@oxyhq/bloom 0.89.0 → 1.0.1

package/lib/typescript/commonjs/theme/color-engine/generate-role-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-role-colors.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/generate-role-colors.ts"],"names":[],"mappings":"AAOA,OAAO,EAAS,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE,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;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAuBpE"}

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

@@ -6,55 +6,18 @@
  * 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.
+ *
+ * This barrel is the engine's PUBLIC surface — `@oxyhq/bloom/theme` publishes it
+ * whole, as the `ColorEngine` namespace. Keep it to what a consumer deriving a
+ * theme actually calls; the ports underneath (`Hct`, `TonalPalette`,
+ * `DynamicScheme`, `ColorRole`, `Roles`, `buildScheme`, `quantizeWu`, `score`)
+ * are implementation and are imported from their own modules by the handful of
+ * files inside Bloom that need them — adding one back here publishes it.
  */
-export { Hct } from './hct';
-export { TonalPalette } from './tonal-palette';
-export { DynamicScheme } from './dynamic-scheme';
-export { buildScheme, schemeVibrant, schemeExpressive, schemeTonalSpot, schemeNeutral, schemeMonochrome } from './scheme-variants';
 export type { SchemeVariant, AccentSources } 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;
-    /**
-     * Optional explicit secondary-accent seed, `#rrggbb`. When set, the secondary
-     * palette is pinned to THIS colour's hue + chroma (M3 role tones still apply)
-     * instead of the variant's derived hue-rotation of the primary seed. Omit for
-     * the current derived behaviour.
-     */
-    secondarySeed?: string;
-    /**
-     * Optional explicit tertiary-accent seed, `#rrggbb`. Same semantics as
-     * {@link GenerateOptions.secondarySeed} for the tertiary palette.
-     */
-    tertiarySeed?: string;
-}
-/**
- * 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.
- *
- * `secondarySeed` / `tertiarySeed` optionally PIN those accent families to real
- * brand colours (e.g. a blue-primary brand with a yellow secondary); omitted, the
- * accents are derived as the variant's hue-rotations — byte-identical to before.
- */
-export declare function generateRoleColors(opts: GenerateOptions): RoleColors;
+export { argbFromRgb, redFromArgb, greenFromArgb, blueFromArgb, argbFromHex, hexFromArgb, } from './color-utils';
+export { generateRoleColors } from './generate-role-colors';
+export type { RoleColors, GenerateOptions } from './generate-role-colors';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnI,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,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;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAuBpE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"color-policy.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM9D,sFAAsF;AACtF,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAsHlD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAuOD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,aAAkB,GACzB,YAAY,CAqJd"}
+{"version":3,"file":"color-policy.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM9D,sFAAsF;AACtF,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA4JlD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAkND;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,aAAkB,GACzB,YAAY,CAmLd"}

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

@@ -1,89 +1,413 @@
 import type { SchemeVariant } from './color-engine';
-export type AppColorName = 'teal' | 'blue' | 'green' | 'yellow' | 'red' | 'purple' | 'pink' | 'sky' | 'orange' | 'mint' | 'oxy' | 'faircoin' | 'pumpkin' | 'gray' | 'brown' | 'peach' | 'rose' | 'mono';
-/**
- * A single colour preset: a brand SEED colour plus the tonal scheme variant to
- * derive its full role set with.
- *
- * 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.
- */
-/**
- * Why a preset is not offered to every user. Absent means it is.
- *
- * The two are NOT interchangeable and must not collapse back into one list: a
- * `handle` preset belongs to a specific account and cannot be bought, while a
- * `premium` one is exactly what is bought. Conflating them is how the picker
- * came to offer both of Oxy's reserved brand colours to everybody.
- */
+/** Why a preset is not offered to every user. Absent means it is free. */
 export type ColorPresetGate = 
 /** Reserved for the account whose brand it is — not purchasable. */
 'handle'
 /** Sold with a subscription. */
  | 'premium';
