@ankhorage/zora 0.12.1 → 0.12.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.12.3
+
+### Patch Changes
+
+- 2f08e20: Adds internal role color scale generation for future ZORA theme generation work.
+
+## 0.12.2
+
+### Patch Changes
+
+- da31347: Adds internal hue-role assignment for future ZORA theme generation work.
+
 ## 0.12.1
 
 ### Patch Changes

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

@@ -1,6 +1,8 @@
 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 { createZoraRoleColorScales, getZoraRoleColorScale, ZORA_COLOR_SCALE_ROLE_ORDER, type ZoraColorScaleRoleId, type ZoraComputedRoleColorScales, type ZoraRoleColorScale, } from './roleScales';
 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,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"}
+{"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,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,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,6 +1,8 @@
 export { computeZoraHarmony, } from './harmony';
 export { parseHexToOklch } from './oklch';
 export { resolveModePrimaryColor } from './primary';
+export { assignZoraHarmonyRoleHues, getZoraHueRoleAssignment, } from './roleHues';
+export { createZoraRoleColorScales, getZoraRoleColorScale, ZORA_COLOR_SCALE_ROLE_ORDER, } from './roleScales';
 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,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"]}
+{"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,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,GAI5B,MAAM,cAAc,CAAC;AACtB,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  createZoraRoleColorScales,\n  getZoraRoleColorScale,\n  ZORA_COLOR_SCALE_ROLE_ORDER,\n  type ZoraColorScaleRoleId,\n  type ZoraComputedRoleColorScales,\n  type ZoraRoleColorScale,\n} from './roleScales';\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/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/roleScales.d.ts

@@ -0,0 +1,19 @@
+import type { ZoraHexColor } from '../../theme/types';
+import { type ZoraComputedHueRoles } from './roleHues';
+import type { ZoraColorScale } from './types';
+export type ZoraColorScaleRoleId = 'primary' | 'secondary' | 'accent' | 'highlight' | 'surfaceTint' | 'neutral';
+export declare const ZORA_COLOR_SCALE_ROLE_ORDER: readonly ZoraColorScaleRoleId[];
+export interface ZoraRoleColorScale {
+    role: ZoraColorScaleRoleId;
+    sourceHue?: number;
+    scale: ZoraColorScale;
+}
+export interface ZoraComputedRoleColorScales {
+    roles: readonly ZoraRoleColorScale[];
+}
+export declare function getZoraRoleColorScale(scales: ZoraComputedRoleColorScales, role: ZoraColorScaleRoleId): ZoraRoleColorScale;
+export declare function createZoraRoleColorScales(options: {
+    hueRoles: ZoraComputedHueRoles;
+    seed: ZoraHexColor;
+}): ZoraComputedRoleColorScales;
+//# sourceMappingURL=roleScales.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roleScales.d.ts","sourceRoot":"","sources":["../../../src/internal/color/roleScales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAOpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,aAAa,GACb,SAAS,CAAC;AAEd,eAAO,MAAM,2BAA2B,EAAE,SAAS,oBAAoB,EAOtE,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,2BAA2B,EACnC,IAAI,EAAE,oBAAoB,GACzB,kBAAkB,CAMpB;AA0BD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,EAAE,YAAY,CAAC;CACpB,GAAG,2BAA2B,CAgB9B"}

package/dist/internal/color/roleScales.js

@@ -0,0 +1,51 @@
+import { parseHexToOklch } from './oklch';
+import { getZoraHueRoleAssignment, } from './roleHues';
+import { createZoraHueScale, createZoraNeutralScale, } from './scales';
+export const ZORA_COLOR_SCALE_ROLE_ORDER = [
+    'primary',
+    'secondary',
+    'accent',
+    'highlight',
+    'surfaceTint',
+    'neutral',
+];
+export function getZoraRoleColorScale(scales, role) {
+    const found = scales.roles.find((entry) => entry.role === role);
+    if (!found) {
+        throw new Error(`[zora] Expected role color scales to include "${role}".`);
+    }
+    return found;
+}
+function resolveSeedChroma(seed) {
+    return parseHexToOklch(seed).c;
+}
+function createHueBackedRoleScale(options) {
+    const assignment = getZoraHueRoleAssignment(options.hueRoles, options.role);
+    const hueScaleRole = options.role;
+    const hueScaleOptions = {
+        hue: assignment.hue,
+        seedChroma: options.seedChroma,
+        role: hueScaleRole,
+    };
+    return {
+        role: options.role,
+        sourceHue: assignment.hue,
+        scale: createZoraHueScale(hueScaleOptions),
+    };
+}
+export function createZoraRoleColorScales(options) {
+    const seedChroma = resolveSeedChroma(options.seed);
+    const roles = [
+        createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'primary' }),
+        createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'secondary' }),
+        createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'accent' }),
+        createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'highlight' }),
+        createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'surfaceTint' }),
+        {
+            role: 'neutral',
+            scale: createZoraNeutralScale(options.seed),
+        },
+    ];
+    return { roles };
+}
+//# sourceMappingURL=roleScales.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roleScales.js","sourceRoot":"","sources":["../../../src/internal/color/roleScales.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EACL,wBAAwB,GAGzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAElB,sBAAsB,GAEvB,MAAM,UAAU,CAAC;AAWlB,MAAM,CAAC,MAAM,2BAA2B,GAAoC;IAC1E,SAAS;IACT,WAAW;IACX,QAAQ;IACR,WAAW;IACX,aAAa;IACb,SAAS;CACV,CAAC;AAYF,MAAM,UAAU,qBAAqB,CACnC,MAAmC,EACnC,IAA0B;IAE1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,IAAI,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAkB;IAC3C,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,wBAAwB,CAAC,OAIjC;IACC,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAuB,OAAO,CAAC,IAAI,CAAC;IACtD,MAAM,eAAe,GAA8B;QACjD,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI,EAAE,YAAY;KACnB,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,UAAU,CAAC,GAAG;QACzB,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAGzC;IACC,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAyB;QAClC,wBAAwB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACrF,wBAAwB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACvF,wBAAwB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACpF,wBAAwB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACvF,wBAAwB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACzF;YACE,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC;SAC5C;KACF,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC","sourcesContent":["import type { ZoraHexColor } from '../../theme/types';\nimport { parseHexToOklch } from './oklch';\nimport {\n  getZoraHueRoleAssignment,\n  type ZoraComputedHueRoles,\n  type ZoraHueRoleId,\n} from './roleHues';\nimport {\n  createZoraHueScale,\n  type CreateZoraHueScaleOptions,\n  createZoraNeutralScale,\n  type ZoraHueScaleRoleId,\n} from './scales';\nimport type { ZoraColorScale } from './types';\n\nexport type ZoraColorScaleRoleId =\n  | 'primary'\n  | 'secondary'\n  | 'accent'\n  | 'highlight'\n  | 'surfaceTint'\n  | 'neutral';\n\nexport const ZORA_COLOR_SCALE_ROLE_ORDER: readonly ZoraColorScaleRoleId[] = [\n  'primary',\n  'secondary',\n  'accent',\n  'highlight',\n  'surfaceTint',\n  'neutral',\n];\n\nexport interface ZoraRoleColorScale {\n  role: ZoraColorScaleRoleId;\n  sourceHue?: number;\n  scale: ZoraColorScale;\n}\n\nexport interface ZoraComputedRoleColorScales {\n  roles: readonly ZoraRoleColorScale[];\n}\n\nexport function getZoraRoleColorScale(\n  scales: ZoraComputedRoleColorScales,\n  role: ZoraColorScaleRoleId,\n): ZoraRoleColorScale {\n  const found = scales.roles.find((entry) => entry.role === role);\n  if (!found) {\n    throw new Error(`[zora] Expected role color scales to include \"${role}\".`);\n  }\n  return found;\n}\n\nfunction resolveSeedChroma(seed: ZoraHexColor): number {\n  return parseHexToOklch(seed).c;\n}\n\nfunction createHueBackedRoleScale(options: {\n  hueRoles: ZoraComputedHueRoles;\n  seedChroma: number;\n  role: ZoraHueRoleId;\n}): ZoraRoleColorScale {\n  const assignment = getZoraHueRoleAssignment(options.hueRoles, options.role);\n  const hueScaleRole: ZoraHueScaleRoleId = options.role;\n  const hueScaleOptions: CreateZoraHueScaleOptions = {\n    hue: assignment.hue,\n    seedChroma: options.seedChroma,\n    role: hueScaleRole,\n  };\n\n  return {\n    role: options.role,\n    sourceHue: assignment.hue,\n    scale: createZoraHueScale(hueScaleOptions),\n  };\n}\n\nexport function createZoraRoleColorScales(options: {\n  hueRoles: ZoraComputedHueRoles;\n  seed: ZoraHexColor;\n}): ZoraComputedRoleColorScales {\n  const seedChroma = resolveSeedChroma(options.seed);\n\n  const roles: ZoraRoleColorScale[] = [\n    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'primary' }),\n    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'secondary' }),\n    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'accent' }),\n    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'highlight' }),\n    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'surfaceTint' }),\n    {\n      role: 'neutral',\n      scale: createZoraNeutralScale(options.seed),\n    },\n  ];\n\n  return { roles };\n}\n"]}

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

