@ttoss/fsl-theme 1.1.22 → 2.1.0

package/dist/dtcg.cjs

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, {
   value: 'Module'
 });
-const require_helpers = require('./helpers-CIqeJ8yd.cjs');
-const require_tokenRegistry = require('./tokenRegistry-B9zMRjpL.cjs');
+const require_helpers = require('./helpers-BU40JvFA.cjs');
+const require_tokenRegistry = require('./tokenRegistry-f_Bx_BAN.cjs');
 
 //#region src/roots/toDTCG.ts
 /**
@@ -26,12 +26,20 @@ const require_tokenRegistry = require('./tokenRegistry-B9zMRjpL.cjs');
 *
 * Motion leaves (SemanticMotionEntry) overridden separately:
 * - `.duration`     → 'duration'
+*
+* Border / focus line widths resolve to a `dimension` (`1px`, `2px`) but sit
+* under the untyped `semantic.border.` / `semantic.focus.` prefixes:
+* - `.width`        → 'dimension'
+*/
+var SUFFIX_TYPE_OVERRIDES = [[".duration", "duration"], [".fontFamily", "fontFamily"], [".fontSize", "dimension"], [".fontWeight", "fontWeight"], [".lineHeight", "number"], [".letterSpacing", "dimension"], [".width", "dimension"], [".ring.color", "color"]];
+/**
+* Infer the DTCG `$type` for a token path, or `undefined` when the token is
+* opaque (keyword/curve/dash-string) and has no valid DTCG scalar type — in
+* which case `toDTCG` omits `$type` rather than emitting an invalid one.
 */