+/** Stable picker/playground categories, ordered from specific to general. */
+declare const COLOR_PRESET_FAMILY_SOURCES: readonly [{
+    readonly name: "brand";
+    readonly displayName: "Brand";
+    readonly description: "Reserved ecosystem identities.";
+}, {
+    readonly name: "botanical";
+    readonly displayName: "Botanical";
+    readonly description: "Greens, jade and living hues.";
+}, {
+    readonly name: "ocean";
+    readonly displayName: "Ocean";
+    readonly description: "Blue, cyan and aquatic identities.";
+}, {
+    readonly name: "sunset";
+    readonly displayName: "Sunset";
+    readonly description: "Red, orange and golden identities.";
+}, {
+    readonly name: "earth";
+    readonly displayName: "Earth";
+    readonly description: "Warm mineral and grounded identities.";
+}, {
+    readonly name: "jewel";
+    readonly displayName: "Jewel";
+    readonly description: "Purple, rose and saturated gem hues.";
+}, {
+    readonly name: "neutral";
+    readonly displayName: "Neutral";
+    readonly description: "Slate, graphite and monochrome.";
+}];
+export type ColorPresetFamily = (typeof COLOR_PRESET_FAMILY_SOURCES)[number]['name'];
+export interface ColorPresetFamilyDefinition {
+    name: ColorPresetFamily;
+    displayName: string;
+    description: string;
+}
+export declare const COLOR_PRESET_FAMILY_REGISTRY: readonly ColorPresetFamilyDefinition[];
+export declare const COLOR_PRESET_FAMILIES: readonly ColorPresetFamily[];
+export type ColorPresetPairing = 'derived' | 'curated';
+/**
+ * The ONE authored preset source.
+ *
+ * Everything public below — the name union, ordered registry, lookup record,
+ * hex lookup, gate lists, family groups and playground list — is derived from
+ * this tuple. A preset is a seed recipe, never a frozen light/dark token table;
+ * Bloom's colour policy resolves both modes at runtime.
+ */
+declare const COLOR_PRESET_SOURCES: readonly [{
+    readonly name: "teal";
+    readonly displayName: "Teal";
+    readonly family: "ocean";
+    readonly description: "Deep teal identity with dynamically derived split-complementary accents.";
+    readonly hex: "#005c67";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "blue";
+    readonly displayName: "Blue";
+    readonly family: "ocean";
+    readonly description: "Clear social blue with vivid generated supporting colours.";
+    readonly hex: "#1d9bf0";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "green";
+    readonly displayName: "Green";
+    readonly family: "botanical";
+    readonly description: "Fresh green identity with dynamically generated contrast accents.";
+    readonly hex: "#10b981";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "yellow";
+    readonly displayName: "Yellow";
+    readonly family: "sunset";
+    readonly description: "A signal-yellow identity deliberately brought deep enough for a white label.";
+    readonly hex: "#ffd400";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+    readonly label: "white";
+}, {
+    readonly name: "red";
+    readonly displayName: "Red";
+    readonly family: "sunset";
+    readonly description: "Direct red identity with contrasting generated accent arms.";
+    readonly hex: "#ef4444";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "purple";
+    readonly displayName: "Purple";
+    readonly family: "jewel";
+    readonly description: "Bright purple identity with dynamically derived action colours.";
+    readonly hex: "#b866ff";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "pink";
+    readonly displayName: "Pink";
+    readonly family: "jewel";
+    readonly description: "Hot pink identity with a vivid generated complement.";
+    readonly hex: "#f91880";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "sky";
+    readonly displayName: "Sky";
+    readonly family: "ocean";
+    readonly description: "Open sky blue with dynamically generated supporting accents.";
+    readonly hex: "#03a9f4";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "orange";
+    readonly displayName: "Orange";
+    readonly family: "sunset";
+    readonly description: "A gamut-aware orange that stays orange at white-label fill tones.";
+    readonly hex: "#ff7a00";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "mint";
+    readonly displayName: "Mint";
+    readonly family: "botanical";
+    readonly description: "Cool mint identity with vivid generated supporting hues.";
+    readonly hex: "#14b8a6";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "oxy";
+    readonly displayName: "Oxy";
+    readonly family: "brand";
+    readonly description: "Oxy purple, reserved for the Oxy account identity.";
+    readonly hex: "#c46ede";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+    readonly gate: "handle";
+}, {
+    readonly name: "faircoin";
+    readonly displayName: "FairCoin";
+    readonly family: "brand";
+    readonly description: "FairCoin lime, reserved for the FairCoin account identity.";
+    readonly hex: "#9ffb50";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+    readonly gate: "handle";
+}, {
+    readonly name: "pumpkin";
+    readonly displayName: "Pumpkin";
+    readonly family: "sunset";
+    readonly description: "Golden pumpkin orange with a generated split complement.";
+    readonly hex: "#ff9800";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "gray";
+    readonly displayName: "Slate";
+    readonly family: "neutral";
+    readonly description: "Cool slate identity with restrained chroma and generated accents.";
+    readonly hex: "#607d8b";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "brown";
+    readonly displayName: "Brown";
+    readonly family: "earth";
+    readonly description: "Deep earthen brown with a contrasting generated action colour.";
+    readonly hex: "#813519";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "peach";
+    readonly displayName: "Peach";
+    readonly family: "earth";
+    readonly description: "Warm peach identity with dynamically derived contrast accents.";
+    readonly hex: "#ffb28d";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "rose";
+    readonly displayName: "Rose";
+    readonly family: "jewel";
+    readonly description: "Light rose identity with generated vivid supporting hues.";
+    readonly hex: "#fcaffe";
+    readonly variant: "vivid";
+    readonly pairing: "derived";
+}, {
+    readonly name: "mono";
+    readonly displayName: "Monochrome";
+    readonly family: "neutral";
+    readonly description: "Colourless identity and surfaces, derived as a true greyscale theme.";
+    readonly hex: "#000000";
+    readonly variant: "monochrome";
+    readonly pairing: "derived";
+    readonly gate: "premium";
+}, {
+    readonly name: "grove";
+    readonly displayName: "Grove + Marigold";
+    readonly family: "botanical";
+    readonly description: "Green identity with warm marigold reserved for the action that must win.";
+    readonly hex: "#087a3e";
+    readonly tertiaryHex: "#ffb000";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "ember";
+    readonly displayName: "Terracotta + Saffron";
+    readonly family: "earth";
+    readonly description: "Terracotta identity with a high-energy saffron action.";
+    readonly hex: "#b52f0c";
+    readonly tertiaryHex: "#ffb000";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "merlot";
+    readonly displayName: "Oxblood + Coral";
+    readonly family: "jewel";
+    readonly description: "Deep wine identity with coral action, expressive without reading destructive.";
+    readonly hex: "#a5003c";
+    readonly tertiaryHex: "#ff542e";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "cobalt";
+    readonly displayName: "Cobalt + Signal Yellow";
+    readonly family: "ocean";
+    readonly description: "Cobalt structure cut by a saturated signal-yellow action.";
+    readonly hex: "#154fd7";
+    readonly tertiaryHex: "#ffd000";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "jade";
+    readonly displayName: "Jade + Tangerine";
+    readonly family: "botanical";
+    readonly description: "Clean jade identity with a direct tangerine action.";
+    readonly hex: "#007a4b";
+    readonly tertiaryHex: "#ff5e00";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "pine";
+    readonly displayName: "Pine + Rose";
+    readonly family: "botanical";
+    readonly description: "Sober pine identity with a vivid rose action.";
+    readonly hex: "#135c2d";
+    readonly tertiaryHex: "#f0005a";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "olive";
+    readonly displayName: "Olive + Lilac";
+    readonly family: "earth";
+    readonly description: "Editorial olive identity with an unexpected clear lilac action.";
+    readonly hex: "#5f6400";
+    readonly tertiaryHex: "#7c25e8";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "lagoon";
+    readonly displayName: "Teal + Coral";
+    readonly family: "ocean";
+    readonly description: "Aquatic teal identity with a warm coral action.";
+    readonly hex: "#00706d";
+    readonly tertiaryHex: "#ff4935";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "navy";
+    readonly displayName: "Navy + Apricot";
+    readonly family: "ocean";
+    readonly description: "Serious navy identity softened by a human apricot action.";
+    readonly hex: "#0b2c72";
+    readonly tertiaryHex: "#ff6b20";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "azure";
+    readonly displayName: "Sky + Vermilion";
+    readonly family: "ocean";
+    readonly description: "Airy sky identity with a decisive vermilion action.";
+    readonly hex: "#006a94";
+    readonly tertiaryHex: "#e82e12";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "violet";
+    readonly displayName: "Violet + Lime";
+    readonly family: "jewel";
+    readonly description: "Deep violet identity with an electric lime action.";
+    readonly hex: "#7227c4";
+    readonly tertiaryHex: "#78c900";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "lavender";
+    readonly displayName: "Lavender + Brass";
+    readonly family: "jewel";
+    readonly description: "Calm lavender identity with a warmer, more editorial brass action.";
+    readonly hex: "#5c3db5";
+    readonly tertiaryHex: "#d98900";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "plum";
+    readonly displayName: "Plum + Aqua";
+    readonly family: "jewel";
+    readonly description: "Nocturnal plum identity with a bright aqua action.";
+    readonly hex: "#8d075f";
+    readonly tertiaryHex: "#00aeb8";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "cherry";
+    readonly displayName: "Cherry + Powder Blue";
+    readonly family: "jewel";
+    readonly description: "Cherry identity with a cool powder-blue counterpoint.";
+    readonly hex: "#b00038";
+    readonly tertiaryHex: "#2979e8";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "chocolate";
+    readonly displayName: "Chocolate + Cyan";
+    readonly family: "earth";
+    readonly description: "Material chocolate identity with a crisp technological cyan action.";
+    readonly hex: "#7a2a00";
+    readonly tertiaryHex: "#00aabe";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}, {
+    readonly name: "graphite";
+    readonly displayName: "Graphite + Acid";
+    readonly family: "neutral";
+    readonly description: "Near-neutral identity that gives the stage to an acid-green action.";
+    readonly hex: "#272b28";
+    readonly tertiaryHex: "#78c900";
+    readonly variant: "vivid";
+    readonly pairing: "curated";
+    readonly featured: true;
+}];
+/** Preset identifiers are inferred from the authored registry, never repeated. */
+export type AppColorName = (typeof COLOR_PRESET_SOURCES)[number]['name'];
+/**
+ * Backwards-compatible named-preset contract. Rich picker metadata lives on
+ * {@link ColorPresetRecipe} so existing consumers constructing this type do not
+ * acquire new required fields in a patch release.
+ */
 export interface AppColorPreset {
     name: AppColorName;
-    /** The brand seed colour, `#rrggbb`. Also the value the colour picker matches. */
     hex: string;
-    /** The tonal scheme variant the engine derives roles with. */
     variant: SchemeVariant;
-    /**
-     * Optional explicit secondary-accent seed, `#rrggbb`. When set, the secondary
-     * palette is PINNED to this brand colour (hue + chroma preserved; M3 role tones
-     * still apply) instead of the derived hue-rotation of {@link AppColorPreset.hex}.
-     * Bloom's built-in presets do NOT set this, so their generated output is
-     * unchanged; a consumer brand with a distinct accent (blue primary + yellow
-     * secondary) sets it to pin its real accent family.
-     */
     secondaryHex?: string;
-    /**
-     * Optional explicit tertiary-accent seed, `#rrggbb`. Same semantics as
-     * {@link AppColorPreset.secondaryHex} for the tertiary palette.
-     */
     tertiaryHex?: string;
-    /**
-     * Force the fill to a tone a WHITE label fits, in BOTH modes — overriding the
-     * budget that otherwise lets an already-light seed keep its own tone in dark
-     * and take a black label.
-     *
-     * It has to be declared, because it cannot be derived: `yellow` (seed tone 86)
-     * wants to come down to a deep gold with white on it, and `faircoin` (tone 90)
-     * wants to stay a bright lime with black on it. Two seeds four tones apart,
-     * opposite answers — nothing in the hex distinguishes them, only what the brand
-     * is for.
-     */
     label?: 'white';
-    /**
-     * Who may pick this preset. Absent = everyone. Bloom only DECLARES the gate;
-     * whether a given viewer satisfies it is the consuming app's question, since
-     * only the app knows who is signed in and what they pay for.
-     */
     gate?: ColorPresetGate;
 }
