@oxyhq/bloom 0.84.0 → 0.85.0

package/lib/commonjs/design-tokens/index.js

@@ -81,8 +81,22 @@ Object.defineProperty(exports, "bloomThemeCss", {
     return _themeCss.bloomThemeCss;
   }
 });
+Object.defineProperty(exports, "buildSeedScopeVars", {
+  enumerable: true,
+  get: function () {
+    return _seedScope.buildSeedScopeVars;
+  }
+});
+Object.defineProperty(exports, "getPresetVars", {
+  enumerable: true,
+  get: function () {
+    return _presetVars.getPresetVars;
+  }
+});
 var _tailwindPreset = require("./tailwind-preset.js");
 var _themeCss = require("./theme-css.js");
+var _presetVars = require("../theme/preset-vars.js");
+var _seedScope = require("../theme/color-scope/seed-scope.js");
 var _colorRoles = require("./color-roles.js");
 var _scales = require("./scales.js");
 var _shadows = require("./shadows");

package/lib/commonjs/design-tokens/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_tailwindPreset","require","_themeCss","_colorRoles","_scales","_shadows"],"sourceRoot":"../../../src","sources":["design-tokens/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA,IAAAA,eAAA,GAAAC,OAAA;AAMA,IAAAC,SAAA,GAAAD,OAAA;AAEA,IAAAE,WAAA,GAAAF,OAAA;AAOA,IAAAG,OAAA,GAAAH,OAAA;AASA,IAAAI,QAAA,GAAAJ,OAAA","ignoreList":[]}
+{"version":3,"names":["_tailwindPreset","require","_themeCss","_presetVars","_seedScope","_colorRoles","_scales","_shadows"],"sourceRoot":"../../../src","sources":["design-tokens/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAAA,eAAA,GAAAC,OAAA;AAMA,IAAAC,SAAA,GAAAD,OAAA;AAgBA,IAAAE,WAAA,GAAAF,OAAA;AAEA,IAAAG,UAAA,GAAAH,OAAA;AAGA,IAAAI,WAAA,GAAAJ,OAAA;AAOA,IAAAK,OAAA,GAAAL,OAAA;AASA,IAAAM,QAAA,GAAAN,OAAA","ignoreList":[]}

package/lib/module/design-tokens/index.js

@@ -10,6 +10,8 @@
  *     `p-space-8`, `rounded-radius-20`, `text-body`, `font-body`, `shadow-s`).
  *   - `bloomThemeCss` / `bloomThemeBlock` — the Tailwind v4 `@theme` equivalent
  *     for CSS-configured web apps.