-var SUFFIX_TYPE_OVERRIDES = [[".duration", "duration"], [".fontFamily", "fontFamily"], [".fontSize", "dimension"], [".fontWeight", "fontWeight"], [".lineHeight", "number"], [".letterSpacing", "dimension"], [".ring.color", "color"]];
-var inferType = path => {
+var inferDtcgType = path => {
   for (const [suffix, type] of SUFFIX_TYPE_OVERRIDES) if (path.endsWith(suffix)) return type;
   for (const [prefix, type] of require_tokenRegistry.DTCG_TYPE_PREFIXES) if (path.startsWith(prefix)) return type;
-  return "string";
 };
 /**
 * Set a value at a dot-path in a nested object, creating intermediate
@@ -71,8 +79,16 @@ var buildHitExtension = (step, theme) => {
 * Root 3 — W3C Design Tokens (DTCG JSON).
 *
 * Convert a `ThemeTokens` into a structured token tree following the
-* W3C Design Tokens Community Group format. Every leaf node has `$value`
-* (fully resolved) and `$type` (inferred from the token path).
+* W3C Design Tokens Community Group format (2025.10). Every leaf has a
+* `$value`; `$type` is inferred from the token path and **omitted** for opaque
+* tokens with no valid DTCG scalar type (`$type` is optional per spec).
+*
+* **Profile:** this emits **fully-resolved scalar tokens** — `$value`s are
+* concrete (no `{alias}` refs) and composite shapes (typography, shadow,
+* border, transition) are emitted as their individual scalar leaves, not as
+* DTCG composite objects. This is a conformant DTCG profile; richer
+* alias-preserving / composite output is a deferred enhancement (see
+* CONTRIBUTING.md ADR-013).
 *
 * Semantic hit tokens (`semantic.sizing.hit.*`) include a `$extensions`
 * field declaring their coarse-pointer override value, so non-CSS consumers
@@ -98,10 +114,11 @@ var toDTCG = theme => {
   const flat = require_helpers.toFlatTokens(theme);
   const tree = {};
   for (const [path, value] of Object.entries(flat)) {
+    const dtcgType = inferDtcgType(path);
     const token = {
-      $value: value,
-      $type: inferType(path)
+      $value: value
     };
+    if (dtcgType !== void 0) token.$type = dtcgType;
     if (path.startsWith(SEMANTIC_HIT_PREFIX)) {
       const ext = buildHitExtension(path.slice(20), theme);
       if (ext) token.$extensions = ext;

package/dist/dtcg.d.cts

@@ -1,5 +1,5 @@
 
-import { i as ThemeTokens } from "./Types-BiBa17RL.cjs";
+import { a as ThemeTokens } from "./Types-a_sfpbha.cjs";
 
 //#region src/roots/toDTCG.d.ts
 /**
@@ -10,7 +10,12 @@ import { i as ThemeTokens } from "./Types-BiBa17RL.cjs";
  */
 interface DTCGToken {
   $value: string | number;
-  $type: string;
+  /**
+   * W3C DTCG type. **Optional** — omitted for opaque/keyword tokens that have
+   * no valid DTCG scalar type (`$type` is optional in the DTCG spec). There is
+   * no `'string'` DTCG type; emitting one would break conformant importers.
+   */
+  $type?: string;
   $extensions?: Record<string, unknown>;
 }
 /**
@@ -23,8 +28,16 @@ type DTCGTokenTree = DTCGToken | {
  * Root 3 — W3C Design Tokens (DTCG JSON).
  *
  * Convert a `ThemeTokens` into a structured token tree following the
- * W3C Design Tokens Community Group format. Every leaf node has `$value`
- * (fully resolved) and `$type` (inferred from the token path).
+ * W3C Design Tokens Community Group format (2025.10). Every leaf has a
+ * `$value`; `$type` is inferred from the token path and **omitted** for opaque
+ * tokens with no valid DTCG scalar type (`$type` is optional per spec).
+ *
+ * **Profile:** this emits **fully-resolved scalar tokens** — `$value`s are
+ * concrete (no `{alias}` refs) and composite shapes (typography, shadow,
+ * border, transition) are emitted as their individual scalar leaves, not as
+ * DTCG composite objects. This is a conformant DTCG profile; richer
+ * alias-preserving / composite output is a deferred enhancement (see
+ * CONTRIBUTING.md ADR-013).
  *
  * Semantic hit tokens (`semantic.sizing.hit.*`) include a `$extensions`
  * field declaring their coarse-pointer override value, so non-CSS consumers

package/dist/dtcg.d.mts

@@ -1,5 +1,5 @@
 
-import { i as ThemeTokens } from "./Types-BiBa17RL.mjs";
+import { a as ThemeTokens } from "./Types-a_sfpbha.mjs";
 
 //#region src/roots/toDTCG.d.ts
 /**
@@ -10,7 +10,12 @@ import { i as ThemeTokens } from "./Types-BiBa17RL.mjs";
  */
 interface DTCGToken {
   $value: string | number;
-  $type: string;
+  /**
+   * W3C DTCG type. **Optional** — omitted for opaque/keyword tokens that have
+   * no valid DTCG scalar type (`$type` is optional in the DTCG spec). There is
+   * no `'string'` DTCG type; emitting one would break conformant importers.
+   */
+  $type?: string;
   $extensions?: Record<string, unknown>;
 }
 /**
@@ -23,8 +28,16 @@ type DTCGTokenTree = DTCGToken | {
  * Root 3 — W3C Design Tokens (DTCG JSON).
  *
  * Convert a `ThemeTokens` into a structured token tree following the
- * W3C Design Tokens Community Group format. Every leaf node has `$value`
- * (fully resolved) and `$type` (inferred from the token path).
+ * W3C Design Tokens Community Group format (2025.10). Every leaf has a
+ * `$value`; `$type` is inferred from the token path and **omitted** for opaque
+ * tokens with no valid DTCG scalar type (`$type` is optional per spec).
+ *
+ * **Profile:** this emits **fully-resolved scalar tokens** — `$value`s are
+ * concrete (no `{alias}` refs) and composite shapes (typography, shadow,
+ * border, transition) are emitted as their individual scalar leaves, not as
+ * DTCG composite objects. This is a conformant DTCG profile; richer
+ * alias-preserving / composite output is a deferred enhancement (see
+ * CONTRIBUTING.md ADR-013).
  *
  * Semantic hit tokens (`semantic.sizing.hit.*`) include a `$extensions`
  * field declaring their coarse-pointer override value, so non-CSS consumers

package/dist/dtcg.mjs

@@ -1,6 +1,6 @@
 /** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
-import { s as toFlatTokens } from "./helpers-Dz7NfNK6.mjs";
-import { n as DTCG_TYPE_PREFIXES } from "./tokenRegistry-DolhB5Vf.mjs";
+import { s as toFlatTokens } from "./helpers-BXaKe2s3.mjs";
+import { n as DTCG_TYPE_PREFIXES } from "./tokenRegistry-DviyqDeE.mjs";
 
 //#region src/roots/toDTCG.ts
 /**
@@ -23,12 +23,20 @@ import { n as DTCG_TYPE_PREFIXES } from "./tokenRegistry-DolhB5Vf.mjs";
 *
 * Motion leaves (SemanticMotionEntry) overridden separately:
 * - `.duration`     → 'duration'
+*
+* Border / focus line widths resolve to a `dimension` (`1px`, `2px`) but sit
+* under the untyped `semantic.border.` / `semantic.focus.` prefixes:
+* - `.width`        → 'dimension'
+*/
+var SUFFIX_TYPE_OVERRIDES = [[".duration", "duration"], [".fontFamily", "fontFamily"], [".fontSize", "dimension"], [".fontWeight", "fontWeight"], [".lineHeight", "number"], [".letterSpacing", "dimension"], [".width", "dimension"], [".ring.color", "color"]];
+/**
+* Infer the DTCG `$type` for a token path, or `undefined` when the token is
+* opaque (keyword/curve/dash-string) and has no valid DTCG scalar type — in
+* which case `toDTCG` omits `$type` rather than emitting an invalid one.
 */
-var SUFFIX_TYPE_OVERRIDES = [[".duration", "duration"], [".fontFamily", "fontFamily"], [".fontSize", "dimension"], [".fontWeight", "fontWeight"], [".lineHeight", "number"], [".letterSpacing", "dimension"], [".ring.color", "color"]];
-var inferType = path => {
+var inferDtcgType = path => {
   for (const [suffix, type] of SUFFIX_TYPE_OVERRIDES) if (path.endsWith(suffix)) return type;
   for (const [prefix, type] of DTCG_TYPE_PREFIXES) if (path.startsWith(prefix)) return type;
-  return "string";
 };
 /**
 * Set a value at a dot-path in a nested object, creating intermediate
@@ -68,8 +76,16 @@ var buildHitExtension = (step, theme) => {
 * Root 3 — W3C Design Tokens (DTCG JSON).
 *
 * Convert a `ThemeTokens` into a structured token tree following the
-* W3C Design Tokens Community Group format. Every leaf node has `$value`
-* (fully resolved) and `$type` (inferred from the token path).
+* W3C Design Tokens Community Group format (2025.10). Every leaf has a
+* `$value`; `$type` is inferred from the token path and **omitted** for opaque
+* tokens with no valid DTCG scalar type (`$type` is optional per spec).
+*
+* **Profile:** this emits **fully-resolved scalar tokens** — `$value`s are
+* concrete (no `{alias}` refs) and composite shapes (typography, shadow,
+* border, transition) are emitted as their individual scalar leaves, not as
+* DTCG composite objects. This is a conformant DTCG profile; richer
+* alias-preserving / composite output is a deferred enhancement (see
+* CONTRIBUTING.md ADR-013).
 *
 * Semantic hit tokens (`semantic.sizing.hit.*`) include a `$extensions`
 * field declaring their coarse-pointer override value, so non-CSS consumers
@@ -95,10 +111,11 @@ var toDTCG = theme => {
   const flat = toFlatTokens(theme);
   const tree = {};
   for (const [path, value] of Object.entries(flat)) {
+    const dtcgType = inferDtcgType(path);
     const token = {
-      $value: value,
-      $type: inferType(path)
+      $value: value
     };
+    if (dtcgType !== void 0) token.$type = dtcgType;
     if (path.startsWith(SEMANTIC_HIT_PREFIX)) {
       const ext = buildHitExtension(path.slice(20), theme);
       if (ext) token.$extensions = ext;

package/dist/{helpers-CIqeJ8yd.cjs → helpers-BU40JvFA.cjs}

@@ -1,8 +1,19 @@
 /** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
 //#region src/roots/helpers.ts
-/** Check if a value is a token reference like `{core.colors.brand.500}` */
+/**
+* Check if a value is a **pure** token reference like `{core.colors.brand.500}`.
+*
+* A pure ref is a single `{path}` with no interior braces. Compound expressions
+* (`clamp({a}, {b})`) and multi-ref strings (`{a} {b}`) are NOT pure refs — they
+* start `{`/end `}` but carry interior braces, and must go through the compound
+* resolution path instead. Without the interior-brace check `{a} {b}` would be
+* mis-parsed as the single path `a} {b`.
+*/
+var hasInteriorBraces = value => {
+  return value.indexOf("{", 1) !== -1 || value.indexOf("}") !== value.length - 1;
+};
 var isTokenRef = value => {
-  return typeof value === "string" && value.length > 2 && value.startsWith("{") && value.endsWith("}");
+  return typeof value === "string" && value.length > 2 && value.startsWith("{") && value.endsWith("}") && !hasInteriorBraces(value);
 };
 /** Extract the inner path from a token reference: `{core.colors.brand.500}` → `core.colors.brand.500` */
 var extractRefPath = ref => {
@@ -24,6 +35,14 @@ var isPlainObject = value => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
 /**
+* Prototype-chain keys that must never be written from override data —
+* `result['__proto__']` reaches the prototype setter, not an own property.
+* Guards `createTheme`'s public `overrides` against prototype pollution.
+*/
+var isUnsafeMergeKey = key => {
+  return key === "__proto__" || key === "constructor" || key === "prototype";
+};
+/**
 * Recursively merges `overrides` into `base`.
 * - Plain objects are merged recursively.
 * - All other values (primitives, arrays) are replaced.
@@ -34,6 +53,7 @@ var deepMerge = (base, overrides) => {
     ...base
   };
   for (const key of Object.keys(overrides)) {
+    if (isUnsafeMergeKey(key)) continue;
     const baseVal = result[key];
     const overVal = overrides[key];
     if (overVal === void 0) continue;
@@ -114,8 +134,8 @@ var toFlatTokens = (theme, options = {}) => {
   /**
   * Resolve all embedded `{path}` refs in a raw string expression.
   *
-  * Handles both pure refs (`{core.space.4}`) and compound expressions
-  * (`clamp({core.space.4}, {core.space.6}, {core.space.12})`).
+  * Handles both pure refs (`{core.spacing.4}`) and compound expressions
+  * (`clamp({core.spacing.4}, {core.spacing.6}, {core.spacing.12})`).
   */
   const resolveInline = (value, seen, ownerKey) => {
     return value.replace(COMPOUND_REF_RE, (_match, path) => {
@@ -128,7 +148,9 @@ var toFlatTokens = (theme, options = {}) => {
         reportUnresolved(ownerKey, path, "circular reference");
         return `{${path}}`;
       }
-      const resolved = resolveRef(target, new Set(seen).add(path), ownerKey);
+      const childSeen = new Set(seen).add(path);
+      const resolved = resolveRef(target, childSeen, ownerKey);
+      if (typeof resolved === "string" && resolved.includes("{")) return resolveInline(resolved, childSeen, ownerKey);
       return String(resolved);
     });
   };

package/dist/{helpers-Dz7NfNK6.mjs → helpers-BXaKe2s3.mjs}

@@ -1,8 +1,19 @@
 /** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
 //#region src/roots/helpers.ts
-/** Check if a value is a token reference like `{core.colors.brand.500}` */
+/**
+* Check if a value is a **pure** token reference like `{core.colors.brand.500}`.
+*
+* A pure ref is a single `{path}` with no interior braces. Compound expressions
+* (`clamp({a}, {b})`) and multi-ref strings (`{a} {b}`) are NOT pure refs — they
+* start `{`/end `}` but carry interior braces, and must go through the compound
+* resolution path instead. Without the interior-brace check `{a} {b}` would be
+* mis-parsed as the single path `a} {b`.
+*/
+var hasInteriorBraces = value => {
+  return value.indexOf("{", 1) !== -1 || value.indexOf("}") !== value.length - 1;
+};
 var isTokenRef = value => {
-  return typeof value === "string" && value.length > 2 && value.startsWith("{") && value.endsWith("}");
+  return typeof value === "string" && value.length > 2 && value.startsWith("{") && value.endsWith("}") && !hasInteriorBraces(value);
 };
 /** Extract the inner path from a token reference: `{core.colors.brand.500}` → `core.colors.brand.500` */
 var extractRefPath = ref => {
@@ -24,6 +35,14 @@ var isPlainObject = value => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
 /**
+* Prototype-chain keys that must never be written from override data —
+* `result['__proto__']` reaches the prototype setter, not an own property.
+* Guards `createTheme`'s public `overrides` against prototype pollution.
+*/
+var isUnsafeMergeKey = key => {
+  return key === "__proto__" || key === "constructor" || key === "prototype";
+};
+/**
 * Recursively merges `overrides` into `base`.
 * - Plain objects are merged recursively.
 * - All other values (primitives, arrays) are replaced.
@@ -34,6 +53,7 @@ var deepMerge = (base, overrides) => {
     ...base
   };
   for (const key of Object.keys(overrides)) {
+    if (isUnsafeMergeKey(key)) continue;
     const baseVal = result[key];
     const overVal = overrides[key];
     if (overVal === void 0) continue;
@@ -114,8 +134,8 @@ var toFlatTokens = (theme, options = {}) => {
   /**
   * Resolve all embedded `{path}` refs in a raw string expression.
   *
-  * Handles both pure refs (`{core.space.4}`) and compound expressions
-  * (`clamp({core.space.4}, {core.space.6}, {core.space.12})`).
+  * Handles both pure refs (`{core.spacing.4}`) and compound expressions
+  * (`clamp({core.spacing.4}, {core.spacing.6}, {core.spacing.12})`).
   */
   const resolveInline = (value, seen, ownerKey) => {
     return value.replace(COMPOUND_REF_RE, (_match, path) => {
@@ -128,7 +148,9 @@ var toFlatTokens = (theme, options = {}) => {
         reportUnresolved(ownerKey, path, "circular reference");
         return `{${path}}`;
       }
-      const resolved = resolveRef(target, new Set(seen).add(path), ownerKey);
+      const childSeen = new Set(seen).add(path);
+      const resolved = resolveRef(target, childSeen, ownerKey);
+      if (typeof resolved === "string" && resolved.includes("{")) return resolveInline(resolved, childSeen, ownerKey);
       return String(resolved);
     });
   };

package/dist/{index-BuszkWMy.d.mts → index-BmZQVd3G.d.cts}

@@ -1,5 +1,5 @@
 
-import { a as DeepPartial, i as ThemeTokens, r as ThemeBundle, t as ModeOverride } from "./Types-BiBa17RL.mjs";
+import { a as ThemeTokens, i as ThemeBundle, o as DeepPartial, r as ThemeBrief, t as ModeOverride } from "./Types-a_sfpbha.cjs";
 //#region src/baseTheme.d.ts
 /**
  * **Foundation** — Neutral baseline theme.
@@ -85,7 +85,8 @@ declare const createTheme: ({
   baseMode,
   base,
   overrides,
-  alternate
+  alternate,
+  brief
 }?: {
   /**
    * Parent bundle to inherit from. `base`, `baseMode`, and `alternate` all
@@ -104,18 +105,14 @@ declare const createTheme: ({
    * Pass `null` to opt out of any alternate (single-mode theme).
    */
   alternate?: ModeOverride | null;
+  /**
+   * Machine-readable design brief. Inherited from `extends.meta` when omitted.
+   * Orthogonal to tokens — never affects DTCG/CSS output.
+   */
+  brief?: ThemeBrief;
 }) => ThemeBundle;
 //#endregion
 //#region src/themes/bruttal.d.ts
 declare const bruttal: ThemeBundle;
 //#endregion
-//#region src/themes/corporate.d.ts
-declare const corporate: ThemeBundle;
-//#endregion
-//#region src/themes/oca.d.ts
-declare const oca: ThemeBundle;
-//#endregion
-//#region src/themes/ventures.d.ts
-declare const ventures: ThemeBundle;
-//#endregion
-export { createTheme as a, bruttal as i, oca as n, baseTheme as o, corporate as r, darkAlternate as s, ventures as t };
+export { darkAlternate as i, createTheme as n, baseTheme as r, bruttal as t };

package/dist/{index-Djro6G4e.d.cts → index-XZsRrMTF.d.mts}

@@ -1,5 +1,5 @@
 
-import { a as DeepPartial, i as ThemeTokens, r as ThemeBundle, t as ModeOverride } from "./Types-BiBa17RL.cjs";
+import { a as ThemeTokens, i as ThemeBundle, o as DeepPartial, r as ThemeBrief, t as ModeOverride } from "./Types-a_sfpbha.mjs";
 //#region src/baseTheme.d.ts
 /**
  * **Foundation** — Neutral baseline theme.
@@ -85,7 +85,8 @@ declare const createTheme: ({
   baseMode,
   base,
   overrides,
-  alternate
+  alternate,
+  brief
 }?: {
   /**
    * Parent bundle to inherit from. `base`, `baseMode`, and `alternate` all
@@ -104,18 +105,14 @@ declare const createTheme: ({
    * Pass `null` to opt out of any alternate (single-mode theme).
    */
   alternate?: ModeOverride | null;
+  /**
+   * Machine-readable design brief. Inherited from `extends.meta` when omitted.
+   * Orthogonal to tokens — never affects DTCG/CSS output.
+   */
+  brief?: ThemeBrief;
 }) => ThemeBundle;
 //#endregion
 //#region src/themes/bruttal.d.ts
 declare const bruttal: ThemeBundle;
 //#endregion