-/**
- * 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>;
+/** Enriched registry entry for a picker or colour playground. */
+export interface ColorPresetRecipe extends AppColorPreset {
+    displayName: string;
+    family: ColorPresetFamily;
+    description: string;
+    pairing: ColorPresetPairing;
+    featured: boolean;
+}
+/** Stable ordered entries for pickers, filters and the Storybook playground. */
+export declare const COLOR_PRESET_REGISTRY: readonly ColorPresetRecipe[];
 export declare const APP_COLOR_NAMES: readonly AppColorName[];
+export declare const APP_COLOR_PRESETS: Record<AppColorName, AppColorPreset>;
 export declare const HEX_TO_APP_COLOR: Record<string, AppColorName>;
 export declare function hexToAppColorName(hex: string): AppColorName;
+/** The sixteen approved paired directions in the permanent Mention playground. */
+export declare const COLOR_PLAYGROUND_NAMES: readonly AppColorName[];
+export interface ColorPresetGroup extends ColorPresetFamilyDefinition {
+    presets: readonly ColorPresetRecipe[];
+}
+/** Ordered family metadata and entries for consumer pickers. */
+export declare const COLOR_PRESET_GROUPS: Readonly<Record<ColorPresetFamily, ColorPresetGroup>>;
 /**
- * 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.
+ * Historically each preset carried a full light/dark map of raw HSL triples.
+ * The engine now derives every role from the registry's seeds.
  */
