@oxyhq/bloom 0.41.0 → 0.42.0

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

@@ -27,6 +27,18 @@ export interface SeedScopeOptions {
     variant?: SchemeVariant;
     /** −1 (low) … 0 (normal) … 1 (high). Defaults to 0. */
     contrastLevel?: number;
+    /**
+     * Optional explicit secondary-accent seed, `#rrggbb`. Pins the secondary palette
+     * to this brand colour instead of the derived rotation (M3 role tones still
+     * apply). Handy for an artwork-extracted theme: pass the second-ranked seed from
+     * `seedsFromImagePixels` (`seeds[1]`) as a distinct secondary accent.
+     */
+    secondarySeed?: string;
+    /**
+     * Optional explicit tertiary-accent seed, `#rrggbb`. Same semantics; pass
+     * `seedsFromImagePixels`' `seeds[2]` for a third artwork-derived accent.
+     */
+    tertiarySeed?: string;
 }
 /**
  * Build the CSS custom-property map for an ARBITRARY seed colour — the dynamic

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

@@ -1 +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;;;;OAIG;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,CAkBpF"}
+{"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;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBpF"}

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

@@ -1,6 +1,7 @@
 import type React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 import type { AppColorName } from '../color-presets';
+import type { ExplicitAccents } from '../preset-vars';
 /**
  * Component that provides inline CSS variables to a subtree via NativeWind's
  * (react-native-css's) real `VariableContext`. The runtime strips the leading
@@ -21,7 +22,7 @@ export type VariableContextProviderComponent = React.ComponentType<{
  * inherited custom properties like `--color-primary: var(--primary)` compute at
  * the document root and would otherwise keep pointing at the app-wide preset.
  */
-export declare function buildScopeVars(colorPreset: AppColorName, mode: 'light' | 'dark'): Record<string, string>;
+export declare function buildScopeVars(colorPreset: AppColorName, mode: 'light' | 'dark', accents?: ExplicitAccents): Record<string, string>;
 /**
  * Resolve NativeWind's `VariableContextProvider` — the canonical, non-deprecated
  * react-native-css v3 API for providing inline CSS variables to a subtree. It

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

@@ -1 +1 @@
-{"version":3,"file":"style-builder.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/style-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;GAKG;AACH,MAAM,MAAM,gCAAgC,GAAG,KAAK,CAAC,aAAa,CAAC;IACjE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC,CAAC;AASH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,YAAY,EACzB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,IAAI,gCAAgC,GAAG,IAAI,CAKpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,YAAY,EACzB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,SAAS,CAAC,SAAS,CAAC,CAKtB"}
+{"version":3,"file":"style-builder.d.ts","sourceRoot":"","sources":["../../../../../src/theme/color-scope/style-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD;;;;;GAKG;AACH,MAAM,MAAM,gCAAgC,GAAG,KAAK,CAAC,aAAa,CAAC;IACjE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC,CAAC;AASH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,YAAY,EACzB,IAAI,EAAE,OAAO,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,IAAI,gCAAgC,GAAG,IAAI,CAKpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,YAAY,EACzB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,SAAS,CAAC,SAAS,CAAC,CAKtB"}

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

@@ -7,9 +7,10 @@ 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 type { RoleColors, GenerateOptions, RoleName, SchemeVariant, AccentSources } from './color-engine';
 export { buildTheme, STATUS_COLORS } from './build-theme';
 export { buildThemeFromSeed, buildColorsFromSeed } from './build-theme-from-seed';
+export type { SeedAccents } from './build-theme-from-seed';
 export { THEME_GRADIENTS } from './gradients';
 export { useTheme, useThemeColor, useBloomTheme } from './use-theme';
 export { useNavigationTheme } from './use-navigation-theme';
@@ -20,6 +21,7 @@ export { APP_COLOR_NAMES, PREMIUM_COLOR_NAMES, APP_COLOR_PRESETS, HEX_TO_APP_COL
 export { parseRgb, withAlpha } from './color-utils';
 export type { RgbChannels } from './color-utils';
 export { getPresetVars, applyPresetVarsToDocument } from './preset-vars';
+export type { ExplicitAccents } from './preset-vars';
 export { applyDarkClass } from './apply-dark-class';
 export { setColorSchemeSafe } from './set-color-scheme-safe';
 export { initCssInteropDarkMode } from './init-css-interop';

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,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"}
+{"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,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,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,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,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/native-root-vars.d.ts

@@ -1,4 +1,5 @@
 import { type AppColorName } from './color-presets';
+import type { ExplicitAccents } from './preset-vars';
 /**
  * Platform-neutral DEFAULT variant of `applyNativeRootVars` — a no-op.
  *
@@ -29,5 +30,5 @@ import { type AppColorName } from './color-presets';
  * The signature is intentionally identical to those variants so the import site in
  * `BloomThemeProvider` is platform-agnostic.
  */
