@ankhorage/zora 0.16.2 → 1.0.1

package/dist/internal/color/semanticTokens.js

@@ -1,84 +0,0 @@
-import { parseHexToOklch } from './oklch';
-import { getZoraRoleColorScale } from './roleScales';
-/**
- * Selects the more readable of two candidate hex colors against a given background,
- * using OKLCH lightness as a simple contrast proxy.
- */
-export function getReadableTextColor(background, candidates) {
-    const bgL = parseHexToOklch(background).l;
-    const [a, b] = candidates;
-    const diffA = Math.abs(parseHexToOklch(a).l - bgL);
-    const diffB = Math.abs(parseHexToOklch(b).l - bgL);
-    return diffA >= diffB ? a : b;
-}
-export function createZoraSemanticColorTokens(options) {
-    // colorTone is accepted now and reserved for future per-tone step overrides
-    // (e.g. obsidian/pastel may shift surface selections differently).
-    const { roleScales, mode } = options;
-    const neutral = getZoraRoleColorScale(roleScales, 'neutral').scale;
-    const surfaceTintScale = getZoraRoleColorScale(roleScales, 'surfaceTint').scale;
-    const primaryScale = getZoraRoleColorScale(roleScales, 'primary').scale;
-    const secondaryScale = getZoraRoleColorScale(roleScales, 'secondary').scale;
-    const accentScale = getZoraRoleColorScale(roleScales, 'accent').scale;
-    const highlightScale = getZoraRoleColorScale(roleScales, 'highlight').scale;
-    if (mode === 'light') {
-        const background = neutral[50];
-        const surface = neutral[100];
-        const surfaceRaised = neutral[50];
-        const surfaceTint = surfaceTintScale[100];
-        const border = neutral[200];
-        const text = neutral[900];
-        const textMuted = neutral[700];
-        const primary = primaryScale[600];
-        const secondary = secondaryScale[600];
-        const accent = accentScale[600];
-        const highlight = highlightScale[600];
-        const onPrimary = getReadableTextColor(primary, [neutral[50], neutral[950]]);
-        const onAccent = getReadableTextColor(accent, [neutral[50], neutral[950]]);
-        return {
-            background,
-            surface,
-            surfaceRaised,
-            surfaceTint,
-            border,
-            text,
-            textMuted,
-            primary,
-            secondary,
-            accent,
-            highlight,
-            onPrimary,
-            onAccent,
-        };
-    }
-    // dark mode
-    const background = neutral[950];
-    const surface = neutral[900];
-    const surfaceRaised = neutral[800];
-    const surfaceTint = surfaceTintScale[900];
-    const border = neutral[700];
-    const text = neutral[50];
-    const textMuted = neutral[300];
-    const primary = primaryScale[400];
-    const secondary = secondaryScale[400];
-    const accent = accentScale[400];
-    const highlight = highlightScale[400];
-    const onPrimary = getReadableTextColor(primary, [neutral[50], neutral[950]]);
-    const onAccent = getReadableTextColor(accent, [neutral[50], neutral[950]]);
-    return {
-        background,
-        surface,
-        surfaceRaised,
-        surfaceTint,
-        border,
-        text,
-        textMuted,
-        primary,
-        secondary,
-        accent,
-        highlight,
-        onPrimary,
-        onAccent,
-    };
-}
-//# sourceMappingURL=semanticTokens.js.map

