@poupe/theme-builder/dist/server.mjs.map

Design token management and theme generation system for Poupe UI framework

{"version":3,"file":"server.mjs","sources":["../src/server/utils.ts","../src/server/stringify.ts","../src/server/index.ts"],"sourcesContent":["// dependencies\nimport { random } from 'colord';\n\nimport {\n  type Color,\n  type HexColor,\n\n  hexString,\n} from '../core';\n\nimport {\n  type StandardDynamicSchemeKey,\n\n  standardDynamicSchemes,\n} from '../theme';\n\nconst reHexValue = /^#?(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;\n\n/** @returns if the value is a string suitable for {@link hct} */\nexport const isHexValue = (s: string | HexColor): boolean => reHexValue.test(s);\n\n/** @returns if the value is a valid {@link StandardDynamicSchemeKey} */\nexport const isThemeSchemeKey = (s?: string): boolean => !!s && s in standardDynamicSchemes;\n\n/** @returns the given string as a valid StandardDynamicSchemeKey, or undefined if it is not a valid key */\nexport const asThemeSchemeKey = (key?: string): StandardDynamicSchemeKey | undefined => {\n  if (isThemeSchemeKey(key)) {\n    return key as StandardDynamicSchemeKey;\n  }\n\n  return undefined;\n};\n\n/** Extracts the first parameter from a potentially undefined or array-like parameter, returning a single string or undefined. */\nexport const getParam = (param?: string | string[]): (string | undefined) => {\n  if (param === undefined) {\n    return undefined;\n  } else if (!Array.isArray(param)) {\n    return param;\n  } else if (param.length > 0) {\n    return param[0];\n  } else {\n    return undefined;\n  }\n};\n\n/**\n * @returns a random hex color value, throwing an error if generation fails\n * It uses `colord` to generate the random color.\n * */\nexport const getRandomColor = (): HexColor => {\n  const c = random();\n\n  if (!c.isValid()) {\n    throw new Error('Failed to generate random color');\n  }\n\n  return c.toHex() as HexColor;\n};\n\n/** Converts a color to a URL-friendly hex string, generating a random color if none is provided.\n * It uses `colord` to generate the random color.\n * @param c - Optional color to convert\n * @returns A hex color string without the leading '#'\n */\nexport const colorToURL = (c?: Color): string => {\n  const s = c ? hexString(c) : getRandomColor();\n  return s.slice(1);\n};\n","import {\n  type CSSRules,\n  type CSSRuleObject,\n  type CSSRulesFormatOptions,\n  generateCSSRulesArray,\n} from '@poupe/css';\n\n/**\n * Options for formatting CSS rules with newLine support.\n */\nexport interface CSSRulesStringifyOptions extends CSSRulesFormatOptions {\n  /**\n   * Character(s) to use for line breaks.\n   * @defaultValue `'\\n'`\n   */\n  newLine?: string\n}\n\n/**\n * Converts CSS rules array to a string with newLine between\n * each line. Uses the efficient generator implementation internally.\n * No trailing newLine for composition purposes.\n *\n * @param rules - The array of CSS rules to format\n * @param options - Configuration options for formatting\n * @returns A string with newLine-separated lines\n */\nexport function stringifyCSSRulesArray(\n  rules: (string | CSSRules | CSSRuleObject)[] = [],\n  options: CSSRulesStringifyOptions = {},\n): string {\n  const {\n    newLine = '\\n',\n    ...formatOptions\n  } = options;\n\n  const lines = [...generateCSSRulesArray(rules, formatOptions)];\n\n  // Join with newLine (no trailing newLine for composition)\n  return lines.join(newLine);\n}\n\n/**\n * Converts CSS rules array to an async generator for streaming responses.\n * Uses the efficient generator implementation that yields lines as they're generated.\n *\n * @param rules - The array of CSS rules to format\n * @param options - Configuration options for formatting\n * @returns Formatted CSS lines with newLine endings\n */\nexport async function* stringifyCSSRulesArrayStream(\n  rules: (string | CSSRules | CSSRuleObject)[] = [],\n  options: CSSRulesStringifyOptions = {},\n): AsyncGenerator<string, void, unknown> {\n  const {\n    newLine = '\\n',\n    ...formatOptions\n  } = options;\n\n  // Use the generator for true streaming\n  for (const line of generateCSSRulesArray(rules, formatOptions)) {\n    yield line + newLine;\n  }\n}\n\n/**\n * Creates a ReadableStream with formatted CSS rules array.\n * Uses the generator directly for true streaming without building arrays.\n * Perfect for Cloudflare Workers and other edge environments.\n *\n * @param rules - The array of CSS rules to format\n * @param options - Configuration options for formatting\n * @returns A ReadableStream ready to be used in Response or other contexts\n */\nexport function stringifyCSSRulesArrayAsStream(\n  rules: (string | CSSRules | CSSRuleObject)[] = [],\n  options: CSSRulesStringifyOptions = {},\n): ReadableStream<Uint8Array> {\n  const {\n    newLine = '\\n',\n    ...formatOptions\n  } = options;\n\n  return new ReadableStream({\n    start(controller) {\n      const generator = generateCSSRulesArray(rules, formatOptions);\n      const encoder = new TextEncoder();\n\n      function pump() {\n        const { done, value } = generator.next();\n\n        if (done) {\n          controller.close();\n          return;\n        }\n\n        controller.enqueue(encoder.encode(value + newLine));\n        pump();\n      }\n\n      pump();\n    },\n  });\n}\n\n/**\n * Creates a Response object with formatted CSS rules array.\n * Sets appropriate Content-Type header and allows for additional headers.\n *\n * @param rules - The array of CSS rules to format\n * @param options - Configuration options for formatting and response\n * @returns A Response object ready to be sent\n */\nexport function stringifyCSSRulesArrayAsResponse(\n  rules: (string | CSSRules | CSSRuleObject)[] = [],\n  options: CSSRulesStringifyOptions & {\n    /**\n     * Additional headers to include in the response.\n     */\n    headers?: HeadersInit\n  } = {},\n): Response {\n  const {\n    headers: extraHeaders,\n    newLine = '\\n',\n    ...formatOptions\n  } = options;\n\n  const content = stringifyCSSRulesArray(rules, { newLine, ...formatOptions });\n  const finalContent = content ? content + newLine : content;\n\n  const headers = new Headers(extraHeaders);\n  // Set Content-Type if not already set\n  if (!headers.has('Content-Type')) {\n    headers.set('Content-Type', 'text/css; charset=utf-8');\n  }\n\n  return new Response(finalContent, {\n    status: 200,\n    headers,\n  });\n}\n\n/**\n * Creates a streaming Response object with formatted CSS rules array.\n * Uses the ReadableStream function for true streaming without building arrays.\n * Sets appropriate Content-Type header and allows for additional headers.\n *\n * @param rules - The array of CSS rules to format\n * @param options - Configuration options for formatting and response\n * @returns A streaming Response object ready to be sent\n */\nexport function stringifyCSSRulesArrayAsStreamingResponse(\n  rules: (string | CSSRules | CSSRuleObject)[] = [],\n  options: CSSRulesStringifyOptions & {\n    /**\n     * Additional headers to include in the response.\n     */\n    headers?: HeadersInit\n  } = {},\n): Response {\n  const {\n    headers: extraHeaders,\n    ...streamOptions\n  } = options;\n\n  const headers = new Headers(extraHeaders);\n  // Set Content-Type if not already set\n  if (!headers.has('Content-Type')) {\n    headers.set('Content-Type', 'text/css; charset=utf-8');\n  }\n\n  const stream = stringifyCSSRulesArrayAsStream(rules, streamOptions);\n\n  return new Response(stream, {\n    status: 200,\n    headers,\n  });\n}\n","// dependencies\nimport {\n  type HexColor,\n\n  colord,\n} from '../core';\n\nimport {\n  type StandardDynamicSchemeKey,\n} from '../theme';\n\nimport {\n  getParam,\n  isHexValue,\n  asThemeSchemeKey,\n} from './utils';\n\n// re-export\n//\nexport {\n  type Color,\n  type Hct,\n  type Colord,\n  type HexColor,\n  hexString,\n  hct,\n  colord,\n} from '../core';\n\nexport {\n  type StandardDynamicSchemeKey,\n} from '../theme';\n\n// normalization utils and type checking\nexport * from './utils';\n\n// CSS stringification utilities\nexport * from './stringify';\n\n/** Attempts to convert a parameter to a valid hex color.\n * @param param - An optional string or string array representing a color\n * @param filter - Optional function to pre-process the parameter before validation\n * @returns An object containing the original parameter and a validated hex color, if applicable\n * @remarks Supports hex values directly, as well as other color formats supported by colord\n * (including RGB, HSL, HSV, LAB, LCH, CMYK and color names if the colord plugin has been enabled)\n */\nexport const getColorParam = (param?: string | string[], filter?: (s?: string)=>(string | undefined)): {\n  param?: string\n  color?: HexColor\n} => {\n  const s = filter ? filter(getParam(param)) : getParam(param);\n  if (s === undefined || s === '') {\n    return { param: s };\n  }\n\n  if (isHexValue(s)) {\n    const hex = (s.startsWith('#') ? s : `#${s}`).toLowerCase() as HexColor;\n    return { param: s, color: hex };\n  }\n\n  const c = colord(s);\n  if (c.isValid()) {\n    const hex = c.toHex() as HexColor;\n    return { param: s, color: hex };\n  }\n\n  return { param: s };\n};\n\n/** Attempts to convert a parameter to a valid StandardDynamicSchemeKey.\n * @param param - An optional string or string array representing a theme scheme key\n * @param filter - Optional function to pre-process the parameter before validation\n * @returns An object containing the original parameter and a validated theme scheme key, if applicable\n */\nexport const getThemeSchemeParam = (param?: string | string[], filter?: (s?: string)=>(string | undefined)): {\n  param?: string\n  scheme?: StandardDynamicSchemeKey\n} => {\n  const key = filter ? filter(getParam(param)) : getParam(param);\n\n  return {\n    param: key,\n    scheme: asThemeSchemeKey(key),\n  };\n};\n"],"names":[],"mappings":"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"}