-//#region src/themes/corporate.d.ts
-declare const corporate: ThemeBundle;
-//#endregion
-//#region src/themes/oca.d.ts
-declare const oca: ThemeBundle;
-//#endregion
-//#region src/themes/ventures.d.ts
-declare const ventures: ThemeBundle;
-//#endregion
-export { createTheme as a, bruttal as i, oca as n, baseTheme as o, corporate as r, darkAlternate as s, ventures as t };
+export { darkAlternate as i, createTheme as n, baseTheme as r, bruttal as t };

package/dist/index.cjs

@@ -2,15 +2,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, {
   value: 'Module'
 });
-const require_createTheme = require('./createTheme-BHGc1IFI.cjs');
+const require_createTheme = require('./createTheme-B7H0xSVp.cjs');
 const require_themes_bruttal = require('./themes/bruttal.cjs');
-const require_themes_corporate = require('./themes/corporate.cjs');
-const require_themes_oca = require('./themes/oca.cjs');
-const require_themes_ventures = require('./themes/ventures.cjs');
 exports.baseTheme = require_createTheme.baseTheme;
 exports.bruttal = require_themes_bruttal.bruttal;
-exports.corporate = require_themes_corporate.corporate;
 exports.createTheme = require_createTheme.createTheme;
-exports.darkAlternate = require_createTheme.darkAlternate;
-exports.oca = require_themes_oca.oca;
-exports.ventures = require_themes_ventures.ventures;
+exports.darkAlternate = require_createTheme.darkAlternate;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 
-import { a as DeepPartial, i as ThemeTokens, n as SemanticTokens, r as ThemeBundle, t as ModeOverride } from "./Types-BiBa17RL.cjs";
-import { a as createTheme, i as bruttal, n as oca, o as baseTheme, r as corporate, s as darkAlternate, t as ventures } from "./index-Djro6G4e.cjs";
+import { a as ThemeTokens, i as ThemeBundle, n as SemanticTokens, o as DeepPartial, r as ThemeBrief, t as ModeOverride } from "./Types-a_sfpbha.cjs";
+import { i as darkAlternate, n as createTheme, r as baseTheme, t as bruttal } from "./index-BmZQVd3G.cjs";
 import { o as ThemeMode } from "./ssrScript-BVysxDws.cjs";
