@dash-ui/styles/server/dist/esm/index.dev.mjs.map

A tiny, powerful, framework-agnostic CSS-in-JS library.

{"version":3,"file":"index.dev.mjs","sources":["../../src/index.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-var-requires */\n\n/**\n * Creates a string of CSS based on the dash `inserted` cache. This\n * is an extremely fast way to generate a CSS string. It returns an\n * object containing the hash names of all of the styles used as well\n * as the CSS string.\n *\n * Note that this function is unsafe in asynchronous render environments\n * because multiple pages using the same cache will dirty the results.\n * This means it will not work with Gatsby, for example.\n *\n * @param styles - A `styles()` instance\n * @param options - Configuration options\n */\nexport function createStylesFromCache(\n  styles = require(\"@dash-ui/styles\").styles,\n  options: CreateServerStylesOptions = {}\n): ServerStylesResult {\n  const { clearCache = false } = options;\n  const { dash } = styles;\n  const styleCache = dash.cache;\n  const names = new Set([...dash.sheets.keys(), ...dash.inserted.values()]);\n  let css = \"\";\n\n  for (const name of names) css += styleCache.get(name);\n\n  if (clearCache) dash.inserted.clear();\n  return { names: [...names], css };\n}\n\n/**\n * Creates a `<style>` tag w/ CSS based on the dash `inserted` cache. This\n * is an extremely fast way to generate a `<style>` tag.\n *\n * Note that this function is unsafe in asynchronous render environments\n * because multiple pages using the same cache will dirty the results.\n * This means it will not work with Gatsby, for example.\n *\n * @param styles - A `styles()` instance\n * @param options - Configuration options\n */\nexport function createStyleTagFromCache(\n  styles = require(\"@dash-ui/styles\").styles,\n  options: CreateServerStylesOptions = {}\n): string {\n  const { css, names } = createStylesFromCache(styles, options);\n  const nonceString = styles.dash.sheet.nonce\n    ? ` nonce=\"${styles.dash.sheet.nonce}\"`\n    : \"\";\n\n  return `<style data-dash=\"${names.join(\" \")}\" data-cache=\"${\n    styles.dash.key\n  }\"${nonceString}>${css}</style>`;\n}\n\n/**\n * Writes a CSS to a file based on the dash `inserted` cache. This\n * is an extremely fast way to generate a CSS file.\n *\n * Note that this function is unsafe in asynchronous render environments\n * because multiple pages using the same cache will dirty the results.\n * This means it will not work with Gatsby, for example.\n *\n * @param outputPath - An absolute or relative path dictating where you want to\n *  output the CSS file.\n * @param styles - A `styles()` instance\n * @param options - Configuration options\n */\nexport async function writeStylesFromCache(\n  outputPath = \"\",\n  styles = require(\"@dash-ui/styles\").styles,\n  options?: WriteServerStylesOptions & { clearCache?: boolean }\n): Promise<WriteServerStylesResult> {\n  // Requiring in here prevents webpack errors in stuff like Next.js apps\n  const fs = require(\"fs\");\n  const path = require(\"path\");\n  let { name, hash = styles.hash, clearCache = false } = options || {};\n  const { css, names } = createStylesFromCache(styles, { clearCache });\n  name = `${name || styles.dash.key + \"-\" + hash(css) + \".css\"}`;\n  const filename = path.join(outputPath, name);\n  await fs.promises.writeFile(filename, css);\n  return { filename, name, path: outputPath, css, names };\n}\n\n/**\n * Creates a string of CSS based on an HTML string. This function will\n * parse your HTML output for Dash class names and pull the styles associated\n * with them from the Dash cache. It returns an object containing the hash names\n * of all of the styles used as well as the CSS string.\n *\n * This is a safe way to generate style strings in an asynchronous environment\n *\n * @param html - An HTML string\n * @param styles - A `styles()` instance\n */\nexport function createStylesFromString(\n  html: string,\n  styles = require(\"@dash-ui/styles\").styles\n): ServerStylesResult {\n  const { dash } = styles;\n  const styleCache = dash.cache;\n  const names = new Set<string>(dash.sheets.keys());\n\n  let css = \"\";\n  for (let name of names) css += styleCache.get(name);\n\n  const re = new RegExp(`[\"\\\\s'=]${dash.key}-(\\\\w+)`, \"g\");\n  for (const [, name] of html.matchAll(re)) {\n    if (!names.has(name)) {\n      css += styleCache.get(name) || \"\";\n      names.add(name);\n    }\n  }\n\n  return { names: [...names], css };\n}\n\n/**\n * Creates a `<style>` tag w/ CSS based on an HTML string. This function will\n * parse your HTML output for Dash class names and pull the styles associated\n * with them from the Dash cache.\n *\n * This is a safe way to generate `<style>` tags in an asynchronous environment.\n *\n * @param html - An HTML string\n * @param styles - A `styles()` instance\n */\nexport function createStyleTagFromString(\n  html: string,\n  styles = require(\"@dash-ui/styles\").styles\n): string {\n  const { css, names } = createStylesFromString(html, styles);\n  const nonceString = styles.dash.sheet.nonce\n    ? ` nonce=\"${styles.dash.sheet.nonce}\"`\n    : \"\";\n\n  return `<style data-dash=\"${names.join(\" \")}\" data-cache=\"${\n    styles.dash.key\n  }\"${nonceString}>${css}</style>`;\n}\n\n/**\n * Writes a CSS to a file based on an HTML string. This function will\n * parse your HTML output for Dash class names and pull the styles associated\n * with them from the Dash cache.\n *\n * This is a safe way to generate `<style>` tags in an asynchronous environment.\n *\n * @param html\n * @param styles - A `styles()` instance\n * @param outputPath - An absolute or relative path dictating where you want to\n *  output the CSS file.\n * @param options - Configuration options\n */\nexport async function writeStylesFromString(\n  html: string,\n  outputPath = \"\",\n  styles = require(\"@dash-ui/styles\").styles,\n  options?: WriteServerStylesOptions\n): Promise<WriteServerStylesResult> {\n  // Requiring in here prevents webpack errors in stuff like Next.js apps\n  const fs = require(\"fs\");\n  const path = require(\"path\");\n  let { name, hash = styles.hash } = options || {};\n  const { css, names } = createStylesFromString(html, styles);\n  name = `${name || styles.dash.key + \"-\" + hash(css) + \".css\"}`;\n  const filename = path.join(outputPath, name);\n  await fs.promises.writeFile(filename, css);\n  return { filename, name, path: outputPath, css, names };\n}\n\nexport interface ServerStylesResult {\n  /**\n   * A CSS string containing all of the styles that were used\n   */\n  css: string;\n  /**\n   * Hash names of all of the styles used in the generated CSS\n   */\n  names: string[];\n}\n\nexport interface CreateServerStylesOptions {\n  /**\n   * Clears the Dash `inserted` cache after styles have been\n   * generated. This is useful in synchronous environments when you\n   * only want to generate CSS strings for the styles that were actually\n   * used in a given page/render.\n   *\n   * @default false\n   */\n  clearCache?: boolean;\n}\n\nexport interface WriteServerStylesOptions {\n  /**\n   * Use this if you want to create your own name for the CSS file.\n   * By default, this function will create a filename based on the hash\n   * of the generated CSS string.\n   */\n  name?: string;\n  /**\n   * Use a custom hash function for creating the name of your CSS file.\n   * By default this function will use the hash function attached to your\n   * `styles()` instance.\n   */\n  hash?: (string: string) => string;\n}\n\nexport interface WriteServerStylesResult {\n  /**\n   * The filename of the generated file. This is the `outputPath` joined\n   * to the basename of the CSS file that was generated.\n   */\n  filename: string;\n  /**\n   * The basename of the CSS file that was generated.\n   */\n  name: string;\n  /**\n   * The output path of the CSS file excluding the basename.\n   */\n  path: string;\n  /**\n   * The CSS string that was generated and written to the output\n   * file.\n   */\n  css: string;\n  /**\n   * The hash names of all of the styles that were inserted into\n   * the generated CSS string.\n   */\n  names: string[];\n}\n"],"names":["createStylesFromCache","styles","options","require","clearCache","dash","styleCache","cache","names","Set","sheets","keys","inserted","values","css","name","get","clear","createStyleTagFromCache","nonceString","sheet","nonce","join","key","writeStylesFromCache","outputPath","fs","path","hash","filename","promises","writeFile","createStylesFromString","html","re","RegExp","matchAll","has","add","createStyleTagFromString","writeStylesFromString"],"mappings":"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"}