@cdx-ui/styles 0.0.1-beta.8 → 0.0.1-beta.80

package/lib/typescript/applyThemeOverride.d.ts

@@ -0,0 +1,26 @@
+import type { Platform, Preset, ThemeOverride } from './types';
+import { type RuntimeMap } from './theming';
+/** The build-time default preset. Apps ship with Poise baked into CSS. */
+export declare const DEFAULT_PRESET: Preset;
+export type ApplyThemeOverrideResult = {
+    applied: true;
+    light: Record<string, string>;
+    dark: Record<string, string>;
+} | {
+    applied: false;
+    reason: 'unsupported_schema_version' | 'no_theme_changes';
+};
+export interface ApplyThemeOverrideOptions {
+    runtimeMap?: RuntimeMap;
+    runtimePlatform?: Platform;
+}
+/**
+ * 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 declare function applyThemeOverride(override: ThemeOverride, options?: ApplyThemeOverrideOptions): ApplyThemeOverrideResult;
+//# sourceMappingURL=applyThemeOverride.d.ts.map

package/lib/typescript/applyThemeOverride.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyThemeOverride.d.ts","sourceRoot":"","sources":["../../src/applyThemeOverride.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAc,MAAM,SAAS,CAAC;AAC3E,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AAMnB,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAE,MAAgB,CAAC;AAgC9C,MAAM,MAAM,wBAAwB,GAChC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC9E;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,4BAA4B,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAMlF,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,QAAQ,CAAC;CAC5B;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CA6D1B"}

package/lib/typescript/index.d.ts

@@ -1,59 +1,10 @@
-/** A DTCG token leaf node. */
-export interface TokenValue {
-    $type: string;
-    $value: string | number;
-    $extensions?: Record<string, unknown>;
-}
-/** Recursive token group — every non-leaf node in a theme object. */
-export interface TokenGroup {
-    [key: string]: TokenValue | TokenGroup;
-}
-/** Theme metadata stored under `$extensions.com.candescent.theme`. */
-export interface ThemeMetadata {
-    name: string;
-    preset: string;
-    schemaVersion: string;
-}
-/** Override metadata stored under `$extensions.com.candescent.themeOverride`. */
-export interface ThemeOverrideMetadata {
-    basePreset: string;
-    fiId: string;
-    fiName: string;
-    schemaVersion: string;
-}
-/**
- * A complete CDX 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`.
- */
-export type ThemeObject = TokenGroup & {
-    $extensions: {
-        'com.candescent.theme': ThemeMetadata;
-        [key: string]: unknown;
-    };
-    modes: {
-        light: TokenGroup;
-        dark: TokenGroup;
-    };
-    platform: {
-        web: TokenGroup;
-        ios: TokenGroup;
-        android: TokenGroup;
-    };
-};
-/**
- * A theme override — a strict subset of the theme object schema containing
- * only the token paths that differ from the base preset.
- */
-export type ThemeOverride = TokenGroup & {
-    $extensions?: {
-        'com.candescent.themeOverride'?: ThemeOverrideMetadata;
-        [key: string]: unknown;
-    };
-};
-export type Mode = 'light' | 'dark';
-export type Platform = 'web' | 'ios' | 'android';
+export { OVERRIDE_SCHEMA_VERSION, SUPPORTED_OVERRIDE_SCHEMA_VERSIONS, INPUT_TOKEN_MAP, presetFonts, } from './types';
+export type { TokenValue, TokenGroup, Preset, ThemeMetadata, ThemeOverrideMetadata, ThemeObject, ThemeOverride, Mode, Platform, } from './types';
+export { generateColorScale, generatePalettesFromInputs, deriveBaseColorKey } from './palette';
+export type { PaletteCategory, PaletteScale, PaletteStep, PaletteTokenMap } from './palette';
+export { isSchemaVersionSupported, presetPatchToUniwindMaps, themeOverrideToUniwindMaps, applyThemeOverride, DEFAULT_PRESET, } from './theming';
+export type { CssVariableMaps, RuntimeMap } from './theming';
+export type { ApplyThemeOverrideOptions, ApplyThemeOverrideResult } from './applyThemeOverride';
+export { useForgeFonts } from './useForgeFonts';
 export { useCdxFonts } from './useCdxFonts';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;CACxC;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG;IACrC,WAAW,EAAE;QACX,sBAAsB,EAAE,aAAa,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,UAAU,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE;QACR,GAAG,EAAE,UAAU,CAAC;QAChB,GAAG,EAAE,UAAU,CAAC;QAChB,OAAO,EAAE,UAAU,CAAC;KACrB,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IACvC,WAAW,CAAC,EAAE;QACZ,8BAA8B,CAAC,EAAE,qBAAqB,CAAC;QACvD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC;AACpC,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAMjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,EACvB,kCAAkC,EAClC,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,UAAU,EACV,UAAU,EACV,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,IAAI,EACJ,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAM7F,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAMhG,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/palette.d.ts