-export declare const APP_COLOR_PRESETS: Record<AppColorName, AppColorPreset>;
+export type PresetTokens = Record<string, string>;
 /** Available to every user, signed in or not. */
 export declare const FREE_COLOR_NAMES: readonly AppColorName[];
 /** Reserved for the account whose brand it is (`oxy`, `faircoin`) — not for sale. */
 export declare const HANDLE_COLOR_NAMES: readonly AppColorName[];
 /** Sold with a subscription. */
 export declare const PREMIUM_COLOR_NAMES: readonly AppColorName[];
+export {};
 //# 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,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,KAAK,GACL,UAAU,GACV,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,CAAC;AAEX;;;;;;;;;;GAUG;AACH;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe;AACzB,oEAAoE;AAClE,QAAQ;AACV,gCAAgC;GAC9B,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,OAAO,EAAE,aAAa,CAAC;IACvB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAAkK,CAAC;AAEtN,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAmBzD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CA+BlE,CAAC;AAgBF,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,EAAE,SAAS,YAAY,EAA4B,CAAC;AAEjF,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAA2B,CAAC;AAElF,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAA4B,CAAC"}
+{"version":3,"file":"color-presets.d.ts","sourceRoot":"","sources":["../../../../src/theme/color-presets.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/theme/color-scope/ColorScope.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+import type { AppColorName } from '../color-presets';
+export interface BloomColorScopeProps {
+    /**
+     * Preset to apply within this subtree. When `undefined`, the scope is a
+     * no-op and children inherit the parent scope's preset unchanged.
+     */
+    colorPreset: AppColorName | undefined;
+    /**
+     * When `true`, do not render a wrapping `<View>`. The single child is cloned
+     * with the scope's CSS vars merged into its `style` prop (Radix-style).
+     */
+    asChild?: boolean;
+    /** Additional style applied to the wrapping `<View>` (or merged into the cloned child with `asChild`). */
+    style?: StyleProp<ViewStyle>;
+    children: React.ReactNode;
+}
+export declare function BloomColorScope({ colorPreset, asChild, style, children, }: BloomColorScopeProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Escape hatch for advanced cases where the wrapping element is owned by the
+ * caller. Returns a stable native style object carrying the preset's CSS vars
+ * via NativeWind's `vars()`. Returns `undefined` on web or when `nativewind`
+ * is not installed.
+ *
+ * NOTE: subject to the react-native-css@3 limitation — the returned style only
+ * propagates vars to descendants when applied to an interop className component
+ * (the runtime gates propagation on matched className style rules). It is a
+ * no-op on a plain `<View>` with no `className`. For the common case prefer
+ * `<BloomColorScope>`, which wraps children in `VariableContextProvider`.
+ */
+export declare function useColorScopeStyle(colorPreset: AppColorName): StyleProp<ViewStyle>;
+//# sourceMappingURL=ColorScope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScope.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/ColorScope.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAC3F,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAMD,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,oBAAoB,2CA4DtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC,SAAS,CAAC,CAYlF"}

package/lib/typescript/commonjs/theme/color-scope/ColorScope.web.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { AppColorName } from '../color-presets';
+export interface BloomColorScopeProps {
+    /**
+     * Preset to apply within this subtree. When `undefined`, the scope is a
+     * no-op and children inherit the parent scope's preset unchanged.
+     */
+    colorPreset: AppColorName | undefined;
+    /**
+     * When `true`, do not render a wrapping `<div>`. The single child is cloned
+     * with the scope's CSS vars merged into its `style` prop (Radix-style).
+     */
+    asChild?: boolean;
+    /** Additional style applied to the wrapping `<div>` (or merged into the cloned child with `asChild`). */
+    style?: React.CSSProperties;
+    children: React.ReactNode;
+}
+export declare function BloomColorScope({ colorPreset, asChild, style, children, }: BloomColorScopeProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Escape hatch for advanced cases where the wrapping element is owned by the
+ * caller. Returns a stable React style object carrying the preset's CSS vars.
+ */
+export declare function useColorScopeStyle(colorPreset: AppColorName): React.CSSProperties;
+//# sourceMappingURL=ColorScope.web.d.ts.map

package/lib/typescript/commonjs/theme/color-scope/ColorScope.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScope.web.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/ColorScope.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAI3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBrD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yGAAyG;IACzG,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAuBD,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,oBAAoB,2CAoDtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,GAAG,KAAK,CAAC,aAAa,CAYjF"}