-import { c as ThemeStylesProps, n as ThemeHeadProps } from "./react-BXqSYnmk.cjs";
-export { type DeepPartial, type ModeOverride, type SemanticTokens, type ThemeBundle, type ThemeHeadProps, type ThemeMode, type ThemeStylesProps, type ThemeTokens, baseTheme, bruttal, corporate, createTheme, darkAlternate, oca, ventures };
+import { c as ThemeStylesProps, n as ThemeHeadProps } from "./react-Drr-QSuX.cjs";
+export { type DeepPartial, type ModeOverride, type SemanticTokens, type ThemeBrief, type ThemeBundle, type ThemeHeadProps, type ThemeMode, type ThemeStylesProps, type ThemeTokens, baseTheme, bruttal, createTheme, darkAlternate };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 
-import { a as DeepPartial, i as ThemeTokens, n as SemanticTokens, r as ThemeBundle, t as ModeOverride } from "./Types-BiBa17RL.mjs";
-import { a as createTheme, i as bruttal, n as oca, o as baseTheme, r as corporate, s as darkAlternate, t as ventures } from "./index-BuszkWMy.mjs";
+import { a as ThemeTokens, i as ThemeBundle, n as SemanticTokens, o as DeepPartial, r as ThemeBrief, t as ModeOverride } from "./Types-a_sfpbha.mjs";
+import { i as darkAlternate, n as createTheme, r as baseTheme, t as bruttal } from "./index-XZsRrMTF.mjs";
 import { o as ThemeMode } from "./ssrScript-BVysxDws.mjs";