@@ -0,0 +1,60 @@
+/** Palette step keys produced by `generateColorScale`. */
+export type PaletteStep = '50' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900' | '950' | 'input';
+/** Token category that supports palette generation. */
+export type PaletteCategory = 'brand' | 'accent' | 'base';
+/** Map of palette step → resolved hex color. */
+export type PaletteScale = Record<PaletteStep, string>;
+/** Map of token dot-path → resolved hex color (e.g. `color.brand.500` → `#548cdc`). */
+export type PaletteTokenMap = Record<string, string>;
+/**
+ * Generate an 11-step contrast-based color scale from a single hex color.
+ *
+ * Uses `@adobe/leonardo-contrast-colors` internally. The generation algorithm
+ * is wrapped behind this function so the underlying library is swappable
+ * without changing the public API.
+ *
+ * @param hex  - A valid hex color string (`#RGB` or `#RRGGBB`).
+ * @param category - The token namespace (`'brand'` or `'accent'`).
+ * @returns A `PaletteTokenMap` keyed by token dot-paths
+ *   (e.g. `"color.brand.50"` through `"color.brand.950"` plus `"color.brand.input"`).
+ */
+export declare function generateColorScale(hex: string, category: PaletteCategory): PaletteTokenMap;
+/**
+ * Derive the base palette color key from a brand color.
+ *
+ * The base scale shares the brand's hue and lightness but is nearly neutral:
+ * the brand color is converted to HSL and its saturation is lowered to
+ * {@link BASE_SATURATION} (5%). The resulting hex is the color key fed to
+ * {@link generateColorScale} for the `base` category.
+ *
+ * @param brandHex - A valid hex color string (`#RGB` or `#RRGGBB`).
+ * @returns The normalised hex color key for the base scale.
+ */
+export declare function deriveBaseColorKey(brandHex: string): string;
+/**
+ * Generate palettes for all colour inputs in a theme override `inputs` object.
+ *
+ * Iterates over known colour-input keys that map to a `color.*` token
+ * namespace. For each matching key present in `inputs`, runs
+ * `generateColorScale` and merges the results into a single flat map of
+ * token dot-paths to hex values — ready for the S5 override application
+ * merge step.
+ *
+ * Non-colour inputs (e.g. `displayFont`) are silently skipped.
+ *
+ * @param inputs - The `inputs` object from a `ThemeOverride`.
+ * @returns A merged `Record<string, string>` of all generated token
+ *   dot-paths to hex values.
+ *
+ * @example
+ * ```ts
+ * const inputs = { brandPrimary: '#0052cc', accentPrimary: '#FF8C42', displayFont: 'Poppins' };
+ * const result = generatePalettesFromInputs(inputs);
+ * // {
+ * //   "color.brand.50": "#...", …, "color.brand.input": "#0052cc",
+ * //   "color.accent.50": "#...", …, "color.accent.input": "#ff8c42"
+ * // }
+ * ```
+ */
+export declare function generatePalettesFromInputs(inputs: Record<string, string | number>): PaletteTokenMap;
+//# sourceMappingURL=palette.d.ts.map

package/lib/typescript/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/palette.ts"],"names":[],"mappings":"AAMA,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,OAAO,CAAC;AAEZ,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAEvD,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA8ErD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,eAAe,CAgD1F;AAkED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG3D;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,eAAe,CAcjB"}

package/lib/typescript/theming.d.ts

@@ -0,0 +1,40 @@
+import { type Platform, type ThemeOverride, type TokenGroup } from './types';
+export { applyThemeOverride, DEFAULT_PRESET } from './applyThemeOverride';
+export type { ApplyThemeOverrideOptions, ApplyThemeOverrideResult } from './applyThemeOverride';
+/** Per-mode CSS variable maps ready for `Uniwind.updateCSSVariables`. */
+export interface CssVariableMaps {
+    light: Record<string, string>;
+    dark: Record<string, string>;
+}
+/** Runtime map: token dot-paths → CSS custom property names. */
+export type RuntimeMap = Record<string, string>;
+/**
+ * Check whether a `ThemeOverride`'s schema version is supported by the current
+ * build of `@cdx-ui/styles`.
+ */
+export declare function isSchemaVersionSupported(override: ThemeOverride): boolean;
+/**
+ * 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'`).
+ */
+export declare function presetPatchToUniwindMaps(patch: TokenGroup, runtimeMap: RuntimeMap, runtimePlatform: Platform): CssVariableMaps;
+/**
+ * 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'`).
+ */
+export declare function themeOverrideToUniwindMaps(override: ThemeOverride, runtimeMap: RuntimeMap): CssVariableMaps;
+//# sourceMappingURL=theming.d.ts.map

