@cdx-ui/styles 0.0.1-beta.54 → 0.0.1-beta.56

package/css/theme.css

@@ -406,7 +406,7 @@
   --color-surface-action-tint-active: var(--color-brand-300);
   --color-surface-action-tint-hover: var(--color-brand-200);
   --color-surface-backdrop: rgba(0, 0, 0, 0.5);
-  --color-surface-background: var(--color-base-100);
+  --color-surface-background: var(--color-base-50);
   --color-surface-brand-core: var(--color-brand-input);
   --color-surface-brand-strong: var(--color-brand-700);
   --color-surface-brand-subtle: var(--color-brand-200);
@@ -535,7 +535,7 @@
       --color-surface-action-tint-active: var(--color-brand-300);
       --color-surface-action-tint-hover: var(--color-brand-200);
       --color-surface-backdrop: rgba(0, 0, 0, 0.5);
-      --color-surface-background: var(--color-base-100);
+      --color-surface-background: var(--color-base-50);
       --color-surface-brand-core: var(--color-brand-input);
       --color-surface-brand-strong: var(--color-brand-700);
       --color-surface-brand-subtle: var(--color-brand-200);

package/lib/commonjs/applyThemeOverride.js

@@ -0,0 +1,154 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_PRESET = void 0;
+exports.applyThemeOverride = applyThemeOverride;
+var _prestigeVsDefault = _interopRequireDefault(require("../runtime/prestige-vs-default.json"));
+var _pulseVsDefault = _interopRequireDefault(require("../runtime/pulse-vs-default.json"));
+var _tokenToCssVar = _interopRequireDefault(require("../runtime/token-to-css-var.json"));
+var _theming = require("./theming");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+/** The build-time default preset. Apps ship with Poise baked into CSS. */
+const DEFAULT_PRESET = exports.DEFAULT_PRESET = 'poise';
+
+// ---------------------------------------------------------------------------
+// Preset patch lookup
+// ---------------------------------------------------------------------------
+
+const PRESET_PATCHES = {
+  poise: null,
+  prestige: _prestigeVsDefault.default,
+  pulse: _pulseVsDefault.default
+};
+
+// ---------------------------------------------------------------------------
+// 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.
+ */
+function applyThemeOverride(override, options = {}) {
+  const {
+    runtimeMap = _tokenToCssVar.default,
+    runtimePlatform = detectPlatform()
+  } = options;
+
+  // --- Schema version gate ---
+  if (!(0, _theming.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 = (0, _theming.presetPatchToUniwindMaps)(patch, runtimeMap, runtimePlatform);
+    }
+  }
+
+  // --- FI override step ---
+  let overrideMaps = {
+    light: {},
+    dark: {}
+  };
+  if (hasInputs || hasOverrides) {
+    overrideMaps = (0, _theming.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/commonjs/applyThemeOverride.js.map

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

package/lib/commonjs/index.js

@@ -3,7 +3,72 @@
 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, "DEFAULT_PRESET", {
+  enumerable: true,
+  get: function () {
+    return _theming.DEFAULT_PRESET;
+  }
+});
+Object.defineProperty(exports, "INPUT_TOKEN_MAP", {
+  enumerable: true,
+  get: function () {
+    return _types.INPUT_TOKEN_MAP;
+  }
+});
+Object.defineProperty(exports, "OVERRIDE_SCHEMA_VERSION", {
+  enumerable: true,
+  get: function () {
+    return _types.OVERRIDE_SCHEMA_VERSION;
+  }
+});
+Object.defineProperty(exports, "SUPPORTED_OVERRIDE_SCHEMA_VERSIONS", {
+  enumerable: true,
+  get: function () {
+    return _types.SUPPORTED_OVERRIDE_SCHEMA_VERSIONS;
+  }
+});
+Object.defineProperty(exports, "applyThemeOverride", {
+  enumerable: true,
+  get: function () {
+    return _theming.applyThemeOverride;
+  }
+});
+Object.defineProperty(exports, "generateColorScale", {
+  enumerable: true,
+  get: function () {
+    return _palette.generateColorScale;
+  }
+});
+Object.defineProperty(exports, "generatePalettesFromInputs", {
+  enumerable: true,
+  get: function () {
+    return _palette.generatePalettesFromInputs;
+  }
+});
+Object.defineProperty(exports, "isSchemaVersionSupported", {
+  enumerable: true,
+  get: function () {
+    return _theming.isSchemaVersionSupported;
+  }
+});
+Object.defineProperty(exports, "presetFonts", {
+  enumerable: true,
+  get: function () {
+    return _types.presetFonts;
+  }
+});
+Object.defineProperty(exports, "presetPatchToUniwindMaps", {
+  enumerable: true,
+  get: function () {
+    return _theming.presetPatchToUniwindMaps;
+  }
+});
+Object.defineProperty(exports, "themeOverrideToUniwindMaps", {
+  enumerable: true,
+  get: function () {
+    return _theming.themeOverrideToUniwindMaps;
+  }
+});
 Object.defineProperty(exports, "useCdxFonts", {
   enumerable: true,
   get: function () {
@@ -16,78 +81,9 @@ Object.defineProperty(exports, "useForgeFonts", {
     return _useForgeFonts.useForgeFonts;
   }
 });
+var _types = require("./types");
+var _palette = require("./palette");
+var _theming = require("./theming");
 var _useForgeFonts = require("./useForgeFonts");
 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 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']
-};
-
-// ---------------------------------------------------------------------------
-// Hooks
-// ---------------------------------------------------------------------------
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_useForgeFonts","require","_useCdxFonts","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,cAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAtHA;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,MAAME,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":[]}
+{"version":3,"names":["_types","require","_palette","_theming","_useForgeFonts","_useCdxFonts"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,IAAAA,MAAA,GAAAC,OAAA;AAsBA,IAAAC,QAAA,GAAAD,OAAA;AAOA,IAAAE,QAAA,GAAAF,OAAA;AAcA,IAAAG,cAAA,GAAAH,OAAA;AACA,IAAAI,YAAA,GAAAJ,OAAA","ignoreList":[]}

package/lib/commonjs/palette.js

@@ -0,0 +1,180 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.generateColorScale = generateColorScale;
+exports.generatePalettesFromInputs = generatePalettesFromInputs;
+var _leonardoContrastColors = require("@adobe/leonardo-contrast-colors");
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** Palette step keys produced by `generateColorScale`. */
+
+/** Token category that supports palette generation. */
+
+/** Map of palette step → resolved hex color. */
+
+/** Map of token dot-path → resolved hex color (e.g. `color.brand.500` → `#548cdc`). */
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+const REFERENCE_BACKGROUND = '#ffffff';
+const PALETTE_STEPS = ['50', '100', '200', '300', '400', '500', '600', '700', '800', '900', '950'];
+
+/**
+ * Contrast ratios for each palette step against white (#ffffff).
+ *
+ * Step 700 targets WCAG AA for normal text (≥ 4.5:1).
+ */
+const CONTRAST_RATIOS = {
+  '50': 1.04,
+  '100': 1.16,
+  '200': 1.46,
+  '300': 1.85,
+  '400': 2.45,
+  '500': 3.4,
+  '600': 4.8,
+  '700': 6.4,
+  '800': 8.6,
+  '900': 12,
+  '950': 16.8
+};
+const HEX_REGEX = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
+
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+
+/**
+ * Validate and normalise a hex color string.
+ *
+ * Accepts `#RGB` (4 chars) or `#RRGGBB` (7 chars). Throws a descriptive
+ * `TypeError` for any other input.
+ *
+ * @returns The normalised 7-character hex string (e.g. `#aabbcc`).
+ */
+function validateHex(hex) {
+  if (typeof hex !== 'string') {
+    throw new TypeError(`Invalid hex color: expected a string, received ${typeof hex}`);
+  }
+  if (!HEX_REGEX.test(hex)) {
+    throw new TypeError(`Invalid hex color "${hex}": must be a 4-character (#RGB) or 7-character (#RRGGBB) hex string starting with "#"`);
+  }
+  if (hex.length === 4) {
+    const [, r, g, b] = hex;
+    return `#${r}${r}${g}${g}${b}${b}`.toLowerCase();
+  }
+  return hex.toLowerCase();
+}
+
+// ---------------------------------------------------------------------------
+// Core generation — wraps Leonardo behind a thin interface
+// ---------------------------------------------------------------------------
+
+/**
+ * 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"`).
+ */
+function generateColorScale(hex, category) {
+  const normalised = validateHex(hex);
+  const ratiosObject = {};
+  for (const step of PALETTE_STEPS) {
+    ratiosObject[step] = CONTRAST_RATIOS[step];
+  }
+  const color = new _leonardoContrastColors.Color({
+    name: 'palette',
+    colorKeys: [normalised],
+    colorSpace: 'CAM02p',
+    ratios: ratiosObject,
+    smooth: true,
+    output: 'HEX'
+  });
+  const bg = new _leonardoContrastColors.BackgroundColor({
+    name: 'background',
+    colorKeys: [REFERENCE_BACKGROUND],
+    colorSpace: 'CAM02p',
+    smooth: true,
+    ratios: [],
+    output: 'HEX'
+  });
+  const theme = new _leonardoContrastColors.Theme({
+    colors: [color],
+    backgroundColor: bg,
+    lightness: 100,
+    contrast: 1,
+    saturation: 100,
+    output: 'HEX',
+    formula: 'wcag2'
+  });
+  const pairs = theme.contrastColorPairs;
+  const tokenPrefix = `color.${category}`;
+  const result = {};
+  for (const step of PALETTE_STEPS) {
+    result[`${tokenPrefix}.${step}`] = pairs[step].toLowerCase();
+  }
+  result[`${tokenPrefix}.input`] = normalised;
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Convenience wrapper
+// ---------------------------------------------------------------------------
+
+/**
+ * Colour-input keys whose token path starts with `color.` — these trigger
+ * palette generation. Mirrors the colour entries from `INPUT_TOKEN_MAP`
+ * (defined in the package barrel) without creating a circular import.
+ *
+ * Keep in sync with `INPUT_TOKEN_MAP` in `./index.ts`.
+ */
+const COLOR_INPUT_ENTRIES = [['brandPrimary', 'color.brand'], ['accentPrimary', 'color.accent']];
+
+/**
+ * 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"
+ * // }
+ * ```
+ */
+function generatePalettesFromInputs(inputs) {
+  const result = {};
+  for (const [inputKey, tokenPath] of COLOR_INPUT_ENTRIES) {
+    const value = inputs[inputKey];
+    if (typeof value !== 'string') continue;
+    const category = tokenPath.replace('color.', '');
+    const scale = generateColorScale(value, category);
+    Object.assign(result, scale);
+  }
+  return result;
+}
+//# sourceMappingURL=palette.js.map

package/lib/commonjs/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_leonardoContrastColors","require","REFERENCE_BACKGROUND","PALETTE_STEPS","CONTRAST_RATIOS","HEX_REGEX","validateHex","hex","TypeError","test","length","r","g","b","toLowerCase","generateColorScale","category","normalised","ratiosObject","step","color","Color","name","colorKeys","colorSpace","ratios","smooth","output","bg","BackgroundColor","theme","Theme","colors","backgroundColor","lightness","contrast","saturation","formula","pairs","contrastColorPairs","tokenPrefix","result","COLOR_INPUT_ENTRIES","generatePalettesFromInputs","inputs","inputKey","tokenPath","value","replace","scale","Object","assign"],"sourceRoot":"../../src","sources":["palette.ts"],"mappings":"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","ignoreList":[]}