origam 2.18.18 → 2.18.19

package/dist/src/consts/Commons/variant-preset.const.d.ts

@@ -0,0 +1,60 @@
+import type { TVariantPresetRegistry } from '../../types/Commons/variant-preset.type';
+/*********************************************************
+ * VARIANT_PROP_KEY
+ *
+ * @description
+ * Le nom du prop discriminant qu'une table de presets indexe. ADR-005
+ * n'en prevoit qu'un, et le resolveur a besoin de le nommer pour deux
+ * raisons distinctes.
+ *
+ * @description
+ * ⛔ C'EST AUSSI LA GARDE ANTI-RECURSION. Le getter installe sur un prop
+ * lit `props.variant` pour savoir quelle entree de la table consulter. Si
+ * ce getter etait AUSSI installe sur `variant` lui-meme, cette lecture se
+ * rappellerait indefiniment. Un preset ne pose jamais `variant` — il n'y
+ * a donc rien a resoudre pour cette cle, et `patchThemedPropSlot` la
+ * saute explicitement sur le canal preset.
+ ********************************************************/
+export declare const VARIANT_PROP_KEY = "variant";
+/*********************************************************
+ * VARIANT_PRESETS
+ *
+ * @description
+ * Les tables de presets que le DS LIVRE, par nom kebab de composant. Un
+ * theme les surcharge via `IOrigamTheme.variants` (ADR-005 D4) ; il ne les
+ * constitue pas.
+ *
+ * @description
+ * ⛔ VIDE A DESSEIN DANS CE LOT, et ce n'est pas du code mort. Le lot 1
+ * d'ADR-005 livre le MECANISME (type partage, rang dans le resolveur,
+ * canal `theme.variants`) et aucune conversion de composant : chaque
+ * composant arrive avec son propre lot, parce qu'aucun ne se convertit
+ * mecaniquement. Mesure a l'appui (2026-09-30), la taxonomie « famille A »
+ * de D5 est optimiste sur trois des quatre composants qu'elle liste :
+ * @description
+ * - `OrigamKbd` — ses regles de variant posent des PROPRIETES CUSTOM que
+ *   `key-surface` consomme sur la racine ET sur les descendants `__key`
+ *   (`&--variant-outlined &__key`). Un prop de racine emet
+ *   `background-color`, qui n'herite pas jusqu'a `__key` ; et la
+ *   declaration de `key-surface` siege a (0,2,0), donc une valeur de
+ *   preset TOKENISEE lui perdrait. Conversion fidele = revoir par ou
+ *   `key-surface` recoit sa couleur.
+ * - `OrigamBtnGroup` — recopie `--origam-btn-group---border-width` dans
+ *   une propriete custom qui alimente un `calc()` de rayon interieur.
+ *   Inexprimable en prop de racine.
+ * - `OrigamBlockquote` — `padding-inline-start: calc(var(--…) + var(--…))`
+ *   et des regles imbriquees sur `__body` / `__attribution`.
+ * @description
+ * Seul `OrigamBtn` ne peint que des proprietes de racine — mais il depend
+ * de `IOpacityProps` / `IBackdropProps` (Q1, absents) et son `ghost` porte
+ * une branche `@supports not (backdrop-filter)` qui echange le fond de
+ * 12 % a 18 % : aucune prop n'exprime une valeur conditionnee a une
+ * feature query.
+ *
+ * @description
+ * Le pilote est `OrigamKbd`, pour une raison que D7 ne donne pas : AUCUN
+ * theme de marque ne touche un seul token `origam-kbd` (verifie, zero
+ * occurrence sur les 8 themes), donc le zero-changement y est prouvable en
+ * isolation. `OrigamBtn` vient au lot 4.
+ ********************************************************/
+export declare const VARIANT_PRESETS: TVariantPresetRegistry;

package/dist/src/consts/Commons/variant-preset.const.js

@@ -0,0 +1,2 @@
+export const VARIANT_PROP_KEY = "variant";
+export const VARIANT_PRESETS = {};

package/dist/src/consts/index.cjs

@@ -959,4 +959,15 @@ Object.keys(_elevation).forEach(function (key) {
       return _elevation[key];
     }
   });
