@oxyhq/bloom 0.35.8 → 0.37.0

package/lib/typescript/commonjs/theme/color-engine/color-utils.d.ts

@@ -0,0 +1,32 @@
+/** Pack 0–255 R/G/B into an opaque ARGB int. */
+export declare function argbFromRgb(red: number, green: number, blue: number): number;
+/** Pack linear-RGB (0–100 per channel) into an opaque ARGB int. */
+export declare function argbFromLinrgb(linrgb: [number, number, number]): number;
+export declare function alphaFromArgb(argb: number): number;
+export declare function redFromArgb(argb: number): number;
+export declare function greenFromArgb(argb: number): number;
+export declare function blueFromArgb(argb: number): number;
+export declare function isOpaque(argb: number): boolean;
+/** XYZ → ARGB. */
+export declare function argbFromXyz(x: number, y: number, z: number): number;
+/** ARGB → XYZ. */
+export declare function xyzFromArgb(argb: number): [number, number, number];
+/** L*a*b* → ARGB. */
+export declare function argbFromLab(l: number, a: number, b: number): number;
+/** ARGB → L*a*b*. */
+export declare function labFromArgb(argb: number): [number, number, number];
+/** L* → ARGB (a grayscale color with that lightness). */
+export declare function argbFromLstar(lstar: number): number;
+/** ARGB → L*. */
+export declare function lstarFromArgb(argb: number): number;
+/** L* → Y (XYZ luminance). */
+export declare function yFromLstar(lstar: number): number;
+/** Y (XYZ luminance) → L*. */
+export declare function lstarFromY(y: number): number;
+/** sRGB component (0–255) → linear (0–100). */
+export declare function linearized(rgbComponent: number): number;
+/** Linear component (0–100) → sRGB (0–255). */
+export declare function delinearized(rgbComponent: number): number;
+/** The D65 white point. */
+export declare function whitePointD65(): [number, number, number];
+//# sourceMappingURL=color-utils.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/color-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/color-utils.ts"],"names":[],"mappings":"AA6BA,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAEvE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AACD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AACD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AACD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AACD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,kBAAkB;AAClB,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,kBAAkB;AAClB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAKlE;AAED,qBAAqB;AACrB,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,qBAAqB;AACrB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAalE;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,iBAAiB;AACjB,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED,2BAA2B;AAC3B,wBAAgB,aAAa,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAExD"}

package/lib/typescript/commonjs/theme/color-engine/contrast-curve.d.ts

@@ -0,0 +1,9 @@
+export declare class ContrastCurve {
+    readonly low: number;
+    readonly normal: number;
+    readonly medium: number;
+    readonly high: number;
+    constructor(low: number, normal: number, medium: number, high: number);
+    get(contrastLevel: number): number;
+}
+//# sourceMappingURL=contrast-curve.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/contrast-curve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast-curve.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/contrast-curve.ts"],"names":[],"mappings":"AASA,qBAAa,aAAa;IAEtB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAHZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;IAGvB,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAOnC"}

package/lib/typescript/commonjs/theme/color-engine/contrast.d.ts

@@ -0,0 +1,12 @@
+/** WCAG contrast ratio between two tones (L*). */
+export declare function ratioOfTones(toneA: number, toneB: number): number;
+export declare function ratioOfYs(y1: number, y2: number): number;
+/** Lightest tone that hits `ratio` against `tone`, or -1 if impossible. */
+export declare function lighter(tone: number, ratio: number): number;
+/** Darkest tone that hits `ratio` against `tone`, or -1 if impossible. */
+export declare function darker(tone: number, ratio: number): number;
+/** Like {@link lighter} but returns 100 instead of -1 when unattainable. */
+export declare function lighterUnsafe(tone: number, ratio: number): number;
+/** Like {@link darker} but returns 0 instead of -1 when unattainable. */
+export declare function darkerUnsafe(tone: number, ratio: number): number;
+//# sourceMappingURL=contrast.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/contrast.ts"],"names":[],"mappings":"AAWA,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS1D;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/lib/typescript/commonjs/theme/color-engine/dislike-analyzer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Bloom colour engine — dislike analyzer.
+ *
+ * Faithful port of Material Color Utilities' `DislikeAnalyzer` (Apache-2.0).
+ * Certain dark-yellow-green HCT colours read as "bile"; this nudges their tone
+ * up to 70 so generated palettes never land on a universally-disliked colour.
+ */
+import { Hct } from './hct';
+export declare function isDisliked(hct: Hct): boolean;
+export declare function fixIfDisliked(hct: Hct): Hct;
+//# sourceMappingURL=dislike-analyzer.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/dislike-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dislike-analyzer.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/dislike-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAK5C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAE3C"}

