@ankhorage/zora 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.12.1
+
+### Patch Changes
+
+- 35c4046: Adds internal harmony hue-slot computation for future ZORA theme generation work.
+
 ## 0.12.0
 
 ### Minor Changes

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/color/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC"}
+{"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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/color/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC","sourcesContent":["export { parseHexToOklch } from './oklch';\nexport { resolveModePrimaryColor } from './primary';\n"]}
+{"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.map

@@ -1 +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;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAc9C,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"}
+{"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

@@ -1,10 +1,7 @@
 import { converter, formatHex, parse, toGamut } from 'culori';
+import { normalizeHueDegrees } from './hue';
 const toOklch = converter('oklch');
 const gamutMapToSrgb = toGamut('rgb', 'oklch');
-function normalizeHueDegrees(hue) {
-    const normalized = ((hue % 360) + 360) % 360;
-    return normalized;
-}
 function isSixDigitHexColor(value) {
     return /^#[0-9a-fA-F]{6}$/.test(value);
 }

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

@@ -1 +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 type { ZoraOklchColor } from './types';\n\nconst toOklch = converter('oklch');\nconst gamutMapToSrgb = toGamut('rgb', 'oklch');\n\nfunction normalizeHueDegrees(hue: number): number {\n  const normalized = ((hue % 360) + 360) % 360;\n  return normalized;\n}\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"]}
+{"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/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":"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","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

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/internal/color/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX"}
+{"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,2 +1,4 @@
-export {};
+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 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internal/color/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface ZoraOklchColor {\n  l: number;\n  c: number;\n  h: number;\n}\n"]}
+{"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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "0.12.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": {

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

@@ -0,0 +1,145 @@
+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();
+  });
+});

package/src/internal/color/harmony.ts

@@ -0,0 +1,96 @@
+import type { ZoraColorHarmony, ZoraHexColor } from '../../theme/types';
+import { normalizeHueDegrees, rotateHueDegrees } from './hue';
+import { parseHexToOklch } from './oklch';
+
+export type ZoraHarmonySlotId = 'base' | 'a' | 'b' | 'c';
+
+export interface ZoraHarmonySlot {
+  id: ZoraHarmonySlotId;
+  hue: number;
+}
+
+export interface ZoraComputedHarmony {
+  kind: ZoraColorHarmony;
+  orderedSlots: readonly ZoraHarmonySlot[];
+}
+
+const DEFAULT_HARMONY_HUE_DEGREES = 260;
+const MIN_SEED_CHROMA_FOR_HARMONY_HUE = 0.03;
+
+function createSlot(id: ZoraHarmonySlotId, hue: number): ZoraHarmonySlot {
+  return { id, hue: normalizeHueDegrees(hue) };
+}
+
+function resolveSeedHueDegrees(seed: ZoraHexColor): number {
+  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: ZoraHexColor,
+  harmony: ZoraColorHarmony,
+): ZoraComputedHarmony {
+  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)),
+    ],
+  };
+}

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

@@ -0,0 +1,28 @@
+import { describe, expect, test } from 'bun:test';
+
+import { normalizeHueDegrees, rotateHueDegrees } from './hue';
+
+describe('normalizeHueDegrees', () => {
+  test('normalizes negative hues into [0, 360)', () => {
+    expect(normalizeHueDegrees(-30)).toBe(330);
+    expect(normalizeHueDegrees(-390)).toBe(330);
+  });
+
+  test('normalizes hues >= 360 into [0, 360)', () => {
+    expect(normalizeHueDegrees(390)).toBe(30);
+    expect(normalizeHueDegrees(720)).toBe(0);
+  });
+
+  test('preserves in-range hues', () => {
+    expect(normalizeHueDegrees(0)).toBe(0);
+    expect(normalizeHueDegrees(12.5)).toBe(12.5);
+    expect(normalizeHueDegrees(359.99)).toBe(359.99);
+  });
+});
+
+describe('rotateHueDegrees', () => {
+  test('rotates and normalizes', () => {
+    expect(rotateHueDegrees(350, 30)).toBe(20);
+    expect(rotateHueDegrees(10, -30)).toBe(340);
+  });
+});

package/src/internal/color/hue.ts

@@ -0,0 +1,7 @@
+export function normalizeHueDegrees(hue: number): number {
+  return ((hue % 360) + 360) % 360;
+}
+
+export function rotateHueDegrees(hue: number, delta: number): number {
+  return normalizeHueDegrees(hue + delta);
+}