+});
+var _variantPreset = require("./Commons/variant-preset.const.cjs");
+Object.keys(_variantPreset).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _variantPreset[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _variantPreset[key];
+    }
+  });
 });

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

@@ -85,3 +85,4 @@ export * from './Audio/audio-waveform.const';
 export * from './Clipboard/clipboard.const';
 export * from './Commons/css-support.const';
 export * from './Commons/elevation.const';
+export * from './Commons/variant-preset.const';

package/dist/src/consts/index.js

@@ -85,3 +85,4 @@ export * from "./Audio/audio-waveform.const.js";
 export * from "./Clipboard/clipboard.const.js";
 export * from "./Commons/css-support.const.js";
 export * from "./Commons/elevation.const.js";
+export * from "./Commons/variant-preset.const.js";

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

@@ -2,6 +2,7 @@ import type { Ref } from 'vue';
 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 { TVariantPresetRegistry } from '../../types/Commons/variant-preset.type';
 import type { IDefault } from '../DefaultsProvider/defaults-provider.interface';
 /**
  * Shape of the `useTheme()` singleton state.
@@ -127,4 +128,36 @@ export interface IOrigamTheme {
      * }
      */
     components?: IDefault;
+    /*********************************************************
+     * variants
+     *
+     * @description
+     * ADR-005 D4 — redefinit en PROPS ce qu'un `variant` veut dire, par
+     * composant puis par valeur de variant :
+     *
+     *     variants: {
+     *         'origam-btn': { outlined: { border: 3, rounded: 'lg' } }
+     *     }
+     *
+     * @description
+     * C'est ce qui rend les variants conformes a la regle PROPS-D'ABORD :
+     * un theme retune `outlined` en changeant des valeurs de props, et ne
+     * descend a `vars` / `cssVars` que pour ce que les props n'expriment
+     * pas. Les variants etaient le seul API du DS a violer cette regle
+     * structurellement.
+     *
+     * @description
+     * FRERE de `components`, pas une cle imbriquee dedans : `components`
+     * est type `IDefault` (composant -> map de props), donc y nicher un
+     * niveau de variant rendrait `{ 'origam-btn': { outlined: … } }`
+     * ambigu avec un prop qui s'appellerait litteralement `outlined`.
+     *
+     * @description
+     * Fusionne par-dessus la table livree par le DS a l'installation
+     * (`resolveVariantPresetRegistry`), avec le `mergeDeep` que
+     * `provideDefaults` utilise deja. Le preset resultant reste le rang
+     * LE PLUS FAIBLE de la resolution (arbitrage Q2) : un prop ecrit au
+     * site d'appel, comme un defaut de `components`, le battent tous deux.
+     ********************************************************/
+    variants?: TVariantPresetRegistry;
 }

package/dist/src/interfaces/Masonry/masonry.interface.d.ts

@@ -59,8 +59,8 @@ export interface IMasonryProps extends ICommonsComponentProps, ITagProps, IDimen
      * Gap between items, both vertically and horizontally. Accepts:
      *
      * - one of the grid size tokens `'xs' | 'sm' | 'md' | 'lg' | 'xl'`
-     *   (resolved via `tokens/component/grid.json`, same matrix as
-     *   `<OrigamGrid>` for visual consistency).
+     *   (resolved via `GRID_GAP_SIZE_VAR` to `--origam-grid---gap-{size}`,
+     *   same matrix as `<OrigamGrid>` for visual consistency).
      * - any CSS length string (`'24px'`, `'1rem'`).
      * - a plain `number` interpreted as pixels.
      *

package/dist/src/origam.cjs