package/lib/typescript/commonjs/theme/color-engine/dynamic-scheme.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Bloom colour engine — dynamic scheme.
+ *
+ * Faithful port of Material Color Utilities' `DynamicScheme` core (Apache-2.0).
+ * Holds the five tonal palettes (primary/secondary/tertiary/neutral/
+ * neutralVariant) + error that a scheme variant derives from the seed, plus the
+ * dark/contrast state a `DynamicColor` role reads to resolve into an ARGB. The
+ * ~50 convenience role getters from the reference are omitted — Bloom reads
+ * roles directly through `materialRoles`.
+ */
+import type { ColorRole } from './color-role';
+import { Hct } from './hct';
+import { TonalPalette } from './tonal-palette';
+import { Variant } from './variant';
+export interface DynamicSchemeArgs {
+    sourceColorArgb: number;
+    variant: Variant;
+    contrastLevel: number;
+    isDark: boolean;
+    primaryPalette: TonalPalette;
+    secondaryPalette: TonalPalette;
+    tertiaryPalette: TonalPalette;
+    neutralPalette: TonalPalette;
+    neutralVariantPalette: TonalPalette;
+}
+export declare class DynamicScheme {
+    readonly sourceColorArgb: number;
+    readonly variant: Variant;
+    readonly contrastLevel: number;
+    readonly isDark: boolean;
+    readonly sourceColorHct: Hct;
+    readonly primaryPalette: TonalPalette;
+    readonly secondaryPalette: TonalPalette;
+    readonly tertiaryPalette: TonalPalette;
+    readonly neutralPalette: TonalPalette;
+    readonly neutralVariantPalette: TonalPalette;
+    readonly errorPalette: TonalPalette;
+    constructor(args: DynamicSchemeArgs);
+    /**
+     * Rotate the seed hue by a designer-specified amount that depends on which
+     * hue "breakpoint" band the seed falls in.
+     */
+    static getRotatedHue(sourceColor: Hct, hues: number[], rotations: number[]): number;
+    getArgb(role: ColorRole): number;
+    getHct(role: ColorRole): Hct;
+}
+//# sourceMappingURL=dynamic-scheme.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/dynamic-scheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-scheme.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/dynamic-scheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,YAAY,CAAC;IAC7B,gBAAgB,EAAE,YAAY,CAAC;IAC/B,eAAe,EAAE,YAAY,CAAC;IAC9B,cAAc,EAAE,YAAY,CAAC;IAC7B,qBAAqB,EAAE,YAAY,CAAC;CACrC;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,YAAY,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;gBAExB,IAAI,EAAE,iBAAiB;IAcnC;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM;IAuBnF,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAIhC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,GAAG;CAG7B"}

package/lib/typescript/commonjs/theme/color-engine/hct-solver.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Find the sRGB ARGB with the given hue (deg), chroma, and L*. When the exact
+ * colour is out of gamut, hue + L* are preserved and chroma is maximised.
+ */
+export declare function solveToInt(hueDegrees: number, chroma: number, lstar: number): number;
+//# sourceMappingURL=hct-solver.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/hct-solver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hct-solver.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/hct-solver.ts"],"names":[],"mappings":"AAuPA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWpF"}

package/lib/typescript/commonjs/theme/color-engine/hct.d.ts