package/src/internal/color/index.ts

@@ -1,2 +1,15 @@
+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';

package/src/internal/color/oklch.ts

@@ -1,16 +1,12 @@
 import { converter, formatHex, parse, toGamut } from 'culori';
 
 import type { ZoraHexColor } from '../../theme/types';
+import { normalizeHueDegrees } from './hue';
 import type { ZoraOklchColor } from './types';
 
 const toOklch = converter('oklch');
 const gamutMapToSrgb = toGamut('rgb', 'oklch');
 
-function normalizeHueDegrees(hue: number): number {
-  const normalized = ((hue % 360) + 360) % 360;
-  return normalized;
-}
-
 function isSixDigitHexColor(value: string): value is ZoraHexColor {
   return /^#[0-9a-fA-F]{6}$/.test(value);
 }

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

@@ -0,0 +1,151 @@
+import { describe, expect, test } from 'bun:test';
+
+import type { ZoraHexColor } from '../../theme/types';
+import {
+  createZoraColorScale,
+  type CreateZoraColorScaleOptions,
+  createZoraNeutralScale,
+  createZoraPrimaryScale,
+  parseHexToOklch,
+  ZORA_COLOR_SCALE_STEPS,
+  type ZoraColorScale,
+  type ZoraColorScaleStep,
+} from './index';
+
+function isSixDigitLowercaseHexColor(value: string): value is ZoraHexColor {
+  return /^#[0-9a-f]{6}$/.test(value);
+}
+
+function hueDeltaDegrees(a: number, b: number): number {
+  const raw = Math.abs(a - b) % 360;
+  return Math.min(raw, 360 - raw);
+}
+
+function getStepValues(scale: ZoraColorScale): { step: ZoraColorScaleStep; hex: ZoraHexColor }[] {
+  return ZORA_COLOR_SCALE_STEPS.map((step) => ({ step, hex: scale[step] }));
+}
+
+function assertScaleKeys(scale: ZoraColorScale) {
+  const keys = Object.keys(scale)
+    .map((key) => Number(key))
+    .sort((a, b) => a - b);
+
+  expect(keys).toEqual([...ZORA_COLOR_SCALE_STEPS]);
+}
+
+function assertDecreasingLightness(scale: ZoraColorScale) {
+  const lightness = getStepValues(scale).map(({ hex }) => parseHexToOklch(hex).l);
+
+  for (let index = 0; index < lightness.length - 1; index += 1) {
+    expect(lightness[index]).toBeGreaterThan(lightness[index + 1]);
+  }
+}
+
+describe('createZoraPrimaryScale', () => {
+  test('matches createZoraColorScale({ role: primary })', () => {
+    const seed: ZoraHexColor = '#0f766e';
+    const options: CreateZoraColorScaleOptions = { seed, role: 'primary' };
+
+    expect(createZoraPrimaryScale(seed)).toEqual(createZoraColorScale(options));
+  });
+
+  test('returns all 50–950 keys and valid lowercase 6-digit hex values', () => {
+    const seed: ZoraHexColor = '#0f766e';
+    const scale = createZoraPrimaryScale(seed);
+
+    assertScaleKeys(scale);
+
+    for (const { hex } of getStepValues(scale)) {
+      expect(isSixDigitLowercaseHexColor(hex)).toBe(true);
+    }
+  });
+
+  test('is deterministic for the same seed', () => {
+    const seed: ZoraHexColor = '#0f766e';
+
+    expect(createZoraPrimaryScale(seed)).toEqual(createZoraPrimaryScale(seed));
+  });
+
+  test('lightness decreases from 50 to 950', () => {
+    const seed: ZoraHexColor = '#0f766e';
+    const scale = createZoraPrimaryScale(seed);
+
+    assertDecreasingLightness(scale);
+  });
+
+  test('preserves hue approximately for mid steps', () => {
+    const seed: ZoraHexColor = '#0f766e';
+    const seedOklch = parseHexToOklch(seed);
+    const scale = createZoraPrimaryScale(seed);
+
+    const midSteps: ZoraColorScaleStep[] = [400, 500, 600, 700];
+    for (const step of midSteps) {
+      const oklch = parseHexToOklch(scale[step]);
+      expect(hueDeltaDegrees(seedOklch.h, oklch.h)).toBeLessThan(20);
+    }
+  });
+
+  test('mid steps have higher chroma than extremes for a saturated seed', () => {
+    const seed: ZoraHexColor = '#ff00ff';
+    const scale = createZoraPrimaryScale(seed);
+
+    const chroma50 = parseHexToOklch(scale[50]).c;
+    const chroma950 = parseHexToOklch(scale[950]).c;
+    const chroma500 = parseHexToOklch(scale[500]).c;
+    const chroma600 = parseHexToOklch(scale[600]).c;
+
+    const extremes = Math.max(chroma50, chroma950);
+    const mid = Math.max(chroma500, chroma600);
+
+    expect(mid).toBeGreaterThan(extremes);
+  });
+
+  test('bounds saturated inputs to stay in gamut', () => {
+    const seed: ZoraHexColor = '#ff00ff';
+    const scale = createZoraPrimaryScale(seed);
+
+    for (const { hex } of getStepValues(scale)) {
+      expect(isSixDigitLowercaseHexColor(hex)).toBe(true);
+      expect(() => parseHexToOklch(hex)).not.toThrow();
+    }
+  });
+
+  test('throws on invalid seed in test/development', () => {
+    const invalid: ZoraHexColor = '#nope';
+
+    expect(() => createZoraPrimaryScale(invalid)).toThrow();
+  });
+});
+
+describe('createZoraNeutralScale', () => {
+  test('works with and without a seed', () => {
+    const seeded = createZoraNeutralScale('#0f766e');
+    const unseeded = createZoraNeutralScale();
+
+    assertScaleKeys(seeded);
+    assertScaleKeys(unseeded);
+  });
+
+  test('returns low-chroma neutrals', () => {
+    const scale = createZoraNeutralScale('#0f766e');
+
+    for (const { hex } of getStepValues(scale)) {
+      const oklch = parseHexToOklch(hex);
+      expect(oklch.c).toBeLessThanOrEqual(0.03);
+    }
+  });
+
+  test('lightness decreases from 50 to 950', () => {
+    const scale = createZoraNeutralScale('#0f766e');
+
+    assertDecreasingLightness(scale);
+  });
+
+  test('avoids pure black/white in the generated steps', () => {
+    const scale = createZoraNeutralScale('#0f766e');
+    const values = getStepValues(scale).map(({ hex }) => hex);
+
+    expect(values).not.toContain('#000000');
+    expect(values).not.toContain('#ffffff');
+  });
+});