@@ -4,7 +4,14 @@ export interface CreateZoraColorScaleOptions {
     seed: ZoraHexColor;
     role?: 'primary' | 'neutral';
 }
+export type ZoraHueScaleRoleId = 'primary' | 'secondary' | 'accent' | 'highlight' | 'surfaceTint';
+export interface CreateZoraHueScaleOptions {
+    hue: number;
+    seedChroma: number;
+    role: ZoraHueScaleRoleId;
+}
 export declare function createZoraColorScale(options: CreateZoraColorScaleOptions): ZoraColorScale;
 export declare function createZoraPrimaryScale(seed: ZoraHexColor): ZoraColorScale;
 export declare function createZoraNeutralScale(seed?: ZoraHexColor): ZoraColorScale;
+export declare function createZoraHueScale(options: CreateZoraHueScaleOptions): ZoraColorScale;
 //# sourceMappingURL=scales.d.ts.map

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

@@ -1 +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"}
+{"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;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAElG,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AA4ID,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;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,cAAc,CAMrF"}

package/dist/internal/color/scales.js

@@ -43,6 +43,13 @@ 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;
+const ROLE_CHROMA_FACTOR = {
+    primary: 1,
+    secondary: 0.72,
+    accent: 0.85,
+    highlight: 1,
+    surfaceTint: 0.18,
+};
 function clampNumber(value, min, max) {
     return Math.max(min, Math.min(value, max));
 }