@@ -0,0 +1,20 @@
+export declare class Hct {
+    private argb;
+    private internalHue;
+    private internalChroma;
+    private internalTone;
+    private constructor();
+    /** Build an HCT colour from hue (deg), chroma, and tone (L*, 0–100). */
+    static from(hue: number, chroma: number, tone: number): Hct;
+    /** Wrap an existing ARGB colour as HCT. */
+    static fromInt(argb: number): Hct;
+    toInt(): number;
+    get hue(): number;
+    set hue(newHue: number);
+    get chroma(): number;
+    set chroma(newChroma: number);
+    get tone(): number;
+    set tone(newTone: number);
+    private setInternalState;
+}
+//# sourceMappingURL=hct.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/hct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hct.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/hct.ts"],"names":[],"mappings":"AAYA,qBAAa,GAAG;IACd,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO;IAQP,wEAAwE;IACxE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG;IAI3D,2CAA2C;IAC3C,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAIjC,KAAK,IAAI,MAAM;IAIf,IAAI,GAAG,IAAI,MAAM,CAEhB;IACD,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM,EAE3B;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAEvB;IAED,OAAO,CAAC,gBAAgB;CAOzB"}

package/lib/typescript/commonjs/theme/color-engine/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Bloom colour engine — public surface.
+ *
+ * A dependency-free tonal colour system (HCT + tonal palettes + dynamic roles)
+ * reimplemented in Bloom from the Material Color Utilities algorithm (Apache-2.0)
+ * and verified byte-for-byte against it. Give it ANY seed colour and it derives a
+ * full, self-consistent, WCAG-legible set of roles for light and dark at any
+ * contrast level — the same dynamic theming MaterialKolor does, but ours.
+ */
+export { Hct } from './hct';
+export { TonalPalette } from './tonal-palette';
+export { DynamicScheme } from './dynamic-scheme';
+export { buildScheme, schemeVibrant, schemeExpressive, schemeTonalSpot, schemeNeutral } from './scheme-variants';
+export type { SchemeVariant } from './scheme-variants';
+export { Roles } from './color-roles';
+export type { RoleName } from './color-roles';
+export { ColorRole } from './color-role';
+export { quantizeWu } from './quantizer-wu';
+export { score } from './score';
+export type { ScoreOptions } from './score';
+export { quantizeImage, seedsFromImagePixels, seedHexFromImagePixels } from './seed-from-image';
+export { argbFromRgb, redFromArgb, greenFromArgb, blueFromArgb } from './color-utils';
+import { type RoleName } from './color-roles';
+import { type SchemeVariant } from './scheme-variants';
+/** Parse a `#rrggbb` (or `#aarrggbb`) hex string into an ARGB int. */
+export declare function argbFromHex(hex: string): number;
+/** Format an ARGB int as `#rrggbb`. */
+export declare function hexFromArgb(argb: number): string;
+/** Every colour role as a modern `rgb(r g b)` string. */
+export type RoleColors = Record<RoleName, string>;
+export interface GenerateOptions {
+    /** The brand/seed colour, `#rrggbb`. */
+    seed: string;
+    variant?: SchemeVariant;
+    isDark?: boolean;
+    /** −1 (low) … 0 (normal) … 1 (high). */
+    contrastLevel?: number;
+}
+/**
+ * Generate the full role set from ANY seed colour — the dynamic-theming entry
+ * point. Presets are just fixed seeds; a user-picked colour works identically.
+ */
+export declare function generateRoleColors(opts: GenerateOptions): RoleColors;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjH,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGtF,OAAO,EAAS,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAapE"}

package/lib/typescript/commonjs/theme/color-engine/lab-point-provider.d.ts

@@ -0,0 +1,6 @@
+export type LabPoint = [number, number, number];
+export declare function labFromInt(argb: number): LabPoint;
+export declare function intFromLab(point: LabPoint): number;
+/** Squared Euclidean distance in L*a*b* (cheaper than the real distance). */
+export declare function labDistance(from: LabPoint, to: LabPoint): number;
+//# sourceMappingURL=lab-point-provider.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/lab-point-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lab-point-provider.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/lab-point-provider.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEjD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAElD;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,MAAM,CAKhE"}

