origam 2.18.20 → 2.19.0

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

@@ -6,9 +6,14 @@ import type { TLineHeight } from '../../types/Commons/line-height.type';
 /**
  * Cross-cutting typography surface — the font equivalent of
  * `IColorProps` / `IBorderProps` / `IMarginProps`. Every prop is optional
- * and maps a primitive font token key to the matching component CSS
- * variable via `useTypography`. When a prop is unset the component keeps
- * its theme value (no override emitted).
+ * and resolves to the matching component CSS variable via `useTypography`.
+ * When a prop is unset the component keeps its theme value (no override
+ * emitted).
+ *
+ * The first FIVE props are primitive font token KEYS, wrapped into
+ * `var(--origam-font__{group}---{value})`. `fontStyle` is the one
+ * PASSTHROUGH: a CSS keyword emitted verbatim, because `font-style` has no
+ * design scale — see its own note below.
  *
  * | Prop            | CSS property      | Primitive token group        |
  * |-----------------|-------------------|------------------------------|
@@ -17,6 +22,7 @@ import type { TLineHeight } from '../../types/Commons/line-height.type';
  * | `fontWeight`    | `font-weight`     | `--origam-font__weight---*`        |
  * | `lineHeight`    | `line-height`     | `--origam-font__lineHeight---*`    |
  * | `letterSpacing` | `letter-spacing`  | `--origam-font__letterSpacing---*` |
+ * | `fontStyle`     | `font-style`      | *none — passthrough, see below*    |
  *
  * Collision-free names by design: `fontSize` / `fontWeight` / `fontFamily`
  * (not `size` / `weight` / `family`) so the surface composes with
@@ -53,4 +59,42 @@ export interface ITypographyProps {
      * When unset, the component keeps its theme letter-spacing.
      */
     letterSpacing?: TLetterSpacing;
+    /*********************************************************
+     * fontStyle
+     *
+     * @description
+     * Style de fonte, emis LITTERALEMENT dans
+     * `--origam-{prefix}---font-style`. Seul membre PASSTHROUGH de cette
+     * interface : les cinq autres props sont des cles de token que
+     * `useTypography` enveloppe en `var(--origam-font__{groupe}---{valeur})`.
+     *
+     * @description
+     * ⛔ POURQUOI PAS UN TOKEN. `italic` / `normal` / `oblique` sont des
+     * MOTS-CLES CSS, pas les echelons d'une echelle de design : il n'existe
+     * aucun groupe `--origam-font__style---*` dans `primitive.css` (verifie,
+     * zero occurrence) et il n'en faut pas. Enveloppee, la valeur sortirait
+     * en `var(--origam-font__style---italic)`, un nom que nulle feuille ne
+     * declare — donc rien ne peindrait.
+     *
+     * @description
+     * Type `string` volontairement large, par coherence avec
+     * `IBorderProps.borderStyle` / `borderColor`, les deux autres
+     * passthrough de mot-cle CSS des interfaces Commons. Laisse passer
+     * `oblique 10deg`, qu'une union fermee rejetterait.
+     *
+     * @description
+     * ⚠️ N'a d'EFFET que si la SCSS du composant lit le var GENERIQUE
+     * `--origam-{prefix}---font-style`. Mesure a l'ajout : un seul composant
+     * le fait — `OrigamBlockquote`
+     * (`--origam-blockquote---resolved-font-style` retombe dessus).
+     * @description
+     * ⛔ `OrigamBracketCompetitor` ne compte PAS, et la nuance vaut d'etre
+     * lue : il lit `--origam-bracket-competitor--pending---font-style`, un
+     * var de MODIFICATEUR D'ETAT (double tiret `--pending---`), pas le
+     * generique que `useTypography(props, 'bracket-competitor')` emet. La
+     * prop y type-check et emet sa variable sans rien peindre — meme cas
+     * que `fontFamily` sur Btn. Ne pas ajouter de regle SCSS pour lui
+     * forcer un effet sans le signaler.
+     ********************************************************/
+    fontStyle?: string;
 }

package/dist/src/interfaces/Kbd/kbd.interface.d.ts

@@ -1,11 +1,12 @@
 import type { IBorderProps } from '../Commons/border.interface';
 import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
 import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { ISizeProps } from '../Commons/size.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
 import type { TKbdVariant } from '../../types/Kbd/kbd.type';
-export interface IKbdProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IBorderProps, IRoundedProps, Pick<ITypographyProps, 'fontFamily' | 'fontSize' | 'fontWeight'> {
+export interface IKbdProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IBorderProps, IElevationProps, IRoundedProps, Pick<ITypographyProps, 'fontFamily' | 'fontSize' | 'fontWeight'> {
     /** Single key label (e.g. "⌘", "Ctrl", "A"). Overridden by the default slot. */
     text?: string;
     /** Composed shortcut rendered as individual nested `<kbd>` elements (e.g. ['Ctrl', 'Shift', 'Z']). */