package/src/internal/color/scales.ts

@@ -0,0 +1,145 @@
+import type { ZoraHexColor } from '../../theme/types';
+import { clampOklchToGamut, formatOklchAsHex, parseHexToOklch } from './oklch';
+import { type ZoraColorScale, type ZoraColorScaleStep } from './types';
+
+export interface CreateZoraColorScaleOptions {
+  seed: ZoraHexColor;
+  role?: 'primary' | 'neutral';
+}
+
+const PRIMARY_LIGHTNESS_BY_STEP: Record<ZoraColorScaleStep, number> = {
+  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: Record<ZoraColorScaleStep, number> = {
+  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: Record<ZoraColorScaleStep, number> = {
+  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: number, min: number, max: number): number {
+  return Math.max(min, Math.min(value, max));
+}
+
+function resolvePrimaryScaleChroma(seedChroma: number, step: ZoraColorScaleStep): number {
+  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: CreateZoraColorScaleOptions): ZoraColorScale {
+  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,
+  });
+}
+
+interface CreateScaleFromRampOptions {
+  hue: number;
+  chroma?: number;
+  chromaByStep?: (step: ZoraColorScaleStep) => number;
+  lightnessByStep: Record<ZoraColorScaleStep, number>;
+}
+
+function createScaleColor(
+  options: CreateScaleFromRampOptions,
+  step: ZoraColorScaleStep,
+): ZoraHexColor {
+  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: CreateScaleFromRampOptions): ZoraColorScale {
+  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: CreateZoraColorScaleOptions): ZoraColorScale {
+  return createScaleEntries({
+    seed: options.seed,
+    role: options.role,
+  });
+}
+
+export function createZoraPrimaryScale(seed: ZoraHexColor): ZoraColorScale {
+  return createZoraColorScale({ seed, role: 'primary' });
+}
+
+export function createZoraNeutralScale(seed: ZoraHexColor = '#94a3b8'): ZoraColorScale {
+  return createZoraColorScale({ seed, role: 'neutral' });
+}

package/src/internal/color/types.ts

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