@ankhorage/zora 0.12.0 → 0.12.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.12.2
+
+### Patch Changes
+
+- da31347: Adds internal hue-role assignment for future ZORA theme generation work.
+
+## 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,7 @@
+export { computeZoraHarmony, type ZoraComputedHarmony, type ZoraHarmonySlot, type ZoraHarmonySlotId, } from './harmony';
 export { parseHexToOklch } from './oklch';
 export { resolveModePrimaryColor } from './primary';
+export { assignZoraHarmonyRoleHues, getZoraHueRoleAssignment, type ZoraComputedHueRoles, type ZoraHueRoleAssignment, type ZoraHueRoleId, } from './roleHues';
+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,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AACpB,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,7 @@
+export { computeZoraHarmony, } from './harmony';
 export { parseHexToOklch } from './oklch';
 export { resolveModePrimaryColor } from './primary';
+export { assignZoraHarmonyRoleHues, getZoraHueRoleAssignment, } from './roleHues';
+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,yBAAyB,EACzB,wBAAwB,GAIzB,MAAM,YAAY,CAAC;AACpB,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  assignZoraHarmonyRoleHues,\n  getZoraHueRoleAssignment,\n  type ZoraComputedHueRoles,\n  type ZoraHueRoleAssignment,\n  type ZoraHueRoleId,\n} from './roleHues';\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/roleHues.d.ts

@@ -0,0 +1,15 @@
+import type { ZoraColorHarmony } from '../../theme/types';
+import type { ZoraComputedHarmony, ZoraHarmonySlotId } from './harmony';
+export type ZoraHueRoleId = 'primary' | 'secondary' | 'accent' | 'highlight' | 'surfaceTint';
+export interface ZoraHueRoleAssignment {
+    role: ZoraHueRoleId;
+    hue: number;
+    sourceSlotId: ZoraHarmonySlotId;
+}
+export interface ZoraComputedHueRoles {
+    harmony: ZoraColorHarmony;
+    assignments: readonly ZoraHueRoleAssignment[];
+}
+export declare function assignZoraHarmonyRoleHues(harmony: ZoraComputedHarmony): ZoraComputedHueRoles;
+export declare function getZoraHueRoleAssignment(roles: ZoraComputedHueRoles, role: ZoraHueRoleId): ZoraHueRoleAssignment;
+//# sourceMappingURL=roleHues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roleHues.d.ts","sourceRoot":"","sources":["../../../src/internal/color/roleHues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAmB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGzF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAE7F,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC/C;AAmCD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,CA8E5F;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,aAAa,GAClB,qBAAqB,CAQvB"}

package/dist/internal/color/roleHues.js

