@flyingrobots/bijou 7.1.0 → 8.0.0-rc.1

package/dist/core/theme/builder.part02.js

@@ -0,0 +1,100 @@
+import { hexToRgb, rgbToHex } from './color.js';
+import { assertNonEmpty, freezeColorValue, from } from './builder.part01.js';
+function normalizeColorInput(value) {
+    if (typeof value === 'string') {
+        const rgb = hexToRgb(value);
+        return freezeColorValue({ hex: rgbToHex(rgb), rgb });
+    }
+    if (Array.isArray(value)) {
+        return from(value);
+    }
+    return from([value.r, value.g, value.b]);
+}
+class MutableThemeModeBuilder {
+    modeId;
+    tokens = new Map();
+    constructor(modeId) {
+        this.modeId = modeId;
+    }
+    token(id) {
+        if (id === undefined) {
+            return new DraftTokenBuilder(this);
+        }
+        assertNonEmpty(id, 'Token id');
+        return new ShortTokenBuilder(this, id);
+    }
+    registerToken(id, value) {
+        assertNonEmpty(id, 'Token id');
+        if (this.tokens.has(id)) {
+            throw new Error(`Duplicate token "${id}" in mode "${this.modeId}".`);
+        }
+        this.tokens.set(id, normalizeColorInput(value));
+        return this;
+    }
+    hasToken(id) {
+        return this.tokens.has(id);
+    }
+    tokenIds() {
+        return [...this.tokens.keys()];
+    }
+    build() {
+        const tokens = {};
+        for (const [id, value] of this.tokens) {
+            tokens[id] = freezeColorValue(value);
+        }
+        return Object.freeze({
+            id: this.modeId,
+            tokens: Object.freeze(tokens),
+        });
+    }
+}
+class ShortTokenBuilder {
+    mode;
+    tokenId;
+    constructor(mode, tokenId) {
+        this.mode = mode;
+        this.tokenId = tokenId;
+    }
+    color(value) {
+        return this.mode.registerToken(this.tokenId, value);
+    }
+}
+class DraftTokenBuilder {
+    mode;
+    constructor(mode) {
+        this.mode = mode;
+    }
+    id(id) {
+        assertNonEmpty(id, 'Token id');
+        return new DraftTokenColorBuilder(this.mode, id);
+    }
+}
+class DraftTokenColorBuilder {
+    mode;
+    tokenId;
+    constructor(mode, tokenId) {
+        this.mode = mode;
+        this.tokenId = tokenId;
+    }
+    color(value) {
+        return new DraftTokenRegistrationBuilder(this.mode, this.tokenId, value);
+    }
+}
+class DraftTokenRegistrationBuilder {
+    mode;
+    tokenId;
+    value;
+    constructor(mode, tokenId, value) {
+        this.mode = mode;
+        this.tokenId = tokenId;
+        this.value = value;
+    }
+    register() {
+        return this.mode.registerToken(this.tokenId, this.value);
+    }
+}
+function sortedTokenIds(modes) {
+    return [...new Set([...modes.values()].flatMap(mode => mode.tokenIds()))].sort();
+}
+export { MutableThemeModeBuilder, normalizeColorInput, sortedTokenIds };
+//# sourceMappingURL=builder.part02.js.map

package/dist/core/theme/builder.part02.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.part02.js","sourceRoot":"","sources":["../../../src/core/theme/builder.part02.ts"],"names":[],"mappings":"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"}

package/dist/core/theme/builder.part03.d.ts

@@ -0,0 +1,5 @@
+import type { ThemeBuilder, ThemeTokenRef } from './builder.part01.js';
+export declare function defineTheme(): ThemeBuilder;
+export declare function tokenRef(id: string): ThemeTokenRef;
+export declare function isTokenRef(value: unknown): value is ThemeTokenRef;
+//# sourceMappingURL=builder.part03.d.ts.map

package/dist/core/theme/builder.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.part03.d.ts","sourceRoot":"","sources":["../../../src/core/theme/builder.part03.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAwC,aAAa,EAA8B,MAAM,qBAAqB,CAAC;AAoEzI,wBAAgB,WAAW,IAAI,YAAY,CAE1C;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAMlD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAIjE"}

package/dist/core/theme/builder.part03.js