@@ -54,6 +61,10 @@ function resolvePrimaryScaleChroma(seedChroma, step) {
     const shouldEnforceMin = step >= 300 && step <= 700 && seedChroma >= MIN_PRIMARY_SCALE_CHROMA;
     return shouldEnforceMin ? Math.max(bounded, MIN_PRIMARY_SCALE_CHROMA) : bounded;
 }
+function resolveHueScaleChroma(options, step) {
+    const factor = ROLE_CHROMA_FACTOR[options.role];
+    return resolvePrimaryScaleChroma(options.seedChroma * factor, step);
+}
 function createScaleEntries(options) {
     const seed = parseHexToOklch(options.seed);
     if (options.role === 'neutral') {
@@ -107,4 +118,11 @@ export function createZoraPrimaryScale(seed) {
 export function createZoraNeutralScale(seed = '#94a3b8') {
     return createZoraColorScale({ seed, role: 'neutral' });
 }
+export function createZoraHueScale(options) {
+    return createScaleFromRamp({
+        hue: options.hue,
+        chromaByStep: (step) => resolveHueScaleChroma(options, step),
+        lightnessByStep: PRIMARY_LIGHTNESS_BY_STEP,
+    });
+}
 //# sourceMappingURL=scales.js.map

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

@@ -1 +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"]}
+{"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\nexport type ZoraHueScaleRoleId = 'primary' | 'secondary' | 'accent' | 'highlight' | 'surfaceTint';\n\nexport interface CreateZoraHueScaleOptions {\n  hue: number;\n  seedChroma: number;\n  role: ZoraHueScaleRoleId;\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\nconst ROLE_CHROMA_FACTOR = {\n  primary: 1,\n  secondary: 0.72,\n  accent: 0.85,\n  highlight: 1,\n  surfaceTint: 0.18,\n} satisfies Record<ZoraHueScaleRoleId, number>;\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 resolveHueScaleChroma(\n  options: CreateZoraHueScaleOptions,\n  step: ZoraColorScaleStep,\n): number {\n  const factor = ROLE_CHROMA_FACTOR[options.role];\n  return resolvePrimaryScaleChroma(options.seedChroma * factor, step);\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\nexport function createZoraHueScale(options: CreateZoraHueScaleOptions): ZoraColorScale {\n  return createScaleFromRamp({\n    hue: options.hue,\n    chromaByStep: (step) => resolveHueScaleChroma(options, step),\n    lightnessByStep: PRIMARY_LIGHTNESS_BY_STEP,\n  });\n}\n"]}

package/package.json

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

@@ -6,6 +6,21 @@ export {
 } from './harmony';
 export { parseHexToOklch } from './oklch';
 export { resolveModePrimaryColor } from './primary';
+export {
+  assignZoraHarmonyRoleHues,
+  getZoraHueRoleAssignment,
+  type ZoraComputedHueRoles,
+  type ZoraHueRoleAssignment,
+  type ZoraHueRoleId,
+} from './roleHues';
+export {
+  createZoraRoleColorScales,
+  getZoraRoleColorScale,
+  ZORA_COLOR_SCALE_ROLE_ORDER,
+  type ZoraColorScaleRoleId,
+  type ZoraComputedRoleColorScales,
+  type ZoraRoleColorScale,
+} from './roleScales';
 export {
   createZoraColorScale,
   type CreateZoraColorScaleOptions,

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

@@ -0,0 +1,197 @@
+import { describe, expect, test } from 'bun:test';
+
+import {
+  assignZoraHarmonyRoleHues,
+  getZoraHueRoleAssignment,
+  type ZoraComputedHarmony,
+  type ZoraComputedHueRoles,
+  type ZoraHueRoleAssignment,
+  type ZoraHueRoleId,
+} from './index';
+
+function expectNormalizedHue(hue: number) {
+  expect(Number.isFinite(hue)).toBe(true);
+  expect(hue).toBeGreaterThanOrEqual(0);
+  expect(hue).toBeLessThan(360);
+}
+
+const ROLE_ORDER: readonly ZoraHueRoleId[] = [
+  'primary',
+  'secondary',
+  'accent',
+  'highlight',
+  'surfaceTint',
+];
+
+function expectEveryRoleOnce(roles: ReturnType<typeof assignZoraHarmonyRoleHues>) {
+  expect(roles.assignments).toHaveLength(ROLE_ORDER.length);
+  expect(roles.assignments.map((assignment) => assignment.role)).toEqual([...ROLE_ORDER]);
+}
+
+describe('assignZoraHarmonyRoleHues', () => {
+  test('monochromatic assigns every role to base', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'monochromatic',
+      orderedSlots: [{ id: 'base', hue: 100 }],
+    };
+
+    const roles: ZoraComputedHueRoles = assignZoraHarmonyRoleHues(harmony);
+
+    expectEveryRoleOnce(roles);
+    for (const assignment of roles.assignments) {
+      expect(assignment.sourceSlotId).toBe('base');
+      expect(assignment.hue).toBe(100);
+      expectNormalizedHue(assignment.hue);
+    }
+  });
+
+  test('complementary assigns accent/highlight to a', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'complementary',
+      orderedSlots: [
+        { id: 'base', hue: 100 },
+        { id: 'a', hue: 280 },
+      ],
+    };
+
+    const roles: ZoraComputedHueRoles = assignZoraHarmonyRoleHues(harmony);
+
+    expectEveryRoleOnce(roles);
+    const accent: ZoraHueRoleAssignment = getZoraHueRoleAssignment(roles, 'accent');
+    const highlight: ZoraHueRoleAssignment = getZoraHueRoleAssignment(roles, 'highlight');
+
+    expect(accent.sourceSlotId).toBe('a');
+    expect(highlight.sourceSlotId).toBe('a');
+    expect(getZoraHueRoleAssignment(roles, 'primary').sourceSlotId).toBe('base');
+    expect(getZoraHueRoleAssignment(roles, 'surfaceTint').sourceSlotId).toBe('base');
+  });
+
+  test('analogous assigns secondary/surfaceTint to a and accent/highlight to b', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'analogous',
+      orderedSlots: [
+        { id: 'base', hue: 100 },
+        { id: 'a', hue: 70 },
+        { id: 'b', hue: 130 },
+      ],
+    };
+
+    const roles = assignZoraHarmonyRoleHues(harmony);
+
+    expectEveryRoleOnce(roles);
+    expect(getZoraHueRoleAssignment(roles, 'secondary').sourceSlotId).toBe('a');
+    expect(getZoraHueRoleAssignment(roles, 'surfaceTint').sourceSlotId).toBe('a');
+    expect(getZoraHueRoleAssignment(roles, 'accent').sourceSlotId).toBe('b');
+    expect(getZoraHueRoleAssignment(roles, 'highlight').sourceSlotId).toBe('b');
+  });
+
+  test('splitComplementary assigns primary/surfaceTint to base and accent/highlight to b', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'splitComplementary',
+      orderedSlots: [
+        { id: 'base', hue: 100 },
+        { id: 'a', hue: 250 },
+        { id: 'b', hue: 310 },
+      ],
+    };
+
+    const roles = assignZoraHarmonyRoleHues(harmony);
+
+    expectEveryRoleOnce(roles);
+    expect(getZoraHueRoleAssignment(roles, 'primary').sourceSlotId).toBe('base');
+    expect(getZoraHueRoleAssignment(roles, 'surfaceTint').sourceSlotId).toBe('base');
+    expect(getZoraHueRoleAssignment(roles, 'accent').sourceSlotId).toBe('b');
+    expect(getZoraHueRoleAssignment(roles, 'highlight').sourceSlotId).toBe('b');
+  });
+
+  test('triadic assigns primary/surfaceTint to base and secondary/accent across a/b', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'triadic',
+      orderedSlots: [
+        { id: 'base', hue: 100 },
+        { id: 'a', hue: 220 },
+        { id: 'b', hue: 340 },
+      ],
+    };
+
+    const roles = assignZoraHarmonyRoleHues(harmony);
+
+    expectEveryRoleOnce(roles);
+    expect(getZoraHueRoleAssignment(roles, 'primary').sourceSlotId).toBe('base');
+    expect(getZoraHueRoleAssignment(roles, 'surfaceTint').sourceSlotId).toBe('base');
+    expect(getZoraHueRoleAssignment(roles, 'secondary').sourceSlotId).toBe('a');
+    expect(getZoraHueRoleAssignment(roles, 'accent').sourceSlotId).toBe('b');
+  });
+
+  test('tetradic assigns highlight to c', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'tetradic',
+      orderedSlots: [
+        { id: 'base', hue: 100 },
+        { id: 'a', hue: 190 },
+        { id: 'b', hue: 280 },
+        { id: 'c', hue: 10 },
+      ],
+    };
+
+    const roles = assignZoraHarmonyRoleHues(harmony);
+
+    expectEveryRoleOnce(roles);
+    expect(getZoraHueRoleAssignment(roles, 'highlight').sourceSlotId).toBe('c');
+  });
+
+  test('every assignment hue is normalized to [0, 360)', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'complementary',
+      orderedSlots: [
+        { id: 'base', hue: -10 },
+        { id: 'a', hue: 370 },
+      ],
+    };
+
+    const roles = assignZoraHarmonyRoleHues(harmony);
+
+    expectEveryRoleOnce(roles);
+    for (const assignment of roles.assignments) {
+      expectNormalizedHue(assignment.hue);
+    }
+  });
+
+  test('is deterministic for the same computed harmony', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'analogous',
+      orderedSlots: [
+        { id: 'base', hue: 100 },
+        { id: 'a', hue: 70 },
+        { id: 'b', hue: 130 },
+      ],
+    };
+
+    expect(assignZoraHarmonyRoleHues(harmony)).toEqual(assignZoraHarmonyRoleHues(harmony));
+  });
+
+  test('falls back when a preferred non-base slot is missing', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'analogous',
+      orderedSlots: [
+        { id: 'base', hue: 100 },
+        { id: 'a', hue: 70 },
+      ],
+    };
+
+    const roles = assignZoraHarmonyRoleHues(harmony);
+
+    expectEveryRoleOnce(roles);
+    expect(getZoraHueRoleAssignment(roles, 'accent').sourceSlotId).toBe('a');
+    expect(getZoraHueRoleAssignment(roles, 'highlight').sourceSlotId).toBe('a');
+  });
+
+  test('throws a clear error when the base slot is missing', () => {
+    const harmony: ZoraComputedHarmony = {
+      kind: 'complementary',
+      orderedSlots: [{ id: 'a', hue: 200 }],
+    };
+
+    expect(() => assignZoraHarmonyRoleHues(harmony)).toThrow('base');
+  });
+});

