@ankhorage/surface 3.1.3 → 3.2.0

package/dist/theme/createSurfaceSemanticPolicy.d.ts

@@ -0,0 +1,30 @@
+import type { ColorContrastContext, ColorSelectionTarget, ColorSwatch, ColorSwatchTiePolicy, HexColor, SemanticColorToken } from '@ankhorage/color-theory';
+import type { ContentSemantics, NeutralSemantics, SurfaceContrastDiagnostic, SurfaceSemantics } from './types';
+type ResolvedSemanticColors = Record<SemanticColorToken, HexColor>;
+interface SurfaceSemanticMeasurements {
+    measureForeground: (id: string, foreground: HexColor, background: HexColor, minimumContrast: number) => HexColor;
+    measureSurface: (id: string, foreground: HexColor, background: HexColor, minimumContrast: number) => SurfaceContrastDiagnostic;
+}
+/** Create the canonical Surface policy for selecting and measuring semantic colors. */
+export declare function createSurfaceSemanticPolicy(resolved: ResolvedSemanticColors, isDark: boolean, measurements: SurfaceSemanticMeasurements): SurfaceSemanticPolicy;
+declare class SurfaceSemanticPolicy {
+    private readonly resolved;
+    private readonly isDark;
+    private readonly measurements;
+    readonly adjacentSurfaceContexts: readonly ColorContrastContext[];
+    readonly textSurfaceContexts: readonly ColorContrastContext[];
+    readonly tiePolicy: ColorSwatchTiePolicy;
+    constructor(resolved: ResolvedSemanticColors, isDark: boolean, measurements: SurfaceSemanticMeasurements);
+    buildNeutral(neutralSwatch: ColorSwatch): NeutralSemantics;
+    buildSurface(inverse: HexColor): SurfaceSemantics;
+    measureContent(content: ContentSemantics, surface: SurfaceSemantics): void;
+    measureSurfaceSeparation(surface: SurfaceSemantics): SurfaceContrastDiagnostic[];
+    neutralTarget(): ColorSelectionTarget;
+    roleTarget(): ColorSelectionTarget;
+    strongNeutralTarget(): ColorSelectionTarget;
+    textTarget(): ColorSelectionTarget;
+    private createSurfaceContexts;
+    private measureSurface;
+}
+export {};
+//# sourceMappingURL=createSurfaceSemanticPolicy.d.ts.map

package/dist/theme/createSurfaceSemanticPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSurfaceSemanticPolicy.d.ts","sourceRoot":"","sources":["../../src/theme/createSurfaceSemanticPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,QAAQ,EACR,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,KAAK,sBAAsB,GAAG,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAEnE,UAAU,2BAA2B;IACnC,iBAAiB,EAAE,CACjB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,QAAQ,EACpB,UAAU,EAAE,QAAQ,EACpB,eAAe,EAAE,MAAM,KACpB,QAAQ,CAAC;IACd,cAAc,EAAE,CACd,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,QAAQ,EACpB,UAAU,EAAE,QAAQ,EACpB,eAAe,EAAE,MAAM,KACpB,yBAAyB,CAAC;CAChC;AAED,uFAAuF;AACvF,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,2BAA2B,yBAG1C;AAED,cAAM,qBAAqB;IAMvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAP/B,QAAQ,CAAC,uBAAuB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClE,QAAQ,CAAC,mBAAmB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9D,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;gBAGtB,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,2BAA2B;IAO5D,YAAY,CAAC,aAAa,EAAE,WAAW,GAAG,gBAAgB;IAkB1D,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,gBAAgB;IAajD,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IA4C1E,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,yBAAyB,EAAE;IAQhF,aAAa,IAAI,oBAAoB;IAIrC,UAAU,IAAI,oBAAoB;IAIlC,mBAAmB,IAAI,oBAAoB;IAI3C,UAAU,IAAI,oBAAoB;IAIlC,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,cAAc;CAQvB"}

package/dist/theme/createSurfaceSemanticPolicy.js

@@ -0,0 +1,118 @@
+import { parseHexColorOrThrow } from '@ankhorage/color-theory';
+import { SURFACE_COLOR_POLICY } from './surfaceColorPolicy';
+/** Create the canonical Surface policy for selecting and measuring semantic colors. */
+export function createSurfaceSemanticPolicy(resolved, isDark, measurements) {
+    return new SurfaceSemanticPolicy(resolved, isDark, measurements);
+}
+class SurfaceSemanticPolicy {
+    resolved;
+    isDark;
+    measurements;
+    adjacentSurfaceContexts;
+    textSurfaceContexts;
+    tiePolicy;
+    constructor(resolved, isDark, measurements) {
+        this.resolved = resolved;
+        this.isDark = isDark;
+        this.measurements = measurements;
+        this.adjacentSurfaceContexts = this.createSurfaceContexts(SURFACE_COLOR_POLICY.uiContrast);
+        this.textSurfaceContexts = this.createSurfaceContexts(SURFACE_COLOR_POLICY.textContrast);
+        this.tiePolicy = isDark ? 'lower-step' : 'higher-step';
+    }
+    buildNeutral(neutralSwatch) {
+        return {
+            bg: this.resolved.background,
+            bgSubtle: this.resolved.surface,
+            surface: this.resolved.surface,
+            surfaceHover: this.isDark ? neutralSwatch[800] : neutralSwatch[200],
+            surfaceActive: this.isDark ? neutralSwatch[700] : neutralSwatch[300],
+            border: this.resolved.border,
+            borderStrong: this.isDark ? neutralSwatch[600] : neutralSwatch[300],
+            divider: this.resolved.divider,
+            text: this.resolved.text,
+            textMuted: this.resolved.textMuted,
+            textSubtle: this.isDark ? neutralSwatch[300] : neutralSwatch[600],
+            disabledBg: this.resolved.disabledBg,
+            disabledText: this.resolved.disabledText,
+        };
+    }
+    buildSurface(inverse) {
+        return {
+            default: this.resolved.surface,
+            subtle: this.resolved.background,
+            raised: this.resolved.surfaceRaised,
+            sunken: this.resolved.background,
+            overlay: this.resolved.surfaceRaised,
+            scrim: '#0000008f',
+            disabled: this.resolved.disabledBg,
+            inverse,
+        };
+    }
+    measureContent(content, surface) {
+        const pairs = [
+            [
+                'content.default/background',
+                content.default,
+                surface.sunken,
+                SURFACE_COLOR_POLICY.textContrast,
+            ],
+            [
+                'content.default/surface',
+                content.default,
+                surface.default,
+                SURFACE_COLOR_POLICY.textContrast,
+            ],
+            ['content.muted/surface', content.muted, surface.default, SURFACE_COLOR_POLICY.textContrast],
+            [
+                'content.subtle/surface',
+                content.subtle,
+                surface.default,
+                SURFACE_COLOR_POLICY.textContrast,
+            ],
+            [
+                'content.disabled/disabled',
+                content.disabled,
+                surface.disabled,
+                SURFACE_COLOR_POLICY.disabledContrast,
+            ],
+            [
+                'content.inverse/inverse',
+                content.inverse,
+                surface.inverse,
+                SURFACE_COLOR_POLICY.textContrast,
+            ],
+        ];
+        for (const [id, foreground, background, minimumContrast] of pairs) {
+            this.measurements.measureForeground(id, parseHexColorOrThrow(foreground), parseHexColorOrThrow(background), minimumContrast);
+        }
+    }
+    measureSurfaceSeparation(surface) {
+        return [
+            this.measureSurface('surface.default', surface.default),
+            this.measureSurface('surface.raised', surface.raised),
+            this.measureSurface('surface.disabled', surface.disabled),
+        ];
+    }
+    neutralTarget() {
+        return { lightness: this.isDark ? 0.65 : 0.55, chroma: 0.02 };
+    }
+    roleTarget() {
+        return { lightness: this.isDark ? 0.65 : 0.5, chroma: 0.15 };
+    }
+    strongNeutralTarget() {
+        return { lightness: this.isDark ? 0.8 : 0.4, chroma: 0.02 };
+    }
+    textTarget() {
+        return { lightness: this.isDark ? 0.75 : 0.45, chroma: 0.15 };
+    }
+    createSurfaceContexts(minimumContrast) {
+        return [
+            { id: 'background', against: this.resolved.background, minimumContrast },
+            { id: 'surface', against: this.resolved.surface, minimumContrast },
+        ];
+    }
+    measureSurface(id, foreground) {
+        return this.measurements.measureSurface(id, parseHexColorOrThrow(foreground), this.resolved.background, SURFACE_COLOR_POLICY.surfaceSeparation);
+    }
+}
+//# sourceMappingURL=createSurfaceSemanticPolicy.js.map