package/dist/internal/color/semanticTokens.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"semanticTokens.js","sourceRoot":"","sources":["../../../src/internal/color/semanticTokens.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAoC,MAAM,cAAc,CAAC;AAkBvF;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAwB,EACxB,UAAiD;IAEjD,MAAM,GAAG,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACnD,OAAO,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAI7C;IACC,4EAA4E;IAC5E,mEAAmE;IACnE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAErC,MAAM,OAAO,GAAG,qBAAqB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC;IACnE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,KAAK,CAAC;IAChF,MAAM,YAAY,GAAG,qBAAqB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC;IACxE,MAAM,cAAc,GAAG,qBAAqB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC;IAC5E,MAAM,WAAW,GAAG,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC;IACtE,MAAM,cAAc,GAAG,qBAAqB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC;IAE5E,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,aAAa,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAE3E,OAAO;YACL,UAAU;YACV,OAAO;YACP,aAAa;YACb,WAAW;YACX,MAAM;YACN,IAAI;YACJ,SAAS;YACT,OAAO;YACP,SAAS;YACT,MAAM;YACN,SAAS;YACT,SAAS;YACT,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,YAAY;IACZ,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACzB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAE3E,OAAO;QACL,UAAU;QACV,OAAO;QACP,aAAa;QACb,WAAW;QACX,MAAM;QACN,IAAI;QACJ,SAAS;QACT,OAAO;QACP,SAAS;QACT,MAAM;QACN,SAAS;QACT,SAAS;QACT,QAAQ;KACT,CAAC;AACJ,CAAC","sourcesContent":["import type { ZoraColorTone, ZoraHexColor, ZoraThemeMode } from '../../theme/types';\nimport { parseHexToOklch } from './oklch';\nimport { getZoraRoleColorScale, type ZoraComputedRoleColorScales } from './roleScales';\n\nexport interface ZoraSemanticColorTokens {\n  background: ZoraHexColor;\n  surface: ZoraHexColor;\n  surfaceRaised: ZoraHexColor;\n  surfaceTint: ZoraHexColor;\n  border: ZoraHexColor;\n  text: ZoraHexColor;\n  textMuted: ZoraHexColor;\n  primary: ZoraHexColor;\n  secondary: ZoraHexColor;\n  accent: ZoraHexColor;\n  highlight: ZoraHexColor;\n  onPrimary: ZoraHexColor;\n  onAccent: ZoraHexColor;\n}\n\n/**\n * Selects the more readable of two candidate hex colors against a given background,\n * using OKLCH lightness as a simple contrast proxy.\n */\nexport function getReadableTextColor(\n  background: ZoraHexColor,\n  candidates: readonly [ZoraHexColor, ZoraHexColor],\n): ZoraHexColor {\n  const bgL = parseHexToOklch(background).l;\n  const [a, b] = candidates;\n  const diffA = Math.abs(parseHexToOklch(a).l - bgL);\n  const diffB = Math.abs(parseHexToOklch(b).l - bgL);\n  return diffA >= diffB ? a : b;\n}\n\nexport function createZoraSemanticColorTokens(options: {\n  roleScales: ZoraComputedRoleColorScales;\n  mode: ZoraThemeMode;\n  colorTone: ZoraColorTone;\n}): ZoraSemanticColorTokens {\n  // colorTone is accepted now and reserved for future per-tone step overrides\n  // (e.g. obsidian/pastel may shift surface selections differently).\n  const { roleScales, mode } = options;\n\n  const neutral = getZoraRoleColorScale(roleScales, 'neutral').scale;\n  const surfaceTintScale = getZoraRoleColorScale(roleScales, 'surfaceTint').scale;\n  const primaryScale = getZoraRoleColorScale(roleScales, 'primary').scale;\n  const secondaryScale = getZoraRoleColorScale(roleScales, 'secondary').scale;\n  const accentScale = getZoraRoleColorScale(roleScales, 'accent').scale;\n  const highlightScale = getZoraRoleColorScale(roleScales, 'highlight').scale;\n\n  if (mode === 'light') {\n    const background = neutral[50];\n    const surface = neutral[100];\n    const surfaceRaised = neutral[50];\n    const surfaceTint = surfaceTintScale[100];\n    const border = neutral[200];\n    const text = neutral[900];\n    const textMuted = neutral[700];\n    const primary = primaryScale[600];\n    const secondary = secondaryScale[600];\n    const accent = accentScale[600];\n    const highlight = highlightScale[600];\n    const onPrimary = getReadableTextColor(primary, [neutral[50], neutral[950]]);\n    const onAccent = getReadableTextColor(accent, [neutral[50], neutral[950]]);\n\n    return {\n      background,\n      surface,\n      surfaceRaised,\n      surfaceTint,\n      border,\n      text,\n      textMuted,\n      primary,\n      secondary,\n      accent,\n      highlight,\n      onPrimary,\n      onAccent,\n    };\n  }\n\n  // dark mode\n  const background = neutral[950];\n  const surface = neutral[900];\n  const surfaceRaised = neutral[800];\n  const surfaceTint = surfaceTintScale[900];\n  const border = neutral[700];\n  const text = neutral[50];\n  const textMuted = neutral[300];\n  const primary = primaryScale[400];\n  const secondary = secondaryScale[400];\n  const accent = accentScale[400];\n  const highlight = highlightScale[400];\n  const onPrimary = getReadableTextColor(primary, [neutral[50], neutral[950]]);\n  const onAccent = getReadableTextColor(accent, [neutral[50], neutral[950]]);\n\n  return {\n    background,\n    surface,\n    surfaceRaised,\n    surfaceTint,\n    border,\n    text,\n    textMuted,\n    primary,\n    secondary,\n    accent,\n    highlight,\n    onPrimary,\n    onAccent,\n  };\n}\n"]}