@@ -0,0 +1,74 @@
+import { REQUIRED_MODES, assertNonEmpty } from './builder.part01.js';
+import { MutableThemeModeBuilder, sortedTokenIds } from './builder.part02.js';
+class MutableThemeBuilder {
+    themeId;
+    themeLabel;
+    modes = new Map();
+    id(id) {
+        assertNonEmpty(id, 'Theme id');
+        this.themeId = id;
+        return this;
+    }
+    label(label) {
+        assertNonEmpty(label, 'Theme label');
+        this.themeLabel = label;
+        return this;
+    }
+    mode(id, configure) {
+        assertNonEmpty(id, 'Theme mode id');
+        if (this.modes.has(id)) {
+            throw new Error(`Duplicate theme mode "${id}".`);
+        }
+        const mode = new MutableThemeModeBuilder(id);
+        configure(mode);
+        this.modes.set(id, mode);
+        return this;
+    }
+    build() {
+        if (this.themeId === undefined) {
+            throw new Error('Theme id is required.');
+        }
+        for (const requiredMode of REQUIRED_MODES) {
+            if (!this.modes.has(requiredMode)) {
+                throw new Error(`Missing required theme mode "${requiredMode}".`);
+            }
+        }
+        const tokenIds = sortedTokenIds(this.modes);
+        for (const [modeId, mode] of this.modes) {
+            for (const tokenId of tokenIds) {
+                if (!mode.hasToken(tokenId)) {
+                    throw new Error(`Mode "${modeId}" is missing token "${tokenId}".`);
+                }
+            }
+        }
+        const modes = {};
+        for (const [modeId, mode] of this.modes) {
+            modes[modeId] = mode.build();
+        }
+        const built = {
+            kind: 'bijou.token-theme',
+            id: this.themeId,
+            ...(this.themeLabel === undefined ? {} : { label: this.themeLabel }),
+            requiredModes: REQUIRED_MODES,
+            modes: Object.freeze(modes),
+            tokenIds: Object.freeze(tokenIds),
+        };
+        return Object.freeze(built);
+    }
+}
+export function defineTheme() {
+    return new MutableThemeBuilder();
+}
+export function tokenRef(id) {
+    assertNonEmpty(id, 'Token id');
+    return Object.freeze({
+        kind: 'bijou.theme-token-ref',
+        id,
+    });
+}
+export function isTokenRef(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        && 'kind' in value && value.kind === 'bijou.theme-token-ref'
+        && 'id' in value && typeof value.id === 'string';
+}
+//# sourceMappingURL=builder.part03.js.map

package/dist/core/theme/builder.part03.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.part03.js","sourceRoot":"","sources":["../../../src/core/theme/builder.part03.ts"],"names":[],"mappings":"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"}

package/dist/core/theme/builder.part04.d.ts

@@ -0,0 +1,3 @@
+import type { ResolveThemeColorRefOptions, ThemeColorRef, ThemeColorResolution } from './builder.part01.js';
+export declare function resolveThemeColorRef(ref: ThemeColorRef, options: ResolveThemeColorRefOptions): ThemeColorResolution;
+//# sourceMappingURL=builder.part04.d.ts.map

package/dist/core/theme/builder.part04.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.part04.d.ts","sourceRoot":"","sources":["../../../src/core/theme/builder.part04.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAI5G,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,2BAA2B,GACnC,oBAAoB,CAgDtB"}

package/dist/core/theme/builder.part04.js

@@ -0,0 +1,49 @@
+import { dup } from './builder.part01.js';
+import { normalizeColorInput } from './builder.part02.js';
+import { isTokenRef } from './builder.part03.js';
+export function resolveThemeColorRef(ref, options) {
+    const mode = options.theme.modes[options.mode];
+    if (mode === undefined) {
+        throw new Error(`Unknown theme mode "${options.mode}" for theme "${options.theme.id}".`);
+    }
+    if (!isTokenRef(ref)) {
+        const color = normalizeColorInput(ref);
+        return Object.freeze({
+            source: 'raw-color',
+            themeId: options.theme.id,
+            mode: options.mode,
+            hex: color.hex,
+            rgb: dup(color.rgb),
+            fallback: false,
+        });
+    }
+    const token = mode.tokens[ref.id];
+    if (token !== undefined) {
+        return Object.freeze({
+            source: 'theme',
+            themeId: options.theme.id,
+            mode: options.mode,
+            tokenId: ref.id,
+            hex: token.hex,
+            rgb: dup(token.rgb),
+            fallback: false,
+        });
+    }
+    if (options.unresolved === 'fallback') {
+        if (options.fallback === undefined) {
+            throw new Error(`Fallback color is required for unresolved token "${ref.id}".`);
+        }
+        const fallback = normalizeColorInput(options.fallback);
+        return Object.freeze({
+            source: 'fallback',
+            themeId: options.theme.id,
+            mode: options.mode,
+            tokenId: ref.id,
+            hex: fallback.hex,
+            rgb: dup(fallback.rgb),
+            fallback: true,
+        });
+    }
+    throw new Error(`Unresolved theme token "${ref.id}" for mode "${options.mode}" in theme "${options.theme.id}".`);
+}
+//# sourceMappingURL=builder.part04.js.map

