origam 2.20.0 → 2.22.0

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

@@ -15,6 +15,62 @@ import { Ref } from 'vue';
  * `teleportTarget` reste `undefined` — le composant appelant retombe
  * alors sur son rendu non-teleporte plutot que de crasher. En SSR
  * (`!IN_BROWSER`), toujours `undefined`, sans avertissement.
+ *
+ * @description
+ * ⛔ `useHydration()` — #attach-harmonisation. Un selecteur `string` ciblant
+ * un NOEUD FRERE cree dans la MEME passe de rendu (ex: un conteneur local
+ * que le consommateur monte lui-meme juste avant le composant qui teleporte)
+ * peut ne pas encore etre connecte a `document` au moment ou ce `computed`
+ * s'evalue pour la PREMIERE fois — mesure concrete sous Histoire (dont
+ * `OrigamApp`/`OrigamLayout` englobent chaque story dans un `<Suspense>` :
+ * l'arbre entier, y compris les freres, n'est commit dans le vrai DOM
+ * qu'une fois la resolution async terminee). `document.querySelector` n'est
+ * PAS une dependance reactive : si le premier appel echoue, le `computed`
+ * reste bloque sur `undefined` pour toujours, meme apres que la cible soit
+ * reellement montee — rien ne le marque sale.
+ *
+ * @description
+ * ⛔ UN COMPTEUR LOCAL (`mountTick`, essaye d'abord) CASSE LE SSR MARKETING.
+ * Mesure, CI (#1043) : 4 e2e marketing (Nuxt, SSR) en echec sur « sans
+ * erreur JS console » / « pas d'erreur d'hydratation ». Cause reelle,
+ * independante de `mountTick` : la toute PREMIERE evaluation du computed
+ * divergeait DEJA entre serveur et client. Cote serveur, `!IN_BROWSER` est
+ * toujours vrai (pas de `window` en SSR) -> `undefined` (teleport
+ * desactive, rendu en place). Cote client, `IN_BROWSER` est vrai DES LE
+ * DEPART, y compris pendant la passe d'HYDRATATION (avant tout
+ * `onMounted`) -> la cible (souvent `document.body`, qui existe toujours)
+ * se resout avec SUCCES sur ce tout premier rendu -> teleport deja ACTIF.
+ * Vue compare les deux rendus pendant l'hydratation : desactive vs actif,
+ * d'ou le decalage. `mountTick` n'ajoutait qu'une DEUXIEME evaluation
+ * post-montage — elle n'a jamais ete la cause du decalage, qui existait
+ * deja sur la premiere.
+ *
+ * @description
+ * Le fix : `isHydrated.value` (vrai gate, pas une simple lecture de
+ * dependance) force EXACTEMENT le meme `undefined` cote client QUE cote
+ * serveur tant que l'hydratation n'est pas terminee — `useHydration()`
+ * (deja utilise par `OrigamOverlay.vue`) seede `isHydrated` a `false` sur
+ * les DEUX rendus compares (serveur ET premiere passe client) quand l'app
+ * est reellement en SSR (`ssr` vrai), et ne bascule a `true` que dans un
+ * `onMounted` — donc APRES que l'hydratation ait deja conclu. Reutilise,
+ * ne redeclare pas.
+ *
+ * @description
+ * ⚠️ Dans une app 100% client (pas de SSR — Histoire, Tauri…),
+ * `useHydration()` renvoie `isHydrated=true` DES LE DEPART (son
+ * optimisation deliberee : « pas de delai artificiel » — voir son propre
+ * commentaire de tete) : le gate ci-dessous ne retarde donc RIEN la ou il
+ * n'y a aucune hydratation a proteger. Consequence mesuree : une cible
+ * FRERE montee dans la MEME passe de rendu que le consommateur (ex: un
+ * conteneur local qu'une story Histoire monte juste avant le composant
+ * teleportant, sous un `<Suspense>` qui ne commit l'arbre qu'une fois
+ * resolu) peut encore echouer sur cette toute premiere resolution, pour la
+ * meme raison qu'avant : `document.querySelector` n'est pas reactif. Ce
+ * n'est PAS le defaut que ce correctif vise — c'est un defaut DIFFERENT,
+ * propre a la construction du test (une cible fraiche ne preexiste jamais
+ * en usage reel), traite cote story plutot qu'en reintroduisant un
+ * compteur local ici (voir les stories CommandPalette / SnackbarGroup /
+ * Drawer, variante « Prop - attach »).
  ********************************************************/
 export declare function useTeleport(target: Ref<boolean | string | Element>): {
     teleportTarget: import("vue").ComputedRef<Element | undefined>;

package/dist/src/composables/Commons/teleport.composable.js

@@ -1,10 +1,13 @@
 import { IN_BROWSER } from "../../consts/Commons/commons.const.js";
 import { consoleWarn } from "../../utils/Commons/console.util.js";
 import { computed } from "vue";
+import { useHydration } from "./hydration.composable.js";
 export function useTeleport(target) {
+  const isHydrated = useHydration();
   const teleportTarget = computed(() => {
     const _target = target.value;
     if (_target === true || !IN_BROWSER) return void 0;
+    if (!isHydrated.value) return void 0;
     const targetElement = _target === false ? document.body : typeof _target === "string" ? document.querySelector(_target) : _target;
     if (targetElement == null) {
       consoleWarn(`Unable to locate target ${_target}`);

package/dist/src/consts/Blockquote/blockquote.const.cjs

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.QUOTE_MARKS_BY_LANG = exports.BLOCKQUOTE_VARIANTS = exports.BLOCKQUOTE_LANGS = exports.BLOCKQUOTE_DEFAULTS = exports.BLOCKQUOTE_ALIGNS = void 0;
+exports.QUOTE_MARKS_BY_LANG = exports.BLOCKQUOTE_VARIANT_PRESETS = exports.BLOCKQUOTE_VARIANTS = exports.BLOCKQUOTE_LANGS = exports.BLOCKQUOTE_DEFAULTS = exports.BLOCKQUOTE_ALIGNS = void 0;
 var _enums = require("../../enums/index.cjs");
 const BLOCKQUOTE_VARIANTS = exports.BLOCKQUOTE_VARIANTS = Object.values(_enums.BLOCKQUOTE_VARIANT);
 const BLOCKQUOTE_LANGS = exports.BLOCKQUOTE_LANGS = Object.values(_enums.BLOCKQUOTE_LANG);
@@ -29,5 +29,42 @@ const QUOTE_MARKS_BY_LANG = exports.QUOTE_MARKS_BY_LANG = {
 const BLOCKQUOTE_DEFAULTS = exports.BLOCKQUOTE_DEFAULTS = {
   variant: "default",
   lang: "auto",
+  align: "left",
   tag: "blockquote"
+};
+const BLOCKQUOTE_VARIANT_PRESETS = exports.BLOCKQUOTE_VARIANT_PRESETS = {
+  default: {
+    borderInlineStart: "var(--origam-blockquote__accent---width, 4px) solid var(--origam-blockquote---resolved-accent-color, currentColor)",
+    paddingInlineStart: "calc(var(--origam-blockquote---padding-inline, 24px) + var(--origam-blockquote__accent---width, 4px))"
+  },
+  elegant: {
+    fontFamily: "serif",
+    fontSize: "xl",
+    fontStyle: "var(--origam-blockquote__elegant---font-style, italic)",
+    lineHeight: "loose",
+    paddingBlock: "var(--origam-blockquote__elegant---padding-block, 24px)",
+    borderInlineStart: "var(--origam-blockquote__accent---width, 4px) solid var(--origam-blockquote---resolved-accent-color, currentColor)",
+    paddingInlineStart: "calc(var(--origam-blockquote---padding-inline, 24px) + var(--origam-blockquote__accent---width, 4px))"
+  },
+  quoted: {
+    quoteMark: true,
+    paddingTop: "calc(var(--origam-blockquote---padding-block, 16px) + var(--origam-blockquote--quoted---glyph-padding-extra, 1rem))"
+  },
+  minimal: {
+    fontSize: "md",
+    fontStyle: "var(--origam-blockquote__minimal---font-style, italic)",
+    paddingBlock: 0,
+    paddingInline: "var(--origam-blockquote__minimal---padding-inline, 12px)",
+    borderInlineStart: "var(--origam-blockquote--minimal---accent-width, 2px) solid var(--origam-blockquote---resolved-accent-color, currentColor)",
+    paddingInlineStart: "calc(var(--origam-blockquote__minimal---padding-inline, 12px) + var(--origam-blockquote--minimal---accent-width, 2px))"
+  },
+  pull: {
+    fontFamily: "serif",
+    fontSize: "3xl",
+    fontWeight: "medium",
+    lineHeight: "snug",
+    align: "center",
+    paddingBlock: "var(--origam-blockquote__pull---padding-block, 24px)",
+    borderBlock: "var(--origam-blockquote__pull---rule-width, 2px) solid var(--origam-blockquote---resolved-accent-color, currentColor)"
+  }
 };

package/dist/src/consts/Blockquote/blockquote.const.d.ts

@@ -1,4 +1,6 @@
+import type { IBlockquoteProps } from '../../interfaces/Blockquote/blockquote.interface';
 import type { TBlockquoteAlign, TBlockquoteLang, TBlockquoteVariant } from '../../types/Blockquote/blockquote.type';
+import type { TVariantPresets } from '../../types/Commons/variant-preset.type';
 /**
  * Closed list of valid `variant` values for `<OrigamBlockquote>`.
  * Exposed so stories / consumers can iterate the matrix without
@@ -33,5 +35,116 @@ export declare const QUOTE_MARKS_BY_LANG: Record<Exclude<TBlockquoteLang, 'auto'
 export declare const BLOCKQUOTE_DEFAULTS: {
     readonly variant: TBlockquoteVariant;
     readonly lang: TBlockquoteLang;
+    readonly align: TBlockquoteAlign;
     readonly tag: "blockquote";
 };
+/*********************************************************
+ * BLOCKQUOTE_VARIANT_PRESETS
+ *
+ * @description
+ * ADR-005 D7, lot #1015 — le deuxieme composant converti, apres le pilote
+ * `OrigamKbd`. Un variant de Blockquote n'est plus un bloc SCSS : c'est ce
+ * sac de props, resolu au rang le plus faible de la chaine (prop du site
+ * d'appel > defaut de theme > PRESET > `withDefaults`).
+ *
+ * @description
+ * ⛔ CE QUE LA CONVERSION REPARE, ET C'EST SA JUSTIFICATION. Les regles
+ * `--variant-elegant` / `--variant-minimal` / `--variant-pull` declaraient
+ * `font-size` / `font-family` / `font-weight` / `line-height`
+ * DIRECTEMENT, a specificite (0,2,0) — identique a celle de la regle de
+ * base — et plus loin dans l'ordre source. Or `useTypography` n'ecrit pas
+ * ces proprietes : il ecrit la propriete custom
+ * `--origam-blockquote---{propriete}` que la regle de base consomme via
+ * `--resolved-{propriete}`. Les cinq props typographiques etaient donc
+ * VIVANTES sur `default` et `quoted` et MORTES sur les trois autres, sans
+ * aucun diagnostic — alors que la story exposait les cinq controles et que
+ * la doc les documentait.
+ * @description
+ * Verdict navigateur, chromium, Histoire statique, lot #1015 :
+ * `variant="elegant" font-size="sm"` rendait **18px**, exactement comme
+ * `variant="elegant"` nu. Apres conversion la prop gagne. C'est l'une des
+ * deux assertions ROUGE-avant / VERT-apres de `e2e/blockquote.spec.ts`.
+ *
+ * @description
+ * ⛔ CHAQUE VALEUR PORTE LA CHAINE `var()` QUE LA REGLE PORTAIT, partout ou
+ * le canal peut la transporter. `resolveSpacingValue` rend verbatim toute
+ * valeur qui n'est pas un echelon de l'echelle, et
+ * `parseBorderPositionValue` prend `match.width` EN ENTIER — donc les
+ * `calc()` et les largeurs `var(--…, repli)` voyagent telles quelles, et le
+ * canal d'override des themes survit.
+ *
+ * @description
+ * ⛔ LES CINQ VALEURS TYPOGRAPHIQUES SONT L'EXCEPTION, ET ELLE EST
+ * STRUCTURELLE. `useTypography` n'a AUCUNE echappatoire pour une valeur
+ * custom (`typography.composable.ts:210-216`) : il enveloppe toujours en
+ * `var(--origam-font__{groupe}---{valeur})`. Poser
+ * `fontSize: 'var(--origam-blockquote__elegant---font-size, 1.125rem)'`
+ * produirait le nom imbrique
+ * `var(--origam-font__size---var(--origam-blockquote__elegant---font-size, 1.125rem))`,
+ * qu'aucune feuille ne declare, et la declaration serait jetee. La ruse du
+ * pilote Kbd est donc indisponible ici — c'est **#1018**, ouvert, et il
+ * n'est PAS corrige dans ce lot. Seul `fontStyle` echappe, via
+ * `TYPOGRAPHY_PASSTHROUGH_MAP`, et son preset porte donc bien la chaine.
+ * @description
+ * Le cout de cette exception est NUL, et c'est mesure, pas suppose : chacun
+ * des 8 tokens concernes etait un ALIAS byte-pour-byte de l'echelon
+ * semantique que le preset pose a sa place (`__elegant---font-size:
+ * var(--origam-font__size---xl)` -> `fontSize: 'xl'`, et ainsi de suite),
+ * et aucun des 8 themes n'en lisait un seul. Les 8 tokens sortent donc des
+ * 4 feuilles et de `tokens.type.ts`, ce que `token-var-channels` prescrit
+ * lui-meme pour un token que plus rien ne lit.
+ *
+ * @description
+ * ⛔ CE QUE LA TABLE NE POSE PAS EST AUSSI IMPORTANT QUE CE QU'ELLE POSE.
+ * `pull` declarait `padding-inline:
+ * var(--origam-blockquote---resolved-padding-inline)` — une REDONDANCE avec
+ * la regle de base, qui pose exactement la meme valeur. L'inscrire ici
+ * emettrait une declaration INLINE, qui passerait devant la classe
+ * utilitaire qu'un `padding` du consommateur produit : la table
+ * confisquerait le canal qu'elle est censee servir. Valeur calculee
+ * identique des deux cotes tant qu'aucun `padding` n'est passe ; quand il
+ * l'est, l'axe inline de `pull` lui OBEIT desormais, ce qui va dans le sens
+ * du lot.
+ *
+ * @description
+ * ⛔ LES INDIRECTIONS `---resolved-*` NE SORTENT PAS D'ICI quand le token
+ * PUBLIC suffit. Les regles supprimees lisaient
+ * `var(--origam-blockquote---resolved-padding-inline)` et
+ * `var(--origam-blockquote---resolved-padding-block)`, deux proprietes
+ * custom que le bloc `<style scoped>` du composant synthetise lui-meme
+ * (`OrigamBlockquote.vue`, regle `.origam-blockquote`) et qu'AUCUNE feuille
+ * ne declare. Le preset nomme donc directement le token public que ces
+ * indirections resolvent — `--origam-blockquote---padding-inline, 24px` et
+ * `---padding-block, 16px` — ce qui est strictement equivalent par
+ * substitution (verifie : une seule declaration de chacune des deux
+ * indirections dans tout `packages/ds/src`, aucun modificateur ne les
+ * redeclare) et met le preset sur le canal de theme PUBLIC plutot que sur
+ * un detail interne. Le garde `ts-token-refs` cesse par la meme de
+ * rougir sur deux des quatre noms.
+ * @description
+ * ⚠️ `--origam-blockquote---resolved-accent-color` ne PEUT PAS subir le
+ * meme traitement, et c'est la seule entree de baseline que ce lot ajoute :
+ * les huit modificateurs `.origam-blockquote--accent-{intent}` REDECLARENT
+ * cette indirection. Nommer le token sous-jacent
+ * (`--origam-blockquote__accent---color`) rendrait `accent-color="primary"`
+ * inoperant sur le filet — une regression reelle. L'indirection est le
+ * mecanisme meme de l'axe `accentColor`, donc elle reste, avec un repli
+ * `currentColor` plat. ⛔ Un repli IMBRIQUE est exclu : le groupe `color`
+ * de `BORDER_REGEX` s'arrete a la premiere parenthese fermante, donc une
+ * valeur a repli imbrique ne matche pas DU TOUT et rien ne serait emis.
+ *
+ * @description
+ * ⚠️ `--origam-blockquote--minimal---accent-width` n'est declare par AUCUNE
+ * feuille — grammaire divergente, double tiret la ou le reste du composant
+ * ecrit `__`. `minimal` tombe donc toujours sur son repli `2px`. Le preset
+ * porte la chaine TELLE QUELLE : la fidelite est le travail, pas la
+ * correction. C'est **#1014**, et il n'est PAS corrige ici.
+ *
+ * @description
+ * ⚠️ `quoteMark` et `align` sont les deux moities « famille B » de ce
+ * composant — un element monte et un defaut d'alignement. D7 exige qu'elles
+ * passent par une prop COMPORTEMENTALE et que l'exemption soit documentee
+ * SUR la prop : voir leurs JSDoc dans
+ * `interfaces/Blockquote/blockquote.interface.ts`.
+ ********************************************************/
+export declare const BLOCKQUOTE_VARIANT_PRESETS: TVariantPresets<TBlockquoteVariant, IBlockquoteProps>;

package/dist/src/consts/Blockquote/blockquote.const.js

@@ -15,5 +15,42 @@ export const QUOTE_MARKS_BY_LANG = {
 export const BLOCKQUOTE_DEFAULTS = {
   variant: "default",
   lang: "auto",
+  align: "left",
   tag: "blockquote"
 };
+export const BLOCKQUOTE_VARIANT_PRESETS = {
+  default: {
+    borderInlineStart: "var(--origam-blockquote__accent---width, 4px) solid var(--origam-blockquote---resolved-accent-color, currentColor)",
+    paddingInlineStart: "calc(var(--origam-blockquote---padding-inline, 24px) + var(--origam-blockquote__accent---width, 4px))"
+  },
+  elegant: {
+    fontFamily: "serif",
+    fontSize: "xl",
+    fontStyle: "var(--origam-blockquote__elegant---font-style, italic)",
+    lineHeight: "loose",
+    paddingBlock: "var(--origam-blockquote__elegant---padding-block, 24px)",
+    borderInlineStart: "var(--origam-blockquote__accent---width, 4px) solid var(--origam-blockquote---resolved-accent-color, currentColor)",
+    paddingInlineStart: "calc(var(--origam-blockquote---padding-inline, 24px) + var(--origam-blockquote__accent---width, 4px))"
+  },
+  quoted: {
+    quoteMark: true,
+    paddingTop: "calc(var(--origam-blockquote---padding-block, 16px) + var(--origam-blockquote--quoted---glyph-padding-extra, 1rem))"
+  },
+  minimal: {
+    fontSize: "md",
+    fontStyle: "var(--origam-blockquote__minimal---font-style, italic)",
+    paddingBlock: 0,
+    paddingInline: "var(--origam-blockquote__minimal---padding-inline, 12px)",
+    borderInlineStart: "var(--origam-blockquote--minimal---accent-width, 2px) solid var(--origam-blockquote---resolved-accent-color, currentColor)",
+    paddingInlineStart: "calc(var(--origam-blockquote__minimal---padding-inline, 12px) + var(--origam-blockquote--minimal---accent-width, 2px))"
+  },
+  pull: {
+    fontFamily: "serif",
+    fontSize: "3xl",
+    fontWeight: "medium",
+    lineHeight: "snug",
+    align: "center",
+    paddingBlock: "var(--origam-blockquote__pull---padding-block, 24px)",
+    borderBlock: "var(--origam-blockquote__pull---rule-width, 2px) solid var(--origam-blockquote---resolved-accent-color, currentColor)"
+  }
+};

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

@@ -4,8 +4,10 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.VARIANT_PROP_KEY = exports.VARIANT_PRESETS = void 0;
+var _blockquote = require("../Blockquote/blockquote.const.cjs");
 var _kbd = require("../Kbd/kbd.const.cjs");
 const VARIANT_PROP_KEY = exports.VARIANT_PROP_KEY = "variant";
 const VARIANT_PRESETS = exports.VARIANT_PRESETS = {
+  "origam-blockquote": _blockquote.BLOCKQUOTE_VARIANT_PRESETS,
   "origam-kbd": _kbd.KBD_VARIANT_PRESETS
 };

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

@@ -25,12 +25,13 @@ export declare const VARIANT_PROP_KEY = "variant";
  * constitue pas.
  *
  * @description
- * ⛔ UN SEUL COMPOSANT CONVERTI A CE JOUR — `OrigamKbd`, lot 2. Le lot 1
- * d'ADR-005 livre le MECANISME (type partage, rang dans le resolveur,
- * canal `theme.variants`) et aucune conversion : 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 :
+ * ⛔ DEUX COMPOSANTS CONVERTIS A CE JOUR — `OrigamKbd` (lot 2) et
+ * `OrigamBlockquote` (lot #1015). Le lot 1 d'ADR-005 livre le MECANISME
+ * (type partage, rang dans le resolveur, canal `theme.variants`) et aucune
+ * conversion : 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` — FAIT (lot 2). Ses regles de variant posaient des
  *   PROPRIETES CUSTOM que `key-surface` consomme sur la racine ET sur les
@@ -45,8 +46,18 @@ export declare const VARIANT_PROP_KEY = "variant";
  * - `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`.
+ * - `OrigamBlockquote` — FAIT (lot #1015). Les deux reserves que ce
+ *   paragraphe posait se sont reglees sans nouveau mecanisme. Le
+ *   `calc(var(--…) + var(--…))` voyage verbatim : `resolveSpacingValue`
+ *   rend telle quelle toute valeur qui n'est pas un echelon de l'echelle.
+ *   Les regles imbriquees sur `__body` / `__attribution` ne dependaient
+ *   pas du variant mais de la PRESENCE du glyphe, donc elles sont
+ *   reecrites en selecteurs de VOISINAGE (`__mark--bg + __body`,
+ *   `__mark--bg ~ __attribution`) : elles se declenchent sur la condition
+ *   reelle, n'ajoutent aucun alias de classe que `no-variant-css`
+ *   surveillerait, et laissent zero ecart de style calcule sur les quatre
+ *   autres variants. Le vrai obstacle etait ailleurs — `useTypography` n'a
+ *   aucune echappatoire pour une valeur custom (#1018).
  * @description
  * Seul `OrigamBtn` ne peint que des proprietes de racine — mais il depend
  * de `IOpacityProps` / `IBackdropProps` (Q1, absents) et son `ghost` porte

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

@@ -1,5 +1,7 @@
+import { BLOCKQUOTE_VARIANT_PRESETS } from "../Blockquote/blockquote.const.js";
 import { KBD_VARIANT_PRESETS } from "../Kbd/kbd.const.js";
 export const VARIANT_PROP_KEY = "variant";
 export const VARIANT_PRESETS = {
+  "origam-blockquote": BLOCKQUOTE_VARIANT_PRESETS,
   "origam-kbd": KBD_VARIANT_PRESETS
 };

package/dist/src/interfaces/Blockquote/blockquote.interface.d.ts

@@ -78,13 +78,68 @@ export interface IBlockquoteProps extends ICommonsComponentProps, ITagProps, ICo
      */
     lang?: TBlockquoteLang;
     /**
-     * Horizontal alignment of the citation body and attribution. The
-     * `pull` variant forces `'center'` when this prop is left empty;
-     * other variants default to `'left'`.
+     * Horizontal alignment of the citation body and attribution.
      *
-     * @default 'left'
+     * ## ADR-005 D7 — exemption « famille B », documentée ICI et non
+     * implicitement
+     *
+     * `'center'` sur `pull` n'est plus calculé par le composant : c'est
+     * `BLOCKQUOTE_VARIANT_PRESETS.pull.align`, résolu au rang PRESET de la
+     * chaîne. La sémantique est identique à celle du `computed`
+     * `effectiveAlign` qu'il remplace — un `align` écrit au site d'appel
+     * gagne, parce que le rang 1 du résolveur (`if (wasPassed) return
+     * fallback`) précède le rang preset.
+     *
+     * ⚠️ **Rupture, assumée.** Le centrage de `pull` dépend désormais du
+     * résolveur, que seul `createOrigam()` installe. Un consommateur qui
+     * importe le composant sans installer le plugin obtient `'left'` (la
+     * valeur `withDefaults`, qui n'existe que comme plancher sans variant).
+     * Avant la conversion, le `computed` centrait sans plugin.
+     *
+     * @default 'left' — plancher `withDefaults`, que le preset de `pull` bat
      */
     align?: TBlockquoteAlign;
+    /*********************************************************
+     * quoteMark
+     *
+     * @description
+     * Monte le glyphe d'ouverture decoratif en filigrane de fond
+     * (`<span class="origam-blockquote__mark--bg">`), avec la paire de
+     * guillemets que `lang` selectionne.
+     *
+     * @description
+     * ⛔ ADR-005 D7 — EXEMPTION « FAMILLE B », DOCUMENTEE ICI ET NON
+     * IMPLICITEMENT. Ce prop existe parce que `quoted` ne se reduit PAS a
+     * des props de peinture : il MONTE UN ELEMENT. D7 interdit de laisser
+     * cet effet accroche au variant et exige que l'exemption soit ecrite
+     * sur la prop — c'est ce paragraphe.
+     *
+     * @description
+     * Le glyphe est donc pilote par `quoteMark`, et
+     * `BLOCKQUOTE_VARIANT_PRESETS.quoted` le pose a `true`. Deux
+     * consequences voulues : `quoted` reste le raccourci qu'il a toujours
+     * ete, et le glyphe devient atteignable sur N'IMPORTE QUEL variant
+     * (`<origam-blockquote variant="pull" quote-mark>`), ce que le modele
+     * SCSS rendait impossible.
+     *
+     * @description
+     * Les deux regles d'empilement que `quoted` portait (`position:
+     * relative; z-index: 1` sur `__body` et `__attribution`, pour que le
+     * texte passe devant le glyphe) suivent desormais la PRESENCE DU
+     * GLYPHE et non le variant : ce sont des selecteurs de voisinage
+     * (`__mark--bg + __body`, `__mark--bg ~ __attribution`), donc ils se
+     * declenchent exactement quand il y a quelque chose a surmonter, et
+     * laissent zero ecart de style calcule sur les quatre autres variants.
+     *
+     * @description
+     * ⚠️ Le sur-remplissage haut qui laisse de la place au glyphe
+     * (`paddingTop`) reste porte par le preset de `quoted`, pas par ce
+     * prop. `quote-mark` sur un autre variant rend donc le glyphe sans ce
+     * supplement — passer `padding-top` soi-meme le retablit.
+     *
+     * @default false
+     ********************************************************/
+    quoteMark?: boolean;
 }
 /**
  * Slot signatures for `<OrigamBlockquote>`. The `default` slot owns the

package/dist/src/interfaces/CommandPalette/command-palette.interface.d.ts

@@ -1,4 +1,5 @@
 import type { ICommand } from './command.interface';
+import type { IAttachProps } from '../Commons/attach.interface';
 import type { ICommonsComponentProps } from '../Commons/commons.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
 /**
@@ -11,7 +12,7 @@ import type { ITypographyProps } from '../Commons/typography.interface';
  * the listeners so consumers can pass either form interchangeably.
  */
 export type TCommandPaletteHotkey = ReadonlyArray<string> | ReadonlyArray<ReadonlyArray<string>>;
-export interface ICommandPaletteProps extends ICommonsComponentProps, Pick<ITypographyProps, 'fontSize'> {
+export interface ICommandPaletteProps extends ICommonsComponentProps, Pick<ITypographyProps, 'fontSize'>, IAttachProps {
     /** v-model — whether the palette is open. */
     modelValue?: boolean;
     /**

package/dist/src/interfaces/Commons/attach.interface.cjs

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

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

@@ -0,0 +1,30 @@
+/**
+ * `attach` — the teleport target for a component's floating / portal
+ * surface, resolved through `useTeleport()`
+ * (`composables/Commons/teleport.composable.ts`), the SINGLE consumption
+ * point for the whole DS. Extracted from `IOverlayProps` (#attach-
+ * harmonisation) so every component that teleports declares the exact
+ * same surface instead of a half-implemented, hand-rolled `to="body"`.
+ *
+ *   • `true`               → no teleport, render in place.
+ *   • `false` / unset      → `document.body`. Vue's boolean-prop casting
+ *                             defaults an ABSENT prop whose declared type
+ *                             includes `Boolean` to `false` when the
+ *                             component declares no `default` for it — so
+ *                             "not passed" and "passed `false`" resolve
+ *                             identically to `document.body` by design
+ *                             (see `OrigamOverlay`, `OrigamMenu`).
+ *   • a CSS selector string → resolved against `document.querySelector`.
+ *   • an `Element`          → used directly as the teleport container.
+ *   • `null`                → reserved for a component whose OWN default
+ *                             is not `document.body` (`OrigamDrawer`
+ *                             teleports into its `<OrigamLayout>` wrapper
+ *                             by default) and therefore needs a THIRD
+ *                             state, distinguishable from an explicit
+ *                             `false`, to fall back to that non-body
+ *                             default instead. Same tri-state pattern as
+ *                             `IDrawerProps.push` / `.clipped`.
+ */
+export interface IAttachProps {
+    attach?: boolean | string | Element | null;
+}

package/dist/src/interfaces/Drawer/drawer.interface.d.ts

@@ -1,5 +1,6 @@
 import type { IActiveProps } from '../Commons/active.interface';
 import type { IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IAttachProps } from '../Commons/attach.interface';
 import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
 import type { IBorderProps } from '../Commons/border.interface';
 import type { ICommonsComponentEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
@@ -12,7 +13,7 @@ import type { IPaddingProps } from '../Commons/padding.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { IScrimProps } from '../Overlay/overlay-scrim.interface';
 import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
-export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorderProps, IElevationProps, ILayoutItemProps, IRoundedProps, IColorProps, IBgColorProps, IDensityProps, IPaddingProps, IMarginProps, ITransitionComponentProps, IScrimProps, IActiveProps, IHoverProps {
+export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorderProps, IElevationProps, ILayoutItemProps, IRoundedProps, IColorProps, IBgColorProps, IDensityProps, IPaddingProps, IMarginProps, ITransitionComponentProps, IScrimProps, IActiveProps, IHoverProps, IAttachProps {
     disableResizeWatcher?: boolean;
     disableRouteWatcher?: boolean;
     expandOnHover?: boolean;
@@ -60,6 +61,28 @@ export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorder
      *               Drawer before AppBar → drawer full-height.
      */
     clipped?: boolean | null;
+    /**
+     * `attach` — inherited from `IAttachProps`, re-documented here because
+     * `OrigamDrawer`'s DEFAULT target is not `document.body` like the rest
+     * of the Overlay family: it teleports into its `<OrigamLayout>`
+     * ancestor's `.origam-layout__wrapper` (by `id`, via `useLayoutItem`),
+     * or renders inline when no `<OrigamLayout>` ancestor exists (the
+     * "orphan" case).
+     *
+     *   • `null` (default) → keep the layout-wrapper / orphan-inline
+     *               behaviour described above. Declared as the explicit
+     *               `withDefaults` value so Vue's boolean-prop casting —
+     *               which would otherwise force an UNSET `attach` to
+     *               `false` — never overrides it. Same device as `push` /
+     *               `clipped` above.
+     *   • `true`  → render in place, bypassing BOTH the layout teleport
+     *               AND the orphan fallback.
+     *   • `false` → `document.body`, same as the rest of the Overlay
+     *               family — escapes the layout wrapper entirely.
+     *   • a CSS selector `string` / an `Element` → teleport there instead
+     *               of the layout wrapper.
+     */
+    attach?: boolean | string | Element | null;
 }
 /**
  * Emits fired by `<OrigamDrawer>` — v-model on the open state, plus a

package/dist/src/interfaces/Overlay/overlay.interface.d.ts

@@ -1,4 +1,5 @@
 import type { IActivatorProps } from '../Commons/activator.interface';
+import type { IAttachProps } from '../Commons/attach.interface';
 import type { IClickOutsideEmits } from '../Commons/clickOutside.interface';
 import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
 import type { IDimensionProps } from '../Commons/dimension.interface';
@@ -7,9 +8,8 @@ import type { ILocationStrategyProps } from '../Commons/location.interface';
 import type { IScrimProps } from './overlay-scrim.interface';
 import type { IScrollStrategyProps } from '../Commons/scroll.interface';
 import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
-export interface IOverlayProps extends ICommonsComponentProps, IDimensionProps, IActivatorProps, ILocationStrategyProps, IScrollStrategyProps, ILazyProps, ITransitionComponentProps, IScrimProps {
+export interface IOverlayProps extends ICommonsComponentProps, IDimensionProps, IActivatorProps, ILocationStrategyProps, IScrollStrategyProps, ILazyProps, ITransitionComponentProps, IScrimProps, IAttachProps {
     absolute?: boolean;
-    attach?: boolean | string | Element;
     closeOnBack?: boolean;
     contentClass?: string | Array<string>;
     contentProps?: any;

package/dist/src/interfaces/Snackbar/snackbar-group.interface.d.ts

@@ -1,4 +1,5 @@
 import type { Ref } from 'vue';
+import type { IAttachProps } from '../Commons/attach.interface';
 import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
 import type { ISnackbarGroupItem, ISnackbarGroupItemOptions } from './snackbar-group-item.interface';
 import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../types/Snackbar/snackbar-group.type';
@@ -12,7 +13,7 @@ import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../type
  * The component subscribes to its registered stack `id` and re-renders
  * when the underlying `items` ref changes.
  */
-export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
+export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps, IAttachProps {
     /**
      * Identifier of the stack this container renders. Pair with
      * `useSnackbarGroup({ id })` to spawn items into the same stack.

package/dist/src/interfaces/index.cjs

@@ -520,6 +520,17 @@ Object.keys(_align).forEach(function (key) {
     }
   });
 });
+var _attach = require("./Commons/attach.interface.cjs");
+Object.keys(_attach).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _attach[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _attach[key];
+    }
+  });
+});
 var _audio = require("./Commons/audio.interface.cjs");
 Object.keys(_audio).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

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

@@ -45,6 +45,7 @@ export * from './Commons/activator.interface';
 export * from './Commons/active.interface';
 export * from './Commons/adjacent.interface';
 export * from './Commons/align.interface';
+export * from './Commons/attach.interface';
 export * from './Commons/audio.interface';
 export * from './Commons/autocomplete.interface';
 export * from './Commons/backdrop.interface';

package/dist/src/interfaces/index.js

@@ -45,6 +45,7 @@ export * from "./Commons/activator.interface.js";
 export * from "./Commons/active.interface.js";
 export * from "./Commons/adjacent.interface.js";
 export * from "./Commons/align.interface.js";
+export * from "./Commons/attach.interface.js";
 export * from "./Commons/audio.interface.js";
 export * from "./Commons/autocomplete.interface.js";
 export * from "./Commons/backdrop.interface.js";

package/dist/src/themes/origam.theme.cjs

@@ -525,7 +525,16 @@ const origamDarkTheme = exports.origamDarkTheme = {
       text: {
         primary: "#fafafa",
         secondary: "#a3a3a3",
-        tertiary: "#737373",
+        /*********************************************************
+         * #1044 — tertiary corrigé
+         *
+         * @description
+         * Était '#737373' (neutral-500), copié du mode clair sans
+         * réadapter : 4.18:1 sur ce fond, sous AA (4.5:1). Aligné sur
+         * dark.css (neutral-400, 7.85:1) — voir sa note pour la
+         * mesure complète et pourquoi ce rung s'aplatit sur secondary.
+         ********************************************************/
+        tertiary: "#a3a3a3",
         disabled: "#525252",
         inverse: "#0a0a0a",
         onColor: "#ffffff",

package/dist/src/themes/origam.theme.js

@@ -253,7 +253,16 @@ export const origamDarkTheme = {
       text: {
         primary: "#fafafa",
         secondary: "#a3a3a3",
-        tertiary: "#737373",
+        /*********************************************************
+         * #1044 — tertiary corrigé
+         *
+         * @description
+         * Était '#737373' (neutral-500), copié du mode clair sans
+         * réadapter : 4.18:1 sur ce fond, sous AA (4.5:1). Aligné sur
+         * dark.css (neutral-400, 7.85:1) — voir sa note pour la
+         * mesure complète et pourquoi ce rung s'aplatit sur secondary.
+         ********************************************************/
+        tertiary: "#a3a3a3",
         disabled: "#525252",
         inverse: "#0a0a0a",
         onColor: "#ffffff",