package/dist/internal/color/types.d.ts

@@ -1,10 +0,0 @@
-import type { ZoraHexColor } from '../../theme/types';
-export interface ZoraOklchColor {
-    l: number;
-    c: number;
-    h: number;
-}
-export declare const ZORA_COLOR_SCALE_STEPS: readonly [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950];
-export type ZoraColorScaleStep = (typeof ZORA_COLOR_SCALE_STEPS)[number];
-export type ZoraColorScale = Record<ZoraColorScaleStep, ZoraHexColor>;
-//# sourceMappingURL=types.d.ts.map

package/dist/internal/color/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/internal/color/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,eAAO,MAAM,sBAAsB,iEAEzB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC"}

package/dist/internal/color/types.js

@@ -1,4 +0,0 @@
-export const ZORA_COLOR_SCALE_STEPS = [
-    50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950,
-];
-//# sourceMappingURL=types.js.map

package/dist/internal/color/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internal/color/types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAC5C,CAAC","sourcesContent":["import type { ZoraHexColor } from '../../theme/types';\n\nexport interface ZoraOklchColor {\n  l: number;\n  c: number;\n  h: number;\n}\n\nexport const ZORA_COLOR_SCALE_STEPS = [\n  50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950,\n] as const;\n\nexport type ZoraColorScaleStep = (typeof ZORA_COLOR_SCALE_STEPS)[number];\n\nexport type ZoraColorScale = Record<ZoraColorScaleStep, ZoraHexColor>;\n"]}

package/dist/patterns/theme-composer/recommendations.d.ts

@@ -1,14 +0,0 @@
-import type { ZoraHexColor, ZoraTheme } from '../../theme/types';
-import type { ThemeComposerAppCategory, ThemeComposerAppMood, ThemeComposerRecommendation } from './types';
-export declare function findThemeComposerRecommendation(options: {
-    appCategory?: ThemeComposerAppCategory;
-    appMood?: ThemeComposerAppMood;
-    recommendations?: readonly ThemeComposerRecommendation[];
-}): ThemeComposerRecommendation | undefined;
-export declare function formatThemeComposerLabel(value: string): string;
-export declare function hueDegreesToZoraHexColor(hueDegrees: number): ZoraHexColor;
-export declare function createThemeFromThemeComposerRecommendation(options: {
-    value: ZoraTheme;
-    recommendation: ThemeComposerRecommendation;
-}): ZoraTheme;
-//# sourceMappingURL=recommendations.d.ts.map

package/dist/patterns/theme-composer/recommendations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/patterns/theme-composer/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,wBAAgB,+BAA+B,CAAC,OAAO,EAAE;IACvD,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC1D,GAAG,2BAA2B,GAAG,SAAS,CAU1C;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CA+BzE;AAED,wBAAgB,0CAA0C,CAAC,OAAO,EAAE;IAClE,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,EAAE,2BAA2B,CAAC;CAC7C,GAAG,SAAS,CAYZ"}

package/dist/patterns/theme-composer/recommendations.js