package/dist/core/theme/builder.part04.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.part04.js","sourceRoot":"","sources":["../../../src/core/theme/builder.part04.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,UAAU,oBAAoB,CAClC,GAAkB,EAClB,OAAoC;IAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,CAAC,IAAI,gBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,WAAoB;YAC5B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;YACnB,QAAQ,EAAE,KAAc;SACzB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,OAAgB;YACxB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,GAAG,CAAC,EAAE;YACf,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;YACnB,QAAQ,EAAE,KAAc;SACzB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,oDAAoD,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,UAAmB;YAC3B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,GAAG,CAAC,EAAE;YACf,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YACtB,QAAQ,EAAE,IAAa;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,EAAE,eAAe,OAAO,CAAC,IAAI,eAAe,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;AACnH,CAAC"}

package/dist/core/theme/color.d.ts

@@ -1,96 +1,4 @@
-/**
- * Color manipulation utilities for theme tokens.
- *
- * Provides conversion between hex and RGB, plus manipulation functions
- * (lighten, darken, mix, complementary, saturate, desaturate) that
- * preserve token modifiers.
- */
-import type { RGB, TokenValue } from './tokens.js';
-/** A pre-resolved color value that carries both hex and RGB forms. */
-export interface ResolvedColor {
-    readonly kind: 'resolved-color';
-    readonly hex: string;
-    readonly rgb: RGB;
-}
-/** Public color input accepted by hot rendering paths. */
-export type ColorRef = string | ResolvedColor;
-/**
- * Preserve a literal hex string as a lazy color reference.
- *
- * User code can keep calling styling APIs with `#rrggbb`; hot paths can
- * later upgrade that reference via {@link resolveColor}.
- */
-export declare function color(hex: string): ColorRef;
-/** Narrow an unknown value to a pre-resolved color reference. */
-export declare function isResolvedColor(value: unknown): value is ResolvedColor;
-/** Resolve a color reference into its eager `{ hex, rgb }` form. */
-export declare function resolveColor(ref: ColorRef): ResolvedColor;
-/** Resolve a color reference when valid, otherwise return `undefined`. */
-export declare function tryResolveColor(ref: ColorRef | undefined): ResolvedColor | undefined;
-/** Return the canonical hex form for a color reference when available. */
-export declare function colorHex(ref: ColorRef | undefined): string | undefined;
-/** Return parsed RGB bytes for a color reference when available. */
-export declare function colorRgb(ref: ColorRef | undefined): RGB | undefined;
-/**
- * Parse a hex color string to an RGB tuple. Supports `#RGB` and `#RRGGBB` (with or without `#`).
- * @param hex - Hex color string to parse.
- * @returns Parsed RGB tuple.
- * @throws {Error} If the hex string is not a valid 3- or 6-digit hex color.
- */
-export declare function hexToRgb(hex: string): RGB;
-/**
- * Parse a hex color string to an RGB tuple, returning `undefined` for invalid input.
- *
- * Use this when theme/runtime code wants to preserve invalid authored input
- * without throwing, but still cache parsed bytes for valid colors.
- */
-export declare function tryHexToRgb(hex: string): RGB | undefined;
-/**
- * Convert an RGB tuple to a `#rrggbb` hex string.
- * @param rgb - RGB tuple to convert. Values are clamped to [0, 255].
- * @returns Lowercase hex string with leading `#`.
- */
-export declare function rgbToHex(rgb: RGB): string;
-/**
- * Blend a token's color toward white by `amount` (0 = unchanged, 1 = white).
- * @param token - Source token to lighten.
- * @param amount - Blend factor, clamped to [0, 1].
- * @returns New TokenValue with the lightened hex, preserving modifiers.
- */
-export declare function lighten(token: TokenValue, amount: number): TokenValue;
-/**
- * Blend a token's color toward black by `amount` (0 = unchanged, 1 = black).
- * @param token - Source token to darken.
- * @param amount - Blend factor, clamped to [0, 1].
- * @returns New TokenValue with the darkened hex, preserving modifiers.
- */
-export declare function darken(token: TokenValue, amount: number): TokenValue;
-/**
- * Blend two token colors by `ratio` (0 = first, 1 = second, default 0.5). Preserves modifiers from the first token.
- * @param a - First token (its modifiers are preserved).
- * @param b - Second token.
- * @param ratio - Blend ratio, clamped to [0, 1]. Default is 0.5.
- * @returns New TokenValue with the blended hex.
- */
-export declare function mix(a: TokenValue, b: TokenValue, ratio?: number): TokenValue;
-/**
- * Rotate hue by 180 degrees to produce the complementary color.
- * @param token - Source token.
- * @returns New TokenValue with the complementary hex, preserving modifiers.
- */
-export declare function complementary(token: TokenValue): TokenValue;
-/**
- * Increase saturation by `amount` (0 = unchanged, 1 = full saturation).
- * @param token - Source token.
- * @param amount - Saturation increase factor, clamped to [0, 1].
- * @returns New TokenValue with the saturated hex, preserving modifiers.
- */
-export declare function saturate(token: TokenValue, amount: number): TokenValue;
-/**
- * Decrease saturation by `amount` (0 = unchanged, 1 = fully desaturated).
- * @param token - Source token.
- * @param amount - Desaturation factor, clamped to [0, 1].
- * @returns New TokenValue with the desaturated hex, preserving modifiers.
- */
-export declare function desaturate(token: TokenValue, amount: number): TokenValue;
+export { color, colorHex, colorRgb, hexToRgb, isResolvedColor, resolveColor, rgbToHex, tryHexToRgb, tryResolveColor } from './color.part01.js';
+export type { ColorRef, ResolvedColor } from './color.part01.js';
+export { complementary, darken, desaturate, lighten, mix, saturate } from './color.part02.js';
 //# sourceMappingURL=color.d.ts.map