-import { c as ThemeStylesProps, n as ThemeHeadProps } from "./react-D2J482kx.mjs";
-export { type DeepPartial, type ModeOverride, type SemanticTokens, type ThemeBundle, type ThemeHeadProps, type ThemeMode, type ThemeStylesProps, type ThemeTokens, baseTheme, bruttal, corporate, createTheme, darkAlternate, oca, ventures };
+import { c as ThemeStylesProps, n as ThemeHeadProps } from "./react-BwsjWKmo.mjs";
+export { type DeepPartial, type ModeOverride, type SemanticTokens, type ThemeBrief, type ThemeBundle, type ThemeHeadProps, type ThemeMode, type ThemeStylesProps, type ThemeTokens, baseTheme, bruttal, createTheme, darkAlternate };

package/dist/index.mjs

@@ -1,7 +1,4 @@
 /** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
-import { i as darkAlternate, n as createTheme, r as baseTheme } from "./createTheme-C1r5nJco.mjs";
+import { a as darkAlternate, i as baseTheme, n as createTheme } from "./createTheme-Bm9LVQ4w.mjs";
 import { bruttal } from "./themes/bruttal.mjs";
-import { corporate } from "./themes/corporate.mjs";
-import { oca } from "./themes/oca.mjs";
-import { ventures } from "./themes/ventures.mjs";
-export { baseTheme, bruttal, corporate, createTheme, darkAlternate, oca, ventures };
+export { baseTheme, bruttal, createTheme, darkAlternate };

package/dist/{react-D2J482kx.d.mts → react-BwsjWKmo.d.mts}

@@ -1,9 +1,17 @@
 
-import { n as SemanticTokens, r as ThemeBundle } from "./Types-BiBa17RL.mjs";
+import { i as ThemeBundle, n as SemanticTokens } from "./Types-a_sfpbha.mjs";
 import { a as ResolvedMode, o as ThemeMode, t as ThemeScriptConfig } from "./ssrScript-BVysxDws.mjs";
 import * as React from "react";
 
 //#region src/react.d.ts
+/**
+ * Accepted shapes for the `root` prop: a concrete element, or a ref object.
+ * Prefer the ref form — refs are populated before layout effects run, so the
+ * runtime attaches directly to the target element with no transient attach
+ * to `<html>` on the first render (the element form is `null` during the
+ * first render when read from `ref.current`).
+ */
+type ThemeRootInput = HTMLElement | React.RefObject<HTMLElement | null>;
 /**
  * Props for the `ThemeProvider` component.
  */
