@ankhorage/zora 0.11.0 → 0.12.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.12.1
+
+### Patch Changes
+
+- 35c4046: Adds internal harmony hue-slot computation for future ZORA theme generation work.
+
+## 0.12.0
+
+### Minor Changes
+
+- 7279fe4: Derives light and dark primary colors from a single ZORA theme seed using an internal OKLCH color boundary.
+
 ## 0.11.0
 
 ### Minor Changes

package/README.md

@@ -90,6 +90,22 @@ export function App({ appTheme }: { appTheme: ZoraTheme }) {
 }
 ```
 
+ZORA themes use a single seed `primaryColor`. ZORA derives mode-specific primary
+colors for light and dark mode internally.
+
+```tsx
+<ZoraProvider
+  theme={{
+    id: 'studio',
+    primaryColor: '#0f766e',
+    harmony: 'analogous',
+    tone: 'jewel',
+  }}
+>
+  <App />
+</ZoraProvider>
+```
+
 `mode` and `themeId` are available on public ZORA components through `ZoraBaseProps`.
 Use component props for local component/subtree overrides.
 

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

@@ -0,0 +1,12 @@
+import type { ZoraColorHarmony, ZoraHexColor } from '../../theme/types';
+export type ZoraHarmonySlotId = 'base' | 'a' | 'b' | 'c';
+export interface ZoraHarmonySlot {
+    id: ZoraHarmonySlotId;
+    hue: number;
+}
+export interface ZoraComputedHarmony {
+    kind: ZoraColorHarmony;
+    orderedSlots: readonly ZoraHarmonySlot[];
+}
+export declare function computeZoraHarmony(seed: ZoraHexColor, harmony: ZoraColorHarmony): ZoraComputedHarmony;
+//# sourceMappingURL=harmony.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harmony.d.ts","sourceRoot":"","sources":["../../../src/internal/color/harmony.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIxE,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,iBAAiB,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;CAC1C;AAmBD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,gBAAgB,GACxB,mBAAmB,CA2DrB"}

package/dist/internal/color/harmony.js

@@ -0,0 +1,69 @@
+import { normalizeHueDegrees, rotateHueDegrees } from './hue';
+import { parseHexToOklch } from './oklch';
+const DEFAULT_HARMONY_HUE_DEGREES = 260;
+const MIN_SEED_CHROMA_FOR_HARMONY_HUE = 0.03;
+function createSlot(id, hue) {
+    return { id, hue: normalizeHueDegrees(hue) };
+}
+function resolveSeedHueDegrees(seed) {
+    const parsed = parseHexToOklch(seed);
+    if (!Number.isFinite(parsed.h) || parsed.c < MIN_SEED_CHROMA_FOR_HARMONY_HUE) {
+        return DEFAULT_HARMONY_HUE_DEGREES;
+    }
+    return normalizeHueDegrees(parsed.h);
+}
+export function computeZoraHarmony(seed, harmony) {
+    const baseHue = resolveSeedHueDegrees(seed);
+    if (harmony === 'monochromatic') {
+        return {
+            kind: harmony,
+            orderedSlots: [createSlot('base', baseHue)],
+        };
+    }
+    if (harmony === 'complementary') {
+        return {
+            kind: harmony,
+            orderedSlots: [createSlot('base', baseHue), createSlot('a', rotateHueDegrees(baseHue, 180))],
+        };
+    }
+    if (harmony === 'analogous') {
+        return {
+            kind: harmony,
+            orderedSlots: [
+                createSlot('base', baseHue),
+                createSlot('a', rotateHueDegrees(baseHue, -30)),
+                createSlot('b', rotateHueDegrees(baseHue, 30)),
+            ],
+        };
+    }
+    if (harmony === 'splitComplementary') {
+        return {
+            kind: harmony,
+            orderedSlots: [
+                createSlot('base', baseHue),
+                createSlot('a', rotateHueDegrees(baseHue, 150)),
+                createSlot('b', rotateHueDegrees(baseHue, 210)),
+            ],
+        };
+    }
+    if (harmony === 'triadic') {
+        return {
+            kind: harmony,
+            orderedSlots: [
+                createSlot('base', baseHue),
+                createSlot('a', rotateHueDegrees(baseHue, 120)),
+                createSlot('b', rotateHueDegrees(baseHue, 240)),
+            ],
+        };
+    }
+    return {
+        kind: harmony,
+        orderedSlots: [
+            createSlot('base', baseHue),
+            createSlot('a', rotateHueDegrees(baseHue, 90)),
+            createSlot('b', rotateHueDegrees(baseHue, 180)),
+            createSlot('c', rotateHueDegrees(baseHue, 270)),
+        ],
+    };
+}
+//# sourceMappingURL=harmony.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harmony.js","sourceRoot":"","sources":["../../../src/internal/color/harmony.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ZoraColorHarmony, ZoraHexColor } from '../../theme/types';\nimport { normalizeHueDegrees, rotateHueDegrees } from './hue';\nimport { parseHexToOklch } from './oklch';\n\nexport type ZoraHarmonySlotId = 'base' | 'a' | 'b' | 'c';\n\nexport interface ZoraHarmonySlot {\n  id: ZoraHarmonySlotId;\n  hue: number;\n}\n\nexport interface ZoraComputedHarmony {\n  kind: ZoraColorHarmony;\n  orderedSlots: readonly ZoraHarmonySlot[];\n}\n\nconst DEFAULT_HARMONY_HUE_DEGREES = 260;\nconst MIN_SEED_CHROMA_FOR_HARMONY_HUE = 0.03;\n\nfunction createSlot(id: ZoraHarmonySlotId, hue: number): ZoraHarmonySlot {\n  return { id, hue: normalizeHueDegrees(hue) };\n}\n\nfunction resolveSeedHueDegrees(seed: ZoraHexColor): number {\n  const parsed = parseHexToOklch(seed);\n\n  if (!Number.isFinite(parsed.h) || parsed.c < MIN_SEED_CHROMA_FOR_HARMONY_HUE) {\n    return DEFAULT_HARMONY_HUE_DEGREES;\n  }\n\n  return normalizeHueDegrees(parsed.h);\n}\n\nexport function computeZoraHarmony(\n  seed: ZoraHexColor,\n  harmony: ZoraColorHarmony,\n): ZoraComputedHarmony {\n  const baseHue = resolveSeedHueDegrees(seed);\n\n  if (harmony === 'monochromatic') {\n    return {\n      kind: harmony,\n      orderedSlots: [createSlot('base', baseHue)],\n    };\n  }\n\n  if (harmony === 'complementary') {\n    return {\n      kind: harmony,\n      orderedSlots: [createSlot('base', baseHue), createSlot('a', rotateHueDegrees(baseHue, 180))],\n    };\n  }\n\n  if (harmony === 'analogous') {\n    return {\n      kind: harmony,\n      orderedSlots: [\n        createSlot('base', baseHue),\n        createSlot('a', rotateHueDegrees(baseHue, -30)),\n        createSlot('b', rotateHueDegrees(baseHue, 30)),\n      ],\n    };\n  }\n\n  if (harmony === 'splitComplementary') {\n    return {\n      kind: harmony,\n      orderedSlots: [\n        createSlot('base', baseHue),\n        createSlot('a', rotateHueDegrees(baseHue, 150)),\n        createSlot('b', rotateHueDegrees(baseHue, 210)),\n      ],\n    };\n  }\n\n  if (harmony === 'triadic') {\n    return {\n      kind: harmony,\n      orderedSlots: [\n        createSlot('base', baseHue),\n        createSlot('a', rotateHueDegrees(baseHue, 120)),\n        createSlot('b', rotateHueDegrees(baseHue, 240)),\n      ],\n    };\n  }\n\n  return {\n    kind: harmony,\n    orderedSlots: [\n      createSlot('base', baseHue),\n      createSlot('a', rotateHueDegrees(baseHue, 90)),\n      createSlot('b', rotateHueDegrees(baseHue, 180)),\n      createSlot('c', rotateHueDegrees(baseHue, 270)),\n    ],\n  };\n}\n"]}

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

@@ -0,0 +1,3 @@
+export declare function normalizeHueDegrees(hue: number): number;
+export declare function rotateHueDegrees(hue: number, delta: number): number;
+//# sourceMappingURL=hue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hue.d.ts","sourceRoot":"","sources":["../../../src/internal/color/hue.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/internal/color/hue.js

@@ -0,0 +1,7 @@
+export function normalizeHueDegrees(hue) {
+    return ((hue % 360) + 360) % 360;
+}
+export function rotateHueDegrees(hue, delta) {
+    return normalizeHueDegrees(hue + delta);
+}
+//# sourceMappingURL=hue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hue.js","sourceRoot":"","sources":["../../../src/internal/color/hue.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAa;IACzD,OAAO,mBAAmB,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["export function normalizeHueDegrees(hue: number): number {\n  return ((hue % 360) + 360) % 360;\n}\n\nexport function rotateHueDegrees(hue: number, delta: number): number {\n  return normalizeHueDegrees(hue + delta);\n}\n"]}

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

@@ -0,0 +1,6 @@
+export { computeZoraHarmony, type ZoraComputedHarmony, type ZoraHarmonySlot, type ZoraHarmonySlotId, } from './harmony';
+export { parseHexToOklch } from './oklch';
+export { resolveModePrimaryColor } from './primary';
+export { createZoraColorScale, type CreateZoraColorScaleOptions, createZoraNeutralScale, createZoraPrimaryScale, } from './scales';
+export { ZORA_COLOR_SCALE_STEPS, type ZoraColorScale, type ZoraColorScaleStep } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/color/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/internal/color/index.js

@@ -0,0 +1,6 @@
+export { computeZoraHarmony, } from './harmony';
+export { parseHexToOklch } from './oklch';
+export { resolveModePrimaryColor } from './primary';
+export { createZoraColorScale, createZoraNeutralScale, createZoraPrimaryScale, } from './scales';
+export { ZORA_COLOR_SCALE_STEPS } from './types';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/color/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAInB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,oBAAoB,EAEpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,sBAAsB,EAAgD,MAAM,SAAS,CAAC","sourcesContent":["export {\n  computeZoraHarmony,\n  type ZoraComputedHarmony,\n  type ZoraHarmonySlot,\n  type ZoraHarmonySlotId,\n} from './harmony';\nexport { parseHexToOklch } from './oklch';\nexport { resolveModePrimaryColor } from './primary';\nexport {\n  createZoraColorScale,\n  type CreateZoraColorScaleOptions,\n  createZoraNeutralScale,\n  createZoraPrimaryScale,\n} from './scales';\nexport { ZORA_COLOR_SCALE_STEPS, type ZoraColorScale, type ZoraColorScaleStep } from './types';\n"]}

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

@@ -0,0 +1,6 @@
+import type { ZoraHexColor } from '../../theme/types';
+import type { ZoraOklchColor } from './types';
+export declare function parseHexToOklch(hex: ZoraHexColor): ZoraOklchColor;
+export declare function formatOklchAsHex(color: ZoraOklchColor): ZoraHexColor;
+export declare function clampOklchToGamut(color: ZoraOklchColor): ZoraOklchColor;
+//# sourceMappingURL=oklch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oklch.d.ts","sourceRoot":"","sources":["../../../src/internal/color/oklch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAS9C,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,CAoBjE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAcpE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAavE"}

package/dist/internal/color/oklch.js

@@ -0,0 +1,50 @@
+import { converter, formatHex, parse, toGamut } from 'culori';
+import { normalizeHueDegrees } from './hue';
+const toOklch = converter('oklch');
+const gamutMapToSrgb = toGamut('rgb', 'oklch');
+function isSixDigitHexColor(value) {
+    return /^#[0-9a-fA-F]{6}$/.test(value);
+}
+export function parseHexToOklch(hex) {
+    if (!isSixDigitHexColor(hex)) {
+        throw new Error(`Expected a 6-digit hex color like '#0f766e', got '${String(hex)}'.`);
+    }
+    const parsed = parse(hex);
+    if (!parsed) {
+        throw new Error(`Unable to parse hex color '${String(hex)}'.`);
+    }
+    const oklch = toOklch(parsed);
+    if (typeof oklch.l !== 'number' || typeof oklch.c !== 'number') {
+        throw new Error(`Unable to convert hex color '${String(hex)}' to OKLCH.`);
+    }
+    return {
+        l: oklch.l,
+        c: oklch.c,
+        h: normalizeHueDegrees(typeof oklch.h === 'number' ? oklch.h : 0),
+    };
+}
+export function formatOklchAsHex(color) {
+    const mapped = gamutMapToSrgb({ mode: 'oklch', l: color.l, c: color.c, h: color.h });
+    const hex = formatHex(mapped);
+    if (!hex || !isSixDigitHexColor(hex)) {
+        throw new Error('Unable to format OKLCH color as a 6-digit hex value.');
+    }
+    const normalized = hex.toLowerCase();
+    if (!isSixDigitHexColor(normalized)) {
+        throw new Error('Unable to format OKLCH color as a 6-digit hex value.');
+    }
+    return normalized;
+}
+export function clampOklchToGamut(color) {
+    const mapped = gamutMapToSrgb({ mode: 'oklch', l: color.l, c: color.c, h: color.h });
+    const clamped = toOklch(mapped);
+    if (typeof clamped.l !== 'number' || typeof clamped.c !== 'number') {
+        throw new Error('Unable to clamp OKLCH color to sRGB gamut.');
+    }
+    return {
+        l: clamped.l,
+        c: clamped.c,
+        h: normalizeHueDegrees(typeof clamped.h === 'number' ? clamped.h : 0),
+    };
+}
+//# sourceMappingURL=oklch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oklch.js","sourceRoot":"","sources":["../../../src/internal/color/oklch.ts"],"names":[],"mappings":"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","sourcesContent":["import { converter, formatHex, parse, toGamut } from 'culori';\n\nimport type { ZoraHexColor } from '../../theme/types';\nimport { normalizeHueDegrees } from './hue';\nimport type { ZoraOklchColor } from './types';\n\nconst toOklch = converter('oklch');\nconst gamutMapToSrgb = toGamut('rgb', 'oklch');\n\nfunction isSixDigitHexColor(value: string): value is ZoraHexColor {\n  return /^#[0-9a-fA-F]{6}$/.test(value);\n}\n\nexport function parseHexToOklch(hex: ZoraHexColor): ZoraOklchColor {\n  if (!isSixDigitHexColor(hex)) {\n    throw new Error(`Expected a 6-digit hex color like '#0f766e', got '${String(hex)}'.`);\n  }\n\n  const parsed = parse(hex);\n  if (!parsed) {\n    throw new Error(`Unable to parse hex color '${String(hex)}'.`);\n  }\n\n  const oklch = toOklch(parsed);\n  if (typeof oklch.l !== 'number' || typeof oklch.c !== 'number') {\n    throw new Error(`Unable to convert hex color '${String(hex)}' to OKLCH.`);\n  }\n\n  return {\n    l: oklch.l,\n    c: oklch.c,\n    h: normalizeHueDegrees(typeof oklch.h === 'number' ? oklch.h : 0),\n  };\n}\n\nexport function formatOklchAsHex(color: ZoraOklchColor): ZoraHexColor {\n  const mapped = gamutMapToSrgb({ mode: 'oklch', l: color.l, c: color.c, h: color.h });\n  const hex = formatHex(mapped);\n\n  if (!hex || !isSixDigitHexColor(hex)) {\n    throw new Error('Unable to format OKLCH color as a 6-digit hex value.');\n  }\n\n  const normalized = hex.toLowerCase();\n  if (!isSixDigitHexColor(normalized)) {\n    throw new Error('Unable to format OKLCH color as a 6-digit hex value.');\n  }\n\n  return normalized;\n}\n\nexport function clampOklchToGamut(color: ZoraOklchColor): ZoraOklchColor {\n  const mapped = gamutMapToSrgb({ mode: 'oklch', l: color.l, c: color.c, h: color.h });\n  const clamped = toOklch(mapped);\n\n  if (typeof clamped.l !== 'number' || typeof clamped.c !== 'number') {\n    throw new Error('Unable to clamp OKLCH color to sRGB gamut.');\n  }\n\n  return {\n    l: clamped.l,\n    c: clamped.c,\n    h: normalizeHueDegrees(typeof clamped.h === 'number' ? clamped.h : 0),\n  };\n}\n"]}

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

@@ -0,0 +1,3 @@
+import type { ZoraHexColor, ZoraThemeMode } from '../../theme/types';
+export declare function resolveModePrimaryColor(primaryColor: ZoraHexColor, mode: ZoraThemeMode): ZoraHexColor;
+//# sourceMappingURL=primary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primary.d.ts","sourceRoot":"","sources":["../../../src/internal/color/primary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA2BrE,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,aAAa,GAClB,YAAY,CAiCd"}

package/dist/internal/color/primary.js

@@ -0,0 +1,44 @@
+import { clampOklchToGamut, formatOklchAsHex, parseHexToOklch } from './oklch';
+const FALLBACK_PRIMARY_COLOR = '#0f766e';
+const LIGHT_PRIMARY_LIGHTNESS_TARGET = 0.52;
+const DARK_PRIMARY_LIGHTNESS_TARGET = 0.72;
+const MIN_PRIMARY_CHROMA = 0.04;
+const MAX_LIGHT_PRIMARY_CHROMA = 0.18;
+const MAX_DARK_PRIMARY_CHROMA = 0.2;
+const LIGHTNESS_BLEND = 0.85;
+function clampNumber(value, min, max) {
+    return Math.max(min, Math.min(value, max));
+}
+function resolveModePrimaryTargetLightness(mode) {
+    return mode === 'dark' ? DARK_PRIMARY_LIGHTNESS_TARGET : LIGHT_PRIMARY_LIGHTNESS_TARGET;
+}
+function resolveModePrimaryMaxChroma(mode) {
+    return mode === 'dark' ? MAX_DARK_PRIMARY_CHROMA : MAX_LIGHT_PRIMARY_CHROMA;
+}
+export function resolveModePrimaryColor(primaryColor, mode) {
+    let seed;
+    try {
+        seed = parseHexToOklch(primaryColor);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (process.env.NODE_ENV === 'production') {
+            console.warn(`Invalid ZORA primaryColor '${primaryColor}'. Falling back. ${message}`);
+            return resolveModePrimaryColor(FALLBACK_PRIMARY_COLOR, mode);
+        }
+        throw error instanceof Error ? error : new Error(message);
+    }
+    const targetLightness = resolveModePrimaryTargetLightness(mode);
+    const maxChroma = resolveModePrimaryMaxChroma(mode);
+    const blendedLightness = seed.l + (targetLightness - seed.l) * LIGHTNESS_BLEND;
+    const boundedLightness = clampNumber(blendedLightness, 0.12, 0.92);
+    const cappedChroma = clampNumber(seed.c, 0, maxChroma);
+    const boundedChroma = seed.c < MIN_PRIMARY_CHROMA ? cappedChroma : Math.max(cappedChroma, MIN_PRIMARY_CHROMA);
+    const derived = clampOklchToGamut({
+        l: boundedLightness,
+        c: boundedChroma,
+        h: seed.h,
+    });
+    return formatOklchAsHex(derived);
+}
+//# sourceMappingURL=primary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primary.js","sourceRoot":"","sources":["../../../src/internal/color/primary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/E,MAAM,sBAAsB,GAAiB,SAAS,CAAC;AAEvD,MAAM,8BAA8B,GAAG,IAAI,CAAC;AAC5C,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAE3C,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B,SAAS,WAAW,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,iCAAiC,CAAC,IAAmB;IAC5D,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,8BAA8B,CAAC;AAC1F,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAmB;IACtD,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,wBAAwB,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,YAA0B,EAC1B,IAAmB;IAEnB,IAAI,IAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,IAAI,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,8BAA8B,YAAY,oBAAoB,OAAO,EAAE,CAAC,CAAC;YACtF,OAAO,uBAAuB,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,eAAe,GAAG,iCAAiC,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAEpD,MAAM,gBAAgB,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC;IAC/E,MAAM,gBAAgB,GAAG,WAAW,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAEnE,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,aAAa,GACjB,IAAI,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IAE1F,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,CAAC,EAAE,gBAAgB;QACnB,CAAC,EAAE,aAAa;QAChB,CAAC,EAAE,IAAI,CAAC,CAAC;KACV,CAAC,CAAC;IAEH,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import type { ZoraHexColor, ZoraThemeMode } from '../../theme/types';\nimport { clampOklchToGamut, formatOklchAsHex, parseHexToOklch } from './oklch';\nimport type { ZoraOklchColor } from './types';\n\nconst FALLBACK_PRIMARY_COLOR: ZoraHexColor = '#0f766e';\n\nconst LIGHT_PRIMARY_LIGHTNESS_TARGET = 0.52;\nconst DARK_PRIMARY_LIGHTNESS_TARGET = 0.72;\n\nconst MIN_PRIMARY_CHROMA = 0.04;\nconst MAX_LIGHT_PRIMARY_CHROMA = 0.18;\nconst MAX_DARK_PRIMARY_CHROMA = 0.2;\n\nconst LIGHTNESS_BLEND = 0.85;\n\nfunction clampNumber(value: number, min: number, max: number): number {\n  return Math.max(min, Math.min(value, max));\n}\n\nfunction resolveModePrimaryTargetLightness(mode: ZoraThemeMode): number {\n  return mode === 'dark' ? DARK_PRIMARY_LIGHTNESS_TARGET : LIGHT_PRIMARY_LIGHTNESS_TARGET;\n}\n\nfunction resolveModePrimaryMaxChroma(mode: ZoraThemeMode): number {\n  return mode === 'dark' ? MAX_DARK_PRIMARY_CHROMA : MAX_LIGHT_PRIMARY_CHROMA;\n}\n\nexport function resolveModePrimaryColor(\n  primaryColor: ZoraHexColor,\n  mode: ZoraThemeMode,\n): ZoraHexColor {\n  let seed: ZoraOklchColor;\n\n  try {\n    seed = parseHexToOklch(primaryColor);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n\n    if (process.env.NODE_ENV === 'production') {\n      console.warn(`Invalid ZORA primaryColor '${primaryColor}'. Falling back. ${message}`);\n      return resolveModePrimaryColor(FALLBACK_PRIMARY_COLOR, mode);\n    }\n\n    throw error instanceof Error ? error : new Error(message);\n  }\n\n  const targetLightness = resolveModePrimaryTargetLightness(mode);\n  const maxChroma = resolveModePrimaryMaxChroma(mode);\n\n  const blendedLightness = seed.l + (targetLightness - seed.l) * LIGHTNESS_BLEND;\n  const boundedLightness = clampNumber(blendedLightness, 0.12, 0.92);\n\n  const cappedChroma = clampNumber(seed.c, 0, maxChroma);\n  const boundedChroma =\n    seed.c < MIN_PRIMARY_CHROMA ? cappedChroma : Math.max(cappedChroma, MIN_PRIMARY_CHROMA);\n\n  const derived = clampOklchToGamut({\n    l: boundedLightness,\n    c: boundedChroma,\n    h: seed.h,\n  });\n\n  return formatOklchAsHex(derived);\n}\n"]}

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

@@ -0,0 +1,10 @@
+import type { ZoraHexColor } from '../../theme/types';
+import { type ZoraColorScale } from './types';
+export interface CreateZoraColorScaleOptions {
+    seed: ZoraHexColor;
+    role?: 'primary' | 'neutral';
+}
+export declare function createZoraColorScale(options: CreateZoraColorScaleOptions): ZoraColorScale;
+export declare function createZoraPrimaryScale(seed: ZoraHexColor): ZoraColorScale;
+export declare function createZoraNeutralScale(seed?: ZoraHexColor): ZoraColorScale;
+//# sourceMappingURL=scales.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scales.d.ts","sourceRoot":"","sources":["../../../src/internal/color/scales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,SAAS,CAAC;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B;AA4HD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,cAAc,CAKzF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAEzE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,YAAwB,GAAG,cAAc,CAErF"}

package/dist/internal/color/scales.js

@@ -0,0 +1,110 @@
+import { clampOklchToGamut, formatOklchAsHex, parseHexToOklch } from './oklch';
+import {} from './types';
+const PRIMARY_LIGHTNESS_BY_STEP = {
+    50: 0.97,
+    100: 0.93,
+    200: 0.86,
+    300: 0.78,
+    400: 0.68,
+    500: 0.58,
+    600: 0.5,
+    700: 0.42,
+    800: 0.34,
+    900: 0.27,
+    950: 0.2,
+};
+const NEUTRAL_LIGHTNESS_BY_STEP = {
+    50: 0.98,
+    100: 0.95,
+    200: 0.89,
+    300: 0.8,
+    400: 0.68,
+    500: 0.55,
+    600: 0.44,
+    700: 0.34,
+    800: 0.25,
+    900: 0.18,
+    950: 0.12,
+};
+const PRIMARY_CHROMA_MULTIPLIER_BY_STEP = {
+    50: 0.2,
+    100: 0.3,
+    200: 0.45,
+    300: 0.7,
+    400: 0.95,
+    500: 1,
+    600: 0.95,
+    700: 0.85,
+    800: 0.65,
+    900: 0.45,
+    950: 0.3,
+};
+const MAX_PRIMARY_SCALE_CHROMA = 0.2;
+const MIN_PRIMARY_SCALE_CHROMA = 0.04;
+const NEUTRAL_CHROMA = 0.012;
+const DEFAULT_NEUTRAL_HUE_DEGREES = 260;
+function clampNumber(value, min, max) {
+    return Math.max(min, Math.min(value, max));
+}
+function resolvePrimaryScaleChroma(seedChroma, step) {
+    const cappedSeedChroma = clampNumber(seedChroma, 0, MAX_PRIMARY_SCALE_CHROMA);
+    const multiplier = PRIMARY_CHROMA_MULTIPLIER_BY_STEP[step];
+    const scaled = cappedSeedChroma * multiplier;
+    const bounded = clampNumber(scaled, 0, MAX_PRIMARY_SCALE_CHROMA);
+    const shouldEnforceMin = step >= 300 && step <= 700 && seedChroma >= MIN_PRIMARY_SCALE_CHROMA;
+    return shouldEnforceMin ? Math.max(bounded, MIN_PRIMARY_SCALE_CHROMA) : bounded;
+}
+function createScaleEntries(options) {
+    const seed = parseHexToOklch(options.seed);
+    if (options.role === 'neutral') {
+        const hue = typeof seed.h === 'number' ? seed.h : DEFAULT_NEUTRAL_HUE_DEGREES;
+        return createScaleFromRamp({
+            hue,
+            chroma: NEUTRAL_CHROMA,
+            lightnessByStep: NEUTRAL_LIGHTNESS_BY_STEP,
+        });
+    }
+    return createScaleFromRamp({
+        hue: seed.h,
+        chromaByStep: (step) => resolvePrimaryScaleChroma(seed.c, step),
+        lightnessByStep: PRIMARY_LIGHTNESS_BY_STEP,
+    });
+}
+function createScaleColor(options, step) {
+    const lightness = options.lightnessByStep[step];
+    const chroma = typeof options.chromaByStep === 'function' ? options.chromaByStep(step) : (options.chroma ?? 0);
+    const clamped = clampOklchToGamut({
+        l: clampNumber(lightness, 0, 1),
+        c: clampNumber(chroma, 0, 1),
+        h: options.hue,
+    });
+    return formatOklchAsHex(clamped);
+}
+function createScaleFromRamp(options) {
+    return {
+        50: createScaleColor(options, 50),
+        100: createScaleColor(options, 100),
+        200: createScaleColor(options, 200),
+        300: createScaleColor(options, 300),
+        400: createScaleColor(options, 400),
+        500: createScaleColor(options, 500),
+        600: createScaleColor(options, 600),
+        700: createScaleColor(options, 700),
+        800: createScaleColor(options, 800),
+        900: createScaleColor(options, 900),
+        950: createScaleColor(options, 950),
+    };
+}
+export function createZoraColorScale(options) {
+    return createScaleEntries({
+        seed: options.seed,
+        role: options.role,
+    });
+}
+export function createZoraPrimaryScale(seed) {
+    return createZoraColorScale({ seed, role: 'primary' });
+}
+export function createZoraNeutralScale(seed = '#94a3b8') {
+    return createZoraColorScale({ seed, role: 'neutral' });
+}
+//# sourceMappingURL=scales.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scales.js","sourceRoot":"","sources":["../../../src/internal/color/scales.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAgD,MAAM,SAAS,CAAC;AAOvE,MAAM,yBAAyB,GAAuC;IACpE,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,GAAG;CACT,CAAC;AAEF,MAAM,yBAAyB,GAAuC;IACpE,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;CACV,CAAC;AAEF,MAAM,iCAAiC,GAAuC;IAC5E,EAAE,EAAE,GAAG;IACP,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,GAAG;CACT,CAAC;AAEF,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAExC,SAAS,WAAW,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,yBAAyB,CAAC,UAAkB,EAAE,IAAwB;IAC7E,MAAM,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,iCAAiC,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,gBAAgB,GAAG,UAAU,CAAC;IAE7C,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,wBAAwB,CAAC,CAAC;IACjE,MAAM,gBAAgB,GAAG,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,UAAU,IAAI,wBAAwB,CAAC;IAE9F,OAAO,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAClF,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAoC;IAC9D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC;QAE9E,OAAO,mBAAmB,CAAC;YACzB,GAAG;YACH,MAAM,EAAE,cAAc;YACtB,eAAe,EAAE,yBAAyB;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,mBAAmB,CAAC;QACzB,GAAG,EAAE,IAAI,CAAC,CAAC;QACX,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;QAC/D,eAAe,EAAE,yBAAyB;KAC3C,CAAC,CAAC;AACL,CAAC;AASD,SAAS,gBAAgB,CACvB,OAAmC,EACnC,IAAwB;IAExB,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,MAAM,GACV,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAElG,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,CAAC,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC,EAAE,OAAO,CAAC,GAAG;KACf,CAAC,CAAC;IAEH,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAmC;IAC9D,OAAO;QACL,EAAE,EAAE,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC;QACjC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;QACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAoC;IACvE,OAAO,kBAAkB,CAAC;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAkB;IACvD,OAAO,oBAAoB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAqB,SAAS;IACnE,OAAO,oBAAoB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import type { ZoraHexColor } from '../../theme/types';\nimport { clampOklchToGamut, formatOklchAsHex, parseHexToOklch } from './oklch';\nimport { type ZoraColorScale, type ZoraColorScaleStep } from './types';\n\nexport interface CreateZoraColorScaleOptions {\n  seed: ZoraHexColor;\n  role?: 'primary' | 'neutral';\n}\n\nconst PRIMARY_LIGHTNESS_BY_STEP: Record<ZoraColorScaleStep, number> = {\n  50: 0.97,\n  100: 0.93,\n  200: 0.86,\n  300: 0.78,\n  400: 0.68,\n  500: 0.58,\n  600: 0.5,\n  700: 0.42,\n  800: 0.34,\n  900: 0.27,\n  950: 0.2,\n};\n\nconst NEUTRAL_LIGHTNESS_BY_STEP: Record<ZoraColorScaleStep, number> = {\n  50: 0.98,\n  100: 0.95,\n  200: 0.89,\n  300: 0.8,\n  400: 0.68,\n  500: 0.55,\n  600: 0.44,\n  700: 0.34,\n  800: 0.25,\n  900: 0.18,\n  950: 0.12,\n};\n\nconst PRIMARY_CHROMA_MULTIPLIER_BY_STEP: Record<ZoraColorScaleStep, number> = {\n  50: 0.2,\n  100: 0.3,\n  200: 0.45,\n  300: 0.7,\n  400: 0.95,\n  500: 1,\n  600: 0.95,\n  700: 0.85,\n  800: 0.65,\n  900: 0.45,\n  950: 0.3,\n};\n\nconst MAX_PRIMARY_SCALE_CHROMA = 0.2;\nconst MIN_PRIMARY_SCALE_CHROMA = 0.04;\nconst NEUTRAL_CHROMA = 0.012;\nconst DEFAULT_NEUTRAL_HUE_DEGREES = 260;\n\nfunction clampNumber(value: number, min: number, max: number): number {\n  return Math.max(min, Math.min(value, max));\n}\n\nfunction resolvePrimaryScaleChroma(seedChroma: number, step: ZoraColorScaleStep): number {\n  const cappedSeedChroma = clampNumber(seedChroma, 0, MAX_PRIMARY_SCALE_CHROMA);\n  const multiplier = PRIMARY_CHROMA_MULTIPLIER_BY_STEP[step];\n  const scaled = cappedSeedChroma * multiplier;\n\n  const bounded = clampNumber(scaled, 0, MAX_PRIMARY_SCALE_CHROMA);\n  const shouldEnforceMin = step >= 300 && step <= 700 && seedChroma >= MIN_PRIMARY_SCALE_CHROMA;\n\n  return shouldEnforceMin ? Math.max(bounded, MIN_PRIMARY_SCALE_CHROMA) : bounded;\n}\n\nfunction createScaleEntries(options: CreateZoraColorScaleOptions): ZoraColorScale {\n  const seed = parseHexToOklch(options.seed);\n\n  if (options.role === 'neutral') {\n    const hue = typeof seed.h === 'number' ? seed.h : DEFAULT_NEUTRAL_HUE_DEGREES;\n\n    return createScaleFromRamp({\n      hue,\n      chroma: NEUTRAL_CHROMA,\n      lightnessByStep: NEUTRAL_LIGHTNESS_BY_STEP,\n    });\n  }\n\n  return createScaleFromRamp({\n    hue: seed.h,\n    chromaByStep: (step) => resolvePrimaryScaleChroma(seed.c, step),\n    lightnessByStep: PRIMARY_LIGHTNESS_BY_STEP,\n  });\n}\n\ninterface CreateScaleFromRampOptions {\n  hue: number;\n  chroma?: number;\n  chromaByStep?: (step: ZoraColorScaleStep) => number;\n  lightnessByStep: Record<ZoraColorScaleStep, number>;\n}\n\nfunction createScaleColor(\n  options: CreateScaleFromRampOptions,\n  step: ZoraColorScaleStep,\n): ZoraHexColor {\n  const lightness = options.lightnessByStep[step];\n  const chroma =\n    typeof options.chromaByStep === 'function' ? options.chromaByStep(step) : (options.chroma ?? 0);\n\n  const clamped = clampOklchToGamut({\n    l: clampNumber(lightness, 0, 1),\n    c: clampNumber(chroma, 0, 1),\n    h: options.hue,\n  });\n\n  return formatOklchAsHex(clamped);\n}\n\nfunction createScaleFromRamp(options: CreateScaleFromRampOptions): ZoraColorScale {\n  return {\n    50: createScaleColor(options, 50),\n    100: createScaleColor(options, 100),\n    200: createScaleColor(options, 200),\n    300: createScaleColor(options, 300),\n    400: createScaleColor(options, 400),\n    500: createScaleColor(options, 500),\n    600: createScaleColor(options, 600),\n    700: createScaleColor(options, 700),\n    800: createScaleColor(options, 800),\n    900: createScaleColor(options, 900),\n    950: createScaleColor(options, 950),\n  };\n}\n\nexport function createZoraColorScale(options: CreateZoraColorScaleOptions): ZoraColorScale {\n  return createScaleEntries({\n    seed: options.seed,\n    role: options.role,\n  });\n}\n\nexport function createZoraPrimaryScale(seed: ZoraHexColor): ZoraColorScale {\n  return createZoraColorScale({ seed, role: 'primary' });\n}\n\nexport function createZoraNeutralScale(seed: ZoraHexColor = '#94a3b8'): ZoraColorScale {\n  return createZoraColorScale({ seed, role: 'neutral' });\n}\n"]}

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

@@ -0,0 +1,10 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1 @@
+{"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/theme/createZoraThemeConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createZoraThemeConfig.d.ts","sourceRoot":"","sources":["../../src/theme/createZoraThemeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAgB,SAAS,EAAiB,MAAM,SAAS,CAAC;AAStE,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,SAA4B,GAAG,WAAW,CAetF"}
+{"version":3,"file":"createZoraThemeConfig.d.ts","sourceRoot":"","sources":["../../src/theme/createZoraThemeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,SAA4B,GAAG,WAAW,CAetF"}

package/dist/theme/createZoraThemeConfig.js

@@ -1,9 +1,5 @@
+import { resolveModePrimaryColor } from '../internal/color';
 import { zoraDefaultTheme } from './zoraDefaultTheme';
-function resolveModePrimaryColor(primaryColor, _mode) {
-    // Intentionally conservative in Plan 1: mode-specific primary derivation
-    // (OKLCH/lightness scale, etc.) comes in later theme-engine work.
-    return primaryColor;
-}
 export function createZoraThemeConfig(theme = zoraDefaultTheme) {
     return {
         id: theme.id,

package/dist/theme/createZoraThemeConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"createZoraThemeConfig.js","sourceRoot":"","sources":["../../src/theme/createZoraThemeConfig.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,SAAS,uBAAuB,CAAC,YAA0B,EAAE,KAAoB;IAC/E,yEAAyE;IACzE,kEAAkE;IAClE,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAmB,gBAAgB;IACvE,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;QAC5B,KAAK,EAAE;YACL,YAAY,EAAE,uBAAuB,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC;YAClE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI;SACvB;QACD,IAAI,EAAE;YACJ,YAAY,EAAE,uBAAuB,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC;YACjE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI;SACvB;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { ThemeConfig } from '@ankhorage/surface';\n\nimport type { ZoraHexColor, ZoraTheme, ZoraThemeMode } from './types';\nimport { zoraDefaultTheme } from './zoraDefaultTheme';\n\nfunction resolveModePrimaryColor(primaryColor: ZoraHexColor, _mode: ZoraThemeMode): ZoraHexColor {\n  // Intentionally conservative in Plan 1: mode-specific primary derivation\n  // (OKLCH/lightness scale, etc.) comes in later theme-engine work.\n  return primaryColor;\n}\n\nexport function createZoraThemeConfig(theme: ZoraTheme = zoraDefaultTheme): ThemeConfig {\n  return {\n    id: theme.id,\n    name: theme.name ?? theme.id,\n    light: {\n      primaryColor: resolveModePrimaryColor(theme.primaryColor, 'light'),\n      harmony: theme.harmony,\n      systemTone: theme.tone,\n    },\n    dark: {\n      primaryColor: resolveModePrimaryColor(theme.primaryColor, 'dark'),\n      harmony: theme.harmony,\n      systemTone: theme.tone,\n    },\n  };\n}\n"]}
+{"version":3,"file":"createZoraThemeConfig.js","sourceRoot":"","sources":["../../src/theme/createZoraThemeConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,UAAU,qBAAqB,CAAC,QAAmB,gBAAgB;IACvE,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;QAC5B,KAAK,EAAE;YACL,YAAY,EAAE,uBAAuB,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC;YAClE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI;SACvB;QACD,IAAI,EAAE;YACJ,YAAY,EAAE,uBAAuB,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC;YACjE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI;SACvB;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { ThemeConfig } from '@ankhorage/surface';\n\nimport { resolveModePrimaryColor } from '../internal/color';\nimport type { ZoraTheme } from './types';\nimport { zoraDefaultTheme } from './zoraDefaultTheme';\n\nexport function createZoraThemeConfig(theme: ZoraTheme = zoraDefaultTheme): ThemeConfig {\n  return {\n    id: theme.id,\n    name: theme.name ?? theme.id,\n    light: {\n      primaryColor: resolveModePrimaryColor(theme.primaryColor, 'light'),\n      harmony: theme.harmony,\n      systemTone: theme.tone,\n    },\n    dark: {\n      primaryColor: resolveModePrimaryColor(theme.primaryColor, 'dark'),\n      harmony: theme.harmony,\n      systemTone: theme.tone,\n    },\n  };\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -43,7 +43,8 @@
     }
   },
   "dependencies": {
-    "@ankhorage/surface": "^0.1.12"
+    "@ankhorage/surface": "^0.1.12",
+    "culori": "^4.0.2"
   },
   "files": [
     "dist",
@@ -84,6 +85,7 @@
     "@changesets/cli": "^2.31.0",
     "@expo/vector-icons": "^15.1.1",
     "@react-native-picker/picker": "^2.11.4",
+    "@types/culori": "^4.0.1",
     "@types/bun": "^1.3.13",
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",