+ *   - `getPresetVars` / `buildSeedScopeVars` — the resolved token VALUES behind
+ *     that alias layer, for a named preset or an arbitrary brand seed.
  *   - The raw token maps (`FILL_ROLES`, `TEXT_ROLES`, `BORDER_ROLES`, `SPACING`,
  *     `RADIUS`, `TYPOGRAPHY`, `SHADOW_BOX`) for direct programmatic use.
  *   - `bloomShadowStyle` — platform-correct shadow style object (web box-shadow /
@@ -21,6 +23,23 @@
 
 export { bloomTailwindPreset } from "./tailwind-preset.js";
 export { bloomThemeCss, bloomThemeBlock } from "./theme-css.js";
+
+/* The resolved counterpart of `bloomThemeCss()`. That emits the alias layer
+ * (`--color-x: var(--x)`); these resolve `--x` itself, so a build script can
+ * write a static `:root` / `.dark` block and a prerendered page paints the real
+ * theme before `BloomThemeProvider` runs — instead of a hand-written palette
+ * that drifts from the preset it claims to mirror.
+ *
+ * `getPresetVars` returns the canonical tokens alone, which is all a document
+ * root needs. `buildSeedScopeVars` also returns the `--color-x` aliases, which a
+ * SCOPED block (a brand section, a forced-dark region) does need: a `--color-x`
+ * alias substitutes where it is declared, so overriding `--x` on a subtree does
+ * not move an alias declared at `:root`.
+ *
+ * Both are pure — no React, no react-native — so they run in a plain node/bun
+ * build script as well as in an app. */
+export { getPresetVars } from "../theme/preset-vars.js";
+export { buildSeedScopeVars } from "../theme/color-scope/seed-scope.js";
 export { FILL_ROLES, TEXT_ROLES, BORDER_ROLES } from "./color-roles.js";
 export { SPACING, RADIUS, BORDER_WIDTH, TYPOGRAPHY, FONT_FAMILY_VARS } from "./scales.js";
 export { SHADOW_BOX, bloomShadowStyle } from './shadows';

package/lib/module/design-tokens/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["bloomTailwindPreset","bloomThemeCss","bloomThemeBlock","FILL_ROLES","TEXT_ROLES","BORDER_ROLES","SPACING","RADIUS","BORDER_WIDTH","TYPOGRAPHY","FONT_FAMILY_VARS","SHADOW_BOX","bloomShadowStyle"],"sourceRoot":"../../../src","sources":["design-tokens/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,mBAAmB,QAAQ,sBAAmB;AAMvD,SAASC,aAAa,EAAEC,eAAe,QAAQ,gBAAa;AAE5D,SACEC,UAAU,EACVC,UAAU,EACVC,YAAY,QACP,kBAAe;AAGtB,SACEC,OAAO,EACPC,MAAM,EACNC,YAAY,EACZC,UAAU,EACVC,gBAAgB,QACX,aAAU;AAGjB,SAASC,UAAU,EAAEC,gBAAgB,QAAQ,WAAW","ignoreList":[]}
+{"version":3,"names":["bloomTailwindPreset","bloomThemeCss","bloomThemeBlock","getPresetVars","buildSeedScopeVars","FILL_ROLES","TEXT_ROLES","BORDER_ROLES","SPACING","RADIUS","BORDER_WIDTH","TYPOGRAPHY","FONT_FAMILY_VARS","SHADOW_BOX","bloomShadowStyle"],"sourceRoot":"../../../src","sources":["design-tokens/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,mBAAmB,QAAQ,sBAAmB;AAMvD,SAASC,aAAa,EAAEC,eAAe,QAAQ,gBAAa;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,aAAa,QAAQ,yBAAsB;AAEpD,SAASC,kBAAkB,QAAQ,oCAAiC;AAGpE,SACEC,UAAU,EACVC,UAAU,EACVC,YAAY,QACP,kBAAe;AAGtB,SACEC,OAAO,EACPC,MAAM,EACNC,YAAY,EACZC,UAAU,EACVC,gBAAgB,QACX,aAAU;AAGjB,SAASC,UAAU,EAAEC,gBAAgB,QAAQ,WAAW","ignoreList":[]}

package/lib/typescript/commonjs/design-tokens/index.d.ts

@@ -8,6 +8,8 @@
  *     `p-space-8`, `rounded-radius-20`, `text-body`, `font-body`, `shadow-s`).
  *   - `bloomThemeCss` / `bloomThemeBlock` — the Tailwind v4 `@theme` equivalent
  *     for CSS-configured web apps.
+ *   - `getPresetVars` / `buildSeedScopeVars` — the resolved token VALUES behind
+ *     that alias layer, for a named preset or an arbitrary brand seed.
  *   - The raw token maps (`FILL_ROLES`, `TEXT_ROLES`, `BORDER_ROLES`, `SPACING`,
  *     `RADIUS`, `TYPOGRAPHY`, `SHADOW_BOX`) for direct programmatic use.
  *   - `bloomShadowStyle` — platform-correct shadow style object (web box-shadow /
@@ -19,6 +21,10 @@
 export { bloomTailwindPreset } from './tailwind-preset';
 export type { TailwindPreset, TailwindPresetThemeExtend, } from './tailwind-preset';
 export { bloomThemeCss, bloomThemeBlock } from './theme-css';
+export { getPresetVars } from '../theme/preset-vars';
+export type { ExplicitAccents } from '../theme/preset-vars';
+export { buildSeedScopeVars } from '../theme/color-scope/seed-scope';
+export type { SeedScopeOptions } from '../theme/color-scope/seed-scope';
 export { FILL_ROLES, TEXT_ROLES, BORDER_ROLES, } from './color-roles';
 export type { FillRole, TextRole, BorderRole } from './color-roles';
 export { SPACING, RADIUS, BORDER_WIDTH, TYPOGRAPHY, FONT_FAMILY_VARS, } from './scales';

package/lib/typescript/commonjs/design-tokens/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,cAAc,EACd,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EACL,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,cAAc,EACd,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgB7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EACL,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/lib/typescript/module/design-tokens/index.d.ts

@@ -8,6 +8,8 @@
  *     `p-space-8`, `rounded-radius-20`, `text-body`, `font-body`, `shadow-s`).
  *   - `bloomThemeCss` / `bloomThemeBlock` — the Tailwind v4 `@theme` equivalent
  *     for CSS-configured web apps.
+ *   - `getPresetVars` / `buildSeedScopeVars` — the resolved token VALUES behind
+ *     that alias layer, for a named preset or an arbitrary brand seed.
  *   - The raw token maps (`FILL_ROLES`, `TEXT_ROLES`, `BORDER_ROLES`, `SPACING`,
  *     `RADIUS`, `TYPOGRAPHY`, `SHADOW_BOX`) for direct programmatic use.
  *   - `bloomShadowStyle` — platform-correct shadow style object (web box-shadow /
@@ -19,6 +21,10 @@
 export { bloomTailwindPreset } from './tailwind-preset';
 export type { TailwindPreset, TailwindPresetThemeExtend, } from './tailwind-preset';
 export { bloomThemeCss, bloomThemeBlock } from './theme-css';
+export { getPresetVars } from '../theme/preset-vars';
+export type { ExplicitAccents } from '../theme/preset-vars';
+export { buildSeedScopeVars } from '../theme/color-scope/seed-scope';
+export type { SeedScopeOptions } from '../theme/color-scope/seed-scope';
 export { FILL_ROLES, TEXT_ROLES, BORDER_ROLES, } from './color-roles';
 export type { FillRole, TextRole, BorderRole } from './color-roles';
 export { SPACING, RADIUS, BORDER_WIDTH, TYPOGRAPHY, FONT_FAMILY_VARS, } from './scales';

package/lib/typescript/module/design-tokens/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,cAAc,EACd,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EACL,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/design-tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,cAAc,EACd,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgB7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EACL,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/package.json

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

package/src/__tests__/design-tokens.test.ts

@@ -1,10 +1,12 @@
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
 
 import {
   bloomTailwindPreset,
   bloomThemeCss,
   bloomThemeBlock,
+  getPresetVars,
+  buildSeedScopeVars,
   FILL_ROLES,
   TEXT_ROLES,
   BORDER_ROLES,
@@ -16,6 +18,7 @@ import {
   SHADOW_BOX,
   bloomShadowStyle,
 } from '../design-tokens';
+import { APP_COLOR_PRESETS } from '../theme/color-presets';
 import { CANONICAL_TOKENS } from '../theme/token-registry';
 
 describe('design-tokens color roles', () => {
@@ -190,3 +193,113 @@ describe('design-tokens shadow style (web default)', () => {
     expect(style).toHaveProperty('boxShadow', SHADOW_BOX.m);
   });
 });
+
+describe('design-tokens resolved token values', () => {
+  it('getPresetVars resolves a preset to canonical tokens only', () => {
+    const vars = getPresetVars('oxy', 'dark');
+    expect(vars['--background']).toMatch(/^rgb/);
+    // A document root needs the canonical tokens alone — the `--color-x` alias
+    // layer comes from theme.css / bloomThemeCss().
+    expect(Object.keys(vars).some((k) => k.startsWith('--color-'))).toBe(false);
+  });
+
+  it('buildSeedScopeVars also emits the --color-x aliases a scope needs', () => {
+    const vars = buildSeedScopeVars({ seed: '#7c5aed', mode: 'dark' });
+    const aliases = Object.keys(vars).filter((k) => k.startsWith('--color-'));
+    expect(aliases.length).toBeGreaterThan(0);
+    for (const alias of aliases) {
+      expect(vars[alias]).toBe(vars[alias.replace('--color-', '--')]);
+    }
+  });
+
+  it("a preset's own seed reproduces that preset exactly", () => {
+    // What lets a consumer theme a brand scope and the document root through one
+    // code path: the seed form is not an approximation of the preset form.
+    const preset = APP_COLOR_PRESETS.oxy;
+    for (const mode of ['light', 'dark'] as const) {
+      const fromPreset = getPresetVars('oxy', mode);
+      const fromSeed = buildSeedScopeVars({
+        seed: preset.hex,
+        mode,
+        variant: preset.variant,
+      });
+      for (const [token, value] of Object.entries(fromPreset)) {
+        expect(fromSeed[token]).toBe(value);
+      }
+    }
+  });
+});
+
+describe('design-tokens entry stays free of react / react-native', () => {
+  /* Build scripts import this entry from plain node/bun to emit a static theme
+   * stylesheet (see the export's doc comment). A `react-native` import anywhere
+   * in its transitive graph makes that throw at import time — in the CONSUMER's
+   * build, with a parse error inside node_modules and nothing pointing back
+   * here. Jest cannot catch it by importing the module: this suite runs in the
+   * RN preset, where both packages resolve. So walk the graph statically. */
+  const SOURCE_ROOT = join(__dirname, '..');
+  /* Captures the clause of every `import`/`export … from '…'`, so a type-only
+   * one can be told apart from a value one. `import { type ViewStyle } from
+   * 'react-native'` is erased by the compiler and is FINE here; a value import
+   * of the same module is not. A scanner blind to the difference reports the
+   * shipped `shadows.ts` as a violation. */
+  const IMPORT_RE = /(?:import|export)\s+([\s\S]*?)\s*from\s*['"]([^'"]+)['"]/g;
+
+  function isValueImport(clause: string): boolean {
+    const trimmed = clause.trim();
+    if (trimmed.startsWith('type ') || trimmed === 'type') return false;
+    const named = /^\{([\s\S]*)\}$/.exec(trimmed)?.[1];
+    if (named === undefined) return true; // default or namespace import — always a value
+    return named
+      .split(',')
+      .map((specifier) => specifier.trim())
+      .filter(Boolean)
+      .some((specifier) => !specifier.startsWith('type '));
+  }
+
+  function resolve(specifier: string, fromFile: string): string | null {
+    const base = join(dirname(fromFile), specifier);
+    for (const candidate of [
+      base,
+      `${base}.ts`,
+      `${base}.tsx`,
+      join(base, 'index.ts'),
+      join(base, 'index.tsx'),
+    ]) {
+      if (existsSync(candidate) && statSync(candidate).isFile()) return candidate;
+    }
+    return null;
+  }
+
+  const entry = join(SOURCE_ROOT, 'design-tokens', 'index.ts');
+  const visited = new Set<string>();
+  const offenders: string[] = [];
+  const queue = [entry];
+
+  for (let file = queue.pop(); file !== undefined; file = queue.pop()) {
+    if (visited.has(file)) continue;
+    visited.add(file);
+    const source = readFileSync(file, 'utf8');
+    for (const match of source.matchAll(IMPORT_RE)) {
+      const [, clause = '', specifier = ''] = match;
+      if (!isValueImport(clause)) continue;
+      if (specifier === 'react' || specifier === 'react-native' || specifier.startsWith('react-native/')) {
+        offenders.push(`${relative(SOURCE_ROOT, file)} imports ${specifier}`);
+        continue;
+      }
+      if (!specifier.startsWith('.')) continue;
+      const resolved = resolve(specifier, file);
+      if (resolved) queue.push(resolved);
+    }
+  }
+
+  it('imports neither react nor react-native anywhere in its graph', () => {
+    expect(offenders).toEqual([]);
+  });
+
+  it('actually walked the graph', () => {
+    // Without a floor, a resolver that silently returns null for everything
+    // would report a clean graph of one file.
+    expect(visited.size).toBeGreaterThan(8);
+  });
+});

package/src/design-tokens/index.ts

@@ -8,6 +8,8 @@
  *     `p-space-8`, `rounded-radius-20`, `text-body`, `font-body`, `shadow-s`).
  *   - `bloomThemeCss` / `bloomThemeBlock` — the Tailwind v4 `@theme` equivalent
  *     for CSS-configured web apps.
+ *   - `getPresetVars` / `buildSeedScopeVars` — the resolved token VALUES behind
+ *     that alias layer, for a named preset or an arbitrary brand seed.
  *   - The raw token maps (`FILL_ROLES`, `TEXT_ROLES`, `BORDER_ROLES`, `SPACING`,
  *     `RADIUS`, `TYPOGRAPHY`, `SHADOW_BOX`) for direct programmatic use.
  *   - `bloomShadowStyle` — platform-correct shadow style object (web box-shadow /
@@ -25,6 +27,25 @@ export type {
 
 export { bloomThemeCss, bloomThemeBlock } from './theme-css';
 
+/* The resolved counterpart of `bloomThemeCss()`. That emits the alias layer
+ * (`--color-x: var(--x)`); these resolve `--x` itself, so a build script can
+ * write a static `:root` / `.dark` block and a prerendered page paints the real
+ * theme before `BloomThemeProvider` runs — instead of a hand-written palette
+ * that drifts from the preset it claims to mirror.
+ *
+ * `getPresetVars` returns the canonical tokens alone, which is all a document
+ * root needs. `buildSeedScopeVars` also returns the `--color-x` aliases, which a
+ * SCOPED block (a brand section, a forced-dark region) does need: a `--color-x`
+ * alias substitutes where it is declared, so overriding `--x` on a subtree does
+ * not move an alias declared at `:root`.
+ *
+ * Both are pure — no React, no react-native — so they run in a plain node/bun
+ * build script as well as in an app. */
+export { getPresetVars } from '../theme/preset-vars';
+export type { ExplicitAccents } from '../theme/preset-vars';
+export { buildSeedScopeVars } from '../theme/color-scope/seed-scope';
+export type { SeedScopeOptions } from '../theme/color-scope/seed-scope';
+
 export {
   FILL_ROLES,
   TEXT_ROLES,