package/src/internal/color/roleHues.ts

@@ -0,0 +1,142 @@
+import type { ZoraColorHarmony } from '../../theme/types';
+import type { ZoraComputedHarmony, ZoraHarmonySlot, ZoraHarmonySlotId } from './harmony';
+import { normalizeHueDegrees } from './hue';
+
+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[];
+}
+
+function findSlot(
+  harmony: ZoraComputedHarmony,
+  id: ZoraHarmonySlotId,
+): ZoraHarmonySlot | undefined {
+  return harmony.orderedSlots.find((slot) => slot.id === id);
+}
+
+function requireBaseSlot(harmony: ZoraComputedHarmony): ZoraHarmonySlot {
+  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: ZoraHueRoleId,
+  harmony: ZoraComputedHarmony,
+  preferred: ZoraHarmonySlotId,
+  fallback: ZoraHarmonySlotId = 'base',
+): ZoraHueRoleAssignment {
+  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: ZoraComputedHarmony): ZoraComputedHueRoles {
+  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: ZoraComputedHueRoles,
+  role: ZoraHueRoleId,
+): ZoraHueRoleAssignment {
+  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;
+}

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

@@ -0,0 +1,247 @@
+import { describe, expect, test } from 'bun:test';
+
+import type { ZoraHexColor } from '../../theme/types';
+import {
+  assignZoraHarmonyRoleHues,
+  computeZoraHarmony,
+  createZoraRoleColorScales,
+  getZoraRoleColorScale,
+  parseHexToOklch,
+  ZORA_COLOR_SCALE_ROLE_ORDER,
+  ZORA_COLOR_SCALE_STEPS,
+  type ZoraColorScale,
+  type ZoraColorScaleRoleId,
+  type ZoraColorScaleStep,
+  type ZoraComputedHueRoles,
+  type ZoraComputedRoleColorScales,
+  type ZoraRoleColorScale,
+} 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 assertNoPureBlackOrWhite(scale: ZoraColorScale) {
+  const values = getStepValues(scale).map(({ hex }) => hex);
+  expect(values).not.toContain('#000000');
+  expect(values).not.toContain('#ffffff');
+}
+
+function buildHueRoles(assignments: ZoraComputedHueRoles['assignments']): ZoraComputedHueRoles {
+  return {
+    harmony: 'tetradic',
+    assignments,
+  };
+}
+
+function requireHueBackedSourceHue(role: ZoraRoleColorScale): number {
+  if (typeof role.sourceHue !== 'number') {
+    throw new Error(`[zora] Expected "${role.role}" role scale to include a sourceHue.`);
+  }
+  return role.sourceHue;
+}
+
+function expectRoleOrder(
+  scales: ZoraComputedRoleColorScales,
+  expected: readonly ZoraColorScaleRoleId[],
+) {
+  expect(scales.roles.map((entry) => entry.role)).toEqual([...expected]);
+}
+
+describe('createZoraRoleColorScales', () => {
+  test('returns all roles exactly once in deterministic order', () => {
+    const hueRoles = buildHueRoles([
+      { role: 'primary', hue: 120, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 200, sourceSlotId: 'a' },
+      { role: 'accent', hue: 280, sourceSlotId: 'b' },
+      { role: 'highlight', hue: 20, sourceSlotId: 'c' },
+      { role: 'surfaceTint', hue: 160, sourceSlotId: 'a' },
+    ]);
+
+    const scales: ZoraComputedRoleColorScales = createZoraRoleColorScales({
+      hueRoles,
+      seed: '#0f766e',
+    });
+
+    const expectedOrder: readonly ZoraColorScaleRoleId[] = ZORA_COLOR_SCALE_ROLE_ORDER;
+    expect(scales.roles).toHaveLength(expectedOrder.length);
+
+    expectRoleOrder(scales, expectedOrder);
+    expect(new Set(scales.roles.map((entry) => entry.role)).size).toBe(
+      ZORA_COLOR_SCALE_ROLE_ORDER.length,
+    );
+  });
+
+  test('every scale contains exactly all 50–950 keys and valid lowercase 6-digit hex values', () => {
+    const hueRoles = buildHueRoles([
+      { role: 'primary', hue: 120, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 200, sourceSlotId: 'a' },
+      { role: 'accent', hue: 280, sourceSlotId: 'b' },
+      { role: 'highlight', hue: 20, sourceSlotId: 'c' },
+      { role: 'surfaceTint', hue: 160, sourceSlotId: 'a' },
+    ]);
+
+    const scales = createZoraRoleColorScales({ hueRoles, seed: '#0f766e' });
+
+    for (const role of scales.roles) {
+      assertScaleKeys(role.scale);
+      for (const { hex } of getStepValues(role.scale)) {
+        expect(isSixDigitLowercaseHexColor(hex)).toBe(true);
+      }
+    }
+  });
+
+  test('output is deterministic for the same input', () => {
+    const hueRoles = buildHueRoles([
+      { role: 'primary', hue: 120, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 200, sourceSlotId: 'a' },
+      { role: 'accent', hue: 280, sourceSlotId: 'b' },
+      { role: 'highlight', hue: 20, sourceSlotId: 'c' },
+      { role: 'surfaceTint', hue: 160, sourceSlotId: 'a' },
+    ]);
+
+    const seed: ZoraHexColor = '#0f766e';
+
+    expect(createZoraRoleColorScales({ hueRoles, seed })).toEqual(
+      createZoraRoleColorScales({ hueRoles, seed }),
+    );
+  });
+
+  test('role hue is preserved approximately for mid steps', () => {
+    const hueRoles = buildHueRoles([
+      { role: 'primary', hue: 115, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 210, sourceSlotId: 'a' },
+      { role: 'accent', hue: 300, sourceSlotId: 'b' },
+      { role: 'highlight', hue: 25, sourceSlotId: 'c' },
+      { role: 'surfaceTint', hue: 165, sourceSlotId: 'a' },
+    ]);
+
+    const scales = createZoraRoleColorScales({ hueRoles, seed: '#0f766e' });
+
+    const midSteps: ZoraColorScaleStep[] = [400, 500, 600, 700];
+    for (const roleId of ['primary', 'secondary', 'accent', 'highlight', 'surfaceTint'] as const) {
+      const role = getZoraRoleColorScale(scales, roleId);
+      const expectedHue = requireHueBackedSourceHue(role);
+
+      for (const step of midSteps) {
+        const oklch = parseHexToOklch(role.scale[step]);
+        expect(hueDeltaDegrees(expectedHue, oklch.h)).toBeLessThan(25);
+      }
+    }
+  });
+
+  test('surfaceTint scale has lower chroma than primary/accent/highlight for mid steps', () => {
+    const hueRoles = buildHueRoles([
+      { role: 'primary', hue: 120, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 200, sourceSlotId: 'a' },
+      { role: 'accent', hue: 280, sourceSlotId: 'b' },
+      { role: 'highlight', hue: 20, sourceSlotId: 'c' },
+      { role: 'surfaceTint', hue: 160, sourceSlotId: 'a' },
+    ]);
+
+    const scales = createZoraRoleColorScales({ hueRoles, seed: '#0f766e' });
+
+    const surfaceTint = getZoraRoleColorScale(scales, 'surfaceTint').scale;
+    const primary = getZoraRoleColorScale(scales, 'primary').scale;
+    const accent = getZoraRoleColorScale(scales, 'accent').scale;
+    const highlight = getZoraRoleColorScale(scales, 'highlight').scale;
+
+    const step: ZoraColorScaleStep = 500;
+    const surfaceTintChroma = parseHexToOklch(surfaceTint[step]).c;
+
+    expect(surfaceTintChroma).toBeLessThan(parseHexToOklch(primary[step]).c);
+    expect(surfaceTintChroma).toBeLessThan(parseHexToOklch(accent[step]).c);
+    expect(surfaceTintChroma).toBeLessThan(parseHexToOklch(highlight[step]).c);
+  });
+
+  test('neutral scale has low chroma', () => {
+    const hueRoles = buildHueRoles([
+      { role: 'primary', hue: 120, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 200, sourceSlotId: 'a' },
+      { role: 'accent', hue: 280, sourceSlotId: 'b' },
+      { role: 'highlight', hue: 20, sourceSlotId: 'c' },
+      { role: 'surfaceTint', hue: 160, sourceSlotId: 'a' },
+    ]);
+
+    const scales = createZoraRoleColorScales({ hueRoles, seed: '#0f766e' });
+    const neutral = getZoraRoleColorScale(scales, 'neutral').scale;
+
+    for (const { hex } of getStepValues(neutral)) {
+      expect(parseHexToOklch(hex).c).toBeLessThanOrEqual(0.03);
+    }
+  });
+
+  test('missing required hue role throws a clear error', () => {
+    const hueRoles = buildHueRoles([
+      { role: 'primary', hue: 120, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 200, sourceSlotId: 'a' },
+      { role: 'accent', hue: 280, sourceSlotId: 'b' },
+      { role: 'surfaceTint', hue: 160, sourceSlotId: 'a' },
+    ]);
+
+    expect(() => createZoraRoleColorScales({ hueRoles, seed: '#0f766e' })).toThrow('highlight');
+  });
+
+  test('no role scale contains pure black/white by default', () => {
+    const hueRoles = buildHueRoles([
+      { role: 'primary', hue: 120, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 200, sourceSlotId: 'a' },
+      { role: 'accent', hue: 280, sourceSlotId: 'b' },
+      { role: 'highlight', hue: 20, sourceSlotId: 'c' },
+      { role: 'surfaceTint', hue: 160, sourceSlotId: 'a' },
+    ]);
+
+    const scales = createZoraRoleColorScales({ hueRoles, seed: '#0f766e' });
+
+    for (const role of scales.roles) {
+      assertNoPureBlackOrWhite(role.scale);
+    }
+  });
+
+  test('does not mutate input hueRoles', () => {
+    const assignments: ZoraComputedHueRoles['assignments'] = [
+      { role: 'primary', hue: 120, sourceSlotId: 'base' },
+      { role: 'secondary', hue: 200, sourceSlotId: 'a' },
+      { role: 'accent', hue: 280, sourceSlotId: 'b' },
+      { role: 'highlight', hue: 20, sourceSlotId: 'c' },
+      { role: 'surfaceTint', hue: 160, sourceSlotId: 'a' },
+    ];
+
+    const hueRoles: ZoraComputedHueRoles = buildHueRoles(assignments);
+    const snapshot = JSON.stringify(hueRoles);
+
+    createZoraRoleColorScales({ hueRoles, seed: '#0f766e' });
+
+    expect(JSON.stringify(hueRoles)).toBe(snapshot);
+  });
+
+  test('integration: harmony -> role hues -> role scales pipeline connects', () => {
+    const seed: ZoraHexColor = '#0f766e';
+    const harmony = computeZoraHarmony(seed, 'tetradic');
+    const hueRoles = assignZoraHarmonyRoleHues(harmony);
+
+    const scales = createZoraRoleColorScales({ hueRoles, seed });
+
+    expect(scales.roles.map((entry) => entry.role)).toEqual([...ZORA_COLOR_SCALE_ROLE_ORDER]);
+    for (const role of scales.roles) {
+      assertScaleKeys(role.scale);
+    }
+  });
+});

