origam 2.19.0 → 2.21.0

package/dist/src/types/Bracket/bracket.type.d.ts

@@ -103,3 +103,85 @@ export type TBracketElevation = TElevation | boolean | null | undefined;
  * layer.
  */
 export type TBracketBorder = IBorderProps['borderTop'] | null | undefined;
+/*********************************************************
+ * TBracketBorderProps
+ *
+ * @description
+ * `IBorderProps` MOINS les quatre aretes logiques INLINE (#1013). Partage
+ * par les interfaces Bracket dont les props de bordure sont resolues par
+ * `bracketSurfaceVars` — `IBracketProps` (la racine) et `IBracketMatchProps`
+ * (la carte). Declare UNE fois ici plutot que deux `Omit<>` recopies.
+ *
+ * @description
+ * ⛔ `IBracketCompetitorProps` n'utilise PAS ce type, a dessein :
+ * `OrigamBracketCompetitor` appelle `useStateEffect` pour de vrai
+ * (`OrigamBracketCompetitor.vue:209`), donc ses quatre aretes logiques
+ * atteignent `useBorder` et peignent. Restreindre par FAMILLE de composant
+ * au lieu de par consommation mesuree y retirerait quatre props qui
+ * marchent.
+ *
+ * @description
+ * Pourquoi les deux autres sont restreintes : elles ne peignent pas via
+ * `useBorder` mais via des custom properties `--origam-bracket-match---*`
+ * lues dans des declarations PHYSIQUES. Mapper une arete logique sur une
+ * arete physique au moment d'ecrire la feuille exige de connaitre le mode
+ * d'ecriture, et `inline-start` vaut `left` en LTR mais `right` en RTL.
+ * Aucune chaine de repli `var()` ne peut l'exprimer : la substitution est
+ * AVEUGLE au mode d'ecriture alors que le mapping de la propriete ne l'est
+ * pas.
+ *
+ * @description
+ * Les deux aretes de BLOC restent declarees et sont honorees :
+ * `block-start`/`block-end` valent invariablement `top`/`bottom` en
+ * `horizontal-tb`, hypothese que la feuille faisait deja pour `borderBlock`.
+ * Confirme par sonde navigateur sur l'axe logique (Chromium, LTR vs RTL) :
+ * les noms porteurs d'une composante INLINE changent d'arete, le controle
+ * negatif `padding-block-start` ne bouge pas.
+ *
+ * @description
+ * ⛔ Retirer plutot que declarer-et-ignorer est la regle que
+ * `bracket-surface.interface.ts` enonce deja pour cette couche : une prop
+ * typee, editable dans Histoire, et inerte est pire qu'une prop absente.
+ * Arbitre par le proprietaire le 2026-10-01. La completude de l'axe inline
+ * part dans son propre ticket (elle demande de convertir la cascade en
+ * longhands logiques, ce qui change le comportement RTL des props physiques
+ * existantes).
+ ********************************************************/
+export type TBracketBorderProps = Omit<IBorderProps, 'borderInlineStart' | 'borderInlineEnd' | 'borderInlineStartColor' | 'borderInlineEndColor'>;
+/*********************************************************
+ * TBracketRoundedProps — le pendant « coins » de {@link TBracketBorderProps}
+ *
+ * @description
+ * Même couche, même cause, même arbitrage (#1013, tranché par le
+ * propriétaire le 2026-10-01) : `OrigamBracket` n'appelle pas `useRounded`,
+ * il passe `props` en bloc à `utils/Bracket/bracket-surface.util.ts`, qui
+ * émet des custom properties relues par le SCSS d'`OrigamBracketMatch` dans
+ * des déclarations PHYSIQUES par coin. La substitution `var()` est AVEUGLE
+ * au mode d'écriture alors que le mapping de la propriété ne l'est pas,
+ * donc aucune chaîne de repli ne peut encoder « le physique gagne » ET « le
+ * logique se retourne en RTL » simultanément.
+ *
+ * @description
+ * ⛔ MAIS LES QUATRE SORTENT, là où le côté border n'en retire que deux. Le
+ * sursis des arêtes de BLOC ne s'applique pas à un coin : tout nom de coin
+ * logique est `{bloc}-{inline}` et porte donc une composante inline. Mesuré
+ * dans Chromium (sonde Playwright, LTR vs RTL) plutôt que déduit —
+ * `start-start` top-left -> top-RIGHT, `start-end` top-right -> top-LEFT,
+ * `end-start` bottom-left -> bottom-RIGHT, `end-end` bottom-right ->
+ * bottom-LEFT. Contrôle négatif `padding-block-start` -> `padding-top` :
+ * 40px dans les deux sens, il ne bouge pas, ce qui prouve que la sonde sait
+ * distinguer l'immobilité et que les quatre déplacements sont réels.
+ *
+ * @description
+ * PORTÉE VÉRIFIÉE — seul `IBracketProps` est restreint. Les deux autres
+ * interfaces Bracket qui étendent `IRoundedProps` consomment réellement
+ * leurs coins : `OrigamBracketMatch` et `OrigamBracketCompetitor` appellent
+ * `useRounded` / `useStateEffect`, et gardent donc la surface complète.
+ * `OrigamBracket` est le seul à n'avoir aucun de ces appels.
+ *
+ * @description
+ * Retirer plutôt que déclarer-et-ignorer, même règle que ci-dessus. La
+ * complétude de l'axe inline pour les coins suit le même ticket que pour
+ * les arêtes : il faut convertir la cascade en longhands logiques.
+ ********************************************************/
+export type TBracketRoundedProps = Omit<IRoundedProps, 'roundedStartStart' | 'roundedStartEnd' | 'roundedEndStart' | 'roundedEndEnd'>;

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

