@oxyhq/bloom 0.36.0 → 0.37.0

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/theme/build-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-theme.d.ts","sourceRoot":"","sources":["../../../../src/theme/build-theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIvE,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAyFX;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,OAAO,GAAG,MAAM,EAC1B,UAAU,GAAE,OAAe,GAC1B,KAAK,CAWP"}
+{"version":3,"file":"build-theme.d.ts","sourceRoot":"","sources":["../../../../src/theme/build-theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKvE,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AA4EX;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,OAAO,GAAG,MAAM,EAC1B,UAAU,GAAE,OAAe,GAC1B,KAAK,CAWP"}

package/lib/typescript/module/theme/color-engine/cam16.d.ts

@@ -0,0 +1,26 @@
+import { ViewingConditions } from './viewing-conditions';
+export declare class Cam16 {
+    readonly hue: number;
+    readonly chroma: number;
+    readonly j: number;
+    readonly q: number;
+    readonly m: number;
+    readonly s: number;
+    readonly jstar: number;
+    readonly astar: number;
+    readonly bstar: number;
+    constructor(hue: number, chroma: number, j: number, q: number, m: number, s: number, jstar: number, astar: number, bstar: number);
+    /** CAM16-UCS perceptual distance to another colour. */
+    distance(other: Cam16): number;
+    static fromInt(argb: number): Cam16;
+    static fromIntInViewingConditions(argb: number, vc: ViewingConditions): Cam16;
+    static fromXyzInViewingConditions(x: number, y: number, z: number, vc: ViewingConditions): Cam16;
+    static fromJch(j: number, c: number, h: number): Cam16;
+    static fromJchInViewingConditions(j: number, c: number, h: number, vc: ViewingConditions): Cam16;
+    static fromUcs(jstar: number, astar: number, bstar: number): Cam16;
+    static fromUcsInViewingConditions(jstar: number, astar: number, bstar: number, vc: ViewingConditions): Cam16;
+    toInt(): number;
+    viewed(vc: ViewingConditions): number;
+    xyzInViewingConditions(vc: ViewingConditions): [number, number, number];
+}
+//# sourceMappingURL=cam16.d.ts.map

package/lib/typescript/module/theme/color-engine/cam16.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cam16.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/cam16.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,qBAAa,KAAK;IAEd,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM;gBARb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM;IAGxB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAQ9B,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAInC,MAAM,CAAC,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,GAAG,KAAK;IAa7E,MAAM,CAAC,0BAA0B,CAC/B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,iBAAiB,GACpB,KAAK;IAwCR,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK;IAItD,MAAM,CAAC,0BAA0B,CAC/B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,iBAAiB,GACpB,KAAK;IAaR,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK;IAIlE,MAAM,CAAC,0BAA0B,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,iBAAiB,GACpB,KAAK;IAYR,KAAK,IAAI,MAAM;IAIf,MAAM,CAAC,EAAE,EAAE,iBAAiB,GAAG,MAAM;IAKrC,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;CA8BxE"}

package/lib/typescript/module/theme/color-engine/color-role.d.ts

@@ -0,0 +1,36 @@
+import type { ContrastCurve } from './contrast-curve';
+import type { DynamicScheme } from './dynamic-scheme';
+import { Hct } from './hct';
+import type { TonalPalette } from './tonal-palette';
+import type { ToneDeltaPair } from './tone-delta-pair';
+export interface ColorRoleArgs {
+    name?: string;
+    palette: (scheme: DynamicScheme) => TonalPalette;
+    tone: (scheme: DynamicScheme) => number;
+    isBackground?: boolean;
+    background?: (scheme: DynamicScheme) => ColorRole | undefined;
+    secondBackground?: (scheme: DynamicScheme) => ColorRole | undefined;
+    contrastCurve?: ContrastCurve;
+    toneDeltaPair?: (scheme: DynamicScheme) => ToneDeltaPair;
+}
+export declare class ColorRole {
+    readonly name: string;
+    readonly palette: (scheme: DynamicScheme) => TonalPalette;
+    readonly tone: (scheme: DynamicScheme) => number;
+    readonly isBackground: boolean;
+    readonly background?: (scheme: DynamicScheme) => ColorRole | undefined;
+    readonly secondBackground?: (scheme: DynamicScheme) => ColorRole | undefined;
+    readonly contrastCurve?: ContrastCurve;
+    readonly toneDeltaPair?: (scheme: DynamicScheme) => ToneDeltaPair;
+    private readonly hctCache;
+    static fromPalette(args: ColorRoleArgs): ColorRole;
+    constructor(args: ColorRoleArgs);
+    getArgb(scheme: DynamicScheme): number;
+    getHct(scheme: DynamicScheme): Hct;
+    getTone(scheme: DynamicScheme): number;
+    static foregroundTone(bgTone: number, ratio: number): number;
+    static tonePrefersLightForeground(tone: number): boolean;
+    static toneAllowsLightForeground(tone: number): boolean;
+    static enableLightForeground(tone: number): number;
+}
+//# sourceMappingURL=color-role.d.ts.map

package/lib/typescript/module/theme/color-engine/color-role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-role.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/color-role.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,YAAY,CAAC;IACjD,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,CAAC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9D,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,SAAS,GAAG,SAAS,CAAC;IACpE,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAAC;CAC1D;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,YAAY,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,SAAS,GAAG,SAAS,CAAC;IACvE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,SAAS,GAAG,SAAS,CAAC;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAAC;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAE1D,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS;gBAItC,IAAI,EAAE,aAAa;IAoB/B,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAItC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,GAAG;IAUlC,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IA4GtC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAgB5D,MAAM,CAAC,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxD,MAAM,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIvD,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAMnD"}

package/lib/typescript/module/theme/color-engine/color-roles.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Bloom colour engine — the colour roles.
+ *
+ * Faithful port of Material Color Utilities' `MaterialDynamicColors` (Apache-2.0),
+ * renamed to Bloom's own `Roles`. Each role is a {@link ColorRole} recipe over
+ * the scheme's palettes: surfaces, on-surfaces, the accent trio + their
+ * containers, outlines and error. Resolving a role against a scheme yields the
+ * final colour. The 12 "*Fixed" roles the reference ships are omitted — Bloom's
+ * token contract doesn't use them.
+ */
+import { ColorRole } from './color-role';
+/** The full set of Bloom colour roles, keyed by name. Resolve via `.getArgb(scheme)`. */
+export declare const Roles: {
+    readonly primaryPaletteKeyColor: ColorRole;
+    readonly secondaryPaletteKeyColor: ColorRole;
+    readonly tertiaryPaletteKeyColor: ColorRole;
+    readonly neutralPaletteKeyColor: ColorRole;
+    readonly neutralVariantPaletteKeyColor: ColorRole;
+    readonly background: ColorRole;
+    readonly onBackground: ColorRole;
+    readonly surface: ColorRole;
+    readonly surfaceDim: ColorRole;
+    readonly surfaceBright: ColorRole;
+    readonly surfaceContainerLowest: ColorRole;
+    readonly surfaceContainerLow: ColorRole;
+    readonly surfaceContainer: ColorRole;
+    readonly surfaceContainerHigh: ColorRole;
+    readonly surfaceContainerHighest: ColorRole;
+    readonly onSurface: ColorRole;
+    readonly surfaceVariant: ColorRole;
+    readonly onSurfaceVariant: ColorRole;
+    readonly inverseSurface: ColorRole;
+    readonly inverseOnSurface: ColorRole;
+    readonly outline: ColorRole;
+    readonly outlineVariant: ColorRole;
+    readonly shadow: ColorRole;
+    readonly scrim: ColorRole;
+    readonly surfaceTint: ColorRole;
+    readonly primary: ColorRole;
+    readonly onPrimary: ColorRole;
+    readonly primaryContainer: ColorRole;
+    readonly onPrimaryContainer: ColorRole;
+    readonly inversePrimary: ColorRole;
+    readonly secondary: ColorRole;
+    readonly onSecondary: ColorRole;
+    readonly secondaryContainer: ColorRole;
+    readonly onSecondaryContainer: ColorRole;
+    readonly tertiary: ColorRole;
+    readonly onTertiary: ColorRole;
+    readonly tertiaryContainer: ColorRole;
+    readonly onTertiaryContainer: ColorRole;
+    readonly error: ColorRole;
+    readonly onError: ColorRole;
+    readonly errorContainer: ColorRole;
+    readonly onErrorContainer: ColorRole;
+};
+export type RoleName = keyof typeof Roles;
+//# sourceMappingURL=color-roles.d.ts.map

package/lib/typescript/module/theme/color-engine/color-roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-roles.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/color-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA0XzC,yFAAyF;AACzF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CR,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,KAAK,CAAC"}

package/lib/typescript/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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"}