package/lib/typescript/theming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theming.d.ts","sourceRoot":"","sources":["../../src/theming.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,UAAU,EAEhB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAMhG,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAGzE;AAgFD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,QAAQ,GACxB,eAAe,CAIjB;AA+CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,UAAU,GAErB,eAAe,CAgEjB"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,90 @@
+/** A DTCG token leaf node. */
+export interface TokenValue {
+    $type: string;
+    $value: string | number;
+    $extensions?: Record<string, unknown>;
+}
+/** Recursive token group — every non-leaf node in a theme object. */
+export interface TokenGroup {
+    [key: string]: TokenValue | TokenGroup;
+}
+/** The three built-in Forge UI theme presets. */
+export type Preset = 'poise' | 'prestige' | 'pulse';
+/** Theme metadata stored under `$extensions.com.forge.ui.theme`. */
+export interface ThemeMetadata {
+    name: string;
+    preset: Preset;
+    schemaVersion: string;
+}
+/** Override metadata stored under `$extensions.com.forge.ui.themeOverride`. */
+export interface ThemeOverrideMetadata {
+    basePreset: Preset;
+    schemaVersion: string;
+}
+/**
+ * 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`.
+ */
+export type ThemeObject = TokenGroup & {
+    $extensions: {
+        'com.forge.ui.theme': ThemeMetadata;
+        [key: string]: unknown;
+    };
+    modes: {
+        light: TokenGroup;
+        dark: TokenGroup;
+    };
+    platform: {
+        web: TokenGroup;
+        ios: TokenGroup;
+        android: TokenGroup;
+    };
+};
+/**
+ * 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 interface ThemeOverride {
+    $extensions: {
+        'com.forge.ui.themeOverride': ThemeOverrideMetadata;
+        [key: string]: unknown;
+    };
+    inputs?: Record<string, string | number>;
+    overrides?: Partial<Record<Mode, Record<string, string | number>>>;
+}
+export type Mode = 'light' | 'dark';
+export type Platform = 'web' | 'ios' | 'android';
+/** Current override schema version. Consuming apps gate compatibility on this. */
+export declare 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 declare const SUPPORTED_OVERRIDE_SCHEMA_VERSIONS: readonly string[];
+/**
+ * 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 declare const INPUT_TOKEN_MAP: {
+    readonly brandPrimary: "color.brand";
+    readonly accentPrimary: "color.accent";
+    readonly basePrimary: "color.base";
+    readonly displayFont: "font.display";
+};
+/**
+ * Allowed display font families per preset, consumed by the theme editor for
+ * font selection and by consuming apps for validation.
+ */
+export declare const presetFonts: Record<Preset, readonly string[]>;
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAIA,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;CACxC;AAED,iDAAiD;AACjD,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpD,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG;IACrC,WAAW,EAAE;QACX,oBAAoB,EAAE,aAAa,CAAC;QACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,UAAU,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE;QACR,GAAG,EAAE,UAAU,CAAC;QAChB,GAAG,EAAE,UAAU,CAAC;QAChB,OAAO,EAAE,UAAU,CAAC;KACrB,CAAC;CACH,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE;QACX,4BAA4B,EAAE,qBAAqB,CAAC;QACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;CACpE;AAED,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC;AACpC,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAMjD,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,EAAG,OAAgB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,EAAE,SAAS,MAAM,EAAuB,CAAC;AAExF;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;CAKe,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAIhD,CAAC"}

package/lib/typescript/useCdxFonts.d.ts

@@ -1,12 +1,3 @@
-/**
- * Loads all CDX UI fonts — 9 display fonts (3 per preset) with weight/italic
- * variants, plus web platform fonts (Inter, IBM Plex Mono) on web.
- *
- * This is a pure font loader with no preset or FI config awareness. Font
- * selection is handled by the CSS variable layer via theme tokens.
- */
-export declare function useCdxFonts(): {
-    loaded: boolean;
-    error: Error | null;
-};
+/** @deprecated Use `useForgeFonts` instead. Will be removed in a future major release. */
+export { useForgeFonts as useCdxFonts } from './useForgeFonts';
 //# sourceMappingURL=useCdxFonts.d.ts.map

