origam 2.16.0 → 2.17.1

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

@@ -1,6 +1,20 @@
 import type { ComponentInternalInstance, ComputedRef, CSSProperties, Ref } from 'vue';
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
-import type { TDirectionBoth } from '../../types';
+import type { ICommonsComponentProps } from './commons.interface';
+import type { TDirectionBoth } from '../../types/Commons/anchor.type';
+/*********************************************************
+ * ILayoutProvide / ILayer / ILayerItem / ILayoutItemProps
+ *
+ * @description
+ * Genuinely transverse — consumed via `useLayoutItem` /
+ * `useCreateLayout` (composables/Commons/layout.composable.ts) by
+ * App(Bar), BottomNav, Drawer, and SystemBar, none of which belong to
+ * the Layout family. Stay here.
+ *
+ * @description
+ * `ILayoutProps` (the actual `<OrigamLayout>` props, single consumer)
+ * moved out to `interfaces/Layout/layout.interface.ts` under issue
+ * #364 — it was the one symbol in this file that was NOT transverse.
+ ********************************************************/
 export interface ILayoutProvide {
     register: (vm: ComponentInternalInstance, options: {
         id: string;
@@ -36,10 +50,6 @@ export interface ILayerItem extends ILayer {
     size: number;
     position: TDirectionBoth;
 }
-export interface ILayoutProps extends ICommonsComponentProps, IDimensionProps, IMarginProps, IPaddingProps, IRoundedProps, IElevationProps, IBgColorProps, IColorProps, IBorderProps {
-    overlaps?: Array<string>;
-    fullHeight?: boolean;
-}
 export interface ILayoutItemProps extends ICommonsComponentProps {
     name?: string;
     /**

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

@@ -1,16 +1,17 @@
-import type { ICommonsComponentEmits, ICommonsComponentProps, IDimensionProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
+/*********************************************************
+ * ILazyProps
+ *
+ * @description
+ * Genuinely transverse — `extends ILazyProps` by Tabs (TabPanel),
+ * ExpansionPanel (x3: Panel, Panels, Content), Tooltip, Img, Window
+ * (WindowItem), Select, and Overlay. None of that is the Lazy family.
+ *
+ * @description
+ * `ILazyComponentProps` / `ILazyEmits` / `ILazySlots` (the actual
+ * `<OrigamLazy>` component surface, single consumer) moved out to
+ * `interfaces/Lazy/lazy.interface.ts` under issue #364 — they were the
+ * symbols in this file that were NOT transverse.
+ ********************************************************/
 export interface ILazyProps {
     eager?: boolean;
 }
-export interface ILazyComponentProps extends ICommonsComponentProps, IDimensionProps, ITagProps, ITransitionComponentProps {
-    modelValue?: boolean;
-    options?: IntersectionObserverInit;
-}
-/** Emits fired by `<OrigamLazy>` — v-model fires when the intersection
- *  observer flips the wrapper to "visible". */
-export interface ILazyEmits extends ICommonsComponentEmits {
-}
-/** Slot signatures for `<OrigamLazy>`. */
-export interface ILazySlots {
-    default?: () => any;
-}

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

@@ -1,14 +1,25 @@
-import type { IColorProps, ICommonsComponentProps, ITagProps } from '../../interfaces';
-import type { TLoaderConfig, TLoaderKind, TLoadingValue } from '../../types';
+import type { IColorProps } from './color.interface';
+import type { ICommonsComponentProps, ITagProps } from './commons.interface';
+import type { TLoaderConfig, TLoaderKind, TLoadingValue } from '../../types/Commons/loader.type';
+/*********************************************************
+ * ILoaderProps / IResolvedLoader
+ *
+ * @description
+ * Genuinely transverse — `extends ILoaderProps` by ExpansionPanel
+ * (x3: Panel, Panels, Content), Card, Field, Btn, Switch, and
+ * DataTable (Headers, Rows). `IResolvedLoader` is the `useLoader`
+ * composable's return shape, consumed the same way.
+ *
+ * @description
+ * `ILoaderSlots` (the actual `<OrigamLoader>` slot surface, single
+ * consumer) moved out to `interfaces/Loader/loader.interface.ts`
+ * under issue #364 — it was the one symbol in this file that was NOT
+ * transverse.
+ ********************************************************/
 export interface ILoaderProps extends ICommonsComponentProps, ITagProps, IColorProps {
     loading?: TLoadingValue;
     loadingText?: string;
 }
-/** Slot signatures for `<OrigamLoader>`. */
-export interface ILoaderSlots {
-    loader?: () => any;
-    default?: () => any;
-}
 /**
  * Resolved loader state — what each consumer component reads to decide
  * which renderer to mount and with which props.

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

@@ -1,6 +1,7 @@
 import type { Ref } from 'vue';
-import type { IDimensionProps } from '../../interfaces';
-import type { TAnchor, TLocationStrategy, TLocationStrategyFn } from '../../types';
+import type { IDimensionProps } from './dimension.interface';
+import type { TAnchor } from '../../types/Commons/anchor.type';
+import type { TLocationStrategy, TLocationStrategyFn } from '../../types/Commons/location.type';
 export interface ILocationProps {
     location?: TAnchor;
 }

package/dist/src/interfaces/{Mask/mask-options.interface.d.ts → Commons/mask.interface.d.ts}

@@ -1,5 +1,5 @@
 import type { Ref } from 'vue';
-import type { TMaskTokenKind, TPatternValidator } from '../../types';
+import type { TMaskTokenKind, TPatternValidator } from '../../types/TextField/text-field.type';
 /**
  * Configuration object accepted by `useMask` / the
  * `OrigamTextField.mask` prop in its long form.

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

@@ -0,0 +1,13 @@
+/*********************************************************
+ * IMessageProps
+ *
+ * @description
+ * The prop bag `useMessage` reads from — the `messages` / `errorMessages`
+ * / `hint` triad shared by `OrigamForm` (and any future consumer that
+ * wants the same "what should I display under the field" resolution).
+ ********************************************************/
+export interface IMessageProps {
+    messages?: Array<string> | string;
+    errorMessages?: Array<string> | string;
+    hint?: string;
+}

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

@@ -1,4 +1,4 @@
-import type { TOpenStrategy, TOpenStrategyFns, TSelectStrategy, TSelectStrategyFn } from '../../types';
+import type { TOpenStrategy, TOpenStrategyFns, TSelectStrategy, TSelectStrategyFn } from '../../types/Commons/nested.type';
 export interface INestedProps {
     selectStrategy?: TSelectStrategy | TSelectStrategyFn;
     openStrategy?: TOpenStrategy | TOpenStrategyFns;

package/dist/src/interfaces/{Nuxt → Commons}/nuxt-module.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IOrigamTheme } from '../Theme/origam-theme.interface';
+import type { IOrigamTheme } from './theme.interface';
 /**
  * Options passed by a consumer in `nuxt.config.ts` under the `origam` key.
  *

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

@@ -1,4 +1,4 @@
-import type { TPosition } from '../../types';
+import type { TPosition } from '../../types/Commons/position.type';
 export interface IPositionProps {
     position?: TPosition;
     top?: number | string;

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

@@ -1,4 +1,4 @@
-import type { TRounded } from '../../types';
+import type { TRounded } from '../../types/Commons/rounded.type';
 /**
  * Corner-radius surface.
  *

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

@@ -7,7 +7,7 @@ export interface ILinkProps {
     exact?: boolean;
 }
 export interface ILink extends Omit<Partial<ReturnType<typeof _useLink>>, 'href'> {
-    tag: string;
+    tag: ComputedRef<string>;
     isLink: ComputedRef<boolean>;
     isClickable: ComputedRef<boolean>;
     href: Ref<string | undefined>;

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

@@ -1,4 +1,5 @@
-import type { TScrollBehavior, TScrollStrategy, TScrollStrategyFn } from '../../types';
+import type { TScrollBehavior } from '../../types/Toolbar/toolbar.type';
+import type { TScrollStrategy, TScrollStrategyFn } from '../../types/Commons/scroll.type';
 import type { Ref } from 'vue';
 export interface IScrollProps {
     /**

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

@@ -1,4 +1,4 @@
-import type { TSize } from '../../types';
+import type { TSize } from '../../types/Commons/size.type';
 export interface ISizeProps {
     size?: TSize | number;
 }

package/dist/src/interfaces/Commons/state-effect.interface.d.ts

@@ -1,5 +1,9 @@
-import type { IBorderProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
-import type { TColor } from '../../types';
+import type { IBorderProps } from './border.interface';
+import type { IElevationProps } from './elevation.interface';
+import type { IMarginProps } from './margin.interface';
+import type { IPaddingProps } from './padding.interface';
+import type { IRoundedProps } from './rounded.interface';
+import type { TColor } from '../../types/Commons/color.type';
 /**
  * Shared shape for state-aware visual overrides (`hover`, `active`).
  *

package/dist/src/interfaces/Commons/state-flag.interface.d.ts

@@ -0,0 +1,61 @@
+import type { ComputedRef } from 'vue';
+import type { TStateName } from '../../types/Commons/state-flag.type';
+import type { IStateEffectConfig } from './state-effect.interface';
+/*********************************************************
+ * IStateFlagOptions
+ *
+ * @description
+ * Options for `useStateFlag`. `props` (the object being read) stays a
+ * POSITIONAL first argument on the composable itself — it's the one
+ * parameter every call site has and it can never be confused with
+ * anything else (it's an object, not a string). Every option here is
+ * named, on purpose: the bug this composable fixes is two positional
+ * `string` parameters (`prop`, `name`) that swapped meaning at a call site
+ * and nothing — not TS, not lint, not review — noticed. `state` being a
+ * closed union (`TStateName`) turns that class of mistake into a
+ * `TS2322` compile error instead of a silent runtime drift.
+ *
+ * @description
+ * `state` — identity: drives the class suffix AND the default `source`
+ * prop key.
+ * `source` — prop actually read off `props`. Defaults to `state` (e.g.
+ * `'active'`). Set to `'modelValue'` for Alert/BottomNav/Badge.
+ * `name` — component name used in the emitted class. Defaults to
+ * `getCurrentInstanceName()`.
+ ********************************************************/
+export interface IStateFlagOptions<S extends TStateName> {
+    state: S;
+    source?: string;
+    name?: string;
+}
+/*********************************************************
+ * IStateFlagReturn
+ *
+ * @description
+ * Return shape of `useStateFlag` — same surface for `hover` and `active`.
+ * `isOn` — whether the state is currently engaged (pointer-driven,
+ * toggled, or forced). `config` — the `IStateEffectConfig` object when the
+ * consumer passed one, else `undefined`. `classes` — classes to apply on
+ * the host while the state is engaged.
+ *
+ * @description
+ * `set` engages the state (mirrors legacy `onMouseenter`). `unset`
+ * disengages it (mirrors legacy `onMouseleave`). Both always write
+ * through the v-model for a boolean/undefined value — required so a
+ * plain `v-model:hover`/`v-model:active` keeps emitting.
+ *
+ * @description
+ * `toggle` flips the state (mirrors legacy `onActive`). With no argument,
+ * it toggles exactly like before (v-model write for boolean/undefined,
+ * internal flip for a config object). With `force` (`true`/`false`), it
+ * FORCES `internalToggle` to that value and never touches the v-model —
+ * no `update:{source}` emit, even for a plain boolean prop.
+ ********************************************************/
+export interface IStateFlagReturn {
+    isOn: ComputedRef<boolean>;
+    config: ComputedRef<IStateEffectConfig | undefined>;
+    classes: ComputedRef<string[]>;
+    set: () => void;
+    unset: () => void;
+    toggle: (force?: boolean | null) => void;
+}

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

@@ -1,5 +1,5 @@
-import type { IIconProps } from '../../interfaces';
-import { TStatus, TStatusPosition } from '../../types';
+import type { IIconProps } from '../Icon/icon.interface';
+import { TStatus, TStatusPosition } from '../../types/Commons/status.type';
 export interface IStatusProps extends IIconProps {
     status?: TStatus;
     statusIconPosition?: TStatusPosition;

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

@@ -1,4 +1,4 @@
-import { IConfigurableDocument } from "../../interfaces";
+import { IConfigurableDocument } from './commons.interface';
 export interface IStyleTagOptions extends IConfigurableDocument {
     /**
      * Media query for styles to apply

package/dist/src/interfaces/{Theme/origam-theme.interface.d.ts → Commons/theme.interface.d.ts}

@@ -1,7 +1,8 @@
 import type { Ref } from 'vue';
-import type { IThemeVars, TThemeVars } from '../../types';
-import type { TMode, TTheme } from '../../types/Theme/theme.type';
-import type { IDefault } from '../DefaultProvider/default-provider.interface';
+import type { IThemeVars } from '../../types/Commons/semantic-tree.type';
+import type { TThemeVars } from '../../types/Commons/token-tree.type';
+import type { TMode, TTheme } from '../../types/Commons/theme.type';
+import type { IDefault } from '../DefaultsProvider/defaults-provider.interface';
 /**
  * Shape of the `useTheme()` singleton state.
  *

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

@@ -33,6 +33,21 @@ export interface ITouchStoredHandlers {
     touchend: (e: TouchEvent) => void;
     touchmove: (e: TouchEvent) => void;
 }
+/*********************************************************
+ * ITouchStoredEntry
+ *
+ * @description
+ * What the directive keeps around per component `uid` so `unmounted` (or a
+ * later `updated`) can tear a registration down with the EXACT options it
+ * was registered with. `removeEventListener` only matches a listener on the
+ * (type, callback, capture) triplet — omitting `options` on removal is
+ * equivalent to passing `capture: false`, which silently fails to remove a
+ * listener that was added with `capture: true`.
+ ********************************************************/
+export interface ITouchStoredEntry {
+    handlers: ITouchStoredHandlers;
+    options: AddEventListenerOptions;
+}
 export interface ITouchDirectiveBinding extends Omit<DirectiveBinding, 'value'> {
     value?: ITouchValue;
 }

package/dist/src/interfaces/Commons/transition-component.interface.d.ts

@@ -0,0 +1,50 @@
+import type { TTransitionProps } from '../../types/Transition/transition.type';
+/*********************************************************
+ * ITransitionComponentProps
+ *
+ * @description
+ * The "does this component accept a `transition` override" mixin —
+ * `transition?: boolean | string | TTransitionProps`. Consumed by
+ * `<OrigamTransition>` itself AND, transversally, by Badge, BottomNav,
+ * ColorPickerField, Counter, DatePickerField, Drawer, Img, Messages,
+ * Overlay, Select, Snackbar, Tooltip, and Window — 13 families outside
+ * Transition.
+ *
+ * @description
+ * Issue #364 moved this out of `interfaces/Transition/transition.
+ * interface.ts` into Commons: leaving it there would force every one
+ * of those 13 unrelated families to reach into the Transition module
+ * once #14/ADR-006 splits families into packages — exactly the
+ * inter-family coupling the modularisation work is meant to remove.
+ * `ITransitionProps` (the 14-way shared surface across the Transition
+ * wrapper components themselves — Fade, SlideX/Y, ExpandX/Y,
+ * ScaleRotate, TranslateScale, …) stays in the Transition family: that
+ * sharing is intra-family and does not block the split.
+ ********************************************************/
+export interface ITransitionComponentProps {
+    transition?: boolean | string | TTransitionProps;
+}
+/*********************************************************
+ * ITransitionHostProps
+ *
+ * @description
+ * `ITransitionComponentProps` plus le `disabled` qui coupe la transition.
+ * Reserve a `<OrigamTransition>` lui-meme.
+ *
+ * @description
+ * ⛔ `disabled` vivait dans le mixin, donc les 13 familles qui acceptent une
+ * surcharge de `transition` le declaraient aussi — sans jamais le lire. Verifie
+ * sur les cinq que le garde signalait : Badge, Drawer, Img, Lazy et Messages
+ * rendent bien un `<origam-transition :disabled="…">`, mais avec LEUR PROPRE
+ * valeur calculee (`isLayoutOrphan`, `!isBooted`), jamais `props.disabled`. Le
+ * transmettre aurait ecrase cette logique ; le laisser declare promettait un
+ * effet inexistant.
+ *
+ * @description
+ * La doc de ce fichier disait deja que le mixin repond a « ce composant
+ * accepte-t-il une surcharge de `transition` ? ». `disabled` n'a jamais fait
+ * partie de cette question. Issue #550, critere C1.
+ ********************************************************/
+export interface ITransitionHostProps extends ITransitionComponentProps {
+    disabled?: boolean;
+}

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

@@ -1,4 +1,8 @@
-import type { TFontFamily, TFontSize, TFontWeight, TLetterSpacing, TLineHeight } from '../../types';
+import type { TFontFamily } from '../../types/Commons/font-family.type';
+import type { TFontSize } from '../../types/Commons/font-size.type';
+import type { TFontWeight } from '../../types/Commons/font-weight.type';
+import type { TLetterSpacing } from '../../types/Commons/letter-spacing.type';
+import type { TLineHeight } from '../../types/Commons/line-height.type';
 /**
  * Cross-cutting typography surface — the font equivalent of
  * `IColorProps` / `IBorderProps` / `IMarginProps`. Every prop is optional

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

@@ -1,5 +1,35 @@
-import type { IFocusProps } from '../../interfaces';
-import type { TValidateOn } from '../../types';
+import type { IFocusProps } from './focus.interface';
+import type { TValidateOn } from '../../types/Commons/validation.type';
+/*********************************************************
+ * IValidationProps
+ *
+ * @description
+ * ⛔ `label` used to live here and no longer does. A validation mixin has
+ * no display surface: `useValidation` never read it, and the ONE component
+ * whose whole prop set comes from this mixin — `<OrigamInput>`, via
+ * `IInputProps extends … IValidationProps` — renders no label at all. Its
+ * root is a 4-area grid (prepend / control / append / messages); the
+ * accessible name belongs to the CONTROL handed in through its `#default`
+ * slot, not to the wrapper `<div>`.
+ *
+ * @description
+ * Measured before removing (mount + one tick, `label="PROBE_LABEL"`):
+ * `<label>` elements rendered — Checkbox 1, Switch 1, TextField 2 (static
+ * + floating), RatingField 1, SliderField 1, RadioGroup 1, OrigamInput 0.
+ * So making the wrapper paint one would have given all six a DUPLICATE,
+ * and warning on it fired on `<OrigamCheckbox label>` /
+ * `<OrigamTextField label>` / `<OrigamSwitch label>` — correct calls,
+ * because each of those forwards its own props into `<origam-input>`
+ * through `filterProps`, which only carries keys `<OrigamInput>` declares.
+ * Dropping the declaration is what stops that forwarding at the source.
+ *
+ * @description
+ * The label now sits on the interfaces that actually render one:
+ * `ILabelProps` (`text`), `IFieldProps.label`,
+ * `ISelectionControlProps.label`, and — added with this change, since this
+ * mixin was their only source — `IRatingFieldProps.label` /
+ * `ISliderFieldProps.label`.
+ ********************************************************/
 export interface IValidationProps extends IFocusProps {
     disabled?: boolean;
     /** Field-level error flag. Accepts a `boolean` (error on/off) or a `string`
@@ -8,7 +38,6 @@ export interface IValidationProps extends IFocusProps {
     errorMessages?: Array<string> | string;
     maxErrors?: number | string;
     name?: string;
-    label?: string;
     readonly?: boolean;
     rules?: Array<any>;
     modelValue?: any;

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

@@ -1,4 +1,4 @@
-import type { TVariant, TVariantInput } from '../../types';
+import type { TVariant, TVariantInput } from '../../types/Commons/variant.type';
 /**
  * Mixin props for components that expose a visual variant. The union accepts
  * both action-style variants (`text/flat/elevated/tonal/outlined/plain`) and

package/dist/src/interfaces/ConfirmWrapper/confirm-wrapper.interface.d.ts

@@ -1,4 +1,12 @@
-import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IFocusEmits, IFocusProps, IRoundedProps, IVariantProps } from '../../interfaces';
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDirectionProps } from '../Commons/direction.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IFocusProps } from '../Commons/focus.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { IVariantProps } from '../Commons/variant.interface';
 /**
  * Props for `<OrigamConfirmWrapper>` — a "type-it-twice" form helper that
  * pairs a primary input with a confirmation input and lights up only when
@@ -26,7 +34,20 @@ export interface IConfirmWrapperProps extends ICommonsComponentProps, IAdjacentP
     centerAffix?: boolean;
     label?: string;
 }
-export interface IConfirmWrapperEmits extends ICommonsComponentEmits, IAdjacentEmits, IFocusEmits {
+/*********************************************************
+ * IConfirmWrapperEmits
+ *
+ * @description
+ * Does NOT extend `IFocusEmits`: the component reads the `focused` prop
+ * (from `IFocusProps`, kept below) purely as an externally-driven display
+ * hint — showing the hint text while a consumer says the field is focused
+ * — but never tracks focus itself. There is no `useFocus(props)` call, no
+ * focus/blur listener, nowhere `update:focused` could fire from.
+ * Declaring it anyway would silently break the `@update:focused`
+ * fallthrough for any consumer that tried to listen — same defect class
+ * as the `OrigamCheckboxBtn` `update:focused` fix.
+ ********************************************************/
+export interface IConfirmWrapperEmits extends ICommonsComponentEmits, IAdjacentEmits {
     (e: 'update:confirm', value: any): void;
 }
 export interface IConfirmWrapperSlots extends IAdjacentSlots {

package/dist/src/interfaces/ContextualMenu/contextual-menu.interface.d.ts

@@ -1,3 +1,49 @@
-import type { ICommonsComponentProps, IMenuProps } from "../../interfaces";
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IMenuProps } from '../Menu/menu.interface';
 export interface IContextualMenuProps extends ICommonsComponentProps, IMenuProps {
 }
+export interface IContextualMenuEmits {
+}
+/*********************************************************
+ * Slots — passthrough dynamique, signature d'index OBLIGATOIRE
+ *
+ * @description
+ * ⛔ NE PAS remettre `IContextualMenuSlots {}` ici. Une interface vide
+ * ne compile pas sur ce composant : le template fait
+ * `v-for="(_, name) in $slots"` et indexe donc `$slots` avec une chaine.
+ * Sans signature d'index, `vue-tsc` leve :
+ *
+ *     OrigamContextualMenu.vue(19,6): error TS7053 — Element implicitly
+ *     has an 'any' type because expression of type 'string' can't be used
+ *     to index type 'IContextualMenuSlots'.
+ *
+ * @description
+ * Avant que `defineSlots` ne soit pose sur ce composant, `$slots` etait
+ * non type et l'indexation dynamique passait. La typer l'a rendue
+ * verifiable — et donc refusable. C'est le typage qui a revele le trou,
+ * pas qui l'a cree.
+ *
+ * @description
+ * La signature est volontairement lache : c'est inherent a un passthrough
+ * dynamique, pas un raccourci. `<OrigamContextualMenu>` forwarde TEL QUEL
+ * n'importe quel slot nomme vers le `<OrigamMenu>` interne, y compris des
+ * noms que Menu ne documente pas. Une interface vide serait donc doublement
+ * fausse : incompilable, et menteuse sur la surface acceptee. Pour les
+ * formes de slots qui atteignent reellement le DOM en aval, lire
+ * `IMenuSlots` dans `interfaces/Menu/menu.interface.ts`.
+ *
+ * @description
+ * ⛔ ET RETIRER LA SIGNATURE NE REPARE RIEN — ca fait seulement cesser
+ * `vue-tsc` de regarder. Comme il verifie tout le paquet en une passe,
+ * ce seul fichier bloquait la porte type-check pour TOUT le catalogue,
+ * pas seulement pour ce composant : les six lots du chantier
+ * `defineEmits`/`defineSlots` etaient bloques par cette unique ligne.
+ *
+ * @description
+ * Cette forme a ete trouvee DEUX FOIS INDEPENDAMMENT — par le
+ * coordinateur et par un agent du lot 5 — a l'identique, signature
+ * comprise. Ce n'est pas une preference : c'est la seule qui compile.
+ ********************************************************/
+export interface IContextualMenuSlots {
+    [name: string]: ((props: any) => any) | undefined;
+}

package/dist/src/interfaces/Counter/counter.interface.d.ts

@@ -1,4 +1,12 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITransitionComponentProps } from "../../interfaces";
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
 export interface ICounterProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IColorProps, IBgColorProps, IElevationProps, IDensityProps, ITransitionComponentProps {
     active?: boolean;
     disabled?: boolean;
@@ -15,3 +23,12 @@ export interface ICounterSlots {
         value: string | number;
     }) => any;
 }
+/*********************************************************
+ * ICounterEmits
+ *
+ * @description
+ * Emits fired by `<OrigamCounter>` — none. Purely presentational,
+ * displays `value` / `max` without owning any interactive state.
+ ********************************************************/
+export interface ICounterEmits {
+}

package/dist/src/interfaces/DataList/data-list.interface.d.ts

@@ -1,7 +1,19 @@
-import type { IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDataListKVItem, IDataTextProps, IDataTitleProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITypographyProps } from "../../interfaces";
-import type { TDataListMode } from "../../types";
+import type { IAdjacentProps } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDataListKVItem } from './data-list-kv-item.interface';
+import type { IDataTextProps } from './data-text.interface';
+import type { IDataTitleProps } from './data-title.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { TDataListMode } from '../../types/DataList/data-list.type';
 export type { TDataListMode } from "../../types/DataList/data-list.type";
-export interface IDataListProps extends ICommonsComponentProps, IAdjacentProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IDensityProps, IBorderProps, IRoundedProps, IElevationProps, ITypographyProps {
+export interface IDataListProps extends ICommonsComponentProps, IAdjacentProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IDensityProps, IBorderProps, IRoundedProps, IElevationProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     /**
      * Selects the layout. Defaults to `"avatar"` so existing call sites
      * keep their current rendering. Set to `"kv"` for the PDF-aligned
@@ -38,6 +50,17 @@ export interface IDataItem extends IAdjacentProps {
  * signatures alongside the un-indexed fallback names (`item`, `key`,
  * `value`, `item.title`, …) the template also checks.
  */
+/*********************************************************
+ * IDataListEmits
+ *
+ * @description
+ * `<OrigamDataList>` emits nothing of its own — both layout modes
+ * (avatar / kv) are purely presentational, driven entirely by the
+ * `items` prop. Kept empty (not extending `ICommonsComponentEmits`)
+ * to avoid declaring a phantom `update:modelValue`.
+ ********************************************************/
+export interface IDataListEmits {
+}
 export interface IDataListSlots {
     default?: (data: {
         items: Array<IDataItem>;

package/dist/src/interfaces/DataList/data-text.interface.d.ts

@@ -1,11 +1,20 @@
-import type { IAdjacentProps, IAdjacentSlots, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps } from "../../interfaces";
-import type { TColor } from "../../types";
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
 export interface IDataTextProps extends ICommonsComponentProps, IAdjacentProps, IDensityProps, IMarginProps, IPaddingProps, IColorProps, IBgColorProps {
     text: string | number;
-    /** @deprecated Use the `hover` object prop instead. Kept for back-compat. */
-    hoverColor?: TColor;
-    /** @deprecated Use the `hover` object prop instead. Kept for back-compat. */
-    hoverBgColor?: TColor;
+}
+/*********************************************************
+ * IDataTextEmits
+ *
+ * @description
+ * Emits fired by `<OrigamDataText>` — the prepend/append icon or
+ * avatar zones relay `click:prepend` / `click:append` via `useAdjacent`.
+ ********************************************************/
+export interface IDataTextEmits extends IAdjacentEmits {
 }
 /** Slot signatures for `<OrigamDataText>`. */
 export interface IDataTextSlots extends IAdjacentSlots {