package/lib/typescript/commonjs/theme/color-engine/math-utils.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Bloom colour engine — scalar/vector maths.
+ *
+ * Self-contained port of the Material Color Utilities maths helpers (the same
+ * primitives MaterialKolor uses), reimplemented in Bloom's own TypeScript so the
+ * theme has ZERO external colour dependencies. Algorithm © Google, Apache-2.0;
+ * this is a faithful derivative kept byte-compatible via golden tests.
+ */
+/** 1 if `n > 0`, -1 if `n < 0`, 0 if `n === 0`. */
+export declare function signum(n: number): number;
+/** Linear interpolation: `start` at `amount = 0`, `stop` at `amount = 1`. */
+export declare function lerp(start: number, stop: number, amount: number): number;
+/** Clamp `input` into `[min, max]`. */
+export declare function clampInt(min: number, max: number, input: number): number;
+/** Clamp `input` into `[min, max]` (floating point). */
+export declare function clampDouble(min: number, max: number, input: number): number;
+/** Wrap a degree measure into `[0, 360)` as an integer. */
+export declare function sanitizeDegreesInt(degrees: number): number;
+/** Wrap a degree measure into `[0, 360)` as a float. */
+export declare function sanitizeDegreesDouble(degrees: number): number;
+/**
+ * Sign of the shortest rotation from `from` to `to` on a circle.
+ * @returns 1 if increasing `from` is shortest, -1 if decreasing is.
+ */
+export declare function rotationDirection(from: number, to: number): number;
+/** Shortest angular distance (degrees) between two hues. */
+export declare function differenceDegrees(a: number, b: number): number;
+/** Multiply a 1×3 row vector by a 3×3 matrix. */
+export declare function matrixMultiply(row: [number, number, number], matrix: [
+    [
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number
+    ]
+]): [number, number, number];
+//# sourceMappingURL=math-utils.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/math-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-utils.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/math-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,6EAA6E;AAC7E,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wDAAwD;AACxD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7B,MAAM,EAAE;IACN;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxB;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxB;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;CACzB,GACA,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAK1B"}

package/lib/typescript/commonjs/theme/color-engine/quantizer-map.d.ts

@@ -0,0 +1,3 @@
+/** Count opaque pixels by exact ARGB. Fully-transparent pixels are dropped. */
+export declare function countByColor(pixels: number[]): Map<number, number>;
+//# sourceMappingURL=quantizer-map.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/quantizer-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantizer-map.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/quantizer-map.ts"],"names":[],"mappings":"AAQA,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOlE"}

package/lib/typescript/commonjs/theme/color-engine/quantizer-wu.d.ts

@@ -0,0 +1,3 @@
+/** Wu-quantize `pixels` into at most `maxColors` representative ARGB colours. */
+export declare function quantizeWu(pixels: number[], maxColors: number): number[];
+//# sourceMappingURL=quantizer-wu.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/quantizer-wu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantizer-wu.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/quantizer-wu.ts"],"names":[],"mappings":"AAqDA,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAyQxE"}