package/dist/theme/createSurfaceSemanticPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSurfaceSemanticPolicy.js","sourceRoot":"","sources":["../../src/theme/createSurfaceSemanticPolicy.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ColorContrastContext,\n  ColorSelectionTarget,\n  ColorSwatch,\n  ColorSwatchTiePolicy,\n  HexColor,\n  SemanticColorToken,\n} from '@ankhorage/color-theory';\nimport { parseHexColorOrThrow } from '@ankhorage/color-theory';\n\nimport { SURFACE_COLOR_POLICY } from './surfaceColorPolicy';\nimport type {\n  ContentSemantics,\n  NeutralSemantics,\n  SurfaceContrastDiagnostic,\n  SurfaceSemantics,\n} from './types';\n\ntype ResolvedSemanticColors = Record<SemanticColorToken, HexColor>;\n\ninterface SurfaceSemanticMeasurements {\n  measureForeground: (\n    id: string,\n    foreground: HexColor,\n    background: HexColor,\n    minimumContrast: number,\n  ) => HexColor;\n  measureSurface: (\n    id: string,\n    foreground: HexColor,\n    background: HexColor,\n    minimumContrast: number,\n  ) => SurfaceContrastDiagnostic;\n}\n\n/** Create the canonical Surface policy for selecting and measuring semantic colors. */\nexport function createSurfaceSemanticPolicy(\n  resolved: ResolvedSemanticColors,\n  isDark: boolean,\n  measurements: SurfaceSemanticMeasurements,\n) {\n  return new SurfaceSemanticPolicy(resolved, isDark, measurements);\n}\n\nclass SurfaceSemanticPolicy {\n  readonly adjacentSurfaceContexts: readonly ColorContrastContext[];\n  readonly textSurfaceContexts: readonly ColorContrastContext[];\n  readonly tiePolicy: ColorSwatchTiePolicy;\n\n  constructor(\n    private readonly resolved: ResolvedSemanticColors,\n    private readonly isDark: boolean,\n    private readonly measurements: SurfaceSemanticMeasurements,\n  ) {\n    this.adjacentSurfaceContexts = this.createSurfaceContexts(SURFACE_COLOR_POLICY.uiContrast);\n    this.textSurfaceContexts = this.createSurfaceContexts(SURFACE_COLOR_POLICY.textContrast);\n    this.tiePolicy = isDark ? 'lower-step' : 'higher-step';\n  }\n\n  buildNeutral(neutralSwatch: ColorSwatch): NeutralSemantics {\n    return {\n      bg: this.resolved.background,\n      bgSubtle: this.resolved.surface,\n      surface: this.resolved.surface,\n      surfaceHover: this.isDark ? neutralSwatch[800] : neutralSwatch[200],\n      surfaceActive: this.isDark ? neutralSwatch[700] : neutralSwatch[300],\n      border: this.resolved.border,\n      borderStrong: this.isDark ? neutralSwatch[600] : neutralSwatch[300],\n      divider: this.resolved.divider,\n      text: this.resolved.text,\n      textMuted: this.resolved.textMuted,\n      textSubtle: this.isDark ? neutralSwatch[300] : neutralSwatch[600],\n      disabledBg: this.resolved.disabledBg,\n      disabledText: this.resolved.disabledText,\n    };\n  }\n\n  buildSurface(inverse: HexColor): SurfaceSemantics {\n    return {\n      default: this.resolved.surface,\n      subtle: this.resolved.background,\n      raised: this.resolved.surfaceRaised,\n      sunken: this.resolved.background,\n      overlay: this.resolved.surfaceRaised,\n      scrim: '#0000008f',\n      disabled: this.resolved.disabledBg,\n      inverse,\n    };\n  }\n\n  measureContent(content: ContentSemantics, surface: SurfaceSemantics): void {\n    const pairs = [\n      [\n        'content.default/background',\n        content.default,\n        surface.sunken,\n        SURFACE_COLOR_POLICY.textContrast,\n      ],\n      [\n        'content.default/surface',\n        content.default,\n        surface.default,\n        SURFACE_COLOR_POLICY.textContrast,\n      ],\n      ['content.muted/surface', content.muted, surface.default, SURFACE_COLOR_POLICY.textContrast],\n      [\n        'content.subtle/surface',\n        content.subtle,\n        surface.default,\n        SURFACE_COLOR_POLICY.textContrast,\n      ],\n      [\n        'content.disabled/disabled',\n        content.disabled,\n        surface.disabled,\n        SURFACE_COLOR_POLICY.disabledContrast,\n      ],\n      [\n        'content.inverse/inverse',\n        content.inverse,\n        surface.inverse,\n        SURFACE_COLOR_POLICY.textContrast,\n      ],\n    ] as const;\n    for (const [id, foreground, background, minimumContrast] of pairs) {\n      this.measurements.measureForeground(\n        id,\n        parseHexColorOrThrow(foreground),\n        parseHexColorOrThrow(background),\n        minimumContrast,\n      );\n    }\n  }\n\n  measureSurfaceSeparation(surface: SurfaceSemantics): SurfaceContrastDiagnostic[] {\n    return [\n      this.measureSurface('surface.default', surface.default),\n      this.measureSurface('surface.raised', surface.raised),\n      this.measureSurface('surface.disabled', surface.disabled),\n    ];\n  }\n\n  neutralTarget(): ColorSelectionTarget {\n    return { lightness: this.isDark ? 0.65 : 0.55, chroma: 0.02 };\n  }\n\n  roleTarget(): ColorSelectionTarget {\n    return { lightness: this.isDark ? 0.65 : 0.5, chroma: 0.15 };\n  }\n\n  strongNeutralTarget(): ColorSelectionTarget {\n    return { lightness: this.isDark ? 0.8 : 0.4, chroma: 0.02 };\n  }\n\n  textTarget(): ColorSelectionTarget {\n    return { lightness: this.isDark ? 0.75 : 0.45, chroma: 0.15 };\n  }\n\n  private createSurfaceContexts(minimumContrast: number): readonly ColorContrastContext[] {\n    return [\n      { id: 'background', against: this.resolved.background, minimumContrast },\n      { id: 'surface', against: this.resolved.surface, minimumContrast },\n    ];\n  }\n\n  private measureSurface(id: string, foreground: string): SurfaceContrastDiagnostic {\n    return this.measurements.measureSurface(\n      id,\n      parseHexColorOrThrow(foreground),\n      this.resolved.background,\n      SURFACE_COLOR_POLICY.surfaceSeparation,\n    );\n  }\n}\n"]}