@@ -1,58 +0,0 @@
-export function findThemeComposerRecommendation(options) {
-    if (options.appCategory === undefined || options.recommendations === undefined) {
-        return undefined;
-    }
-    return options.recommendations.find((recommendation) => recommendation.appCategory === options.appCategory &&
-        (options.appMood === undefined || recommendation.appMood === options.appMood));
-}
-export function formatThemeComposerLabel(value) {
-    const spaced = value
-        .replace(/_/g, ' ')
-        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
-        .trim();
-    if (spaced.length === 0) {
-        return value;
-    }
-    return `${spaced.slice(0, 1).toUpperCase()}${spaced.slice(1)}`;
-}
-export function hueDegreesToZoraHexColor(hueDegrees) {
-    const normalizedHue = ((hueDegrees % 360) + 360) % 360;
-    const chroma = 0.56;
-    const lightness = 0.46;
-    const second = chroma * (1 - Math.abs(((normalizedHue / 60) % 2) - 1));
-    const match = lightness - chroma / 2;
-    const hueSector = Math.floor(normalizedHue / 60);
-    const [redPrime, greenPrime, bluePrime] = (() => {
-        switch (hueSector) {
-            case 0:
-                return [chroma, second, 0];
-            case 1:
-                return [second, chroma, 0];
-            case 2:
-                return [0, chroma, second];
-            case 3:
-                return [0, second, chroma];
-            case 4:
-                return [second, 0, chroma];
-            default:
-                return [chroma, 0, second];
-        }
-    })();
-    const toHexChannel = (channel) => {
-        const value = Math.round(Math.min(1, Math.max(0, channel + match)) * 255);
-        return value.toString(16).padStart(2, '0');
-    };
-    return `#${toHexChannel(redPrime)}${toHexChannel(greenPrime)}${toHexChannel(bluePrime)}`;
-}
-export function createThemeFromThemeComposerRecommendation(options) {
-    const suggestedPrimaryColor = options.recommendation.suggestedPrimaryHueDegrees === undefined
-        ? options.value.primaryColor
-        : hueDegreesToZoraHexColor(options.recommendation.suggestedPrimaryHueDegrees);
-    return {
-        ...options.value,
-        primaryColor: suggestedPrimaryColor,
-        harmony: options.recommendation.suggestedHarmony,
-        colorTone: options.recommendation.suggestedColorTone,
-    };
-}
-//# sourceMappingURL=recommendations.js.map

package/dist/patterns/theme-composer/recommendations.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"recommendations.js","sourceRoot":"","sources":["../../../src/patterns/theme-composer/recommendations.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ZoraHexColor, ZoraTheme } from '../../theme/types';\nimport type {\n  ThemeComposerAppCategory,\n  ThemeComposerAppMood,\n  ThemeComposerRecommendation,\n} from './types';\n\nexport function findThemeComposerRecommendation(options: {\n  appCategory?: ThemeComposerAppCategory;\n  appMood?: ThemeComposerAppMood;\n  recommendations?: readonly ThemeComposerRecommendation[];\n}): ThemeComposerRecommendation | undefined {\n  if (options.appCategory === undefined || options.recommendations === undefined) {\n    return undefined;\n  }\n\n  return options.recommendations.find(\n    (recommendation) =>\n      recommendation.appCategory === options.appCategory &&\n      (options.appMood === undefined || recommendation.appMood === options.appMood),\n  );\n}\n\nexport function formatThemeComposerLabel(value: string): string {\n  const spaced = value\n    .replace(/_/g, ' ')\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .trim();\n\n  if (spaced.length === 0) {\n    return value;\n  }\n\n  return `${spaced.slice(0, 1).toUpperCase()}${spaced.slice(1)}`;\n}\n\nexport function hueDegreesToZoraHexColor(hueDegrees: number): ZoraHexColor {\n  const normalizedHue = ((hueDegrees % 360) + 360) % 360;\n  const chroma = 0.56;\n  const lightness = 0.46;\n  const second = chroma * (1 - Math.abs(((normalizedHue / 60) % 2) - 1));\n  const match = lightness - chroma / 2;\n\n  const hueSector = Math.floor(normalizedHue / 60);\n  const [redPrime, greenPrime, bluePrime] = (() => {\n    switch (hueSector) {\n      case 0:\n        return [chroma, second, 0] as const;\n      case 1:\n        return [second, chroma, 0] as const;\n      case 2:\n        return [0, chroma, second] as const;\n      case 3:\n        return [0, second, chroma] as const;\n      case 4:\n        return [second, 0, chroma] as const;\n      default:\n        return [chroma, 0, second] as const;\n    }\n  })();\n\n  const toHexChannel = (channel: number): string => {\n    const value = Math.round(Math.min(1, Math.max(0, channel + match)) * 255);\n    return value.toString(16).padStart(2, '0');\n  };\n\n  return `#${toHexChannel(redPrime)}${toHexChannel(greenPrime)}${toHexChannel(bluePrime)}`;\n}\n\nexport function createThemeFromThemeComposerRecommendation(options: {\n  value: ZoraTheme;\n  recommendation: ThemeComposerRecommendation;\n}): ZoraTheme {\n  const suggestedPrimaryColor =\n    options.recommendation.suggestedPrimaryHueDegrees === undefined\n      ? options.value.primaryColor\n      : hueDegreesToZoraHexColor(options.recommendation.suggestedPrimaryHueDegrees);\n\n  return {\n    ...options.value,\n    primaryColor: suggestedPrimaryColor,\n    harmony: options.recommendation.suggestedHarmony,\n    colorTone: options.recommendation.suggestedColorTone,\n  };\n}\n"]}