package/lib/typescript/commonjs/theme/color-engine/scheme-variants.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Bloom colour engine — scheme variants.
+ *
+ * How each variant derives its five tonal palettes from the seed HCT. Faithful
+ * port of Material Color Utilities' `Scheme*` families (Apache-2.0), expressed
+ * as plain builder functions (our style) rather than subclasses. Fidelity/
+ * Content are intentionally left out — they need the temperature-cache complement
+ * and aren't useful for Bloom's fixed brand seeds.
+ */
+import { DynamicScheme } from './dynamic-scheme';
+import type { Hct } from './hct';
+export type SchemeVariant = 'vibrant' | 'expressive' | 'tonalSpot' | 'neutral';
+/** Maxed-out colourfulness at each position of the primary palette. */
+export declare function schemeVibrant(source: Hct, isDark: boolean, contrastLevel: number): DynamicScheme;
+/** Playful, intentionally detached from the seed hue (primary rotated 240°). */
+export declare function schemeExpressive(source: Hct, isDark: boolean, contrastLevel: number): DynamicScheme;
+/** The Material You default — a calm, balanced treatment of the seed. */
+export declare function schemeTonalSpot(source: Hct, isDark: boolean, contrastLevel: number): DynamicScheme;
+/** Near-greyscale — the seed hue is present only as a whisper. */
+export declare function schemeNeutral(source: Hct, isDark: boolean, contrastLevel: number): DynamicScheme;
+/** Build a scheme by variant name. */
+export declare function buildScheme(variant: SchemeVariant, source: Hct, isDark: boolean, contrastLevel?: number): DynamicScheme;
+//# sourceMappingURL=scheme-variants.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/scheme-variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme-variants.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/scheme-variants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAKjC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAU/E,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,aAAa,CAkBhG;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,aAAa,CAkBnG;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,aAAa,CAYlG;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,aAAa,CAYhG;AASD,sCAAsC;AACtC,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,OAAO,EACf,aAAa,SAAI,GAChB,aAAa,CAEf"}

package/lib/typescript/commonjs/theme/color-engine/score.d.ts

@@ -0,0 +1,8 @@
+export interface ScoreOptions {
+    desired?: number;
+    fallbackColorARGB?: number;
+    filter?: boolean;
+}
+/** Rank quantized colours as theme seeds. Best first. */
+export declare function score(colorsToPopulation: Map<number, number>, options?: ScoreOptions): number[];
+//# sourceMappingURL=score.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/score.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,yDAAyD;AACzD,wBAAgB,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,EAAE,CAwDnG"}

package/lib/typescript/commonjs/theme/color-engine/seed-from-image.d.ts

@@ -0,0 +1,13 @@
+import { type ScoreOptions } from './score';
+/**
+ * Quantize `pixels` to a representative palette with its populations. Uses Wu
+ * (deterministic) for the palette, then assigns every pixel to its nearest
+ * representative in L*a*b* — no randomness, so the same image always yields the
+ * same result.
+ */
+export declare function quantizeImage(pixels: number[], maxColors?: number): Map<number, number>;
+/** Ranked seed candidates (best first) extracted from an image's pixels (ARGB). */
+export declare function seedsFromImagePixels(pixels: number[], options?: ScoreOptions): number[];
+/** The single best seed colour from an image, as `#rrggbb`. */
+export declare function seedHexFromImagePixels(pixels: number[]): string;
+//# sourceMappingURL=seed-from-image.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/seed-from-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-from-image.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/seed-from-image.ts"],"names":[],"mappings":"AAcA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,SAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BpF;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAEvF;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAI/D"}

package/lib/typescript/commonjs/theme/color-engine/tonal-palette.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Bloom colour engine — tonal palettes.
+ *
+ * Faithful port of Material Color Utilities' `TonalPalette` (Apache-2.0). A
+ * palette holds a fixed hue + chroma and yields a colour for any tone (0–100).
+ * Schemes build primary/secondary/tertiary/neutral palettes and read specific
+ * tones per role.
+ */
+import { Hct } from './hct';
+export declare class TonalPalette {
+    readonly hue: number;
+    readonly chroma: number;
+    readonly keyColor: Hct;
+    private readonly cache;
+    private constructor();
+    static fromInt(argb: number): TonalPalette;
+    static fromHct(hct: Hct): TonalPalette;
+    static fromHueAndChroma(hue: number, chroma: number): TonalPalette;
+    /** ARGB of this palette at the given tone. */
+    tone(tone: number): number;
+    /** HCT of this palette at the given tone. */
+    getHct(tone: number): Hct;
+}
+//# sourceMappingURL=tonal-palette.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/tonal-palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tonal-palette.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/tonal-palette.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,qBAAa,YAAY;IAIrB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,QAAQ,EAAE,GAAG;IALxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD,OAAO;IAMP,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAI1C,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,YAAY;IAItC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IAKlE,8CAA8C;IAC9C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS1B,6CAA6C;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;CAG1B"}

