origam 2.18.16 → 2.18.18

package/dist/src/components/List/OrigamListItem.vue

@@ -685,6 +685,13 @@ defineExpose({
 		}
 
 		&__overlay {
+			// ⛔ C2 (#597, deja tranche en PR #586) — `--origam-list-item__overlay
+			// ---background-color` et `---transition-timing-function` restent NON
+			// DECLARES, a dessein : leur second echelon
+			// (`--origam-list__item---overlay-*`) est, lui, declare et type
+			// (`TTokenName`). Declarer le premier echelon a `:root` le figerait et
+			// MASQUERAIT DEFINITIVEMENT ce crochet de theming public. La garde
+			// compare des noms, pas des chaines de repli : faux positif, pas dette.
 			background-color: var(--origam-list-item__overlay---background-color, var(--origam-list__item---overlay-background-color, currentColor));
 			border-radius: var(--origam-list-item__overlay---border-radius, inherit);
 			opacity: var(--origam-list-item__overlay---opacity, var(--origam-list__item---overlay-opacity, 0));

package/dist/src/components/List/OrigamListSubheader.vue

@@ -133,6 +133,11 @@ defineExpose({
 		background: inherit;
 		color: var(--origam-list-subheader---color, var(--origam-color__text---secondary));
 		display: flex;
+		// ⛔ C2 (#597, deja tranche en PR #586) — `--origam-list-subheader
+		// ---font-size` reste NON DECLARE, a dessein : il est ECRIT PAR LE PARENT
+		// (`OrigamList.vue`, variante `nav`) et son second echelon
+		// `--origam-list__subheader---font-size` est declare et type. Le declarer a
+		// `:root` masquerait definitivement ce second crochet.
 		font-size: var(--origam-list-subheader---font-size, var(--origam-list__subheader---font-size, 0.875rem));
 		font-weight: var(--origam-list-subheader---font-weight, 400);
 		line-height: var(--origam-list-subheader---line-height, 1.375rem);

package/dist/src/components/Pagination/OrigamPagination.vue

@@ -629,12 +629,25 @@ defineExpose({
 		}
 
 		&--colored {
+			// ⛔ #596 — these two READ the `--primary` state tokens, not a
+			// `-colored` suffix. The sheets have always declared
+			// `--origam-pagination--primary---{background-color,color}` with
+			// exactly the values below as their value, while this block read
+			// `--origam-pagination---{background-color,color}-colored` — two
+			// grammars whose names never coincide, so the declaration was
+			// dormant and the fallback did all the work (the #550 defect
+			// shape). Renaming the READ side rather than duplicating the
+			// declaration keeps ONE grammar — `--{state}---{property}` — and
+			// matches `--origam-pagination--primary---box-shadow` three lines
+			// below, which this file already reads correctly. Rendering is
+			// unchanged: declared value == the fallback it replaces, in light
+			// and in dark.
 			--bg-base: var(
-				--origam-pagination---background-color-colored,
+				--origam-pagination--primary---background-color,
 				var(--origam-color__action--primary---bg)
 			);
 			--fg-base: var(
-				--origam-pagination---color-colored,
+				--origam-pagination--primary---color,
 				var(--origam-color__action--primary---fg)
 			);
 
@@ -651,6 +664,20 @@ defineExpose({
 
 		// Hover state — derived: 20 % darker than --bg-base.
 		// Consumer can override via --origam-pagination---background-color-hover.
+		//
+		// ⛔ #596 — `--origam-pagination---color-hover` STAYS UNDECLARED in the
+		// token sheets, deliberately. Its fallback is `var(--fg-base)`, and
+		// `--fg-base` is synthesised PER INSTANCE on `.origam-pagination`
+		// itself (line ~800, and repointed by `&--colored`). A custom
+		// property's computed value is its specified value with `var()`
+		// ALREADY substituted ON THE DECLARING ELEMENT — so a `:root`
+		// declaration of `var(--fg-base)` would be substituted where
+		// `--fg-base` does not exist, become guaranteed-invalid, and every
+		// read would fall straight back to the inline fallback again. The
+		// rendering would be byte-identical and the guard would go green on a
+		// channel that does nothing: a lie, not a fix. It therefore stays in
+		// `baseline/token-var-channels.json` as a known false positive — the
+		// guard compares NAMES, not fallback chains.
 		:deep(.origam-btn:hover:not(.origam-btn--active)) {
 			--origam-btn---background-color: var(
 				--origam-pagination---background-color-hover,
@@ -683,6 +710,41 @@ defineExpose({
 
 		// Active state — derived: 30 % darker than --bg-base.
 		// Consumer can override via the matching `is-active` vars.
+		//
+		// ⛔ #596 — of the four `--item--is-active---*` channels read below,
+		// only `---border-color` is declared in the token sheets (its fallback
+		// is the plain literal `transparent`). The other three STAY UNDECLARED
+		// on purpose, each for a measured reason:
+		//
+		//   • `---color` falls back to `var(--fg-base)` — synthesised per
+		//     instance, so a `:root` declaration is guaranteed-invalid and
+		//     inert (same mechanism as the hover block above). Worse, the
+		//     sheets carry a DORMANT near-twin under the other grammar,
+		//     `--origam-pagination__item---active-color:
+		//     var(--origam-color__action--primary---fg)` = WHITE. "Renaming"
+		//     that declaration onto this read — the #550 reflex — would paint
+		//     the active page label white on the untinted (transparent /
+		//     white) surface of uncolored mode: invisible. Exactly the
+		//     BottomNav trap: a name that reads right and inverts the render.
+		//
+		//   • `---background-color` is read TWICE with two DIFFERENT fallbacks
+		//     — `color-mix(… var(--bg-base), black 30%)` here, and
+		//     `var(--origam-color__neutral---200, #e6e6e6)` on the overlay
+		//     below. No single declaration preserves both, and its dormant
+		//     twin `--origam-pagination__item---active-background-color` is
+		//     `action--primary---bg`, which matches neither. The overlay value
+		//     is the one a user-reported defect was fixed to (652a770e, then
+		//     cb10d654) — re-pointing it is a design decision, not a wiring
+		//     one.
+		//
+		//   • `---active-overlay-opacity` is likewise read twice, with `1` on
+		//     the uncolored branch and `0` on the colored one — opposite
+		//     defaults by design, so no root value can hold both (its dormant
+		//     twin says `0.12`, which is neither).
+		//
+		// All three stay in `baseline/token-var-channels.json`. A theme can
+		// still set them: an override lands on an element inside the
+		// component, where `--bg-base` / `--fg-base` DO resolve.
 		&__item--is-active :deep(.origam-btn) {
 			--origam-btn---background-color: var(
 				--origam-pagination__item--is-active---background-color,

package/dist/src/components/Toolbar/OrigamToolbar.vue

@@ -229,6 +229,22 @@ defineExpose({
 		// the toolbar's own gutter (16 px) with whatever the layout
 		// reserved on each side (defaults to 0 when no layout item is
 		// present, so the standalone case still gets the 16 px gutter).
+		//
+		// ⛔ #596 — `--origam-layout---position-{left,right}` STAY UNDECLARED
+		// in the token sheets, deliberately. They are not theme tokens: they
+		// are runtime MEASUREMENTS, written as INLINE STYLES on the layout
+		// root by `useCreateLayout`'s `layoutStyles` (and on main by
+		// `mainStyles`) from `mainRect`, via `LAYOUT_POSITION_VARS` — see
+		// `composables/Commons/createLayout.composable.ts`. Descendants
+		// inherit them from that element, which is how this toolbar receives
+		// them. Declaring them at `:root` would publish a themeable channel
+		// that the layout's inline style overrides on every real instance —
+		// dead by construction — and `LAYOUT_DEFAULT_OFFSET` already is the
+		// `0px` written below. The guard flags them only because it compares
+		// names against the SHEETS; `OrigamMain` reads the same four vars and
+		// is absent from the baseline solely because it declares its own
+		// `0px` block locally. They stay in
+		// `baseline/token-var-channels.json` as known false positives.
 		padding-inline-start: calc(
 			var(--origam-toolbar---padding-inline, 16px) +
 			var(--origam-layout---position-left, 0px)
@@ -267,6 +283,28 @@ defineExpose({
 		border-end-start-radius: var(--origam-toolbar---border-end-start-radius, 0);
 
 		background: var(--origam-toolbar---background);
+		// ⛔ #596 — `--origam-appbar---backdrop-filter` STAYS UNDECLARED in the
+		// token sheets, and that is a NAMING decision left open on purpose,
+		// not an oversight. Measured: the DS's canonical AppBar family is
+		// spelt with a hyphen — `--origam-app-bar---*`, 11 tokens declared in
+		// all four sheets and listed in `TTokenName`, every one of them
+		// DORMANT because `OrigamAppBar.vue` contains no `var(--origam-…)` at
+		// all and delegates its whole surface to this component. This read
+		// uses a THIRD spelling, `--origam-appbar---`, which is also the
+		// namespace `packages/marketing` adopted locally (7 themes set
+		// `--origam-appbar---bg`, read by `marketing/src/layouts/default.vue`;
+		// 5 of them additionally set `--origam-appbar---backdrop-filter`, and
+		// it does reach this line today).
+		// Declaring `none` here would engrave a SECOND grammar for one
+		// component into the public token surface, three lines from the
+		// `--origam-app-bar---*` block. The two defensible renames —
+		// `--origam-app-bar---backdrop-filter` (matches the authoring intent
+		// and marketing's naming) or `--origam-toolbar---backdrop-filter`
+		// (matches the component that actually reads it, per the
+		// `--origam-{component}---{property}` rule) — both break the 5
+		// marketing themes unless they move in the same commit, i.e. a
+		// cross-package decision. Left in `baseline/token-var-channels.json`
+		// until that call is made.
 		backdrop-filter: var(--origam-appbar---backdrop-filter, none);
 		-webkit-backdrop-filter: var(--origam-appbar---backdrop-filter, none);
 		box-shadow: var(--origam-toolbar---box-shadow);
@@ -471,6 +509,26 @@ defineExpose({
 		//
 		// Shape: rounded SQUARE (8 px), overrides Btn's default
 		// `&--icon { border-radius: 50% }`.
+		//
+		// ⛔ #596 — the two DERIVED channels,
+		// `--origam-toolbar---btn-background-color-{hover,active}`, STAY
+		// UNDECLARED in the token sheets. Their fallbacks are
+		// `color-mix(in srgb, var(--btn-bg-base), black {20,30}%)`, and
+		// `--btn-bg-base` is synthesised PER INSTANCE at the top of this block
+		// from `--origam-toolbar---btn-background-color` (which #596 DID
+		// declare, its fallback being the plain literal `transparent`). A
+		// custom property's computed value is its specified value with `var()`
+		// already substituted ON THE DECLARING ELEMENT, so a `:root`
+		// declaration of that `color-mix()` would be substituted where
+		// `--btn-bg-base` does not exist → guaranteed-invalid → every read
+		// falls back to the inline fallback anyway. Identical rendering, green
+		// guard, dead channel: a lie, not a fix. Freezing them to a static
+		// colour instead would be worse — it would sever the derivation from
+		// whatever base colour the consumer sets, which is the whole point of
+		// the block above. They stay in `baseline/token-var-channels.json` as
+		// known false positives; the guard compares NAMES, not fallback
+		// chains. A theme overriding them on the toolbar element itself (or
+		// deeper) still works, because `--btn-bg-base` resolves there.
 		:deep(.origam-btn:not(:hover):not(.origam-btn--active)) {
 			--origam-btn---background-color: var(--btn-bg-base);
 			--origam-btn---color: var(--btn-fg-base);

package/dist/src/composables/Commons/defaults.composable.d.ts

@@ -1,5 +1,56 @@
 import { type MaybeRefOrGetter, type Ref } from 'vue';
 import type { IDefault } from '../../interfaces/DefaultsProvider/defaults-provider.interface';
+/*********************************************************
+ * POURQUOI `useDefaults` RESTE, sans aucun appelant interne (#544)
+ *
+ * @description
+ * ⛔ TRANCHE PAR LA MESURE, 2026-09-29 — NE PAS ROUVRIR. #544 le classait
+ * « doublon du resolveur ADR-005, plus aucun appelant, a retirer ». Zero
+ * appelant est exact : les 40 derniers sont partis sous #363, et un grep dans
+ * `packages/ds/src` ne remonte que des mentions en commentaire. La conclusion,
+ * elle, est FAUSSE — ce n'est pas un doublon.
+ *
+ * @description
+ * `installThemePropsResolver` a une limitation STRUCTURELLE, documentee dans
+ * `theme-props-resolver.composable.ts` (section « Known limitation »). Ce n'est
+ * pas un oubli mais le sequencement de Vue : le hook ecrit dans `beforeCreate`,
+ * qui s'execute APRES le retour de `setup()`. Un prop lu UNE FOIS,
+ * SYNCHRONEMENT, au top level de `setup()` — hors `computed()`,
+ * `watchEffect()` ou fonction de rendu — capture donc la valeur d'AVANT le
+ * patch : le theme ne l'atteint jamais, et rien n'avertit.
+ *
+ * @description
+ * `useDefaults` n'a PAS cette lacune : le getter de son `computed` s'evalue a
+ * l'acces `.value`, a n'importe quel instant, la ref de defauts etant deja
+ * injectee au moment ou `setup()` tourne. C'est donc le SEUL echappatoire pour
+ * un prop qui doit etre lu tot — precisement le piege qui avait casse les props
+ * thematises de 16 composants a travers `useLink` et `useVModel`, jusqu'a ce
+ * que les deux soient rendus paresseux.
+ *
+ * @description
+ * S'y ajoute une surface publique reelle : `useDefaults` a une page de doc
+ * dediee (`packages/docs/composables/useDefaults.md`) et est cite par
+ * `docs/guide/composables.md` et `docs/composables/Commons.md`. C'est
+ * exactement le controle que #544 reclamait, et qui avait deja evite une
+ * suppression fautive sur `useCountdown` et `provideLocale`.
+ *
+ * @description
+ * ⚠️ La lacune est EPINGLEE PAR UNE PAIRE APPARIEE de tests, qui est la preuve
+ * executable que ce composable n'est pas redondant —
+ * `packages/tests/TU/origam/setup-level-prop-reads.spec.ts` :
+ *   it('WITHOUT useDefaults, a value read eagerly in setup() misses the theme')
+ *   it('WITH useDefaults, the same eager read sees the theme')
+ * La spec cite meme un cas reel du catalogue :
+ * `useClipboard({ feedbackDuration: props.feedbackDuration })` dans
+ * `OrigamClipboard`. `probe/preexisting-eager-reads.spec.ts` couvre le meme axe.
+ * Retirer `useDefaults` retire le temoin, donc la preuve.
+ *
+ * @description
+ * ⛔ Et le rayon d'action est large : 35 fichiers sous `packages/tests/TU`
+ * referencent `useDefaults` (mesure, 2026-09-29). Une note anterieure de session
+ * avancait « 3 specs, 23 tests » — chiffre de memoire, FAUX, et c'est exactement
+ * le genre d'affirmation non remesuree qui a fait ouvrir #544.
+ ********************************************************/
 /**
  * Component-side hook: resolve `props` against the closest DefaultsProvider.
  *

package/dist/src/composables/DataTable/headers.composable.d.ts

@@ -39,10 +39,10 @@ export declare function createHeaders(props: IDataTableHeaderProps, options?: {
         sort?: TDataTableCompareFunction | undefined;
         filter?: import("../../types").TFilterFunction | undefined;
         align?: (import("../../enums").ALIGN.START | import("../../enums").ALIGN.END | import("../../enums").ALIGN.CENTER) | undefined;
-        mobile?: boolean | undefined;
         headerProps?: any;
         cellProps?: import("../../types").TDataTableHeaderCell | undefined;
         sortRaw?: TDataTableCompareFunction | undefined;
+        mobile?: boolean | undefined;
     }[][], IInternalDataTableHeader[][] | {
         key: string | null;
         value: import("../../types").TSelectItemKey | null;
@@ -62,10 +62,10 @@ export declare function createHeaders(props: IDataTableHeaderProps, options?: {
         sort?: TDataTableCompareFunction | undefined;
         filter?: import("../../types").TFilterFunction | undefined;
         align?: (import("../../enums").ALIGN.START | import("../../enums").ALIGN.END | import("../../enums").ALIGN.CENTER) | undefined;
-        mobile?: boolean | undefined;
         headerProps?: any;
         cellProps?: import("../../types").TDataTableHeaderCell | undefined;
         sortRaw?: TDataTableCompareFunction | undefined;
+        mobile?: boolean | undefined;
     }[][]>;
     columns: Ref<{
         key: string | null;
@@ -86,10 +86,10 @@ export declare function createHeaders(props: IDataTableHeaderProps, options?: {
         sort?: TDataTableCompareFunction | undefined;
         filter?: import("../../types").TFilterFunction | undefined;
         align?: (import("../../enums").ALIGN.START | import("../../enums").ALIGN.END | import("../../enums").ALIGN.CENTER) | undefined;
-        mobile?: boolean | undefined;
         headerProps?: any;
         cellProps?: import("../../types").TDataTableHeaderCell | undefined;
         sortRaw?: TDataTableCompareFunction | undefined;
+        mobile?: boolean | undefined;
     }[], IInternalDataTableHeader[] | {
         key: string | null;
         value: import("../../types").TSelectItemKey | null;
@@ -109,10 +109,10 @@ export declare function createHeaders(props: IDataTableHeaderProps, options?: {
         sort?: TDataTableCompareFunction | undefined;
         filter?: import("../../types").TFilterFunction | undefined;
         align?: (import("../../enums").ALIGN.START | import("../../enums").ALIGN.END | import("../../enums").ALIGN.CENTER) | undefined;
-        mobile?: boolean | undefined;
         headerProps?: any;
         cellProps?: import("../../types").TDataTableHeaderCell | undefined;
         sortRaw?: TDataTableCompareFunction | undefined;
+        mobile?: boolean | undefined;
     }[]>;
     sortFunctions: Ref<Record<string, TDataTableCompareFunction>, Record<string, TDataTableCompareFunction>>;
     sortRawFunctions: Ref<Record<string, TDataTableCompareFunction>, Record<string, TDataTableCompareFunction>>;

package/dist/src/consts/EmptyState/empty-state.const.d.ts

@@ -1,6 +1,5 @@
-import type { TIntent } from '../../types/Commons/intent.type';
-import type { TEmptyStateAlign, TEmptyStatePreset, TEmptyStateSize } from '../../types/EmptyState/empty-state.type';
-import type { TIcon } from '../../types/Icon/icon.type';
+import type { IEmptyStatePresetConfig } from "../../interfaces";
+import type { TEmptyStateAlign, TEmptyStatePreset, TEmptyStateSize } from '../../types';
 /**
  * Closed list of valid `preset` values for `<OrigamEmptyState>`.
  * Exposed so stories / consumers can iterate the matrix without
@@ -15,17 +14,4 @@ export declare const EMPTY_STATE_SIZES: ReadonlyArray<TEmptyStateSize>;
  * Closed list of valid `align` values.
  */
 export declare const EMPTY_STATE_ALIGNS: ReadonlyArray<TEmptyStateAlign>;
-/**
- * Per-preset bundle: default icon + semantic intent.
- *
- * Consumers can override either side at the prop level (`icon` and
- * `iconColor`) without leaving the preset — the preset is the
- * "starting point", not a lock. The map is intentionally a plain
- * object so brand consumers can extend it through a defaults provider
- * in the future without touching the type.
- */
-export interface IEmptyStatePresetConfig {
-    icon: TIcon;
-    intent: TIntent;
-}
 export declare const EMPTY_STATE_PRESET_CONFIG: Record<TEmptyStatePreset, IEmptyStatePresetConfig>;

package/dist/src/interfaces/Commons/installed-theme.interface.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/interfaces/Commons/installed-theme.interface.d.ts

@@ -0,0 +1,26 @@
+import type { TModeResolved } from "../../types";
+/**
+ * Summary of one installed brand theme, derived from the `IOrigamTheme[]`
+ * objects passed to `createOrigam({ themes })`. Several `IOrigamTheme` objects
+ * may share the same `name` (one per mode); they are collapsed into a single
+ * entry whose `modes` lists every concrete mode that brand was installed for.
+ *
+ * Consumers (e.g. a theme switcher) map over this list instead of hard-coding
+ * the available brands — the list is the single source of truth for "what was
+ * installed".
+ */
+export interface IInstalledTheme {
+    /** Brand name, applied as `data-theme="<name>"`. */
+    name: string;
+    /** Concrete modes this brand ships (`'light'` / `'dark'`). */
+    modes: TModeResolved[];
+    /**
+     * Human-readable label for UI. Defaults to `name` when no installed object
+     * for this brand provided a `label`.
+     */
+    label: string;
+    /** Short description for UI, when an installed object provided one. */
+    description?: string;
+    /** CSS background for a brand swatch preview, when provided. */
+    swatch?: string;
+}

package/dist/src/interfaces/Commons/semantic-tree.interface.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/interfaces/Commons/semantic-tree.interface.d.ts

@@ -0,0 +1,30 @@
+import type { TSemanticLeaf } from "../../types";
+export interface ISemanticTree {
+    [key: string]: TSemanticLeaf | ISemanticTree;
+}
+/**
+ * Structured token-configuration bucket — THE way to author a theme's global
+ * design tokens (the JSON that generates every global `--origam-*` variable).
+ *
+ * Each key is a friendly token GROUP whose nested tree resolves to the matching
+ * `--origam-*` namespace through the shared naming grammar:
+ *   - `color`   → `--origam-color-*`   (`color.surface.default`, `color.text.primary`, `color.action.primary.bg`, …)
+ *   - `rounded` → `--origam-radius-*`  (`rounded.sm`, `rounded.md`, `rounded.lg`, …)
+ *   - `border`  → `--origam-border-*`  (`border.width.thin`, …)
+ *   - `typo`    → `--origam-font-*`    (`typo.family.sans`, `typo.size.md`, `typo.weight.bold`, …)
+ *   - `shadow`  → `--origam-shadow-*`  (`shadow.sm`, `shadow.md`, …)
+ *   - `spacing` → `--origam-space-*`   (`spacing.4`, `spacing.12`, …)
+ *   - `motion`  → `--origam-motion-*`  (`motion.duration.fast`, `motion.easing.standard`, …)
+ *
+ * A leaf value is free-form CSS for its slot (a color slot also accepts a
+ * gradient). Plain JSON — fully serialisable for Theme-Builder round-trips.
+ */
+export interface IThemeVars {
+    color?: ISemanticTree;
+    rounded?: ISemanticTree;
+    border?: ISemanticTree;
+    typo?: ISemanticTree;
+    shadow?: ISemanticTree;
+    spacing?: ISemanticTree;
+    motion?: ISemanticTree;
+}

package/dist/src/interfaces/Commons/theme.interface.d.ts

@@ -1,5 +1,5 @@
 import type { Ref } from 'vue';
-import type { IThemeVars } from '../../types/Commons/semantic-tree.type';
+import type { IThemeVars } from './semantic-tree.interface';
 import type { TThemeVars } from '../../types/Commons/token-tree.type';
 import type { TMode, TTheme } from '../../types/Commons/theme.type';
 import type { IDefault } from '../DefaultsProvider/defaults-provider.interface';

package/dist/src/interfaces/EmptyState/empty-state.interface.d.ts

@@ -3,6 +3,19 @@ import type { ITypographyProps } from '../Commons/typography.interface';
 import type { TEmptyStateAlign, TEmptyStatePreset, TEmptyStateSize } from '../../types/EmptyState/empty-state.type';
 import type { TIcon } from '../../types/Icon/icon.type';
 import type { TIntent } from '../../types/Commons/intent.type';
+/**
+ * Per-preset bundle: default icon + semantic intent.
+ *
+ * Consumers can override either side at the prop level (`icon` and
+ * `iconColor`) without leaving the preset — the preset is the
+ * "starting point", not a lock. The map is intentionally a plain
+ * object so brand consumers can extend it through a defaults provider
+ * in the future without touching the type.
+ */
+export interface IEmptyStatePresetConfig {
+    icon: TIcon;
+    intent: TIntent;
+}
 /**
  * Props for `<OrigamEmptyState>` — placeholder shown when a list, table
  * or collection has nothing to render.

package/dist/src/interfaces/index.cjs

@@ -784,6 +784,17 @@ Object.keys(_intersect).forEach(function (key) {
     }
   });
 });
+var _installedTheme = require("./Commons/installed-theme.interface.cjs");
+Object.keys(_installedTheme).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _installedTheme[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _installedTheme[key];
+    }
+  });
+});
 var _item = require("./Commons/item.interface.cjs");
 Object.keys(_item).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -993,6 +1004,17 @@ Object.keys(_scroll).forEach(function (key) {
     }
   });
 });
+var _semanticTree = require("./Commons/semantic-tree.interface.cjs");
+Object.keys(_semanticTree).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _semanticTree[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _semanticTree[key];
+    }
+  });
+});
 var _size = require("./Commons/size.interface.cjs");
 Object.keys(_size).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/dist/src/interfaces/index.d.ts

@@ -69,6 +69,7 @@ export * from './Commons/group.interface';
 export * from './Commons/hotkey.interface';
 export * from './Commons/hover.interface';
 export * from './Commons/intersect.interface';
+export * from './Commons/installed-theme.interface';
 export * from './Commons/item.interface';
 export * from './Commons/justify.interface';
 export * from './Commons/layout.interface';
@@ -88,6 +89,7 @@ export * from './Commons/ripple.interface';
 export * from './Commons/rounded.interface';
 export * from './Commons/router.interface';
 export * from './Commons/scroll.interface';
+export * from './Commons/semantic-tree.interface';
 export * from './Commons/size.interface';
 export * from './Commons/stack.interface';
 export * from './Commons/state-effect.interface';

package/dist/src/interfaces/index.js

@@ -69,6 +69,7 @@ export * from "./Commons/group.interface.js";
 export * from "./Commons/hotkey.interface.js";
 export * from "./Commons/hover.interface.js";
 export * from "./Commons/intersect.interface.js";
+export * from "./Commons/installed-theme.interface.js";
 export * from "./Commons/item.interface.js";
 export * from "./Commons/justify.interface.js";
 export * from "./Commons/layout.interface.js";
@@ -88,6 +89,7 @@ export * from "./Commons/ripple.interface.js";
 export * from "./Commons/rounded.interface.js";
 export * from "./Commons/router.interface.js";
 export * from "./Commons/scroll.interface.js";
+export * from "./Commons/semantic-tree.interface.js";
 export * from "./Commons/size.interface.js";
 export * from "./Commons/stack.interface.js";
 export * from "./Commons/state-effect.interface.js";

package/dist/src/types/Commons/installed-theme.type.d.ts

@@ -1,31 +1,6 @@
-import type { TModeResolved } from './theme.type';
-/**
- * Summary of one installed brand theme, derived from the `IOrigamTheme[]`
- * objects passed to `createOrigam({ themes })`. Several `IOrigamTheme` objects
- * may share the same `name` (one per mode); they are collapsed into a single
- * entry whose `modes` lists every concrete mode that brand was installed for.
- *
- * Consumers (e.g. a theme switcher) map over this list instead of hard-coding
- * the available brands — the list is the single source of truth for "what was
- * installed".
- */
-export interface TInstalledTheme {
-    /** Brand name, applied as `data-theme="<name>"`. */
-    name: string;
-    /** Concrete modes this brand ships (`'light'` / `'dark'`). */
-    modes: TModeResolved[];
-    /**
-     * Human-readable label for UI. Defaults to `name` when no installed object
-     * for this brand provided a `label`.
-     */
-    label: string;
-    /** Short description for UI, when an installed object provided one. */
-    description?: string;
-    /** CSS background for a brand swatch preview, when provided. */
-    swatch?: string;
-}
+import type { IInstalledTheme } from "../../interfaces/Commons/installed-theme.interface";
 /**
  * The full installed-themes list provided by `createOrigam` and read back via
  * `useInstalledThemes()`.
  */
-export type TInstalledThemes = TInstalledTheme[];
+export type TInstalledThemes = IInstalledTheme[];

package/dist/src/types/Commons/semantic-tree.type.d.ts

@@ -17,32 +17,3 @@
  * round-trip it without losing fidelity.
  */
 export type TSemanticLeaf = string | number;
-export interface ISemanticTree {
-    [key: string]: TSemanticLeaf | ISemanticTree;
-}
-/**
- * Structured token-configuration bucket — THE way to author a theme's global
- * design tokens (the JSON that generates every global `--origam-*` variable).
- *
- * Each key is a friendly token GROUP whose nested tree resolves to the matching
- * `--origam-*` namespace through the shared naming grammar:
- *   - `color`   → `--origam-color-*`   (`color.surface.default`, `color.text.primary`, `color.action.primary.bg`, …)
- *   - `rounded` → `--origam-radius-*`  (`rounded.sm`, `rounded.md`, `rounded.lg`, …)
- *   - `border`  → `--origam-border-*`  (`border.width.thin`, …)
- *   - `typo`    → `--origam-font-*`    (`typo.family.sans`, `typo.size.md`, `typo.weight.bold`, …)
- *   - `shadow`  → `--origam-shadow-*`  (`shadow.sm`, `shadow.md`, …)
- *   - `spacing` → `--origam-space-*`   (`spacing.4`, `spacing.12`, …)
- *   - `motion`  → `--origam-motion-*`  (`motion.duration.fast`, `motion.easing.standard`, …)
- *
- * A leaf value is free-form CSS for its slot (a color slot also accepts a
- * gradient). Plain JSON — fully serialisable for Theme-Builder round-trips.
- */
-export interface IThemeVars {
-    color?: ISemanticTree;
-    rounded?: ISemanticTree;
-    border?: ISemanticTree;
-    typo?: ISemanticTree;
-    shadow?: ISemanticTree;
-    spacing?: ISemanticTree;
-    motion?: ISemanticTree;
-}