@@ -24,7 +32,15 @@ interface ThemeProviderProps {
    *
    * Passing `theme` enables `useTokens()` and `useResolvedTokens()` for all
    * descendants, and automatically injects the CSS Custom Properties `<style>`
-   * tag into the document head (React 19 hoisting).
+   * tag into the document head (React 19 hoisting, deduped by `href`).
+   *
+   * **React version:** auto-injection into `<head>` requires **React 19** style
+   * hoisting. On React 18 the `<style>` renders inline where the provider sits
+   * (not hoisted); use `<ThemeHead>` / `<ThemeStyles>` in your `<head>` for
+   * explicit injection there — but do not also pass `theme` here, since the
+   * href-less `<ThemeHead>`/`<ThemeStyles>` tag does not dedup against this
+   * provider's href-keyed one. The stable `href` only collapses multiple themed
+   * `<ThemeProvider>`s sharing a `themeId` into one tag on 19.
    *
    * @example
    * ```tsx
@@ -75,25 +91,32 @@ interface ThemeProviderProps {
   onModeChange?: (mode: ThemeMode, resolvedMode: ResolvedMode) => void;
   /**
    * Root element to anchor `data-tt-theme` / `data-tt-mode` attributes.
-   * Defaults to `document.documentElement`. Pass a container element for
-   * Storybook isolation or micro-frontend use cases.
+   * Defaults to `document.documentElement`. Pass a container for Storybook
+   * isolation or micro-frontend use cases.
    *
-   * Because the element is often `null` on the first render when passed via
-   * `ref.current`, `root` is reactive: the runtime is recreated once when
-   * it transitions from `undefined` to the actual element.
+   * **Must be paired with `themeId`.** Without a `themeId`, the generated CSS
+   * targets `:root` / `:root[data-tt-mode="dark"]` (the `<html>` element),
+   * while the attributes are written to this element — the alternate mode CSS
+   * would never match. A dev-mode warning fires on this combination.
+   *
+   * **Prefer passing the ref object itself** (`root={rootRef}`): refs are
+   * populated before layout effects, so the runtime attaches directly to the
+   * element. Passing `rootRef.current ?? undefined` also works, but the value
+   * is `null` on the first render, causing one transient attach to `<html>`
+   * before the runtime is recreated on the element.
    *
    * @example
    * ```tsx
    * // Storybook decorator — isolates each story from <html>
    * const rootRef = React.useRef<HTMLDivElement>(null);
    * <div ref={rootRef}>
-   *   <ThemeProvider theme={myTheme} root={rootRef.current ?? undefined}>
+   *   <ThemeProvider theme={myTheme} themeId="story" root={rootRef}>
    *     <Story />
    *   </ThemeProvider>
    * </div>
    * ```
    */
-  root?: HTMLElement;
+  root?: ThemeRootInput;
   children: React.ReactNode;
 }
 /**
@@ -170,11 +193,11 @@ declare const useColorMode: () => UseColorModeResult;
  * inline styles produces silently broken rendering:
  *
  * ```tsx
- * // ✗ WRONG — tokens.colors.brand.main is '{core.colors.brand.main}', not '#FF0000'
- * <div style={{ color: tokens.colors.brand.main }} />
+ * // ✗ WRONG — the leaf is '{core.colors.neutral.1000}' (a ref string), not a CSS color
+ * <div style={{ color: tokens.colors.action.primary.text.default }} />
  *
  * // ✓ CSS consumers — use vars:
- * <div style={{ color: 'var(--tt-color-brand-main)' }} />
+ * <div style={{ color: 'var(--tt-colors-action-primary-text-default)' }} />
  *
  * // ✓ Non-CSS consumers (React Native, canvas) — use useResolvedTokens():
  * const resolved = useResolvedTokens();
@@ -189,8 +212,8 @@ declare const useColorMode: () => UseColorModeResult;
  *
  * const Button = () => {
  *   const tokens = useTokens(); // introspection only
- *   // tokens.colors.action.primary.background.default → '{core.colors.brand.500}'
- *   return <button style={{ background: 'var(--tt-action-primary-background-default)' }} />;
+ *   // tokens.colors.action.primary.background.default → '{core.colors.neutral.1000}'
+ *   return <button style={{ background: 'var(--tt-colors-action-primary-background-default)' }} />;
  * };
  * ```
  */
@@ -210,13 +233,21 @@ declare const useTokens: () => SemanticTokens;
  *
  * ```tsx
  * // ✓ CSS (browser)
- * <div style={{ color: 'var(--tt-color-informational-primary-default)' }} />
+ * <div style={{ color: 'var(--tt-colors-informational-primary-text-default)' }} />
  *
  * // ✓ Non-CSS (React Native, canvas)
  * const resolved = useResolvedTokens();
  * <View style={{ backgroundColor: resolved['semantic.colors.action.primary.background.default'] }} />
  * ```
  *
+ * ### ⚠ CSS-coupled tokens stay unresolved
+ * A registered set of dimensional tokens (model.md §8 — spacing steps, fluid
+ * `text.*.fontSize`, `sizing.hit.*`, `sizing.viewport.*`, `sizing.measure.reading`,
+ * `spacing.gutter.*`) carry CSS-only constructs (`var()`, `calc()`, `clamp()`,
+ * `cqi`, `dvh`, `ch`). This hook returns those **as-is** — they are not usable
+ * outside a CSS engine. Colors, opacity, z-index, font weights/leading and
+ * other scalar tokens resolve to plain raw values and are safe everywhere.
+ *
  * Requires `<ThemeProvider theme={...}>`.
  *
  * @example
@@ -288,6 +319,13 @@ interface ThemeStylesProps {
   themeId?: string;
   /** CSP nonce for the inline style tag. */
   nonce?: string;
+  /**
+   * Emit the `@media (prefers-color-scheme)` fallback block (themeId-less
+   * bundles only). Default `true`. Set `false` when the app's `defaultMode`
+   * is a fixed `'light'`/`'dark'` rather than `'system'` — `<ThemeHead>`
+   * derives this automatically from its `defaultMode`.
+   */
+  systemModeFallback?: boolean;
 }
 /**
  * Renders an inline `<style>` tag with all CSS Custom Properties for a theme
@@ -301,6 +339,10 @@ interface ThemeStylesProps {
  * `dangerouslySetInnerHTML` is safe: content comes exclusively from
  * `toCssVars()` (a pure internal function) — no user input is interpolated.
  *
+ * Renders a plain inline `<style>` where you place it (put it in `<head>`).
+ * Do **not** also pass `theme` to `<ThemeProvider>` — that injects a second
+ * copy; pass `theme` to the head component only (see README SSR section).
+ *
  * @example
  * ```tsx
  * // SSR escape hatch — no themeId needed for canonical 1-theme model
@@ -334,7 +376,8 @@ interface ThemeStylesProps {
 declare const ThemeStyles: ({
   theme,
   themeId,
-  nonce
+  nonce,
+  systemModeFallback
 }: ThemeStylesProps) => any;
 /**
  * Props for the `ThemeHead` component.