origam 2.18.18 → 2.18.20

package/dist/src/types/Commons/opacity.type.cjs

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

package/dist/src/types/Commons/opacity.type.d.ts

@@ -0,0 +1,36 @@
+/*********************************************************
+ * TOpacity
+ *
+ * @description
+ * `opacity` prop accepted by every component that consumes `useOpacity`
+ * (`src/composables/Commons/opacity.composable.ts`).
+ *
+ * @description
+ * Two numeric readings share one type, disambiguated at runtime by the
+ * MAGNITUDE of the value — the same loose `number | string` union
+ * `TElevation` and `TRounded` use, for the same reason: the shapes are
+ * told apart by `useOpacity`, not by the type system.
+ *
+ * @description
+ * A number `<= 1` is read as a CSS fraction and emitted verbatim
+ * (`0.7` -> `opacity: 0.7`). A number `> 1` is read on the 0..100
+ * PERCENT scale that names the token rungs (`70` -> rung `70`), which is
+ * the vocabulary ADR-005's variant presets are written in
+ * (`plain: { opacity: 70, hover: { opacity: 100 } }`).
+ *
+ * @description
+ * ⛔ The split is at 1, not at 0, and that is deliberate. Reading every
+ * number on the percent scale would make `opacity={1}` mean 1 % — very
+ * nearly invisible — where every CSS author on earth means "opaque". The
+ * cost of the split is that 1 % cannot be written as a number; pass the
+ * string `'1%'` for it. That trade was chosen because `opacity={1}`
+ * meaning "opaque" is the single most likely thing a consumer types, and
+ * silently rendering it invisible is the worst available failure.
+ *
+ * @description
+ * A non-numeric string passes through verbatim, so `'50%'`,
+ * `'var(--origam-opacity---50)'` and `'calc(1 / 3)'` all reach the
+ * declaration untouched. Mirrors the custom-value escape hatch of
+ * `TRounded` / `TElevation`.
+ ********************************************************/
+export type TOpacity = number | string;

package/dist/src/types/Commons/state-effect.type.d.ts

@@ -2,6 +2,7 @@ import type { IBgColorProps, IColorProps } from '../../interfaces/Commons/color.
 import type { IBorderProps } from '../../interfaces/Commons/border.interface';
 import type { IElevationProps } from '../../interfaces/Commons/elevation.interface';
 import type { IMarginProps } from '../../interfaces/Commons/margin.interface';
+import type { IOpacityProps } from '../../interfaces/Commons/opacity.interface';
 import type { IPaddingProps } from '../../interfaces/Commons/padding.interface';
 import type { IRoundedProps } from '../../interfaces/Commons/rounded.interface';
 /**
@@ -25,6 +26,6 @@ import type { IRoundedProps } from '../../interfaces/Commons/rounded.interface';
  * OVERRIDE object a consumer passes to `hover` / `active`. This type
  * describes the RESTING props those overrides are layered on top of.
  */
-export type TStateEffectProps = IColorProps & IBgColorProps & IBorderProps & IRoundedProps & IElevationProps & IPaddingProps & IMarginProps & {
+export type TStateEffectProps = IColorProps & IBgColorProps & IBorderProps & IRoundedProps & IElevationProps & IPaddingProps & IMarginProps & IOpacityProps & {
     gap?: boolean | number | string;
 };

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

@@ -597,6 +597,17 @@ Object.keys(_dimension).forEach(function (key) {
     }
   });
 });
+var _backdrop = require("./Commons/backdrop.type.cjs");
+Object.keys(_backdrop).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _backdrop[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _backdrop[key];
+    }
+  });
+});
 var _elevation = require("./Commons/elevation.type.cjs");
 Object.keys(_elevation).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -608,6 +619,17 @@ Object.keys(_elevation).forEach(function (key) {
     }
   });
 });
+var _opacity = require("./Commons/opacity.type.cjs");
+Object.keys(_opacity).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _opacity[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _opacity[key];
+    }
+  });
+});
 var _variant = require("./Commons/variant.type.cjs");
 Object.keys(_variant).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -619,6 +641,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

@@ -52,8 +52,11 @@ export * from './Commons/letter-spacing.type';
 export * from './Commons/line-height.type';
 export * from './Commons/rounded.type';
 export * from './Commons/dimension.type';
+export * from './Commons/backdrop.type';
 export * from './Commons/elevation.type';
+export * from './Commons/opacity.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

@@ -52,8 +52,11 @@ export * from "./Commons/letter-spacing.type.js";
 export * from "./Commons/line-height.type.js";
 export * from "./Commons/rounded.type.js";
 export * from "./Commons/dimension.type.js";
+export * from "./Commons/backdrop.type.js";
 export * from "./Commons/elevation.type.js";
+export * from "./Commons/opacity.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";