package/lib/typescript/commonjs/theme/color-engine/tone-delta-pair.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Bloom colour engine — tone-delta pair.
+ *
+ * Faithful port of Material Color Utilities' `ToneDeltaPair` (Apache-2.0).
+ * Constrains two related roles to keep a minimum tonal distance in a given
+ * direction (e.g. a fixed colour must stay lighter than its dim variant), so
+ * paired roles never collapse into each other.
+ */
+import type { ColorRole } from './color-role';
+export type TonePolarity = 'darker' | 'lighter' | 'nearer' | 'farther';
+export declare class ToneDeltaPair {
+    readonly roleA: ColorRole;
+    readonly roleB: ColorRole;
+    readonly delta: number;
+    readonly polarity: TonePolarity;
+    readonly stayTogether: boolean;
+    constructor(roleA: ColorRole, roleB: ColorRole, delta: number, polarity: TonePolarity, stayTogether: boolean);
+}
+//# sourceMappingURL=tone-delta-pair.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/tone-delta-pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tone-delta-pair.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/tone-delta-pair.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvE,qBAAa,aAAa;IAEtB,QAAQ,CAAC,KAAK,EAAE,SAAS;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,QAAQ,EAAE,YAAY;IAC/B,QAAQ,CAAC,YAAY,EAAE,OAAO;gBAJrB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,OAAO;CAEjC"}

package/lib/typescript/commonjs/theme/color-engine/variant.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Bloom colour engine — scheme variants.
+ *
+ * The families of dynamic-colour scheme supported by the engine. Bloom exposes
+ * the useful subset (Vibrant, Expressive, TonalSpot, Neutral, Fidelity); the
+ * numeric values match Material Color Utilities so ported scheme logic lines up.
+ */
+export declare enum Variant {
+    MONOCHROME = 0,
+    NEUTRAL = 1,
+    TONAL_SPOT = 2,
+    VIBRANT = 3,
+    EXPRESSIVE = 4,
+    FIDELITY = 5,
+    CONTENT = 6,
+    RAINBOW = 7,
+    FRUIT_SALAD = 8
+}
+//# sourceMappingURL=variant.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/variant.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,OAAO;IACjB,UAAU,IAAI;IACd,OAAO,IAAI;IACX,UAAU,IAAI;IACd,OAAO,IAAI;IACX,UAAU,IAAI;IACd,QAAQ,IAAI;IACZ,OAAO,IAAI;IACX,OAAO,IAAI;IACX,WAAW,IAAI;CAChB"}

package/lib/typescript/commonjs/theme/color-engine/viewing-conditions.d.ts

@@ -0,0 +1,18 @@
+export declare class ViewingConditions {
+    readonly n: number;
+    readonly aw: number;
+    readonly nbb: number;
+    readonly ncb: number;
+    readonly c: number;
+    readonly nc: number;
+    readonly rgbD: [number, number, number];
+    readonly fl: number;
+    readonly fLRoot: number;
+    readonly z: number;
+    private static _default;
+    /** sRGB-like viewing conditions (the only ones Bloom uses). */
+    static get DEFAULT(): ViewingConditions;
+    private constructor();
+    static make(whitePoint?: [number, number, number], adaptingLuminance?: number, backgroundLstar?: number, surround?: number, discountingIlluminant?: boolean): ViewingConditions;
+}
+//# sourceMappingURL=viewing-conditions.d.ts.map

package/lib/typescript/commonjs/theme/color-engine/viewing-conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewing-conditions.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/viewing-conditions.ts"],"names":[],"mappings":"AAWA,qBAAa,iBAAiB;IAQ1B,QAAQ,CAAC,CAAC,EAAE,MAAM;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM;IAhBpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,+DAA+D;IAC/D,MAAM,KAAK,OAAO,IAAI,iBAAiB,CAEtC;IAED,OAAO;IAaP,MAAM,CAAC,IAAI,CACT,UAAU,GAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAmB,EACtD,iBAAiB,GAAE,MAAuD,EAC1E,eAAe,SAAO,EACtB,QAAQ,SAAM,EACd,qBAAqB,UAAQ,GAC5B,iBAAiB;CAuCrB"}

