@cdx-ui/styles 0.0.1-beta.53 → 0.0.1-beta.55

package/lib/commonjs/theming.js

@@ -0,0 +1,218 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DEFAULT_PRESET", {
+  enumerable: true,
+  get: function () {
+    return _applyThemeOverride.DEFAULT_PRESET;
+  }
+});
+Object.defineProperty(exports, "applyThemeOverride", {
+  enumerable: true,
+  get: function () {
+    return _applyThemeOverride.applyThemeOverride;
+  }
+});
+exports.isSchemaVersionSupported = isSchemaVersionSupported;
+exports.presetPatchToUniwindMaps = presetPatchToUniwindMaps;
+exports.themeOverrideToUniwindMaps = themeOverrideToUniwindMaps;
+var _palette = require("./palette");
+var _types = require("./types");
+var _applyThemeOverride = require("./applyThemeOverride");
+// ---------------------------------------------------------------------------
+// Re-export orchestrator
+// ---------------------------------------------------------------------------
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** Per-mode CSS variable maps ready for `Uniwind.updateCSSVariables`. */
+
+/** Runtime map: token dot-paths → CSS custom property names. */
+
+// ---------------------------------------------------------------------------
+// Schema version gate
+// ---------------------------------------------------------------------------
+
+/**
+ * Check whether a `ThemeOverride`'s schema version is supported by the current
+ * build of `@cdx-ui/styles`.
+ */
+function isSchemaVersionSupported(override) {
+  const version = override.$extensions['com.forge.ui.themeOverride'].schemaVersion;
+  return _types.SUPPORTED_OVERRIDE_SCHEMA_VERSIONS.includes(version);
+}
+
+// ---------------------------------------------------------------------------
+// DTCG tree walker
+// ---------------------------------------------------------------------------
+
+function isTokenValue(node) {
+  return typeof node === 'object' && node !== null && '$value' in node && '$type' in node;
+}
+
+/**
+ * Recursively walk a nested DTCG object and collect all `$value` leaves with
+ * their full dot-path.
+ */
+function flattenDtcg(node, prefix, result) {
+  for (const key of Object.keys(node)) {
+    if (key.startsWith('$')) continue;
+    const child = node[key];
+    const path = prefix ? `${prefix}.${key}` : key;
+    if (isTokenValue(child)) {
+      result[path] = child.$value;
+    } else if (typeof child === 'object' && child !== null) {
+      flattenDtcg(child, path, result);
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Shared mode-bucketing
+// ---------------------------------------------------------------------------
+
+function bucketByMode(flatTokens, runtimeMap, runtimePlatform) {
+  const light = {};
+  const dark = {};
+  for (const [dotPath, value] of Object.entries(flatTokens)) {
+    const strValue = String(value);
+    if (dotPath.startsWith('modes.light.')) {
+      const cssVar = runtimeMap[dotPath];
+      if (cssVar) light[cssVar] = strValue;
+    } else if (dotPath.startsWith('modes.dark.')) {
+      const cssVar = runtimeMap[dotPath];
+      if (cssVar) dark[cssVar] = strValue;
+    } else if (dotPath.startsWith('platform.')) {
+      const segments = dotPath.split('.');
+      const platform = segments[1];
+      if (platform !== runtimePlatform) continue;
+      const cssVar = runtimeMap[dotPath];
+      if (cssVar) {
+        light[cssVar] = strValue;
+        dark[cssVar] = strValue;
+      }
+    } else {
+      const cssVar = runtimeMap[dotPath];
+      if (cssVar) {
+        light[cssVar] = strValue;
+        dark[cssVar] = strValue;
+      }
+    }
+  }
+  return {
+    light,
+    dark
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Preset patch → Uniwind maps
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert a nested DTCG preset patch (sparse, `$type`/`$value` leaves) into
+ * per-mode CSS variable maps suitable for `Uniwind.updateCSSVariables`.
+ *
+ * @param patch - A sparse DTCG token object (preset patch).
+ * @param runtimeMap - The generated token-to-CSS-var mapping.
+ * @param runtimePlatform - Current platform (`'web' | 'ios' | 'android'`).
+ */
+function presetPatchToUniwindMaps(patch, runtimeMap, runtimePlatform) {
+  const flat = {};
+  flattenDtcg(patch, '', flat);
+  return bucketByMode(flat, runtimeMap, runtimePlatform);
+}
+
+// ---------------------------------------------------------------------------
+// FI override → Uniwind maps
+// ---------------------------------------------------------------------------
+
+/**
+ * Non-color input keys from INPUT_TOKEN_MAP whose token path does NOT start
+ * with `color.`. These are handled separately from palette generation.
+ */
+const FONT_INPUT_ENTRIES = Object.entries(_types.INPUT_TOKEN_MAP).filter(([, tokenPath]) => !tokenPath.startsWith('color.'));
+
+/**
+ * Convert a hybrid FI override (`ThemeOverride`) into per-mode CSS variable
+ * maps suitable for `Uniwind.updateCSSVariables`.
+ *
+ * Processing:
+ * 1. Generate palettes from color `inputs` (via S4).
+ * 2. Map font inputs to token paths.
+ * 3. For each mode, merge palette + fonts + explicit `overrides.{mode}` entries.
+ * 4. Map all token dot-paths to CSS variable names via runtime map.
+ *
+ * @param override - A `ThemeOverride` object.
+ * @param runtimeMap - The generated token-to-CSS-var mapping.
+ * @param runtimePlatform - Current platform (`'web' | 'ios' | 'android'`).
+ */
+function themeOverrideToUniwindMaps(override, runtimeMap
+// runtimePlatform: Platform,
+) {
+  const light = {};
+  const dark = {};
+  const inputs = override.inputs;
+  const overrides = override.overrides;
+  if (!inputs && !overrides) {
+    return {
+      light,
+      dark
+    };
+  }
+
+  // --- Palette generation from colour inputs ---
+  let paletteTokens = {};
+  if (inputs) {
+    paletteTokens = (0, _palette.generatePalettesFromInputs)(inputs);
+  }
+
+  // --- Font input mapping ---
+  const fontTokens = {};
+  if (inputs) {
+    for (const [inputKey, tokenPath] of FONT_INPUT_ENTRIES) {
+      const value = inputs[inputKey];
+      if (value !== undefined) {
+        fontTokens[tokenPath] = String(value);
+      }
+    }
+  }
+
+  // --- Merge per mode ---
+  const modes = ['light', 'dark'];
+  for (const mode of modes) {
+    const bucket = mode === 'light' ? light : dark;
+
+    // 1. Palette-generated primitives (mode-independent → both buckets)
+    for (const [dotPath, hexValue] of Object.entries(paletteTokens)) {
+      const cssVar = runtimeMap[dotPath];
+      if (cssVar) bucket[cssVar] = hexValue;
+    }
+
+    // 2. Font input mappings (mode-independent → both buckets)
+    for (const [tokenPath, value] of Object.entries(fontTokens)) {
+      const modePrefixed = `modes.${mode}.${tokenPath}`;
+      const cssVar = runtimeMap[modePrefixed] ?? runtimeMap[tokenPath];
+      if (cssVar) bucket[cssVar] = value;
+    }
+
+    // 3. Explicit per-mode overrides (wins on collision)
+    const modeOverrides = overrides?.[mode];
+    if (modeOverrides) {
+      for (const [dotPath, value] of Object.entries(modeOverrides)) {
+        const modePrefixed = `modes.${mode}.${dotPath}`;
+        const cssVar = runtimeMap[modePrefixed] ?? runtimeMap[dotPath];
+        if (cssVar) bucket[cssVar] = String(value);
+      }
+    }
+  }
+  return {
+    light,
+    dark
+  };
+}
+//# sourceMappingURL=theming.js.map

package/lib/commonjs/theming.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_palette","require","_types","_applyThemeOverride","isSchemaVersionSupported","override","version","$extensions","schemaVersion","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","includes","isTokenValue","node","flattenDtcg","prefix","result","key","Object","keys","startsWith","child","path","$value","bucketByMode","flatTokens","runtimeMap","runtimePlatform","light","dark","dotPath","value","entries","strValue","String","cssVar","segments","split","platform","presetPatchToUniwindMaps","patch","flat","FONT_INPUT_ENTRIES","INPUT_TOKEN_MAP","filter","tokenPath","themeOverrideToUniwindMaps","inputs","overrides","paletteTokens","generatePalettesFromInputs","fontTokens","inputKey","undefined","modes","mode","bucket","hexValue","modePrefixed","modeOverrides"],"sourceRoot":"../../src","sources":["theming.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/types.js

@@ -0,0 +1,75 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.presetFonts = exports.SUPPORTED_OVERRIDE_SCHEMA_VERSIONS = exports.OVERRIDE_SCHEMA_VERSION = exports.INPUT_TOKEN_MAP = void 0;
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** A DTCG token leaf node. */
+
+/** Recursive token group — every non-leaf node in a theme object. */
+
+/** The three built-in Forge UI theme presets. */
+
+/** Theme metadata stored under `$extensions.com.forge.ui.theme`. */
+
+/** Override metadata stored under `$extensions.com.forge.ui.themeOverride`. */
+
+/**
+ * A complete Forge UI theme object (DTCG-compatible).
+ *
+ * Presets (Poise, Prestige, Pulse) are full theme objects. At runtime the
+ * build-time default preset is augmented by FI overrides via
+ * `applyThemeOverrides`.
+ */
+
+/**
+ * A theme override using the hybrid input + semantic structure.
+ *
+ * - `inputs` — flat map of abstract FI-selected brand values (e.g.
+ *   `brandPrimary`, `displayFont`). Palette generation expands these into
+ *   full token scales at runtime.
+ * - `overrides` — per-mode flat maps of token dot-paths to resolved values
+ *   for direct semantic token overrides beyond what inputs generate.
+ * - `$extensions` — required metadata including base preset and schema version.
+ */
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+/** Current override schema version. Consuming apps gate compatibility on this. */
+const OVERRIDE_SCHEMA_VERSION = exports.OVERRIDE_SCHEMA_VERSION = '1.0.0';
+
+/**
+ * Schema versions that consuming apps accept. Includes the current version and
+ * may include the immediately prior version during transition windows.
+ * @see docs/internal/token-architecture/16-override-structure.md § 4
+ */
+const SUPPORTED_OVERRIDE_SCHEMA_VERSIONS = exports.SUPPORTED_OVERRIDE_SCHEMA_VERSIONS = ['1.0.0'];
+
+/**
+ * Schema-level mapping from known input keys to the token path pattern each
+ * affects. Used by override application (S5) to route inputs to the correct
+ * palette/token namespace. Distinct from the full runtime map (S3).
+ */
+const INPUT_TOKEN_MAP = exports.INPUT_TOKEN_MAP = {
+  brandPrimary: 'color.brand',
+  accentPrimary: 'color.accent',
+  basePrimary: 'color.base',
+  displayFont: 'font.display'
+};
+
+/**
+ * Allowed display font families per preset, consumed by the theme editor for
+ * font selection and by consuming apps for validation.
+ */
+const presetFonts = exports.presetFonts = {
+  poise: ['Crimson Pro', 'Bitter', 'DM Sans'],
+  prestige: ['Libre Caslon Text', 'Cormorant', 'Libre Franklin'],
+  pulse: ['Outfit', 'Manrope', 'Public Sans']
+};
+//# sourceMappingURL=types.js.map

package/lib/commonjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OVERRIDE_SCHEMA_VERSION","exports","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","INPUT_TOKEN_MAP","brandPrimary","accentPrimary","basePrimary","displayFont","presetFonts","poise","prestige","pulse"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;;;;;AAAA;AACA;AACA;;AAEA;;AAOA;;AAKA;;AAGA;;AAOA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;;AAEA;AACO,MAAMA,uBAAuB,GAAAC,OAAA,CAAAD,uBAAA,GAAG,OAAgB;;AAEvD;AACA;AACA;AACA;AACA;AACO,MAAME,kCAAqD,GAAAD,OAAA,CAAAC,kCAAA,GAAG,CAAC,OAAO,CAAU;;AAEvF;AACA;AACA;AACA;AACA;AACO,MAAMC,eAAe,GAAAF,OAAA,CAAAE,eAAA,GAAG;EAC7BC,YAAY,EAAE,aAAa;EAC3BC,aAAa,EAAE,cAAc;EAC7BC,WAAW,EAAE,YAAY;EACzBC,WAAW,EAAE;AACf,CAA2C;;AAE3C;AACA;AACA;AACA;AACO,MAAMC,WAA8C,GAAAP,OAAA,CAAAO,WAAA,GAAG;EAC5DC,KAAK,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC;EAC3CC,QAAQ,EAAE,CAAC,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,CAAC;EAC9DC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,aAAa;AAC5C,CAAU","ignoreList":[]}

package/lib/module/applyThemeOverride.js

@@ -0,0 +1,149 @@
+"use strict";
+
+import prestigePatch from '../runtime/prestige-vs-default.json';
+import pulsePatch from '../runtime/pulse-vs-default.json';
+import defaultRuntimeMap from '../runtime/token-to-css-var.json';
+import { isSchemaVersionSupported, presetPatchToUniwindMaps, themeOverrideToUniwindMaps } from './theming';
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+/** The build-time default preset. Apps ship with Poise baked into CSS. */
+export const DEFAULT_PRESET = 'poise';
+
+// ---------------------------------------------------------------------------
+// Preset patch lookup
+// ---------------------------------------------------------------------------
+
+const PRESET_PATCHES = {
+  poise: null,
+  prestige: prestigePatch,
+  pulse: pulsePatch
+};
+
+// ---------------------------------------------------------------------------
+// Platform detection
+// ---------------------------------------------------------------------------
+
+function detectPlatform() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const {
+      Platform: RNPlatform
+    } = require('react-native');
+    const os = RNPlatform.OS;
+    if (os === 'ios' || os === 'android') return os;
+    return 'web';
+  } catch {
+    return 'web';
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Result type
+// ---------------------------------------------------------------------------
+
+// ---------------------------------------------------------------------------
+// Options
+// ---------------------------------------------------------------------------
+
+// ---------------------------------------------------------------------------
+// Orchestrator
+// ---------------------------------------------------------------------------
+
+/**
+ * Apply a `ThemeOverride` end-to-end: schema version gate, preset patch
+ * selection, palette generation, and `Uniwind.updateCSSVariables` calls.
+ *
+ * Encapsulates the full runtime theme application sequence so consuming
+ * apps don't need to orchestrate lower-level utilities or import Uniwind
+ * directly.
+ */
+export function applyThemeOverride(override, options = {}) {
+  const {
+    runtimeMap = defaultRuntimeMap,
+    runtimePlatform = detectPlatform()
+  } = options;
+
+  // --- Schema version gate ---
+  if (!isSchemaVersionSupported(override)) {
+    return {
+      applied: false,
+      reason: 'unsupported_schema_version'
+    };
+  }
+  const basePreset = override.$extensions['com.forge.ui.themeOverride'].basePreset;
+  const hasInputs = override.inputs !== undefined && Object.keys(override.inputs).length > 0;
+  const hasOverrides = override.overrides !== undefined && Object.keys(override.overrides).length > 0;
+
+  // --- Metadata-only check ---
+  const isDefaultPreset = basePreset === DEFAULT_PRESET;
+  if (isDefaultPreset && !hasInputs && !hasOverrides) {
+    return {
+      applied: false,
+      reason: 'no_theme_changes'
+    };
+  }
+
+  // --- Preset patch step ---
+  let presetMaps = {
+    light: {},
+    dark: {}
+  };
+  if (!isDefaultPreset) {
+    const patch = PRESET_PATCHES[basePreset];
+    if (patch) {
+      presetMaps = presetPatchToUniwindMaps(patch, runtimeMap, runtimePlatform);
+    }
+  }
+
+  // --- FI override step ---
+  let overrideMaps = {
+    light: {},
+    dark: {}
+  };
+  if (hasInputs || hasOverrides) {
+    overrideMaps = themeOverrideToUniwindMaps(override, runtimeMap);
+  }
+
+  // --- Merge per mode (FI wins on collision) ---
+  const mergedLight = {
+    ...presetMaps.light,
+    ...overrideMaps.light
+  };
+  const mergedDark = {
+    ...presetMaps.dark,
+    ...overrideMaps.dark
+  };
+
+  // --- Non-default preset with no FI changes still needs patch application ---
+  if (Object.keys(mergedLight).length === 0 && Object.keys(mergedDark).length === 0) {
+    return {
+      applied: false,
+      reason: 'no_theme_changes'
+    };
+  }
+
+  // --- Apply via Uniwind ---
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const {
+      Uniwind
+    } = require('uniwind');
+    if (Object.keys(mergedLight).length > 0) {
+      Uniwind.updateCSSVariables('light', mergedLight);
+    }
+    if (Object.keys(mergedDark).length > 0) {
+      Uniwind.updateCSSVariables('dark', mergedDark);
+    }
+  } catch {
+    throw new Error('applyThemeOverride requires "uniwind" to be installed. ' + 'Add it as a dependency in your app.');
+  }
+  return {
+    applied: true,
+    light: mergedLight,
+    dark: mergedDark
+  };
+}
+//# sourceMappingURL=applyThemeOverride.js.map

package/lib/module/applyThemeOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["prestigePatch","pulsePatch","defaultRuntimeMap","isSchemaVersionSupported","presetPatchToUniwindMaps","themeOverrideToUniwindMaps","DEFAULT_PRESET","PRESET_PATCHES","poise","prestige","pulse","detectPlatform","Platform","RNPlatform","require","os","OS","applyThemeOverride","override","options","runtimeMap","runtimePlatform","applied","reason","basePreset","$extensions","hasInputs","inputs","undefined","Object","keys","length","hasOverrides","overrides","isDefaultPreset","presetMaps","light","dark","patch","overrideMaps","mergedLight","mergedDark","Uniwind","updateCSSVariables","Error"],"sourceRoot":"../../src","sources":["applyThemeOverride.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -1,74 +1,20 @@
 "use strict";
 
 // ---------------------------------------------------------------------------
-// Types
+// Types & Constants
 // ---------------------------------------------------------------------------
 
-/** A DTCG token leaf node. */
-
-/** Recursive token group — every non-leaf node in a theme object. */
-
-/** The three built-in Forge UI theme presets. */
-
-/** Theme metadata stored under `$extensions.com.forge.ui.theme`. */
-
-/** Override metadata stored under `$extensions.com.forge.ui.themeOverride`. */
-
-/**
- * A complete Forge UI theme object (DTCG-compatible).
- *
- * Presets (Poise, Prestige, Pulse) are full theme objects. At runtime the
- * build-time default preset is augmented by FI overrides via
- * `applyThemeOverrides`.
- */
-
-/**
- * A theme override using the hybrid input + semantic structure.
- *
- * - `inputs` — flat map of abstract FI-selected brand values (e.g.
- *   `brandPrimary`, `displayFont`). Palette generation expands these into
- *   full token scales at runtime.
- * - `overrides` — per-mode flat maps of token dot-paths to resolved values
- *   for direct semantic token overrides beyond what inputs generate.
- * - `$extensions` — required metadata including base preset and schema version.
- */
-
+export { OVERRIDE_SCHEMA_VERSION, SUPPORTED_OVERRIDE_SCHEMA_VERSIONS, INPUT_TOKEN_MAP, presetFonts } from './types';
 // ---------------------------------------------------------------------------
-// Constants
+// Palette generation
 // ---------------------------------------------------------------------------
 
-/** Current override schema version. Consuming apps gate compatibility on this. */
-export const OVERRIDE_SCHEMA_VERSION = '1.0.0';
-
-/**
- * Schema versions that consuming apps accept. Includes the current version and
- * may include the immediately prior version during transition windows.
- * @see docs/internal/token-architecture/16-override-structure.md § 4
- */
-export const SUPPORTED_OVERRIDE_SCHEMA_VERSIONS = ['1.0.0'];
-
-/**
- * Schema-level mapping from known input keys to the token path pattern each
- * affects. Used by override application (S5) to route inputs to the correct
- * palette/token namespace. Distinct from the full runtime map (S3).
- */
-export const INPUT_TOKEN_MAP = {
-  brandPrimary: 'color.brand',
-  accentPrimary: 'color.accent',
-  basePrimary: 'color.base',
-  displayFont: 'font.display'
-};
-
-/**
- * Allowed display font families per preset, consumed by the theme editor for
- * font selection and by consuming apps for validation.
- */
-export const presetFonts = {
-  poise: ['Crimson Pro', 'Bitter', 'DM Sans'],
-  prestige: ['Libre Caslon Text', 'Cormorant', 'Libre Franklin'],
-  pulse: ['Outfit', 'Manrope', 'Public Sans']
-};
+export { generateColorScale, generatePalettesFromInputs } from './palette';
+// ---------------------------------------------------------------------------
+// Theming utilities
+// ---------------------------------------------------------------------------
 
+export { isSchemaVersionSupported, presetPatchToUniwindMaps, themeOverrideToUniwindMaps, applyThemeOverride, DEFAULT_PRESET } from './theming';
 // ---------------------------------------------------------------------------
 // Hooks
 // ---------------------------------------------------------------------------

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["OVERRIDE_SCHEMA_VERSION","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","INPUT_TOKEN_MAP","brandPrimary","accentPrimary","basePrimary","displayFont","presetFonts","poise","prestige","pulse","useForgeFonts","useCdxFonts"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA;;AAOA;;AAKA;;AAGA;;AAOA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;;AAEA;AACA,OAAO,MAAMA,uBAAuB,GAAG,OAAgB;;AAEvD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kCAAqD,GAAG,CAAC,OAAO,CAAU;;AAEvF;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAG;EAC7BC,YAAY,EAAE,aAAa;EAC3BC,aAAa,EAAE,cAAc;EAC7BC,WAAW,EAAE,YAAY;EACzBC,WAAW,EAAE;AACf,CAA2C;;AAE3C;AACA;AACA;AACA;AACA,OAAO,MAAMC,WAA8C,GAAG;EAC5DC,KAAK,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC;EAC3CC,QAAQ,EAAE,CAAC,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,CAAC;EAC9DC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,aAAa;AAC5C,CAAU;;AAEV;AACA;AACA;;AAEA,SAASC,aAAa,QAAQ,iBAAiB;AAC/C,SAASC,WAAW,QAAQ,eAAe","ignoreList":[]}
+{"version":3,"names":["OVERRIDE_SCHEMA_VERSION","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","INPUT_TOKEN_MAP","presetFonts","generateColorScale","generatePalettesFromInputs","isSchemaVersionSupported","presetPatchToUniwindMaps","themeOverrideToUniwindMaps","applyThemeOverride","DEFAULT_PRESET","useForgeFonts","useCdxFonts"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA,SACEA,uBAAuB,EACvBC,kCAAkC,EAClCC,eAAe,EACfC,WAAW,QACN,SAAS;AAahB;AACA;AACA;;AAEA,SAASC,kBAAkB,EAAEC,0BAA0B,QAAQ,WAAW;AAG1E;AACA;AACA;;AAEA,SACEC,wBAAwB,EACxBC,wBAAwB,EACxBC,0BAA0B,EAC1BC,kBAAkB,EAClBC,cAAc,QACT,WAAW;AAIlB;AACA;AACA;;AAEA,SAASC,aAAa,QAAQ,iBAAiB;AAC/C,SAASC,WAAW,QAAQ,eAAe","ignoreList":[]}