package/dist/theme/createTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTheme.d.ts","sourceRoot":"","sources":["../../src/theme/createTheme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAO,MAAM,cAAc,EAAE,WAK5B,CAAC;AAcF,wBAAgB,WAAW,CACzB,MAAM,GAAE,WAA4B,EACpC,IAAI,GAAE,OAAO,GAAG,MAAgB,EAChC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,YAAY,CAYd"}
+{"version":3,"file":"createTheme.d.ts","sourceRoot":"","sources":["../../src/theme/createTheme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAO,MAAM,cAAc,EAAE,WAK5B,CAAC;AAcF,wBAAgB,WAAW,CACzB,MAAM,GAAE,WAA4B,EACpC,IAAI,GAAE,OAAO,GAAG,MAAgB,EAChC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,YAAY,CAad"}

package/dist/theme/createTheme.js

@@ -19,12 +19,13 @@ const ACTIVE_FONT_WEIGHTS = [
     '900',
 ];
 export function createTheme(config = DEFAULT_CONFIG, mode = 'light', activeFontId) {
-    const { colors, swatches, semantics } = generatePalette(config, mode);
+    const { colors, swatches, semantics, colorDiagnostics } = generatePalette(config, mode);
     const theme = {
         ...resolveGlobalTokens(config.tokens),
         colors,
         swatches,
         semantics,
+        colorDiagnostics,
         config,
     };
     applyActiveFont(theme, activeFontId);

package/dist/theme/createTheme.js.map

@@ -1 +1 @@
-{"version":3,"file":"createTheme.js","sourceRoot":"","sources":["../../src/theme/createTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE;IAC5D,IAAI,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE;CAC5D,CAAC;AAEF,MAAM,mBAAmB,GAA0B;IACjD,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,SAAsB,cAAc,EACpC,OAAyB,OAAO,EAChC,YAA4B;IAE5B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtE,MAAM,KAAK,GAAiB;QAC1B,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC;QACrC,MAAM;QACN,QAAQ;QACR,SAAS;QACT,MAAM;KACP,CAAC;IAEF,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB,EAAE,YAAuC;IACnF,IAAI,CAAC,YAAY;QAAE,OAAO;IAE1B,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC9C,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACzC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,UAAU,IAAI,MAAM,SAAS,CAAC;QACzE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,UAAU,IAAI,MAAM,QAAQ,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK;SACT,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC","sourcesContent":["import { generatePalette } from './colorEngine';\nimport { resolveGlobalTokens } from './resolveGlobalTokens';\nimport type { FontWeight, SurfaceTheme, ThemeConfig } from './types';\n\nexport { DEFAULT_TOKENS } from './defaultTokens';\n\nexport const DEFAULT_CONFIG: ThemeConfig = {\n  id: 'default',\n  name: 'Default',\n  light: { primaryColor: '#3B82F6', harmony: 'monochromatic' },\n  dark: { primaryColor: '#3B82F6', harmony: 'monochromatic' },\n};\n\nconst ACTIVE_FONT_WEIGHTS: readonly FontWeight[] = [\n  '100',\n  '200',\n  '300',\n  '400',\n  '500',\n  '600',\n  '700',\n  '800',\n  '900',\n];\n\nexport function createTheme(\n  config: ThemeConfig = DEFAULT_CONFIG,\n  mode: 'light' | 'dark' = 'light',\n  activeFontId?: string | null,\n): SurfaceTheme {\n  const { colors, swatches, semantics } = generatePalette(config, mode);\n  const theme: SurfaceTheme = {\n    ...resolveGlobalTokens(config.tokens),\n    colors,\n    swatches,\n    semantics,\n    config,\n  };\n\n  applyActiveFont(theme, activeFontId);\n  return theme;\n}\n\nfunction applyActiveFont(theme: SurfaceTheme, activeFontId: string | null | undefined): void {\n  if (!activeFontId) return;\n\n  const familyName = toPascalCase(activeFontId);\n  for (const weight of ACTIVE_FONT_WEIGHTS) {\n    theme.typography.fonts.normal[weight] = `${familyName}_${weight}Regular`;\n    theme.typography.fonts.italic[weight] = `${familyName}_${weight}Italic`;\n  }\n}\n\nfunction toPascalCase(value: string): string {\n  return value\n    .split(/[- ]+/)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join('');\n}\n"]}
+{"version":3,"file":"createTheme.js","sourceRoot":"","sources":["../../src/theme/createTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE;IAC5D,IAAI,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE;CAC5D,CAAC;AAEF,MAAM,mBAAmB,GAA0B;IACjD,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,SAAsB,cAAc,EACpC,OAAyB,OAAO,EAChC,YAA4B;IAE5B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxF,MAAM,KAAK,GAAiB;QAC1B,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC;QACrC,MAAM;QACN,QAAQ;QACR,SAAS;QACT,gBAAgB;QAChB,MAAM;KACP,CAAC;IAEF,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB,EAAE,YAAuC;IACnF,IAAI,CAAC,YAAY;QAAE,OAAO;IAE1B,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC9C,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACzC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,UAAU,IAAI,MAAM,SAAS,CAAC;QACzE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,UAAU,IAAI,MAAM,QAAQ,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK;SACT,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC","sourcesContent":["import { generatePalette } from './colorEngine';\nimport { resolveGlobalTokens } from './resolveGlobalTokens';\nimport type { FontWeight, SurfaceTheme, ThemeConfig } from './types';\n\nexport { DEFAULT_TOKENS } from './defaultTokens';\n\nexport const DEFAULT_CONFIG: ThemeConfig = {\n  id: 'default',\n  name: 'Default',\n  light: { primaryColor: '#3B82F6', harmony: 'monochromatic' },\n  dark: { primaryColor: '#3B82F6', harmony: 'monochromatic' },\n};\n\nconst ACTIVE_FONT_WEIGHTS: readonly FontWeight[] = [\n  '100',\n  '200',\n  '300',\n  '400',\n  '500',\n  '600',\n  '700',\n  '800',\n  '900',\n];\n\nexport function createTheme(\n  config: ThemeConfig = DEFAULT_CONFIG,\n  mode: 'light' | 'dark' = 'light',\n  activeFontId?: string | null,\n): SurfaceTheme {\n  const { colors, swatches, semantics, colorDiagnostics } = generatePalette(config, mode);\n  const theme: SurfaceTheme = {\n    ...resolveGlobalTokens(config.tokens),\n    colors,\n    swatches,\n    semantics,\n    colorDiagnostics,\n    config,\n  };\n\n  applyActiveFont(theme, activeFontId);\n  return theme;\n}\n\nfunction applyActiveFont(theme: SurfaceTheme, activeFontId: string | null | undefined): void {\n  if (!activeFontId) return;\n\n  const familyName = toPascalCase(activeFontId);\n  for (const weight of ACTIVE_FONT_WEIGHTS) {\n    theme.typography.fonts.normal[weight] = `${familyName}_${weight}Regular`;\n    theme.typography.fonts.italic[weight] = `${familyName}_${weight}Italic`;\n  }\n}\n\nfunction toPascalCase(value: string): string {\n  return value\n    .split(/[- ]+/)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join('');\n}\n"]}

package/dist/theme/defaultTokens.d.ts

@@ -1,3 +1,3 @@
 import type { ThemeTokens } from './types';
-export declare const DEFAULT_TOKENS: Omit<ThemeTokens, 'colors' | 'swatches' | 'semantics'>;
+export declare const DEFAULT_TOKENS: Omit<ThemeTokens, 'colors' | 'swatches' | 'semantics' | 'colorDiagnostics'>;
 //# sourceMappingURL=defaultTokens.d.ts.map

package/dist/theme/defaultTokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultTokens.d.ts","sourceRoot":"","sources":["../../src/theme/defaultTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,SAAS,CAAC;AAgBvD,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAyCjF,CAAC"}
+{"version":3,"file":"defaultTokens.d.ts","sourceRoot":"","sources":["../../src/theme/defaultTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,SAAS,CAAC;AAgBvD,eAAO,MAAM,cAAc,EAAE,IAAI,CAC/B,WAAW,EACX,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,kBAAkB,CA0CzD,CAAC"}

package/dist/theme/defaultTokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultTokens.js","sourceRoot":"","sources":["../../src/theme/defaultTokens.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAA2C;IAC7D,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA2D;IACpF,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IAChE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACjD,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;YAC/C,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;YAC/C,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;YAC/C,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;YACnD,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;YACnD,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;SACpD;QACD,KAAK,EAAE;YACL,EAAE,EAAE,EAAE;YACN,CAAC,EAAE,EAAE;YACL,CAAC,EAAE,EAAE;YACL,CAAC,EAAE,EAAE;YACL,EAAE,EAAE,EAAE;YACN,GAAG,EAAE,EAAE;YACP,KAAK,EAAE,EAAE;YACT,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;SACP;QACD,OAAO,EAAE;YACP,IAAI,EAAE,KAAK;YACX,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,KAAK;SACb;QACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,cAAc,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,cAAc,EAAE,EAAE;KACxE;IACD,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;CACzC,CAAC","sourcesContent":["import type { FontWeight, ThemeTokens } from './types';\n\nconst EMPTY_FONT_MAP: Record<FontWeight, string | undefined> = {\n  '100': undefined,\n  '200': undefined,\n  '300': undefined,\n  '400': undefined,\n  '500': undefined,\n  '600': undefined,\n  '700': undefined,\n  '800': undefined,\n  '900': undefined,\n  bold: undefined,\n  normal: undefined,\n};\n\nexport const DEFAULT_TOKENS: Omit<ThemeTokens, 'colors' | 'swatches' | 'semantics'> = {\n  spacing: { none: 0, xs: 4, s: 8, m: 16, l: 24, xl: 32, xxl: 48 },\n  radii: { none: 0, s: 4, m: 8, l: 16, full: 9999 },\n  typography: {\n    headings: {\n      1: { size: 32, lineHeight: 40, weight: 'bold' },\n      2: { size: 24, lineHeight: 32, weight: 'bold' },\n      3: { size: 20, lineHeight: 28, weight: 'bold' },\n      4: { size: 18, lineHeight: 24, weight: 'semiBold' },\n      5: { size: 16, lineHeight: 22, weight: 'semiBold' },\n      6: { size: 14, lineHeight: 20, weight: 'semiBold' },\n    },\n    sizes: {\n      xs: 12,\n      s: 14,\n      m: 16,\n      l: 18,\n      xl: 20,\n      xxl: 24,\n      '3xl': 30,\n      h1: 32,\n      h2: 24,\n      h3: 20,\n      h4: 18,\n      h5: 16,\n      h6: 14,\n    },\n    weights: {\n      thin: '100',\n      extraLight: '200',\n      light: '300',\n      regular: '400',\n      medium: '500',\n      semiBold: '600',\n      bold: '700',\n      extraBold: '800',\n      black: '900',\n    },\n    fonts: { normal: { ...EMPTY_FONT_MAP }, italic: { ...EMPTY_FONT_MAP } },\n  },\n  shadows: { soft: 2, medium: 4, hard: 8 },\n};\n"]}
+{"version":3,"file":"defaultTokens.js","sourceRoot":"","sources":["../../src/theme/defaultTokens.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAA2C;IAC7D,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAGvB;IACF,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IAChE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACjD,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;YAC/C,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;YAC/C,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;YAC/C,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;YACnD,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;YACnD,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;SACpD;QACD,KAAK,EAAE;YACL,EAAE,EAAE,EAAE;YACN,CAAC,EAAE,EAAE;YACL,CAAC,EAAE,EAAE;YACL,CAAC,EAAE,EAAE;YACL,EAAE,EAAE,EAAE;YACN,GAAG,EAAE,EAAE;YACP,KAAK,EAAE,EAAE;YACT,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;YACN,EAAE,EAAE,EAAE;SACP;QACD,OAAO,EAAE;YACP,IAAI,EAAE,KAAK;YACX,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,KAAK;SACb;QACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,cAAc,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,cAAc,EAAE,EAAE;KACxE;IACD,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;CACzC,CAAC","sourcesContent":["import type { FontWeight, ThemeTokens } from './types';\n\nconst EMPTY_FONT_MAP: Record<FontWeight, string | undefined> = {\n  '100': undefined,\n  '200': undefined,\n  '300': undefined,\n  '400': undefined,\n  '500': undefined,\n  '600': undefined,\n  '700': undefined,\n  '800': undefined,\n  '900': undefined,\n  bold: undefined,\n  normal: undefined,\n};\n\nexport const DEFAULT_TOKENS: Omit<\n  ThemeTokens,\n  'colors' | 'swatches' | 'semantics' | 'colorDiagnostics'\n> = {\n  spacing: { none: 0, xs: 4, s: 8, m: 16, l: 24, xl: 32, xxl: 48 },\n  radii: { none: 0, s: 4, m: 8, l: 16, full: 9999 },\n  typography: {\n    headings: {\n      1: { size: 32, lineHeight: 40, weight: 'bold' },\n      2: { size: 24, lineHeight: 32, weight: 'bold' },\n      3: { size: 20, lineHeight: 28, weight: 'bold' },\n      4: { size: 18, lineHeight: 24, weight: 'semiBold' },\n      5: { size: 16, lineHeight: 22, weight: 'semiBold' },\n      6: { size: 14, lineHeight: 20, weight: 'semiBold' },\n    },\n    sizes: {\n      xs: 12,\n      s: 14,\n      m: 16,\n      l: 18,\n      xl: 20,\n      xxl: 24,\n      '3xl': 30,\n      h1: 32,\n      h2: 24,\n      h3: 20,\n      h4: 18,\n      h5: 16,\n      h6: 14,\n    },\n    weights: {\n      thin: '100',\n      extraLight: '200',\n      light: '300',\n      regular: '400',\n      medium: '500',\n      semiBold: '600',\n      bold: '700',\n      extraBold: '800',\n      black: '900',\n    },\n    fonts: { normal: { ...EMPTY_FONT_MAP }, italic: { ...EMPTY_FONT_MAP } },\n  },\n  shadows: { soft: 2, medium: 4, hard: 8 },\n};\n"]}

package/dist/theme/resolveGlobalTokens.d.ts

@@ -1,6 +1,6 @@
 import type { ThemeGlobalTokenOverrides } from '@ankhorage/contracts';
 import type { ThemeTokens } from './types';
-type GlobalThemeTokens = Omit<ThemeTokens, 'colors' | 'swatches' | 'semantics'>;
+type GlobalThemeTokens = Omit<ThemeTokens, 'colors' | 'swatches' | 'semantics' | 'colorDiagnostics'>;
 export declare function resolveGlobalTokens(overrides?: ThemeGlobalTokenOverrides): GlobalThemeTokens;
 export {};
 //# sourceMappingURL=resolveGlobalTokens.d.ts.map

package/dist/theme/resolveGlobalTokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveGlobalTokens.d.ts","sourceRoot":"","sources":["../../src/theme/resolveGlobalTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAMtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,KAAK,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;AAEhF,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,yBAAyB,GAAG,iBAAiB,CAmC5F"}
+{"version":3,"file":"resolveGlobalTokens.d.ts","sourceRoot":"","sources":["../../src/theme/resolveGlobalTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAMtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,KAAK,iBAAiB,GAAG,IAAI,CAC3B,WAAW,EACX,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,kBAAkB,CACzD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,yBAAyB,GAAG,iBAAiB,CAmC5F"}

package/dist/theme/resolveGlobalTokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveGlobalTokens.js","sourceRoot":"","sources":["../../src/theme/resolveGlobalTokens.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAK5E,MAAM,UAAU,mBAAmB,CAAC,SAAqC;IACvE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,SAAS,EAAE,UAAU,CAAC;IACzC,OAAO;QACL,OAAO,EAAE;YACP,GAAG,cAAc,CAAC,OAAO;YACzB,GAAG,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;SAC/D;QACD,KAAK,EAAE;YACL,GAAG,cAAc,CAAC,KAAK;YACvB,GAAG,4BAA4B,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC;SAC3D;QACD,UAAU,EAAE;YACV,QAAQ,EAAE,4BAA4B,CACpC,cAAc,CAAC,UAAU,CAAC,QAAQ,EAClC,UAAU,EAAE,QAAQ,CACrB;YACD,KAAK,EAAE;gBACL,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK;gBAClC,GAAG,4BAA4B,CAAC,kBAAkB,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC;aAC7E;YACD,OAAO,EAAE;gBACP,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO;gBACpC,GAAG,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC;aACpD;YACD,KAAK,EAAE;gBACL,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE;gBACrD,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE;aACtD;SACF;QACD,OAAO,EAAE;YACP,GAAG,cAAc,CAAC,OAAO;YACzB,GAAG,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;SAC/D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAgD;IAC1E,IAAI,SAAS,EAAE,OAAO,EAAE,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,SAAS,EAAE,KAAK,EAAE,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;IAChE,CAAC;AACH,CAAC","sourcesContent":["import type { ThemeGlobalTokenOverrides } from '@ankhorage/contracts';\n\nimport { DEFAULT_TOKENS } from './defaultTokens';\nimport { resolveHeadingTokenOverrides } from './resolveHeadingTokenOverrides';\nimport { resolveNumericTokenOverrides } from './resolveNumericTokenOverrides';\nimport { resolveWeightTokenOverrides } from './resolveWeightTokenOverrides';\nimport type { ThemeTokens } from './types';\n\ntype GlobalThemeTokens = Omit<ThemeTokens, 'colors' | 'swatches' | 'semantics'>;\n\nexport function resolveGlobalTokens(overrides?: ThemeGlobalTokenOverrides): GlobalThemeTokens {\n  validateZeroTokens(overrides);\n  const typography = overrides?.typography;\n  return {\n    spacing: {\n      ...DEFAULT_TOKENS.spacing,\n      ...resolveNumericTokenOverrides('spacing', overrides?.spacing),\n    },\n    radii: {\n      ...DEFAULT_TOKENS.radii,\n      ...resolveNumericTokenOverrides('radii', overrides?.radii),\n    },\n    typography: {\n      headings: resolveHeadingTokenOverrides(\n        DEFAULT_TOKENS.typography.headings,\n        typography?.headings,\n      ),\n      sizes: {\n        ...DEFAULT_TOKENS.typography.sizes,\n        ...resolveNumericTokenOverrides('typography.sizes', typography?.sizes, true),\n      },\n      weights: {\n        ...DEFAULT_TOKENS.typography.weights,\n        ...resolveWeightTokenOverrides(typography?.weights),\n      },\n      fonts: {\n        normal: { ...DEFAULT_TOKENS.typography.fonts.normal },\n        italic: { ...DEFAULT_TOKENS.typography.fonts.italic },\n      },\n    },\n    shadows: {\n      ...DEFAULT_TOKENS.shadows,\n      ...resolveNumericTokenOverrides('shadows', overrides?.shadows),\n    },\n  };\n}\n\nfunction validateZeroTokens(overrides: ThemeGlobalTokenOverrides | undefined): void {\n  if (overrides?.spacing?.none !== undefined && overrides.spacing.none !== 0) {\n    throw new RangeError('Theme token spacing.none must remain 0.');\n  }\n  if (overrides?.radii?.none !== undefined && overrides.radii.none !== 0) {\n    throw new RangeError('Theme token radii.none must remain 0.');\n  }\n}\n"]}
+{"version":3,"file":"resolveGlobalTokens.js","sourceRoot":"","sources":["../../src/theme/resolveGlobalTokens.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAQ5E,MAAM,UAAU,mBAAmB,CAAC,SAAqC;IACvE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,SAAS,EAAE,UAAU,CAAC;IACzC,OAAO;QACL,OAAO,EAAE;YACP,GAAG,cAAc,CAAC,OAAO;YACzB,GAAG,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;SAC/D;QACD,KAAK,EAAE;YACL,GAAG,cAAc,CAAC,KAAK;YACvB,GAAG,4BAA4B,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC;SAC3D;QACD,UAAU,EAAE;YACV,QAAQ,EAAE,4BAA4B,CACpC,cAAc,CAAC,UAAU,CAAC,QAAQ,EAClC,UAAU,EAAE,QAAQ,CACrB;YACD,KAAK,EAAE;gBACL,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK;gBAClC,GAAG,4BAA4B,CAAC,kBAAkB,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC;aAC7E;YACD,OAAO,EAAE;gBACP,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO;gBACpC,GAAG,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC;aACpD;YACD,KAAK,EAAE;gBACL,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE;gBACrD,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE;aACtD;SACF;QACD,OAAO,EAAE;YACP,GAAG,cAAc,CAAC,OAAO;YACzB,GAAG,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;SAC/D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAgD;IAC1E,IAAI,SAAS,EAAE,OAAO,EAAE,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,SAAS,EAAE,KAAK,EAAE,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;IAChE,CAAC;AACH,CAAC","sourcesContent":["import type { ThemeGlobalTokenOverrides } from '@ankhorage/contracts';\n\nimport { DEFAULT_TOKENS } from './defaultTokens';\nimport { resolveHeadingTokenOverrides } from './resolveHeadingTokenOverrides';\nimport { resolveNumericTokenOverrides } from './resolveNumericTokenOverrides';\nimport { resolveWeightTokenOverrides } from './resolveWeightTokenOverrides';\nimport type { ThemeTokens } from './types';\n\ntype GlobalThemeTokens = Omit<\n  ThemeTokens,\n  'colors' | 'swatches' | 'semantics' | 'colorDiagnostics'\n>;\n\nexport function resolveGlobalTokens(overrides?: ThemeGlobalTokenOverrides): GlobalThemeTokens {\n  validateZeroTokens(overrides);\n  const typography = overrides?.typography;\n  return {\n    spacing: {\n      ...DEFAULT_TOKENS.spacing,\n      ...resolveNumericTokenOverrides('spacing', overrides?.spacing),\n    },\n    radii: {\n      ...DEFAULT_TOKENS.radii,\n      ...resolveNumericTokenOverrides('radii', overrides?.radii),\n    },\n    typography: {\n      headings: resolveHeadingTokenOverrides(\n        DEFAULT_TOKENS.typography.headings,\n        typography?.headings,\n      ),\n      sizes: {\n        ...DEFAULT_TOKENS.typography.sizes,\n        ...resolveNumericTokenOverrides('typography.sizes', typography?.sizes, true),\n      },\n      weights: {\n        ...DEFAULT_TOKENS.typography.weights,\n        ...resolveWeightTokenOverrides(typography?.weights),\n      },\n      fonts: {\n        normal: { ...DEFAULT_TOKENS.typography.fonts.normal },\n        italic: { ...DEFAULT_TOKENS.typography.fonts.italic },\n      },\n    },\n    shadows: {\n      ...DEFAULT_TOKENS.shadows,\n      ...resolveNumericTokenOverrides('shadows', overrides?.shadows),\n    },\n  };\n}\n\nfunction validateZeroTokens(overrides: ThemeGlobalTokenOverrides | undefined): void {\n  if (overrides?.spacing?.none !== undefined && overrides.spacing.none !== 0) {\n    throw new RangeError('Theme token spacing.none must remain 0.');\n  }\n  if (overrides?.radii?.none !== undefined && overrides.radii.none !== 0) {\n    throw new RangeError('Theme token radii.none must remain 0.');\n  }\n}\n"]}

package/dist/theme/resolveRoleSemantics.d.ts

@@ -0,0 +1,19 @@
+import type { ColorSwatch, HexColor } from '@ankhorage/color-theory';
+import type { RoleSemantics } from './types';
+interface ResolveRoleSemanticsInput {
+    base?: HexColor;
+    disabledBg: HexColor;
+    disabledText: HexColor;
+    hover?: HexColor;
+    id: string;
+    isDark: boolean;
+    measureForeground: (id: string, foreground: HexColor, background: HexColor, minimumContrast: number) => HexColor;
+    onSurfaceText: HexColor;
+    outline: HexColor;
+    selectForeground: (id: string, background: HexColor, minimumContrast: number) => HexColor;
+    swatch: ColorSwatch;
+}
+/** Resolve every filled role state together with its measured foreground. */
+export declare function resolveRoleSemantics({ base, disabledBg, disabledText, hover, id, isDark, measureForeground, onSurfaceText, outline, selectForeground, swatch, }: ResolveRoleSemanticsInput): RoleSemantics;
+export {};
+//# sourceMappingURL=resolveRoleSemantics.d.ts.map

package/dist/theme/resolveRoleSemantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRoleSemantics.d.ts","sourceRoot":"","sources":["../../src/theme/resolveRoleSemantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,UAAU,yBAAyB;IACjC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,QAAQ,CAAC;IACrB,YAAY,EAAE,QAAQ,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,CACjB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,QAAQ,EACpB,UAAU,EAAE,QAAQ,EACpB,eAAe,EAAE,MAAM,KACpB,QAAQ,CAAC;IACd,aAAa,EAAE,QAAQ,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC;IAClB,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,KAAK,QAAQ,CAAC;IAC1F,MAAM,EAAE,WAAW,CAAC;CACrB;AAWD,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,KAAK,EACL,EAAE,EACF,MAAM,EACN,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,MAAM,GACP,EAAE,yBAAyB,GAAG,aAAa,CAiC3C"}

package/dist/theme/resolveRoleSemantics.js

@@ -0,0 +1,29 @@
+import { SURFACE_COLOR_POLICY } from './surfaceColorPolicy';
+/** Resolve every filled role state together with its measured foreground. */
+export function resolveRoleSemantics({ base, disabledBg, disabledText, hover, id, isDark, measureForeground, onSurfaceText, outline, selectForeground, swatch, }) {
+    const states = resolveRoleStateColors(swatch, isDark, base, hover);
+    return {
+        ...states,
+        outline,
+        onSurfaceText,
+        onSolidText: selectForeground(`${id}.base`, states.base, SURFACE_COLOR_POLICY.textContrast),
+        onHoverText: selectForeground(`${id}.hover`, states.hover, SURFACE_COLOR_POLICY.textContrast),
+        onStrongText: selectForeground(`${id}.strong`, states.strong, SURFACE_COLOR_POLICY.textContrast),
+        onSoftText: selectForeground(`${id}.soft`, states.softBg, SURFACE_COLOR_POLICY.textContrast),
+        onSoftHoverText: selectForeground(`${id}.softHover`, states.softHover, SURFACE_COLOR_POLICY.textContrast),
+        onSoftActiveText: selectForeground(`${id}.softActive`, states.softActive, SURFACE_COLOR_POLICY.textContrast),
+        disabledBg,
+        onDisabledText: measureForeground(`${id}.disabled`, disabledText, disabledBg, SURFACE_COLOR_POLICY.disabledContrast),
+    };
+}
+function resolveRoleStateColors(swatch, isDark, base, hover) {
+    return {
+        base: base ?? swatch[500],
+        hover: hover ?? (isDark ? swatch[400] : swatch[600]),
+        strong: isDark ? swatch[300] : swatch[700],
+        softBg: isDark ? swatch[900] : swatch[100],
+        softHover: isDark ? swatch[800] : swatch[200],
+        softActive: isDark ? swatch[700] : swatch[300],
+    };
+}
+//# sourceMappingURL=resolveRoleSemantics.js.map

package/dist/theme/resolveRoleSemantics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRoleSemantics.js","sourceRoot":"","sources":["../../src/theme/resolveRoleSemantics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA+B5D,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,EACnC,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,KAAK,EACL,EAAE,EACF,MAAM,EACN,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,MAAM,GACoB;IAC1B,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAEnE,OAAO;QACL,GAAG,MAAM;QACT,OAAO;QACP,aAAa;QACb,WAAW,EAAE,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,YAAY,CAAC;QAC3F,WAAW,EAAE,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,oBAAoB,CAAC,YAAY,CAAC;QAC7F,YAAY,EAAE,gBAAgB,CAC5B,GAAG,EAAE,SAAS,EACd,MAAM,CAAC,MAAM,EACb,oBAAoB,CAAC,YAAY,CAClC;QACD,UAAU,EAAE,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,YAAY,CAAC;QAC5F,eAAe,EAAE,gBAAgB,CAC/B,GAAG,EAAE,YAAY,EACjB,MAAM,CAAC,SAAS,EAChB,oBAAoB,CAAC,YAAY,CAClC;QACD,gBAAgB,EAAE,gBAAgB,CAChC,GAAG,EAAE,aAAa,EAClB,MAAM,CAAC,UAAU,EACjB,oBAAoB,CAAC,YAAY,CAClC;QACD,UAAU;QACV,cAAc,EAAE,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,YAAY,EACZ,UAAU,EACV,oBAAoB,CAAC,gBAAgB,CACtC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAAmB,EACnB,MAAe,EACf,IAAe,EACf,KAAgB;IAEhB,OAAO;QACL,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC;QACzB,KAAK,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC1C,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC1C,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC7C,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;KAC/C,CAAC;AACJ,CAAC","sourcesContent":["import type { ColorSwatch, HexColor } from '@ankhorage/color-theory';\n\nimport { SURFACE_COLOR_POLICY } from './surfaceColorPolicy';\nimport type { RoleSemantics } from './types';\n\ninterface ResolveRoleSemanticsInput {\n  base?: HexColor;\n  disabledBg: HexColor;\n  disabledText: HexColor;\n  hover?: HexColor;\n  id: string;\n  isDark: boolean;\n  measureForeground: (\n    id: string,\n    foreground: HexColor,\n    background: HexColor,\n    minimumContrast: number,\n  ) => HexColor;\n  onSurfaceText: HexColor;\n  outline: HexColor;\n  selectForeground: (id: string, background: HexColor, minimumContrast: number) => HexColor;\n  swatch: ColorSwatch;\n}\n\ninterface RoleStateColors {\n  base: HexColor;\n  hover: HexColor;\n  softActive: HexColor;\n  softBg: HexColor;\n  softHover: HexColor;\n  strong: HexColor;\n}\n\n/** Resolve every filled role state together with its measured foreground. */\nexport function resolveRoleSemantics({\n  base,\n  disabledBg,\n  disabledText,\n  hover,\n  id,\n  isDark,\n  measureForeground,\n  onSurfaceText,\n  outline,\n  selectForeground,\n  swatch,\n}: ResolveRoleSemanticsInput): RoleSemantics {\n  const states = resolveRoleStateColors(swatch, isDark, base, hover);\n\n  return {\n    ...states,\n    outline,\n    onSurfaceText,\n    onSolidText: selectForeground(`${id}.base`, states.base, SURFACE_COLOR_POLICY.textContrast),\n    onHoverText: selectForeground(`${id}.hover`, states.hover, SURFACE_COLOR_POLICY.textContrast),\n    onStrongText: selectForeground(\n      `${id}.strong`,\n      states.strong,\n      SURFACE_COLOR_POLICY.textContrast,\n    ),\n    onSoftText: selectForeground(`${id}.soft`, states.softBg, SURFACE_COLOR_POLICY.textContrast),\n    onSoftHoverText: selectForeground(\n      `${id}.softHover`,\n      states.softHover,\n      SURFACE_COLOR_POLICY.textContrast,\n    ),\n    onSoftActiveText: selectForeground(\n      `${id}.softActive`,\n      states.softActive,\n      SURFACE_COLOR_POLICY.textContrast,\n    ),\n    disabledBg,\n    onDisabledText: measureForeground(\n      `${id}.disabled`,\n      disabledText,\n      disabledBg,\n      SURFACE_COLOR_POLICY.disabledContrast,\n    ),\n  };\n}\n\nfunction resolveRoleStateColors(\n  swatch: ColorSwatch,\n  isDark: boolean,\n  base?: HexColor,\n  hover?: HexColor,\n): RoleStateColors {\n  return {\n    base: base ?? swatch[500],\n    hover: hover ?? (isDark ? swatch[400] : swatch[600]),\n    strong: isDark ? swatch[300] : swatch[700],\n    softBg: isDark ? swatch[900] : swatch[100],\n    softHover: isDark ? swatch[800] : swatch[200],\n    softActive: isDark ? swatch[700] : swatch[300],\n  };\n}\n"]}

package/dist/theme/resolveSurfaceSemanticModel.d.ts

@@ -0,0 +1,16 @@
+import type { GeneratedThemeModeColors, HexColor, SemanticColorReferenceMap, SemanticColorToken, ThemeColorMode } from '@ankhorage/color-theory';
+import type { SurfaceColorDiagnostics, ThemeSemantics } from './types';
+type ResolvedSemanticColors = Record<SemanticColorToken, HexColor>;
+interface ResolveSurfaceSemanticModelInput {
+    generated: GeneratedThemeModeColors;
+    mode: ThemeColorMode;
+    references: SemanticColorReferenceMap;
+    resolved: ResolvedSemanticColors;
+}
+/** Resolve the complete Surface-owned semantic model from canonical Color Theory output. */
+export declare function resolveSurfaceSemanticModel(input: ResolveSurfaceSemanticModelInput): {
+    semantics: ThemeSemantics;
+    colorDiagnostics: SurfaceColorDiagnostics;
+};
+export {};
+//# sourceMappingURL=resolveSurfaceSemanticModel.d.ts.map

package/dist/theme/resolveSurfaceSemanticModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSurfaceSemanticModel.d.ts","sourceRoot":"","sources":["../../src/theme/resolveSurfaceSemanticModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,wBAAwB,EAExB,QAAQ,EACR,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAIV,uBAAuB,EACvB,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB,KAAK,sBAAsB,GAAG,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAkBnE,UAAU,gCAAgC;IACxC,SAAS,EAAE,wBAAwB,CAAC;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,yBAAyB,CAAC;IACtC,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,4FAA4F;AAC5F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,gCAAgC,GAAG;IACpF,SAAS,EAAE,cAAc,CAAC;IAC1B,gBAAgB,EAAE,uBAAuB,CAAC;CAC3C,CA2CA"}

package/dist/theme/resolveSurfaceSemanticModel.js

@@ -0,0 +1,128 @@
+import { createDefaultSemanticStatusSwatches } from '@ankhorage/color-theory';
+import { createSurfaceColorDiagnosticCollector } from './createSurfaceColorDiagnosticCollector';
+import { createSurfaceSemanticPolicy } from './createSurfaceSemanticPolicy';
+import { resolveRoleSemantics } from './resolveRoleSemantics';
+/** Resolve the complete Surface-owned semantic model from canonical Color Theory output. */
+export function resolveSurfaceSemanticModel(input) {
+    const context = createResolutionContext(input);
+    const roles = resolveSemanticRoles(context);
+    const inverseSurface = context.isDark ? context.neutralSwatch[50] : context.neutralSwatch[900];
+    const inverseContent = context.isDark ? context.neutralSwatch[900] : context.neutralSwatch[50];
+    const neutral = context.policy.buildNeutral(context.neutralSwatch);
+    const surface = context.policy.buildSurface(inverseSurface);
+    const content = resolveContentSemantics(context, neutral.textSubtle, inverseContent);
+    const border = resolveBorderSemantics(context, roles.brand.outline);
+    context.policy.measureContent(content, surface);
+    return {
+        semantics: {
+            neutral,
+            brand: roles.brand,
+            secondary: roles.secondary,
+            accent: roles.accent,
+            highlight: roles.highlight,
+            danger: roles.danger,
+            success: roles.success,
+            warning: roles.warning,
+            error: roles.danger,
+            info: roles.info,
+            surface,
+            content,
+            border,
+            selection: {
+                background: roles.brand.softBg,
+                content: roles.brand.onSoftText,
+                border: border.focus,
+            },
+            action: { primary: roles.brand, neutral: roles.neutralAction, danger: roles.danger },
+        },
+        colorDiagnostics: {
+            mode: context.mode,
+            generated: context.generated,
+            semanticReferences: context.references,
+            statusSwatches: context.statusSwatches.diagnostics,
+            selections: context.collector.selections,
+            contrasts: context.collector.contrasts,
+            surfaceSeparation: context.policy.measureSurfaceSeparation(surface),
+        },
+    };
+}
+function createResolutionContext(input) {
+    const { generated, mode, references, resolved } = input;
+    const { swatches } = generated;
+    const collector = createSurfaceColorDiagnosticCollector();
+    const isDark = mode === 'dark';
+    return {
+        collector,
+        generated,
+        isDark,
+        mode,
+        neutralSwatch: swatches.neutral,
+        policy: createSurfaceSemanticPolicy(resolved, isDark, collector),
+        quaternarySwatch: swatches.quaternary ?? swatches.primary,
+        references,
+        resolved,
+        secondarySwatch: swatches.secondary ?? swatches.primary,
+        statusSwatches: createDefaultSemanticStatusSwatches(),
+        swatches,
+        tertiarySwatch: swatches.tertiary ?? swatches.primary,
+    };
+}
+function resolveBorderSemantics(context, focus) {
+    const { collector, neutralSwatch, policy, resolved } = context;
+    return {
+        default: collector.selectColor('border.default', neutralSwatch, policy.neutralTarget(), policy.adjacentSurfaceContexts, policy.tiePolicy),
+        subtle: resolved.border,
+        strong: collector.selectColor('border.strong', neutralSwatch, policy.strongNeutralTarget(), policy.adjacentSurfaceContexts, policy.tiePolicy),
+        divider: resolved.divider,
+        focus,
+    };
+}
+function resolveContentSemantics(context, subtle, inverse) {
+    const { collector, policy, resolved, secondarySwatch, swatches } = context;
+    return {
+        default: resolved.text,
+        muted: resolved.textMuted,
+        subtle,
+        disabled: resolved.disabledText,
+        icon: resolved.text,
+        link: collector.selectColor('content.link', swatches.primary, policy.textTarget(), policy.textSurfaceContexts, policy.tiePolicy),
+        visited: collector.selectColor('content.visited', secondarySwatch, policy.textTarget(), policy.textSurfaceContexts, policy.tiePolicy),
+        inverse,
+    };
+}
+function resolveRole(context, id, swatch, options = {}) {
+    const { collector, isDark, policy, resolved } = context;
+    return resolveRoleSemantics({
+        base: options.base,
+        disabledBg: resolved.disabledBg,
+        disabledText: resolved.disabledText,
+        hover: options.hover,
+        id,
+        isDark,
+        measureForeground: collector.measureForeground,
+        onSurfaceText: collector.selectColor(`${id}.content`, swatch, policy.textTarget(), policy.textSurfaceContexts, policy.tiePolicy),
+        outline: collector.selectColor(`${id}.outline`, swatch, options.target ?? policy.roleTarget(), policy.adjacentSurfaceContexts, policy.tiePolicy),
+        selectForeground: collector.selectForeground,
+        swatch,
+    });
+}
+function resolveSemanticRoles(context) {
+    const { neutralSwatch, resolved, secondarySwatch, statusSwatches, swatches } = context;
+    return {
+        brand: resolveRole(context, 'brand', swatches.primary, {
+            base: resolved.action,
+            hover: resolved.actionEmphasis,
+        }),
+        secondary: resolveRole(context, 'secondary', secondarySwatch),
+        accent: resolveRole(context, 'accent', context.tertiarySwatch),
+        highlight: resolveRole(context, 'highlight', context.quaternarySwatch),
+        danger: resolveRole(context, 'danger', statusSwatches.swatches.danger),
+        success: resolveRole(context, 'success', statusSwatches.swatches.success),
+        warning: resolveRole(context, 'warning', statusSwatches.swatches.warning),
+        info: resolveRole(context, 'info', statusSwatches.swatches.info),
+        neutralAction: resolveRole(context, 'neutral', neutralSwatch, {
+            target: context.policy.neutralTarget(),
+        }),
+    };
+}
+//# sourceMappingURL=resolveSurfaceSemanticModel.js.map

package/dist/theme/resolveSurfaceSemanticModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSurfaceSemanticModel.js","sourceRoot":"","sources":["../../src/theme/resolveSurfaceSemanticModel.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ColorSelectionTarget,\n  ColorSwatch,\n  GeneratedThemeModeColors,\n  GeneratedThemeSwatches,\n  HexColor,\n  SemanticColorReferenceMap,\n  SemanticColorToken,\n  ThemeColorMode,\n} from '@ankhorage/color-theory';\nimport { createDefaultSemanticStatusSwatches } from '@ankhorage/color-theory';\n\nimport { createSurfaceColorDiagnosticCollector } from './createSurfaceColorDiagnosticCollector';\nimport { createSurfaceSemanticPolicy } from './createSurfaceSemanticPolicy';\nimport { resolveRoleSemantics } from './resolveRoleSemantics';\nimport type {\n  BorderSemantics,\n  ContentSemantics,\n  RoleSemantics,\n  SurfaceColorDiagnostics,\n  ThemeSemantics,\n} from './types';\n\ntype ResolvedSemanticColors = Record<SemanticColorToken, HexColor>;\n\ninterface SemanticResolutionContext {\n  collector: ReturnType<typeof createSurfaceColorDiagnosticCollector>;\n  generated: GeneratedThemeModeColors;\n  isDark: boolean;\n  mode: ThemeColorMode;\n  neutralSwatch: ColorSwatch;\n  policy: ReturnType<typeof createSurfaceSemanticPolicy>;\n  quaternarySwatch: ColorSwatch;\n  references: SemanticColorReferenceMap;\n  resolved: ResolvedSemanticColors;\n  secondarySwatch: ColorSwatch;\n  statusSwatches: ReturnType<typeof createDefaultSemanticStatusSwatches>;\n  swatches: GeneratedThemeSwatches;\n  tertiarySwatch: ColorSwatch;\n}\n\ninterface ResolveSurfaceSemanticModelInput {\n  generated: GeneratedThemeModeColors;\n  mode: ThemeColorMode;\n  references: SemanticColorReferenceMap;\n  resolved: ResolvedSemanticColors;\n}\n\n/** Resolve the complete Surface-owned semantic model from canonical Color Theory output. */\nexport function resolveSurfaceSemanticModel(input: ResolveSurfaceSemanticModelInput): {\n  semantics: ThemeSemantics;\n  colorDiagnostics: SurfaceColorDiagnostics;\n} {\n  const context = createResolutionContext(input);\n  const roles = resolveSemanticRoles(context);\n  const inverseSurface = context.isDark ? context.neutralSwatch[50] : context.neutralSwatch[900];\n  const inverseContent = context.isDark ? context.neutralSwatch[900] : context.neutralSwatch[50];\n  const neutral = context.policy.buildNeutral(context.neutralSwatch);\n  const surface = context.policy.buildSurface(inverseSurface);\n  const content = resolveContentSemantics(context, neutral.textSubtle, inverseContent);\n  const border = resolveBorderSemantics(context, roles.brand.outline);\n  context.policy.measureContent(content, surface);\n\n  return {\n    semantics: {\n      neutral,\n      brand: roles.brand,\n      secondary: roles.secondary,\n      accent: roles.accent,\n      highlight: roles.highlight,\n      danger: roles.danger,\n      success: roles.success,\n      warning: roles.warning,\n      error: roles.danger,\n      info: roles.info,\n      surface,\n      content,\n      border,\n      selection: {\n        background: roles.brand.softBg,\n        content: roles.brand.onSoftText,\n        border: border.focus,\n      },\n      action: { primary: roles.brand, neutral: roles.neutralAction, danger: roles.danger },\n    },\n    colorDiagnostics: {\n      mode: context.mode,\n      generated: context.generated,\n      semanticReferences: context.references,\n      statusSwatches: context.statusSwatches.diagnostics,\n      selections: context.collector.selections,\n      contrasts: context.collector.contrasts,\n      surfaceSeparation: context.policy.measureSurfaceSeparation(surface),\n    },\n  };\n}\n\nfunction createResolutionContext(\n  input: ResolveSurfaceSemanticModelInput,\n): SemanticResolutionContext {\n  const { generated, mode, references, resolved } = input;\n  const { swatches } = generated;\n  const collector = createSurfaceColorDiagnosticCollector();\n  const isDark = mode === 'dark';\n  return {\n    collector,\n    generated,\n    isDark,\n    mode,\n    neutralSwatch: swatches.neutral,\n    policy: createSurfaceSemanticPolicy(resolved, isDark, collector),\n    quaternarySwatch: swatches.quaternary ?? swatches.primary,\n    references,\n    resolved,\n    secondarySwatch: swatches.secondary ?? swatches.primary,\n    statusSwatches: createDefaultSemanticStatusSwatches(),\n    swatches,\n    tertiarySwatch: swatches.tertiary ?? swatches.primary,\n  };\n}\n\nfunction resolveBorderSemantics(\n  context: SemanticResolutionContext,\n  focus: string,\n): BorderSemantics {\n  const { collector, neutralSwatch, policy, resolved } = context;\n  return {\n    default: collector.selectColor(\n      'border.default',\n      neutralSwatch,\n      policy.neutralTarget(),\n      policy.adjacentSurfaceContexts,\n      policy.tiePolicy,\n    ),\n    subtle: resolved.border,\n    strong: collector.selectColor(\n      'border.strong',\n      neutralSwatch,\n      policy.strongNeutralTarget(),\n      policy.adjacentSurfaceContexts,\n      policy.tiePolicy,\n    ),\n    divider: resolved.divider,\n    focus,\n  };\n}\n\nfunction resolveContentSemantics(\n  context: SemanticResolutionContext,\n  subtle: string,\n  inverse: string,\n): ContentSemantics {\n  const { collector, policy, resolved, secondarySwatch, swatches } = context;\n  return {\n    default: resolved.text,\n    muted: resolved.textMuted,\n    subtle,\n    disabled: resolved.disabledText,\n    icon: resolved.text,\n    link: collector.selectColor(\n      'content.link',\n      swatches.primary,\n      policy.textTarget(),\n      policy.textSurfaceContexts,\n      policy.tiePolicy,\n    ),\n    visited: collector.selectColor(\n      'content.visited',\n      secondarySwatch,\n      policy.textTarget(),\n      policy.textSurfaceContexts,\n      policy.tiePolicy,\n    ),\n    inverse,\n  };\n}\n\nfunction resolveRole(\n  context: SemanticResolutionContext,\n  id: string,\n  swatch: ColorSwatch,\n  options: { base?: HexColor; hover?: HexColor; target?: ColorSelectionTarget } = {},\n): RoleSemantics {\n  const { collector, isDark, policy, resolved } = context;\n  return resolveRoleSemantics({\n    base: options.base,\n    disabledBg: resolved.disabledBg,\n    disabledText: resolved.disabledText,\n    hover: options.hover,\n    id,\n    isDark,\n    measureForeground: collector.measureForeground,\n    onSurfaceText: collector.selectColor(\n      `${id}.content`,\n      swatch,\n      policy.textTarget(),\n      policy.textSurfaceContexts,\n      policy.tiePolicy,\n    ),\n    outline: collector.selectColor(\n      `${id}.outline`,\n      swatch,\n      options.target ?? policy.roleTarget(),\n      policy.adjacentSurfaceContexts,\n      policy.tiePolicy,\n    ),\n    selectForeground: collector.selectForeground,\n    swatch,\n  });\n}\n\nfunction resolveSemanticRoles(context: SemanticResolutionContext) {\n  const { neutralSwatch, resolved, secondarySwatch, statusSwatches, swatches } = context;\n  return {\n    brand: resolveRole(context, 'brand', swatches.primary, {\n      base: resolved.action,\n      hover: resolved.actionEmphasis,\n    }),\n    secondary: resolveRole(context, 'secondary', secondarySwatch),\n    accent: resolveRole(context, 'accent', context.tertiarySwatch),\n    highlight: resolveRole(context, 'highlight', context.quaternarySwatch),\n    danger: resolveRole(context, 'danger', statusSwatches.swatches.danger),\n    success: resolveRole(context, 'success', statusSwatches.swatches.success),\n    warning: resolveRole(context, 'warning', statusSwatches.swatches.warning),\n    info: resolveRole(context, 'info', statusSwatches.swatches.info),\n    neutralAction: resolveRole(context, 'neutral', neutralSwatch, {\n      target: context.policy.neutralTarget(),\n    }),\n  };\n}\n"]}

package/dist/theme/surfaceColorPolicy.d.ts

@@ -0,0 +1,8 @@
+/** Canonical measurable thresholds used while Surface resolves runtime color semantics. */
+export declare const SURFACE_COLOR_POLICY: {
+    readonly disabledContrast: 3;
+    readonly surfaceSeparation: 1.05;
+    readonly textContrast: 4.5;
+    readonly uiContrast: 3;
+};
+//# sourceMappingURL=surfaceColorPolicy.d.ts.map

package/dist/theme/surfaceColorPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceColorPolicy.d.ts","sourceRoot":"","sources":["../../src/theme/surfaceColorPolicy.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC"}

package/dist/theme/surfaceColorPolicy.js

@@ -0,0 +1,8 @@
+/** Canonical measurable thresholds used while Surface resolves runtime color semantics. */
+export const SURFACE_COLOR_POLICY = {
+    disabledContrast: 3,
+    surfaceSeparation: 1.05,
+    textContrast: 4.5,
+    uiContrast: 3,
+};
+//# sourceMappingURL=surfaceColorPolicy.js.map

package/dist/theme/surfaceColorPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceColorPolicy.js","sourceRoot":"","sources":["../../src/theme/surfaceColorPolicy.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,gBAAgB,EAAE,CAAC;IACnB,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,GAAG;IACjB,UAAU,EAAE,CAAC;CACL,CAAC","sourcesContent":["/** Canonical measurable thresholds used while Surface resolves runtime color semantics. */\nexport const SURFACE_COLOR_POLICY = {\n  disabledContrast: 3,\n  surfaceSeparation: 1.05,\n  textContrast: 4.5,\n  uiContrast: 3,\n} as const;\n"]}