@cdx-ui/styles 0.0.1-beta.32 → 0.0.1-beta.33

package/lib/commonjs/index.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.presetFonts = exports.SUPPORTED_OVERRIDE_SCHEMA_VERSIONS = exports.OVERRIDE_SCHEMA_VERSION = exports.INPUT_TOKEN_MAP = void 0;
 Object.defineProperty(exports, "useCdxFonts", {
   enumerable: true,
   get: function () {
@@ -10,4 +11,76 @@ Object.defineProperty(exports, "useCdxFonts", {
   }
 });
 var _useCdxFonts = require("./useCdxFonts");
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** A DTCG token leaf node. */
+
+/** Recursive token group — every non-leaf node in a theme object. */
+
+/** The three built-in CDX UI theme presets. */
+
+/** Theme metadata stored under `$extensions.com.candescent.theme`. */
+
+/** Override metadata stored under `$extensions.com.candescent.themeOverride`. */
+
+/**
+ * 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`.
+ */
+
+/**
+ * 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']
+};
+
+// ---------------------------------------------------------------------------
+// Hooks
+// ---------------------------------------------------------------------------
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_useCdxFonts","require"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;AAsEA,IAAAA,YAAA,GAAAC,OAAA","ignoreList":[]}
+{"version":3,"names":["_useCdxFonts","require","OVERRIDE_SCHEMA_VERSION","exports","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","INPUT_TOKEN_MAP","brandPrimary","accentPrimary","basePrimary","displayFont","presetFonts","poise","prestige","pulse"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;AAqHA,IAAAA,YAAA,GAAAC,OAAA;AArHA;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,MAAMC,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;;AAEV;AACA;AACA","ignoreList":[]}

package/lib/module/index.js

@@ -8,6 +8,8 @@
 
 /** Recursive token group — every non-leaf node in a theme object. */
 
+/** The three built-in CDX UI theme presets. */
+
 /** Theme metadata stored under `$extensions.com.candescent.theme`. */
 
 /** Override metadata stored under `$extensions.com.candescent.themeOverride`. */
@@ -21,9 +23,51 @@
  */
 
 /**
- * A theme override — a strict subset of the theme object schema containing
- * only the token paths that differ from the base preset.
+ * 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. */
+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']
+};
 
 // ---------------------------------------------------------------------------
 // Hooks

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCdxFonts"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA;;AAOA;;AAKA;;AAOA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;;AAWA;AACA;AACA;;AAEA,SAASA,WAAW,QAAQ,eAAe","ignoreList":[]}
+{"version":3,"names":["OVERRIDE_SCHEMA_VERSION","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","INPUT_TOKEN_MAP","brandPrimary","accentPrimary","basePrimary","displayFont","presetFonts","poise","prestige","pulse","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,WAAW,QAAQ,eAAe","ignoreList":[]}

package/lib/typescript/index.d.ts

@@ -8,15 +8,17 @@ export interface TokenValue {
 export interface TokenGroup {
     [key: string]: TokenValue | TokenGroup;
 }
+/** The three built-in CDX UI theme presets. */
+export type Preset = 'poise' | 'prestige' | 'pulse';
 /** Theme metadata stored under `$extensions.com.candescent.theme`. */
 export interface ThemeMetadata {
     name: string;
-    preset: string;
+    preset: Preset;
     schemaVersion: string;
 }
 /** Override metadata stored under `$extensions.com.candescent.themeOverride`. */
 export interface ThemeOverrideMetadata {
-    basePreset: string;
+    basePreset: Preset;
     schemaVersion: string;
 }
 /**
@@ -42,16 +44,48 @@ export type ThemeObject = TokenGroup & {
     };
 };
 /**
- * A theme override — a strict subset of the theme object schema containing
- * only the token paths that differ from the base preset.
+ * 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 type ThemeOverride = TokenGroup & {
-    $extensions?: {
-        'com.candescent.themeOverride'?: ThemeOverrideMetadata;
+export interface ThemeOverride {
+    $extensions: {
+        'com.candescent.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[]>;
 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,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,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,+CAA+C;AAC/C,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpD,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,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;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE;QACX,8BAA8B,EAAE,qBAAqB,CAAC;QACtD,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;AAMX,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/styles",
-  "version": "0.0.1-beta.32",
+  "version": "0.0.1-beta.33",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -53,7 +53,7 @@
     "@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.32"
+    "@cdx-ui/utils": "0.0.1-beta.33"
   },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.0.0",

package/src/index.ts

@@ -14,16 +14,19 @@ export interface TokenGroup {
   [key: string]: TokenValue | TokenGroup;
 }
 
+/** The three built-in CDX UI theme presets. */
+export type Preset = 'poise' | 'prestige' | 'pulse';
+
 /** Theme metadata stored under `$extensions.com.candescent.theme`. */
 export interface ThemeMetadata {
   name: string;
-  preset: string;
+  preset: Preset;
   schemaVersion: string;
 }
 
 /** Override metadata stored under `$extensions.com.candescent.themeOverride`. */
 export interface ThemeOverrideMetadata {
-  basePreset: string;
+  basePreset: Preset;
   schemaVersion: string;
 }
 
@@ -51,19 +54,63 @@ export type ThemeObject = TokenGroup & {
 };
 
 /**
- * A theme override — a strict subset of the theme object schema containing
- * only the token paths that differ from the base preset.
+ * 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 type ThemeOverride = TokenGroup & {
-  $extensions?: {
-    'com.candescent.themeOverride'?: ThemeOverrideMetadata;
+export interface ThemeOverride {
+  $extensions: {
+    'com.candescent.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';
 
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+/** Current override schema version. Consuming apps gate compatibility on this. */
+export const OVERRIDE_SCHEMA_VERSION = '1.0.0' as const;
+
+/**
+ * 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: readonly string[] = ['1.0.0'] as const;
+
+/**
+ * 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',
+} as const satisfies Record<string, string>;
+
+/**
+ * Allowed display font families per preset, consumed by the theme editor for
+ * font selection and by consuming apps for validation.
+ */
+export const presetFonts: Record<Preset, readonly string[]> = {
+  poise: ['Crimson Pro', 'Bitter', 'DM Sans'],
+  prestige: ['Libre Caslon Text', 'Cormorant', 'Libre Franklin'],
+  pulse: ['Outfit', 'Manrope', 'Public Sans'],
+} as const;
+
 // ---------------------------------------------------------------------------
 // Hooks
 // ---------------------------------------------------------------------------