package/src/internal/color/roleScales.ts

@@ -0,0 +1,97 @@
+import type { ZoraHexColor } from '../../theme/types';
+import { parseHexToOklch } from './oklch';
+import {
+  getZoraHueRoleAssignment,
+  type ZoraComputedHueRoles,
+  type ZoraHueRoleId,
+} from './roleHues';
+import {
+  createZoraHueScale,
+  type CreateZoraHueScaleOptions,
+  createZoraNeutralScale,
+  type ZoraHueScaleRoleId,
+} from './scales';
+import type { ZoraColorScale } from './types';
+
+export type ZoraColorScaleRoleId =
+  | 'primary'
+  | 'secondary'
+  | 'accent'
+  | 'highlight'
+  | 'surfaceTint'
+  | 'neutral';
+
+export const ZORA_COLOR_SCALE_ROLE_ORDER: readonly ZoraColorScaleRoleId[] = [
+  'primary',
+  'secondary',
+  'accent',
+  'highlight',
+  'surfaceTint',
+  'neutral',
+];
+
+export interface ZoraRoleColorScale {
+  role: ZoraColorScaleRoleId;
+  sourceHue?: number;
+  scale: ZoraColorScale;
+}
+
+export interface ZoraComputedRoleColorScales {
+  roles: readonly ZoraRoleColorScale[];
+}
+
+export function getZoraRoleColorScale(
+  scales: ZoraComputedRoleColorScales,
+  role: ZoraColorScaleRoleId,
+): ZoraRoleColorScale {
+  const found = scales.roles.find((entry) => entry.role === role);
+  if (!found) {
+    throw new Error(`[zora] Expected role color scales to include "${role}".`);
+  }
+  return found;
+}
+
+function resolveSeedChroma(seed: ZoraHexColor): number {
+  return parseHexToOklch(seed).c;
+}
+
+function createHueBackedRoleScale(options: {
+  hueRoles: ZoraComputedHueRoles;
+  seedChroma: number;
+  role: ZoraHueRoleId;
+}): ZoraRoleColorScale {
+  const assignment = getZoraHueRoleAssignment(options.hueRoles, options.role);
+  const hueScaleRole: ZoraHueScaleRoleId = options.role;
+  const hueScaleOptions: CreateZoraHueScaleOptions = {
+    hue: assignment.hue,
+    seedChroma: options.seedChroma,
+    role: hueScaleRole,
+  };
+
+  return {
+    role: options.role,
+    sourceHue: assignment.hue,
+    scale: createZoraHueScale(hueScaleOptions),
+  };
+}
+
+export function createZoraRoleColorScales(options: {
+  hueRoles: ZoraComputedHueRoles;
+  seed: ZoraHexColor;
+}): ZoraComputedRoleColorScales {
+  const seedChroma = resolveSeedChroma(options.seed);
+
+  const roles: ZoraRoleColorScale[] = [
+    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'primary' }),
+    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'secondary' }),
+    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'accent' }),
+    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'highlight' }),
+    createHueBackedRoleScale({ hueRoles: options.hueRoles, seedChroma, role: 'surfaceTint' }),
+    {
+      role: 'neutral',
+      scale: createZoraNeutralScale(options.seed),
+    },
+  ];
+
+  return { roles };
+}