@@ -32,6 +32,7 @@ function createOrigam(origam = {}) {
   const defaultsRef = (0, _composables.createDefaults)({});
   defaultsRef.value = activeDefaultsFor(allThemes, allThemes[0]?.name ?? "", void 0);
   const themedKeysUnion = (0, _composables.themedPropKeysUnion)(allThemes.map(theme => theme.components).filter(components2 => !!components2));
+  const variantPresets = (0, _composables.resolveVariantPresetRegistry)(_consts.VARIANT_PRESETS, allThemes.map(theme => theme.variants).filter(variants => !!variants));
   const scope = (0, _vue.effectScope)();
   return scope.run(() => {
     const icons = (0, _composables.createIcons)(options.icons);
@@ -67,7 +68,7 @@ function createOrigam(origam = {}) {
       app.provide(_consts.ORIGAM_GO_TO_KEY, goTo);
       app.provide(_consts.ORIGAM_THEMES_KEY, installedThemes);
       app.provide(_consts.ORIGAM_DEFAULTS_KEY, defaultsRef);
-      (0, _composables.installThemePropsResolver)(app, themedKeysUnion);
+      (0, _composables.installThemePropsResolver)(app, themedKeysUnion, variantPresets);
       app.provide(_consts.ORIGAM_THEME_DEFAULTS_KEY, (brand, mode) => activeDefaultsFor(allThemes, brand, mode));
       if (_consts.IN_BROWSER && options.ssr) {
         const nuxt = app.$nuxt;

package/dist/src/origam.js

@@ -7,6 +7,7 @@ import {
   createIcons,
   createLocale,
   installThemePropsResolver,
+  resolveVariantPresetRegistry,
   themedPropKeysUnion
 } from "./composables/index.js";
 import {
@@ -19,7 +20,8 @@ import {
   ORIGAM_ICONS_KEY,
   ORIGAM_LOCALE_KEY,
   ORIGAM_THEME_DEFAULTS_KEY,
-  ORIGAM_THEMES_KEY
+  ORIGAM_THEMES_KEY,
+  VARIANT_PRESETS
 } from "./consts/index.js";
 import * as origamDirectives from "./directives/index.js";
 import { setContrastConfig } from "./directives/Contrast/contrast.directive.js";
@@ -45,6 +47,10 @@ export function createOrigam(origam = {}) {
   const themedKeysUnion = themedPropKeysUnion(
     allThemes.map((theme) => theme.components).filter((components2) => !!components2)
   );
+  const variantPresets = resolveVariantPresetRegistry(
+    VARIANT_PRESETS,
+    allThemes.map((theme) => theme.variants).filter((variants) => !!variants)
+  );
   const scope = effectScope();
   return scope.run(() => {
     const icons = createIcons(options.icons);
@@ -80,7 +86,7 @@ export function createOrigam(origam = {}) {
       app.provide(ORIGAM_GO_TO_KEY, goTo);
       app.provide(ORIGAM_THEMES_KEY, installedThemes);
       app.provide(ORIGAM_DEFAULTS_KEY, defaultsRef);
-      installThemePropsResolver(app, themedKeysUnion);
+      installThemePropsResolver(app, themedKeysUnion, variantPresets);
       app.provide(ORIGAM_THEME_DEFAULTS_KEY, (brand, mode) => activeDefaultsFor(allThemes, brand, mode));
       if (IN_BROWSER && options.ssr) {
         const nuxt = app.$nuxt;

package/dist/src/types/Commons/variant-preset.type.cjs

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

package/dist/src/types/Commons/variant-preset.type.d.ts

@@ -0,0 +1,73 @@
+/*********************************************************
+ * TVariantPresets
+ *
+ * @description
+ * ADR-005 (D1) — un `variant` EST une preconfiguration de props nommee,
+ * pas une couche CSS : `Record<valeur du variant, Partial<props>>`.
+ *
+ * @description
+ * C'est le type d'AUTORAT, celui qu'une table
+ * `consts/{Composant}/{composant}-variant.const.ts` annote pour que le
+ * compilateur refuse une valeur de variant inconnue ou un nom de prop que
+ * le composant ne declare pas :
+ *
+ *     export const KBD_VARIANT_PRESETS: TVariantPresets<TKbdVariant, IKbdProps> = {
+ *         outlined: { bgColor: '...', border: 1 },
+ *         filled:   { bgColor: '...' },
+ *         tonal:    { bgColor: '...', border: 0 }
+ *     }
+ *
+ * @description
+ * ⛔ AUCUN SCSS N'ACCOMPAGNE UNE TABLE DE PRESETS. La classe
+ * `{nom}--variant-{valeur}` que `useVariant()` emet continue d'exister,
+ * mais le DS ne lui attache plus aucune regle : elle appartient au
+ * CONSOMMATEUR, comme crochet d'override. Le garde `no-variant-css` tient
+ * cette moitie du contrat.
+ *
+ * @description
+ * ⛔ LES VALEURS NE SE RE-EXPRIMENT PAS EN ECHELON SEMANTIQUE. Mesure
+ * (2026-09-30) : les 8 themes de marque
+ * (`packages/marketing/src/themes/*.theme.ts`) habillent leurs boutons A
+ * TRAVERS les tokens de composant que la regle de variant lisait —
+ * `cartoon` pose `--origam-btn---box-shadow-elevated: 4px 4px 0 #171717`,
+ * `glass` une ombre de verre a quatre couches. Un preset ecrit
+ * `elevation: 'md'` emet `var(--origam-shadow---md)` et jette donc
+ * silencieusement l'ombre de la marque sur les 8 identites x 2 modes.
+ * @description
+ * Un preset porte la MEME chaine `var(--origam-{cmp}---{...}, <repli>)`
+ * que portait la regle, jamais sa traduction en echelon : le canal
+ * d'override des themes survit, et le rendu est identique par
+ * construction. `TElevation` documente le `box-shadow` libre (dont
+ * `var()`, multi-couches, `inset`) rendu verbatim, et `isCssColor`
+ * accepte `var(--…)` comme `color-mix(…)` en les routant vers le canal
+ * de style « valeur custom ».
+ ********************************************************/
+export type TVariantPresets<V extends string, P> = Record<V, Partial<P>>;
+/*********************************************************
+ * TVariantPresetTable
+ *
+ * @description
+ * La meme table, vue par le RESOLVEUR : valeur du variant -> sac de props.
+ *
+ * @description
+ * Type efface a dessein. Le resolveur est generique sur les 217
+ * composants et ne peut etre parametre par aucun `IXxxProps` en
+ * particulier ; c'est la table d'autorat qui porte le typage fort, au
+ * point d'ecriture, ou il sert reellement a quelque chose.
+ ********************************************************/
+export type TVariantPresetTable = Record<string, Record<string, unknown>>;
+/*********************************************************
+ * TVariantPresetRegistry
+ *
+ * @description
+ * Nom kebab du composant (`'origam-btn'`) -> sa table de presets.
+ *
+ * @description
+ * Meme forme que ce qu'un theme peut declarer sous `IOrigamTheme.variants`
+ * (ADR-005 D4). C'est une exigence, pas une coincidence : la directive
+ * d'implementation de l'ADR veut qu'un preset soit « une config par defaut
+ * comme avec le theme, la meme logique ». Si les deux formes divergeaient,
+ * la fusion du lot 1 et les variants definis par le consommateur
+ * demanderaient deux chemins de resolution au lieu d'un.
+ ********************************************************/
+export type TVariantPresetRegistry = Record<string, TVariantPresetTable>;

package/dist/src/types/index.cjs

@@ -619,6 +619,17 @@ Object.keys(_variant).forEach(function (key) {
     }
   });
 });
+var _variantPreset = require("./Commons/variant-preset.type.cjs");
+Object.keys(_variantPreset).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _variantPreset[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _variantPreset[key];
+    }
+  });
+});
 var _direction = require("./Commons/direction.type.cjs");
 Object.keys(_direction).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

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

@@ -54,6 +54,7 @@ export * from './Commons/rounded.type';
 export * from './Commons/dimension.type';
 export * from './Commons/elevation.type';
 export * from './Commons/variant.type';
+export * from './Commons/variant-preset.type';
 export * from './Commons/direction.type';
 export * from './Commons/display.type';
 export * from './Commons/event.type';

package/dist/src/types/index.js

@@ -54,6 +54,7 @@ export * from "./Commons/rounded.type.js";
 export * from "./Commons/dimension.type.js";
 export * from "./Commons/elevation.type.js";
 export * from "./Commons/variant.type.js";
+export * from "./Commons/variant-preset.type.js";
 export * from "./Commons/direction.type.js";
 export * from "./Commons/display.type.js";
 export * from "./Commons/event.type.js";