package/lib/typescript/useCdxFonts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCdxFonts.d.ts","sourceRoot":"","sources":["../../src/useCdxFonts.ts"],"names":[],"mappings":"AAuNA;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,CAOtE"}
+{"version":3,"file":"useCdxFonts.d.ts","sourceRoot":"","sources":["../../src/useCdxFonts.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/typescript/useForgeFonts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Loads all Forge UI fonts — 9 display fonts (3 per preset) with weight/italic
+ * variants, plus web platform fonts (Inter, IBM Plex Mono) on web.
+ *
+ * This is a pure font loader with no preset or FI config awareness. Font
+ * selection is handled by the CSS variable layer via theme tokens.
+ */
+export declare function useForgeFonts(): {
+    loaded: boolean;
+    error: Error | null;
+};
+//# sourceMappingURL=useForgeFonts.d.ts.map

package/lib/typescript/useForgeFonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForgeFonts.d.ts","sourceRoot":"","sources":["../../src/useForgeFonts.ts"],"names":[],"mappings":"AAuNA;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,CAOxE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/styles",
-  "version": "0.0.1-beta.8",
+  "version": "0.0.1-beta.80",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -19,13 +19,24 @@
     "./vanilla.css": "./css/vanilla.css",
     "./presets/poise.json": "./tokens/presets/poise.json",
     "./presets/prestige.json": "./tokens/presets/prestige.json",
-    "./presets/pulse.json": "./tokens/presets/pulse.json"
+    "./presets/pulse.json": "./tokens/presets/pulse.json",
+    "./theming": {
+      "react-native": "./src/theming.ts",
+      "types": "./lib/typescript/theming.d.ts",
+      "import": "./lib/module/theming.js",
+      "require": "./lib/commonjs/theming.js",
+      "default": "./lib/module/theming.js"
+    },
+    "./runtime/token-to-css-var.json": "./runtime/token-to-css-var.json",
+    "./runtime/prestige-vs-default.json": "./runtime/prestige-vs-default.json",
+    "./runtime/pulse-vs-default.json": "./runtime/pulse-vs-default.json"
   },
   "files": [
     "lib",
     "src",
     "css",
-    "tokens"
+    "tokens",
+    "runtime"
   ],
   "react-native-builder-bob": {
     "source": "src",
@@ -42,6 +53,7 @@
     ]
   },
   "dependencies": {
+    "@adobe/leonardo-contrast-colors": "1.1.0",
     "@expo-google-fonts/bitter": "0.4.1",
     "@expo-google-fonts/cormorant": "0.4.2",
     "@expo-google-fonts/crimson-pro": "0.4.2",
@@ -53,12 +65,13 @@
     "@expo-google-fonts/manrope": "0.4.2",
     "@expo-google-fonts/outfit": "0.4.3",
     "@expo-google-fonts/public-sans": "0.4.2",
-    "@cdx-ui/utils": "0.0.1-beta.8"
+    "@cdx-ui/utils": "0.0.1-beta.80"
   },
   "peerDependencies": {
+    "expo-font": ">=13.0.0",
     "react": "^18.2.0 || ^19.0.0",
     "react-native": ">=0.76.0",
-    "expo-font": ">=13.0.0"
+    "uniwind": ">=1.0.0"
   },
   "peerDependenciesMeta": {
     "react-native": {
@@ -66,15 +79,20 @@
     },
     "expo-font": {
       "optional": true
+    },
+    "uniwind": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "@types/jest": "^29.5.14",
     "@types/react": "*",
     "expo-font": "*",
     "react": "*",
     "react-native": "*",
     "react-native-builder-bob": "^0.40.17",
     "style-dictionary": "^4.4.0",
+    "ts-jest": "29.4.11",
     "typescript": "~5.9.2"
   },
   "nx": {
@@ -90,10 +108,11 @@
     "access": "public"
   },
   "scripts": {
-    "build": "bob build",
-    "lint": "eslint src/",
+    "build": "bob build && cp -r runtime lib/runtime",
+    "lint": "eslint src/ --ignore-pattern '**/__tests__/**'",
     "tokens:fetch": "node scripts/figma-fetch-variables.mjs",
     "tokens:build": "node scripts/build-tokens.mjs",
-    "fonts:validate": "node scripts/validate-font-tokens.mjs"
+    "fonts:validate": "node scripts/validate-font-tokens.mjs",
+    "test": "jest --config jest.config.js"
   }
 }

package/runtime/prestige-vs-default.json

@@ -0,0 +1 @@
+{}

package/runtime/pulse-vs-default.json

@@ -0,0 +1 @@
+{}