package/lib/typescript/commonjs/theme/color-presets.d.ts

@@ -1,35 +1,40 @@
+import type { SchemeVariant } from './color-engine';
 export type AppColorName = 'teal' | 'blue' | 'green' | 'amber' | 'yellow' | 'red' | 'purple' | 'pink' | 'sky' | 'orange' | 'mint' | 'oxy' | 'faircoin';
 /**
- * Palette tokens for a single mode (light or dark) of a color preset.
+ * A single colour preset: a brand SEED colour plus the tonal scheme variant to
+ * derive its full role set with.
  *
- * Keys carry a leading `--` for historical reasons (shadcn-style CSS variable
- * names) — keep in mind the values are platform-agnostic **raw HSL triples**
- * (e.g. `'185 100% 20%'` or `'185 100% 20% / 0.5'`), not CSS-resolved colors.
- * The single canonical resolver `getResolvedTokens` (in `token-registry.ts`)
- * converts this raw map to sRGB `rgb(...)` for every runtime write — the same
- * values drive BOTH layers:
- *   - the web layer: `getResolvedTokens`'s `rgb(...)` strings are written to
- *     `document.documentElement` / a `BloomColorScope` element, so `var(--x)` —
- *     the form Tailwind v4 `@theme inline` compiles its color utilities to —
- *     resolves to a valid color directly, and
- *   - the native layer (`buildTheme` resolves the raw triples into `hsl(...)`
- *     strings consumable by React Native styles; `native-root-vars.native.ts`
- *     writes the same canonical `rgb(...)` values into react-native-css's
- *     `rootVariables` family).
- *
- * The `--` prefix is an implementation detail we will drop in a future major.
+ * Every preset's palette is now GENERATED by Bloom's dependency-free colour
+ * engine (`color-engine/`) from this seed — no hand-authored HSL triples. The
+ * engine's `generateRoleColors({ seed, variant, isDark })` yields the full
+ * Material-3 role set for light and dark; `getPresetVars` (in `preset-vars.ts`)
+ * maps those roles onto Bloom's canonical token names. A user-picked colour
+ * flows through the identical path — a preset is just a fixed seed.
  */
-export type PresetTokens = Record<string, string>;
 export interface AppColorPreset {
     name: AppColorName;
+    /** The brand seed colour, `#rrggbb`. Also the value the colour picker matches. */
     hex: string;
-    light: PresetTokens;
-    dark: PresetTokens;
+    /** The tonal scheme variant the engine derives roles with. */
+    variant: SchemeVariant;
 }
+/**
+ * Historically each preset carried a full light/dark map of raw HSL triples.
+ * That map is gone — the engine derives every role from {@link AppColorPreset.hex}.
+ * The type alias is retained for the public `PresetTokens` export shape (the
+ * resolved `--token -> value` record that `getPresetVars` produces).
+ */
+export type PresetTokens = Record<string, string>;
 export declare const APP_COLOR_NAMES: readonly AppColorName[];
 /** Premium-exclusive presets, hidden from the standard color picker. */
 export declare const PREMIUM_COLOR_NAMES: readonly AppColorName[];
 export declare const HEX_TO_APP_COLOR: Record<string, AppColorName>;
 export declare function hexToAppColorName(hex: string): AppColorName;
+/**
+ * The 13 named presets, each a brand seed + scheme variant. The engine derives
+ * the full role set (light + dark) from the seed. Seeds are the brand hex of
+ * each preset; `oxy` reads most faithfully as `vibrant`, everything else keeps a
+ * bold `vibrant` derivation to match the prior saturated palette.
+ */
 export declare const APP_COLOR_PRESETS: Record<AppColorName, AppColorPreset>;
 //# sourceMappingURL=color-presets.d.ts.map

package/lib/typescript/commonjs/theme/color-presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-presets.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-presets.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;AAEvJ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAAsH,CAAC;AAE1K,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAAwB,CAAC;AAEhF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAczD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CAkmBlE,CAAC"}
+{"version":3,"file":"color-presets.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,KAAK,GACL,UAAU,CAAC;AAEf;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAAsH,CAAC;AAE1K,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAAwB,CAAC;AAEhF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAczD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CAclE,CAAC"}

