@oxyhq/bloom 0.38.0 → 0.40.0

package/lib/typescript/module/theme/color-scope/seed-scope.d.ts

@@ -0,0 +1,43 @@
+import { type RoleColors, type SchemeVariant } from '../color-engine';
+/**
+ * The canonical role → token assignment, sourced from an arbitrary seed's role
+ * set instead of a named preset.
+ *
+ * This MUST stay byte-for-byte identical to the mapping in `getPresetVars`
+ * (`preset-vars.ts`): a named preset is just a fixed seed, so scoping a subtree
+ * to a preset via `buildScopeVars` and scoping it to that preset's seed hex via
+ * `buildSeedScopeVars` are required to produce the same tokens. The parity test
+ * (`__tests__/seed-scope-parity.test.ts`) fails CI if the two ever drift.
+ *
+ * Values are full `rgb(r g b)` strings straight from the engine — no HSL-triple
+ * intermediate, so they flow through the scope pipeline unchanged (same as the
+ * preset path after `getResolvedTokens`).
+ */
+export declare function roleColorsToPresetTokens(r: RoleColors): Record<string, string>;
+/** Options for deriving scope vars directly from a seed colour. */
+export interface SeedScopeOptions {
+    /** The seed colour, `#rrggbb`. */
+    seed: string;
+    mode: 'light' | 'dark';
+    /**
+     * The tonal scheme variant. Defaults to `'vibrant'` — the same variant every
+     * named Bloom preset uses, so a preset's seed reproduces that preset exactly.
+     */
+    variant?: SchemeVariant;
+    /** −1 (low) … 0 (normal) … 1 (high). Defaults to 0. */
+    contrastLevel?: number;
+}
+/**
+ * Build the CSS custom-property map for an ARBITRARY seed colour — the dynamic
+ * (non-preset) counterpart of `buildScopeVars`. Feeds the seed through the
+ * colour engine's `generateRoleColors` and assigns the roles to Bloom's
+ * canonical token names, then adds the Tailwind v4 `--color-x` aliases (required
+ * on web so scoped utilities resolve against the subtree instead of the document
+ * root).
+ *
+ * Scope the returned record onto an element (web: inline `style`; native:
+ * NativeWind `VariableContextProvider`) to tint just that subtree — e.g. the
+ * ambient region behind album/artist artwork — without re-theming the whole app.
+ */
+export declare function buildSeedScopeVars(options: SeedScopeOptions): Record<string, string>;
+//# sourceMappingURL=seed-scope.d.ts.map

package/lib/typescript/module/theme/color-scope/seed-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-scope.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/seed-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG1F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0C9E;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBpF"}

package/lib/typescript/module/theme/index.d.ts

@@ -2,7 +2,14 @@ export { BloomThemeProvider } from './BloomThemeProvider';
 export type { BloomThemeProviderProps, BloomThemeContextValue, } from './BloomThemeProvider';
 export { BloomColorScope, useColorScopeStyle } from './color-scope';
 export type { BloomColorScopeProps } from './color-scope';
+export { BloomSeedScope } from './seed-scope';
+export type { BloomSeedScopeProps } from './seed-scope';
+export { buildSeedScopeVars, roleColorsToPresetTokens } from './color-scope/seed-scope';
+export type { SeedScopeOptions } from './color-scope/seed-scope';
+export { generateRoleColors, seedHexFromImagePixels, seedsFromImagePixels, quantizeImage, argbFromHex, hexFromArgb, argbFromRgb, redFromArgb, greenFromArgb, blueFromArgb, } from './color-engine';
+export type { RoleColors, GenerateOptions, RoleName, SchemeVariant } from './color-engine';
 export { buildTheme, STATUS_COLORS } from './build-theme';
+export { buildThemeFromSeed, buildColorsFromSeed } from './build-theme-from-seed';
 export { THEME_GRADIENTS } from './gradients';
 export { useTheme, useThemeColor, useBloomTheme } from './use-theme';
 export { useNavigationTheme } from './use-navigation-theme';

package/lib/typescript/module/theme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5F,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5F,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"preset-vars.d.ts","sourceRoot":"","sources":["../../../../src/theme/preset-vars.ts"],"names":[],"mappings":"AAAA,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,CAYN"}
+{"version":3,"file":"preset-vars.d.ts","sourceRoot":"","sources":["../../../../src/theme/preset-vars.ts"],"names":[],"mappings":"AAAA,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,CAwDd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,IAAI,CAYN"}