package/src/internal/color/colorToneRecipes.test.ts

@@ -1,89 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import { ZORA_COLOR_TONES } from '../../theme/types';
-import {
-  getZoraColorToneRecipe,
-  getZoraColorToneRoleChromaFactor,
-  type ZoraColorToneRecipe,
-  type ZoraHueScaleRoleId,
-} from './index';
-
-const HUE_BACKED_ROLES: readonly ZoraHueScaleRoleId[] = [
-  'primary',
-  'secondary',
-  'accent',
-  'highlight',
-  'surfaceTint',
-];
-
-function expectFinitePositive(value: number) {
-  expect(Number.isFinite(value)).toBe(true);
-  expect(value).toBeGreaterThan(0);
-}
-
-function expectSaneRecipe(recipe: ZoraColorToneRecipe) {
-  expectFinitePositive(recipe.maxChroma);
-  expectFinitePositive(recipe.minMidChroma);
-  expect(recipe.minMidChroma).toBeLessThan(recipe.maxChroma);
-
-  for (const role of HUE_BACKED_ROLES) {
-    expectFinitePositive(getZoraColorToneRoleChromaFactor(recipe, role));
-  }
-}
-
-describe('color tone recipes', () => {
-  test('every ZORA color tone has a recipe', () => {
-    for (const colorTone of ZORA_COLOR_TONES) {
-      expect(getZoraColorToneRecipe(colorTone).colorTone).toBe(colorTone);
-    }
-  });
-
-  test('every recipe has sane chroma values and all hue-backed role factors', () => {
-    for (const colorTone of ZORA_COLOR_TONES) {
-      expectSaneRecipe(getZoraColorToneRecipe(colorTone));
-    }
-  });
-
-  test('records the initial background and foreground lane pairings', () => {
-    expect(getZoraColorToneRecipe('fluorescent').laneRecipe).toEqual({
-      backgroundTone: 'obsidian',
-      foregroundTone: 'fluorescent',
-    });
-    expect(getZoraColorToneRecipe('obsidian').laneRecipe).toEqual({
-      backgroundTone: 'obsidian',
-      foregroundTone: 'fluorescent',
-    });
-    expect(getZoraColorToneRecipe('pastel').laneRecipe).toEqual({
-      backgroundTone: 'pastel',
-      foregroundTone: 'jewel',
-    });
-    expect(getZoraColorToneRecipe('earth').laneRecipe).toEqual({
-      backgroundTone: 'earth',
-      foregroundTone: 'mineral',
-    });
-  });
-
-  test('surface tint remains lower intensity than foreground action roles', () => {
-    for (const colorTone of ZORA_COLOR_TONES) {
-      const recipe = getZoraColorToneRecipe(colorTone);
-      const surfaceTint = getZoraColorToneRoleChromaFactor(recipe, 'surfaceTint');
-
-      expect(surfaceTint).toBeLessThan(getZoraColorToneRoleChromaFactor(recipe, 'primary'));
-      expect(surfaceTint).toBeLessThan(getZoraColorToneRoleChromaFactor(recipe, 'accent'));
-      expect(surfaceTint).toBeLessThan(getZoraColorToneRoleChromaFactor(recipe, 'highlight'));
-    }
-  });
-
-  test('high-energy tones allow higher chroma than neutral and pastel', () => {
-    expect(getZoraColorToneRecipe('fluorescent').maxChroma).toBeGreaterThan(
-      getZoraColorToneRecipe('neutral').maxChroma,
-    );
-    expect(getZoraColorToneRecipe('fluorescent').maxChroma).toBeGreaterThan(
-      getZoraColorToneRecipe('pastel').maxChroma,
-    );
-  });
-
-  test('getter is deterministic', () => {
-    expect(getZoraColorToneRecipe('jewel')).toEqual(getZoraColorToneRecipe('jewel'));
-  });
-});