package/lib/typescript/commonjs/theme/preset-vars.d.ts

@@ -1,16 +1,20 @@
 import { type AppColorName, type PresetTokens } from './color-presets';
 /**
- * Bloom's base preset tokens extended with the surface/card/chart/sidebar
- * tokens that apps layer on top of the core shadcn palette. Synthesized from
- * the preset's primary hue so every preset stays in sync automatically.
+ * Map a preset (seed + variant) and mode onto Bloom's canonical CSS-var token
+ * set, sourcing EVERY colour from the colour engine's Material-3 role output.
+ *
+ * This replaces the old hand-authored HSL triples: the engine derives a full,
+ * self-consistent, WCAG-legible role set from the seed for light and dark, and
+ * this function assigns those roles to Bloom's token names. The token NAMES are
+ * unchanged (see `CANONICAL_TOKENS` in `token-registry.ts`) — only the SOURCE of
+ * each colour moved to the engine, so every downstream consumer keeps working.
+ *
+ * Values are full `rgb(r g b)` strings straight from the engine. `getResolvedTokens`
+ * passes non-HSL-triple values through untouched, so these flow through the whole
+ * pipeline (web document writes, native `rootVariables`, JS `ThemeColors`) unchanged.
  *
  * This is the single source of truth for extended theming vars — consumer apps
  * must not redefine these per-app.
- *
- * Values are platform-agnostic **raw HSL triples** (`'185 100% 20%'`, optionally
- * with a `/ A` alpha tail). The single canonical resolver `getResolvedTokens`
- * (in `token-registry.ts`) converts these to sRGB `rgb(...)` for BOTH web and
- * native runtime writes — this function only produces the raw triple map.
  */
 export declare function getPresetVars(colorName: AppColorName, mode: 'light' | 'dark'): PresetTokens;
 /**
@@ -19,10 +23,10 @@ export declare function getPresetVars(colorName: AppColorName, mode: 'light' | '
  * call this only when an app needs the extended (card/chart/sidebar) tokens on
  * the document root.
  *
- * Tokens are resolved to sRGB `rgb(...)` via the single canonical
- * `getResolvedTokens` pipeline, so `var(--x)` — the form Tailwind v4
- * `@theme inline` compiles its color utilities to — resolves directly to a
- * valid color on web.
+ * Tokens are resolved via the single canonical `getResolvedTokens` pipeline
+ * (already full `rgb(...)` colours from the engine), so `var(--x)` — the form
+ * Tailwind v4 `@theme inline` compiles its color utilities to — resolves
+ * directly to a valid color on web.
  */
 export declare function applyPresetVarsToDocument(colorName: AppColorName, mode: 'light' | 'dark'): void;
 //# sourceMappingURL=preset-vars.d.ts.map

package/lib/typescript/commonjs/theme/preset-vars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preset-vars.d.ts","sourceRoot":"","sources":["../../../../src/theme/preset-vars.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAe1F;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,YAAY,CAiCd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,IAAI,CAQN"}
+{"version":3,"file":"preset-vars.d.ts","sourceRoot":"","sources":["../../../../src/theme/preset-vars.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQ1F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,YAAY,CAoDd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,IAAI,CAQN"}

package/lib/typescript/module/frosted-icon-button/FrostedIconButton.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { FrostedIconButtonProps } from './types';
+export type { FrostedIconButtonProps, FrostedIconButtonSize } from './types';
+export declare const FrostedIconButton: React.NamedExoticComponent<FrostedIconButtonProps>;
+//# sourceMappingURL=FrostedIconButton.d.ts.map

package/lib/typescript/module/frosted-icon-button/FrostedIconButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrostedIconButton.d.ts","sourceRoot":"","sources":["../../../../src/frosted-icon-button/FrostedIconButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAkB7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAsI7E,eAAO,MAAM,iBAAiB,oDAAmC,CAAC"}