package/lib/typescript/module/theme/seed-scope/index.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+import type { SchemeVariant } from '../color-engine';
+export interface BloomSeedScopeProps {
+    /**
+     * The seed colour (`#rrggbb`) to derive this subtree's palette from. When
+     * `undefined`, the scope is a no-op and children inherit the parent scope
+     * unchanged — pass `undefined` to fall back to the app preset (e.g. on
+     * mouse-leave/blur when restoring the default theme).
+     */
+    seed: string | undefined;
+    /** Tonal scheme variant. Defaults to `'vibrant'` (matches Bloom presets). */
+    variant?: SchemeVariant;
+    /** −1 (low) … 0 (normal) … 1 (high). Defaults to 0. */
+    contrastLevel?: number;
+    /**
+     * When `true`, do not render a wrapping `<View>`. The single child is cloned
+     * with the caller's `style` 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;
+}
+/**
+ * Native `<BloomSeedScope>`: scopes a subtree to an ARBITRARY seed colour's
+ * palette (the dynamic counterpart of `<BloomColorScope>`, which takes a named
+ * preset). Feeds the seed through the colour engine and (1) provides the
+ * resulting canonical CSS vars to descendants via react-native-css's
+ * `VariableContext` — so `bg-background` / `bg-card` / `var(--primary)` resolve
+ * against the seed inside this subtree — and (2) publishes a matching JS `theme`
+ * on `BloomThemeContext`, so `useTheme()`/`useBloomTheme()` consumers inside the
+ * subtree also re-theme. The `colorPreset` field is left as the parent's (a seed
+ * is not a named preset).
+ */
+export declare function BloomSeedScope({ seed, variant, contrastLevel, asChild, style, children, }: BloomSeedScopeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/theme/seed-scope/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/theme/seed-scope/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAC3F,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAMpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;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;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,OAAO,EACP,aAAa,EACb,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,mBAAmB,2CA8CrB"}

package/lib/typescript/module/theme/seed-scope/index.web.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import type { SchemeVariant } from '../color-engine';
+export interface BloomSeedScopeProps {
+    /**
+     * The seed colour (`#rrggbb`) to derive this subtree's palette from. When
+     * `undefined`, the scope is a no-op and children inherit the parent scope
+     * unchanged — pass `undefined` to fall back to the app preset (e.g. on
+     * mouse-leave/blur when restoring the default theme).
+     */
+    seed: string | undefined;
+    /** Tonal scheme variant. Defaults to `'vibrant'` (matches Bloom presets). */
+    variant?: SchemeVariant;
+    /** −1 (low) … 0 (normal) … 1 (high). Defaults to 0. */
+    contrastLevel?: number;
+    /**
+     * 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;
+}
+/**
+ * Web `<BloomSeedScope>`: scopes a subtree to an ARBITRARY seed colour's palette
+ * (the dynamic counterpart of `<BloomColorScope>`). It (1) writes every canonical
+ * `--x` token plus the Tailwind v4 `--color-x` aliases (already resolved to
+ * `rgb(...)`) onto the wrapping element's inline `style`, so NativeWind classes
+ * inside resolve against the seed palette instead of the document root, and
+ * (2) publishes a matching JS `theme` on `BloomThemeContext` so
+ * `useTheme()`/`useBloomTheme()` consumers inside the subtree re-theme too. The
+ * `colorPreset` field is left as the parent's (a seed is not a named preset).
+ */
+export declare function BloomSeedScope({ seed, variant, contrastLevel, asChild, style, children, }: BloomSeedScopeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/module/theme/seed-scope/index.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../../src/theme/seed-scope/index.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAK3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;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;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,OAAO,EACP,aAAa,EACb,OAAe,EACf,KAAK,EACL,QAAQ,GACT,EAAE,mBAAmB,2CA6CrB"}

package/lib/typescript/module/theme/token-registry.d.ts

@@ -12,7 +12,7 @@ import { APP_COLOR_NAMES, type AppColorName } from './color-presets';
  * Order mirrors `getPresetVars`'s insertion order: base tokens first (in the
  * order they appear in the preset data), then the synthesized extended tokens.
  */
-export declare const CANONICAL_TOKENS: readonly ["background", "foreground", "surface", "surface-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "border", "input", "ring", "sidebar", "card", "card-foreground", "chart-1", "chart-2", "chart-3", "chart-4", "chart-5", "content-area", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring"];
+export declare const CANONICAL_TOKENS: readonly ["background", "foreground", "surface", "surface-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "tertiary", "tertiary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "border", "input", "ring", "sidebar", "card", "card-foreground", "chart-1", "chart-2", "chart-3", "chart-4", "chart-5", "content-area", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring"];
 /** A canonical token name (no leading `--`). */
 export type CanonicalToken = (typeof CANONICAL_TOKENS)[number];
 /**

package/lib/typescript/module/theme/token-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-registry.d.ts","sourceRoot":"","sources":["../../../../src/theme/token-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,0hBAmCnB,CAAC;AAEX,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAW/D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA+ChD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"token-registry.d.ts","sourceRoot":"","sources":["../../../../src/theme/token-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,6jBAqCnB,CAAC;AAEX,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAW/D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA+ChD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/lib/typescript/module/theme/types.d.ts

@@ -14,8 +14,12 @@ export interface ThemeColors {
     primaryLight: string;
     /** Legacy alias: the page background (`--background`), NOT the focus ring. */
     primaryDark: string;
-    /** Legacy alias: mirrors `primary` (`--primary`) for backwards compatibility. */
+    /** The M3 secondary accent — a real contrast colour (no longer a mirror of primary). */
     secondary: string;
+    secondaryForeground: string;
+    /** The M3 tertiary accent, completing the primary/secondary/tertiary trio. */
+    tertiary: string;
+    tertiaryForeground: string;
     tint: string;
     icon: string;
     iconActive: string;

package/lib/typescript/module/theme/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/theme/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAE3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IAErB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IAEpB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjC;AAED,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE3D,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,yFAAyF;IACzF,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/theme/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAE3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IAErB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IAEpB,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAE3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjC;AAED,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE3D,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,yFAAyF;IACzF,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/bloom",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "description": "Bloom UI — Oxy ecosystem component library for React Native + Expo + Web",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/src/design-tokens/theme-css.ts

@@ -73,6 +73,9 @@ export function bloomThemeCss(): string {
   // `destructive` carries no themed foreground token; its text is always the
   // fixed light-on-error colour.
   lines.push('  --color-destructive-foreground: #ffffff;');
+  // `divider` is a semantic alias of the border token (M3 outlineVariant) so
+  // `bg-divider` / `border-divider` read intentionally in list/section UIs.
+  lines.push('  --color-divider: var(--border);');
 
   // Spacing.
   for (const [key, value] of Object.entries(SPACING)) {

package/src/design-tokens/theme.css

@@ -36,6 +36,8 @@
   --color-primary-foreground: var(--primary-foreground);
   --color-secondary: var(--secondary);
   --color-secondary-foreground: var(--secondary-foreground);
+  --color-tertiary: var(--tertiary);
+  --color-tertiary-foreground: var(--tertiary-foreground);
   --color-muted: var(--muted);
   --color-muted-foreground: var(--muted-foreground);
   --color-accent: var(--accent);
@@ -61,6 +63,7 @@
   --color-sidebar-border: var(--sidebar-border);
   --color-sidebar-ring: var(--sidebar-ring);
   --color-destructive-foreground: #ffffff;
+  --color-divider: var(--border);
   --spacing-space-2: 2px;
   --spacing-space-4: 4px;
   --spacing-space-8: 8px;

package/src/prompt-input/Attachments.tsx

@@ -101,7 +101,7 @@ function ImageAttachmentItem({
         height: 120,
         borderRadius: 16,
         overflow: 'hidden',
-        backgroundColor: theme.colors.backgroundSecondary,
+        backgroundColor: theme.colors.card,
         borderWidth: 1,
         borderColor: theme.colors.border,
       }}
@@ -168,7 +168,7 @@ function DocumentAttachmentItem({
         borderWidth: 1,
         borderColor: theme.colors.border,
         overflow: 'hidden',
-        backgroundColor: theme.colors.backgroundSecondary,
+        backgroundColor: theme.colors.card,
       }}
     >
       <View

package/src/theme/__tests__/__snapshots__/visual-gallery.test.tsx.snap

@@ -26,8 +26,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(101 62 0)",
     "primarySubtleForeground": "rgb(255 221 184)",
     "secondary": "rgb(227 194 140)",
+    "secondaryForeground": "rgb(65 45 5)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(225 196 119)",
+    "tertiaryForeground": "rgb(61 46 0)",
     "text": "rgb(244 223 203)",
     "textSecondary": "rgb(217 195 171)",
     "textTertiary": "rgb(161 141 120)",
@@ -58,8 +61,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(255 221 184)",
     "primarySubtleForeground": "rgb(101 62 0)",
     "secondary": "rgb(115 90 46)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(114 92 26)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(36 26 14)",
     "textSecondary": "rgb(84 68 50)",
     "textTertiary": "rgb(135 116 96)",
@@ -90,8 +96,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(0 74 120)",
     "primarySubtleForeground": "rgb(207 229 255)",
     "secondary": "rgb(185 198 234)",
+    "secondaryForeground": "rgb(35 48 77)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(193 194 249)",
+    "tertiaryForeground": "rgb(42 43 89)",
     "text": "rgb(220 227 238)",
     "textSecondary": "rgb(190 199 212)",
     "textTertiary": "rgb(136 146 158)",
@@ -122,8 +131,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(207 229 255)",
     "primarySubtleForeground": "rgb(0 74 120)",
     "secondary": "rgb(81 94 125)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(89 90 139)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(21 28 36)",
     "textSecondary": "rgb(62 72 82)",
     "textTertiary": "rgb(111 120 132)",
@@ -154,8 +166,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(40 80 0)",
     "primarySubtleForeground": "rgb(138 254 0)",
     "secondary": "rgb(174 207 172)",
+    "secondaryForeground": "rgb(26 54 30)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(151 212 179)",
+    "tertiaryForeground": "rgb(0 56 36)",
     "text": "rgb(223 229 211)",
     "textSecondary": "rgb(193 202 180)",
     "textTertiary": "rgb(139 148 128)",
@@ -186,8 +201,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(138 254 0)",
     "primarySubtleForeground": "rgb(40 80 0)",
     "secondary": "rgb(72 101 73)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(47 105 78)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(24 29 18)",
     "textSecondary": "rgb(65 73 57)",
     "textTertiary": "rgb(114 122 103)",
@@ -218,8 +236,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(0 82 54)",
     "primarySubtleForeground": "rgb(71 255 184)",
     "secondary": "rgb(162 208 195)",
+    "secondaryForeground": "rgb(5 55 46)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(140 211 208)",
+    "tertiaryForeground": "rgb(0 55 54)",
     "text": "rgb(217 230 220)",
     "textSecondary": "rgb(186 203 191)",
     "textTertiary": "rgb(132 149 138)",
@@ -250,8 +271,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(71 255 184)",
     "primarySubtleForeground": "rgb(0 82 54)",
     "secondary": "rgb(59 102 92)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(26 105 103)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(19 30 24)",
     "textSecondary": "rgb(59 74 65)",
     "textTertiary": "rgb(107 123 113)",
@@ -282,8 +306,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(0 80 72)",
     "primarySubtleForeground": "rgb(0 254 229)",
     "secondary": "rgb(160 207 210)",
+    "secondaryForeground": "rgb(0 55 58)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(145 208 228)",
+    "tertiaryForeground": "rgb(0 54 65)",
     "text": "rgb(215 230 225)",
     "textSecondary": "rgb(184 202 198)",
     "textTertiary": "rgb(130 148 144)",
@@ -314,8 +341,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(0 254 229)",
     "primarySubtleForeground": "rgb(0 80 72)",
     "secondary": "rgb(56 101 105)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(33 102 120)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(17 30 28)",
     "textSecondary": "rgb(57 74 71)",
     "textTertiary": "rgb(105 123 119)",
@@ -346,8 +376,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(120 50 0)",
     "primarySubtleForeground": "rgb(255 219 202)",
     "secondary": "rgb(238 189 147)",
+    "secondaryForeground": "rgb(71 41 11)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(238 191 121)",
+    "tertiaryForeground": "rgb(68 43 0)",
     "text": "rgb(248 221 209)",
     "textSecondary": "rgb(223 192 178)",
     "textTertiary": "rgb(166 139 126)",
@@ -378,8 +411,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(255 219 202)",
     "primarySubtleForeground": "rgb(120 50 0)",
     "secondary": "rgb(124 86 52)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(123 88 28)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(38 24 17)",
     "textSecondary": "rgb(87 66 56)",
     "textTertiary": "rgb(139 114 102)",
@@ -410,8 +446,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(119 0 154)",
     "primarySubtleForeground": "rgb(251 215 255)",
     "secondary": "rgb(227 186 218)",
+    "secondaryForeground": "rgb(67 39 63)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(246 179 213)",
+    "tertiaryForeground": "rgb(78 32 60)",
     "text": "rgb(237 222 235)",
     "textSecondary": "rgb(210 193 210)",
     "textTertiary": "rgb(155 140 155)",
@@ -442,8 +481,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(251 215 255)",
     "primarySubtleForeground": "rgb(119 0 154)",
     "secondary": "rgb(117 84 111)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(131 78 107)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(33 25 34)",
     "textSecondary": "rgb(79 67 80)",
     "textTertiary": "rgb(129 115 129)",
@@ -474,8 +516,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(140 0 83)",
     "primarySubtleForeground": "rgb(255 217 228)",
     "secondary": "rgb(242 183 192)",
+    "secondaryForeground": "rgb(75 37 44)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(255 179 175)",
+    "tertiaryForeground": "rgb(83 32 31)",
     "text": "rgb(245 220 227)",
     "textSecondary": "rgb(219 191 200)",
     "textTertiary": "rgb(163 138 146)",
@@ -506,8 +551,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(255 217 228)",
     "primarySubtleForeground": "rgb(140 0 83)",
     "secondary": "rgb(128 81 89)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(139 77 74)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(37 24 29)",
     "textSecondary": "rgb(85 65 72)",
     "textTertiary": "rgb(136 113 120)",
@@ -538,8 +586,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(86 0 202)",
     "primarySubtleForeground": "rgb(233 221 255)",
     "secondary": "rgb(215 189 228)",
+    "secondaryForeground": "rgb(59 41 71)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(233 183 230)",
+    "tertiaryForeground": "rgb(71 35 73)",
     "text": "rgb(231 224 238)",
     "textSecondary": "rgb(203 195 213)",
     "textTertiary": "rgb(148 142 159)",
@@ -570,8 +621,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(233 221 255)",
     "primarySubtleForeground": "rgb(86 0 202)",
     "secondary": "rgb(107 87 120)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(121 80 121)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(29 26 36)",
     "textSecondary": "rgb(73 68 83)",
     "textTertiary": "rgb(122 116 132)",
@@ -602,8 +656,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(147 0 19)",
     "primarySubtleForeground": "rgb(255 218 215)",
     "secondary": "rgb(245 185 162)",
+    "secondaryForeground": "rgb(75 39 23)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(251 184 132)",
+    "tertiaryForeground": "rgb(77 38 0)",
     "text": "rgb(249 220 217)",
     "textSecondary": "rgb(223 191 188)",
     "textTertiary": "rgb(167 138 136)",
@@ -634,8 +691,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(255 218 215)",
     "primarySubtleForeground": "rgb(147 0 19)",
     "secondary": "rgb(129 83 65)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(133 83 39)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(39 24 23)",
     "textSecondary": "rgb(88 65 63)",
     "textTertiary": "rgb(140 113 110)",
@@ -666,8 +726,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(0 76 110)",
     "primarySubtleForeground": "rgb(201 230 255)",
     "secondary": "rgb(180 200 233)",
+    "secondaryForeground": "rgb(29 49 76)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(185 196 250)",
+    "tertiaryForeground": "rgb(34 46 90)",
     "text": "rgb(219 227 237)",
     "textSecondary": "rgb(188 200 211)",
     "textTertiary": "rgb(134 146 157)",
@@ -698,8 +761,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(201 230 255)",
     "primarySubtleForeground": "rgb(0 76 110)",
     "secondary": "rgb(76 95 124)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(81 92 139)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(20 29 35)",
     "textSecondary": "rgb(61 72 81)",
     "textTertiary": "rgb(109 120 131)",
@@ -730,8 +796,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(0 79 88)",
     "primarySubtleForeground": "rgb(154 240 255)",
     "secondary": "rgb(166 204 224)",
+    "secondaryForeground": "rgb(9 53 68)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(160 203 243)",
+    "tertiaryForeground": "rgb(0 51 81)",
     "text": "rgb(215 229 232)",
     "textSecondary": "rgb(184 202 205)",
     "textTertiary": "rgb(131 148 151)",
@@ -762,8 +831,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(154 240 255)",
     "primarySubtleForeground": "rgb(0 79 88)",
     "secondary": "rgb(62 99 116)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(54 98 133)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(17 29 32)",
     "textSecondary": "rgb(57 73 77)",
     "textTertiary": "rgb(105 122 125)",
@@ -794,8 +866,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(90 67 0)",
     "primarySubtleForeground": "rgb(255 223 154)",
     "secondary": "rgb(214 198 141)",
+    "secondaryForeground": "rgb(57 48 5)",
     "shadow": "rgba(0, 0, 0, 0.3)",
     "success": "#10B981",
+    "tertiary": "rgb(207 201 125)",
+    "tertiaryForeground": "rgb(53 50 0)",
     "text": "rgb(238 225 202)",
     "textSecondary": "rgb(211 197 170)",
     "textTertiary": "rgb(156 143 119)",
@@ -826,8 +901,11 @@ exports[`theme.colors snapshot for all presets (catches unintended palette shift
     "primarySubtle": "rgb(255 223 154)",
     "primarySubtleForeground": "rgb(90 67 0)",
     "secondary": "rgb(106 94 47)",
+    "secondaryForeground": "rgb(255 255 255)",
     "shadow": "rgba(0, 0, 0, 0.1)",
     "success": "#10B981",
+    "tertiary": "rgb(100 96 32)",
+    "tertiaryForeground": "rgb(255 255 255)",
     "text": "rgb(33 27 13)",
     "textSecondary": "rgb(79 70 49)",
     "textTertiary": "rgb(130 118 95)",

package/src/theme/__tests__/build-theme-from-seed-parity.test.ts

@@ -0,0 +1,33 @@
+/**
+ * Parity guard for the dynamic JS-theme seed path.
+ *
+ * A named preset is just a fixed seed, so `buildThemeFromSeed(preset.hex, mode)`
+ * MUST produce the identical `theme.colors` as the preset path
+ * `buildTheme(name, mode)`. If `buildColorsFromSeed` ever drifts from
+ * `buildColorsFromPreset`, this fails.
+ *
+ * NOTE: `buildTheme` can apply an adaptive (Material You) override on native, but
+ * this test runs under jsdom/node where `Platform.OS !== 'web'` is false and
+ * `isAdaptive` defaults to false, so the comparison is against the preset-derived
+ * palette (not adaptive), which is exactly what the seed path reproduces.
+ */
+import { APP_COLOR_NAMES, APP_COLOR_PRESETS, type AppColorName } from '../color-presets';
+import { buildTheme } from '../build-theme';
+import { buildThemeFromSeed } from '../build-theme-from-seed';
+
+describe('buildThemeFromSeed parity with buildTheme (preset)', () => {
+  const modes: Array<'light' | 'dark'> = ['light', 'dark'];
+
+  for (const name of APP_COLOR_NAMES as readonly AppColorName[]) {
+    for (const mode of modes) {
+      it(`matches preset "${name}" colours in ${mode} mode`, () => {
+        const preset = APP_COLOR_PRESETS[name];
+        const fromPreset = buildTheme(name, mode);
+        const fromSeed = buildThemeFromSeed(preset.hex, mode, preset.variant);
+        expect(fromSeed.colors).toEqual(fromPreset.colors);
+        expect(fromSeed.mode).toBe(fromPreset.mode);
+        expect(fromSeed.isDark).toBe(fromPreset.isDark);
+      });
+    }
+  }
+});

package/src/theme/__tests__/seed-scope-parity.test.ts

@@ -0,0 +1,27 @@
+/**
+ * Parity guard for the dynamic seed-scope path.
+ *
+ * A named preset is just a fixed seed fed through the same colour engine, so
+ * `buildSeedScopeVars({ seed: preset.hex, ... })` MUST produce the identical
+ * token record as the preset path (`buildScopeVars(name, mode)`), including the
+ * Tailwind v4 `--color-*` aliases. If the role → token mapping in
+ * `seed-scope.ts` ever drifts from `getPresetVars`, this fails.
+ */
+import { APP_COLOR_NAMES, APP_COLOR_PRESETS, type AppColorName } from '../color-presets';
+import { buildScopeVars } from '../color-scope/style-builder';
+import { buildSeedScopeVars } from '../color-scope/seed-scope';
+
+describe('buildSeedScopeVars parity with preset scope', () => {
+  const modes: Array<'light' | 'dark'> = ['light', 'dark'];
+
+  for (const name of APP_COLOR_NAMES as readonly AppColorName[]) {
+    for (const mode of modes) {
+      it(`matches preset "${name}" in ${mode} mode`, () => {
+        const preset = APP_COLOR_PRESETS[name];
+        const fromPreset = buildScopeVars(name, mode);
+        const fromSeed = buildSeedScopeVars({ seed: preset.hex, mode });
+        expect(fromSeed).toEqual(fromPreset);
+      });
+    }
+  }
+});