package/src/internal/color/scales.ts

@@ -7,6 +7,14 @@ export interface CreateZoraColorScaleOptions {
   role?: 'primary' | 'neutral';
 }
 
+export type ZoraHueScaleRoleId = 'primary' | 'secondary' | 'accent' | 'highlight' | 'surfaceTint';
+
+export interface CreateZoraHueScaleOptions {
+  hue: number;
+  seedChroma: number;
+  role: ZoraHueScaleRoleId;
+}
+
 const PRIMARY_LIGHTNESS_BY_STEP: Record<ZoraColorScaleStep, number> = {
   50: 0.97,
   100: 0.93,
@@ -54,6 +62,14 @@ const MIN_PRIMARY_SCALE_CHROMA = 0.04;
 const NEUTRAL_CHROMA = 0.012;
 const DEFAULT_NEUTRAL_HUE_DEGREES = 260;
 
+const ROLE_CHROMA_FACTOR = {
+  primary: 1,
+  secondary: 0.72,
+  accent: 0.85,
+  highlight: 1,
+  surfaceTint: 0.18,
+} satisfies Record<ZoraHueScaleRoleId, number>;
+
 function clampNumber(value: number, min: number, max: number): number {
   return Math.max(min, Math.min(value, max));
 }
@@ -69,6 +85,14 @@ function resolvePrimaryScaleChroma(seedChroma: number, step: ZoraColorScaleStep)
   return shouldEnforceMin ? Math.max(bounded, MIN_PRIMARY_SCALE_CHROMA) : bounded;
 }
 
+function resolveHueScaleChroma(
+  options: CreateZoraHueScaleOptions,
+  step: ZoraColorScaleStep,
+): number {
+  const factor = ROLE_CHROMA_FACTOR[options.role];
+  return resolvePrimaryScaleChroma(options.seedChroma * factor, step);
+}
+
 function createScaleEntries(options: CreateZoraColorScaleOptions): ZoraColorScale {
   const seed = parseHexToOklch(options.seed);
 
@@ -143,3 +167,11 @@ export function createZoraPrimaryScale(seed: ZoraHexColor): ZoraColorScale {
 export function createZoraNeutralScale(seed: ZoraHexColor = '#94a3b8'): ZoraColorScale {
   return createZoraColorScale({ seed, role: 'neutral' });
 }
+
+export function createZoraHueScale(options: CreateZoraHueScaleOptions): ZoraColorScale {
+  return createScaleFromRamp({
+    hue: options.hue,
+    chromaByStep: (step) => resolveHueScaleChroma(options, step),
+    lightnessByStep: PRIMARY_LIGHTNESS_BY_STEP,
+  });
+}