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

package/lib/module/palette.js

@@ -0,0 +1,176 @@
+"use strict";
+
+import { BackgroundColor, Color, Theme } from '@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"`).
+ */
+export function generateColorScale(hex, category) {
+  const normalised = validateHex(hex);
+  const ratiosObject = {};
+  for (const step of PALETTE_STEPS) {
+    ratiosObject[step] = CONTRAST_RATIOS[step];
+  }
+  const color = new Color({
+    name: 'palette',
+    colorKeys: [normalised],
+    colorSpace: 'CAM02p',
+    ratios: ratiosObject,
+    smooth: true,
+    output: 'HEX'
+  });
+  const bg = new BackgroundColor({
+    name: 'background',
+    colorKeys: [REFERENCE_BACKGROUND],
+    colorSpace: 'CAM02p',
+    smooth: true,
+    ratios: [],
+    output: 'HEX'
+  });
+  const theme = new 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"
+ * // }
+ * ```
+ */
+export 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/module/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BackgroundColor","Color","Theme","REFERENCE_BACKGROUND","PALETTE_STEPS","CONTRAST_RATIOS","HEX_REGEX","validateHex","hex","TypeError","test","length","r","g","b","toLowerCase","generateColorScale","category","normalised","ratiosObject","step","color","name","colorKeys","colorSpace","ratios","smooth","output","bg","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":[]}

package/lib/module/theming.js

@@ -0,0 +1,202 @@
+"use strict";
+
+import { generatePalettesFromInputs } from './palette';
+import { INPUT_TOKEN_MAP, SUPPORTED_OVERRIDE_SCHEMA_VERSIONS } from './types';
+
+// ---------------------------------------------------------------------------
+// Re-export orchestrator
+// ---------------------------------------------------------------------------
+
+export { applyThemeOverride, DEFAULT_PRESET } from './applyThemeOverride';
+
+// ---------------------------------------------------------------------------
+// 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`.
+ */
+export function isSchemaVersionSupported(override) {
+  const version = override.$extensions['com.forge.ui.themeOverride'].schemaVersion;
+  return 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'`).
+ */
+export 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(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'`).
+ */
+export 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 = 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/module/theming.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["generatePalettesFromInputs","INPUT_TOKEN_MAP","SUPPORTED_OVERRIDE_SCHEMA_VERSIONS","applyThemeOverride","DEFAULT_PRESET","isSchemaVersionSupported","override","version","$extensions","schemaVersion","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","filter","tokenPath","themeOverrideToUniwindMaps","inputs","overrides","paletteTokens","fontTokens","inputKey","undefined","modes","mode","bucket","hexValue","modePrefixed","modeOverrides"],"sourceRoot":"../../src","sources":["theming.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/types.js

@@ -0,0 +1,71 @@
+"use strict";
+
+// ---------------------------------------------------------------------------
+// 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. */
+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']
+};
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OVERRIDE_SCHEMA_VERSION","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;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","ignoreList":[]}

package/lib/runtime/prestige-vs-default.json

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

package/lib/runtime/pulse-vs-default.json

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