package/src/internal/color/colorToneRecipes.ts

@@ -1,167 +0,0 @@
-import type { ZoraColorTone } from '../../theme/types';
-import type { ZoraHueScaleRoleId } from './scales';
-
-export interface ZoraColorToneLaneRecipe {
-  backgroundTone: ZoraColorTone;
-  foregroundTone: ZoraColorTone;
-}
-
-export interface ZoraColorToneRoleChromaFactors {
-  primary: number;
-  secondary: number;
-  accent: number;
-  highlight: number;
-  surfaceTint: number;
-}
-
-export interface ZoraColorToneRecipe {
-  colorTone: ZoraColorTone;
-  laneRecipe: ZoraColorToneLaneRecipe;
-  roleChromaFactors: ZoraColorToneRoleChromaFactors;
-  maxChroma: number;
-  minMidChroma: number;
-}
-
-const ZORA_COLOR_TONE_RECIPES = {
-  neutral: {
-    colorTone: 'neutral',
-    laneRecipe: { backgroundTone: 'neutral', foregroundTone: 'jewel' },
-    roleChromaFactors: {
-      primary: 0.72,
-      secondary: 0.48,
-      accent: 0.56,
-      highlight: 0.6,
-      surfaceTint: 0.12,
-    },
-    maxChroma: 0.14,
-    minMidChroma: 0.025,
-  },
-  pastel: {
-    colorTone: 'pastel',
-    laneRecipe: { backgroundTone: 'pastel', foregroundTone: 'jewel' },
-    roleChromaFactors: {
-      primary: 0.58,
-      secondary: 0.48,
-      accent: 0.55,
-      highlight: 0.62,
-      surfaceTint: 0.2,
-    },
-    maxChroma: 0.12,
-    minMidChroma: 0.02,
-  },
-  earth: {
-    colorTone: 'earth',
-    laneRecipe: { backgroundTone: 'earth', foregroundTone: 'mineral' },
-    roleChromaFactors: {
-      primary: 0.64,
-      secondary: 0.52,
-      accent: 0.58,
-      highlight: 0.6,
-      surfaceTint: 0.16,
-    },
-    maxChroma: 0.13,
-    minMidChroma: 0.022,
-  },
-  mineral: {
-    colorTone: 'mineral',
-    laneRecipe: { backgroundTone: 'mineral', foregroundTone: 'jewel' },
-    roleChromaFactors: {
-      primary: 0.7,
-      secondary: 0.56,
-      accent: 0.64,
-      highlight: 0.68,
-      surfaceTint: 0.16,
-    },
-    maxChroma: 0.14,
-    minMidChroma: 0.025,
-  },
-  muted: {
-    colorTone: 'muted',
-    laneRecipe: { backgroundTone: 'muted', foregroundTone: 'jewel' },
-    roleChromaFactors: {
-      primary: 0.6,
-      secondary: 0.5,
-      accent: 0.56,
-      highlight: 0.6,
-      surfaceTint: 0.14,
-    },
-    maxChroma: 0.12,
-    minMidChroma: 0.02,
-  },
-  jewel: {
-    colorTone: 'jewel',
-    laneRecipe: { backgroundTone: 'neutral', foregroundTone: 'jewel' },
-    roleChromaFactors: {
-      primary: 1,
-      secondary: 0.72,
-      accent: 0.85,
-      highlight: 1,
-      surfaceTint: 0.18,
-    },
-    maxChroma: 0.2,
-    minMidChroma: 0.04,
-  },
-  fluorescent: {
-    colorTone: 'fluorescent',
-    laneRecipe: { backgroundTone: 'obsidian', foregroundTone: 'fluorescent' },
-    roleChromaFactors: {
-      primary: 1.12,
-      secondary: 0.82,
-      accent: 1.05,
-      highlight: 1.18,
-      surfaceTint: 0.22,
-    },
-    maxChroma: 0.24,
-    minMidChroma: 0.045,
-  },
-  obsidian: {
-    colorTone: 'obsidian',
-    laneRecipe: { backgroundTone: 'obsidian', foregroundTone: 'fluorescent' },
-    roleChromaFactors: {
-      primary: 1.08,
-      secondary: 0.78,
-      accent: 1,
-      highlight: 1.12,
-      surfaceTint: 0.2,
-    },
-    maxChroma: 0.22,
-    minMidChroma: 0.04,
-  },
-  vaporwave: {
-    colorTone: 'vaporwave',
-    laneRecipe: { backgroundTone: 'pastel', foregroundTone: 'fluorescent' },
-    roleChromaFactors: {
-      primary: 0.95,
-      secondary: 0.72,
-      accent: 1,
-      highlight: 1.08,
-      surfaceTint: 0.24,
-    },
-    maxChroma: 0.2,
-    minMidChroma: 0.035,
-  },
-  monochromeAccent: {
-    colorTone: 'monochromeAccent',
-    laneRecipe: { backgroundTone: 'neutral', foregroundTone: 'jewel' },
-    roleChromaFactors: {
-      primary: 0.88,
-      secondary: 0.36,
-      accent: 0.95,
-      highlight: 0.88,
-      surfaceTint: 0.08,
-    },
-    maxChroma: 0.18,
-    minMidChroma: 0.035,
-  },
-} satisfies Record<ZoraColorTone, ZoraColorToneRecipe>;
-
-export function getZoraColorToneRecipe(colorTone: ZoraColorTone): ZoraColorToneRecipe {
-  return ZORA_COLOR_TONE_RECIPES[colorTone];
-}
-
-export function getZoraColorToneRoleChromaFactor(
-  recipe: ZoraColorToneRecipe,
-  role: ZoraHueScaleRoleId,
-): number {
-  return recipe.roleChromaFactors[role];
-}