@@ -1,3 +1,4 @@
+import { BORDER_LOGICAL_AXIS } from '../../enums/Commons/border.enum';
 import { BLOCK, INLINE, START_END } from '../../enums/Commons/anchor.enum';
 export type TStartEnd = `${START_END}`;
 export type TBlock = `${BLOCK}`;
@@ -5,6 +6,53 @@ export type TBlockStartEnd = TBlock | TStartEnd;
 export type TInline = `${INLINE}`;
 export type TInlineStartEnd = TInline | TStartEnd;
 export type TDirectionBoth = TBlock | TInline;
+/*********************************************************
+ * TLogicalSide
+ *
+ * @description
+ * One LOGICAL box edge — `block-start` | `block-end` | `inline-start` |
+ * `inline-end`. The writing-mode-relative twin of {@link TDirectionBoth},
+ * which names the four PHYSICAL edges.
+ *
+ * @description
+ * Composed from the two enums that already carry this vocabulary rather
+ * than spelling a fifth literal union : `BORDER_LOGICAL_AXIS` fournit
+ * l'axe, `START_END` son extremite. Rien de neuf n'est declare, donc les
+ * cotes logiques ne peuvent pas deriver des props d'axe (`paddingInline`,
+ * `borderBlock`, …) qui lisent les memes membres.
+ *
+ * @description
+ * ⚠️ `BORDER_LOGICAL_AXIS` est border-NOMME mais pas border-PORTE — c'est
+ * deja le vocabulaire d'axe de padding et margin
+ * (`consts/Commons/spacing.const.ts` l'importe pour
+ * `PADDING_LOGICAL_AXIS_MAP` / `MARGIN_LOGICAL_AXIS_MAP`). Le reutiliser
+ * ici suit ce precedent au lieu d'ajouter un enum quasi identique.
+ *
+ * @description
+ * Consomme par les familles `*InlineStart` / `*InlineEnd` / `*BlockStart`
+ * / `*BlockEnd` de `IPaddingProps`, `IMarginProps` et `IBorderProps`
+ * (#1013), et par les tables qui les cablent.
+ ********************************************************/
+export type TLogicalSide = `${BORDER_LOGICAL_AXIS}-${START_END}`;
+/*********************************************************
+ * TLogicalCorner
+ *
+ * @description
+ * One LOGICAL box CORNER — `start-start` | `start-end` | `end-start` |
+ * `end-end`, dans l'ordre natif `border-{block}-{inline}-radius` (fin de
+ * bloc d'abord, fin d'inline ensuite). Le jumeau relatif au mode
+ * d'ecriture des noms physiques `top-left` / ….
+ *
+ * @description
+ * Compose depuis `START_END` seul, pour la meme raison anti-duplication
+ * que {@link TLogicalSide} : un coin est l'intersection d'une fin de bloc
+ * et d'une fin d'inline, donc le vocabulaire est `START_END` au carre.
+ *
+ * @description
+ * Consomme par les props `roundedStartStart` / `roundedStartEnd` /
+ * `roundedEndStart` / `roundedEndEnd` de `IRoundedProps` (#1013).
+ ********************************************************/
+export type TLogicalCorner = `${START_END}-${START_END}`;
 export type TAnchor = TBlock | TInline | 'center' | 'center center' | `${TBlock} ${TInline | 'center'}` | `${TInline} ${TBlock | 'center'}`;
 export type TParsedAnchor = {
     side: 'center';

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

@@ -6,10 +6,28 @@
  * 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 :
+ * C'est le type d'AUTORAT, celui qu'une table annote pour que le compilateur
+ * refuse une valeur de variant inconnue ou un nom de prop que le composant ne
+ * declare pas.
+ *
+ * @description
+ * La table vit dans le fichier de consts EXISTANT du composant —
+ * `consts/{Composant}/{composant}.const.ts` — jamais dans un second fichier
+ * cree pour elle. Arbitrage du proprietaire, 2026-10-01 : la regle
+ * anti-duplication du `CLAUDE.md` global commande de reutiliser le fichier de
+ * consts deja en place plutot que d'en ouvrir un parallele. Le pilote
+ * `KBD_VARIANT_PRESETS` est dans `consts/Kbd/kbd.const.ts`, et c'est la forme
+ * a copier.
+ *
+ * @description
+ * ⚠️ Cet en-tete prescrivait `{composant}-variant.const.ts`. C'etait FAUX —
+ * aucune table n'a jamais ete ecrite a ce chemin, et le `fixHint` de la garde
+ * `no-variant-css` portait la meme erreur. Les deux sont corriges ; voir la
+ * section « `variant` = a props PRESET » du `CLAUDE.md` a la racine, qui fait
+ * foi.
+ *
+ * @description
+ * La forme, telle que le pilote la pose :
  *
  *     export const KBD_VARIANT_PRESETS: TVariantPresets<TKbdVariant, IKbdProps> = {
  *         outlined: { bgColor: '...', border: 1 },