package/dist/core/theme/color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/core/theme/color.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CACnB;AAED,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAE3C;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOtE;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,CAQzD;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAUpF;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,CAEnE;AAID;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAUzC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAKzC;AAoGD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAQrE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAQpE;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,SAAM,GAAG,UAAU,CASzE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAK3D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAMtE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAMxE"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/core/theme/color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/I,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/theme/color.js

@@ -1,280 +1,3 @@
-/**
- * Color manipulation utilities for theme tokens.
- *
- * Provides conversion between hex and RGB, plus manipulation functions
- * (lighten, darken, mix, complementary, saturate, desaturate) that
- * preserve token modifiers.
- */
-/**
- * Preserve a literal hex string as a lazy color reference.
- *
- * User code can keep calling styling APIs with `#rrggbb`; hot paths can
- * later upgrade that reference via {@link resolveColor}.
- */
-export function color(hex) {
-    return hex;
-}
-/** Narrow an unknown value to a pre-resolved color reference. */
-export function isResolvedColor(value) {
-    return typeof value === 'object'
-        && value !== null
-        && 'kind' in value
-        && value.kind === 'resolved-color'
-        && typeof value.hex === 'string'
-        && Array.isArray(value.rgb);
-}
-/** Resolve a color reference into its eager `{ hex, rgb }` form. */
-export function resolveColor(ref) {
-    if (isResolvedColor(ref))
-        return ref;
-    const rgb = hexToRgb(ref);
-    return {
-        kind: 'resolved-color',
-        hex: rgbToHex(rgb),
-        rgb,
-    };
-}
-/** Resolve a color reference when valid, otherwise return `undefined`. */
-export function tryResolveColor(ref) {
-    if (ref == null)
-        return undefined;
-    if (isResolvedColor(ref))
-        return ref;
-    const rgb = tryHexToRgb(ref);
-    if (rgb == null)
-        return undefined;
-    return {
-        kind: 'resolved-color',
-        hex: rgbToHex(rgb),
-        rgb,
-    };
-}
-/** Return the canonical hex form for a color reference when available. */
-export function colorHex(ref) {
-    if (ref == null)
-        return undefined;
-    return isResolvedColor(ref) ? ref.hex : ref;
-}
-/** Return parsed RGB bytes for a color reference when available. */
-export function colorRgb(ref) {
-    return tryResolveColor(ref)?.rgb;
-}
-// ── Conversion ─────────────────────────────────────────────────────
-/**
- * Parse a hex color string to an RGB tuple. Supports `#RGB` and `#RRGGBB` (with or without `#`).
- * @param hex - Hex color string to parse.
- * @returns Parsed RGB tuple.
- * @throws {Error} If the hex string is not a valid 3- or 6-digit hex color.
- */
-export function hexToRgb(hex) {
-    let h = hex.startsWith('#') ? hex.slice(1) : hex;
-    if (h.length === 3) {
-        h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
-    }
-    if (h.length !== 6 || !/^[0-9a-f]{6}$/i.test(h)) {
-        throw new Error(`Invalid hex color: "${hex}"`);
-    }
-    const n = parseInt(h, 16);
-    return [(n >> 16) & 0xff, (n >> 8) & 0xff, n & 0xff];
-}
-/**
- * Parse a hex color string to an RGB tuple, returning `undefined` for invalid input.
- *
- * Use this when theme/runtime code wants to preserve invalid authored input
- * without throwing, but still cache parsed bytes for valid colors.
- */
-export function tryHexToRgb(hex) {
-    try {
-        return hexToRgb(hex);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Convert an RGB tuple to a `#rrggbb` hex string.
- * @param rgb - RGB tuple to convert. Values are clamped to [0, 255].
- * @returns Lowercase hex string with leading `#`.
- */
-export function rgbToHex(rgb) {
-    const r = Math.max(0, Math.min(255, Math.round(rgb[0])));
-    const g = Math.max(0, Math.min(255, Math.round(rgb[1])));
-    const b = Math.max(0, Math.min(255, Math.round(rgb[2])));
-    return '#' + ((1 << 24) | (r << 16) | (g << 8) | b).toString(16).slice(1);
-}
-// ── Internal HSL helpers ───────────────────────────────────────────
-/**
- * Convert an RGB tuple to HSL (hue, saturation, lightness), all in [0, 1].
- * @param rgb - Input RGB color.
- * @returns HSL triple with each component normalized to [0, 1].
- */
-function rgbToHsl(rgb) {
-    const r = rgb[0] / 255;
-    const g = rgb[1] / 255;
-    const b = rgb[2] / 255;
-    const max = Math.max(r, g, b);
-    const min = Math.min(r, g, b);
-    const l = (max + min) / 2;
-    if (max === min)
-        return [0, 0, l];
-    const d = max - min;
-    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
-    let h;
-    if (max === r) {
-        h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
-    }
-    else if (max === g) {
-        h = ((b - r) / d + 2) / 6;
-    }
-    else {
-        h = ((r - g) / d + 4) / 6;
-    }
-    return [h, s, l];
-}
-/**
- * Convert a single HSL hue sector to an RGB channel value.
- * @param p - Lower bound from lightness calculation.
- * @param q - Upper bound from lightness calculation.
- * @param t - Hue offset for this channel.
- * @returns Channel value in [0, 1].
- */
-function hue2rgb(p, q, t) {
-    let tt = t;
-    if (tt < 0)
-        tt += 1;
-    if (tt > 1)
-        tt -= 1;
-    if (tt < 1 / 6)
-        return p + (q - p) * 6 * tt;
-    if (tt < 1 / 2)
-        return q;
-    if (tt < 2 / 3)
-        return p + (q - p) * (2 / 3 - tt) * 6;
-    return p;
-}
-/**
- * Convert HSL values to an RGB tuple.
- * @param h - Hue in [0, 1].
- * @param s - Saturation in [0, 1].
- * @param l - Lightness in [0, 1].
- * @returns RGB tuple with each channel in [0, 255].
- */
-function hslToRgb(h, s, l) {
-    if (s === 0) {
-        const v = Math.round(l * 255);
-        return [v, v, v];
-    }
-    const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
-    const p = 2 * l - q;
-    return [
-        Math.round(hue2rgb(p, q, h + 1 / 3) * 255),
-        Math.round(hue2rgb(p, q, h) * 255),
-        Math.round(hue2rgb(p, q, h - 1 / 3) * 255),
-    ];
-}
-// ── Token helpers ──────────────────────────────────────────────────
-/**
- * Clamp a numeric amount to the [0, 1] range.
- * @param amount - Value to clamp.
- * @returns Clamped value.
- */
-function clampAmount(amount) {
-    return Math.max(0, Math.min(1, amount));
-}
-/**
- * Create a new TokenValue with the given hex, preserving the original's modifiers.
- * @param token - Source token whose modifiers are carried over.
- * @param hex - New hex color string.
- * @returns New TokenValue with the updated hex.
- */
-function withHex(token, hex) {
-    return token.modifiers
-        ? { hex, modifiers: [...token.modifiers] }
-        : { hex };
-}
-// ── Manipulation ───────────────────────────────────────────────────
-/**
- * Blend a token's color toward white by `amount` (0 = unchanged, 1 = white).
- * @param token - Source token to lighten.
- * @param amount - Blend factor, clamped to [0, 1].
- * @returns New TokenValue with the lightened hex, preserving modifiers.
- */
-export function lighten(token, amount) {
-    const t = clampAmount(amount);
-    const [r, g, b] = hexToRgb(token.hex);
-    return withHex(token, rgbToHex([
-        r + (255 - r) * t,
-        g + (255 - g) * t,
-        b + (255 - b) * t,
-    ]));
-}
-/**
- * Blend a token's color toward black by `amount` (0 = unchanged, 1 = black).
- * @param token - Source token to darken.
- * @param amount - Blend factor, clamped to [0, 1].
- * @returns New TokenValue with the darkened hex, preserving modifiers.
- */
-export function darken(token, amount) {
-    const t = clampAmount(amount);
-    const [r, g, b] = hexToRgb(token.hex);
-    return withHex(token, rgbToHex([
-        r * (1 - t),
-        g * (1 - t),
-        b * (1 - t),
-    ]));
-}
-/**
- * Blend two token colors by `ratio` (0 = first, 1 = second, default 0.5). Preserves modifiers from the first token.
- * @param a - First token (its modifiers are preserved).
- * @param b - Second token.
- * @param ratio - Blend ratio, clamped to [0, 1]. Default is 0.5.
- * @returns New TokenValue with the blended hex.
- */
-export function mix(a, b, ratio = 0.5) {
-    const t = clampAmount(ratio);
-    const [ar, ag, ab] = hexToRgb(a.hex);
-    const [br, bg, bb] = hexToRgb(b.hex);
-    return withHex(a, rgbToHex([
-        ar + (br - ar) * t,
-        ag + (bg - ag) * t,
-        ab + (bb - ab) * t,
-    ]));
-}
-/**
- * Rotate hue by 180 degrees to produce the complementary color.
- * @param token - Source token.
- * @returns New TokenValue with the complementary hex, preserving modifiers.
- */
-export function complementary(token) {
-    const rgb = hexToRgb(token.hex);
-    const [h, s, l] = rgbToHsl(rgb);
-    const newH = (h + 0.5) % 1;
-    return withHex(token, rgbToHex(hslToRgb(newH, s, l)));
-}
-/**
- * Increase saturation by `amount` (0 = unchanged, 1 = full saturation).
- * @param token - Source token.
- * @param amount - Saturation increase factor, clamped to [0, 1].
- * @returns New TokenValue with the saturated hex, preserving modifiers.
- */
-export function saturate(token, amount) {
-    const t = clampAmount(amount);
-    const rgb = hexToRgb(token.hex);
-    const [h, s, l] = rgbToHsl(rgb);
-    const newS = Math.min(1, s + (1 - s) * t);
-    return withHex(token, rgbToHex(hslToRgb(h, newS, l)));
-}
-/**
- * Decrease saturation by `amount` (0 = unchanged, 1 = fully desaturated).
- * @param token - Source token.
- * @param amount - Desaturation factor, clamped to [0, 1].
- * @returns New TokenValue with the desaturated hex, preserving modifiers.
- */
-export function desaturate(token, amount) {
-    const t = clampAmount(amount);
-    const rgb = hexToRgb(token.hex);
-    const [h, s, l] = rgbToHsl(rgb);
-    const newS = s * (1 - t);
-    return withHex(token, rgbToHex(hslToRgb(h, newS, l)));
-}
+export { color, colorHex, colorRgb, hexToRgb, isResolvedColor, resolveColor, rgbToHex, tryHexToRgb, tryResolveColor } from './color.part01.js';
+export { complementary, darken, desaturate, lighten, mix, saturate } from './color.part02.js';
 //# sourceMappingURL=color.js.map