-export declare function applyNativeRootVars(_colorPreset: AppColorName, _mode: 'light' | 'dark'): void;
+export declare function applyNativeRootVars(_colorPreset: AppColorName, _mode: 'light' | 'dark', _accents?: ExplicitAccents): void;
 //# sourceMappingURL=native-root-vars.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"native-root-vars.d.ts","sourceRoot":"","sources":["../../../../src/theme/native-root-vars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG7F"}
+{"version":3,"file":"native-root-vars.d.ts","sourceRoot":"","sources":["../../../../src/theme/native-root-vars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,OAAO,GAAG,MAAM,EACvB,QAAQ,CAAC,EAAE,eAAe,GACzB,IAAI,CAGN"}

package/lib/typescript/module/theme/native-root-vars.native.d.ts

@@ -1,4 +1,5 @@
 import { type AppColorName } from './color-presets';
+import type { ExplicitAccents } from './preset-vars';
 /**
  * Publish the active color preset's CSS custom properties into react-native-css's
  * GLOBAL root-variable family so they reach the ENTIRE native app tree — including
@@ -100,5 +101,5 @@ import { type AppColorName } from './color-presets';
  * Defensive guard: if a host ships a react-native-css build that doesn't expose
  * `rootVariables` as a callable (it always does on @3), we bail rather than throw.
  */
-export declare function applyNativeRootVars(colorPreset: AppColorName, mode: 'light' | 'dark'): void;
+export declare function applyNativeRootVars(colorPreset: AppColorName, mode: 'light' | 'dark', accents?: ExplicitAccents): void;
 //# sourceMappingURL=native-root-vars.native.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"native-root-vars.native.d.ts","sourceRoot":"","sources":["../../../../src/theme/native-root-vars.native.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAS3F"}
+{"version":3,"file":"native-root-vars.native.d.ts","sourceRoot":"","sources":["../../../../src/theme/native-root-vars.native.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,YAAY,EACzB,IAAI,EAAE,OAAO,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI,CASN"}

package/lib/typescript/module/theme/native-root-vars.web.d.ts

@@ -1,4 +1,5 @@
 import { type AppColorName } from './color-presets';
+import type { ExplicitAccents } from './preset-vars';
 /**
  * Web fork of `applyNativeRootVars` — a no-op.
  *
@@ -16,5 +17,5 @@ import { type AppColorName } from './color-presets';
  * The signature is intentionally identical to the plain variant so the import
  * site in `BloomThemeProvider` is platform-agnostic.
  */
-export declare function applyNativeRootVars(_colorPreset: AppColorName, _mode: 'light' | 'dark'): void;
+export declare function applyNativeRootVars(_colorPreset: AppColorName, _mode: 'light' | 'dark', _accents?: ExplicitAccents): void;
 //# sourceMappingURL=native-root-vars.web.d.ts.map

package/lib/typescript/module/theme/native-root-vars.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-root-vars.web.d.ts","sourceRoot":"","sources":["../../../../src/theme/native-root-vars.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAE7F"}
+{"version":3,"file":"native-root-vars.web.d.ts","sourceRoot":"","sources":["../../../../src/theme/native-root-vars.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,OAAO,GAAG,MAAM,EACvB,QAAQ,CAAC,EAAE,eAAe,GACzB,IAAI,CAEN"}

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

@@ -1,4 +1,15 @@
 import { type AppColorName, type PresetTokens } from './color-presets';
+/**
+ * Optional explicit accent-colour overrides (`#rrggbb`) that PIN the secondary
+ * and/or tertiary palette app-wide, regardless of the active preset's own seed.
+ * Threaded from `BloomThemeProvider`'s `secondaryColor` / `tertiaryColor` props
+ * down through the whole token pipeline. When both are omitted, the preset's own
+ * (usually derived) accents are used — output is unchanged.
+ */
+export interface ExplicitAccents {
+    secondaryHex?: string;
+    tertiaryHex?: string;
+}
 /**
  * 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.
@@ -16,7 +27,7 @@ import { type AppColorName, type PresetTokens } from './color-presets';
  * This is the single source of truth for extended theming vars — consumer apps
  * must not redefine these per-app.
  */
-export declare function getPresetVars(colorName: AppColorName, mode: 'light' | 'dark'): PresetTokens;
+export declare function getPresetVars(colorName: AppColorName, mode: 'light' | 'dark', accents?: ExplicitAccents): PresetTokens;
 /**
  * Apply a preset's extended vars to `document.documentElement`. Web-only no-op
  * on native. `BloomThemeProvider` already writes the base preset vars on web;

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,CAwDd;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;AAG1F;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,YAAY,CA8Dd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,IAAI,CAYN"}

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

@@ -1,4 +1,5 @@
 import { APP_COLOR_NAMES, type AppColorName } from './color-presets';
+import { type ExplicitAccents } from './preset-vars';
 /**
  * The canonical set of Bloom theme token names — WITHOUT the leading `--`.
  *
@@ -48,6 +49,6 @@ export declare function hslToSrgb(triple: string): string;
  * (`__fixtures__/golden-resolved-tokens.json`), guaranteeing the visible palette
  * matches the previous resolved-color pipeline byte-for-byte.
  */
-export declare function getResolvedTokens(preset: AppColorName, mode: 'light' | 'dark'): Record<string, string>;
+export declare function getResolvedTokens(preset: AppColorName, mode: 'light' | 'dark', accents?: ExplicitAccents): Record<string, string>;
 export { APP_COLOR_NAMES };
 //# sourceMappingURL=token-registry.d.ts.map

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,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"}
+{"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;AACrE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpE;;;;;;;;;;;;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,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/bloom",
-  "version": "0.41.0",
+  "version": "0.42.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/__tests__/theme.test.ts

@@ -158,6 +158,9 @@ function createMockColors(): ThemeColors {
     primaryLight: '#e0f7fa',
     primaryDark: '#003d44',
     secondary: '#005c67',
+    secondaryForeground: '#FFFFFF',
+    tertiary: '#7a4b3a',
+    tertiaryForeground: '#FFFFFF',
     tint: '#005c67',
     icon: '#666',
     iconActive: '#005c67',

package/src/theme/BloomThemeProvider.tsx

@@ -37,6 +37,7 @@ import {
   type BloomThemeStorage,
   type SyncReadResult,
 } from './persistence';
+import type { ExplicitAccents } from './preset-vars';
 import { setColorSchemeSafe } from './set-color-scheme-safe';
 import { useIsomorphicLayoutEffect } from './use-isomorphic-layout-effect';
 import type { Theme, ThemeMode } from './types';
@@ -135,6 +136,21 @@ export interface BloomThemeProviderProps {
    */
   nativeWrapperStyle?: StyleProp<ViewStyle>;
 
+  /**
+   * Optional app-wide secondary-accent colour, `#rrggbb`. When set, the whole
+   * theme's secondary family (`--secondary`, `bg-secondary`, `colors.secondary`,
+   * plus the container / on-colour roles) is PINNED to this brand colour instead
+   * of the derived hue-rotation of the active preset's seed — for a brand with a
+   * distinct accent (e.g. blue primary + yellow secondary). M3 role tones still
+   * apply. Omit to keep the preset's derived accent.
+   */
+  secondaryColor?: string;
+  /**
+   * Optional app-wide tertiary-accent colour, `#rrggbb`. Same semantics as
+   * {@link BloomThemeProviderProps.secondaryColor} for the tertiary family.
+   */
+  tertiaryColor?: string;
+
   children: React.ReactNode;
 }
 
@@ -296,10 +312,24 @@ export function BloomThemeProvider({
   fonts = true,
   onFontsLoading,
   nativeWrapperStyle,
+  secondaryColor,
+  tertiaryColor,
   children,
 }: BloomThemeProviderProps) {
   const rnScheme = useRNColorScheme();
 
+  // The app-wide pinned accents, if any. Memoized so its identity only changes
+  // when a prop changes (keeps the effect/memo deps below stable). Left
+  // `undefined` when neither is set so every downstream call is byte-identical
+  // to the no-accent path.
+  const explicitAccents = useMemo<ExplicitAccents | undefined>(
+    () =>
+      secondaryColor === undefined && tertiaryColor === undefined
+        ? undefined
+        : { secondaryHex: secondaryColor, tertiaryHex: tertiaryColor },
+    [secondaryColor, tertiaryColor],
+  );
+
   const { mode, colorPreset, setMode, setColorPreset, resetTheme, hydrated } = useThemeState({
     controlledMode,
     controlledPreset,
@@ -322,8 +352,8 @@ export function BloomThemeProvider({
   useIsomorphicLayoutEffect(() => {
     setColorSchemeSafe(effectiveMode);
     applyDarkClass(resolved);
-    applyColorPresetVars(colorPreset, resolved);
-  }, [effectiveMode, resolved, colorPreset]);
+    applyColorPresetVars(colorPreset, resolved, explicitAccents);
+  }, [effectiveMode, resolved, colorPreset, explicitAccents]);
 
   // Native only: publish the preset vars into react-native-css's GLOBAL root
   // variable family so they reach the ENTIRE app tree — navigator screens and
@@ -333,19 +363,19 @@ export function BloomThemeProvider({
   // there. Runs before paint via `useIsomorphicLayoutEffect`, matching the
   // sibling `applyColorPresetVars` side effect.
   useIsomorphicLayoutEffect(() => {
-    applyNativeRootVars(colorPreset, resolved);
-  }, [colorPreset, resolved]);
+    applyNativeRootVars(colorPreset, resolved, explicitAccents);
+  }, [colorPreset, resolved, explicitAccents]);
 
   const contextValue = useMemo<BloomThemeContextValue>(
     () => ({
-      theme: buildTheme(colorPreset, resolved, isAdaptive),
+      theme: buildTheme(colorPreset, resolved, isAdaptive, explicitAccents),
       mode,
       colorPreset,
       setMode,
       setColorPreset,
       resetTheme,
     }),
-    [colorPreset, resolved, isAdaptive, mode, setMode, setColorPreset, resetTheme],
+    [colorPreset, resolved, isAdaptive, explicitAccents, mode, setMode, setColorPreset, resetTheme],
   );
 
   const shouldAwait = awaitHydration ?? Boolean(persistKey && storage);
@@ -356,8 +386,8 @@ export function BloomThemeProvider({
   // etc. through react-native-css's real VariableContext. Web writes these to
   // `document.documentElement` via `applyColorPresetVars`, so it's unused there.
   const nativeVars = useMemo(
-    () => (Platform.OS === 'web' ? null : buildScopeVars(colorPreset, resolved)),
-    [colorPreset, resolved],
+    () => (Platform.OS === 'web' ? null : buildScopeVars(colorPreset, resolved, explicitAccents)),
+    [colorPreset, resolved, explicitAccents],
   );
   const VariableProvider = getVariableContextProvider();
 

package/src/theme/__tests__/explicit-accents.test.ts

@@ -0,0 +1,129 @@
+/**
+ * Explicit secondary/tertiary accent pinning.
+ *
+ * A brand with a distinct accent (e.g. blue primary + yellow secondary) can PIN
+ * its real accent colours instead of the engine deriving secondary/tertiary as
+ * hue-rotations of the primary seed. These tests assert:
+ *   1. pinning shifts the secondary/tertiary family HUE toward the pinned colour
+ *      (and away from the derived one), and
+ *   2. omitting the seeds is byte-identical to the pre-feature derived output.
+ */
+import {
+  argbFromHex,
+  generateRoleColors,
+  type RoleColors,
+} from '../color-engine';
+import { Hct } from '../color-engine/hct';
+import { buildSeedScopeVars } from '../color-scope/seed-scope';
+
+/** Hue (deg) of an `rgb(r g b)` engine output string. */
+function hueOf(rgb: string): number {
+  const m = rgb.match(/rgb\((\d+) (\d+) (\d+)\)/);
+  if (!m) throw new Error(`expected "rgb(r g b)", got: ${rgb}`);
+  const argb = (0xff << 24) | (Number(m[1]) << 16) | (Number(m[2]) << 8) | Number(m[3]);
+  return Hct.fromInt(argb >>> 0).hue;
+}
+
+/** Smallest absolute angular distance between two hues, in degrees (0–180). */
+function hueDistance(a: number, b: number): number {
+  const d = Math.abs(a - b) % 360;
+  return d > 180 ? 360 - d : d;
+}
+
+const BLUE = '#1d9bf0';
+const YELLOW = '#ffc300';
+const PINK = '#ec4899';
+
+describe('explicit accent pinning — generateRoleColors', () => {
+  const derived: RoleColors = generateRoleColors({ seed: BLUE, variant: 'vivid', isDark: false });
+
+  it('pins the secondary family to the supplied colour hue', () => {
+    const pinned = generateRoleColors({
+      seed: BLUE,
+      variant: 'vivid',
+      isDark: false,
+      secondarySeed: YELLOW,
+    });
+
+    const yellowHue = Hct.fromInt(argbFromHex(YELLOW)).hue;
+    // The pinned secondary family reads at the yellow hue…
+    expect(hueDistance(hueOf(pinned.secondary), yellowHue)).toBeLessThan(20);
+    // …and its container / on-colour roles share that hue family too.
+    expect(hueDistance(hueOf(pinned.secondaryContainer), yellowHue)).toBeLessThan(20);
+    expect(hueDistance(hueOf(pinned.onSecondaryContainer), yellowHue)).toBeLessThan(20);
+    // …which differs materially from the derived (blue-rotation) secondary.
+    expect(hueDistance(hueOf(pinned.secondary), hueOf(derived.secondary))).toBeGreaterThan(30);
+  });
+
+  it('pins the tertiary family independently of the secondary', () => {
+    const pinned = generateRoleColors({
+      seed: BLUE,
+      variant: 'vivid',
+      isDark: false,
+      tertiarySeed: PINK,
+    });
+
+    const pinkHue = Hct.fromInt(argbFromHex(PINK)).hue;
+    expect(hueDistance(hueOf(pinned.tertiary), pinkHue)).toBeLessThan(20);
+    expect(hueDistance(hueOf(pinned.tertiary), hueOf(derived.tertiary))).toBeGreaterThan(20);
+    // Secondary is untouched when only tertiary is pinned.
+    expect(pinned.secondary).toBe(derived.secondary);
+  });
+
+  it('pins both accents at once, leaving primary + neutrals unchanged', () => {
+    const pinned = generateRoleColors({
+      seed: BLUE,
+      variant: 'vivid',
+      isDark: false,
+      secondarySeed: YELLOW,
+      tertiarySeed: PINK,
+    });
+
+    expect(hueDistance(hueOf(pinned.secondary), Hct.fromInt(argbFromHex(YELLOW)).hue)).toBeLessThan(20);
+    expect(hueDistance(hueOf(pinned.tertiary), Hct.fromInt(argbFromHex(PINK)).hue)).toBeLessThan(20);
+    // Primary + surfaces are seed-driven and must not move.
+    expect(pinned.primary).toBe(derived.primary);
+    expect(pinned.background).toBe(derived.background);
+    expect(pinned.surfaceContainerLowest).toBe(derived.surfaceContainerLowest);
+  });
+
+  it('is byte-identical to the derived output when no accents are supplied', () => {
+    const again = generateRoleColors({ seed: BLUE, variant: 'vivid', isDark: false });
+    expect(again).toEqual(derived);
+  });
+
+  it('applies pinned accents in dark mode too', () => {
+    const pinnedDark = generateRoleColors({
+      seed: BLUE,
+      variant: 'vivid',
+      isDark: true,
+      secondarySeed: YELLOW,
+    });
+    expect(hueDistance(hueOf(pinnedDark.secondary), Hct.fromInt(argbFromHex(YELLOW)).hue)).toBeLessThan(20);
+  });
+});
+
+describe('explicit accent pinning — arbitrary-seed scope path', () => {
+  it('threads pinned accents through buildSeedScopeVars', () => {
+    const derivedVars = buildSeedScopeVars({ seed: BLUE, mode: 'light' });
+    const pinnedVars = buildSeedScopeVars({
+      seed: BLUE,
+      mode: 'light',
+      secondarySeed: YELLOW,
+      tertiarySeed: PINK,
+    });
+
+    const yellowHue = Hct.fromInt(argbFromHex(YELLOW)).hue;
+    const pinkHue = Hct.fromInt(argbFromHex(PINK)).hue;
+
+    expect(pinnedVars['--secondary']).toBeDefined();
+    expect(hueDistance(hueOf(pinnedVars['--secondary'] ?? ''), yellowHue)).toBeLessThan(20);
+    expect(hueDistance(hueOf(pinnedVars['--tertiary'] ?? ''), pinkHue)).toBeLessThan(20);
+    // The scoped `--color-*` alias tracks the pinned value too (web utility contract).
+    expect(pinnedVars['--color-secondary']).toBe(pinnedVars['--secondary']);
+    // Primary token is unchanged vs the derived scope.
+    expect(pinnedVars['--primary']).toBe(derivedVars['--primary']);
+    // Derived secondary differs from the pinned one.
+    expect(pinnedVars['--secondary']).not.toBe(derivedVars['--secondary']);
+  });
+});

package/src/theme/apply-dark-class.ts

@@ -1,5 +1,6 @@
 import { Platform } from 'react-native';
 import { APP_COLOR_PRESETS, type AppColorName } from './color-presets';
+import type { ExplicitAccents } from './preset-vars';
 import { getResolvedTokens } from './token-registry';
 
 export function applyDarkClass(resolved: 'light' | 'dark') {
@@ -25,11 +26,15 @@ export function applyDarkClass(resolved: 'light' | 'dark') {
  * Includes extended tokens (card, chart-*, content-area, sidebar-*) so consumer
  * apps don't need to synthesize them.
  */
-export function applyColorPresetVars(preset: AppColorName, resolved: 'light' | 'dark') {
+export function applyColorPresetVars(
+  preset: AppColorName,
+  resolved: 'light' | 'dark',
+  accents?: ExplicitAccents,
+) {
   if (Platform.OS !== 'web' || typeof document === 'undefined') return;
   if (!APP_COLOR_PRESETS[preset]) return;
 
-  const vars = getResolvedTokens(preset, resolved);
+  const vars = getResolvedTokens(preset, resolved, accents);
   const root = document.documentElement.style;
 
   for (const [key, value] of Object.entries(vars)) {

package/src/theme/build-theme-from-seed.ts

@@ -4,6 +4,18 @@ import { STATUS_COLORS } from './build-theme';
 import { THEME_GRADIENTS } from './gradients';
 import type { Theme, ThemeColors } from './types';
 
+/**
+ * Optional explicit accent seeds for the arbitrary-seed theme path. Pinning a
+ * `secondarySeed` / `tertiarySeed` (`#rrggbb`) forces that accent family to the
+ * given brand colour instead of the derived hue-rotation — mirroring
+ * {@link GenerateOptions.secondarySeed}. For an artwork-derived theme, pass the
+ * ranked `seedsFromImagePixels` results (`seeds[1]` / `seeds[2]`).
+ */
+export interface SeedAccents {
+  secondarySeed?: string;
+  tertiarySeed?: string;
+}
+
 /**
  * Build the JS `theme.colors` object from an ARBITRARY seed colour — the dynamic
  * counterpart of `buildTheme(preset, …)`.
@@ -22,8 +34,16 @@ export function buildColorsFromSeed(
   resolved: 'light' | 'dark',
   variant?: SchemeVariant,
   contrastLevel?: number,
+  accents?: SeedAccents,
 ): ThemeColors {
-  const t = buildSeedScopeVars({ seed, mode: resolved, variant, contrastLevel });
+  const t = buildSeedScopeVars({
+    seed,
+    mode: resolved,
+    variant,
+    contrastLevel,
+    secondarySeed: accents?.secondarySeed,
+    tertiarySeed: accents?.tertiarySeed,
+  });
   const isDark = resolved === 'dark';
 
   // Read a resolved `rgb(...)` token by its bare name (no leading `--`).
@@ -34,6 +54,8 @@ export function buildColorsFromSeed(
     variant,
     isDark,
     contrastLevel,
+    secondarySeed: accents?.secondarySeed,
+    tertiarySeed: accents?.tertiarySeed,
   });
 
   return {
@@ -88,10 +110,11 @@ export function buildThemeFromSeed(
   resolved: 'light' | 'dark',
   variant?: SchemeVariant,
   contrastLevel?: number,
+  accents?: SeedAccents,
 ): Theme {
   return {
     mode: resolved,
-    colors: buildColorsFromSeed(seed, resolved, variant, contrastLevel),
+    colors: buildColorsFromSeed(seed, resolved, variant, contrastLevel, accents),
     gradients: THEME_GRADIENTS,
     isDark: resolved === 'dark',
     isLight: resolved === 'light',

package/src/theme/build-theme.ts

@@ -1,6 +1,7 @@
 import { Platform } from 'react-native';
 import { APP_COLOR_PRESETS, type AppColorName } from './color-presets';
 import { generateRoleColors, type RoleColors } from './color-engine';
+import type { ExplicitAccents } from './preset-vars';
 import { getAdaptiveColors } from './adaptive-colors';
 import { getResolvedTokens } from './token-registry';
 import { THEME_GRADIENTS } from './gradients';
@@ -32,20 +33,24 @@ export const STATUS_COLORS = {
 function buildColorsFromPreset(
   preset: AppColorName,
   resolved: 'light' | 'dark',
+  accents?: ExplicitAccents,
 ): ThemeColors {
-  const t = getResolvedTokens(preset, resolved);
+  const t = getResolvedTokens(preset, resolved, accents);
   const isDark = resolved === 'dark';
 
   // Read a resolved `rgb(...)` token by its bare name (no leading `--`).
   const g = (k: string): string => t[`--${k}`] ?? 'rgb(0 0 0)';
 
   // The full engine role set — for fields that map to roles Bloom's canonical
-  // token set does not surface (containers, error family).
+  // token set does not surface (containers, error family). An app-wide accent
+  // override wins over the preset's own declared accent (else derived).
   const config = APP_COLOR_PRESETS[preset];
   const r: RoleColors = generateRoleColors({
     seed: config.hex,
     variant: config.variant,
     isDark,
+    secondarySeed: accents?.secondaryHex ?? config.secondaryHex,
+    tertiarySeed: accents?.tertiaryHex ?? config.tertiaryHex,
   });
 
   return {
@@ -105,9 +110,10 @@ export function buildTheme(
   preset: AppColorName,
   resolved: 'light' | 'dark',
   isAdaptive: boolean = false,
+  accents?: ExplicitAccents,
 ): Theme {
   const adaptive = isAdaptive && Platform.OS !== 'web' ? getAdaptiveColors() : undefined;
-  const colors = adaptive ?? buildColorsFromPreset(preset, resolved);
+  const colors = adaptive ?? buildColorsFromPreset(preset, resolved, accents);
 
   return {
     mode: resolved,

package/src/theme/color-engine/index.ts

@@ -11,7 +11,7 @@ export { Hct } from './hct';
 export { TonalPalette } from './tonal-palette';
 export { DynamicScheme } from './dynamic-scheme';
 export { buildScheme, schemeVibrant, schemeExpressive, schemeTonalSpot, schemeNeutral } from './scheme-variants';
-export type { SchemeVariant } from './scheme-variants';
+export type { SchemeVariant, AccentSources } from './scheme-variants';
 export { Roles } from './color-roles';
 export type { RoleName } from './color-roles';
 export { ColorRole } from './color-role';
@@ -51,11 +51,27 @@ export interface GenerateOptions {
   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 function generateRoleColors(opts: GenerateOptions): RoleColors {
   const scheme = buildScheme(
@@ -63,6 +79,16 @@ export function generateRoleColors(opts: GenerateOptions): RoleColors {
     Hct.fromInt(argbFromHex(opts.seed)),
     opts.isDark ?? false,
     opts.contrastLevel ?? 0,
+    {
+      secondarySource:
+        opts.secondarySeed !== undefined
+          ? Hct.fromInt(argbFromHex(opts.secondarySeed))
+          : undefined,
+      tertiarySource:
+        opts.tertiarySeed !== undefined
+          ? Hct.fromInt(argbFromHex(opts.tertiarySeed))
+          : undefined,
+    },
   );
   const out = {} as RoleColors;
   for (const name of Object.keys(Roles) as RoleName[]) {