package/src/internal/color/harmony.test.ts

@@ -1,145 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import type { ZoraHexColor } from '../../theme/types';
-import { normalizeHueDegrees } from './hue';
-import {
-  computeZoraHarmony,
-  parseHexToOklch,
-  type ZoraComputedHarmony,
-  type ZoraHarmonySlot,
-  type ZoraHarmonySlotId,
-} from './index';
-
-function hueDeltaDegrees(a: number, b: number): number {
-  const raw = Math.abs(a - b) % 360;
-  return Math.min(raw, 360 - raw);
-}
-
-function expectNormalizedHue(hue: number) {
-  expect(hue).toBeGreaterThanOrEqual(0);
-  expect(hue).toBeLessThan(360);
-}
-
-function getSlotIds(slots: readonly ZoraHarmonySlot[]): ZoraHarmonySlotId[] {
-  return slots.map((slot) => slot.id);
-}
-
-describe('computeZoraHarmony', () => {
-  test('monochromatic returns 1 slot', () => {
-    const seed: ZoraHexColor = '#0f766e';
-    const harmony: ZoraComputedHarmony = computeZoraHarmony(seed, 'monochromatic');
-
-    expect(harmony.orderedSlots).toHaveLength(1);
-    expect(harmony.orderedSlots[0].id).toBe('base');
-  });
-
-  test('complementary returns 2 slots', () => {
-    const seed: ZoraHexColor = '#0f766e';
-    const harmony: ZoraComputedHarmony = computeZoraHarmony(seed, 'complementary');
-
-    expect(harmony.orderedSlots).toHaveLength(2);
-    expect(harmony.orderedSlots[0].id).toBe('base');
-    expect(harmony.orderedSlots[1].id).toBe('a');
-  });
-
-  test('analogous returns 3 slots', () => {
-    const seed: ZoraHexColor = '#0f766e';
-    const harmony: ZoraComputedHarmony = computeZoraHarmony(seed, 'analogous');
-
-    expect(harmony.orderedSlots).toHaveLength(3);
-    expect(getSlotIds(harmony.orderedSlots)).toEqual(['base', 'a', 'b']);
-  });
-
-  test('splitComplementary returns 3 slots', () => {
-    const seed: ZoraHexColor = '#0f766e';
-    const harmony: ZoraComputedHarmony = computeZoraHarmony(seed, 'splitComplementary');
-
-    expect(harmony.orderedSlots).toHaveLength(3);
-    expect(getSlotIds(harmony.orderedSlots)).toEqual(['base', 'a', 'b']);
-  });
-
-  test('triadic returns 3 slots', () => {
-    const seed: ZoraHexColor = '#0f766e';
-    const harmony: ZoraComputedHarmony = computeZoraHarmony(seed, 'triadic');
-
-    expect(harmony.orderedSlots).toHaveLength(3);
-    expect(getSlotIds(harmony.orderedSlots)).toEqual(['base', 'a', 'b']);
-  });
-
-  test('tetradic returns 4 slots', () => {
-    const seed: ZoraHexColor = '#0f766e';
-    const harmony: ZoraComputedHarmony = computeZoraHarmony(seed, 'tetradic');
-
-    expect(harmony.orderedSlots).toHaveLength(4);
-    expect(getSlotIds(harmony.orderedSlots)).toEqual(['base', 'a', 'b', 'c']);
-  });
-
-  test('every computed hue is normalized to [0, 360)', () => {
-    const seed: ZoraHexColor = '#0f766e';
-    const harmonies = [
-      'monochromatic',
-      'complementary',
-      'analogous',
-      'splitComplementary',
-      'triadic',
-      'tetradic',
-    ] as const;
-
-    for (const kind of harmonies) {
-      const computed = computeZoraHarmony(seed, kind);
-      for (const slot of computed.orderedSlots) {
-        expectNormalizedHue(slot.hue);
-      }
-    }
-  });
-
-  test('base slot approximately matches parsed seed hue for a non-neutral seed', () => {
-    const seed: ZoraHexColor = '#ff00ff';
-    const seedOklch = parseHexToOklch(seed);
-
-    const computed = computeZoraHarmony(seed, 'complementary');
-    const [base] = computed.orderedSlots;
-
-    expect(base).toBeDefined();
-    if (!base) {
-      throw new Error('Expected a base harmony slot.');
-    }
-
-    expect(base.id).toBe('base');
-    expect(hueDeltaDegrees(seedOklch.h, base.hue)).toBeLessThan(0.5);
-  });
-
-  test('neutral/low-chroma seed uses a stable fallback hue', () => {
-    const seed: ZoraHexColor = '#808080';
-    const computed = computeZoraHarmony(seed, 'monochromatic');
-
-    expect(computed.orderedSlots).toHaveLength(1);
-    expect(computed.orderedSlots[0].hue).toBe(260);
-  });
-
-  test('is deterministic for the same seed/harmony', () => {
-    const seed: ZoraHexColor = '#0f766e';
-
-    expect(computeZoraHarmony(seed, 'triadic')).toEqual(computeZoraHarmony(seed, 'triadic'));
-  });
-
-  test('complementary slots are based on base hue + 180', () => {
-    const seed: ZoraHexColor = '#0f766e';
-    const computed = computeZoraHarmony(seed, 'complementary');
-    const [base, a] = computed.orderedSlots;
-
-    expect(base).toBeDefined();
-    expect(a).toBeDefined();
-    if (!base || !a) {
-      throw new Error('Expected complementary harmony slots.');
-    }
-
-    expect(hueDeltaDegrees(a.hue, normalizeHueDegrees(base.hue + 180))).toBeLessThan(0.0001);
-  });
-
-  test('throws on invalid seed in test/development', () => {
-    const invalid: ZoraHexColor = '#nope';
-
-    expect(() => computeZoraHarmony(invalid, 'triadic')).toThrow();
-  });
-});