@@ -0,0 +1,103 @@
+import { normalizeHueDegrees } from './hue';
+function findSlot(harmony, id) {
+    return harmony.orderedSlots.find((slot) => slot.id === id);
+}
+function requireBaseSlot(harmony) {
+    const base = findSlot(harmony, 'base');
+    if (!base) {
+        throw new Error(`[zora] Expected harmony to include a base slot (kind: ${harmony.kind}).`);
+    }
+    return base;
+}
+function assignRole(role, harmony, preferred, fallback = 'base') {
+    const base = requireBaseSlot(harmony);
+    const preferredSlot = findSlot(harmony, preferred);
+    const fallbackSlot = findSlot(harmony, fallback);
+    const chosenSlot = preferredSlot ?? fallbackSlot ?? base;
+    return {
+        role,
+        hue: normalizeHueDegrees(chosenSlot.hue),
+        sourceSlotId: chosenSlot.id,
+    };
+}
+export function assignZoraHarmonyRoleHues(harmony) {
+    const { kind } = harmony;
+    if (kind === 'monochromatic') {
+        return {
+            harmony: kind,
+            assignments: [
+                assignRole('primary', harmony, 'base'),
+                assignRole('secondary', harmony, 'base'),
+                assignRole('accent', harmony, 'base'),
+                assignRole('highlight', harmony, 'base'),
+                assignRole('surfaceTint', harmony, 'base'),
+            ],
+        };
+    }
+    if (kind === 'complementary') {
+        return {
+            harmony: kind,
+            assignments: [
+                assignRole('primary', harmony, 'base'),
+                assignRole('secondary', harmony, 'base'),
+                assignRole('accent', harmony, 'a'),
+                assignRole('highlight', harmony, 'a'),
+                assignRole('surfaceTint', harmony, 'base'),
+            ],
+        };
+    }
+    if (kind === 'analogous') {
+        return {
+            harmony: kind,
+            assignments: [
+                assignRole('primary', harmony, 'base'),
+                assignRole('secondary', harmony, 'a'),
+                assignRole('accent', harmony, 'b', 'a'),
+                assignRole('highlight', harmony, 'b', 'a'),
+                assignRole('surfaceTint', harmony, 'a'),
+            ],
+        };
+    }
+    if (kind === 'splitComplementary') {
+        return {
+            harmony: kind,
+            assignments: [
+                assignRole('primary', harmony, 'base'),
+                assignRole('secondary', harmony, 'a'),
+                assignRole('accent', harmony, 'b', 'a'),
+                assignRole('highlight', harmony, 'b', 'a'),
+                assignRole('surfaceTint', harmony, 'base'),
+            ],
+        };
+    }
+    if (kind === 'triadic') {
+        return {
+            harmony: kind,
+            assignments: [
+                assignRole('primary', harmony, 'base'),
+                assignRole('secondary', harmony, 'a'),
+                assignRole('accent', harmony, 'b', 'a'),
+                assignRole('highlight', harmony, 'b', 'a'),
+                assignRole('surfaceTint', harmony, 'base'),
+            ],
+        };
+    }
+    return {
+        harmony: kind,
+        assignments: [
+            assignRole('primary', harmony, 'base'),
+            assignRole('secondary', harmony, 'a'),
+            assignRole('accent', harmony, 'b', 'a'),
+            assignRole('highlight', harmony, 'c', 'b'),
+            assignRole('surfaceTint', harmony, 'base'),
+        ],
+    };
+}
+export function getZoraHueRoleAssignment(roles, role) {
+    const found = roles.assignments.find((assignment) => assignment.role === role);
+    if (!found) {
+        throw new Error(`[zora] Expected a hue-role assignment for "${role}" (harmony: ${roles.harmony}).`);
+    }
+    return found;
+}
+//# sourceMappingURL=roleHues.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roleHues.js","sourceRoot":"","sources":["../../../src/internal/color/roleHues.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ZoraColorHarmony } from '../../theme/types';\nimport type { ZoraComputedHarmony, ZoraHarmonySlot, ZoraHarmonySlotId } from './harmony';\nimport { normalizeHueDegrees } from './hue';\n\nexport type ZoraHueRoleId = 'primary' | 'secondary' | 'accent' | 'highlight' | 'surfaceTint';\n\nexport interface ZoraHueRoleAssignment {\n  role: ZoraHueRoleId;\n  hue: number;\n  sourceSlotId: ZoraHarmonySlotId;\n}\n\nexport interface ZoraComputedHueRoles {\n  harmony: ZoraColorHarmony;\n  assignments: readonly ZoraHueRoleAssignment[];\n}\n\nfunction findSlot(\n  harmony: ZoraComputedHarmony,\n  id: ZoraHarmonySlotId,\n): ZoraHarmonySlot | undefined {\n  return harmony.orderedSlots.find((slot) => slot.id === id);\n}\n\nfunction requireBaseSlot(harmony: ZoraComputedHarmony): ZoraHarmonySlot {\n  const base = findSlot(harmony, 'base');\n  if (!base) {\n    throw new Error(`[zora] Expected harmony to include a base slot (kind: ${harmony.kind}).`);\n  }\n  return base;\n}\n\nfunction assignRole(\n  role: ZoraHueRoleId,\n  harmony: ZoraComputedHarmony,\n  preferred: ZoraHarmonySlotId,\n  fallback: ZoraHarmonySlotId = 'base',\n): ZoraHueRoleAssignment {\n  const base = requireBaseSlot(harmony);\n  const preferredSlot = findSlot(harmony, preferred);\n  const fallbackSlot = findSlot(harmony, fallback);\n  const chosenSlot = preferredSlot ?? fallbackSlot ?? base;\n\n  return {\n    role,\n    hue: normalizeHueDegrees(chosenSlot.hue),\n    sourceSlotId: chosenSlot.id,\n  };\n}\n\nexport function assignZoraHarmonyRoleHues(harmony: ZoraComputedHarmony): ZoraComputedHueRoles {\n  const { kind } = harmony;\n\n  if (kind === 'monochromatic') {\n    return {\n      harmony: kind,\n      assignments: [\n        assignRole('primary', harmony, 'base'),\n        assignRole('secondary', harmony, 'base'),\n        assignRole('accent', harmony, 'base'),\n        assignRole('highlight', harmony, 'base'),\n        assignRole('surfaceTint', harmony, 'base'),\n      ],\n    };\n  }\n\n  if (kind === 'complementary') {\n    return {\n      harmony: kind,\n      assignments: [\n        assignRole('primary', harmony, 'base'),\n        assignRole('secondary', harmony, 'base'),\n        assignRole('accent', harmony, 'a'),\n        assignRole('highlight', harmony, 'a'),\n        assignRole('surfaceTint', harmony, 'base'),\n      ],\n    };\n  }\n\n  if (kind === 'analogous') {\n    return {\n      harmony: kind,\n      assignments: [\n        assignRole('primary', harmony, 'base'),\n        assignRole('secondary', harmony, 'a'),\n        assignRole('accent', harmony, 'b', 'a'),\n        assignRole('highlight', harmony, 'b', 'a'),\n        assignRole('surfaceTint', harmony, 'a'),\n      ],\n    };\n  }\n\n  if (kind === 'splitComplementary') {\n    return {\n      harmony: kind,\n      assignments: [\n        assignRole('primary', harmony, 'base'),\n        assignRole('secondary', harmony, 'a'),\n        assignRole('accent', harmony, 'b', 'a'),\n        assignRole('highlight', harmony, 'b', 'a'),\n        assignRole('surfaceTint', harmony, 'base'),\n      ],\n    };\n  }\n\n  if (kind === 'triadic') {\n    return {\n      harmony: kind,\n      assignments: [\n        assignRole('primary', harmony, 'base'),\n        assignRole('secondary', harmony, 'a'),\n        assignRole('accent', harmony, 'b', 'a'),\n        assignRole('highlight', harmony, 'b', 'a'),\n        assignRole('surfaceTint', harmony, 'base'),\n      ],\n    };\n  }\n\n  return {\n    harmony: kind,\n    assignments: [\n      assignRole('primary', harmony, 'base'),\n      assignRole('secondary', harmony, 'a'),\n      assignRole('accent', harmony, 'b', 'a'),\n      assignRole('highlight', harmony, 'c', 'b'),\n      assignRole('surfaceTint', harmony, 'base'),\n    ],\n  };\n}\n\nexport function getZoraHueRoleAssignment(\n  roles: ZoraComputedHueRoles,\n  role: ZoraHueRoleId,\n): ZoraHueRoleAssignment {\n  const found = roles.assignments.find((assignment) => assignment.role === role);\n  if (!found) {\n    throw new Error(\n      `[zora] Expected a hue-role assignment for \"${role}\" (harmony: ${roles.harmony}).`,\n    );\n  }\n  return found;\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.2",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {