origam 2.16.0 → 2.17.1

package/dist/src/interfaces/Parallax/parallax.interface.d.ts

@@ -1,7 +1,39 @@
-import type { IAudioProps, IBorderProps, IBox, IBgColorProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, IParallaxLayerRegistry, IUseAudioProps } from '../../interfaces';
-import type { TParallaxDirection, TParallaxEasing, TParallaxEvent, TPoint } from '../../types';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBox } from '../Commons/box.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDimensionProps } from '../Commons/dimension.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 { IParallaxLayerRegistry } from './parallax-layer.interface';
+import type { IUseAudioProps } from '../Commons/audio.interface';
+import type { TParallaxDirection, TParallaxEasing, TParallaxEvent } from '../../types/Parallax/parallax.type';
+import type { TPoint } from '../../types/Commons/point.type';
 import type { Ref } from 'vue';
-export interface IParallaxProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IDimensionProps, IAudioProps, IUseAudioProps {
+/*********************************************************
+ * IParallaxProps
+ *
+ * @description
+ * ⛔ Cette interface etendait `IAudioProps`, la surface COMPLETE
+ * d'`<OrigamAudio>` : `playlist`, `tracks`, `waveform`, `controls`, `cover`,
+ * `artist`, `album`, `playbackRates`… **29 props declarees et jamais lues**,
+ * a elles seules un quart de la baseline `unconsumed-props` du depot.
+ *
+ * @description
+ * `<OrigamParallax>` a bien un `<audio>`, mais minimal : une bande-son de
+ * fond, pilotee par la seule URL `audio` et le booleen `playAudio`. C'est
+ * exactement ce que `IUseAudioProps` declare, et c'est tout ce que
+ * `useAudio(props)` lit — verifie : le composable ne touche que `props.audio`
+ * et `props.playAudio`.
+ *
+ * @description
+ * L'`extends IAudioProps` est donc retire. Rupture de type pour qui passait
+ * une de ces 29 props — mais elle ne faisait deja rien, silencieusement.
+ * Issue #550, critere C1.
+ ********************************************************/
+export interface IParallaxProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IDimensionProps, IUseAudioProps {
     /**
      * @deprecated Use `duration` instead. `animationDuration` is kept as a
      * silent alias for backwards-compat and will be removed in v3.0.0.
@@ -120,6 +152,14 @@ export interface IParallaxLayerProvide {
      */
     register: (layer: IParallaxLayerRegistry) => void;
     unregister: (id: symbol) => void;
+    /**
+     * Patches a REGISTERED layer's `speed`/`offsetX`/`offsetY` in place —
+     * see #449. `register()` only runs once, at mount; without this, a
+     * reactive change to those props after mount never reaches the
+     * running rAF loop / CSS scroll-driven animation, which both read the
+     * registry entry directly rather than through Vue reactivity.
+     */
+    update: (id: symbol, patch: Pick<IParallaxLayerRegistry, 'speed' | 'offsetX' | 'offsetY'>) => void;
 }
 /*********************************************************
  * Options consumed by `useParallaxRuntime`.

package/dist/src/interfaces/PasswordField/password-field.interface.d.ts

@@ -1,5 +1,12 @@
-import type { IFieldEmits, IFieldSlots, IInputEmits, IInputSlots, IMenuProps, IPasswordRequirement, ITextFieldProps } from '../../interfaces';
-import type { TIcon, TPasswordStrengthLevel } from '../../types';
+import type { IAdjacentInnerEmits } from '../Commons/adjacent.interface';
+import type { IFocusEmits } from '../Commons/focus.interface';
+import type { IFieldSlots } from '../Field/field.interface';
+import type { IInputEmits, IInputSlots } from '../Input/input.interface';
+import type { IMenuProps } from '../Menu/menu.interface';
+import type { IPasswordRequirement } from './password-requirement.interface';
+import type { ITextFieldProps } from '../TextField/text-field.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TPasswordStrengthLevel } from '../../types/PasswordField/password-field.type';
 /**
  * Props for `<OrigamPasswordField>` — a TextField specialised for password
  * entry, with three add-ons over a plain TextField:
@@ -77,7 +84,23 @@ export interface IPasswordFieldProps extends ITextFieldProps {
      */
     minimal?: boolean;
 }
-export interface IPasswordFieldEmits extends IFieldEmits, IInputEmits {
+/*********************************************************
+ * IPasswordFieldEmits
+ *
+ * @description
+ * ⛔ Extends `IFocusEmits` + `IAdjacentInnerEmits` directly rather than the
+ * full `IFieldEmits` — `<OrigamPasswordField>` wraps `<origam-field>`
+ * directly (same shape as TextField) and calls its OWN `useFocus(props)`
+ * and its OWN `useAdjacent(props)` / `useAdjacentInner(props)`, so
+ * `update:focused` / `click:appendInner` / `click:prependInner` are
+ * genuinely emitted at THIS level. `IActiveEmits` (`update:active`) is
+ * deliberately excluded: PasswordField passes its OWN `isActive || isDirty`
+ * computed DOWN to `<origam-field>` as a plain prop, with no
+ * `@update:active` listener wired to relay the child's internal toggle —
+ * declaring it here promised an event nobody ever fired (issue: guard
+ * `unemitted-declarations`, `PasswordField:update:active`).
+ ********************************************************/
+export interface IPasswordFieldEmits extends IFocusEmits, IAdjacentInnerEmits, IInputEmits {
     (e: 'click:control', event: MouseEvent): void;
     (e: 'mousedown:control', event: MouseEvent): void;
     /** Fires when the computed strength level changes (v-model:strength). */

package/dist/src/interfaces/PasswordField/password-strength.interface.d.ts

@@ -1,4 +1,4 @@
-import type { TPasswordStrengthLevel, TPasswordStrengthScore } from '../../types';
+import type { TPasswordStrengthLevel, TPasswordStrengthScore } from '../../types/PasswordField/password-field.type';
 /**
  * Result returned by `computeStrength()` and consumed by
  * `<OrigamPasswordField>` to drive the strength bar UI.

package/dist/src/interfaces/Picker/picker-title.interface.d.ts

@@ -1,5 +1,7 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentProps, ITagProps, ITypographyProps } from "../../interfaces";
-export interface IPickerTitleProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, ITypographyProps {
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+export interface IPickerTitleProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'letterSpacing'> {
     title?: string;
 }
 /** Slot signatures for `<OrigamPickerTitle>`. The default slot wins
@@ -7,3 +9,12 @@ export interface IPickerTitleProps extends ICommonsComponentProps, ITagProps, IC
 export interface IPickerTitleSlots {
     default?: () => any;
 }
+/*********************************************************
+ * IPickerTitleEmits
+ *
+ * @description
+ * `<OrigamPickerTitle>` only ever renders its slot/title text — it
+ * never calls `emit(...)` in its script.
+ ********************************************************/
+export interface IPickerTitleEmits {
+}

package/dist/src/interfaces/Picker/picker.interface.d.ts

@@ -1,4 +1,6 @@
-import type { IBgColorProps, IPickerTitleProps, ISheetProps } from "../../interfaces";
+import type { IBgColorProps } from '../Commons/color.interface';
+import type { IPickerTitleProps } from './picker-title.interface';
+import type { ISheetProps } from '../Sheet/sheet.interface';
 export interface IPickerProps extends ISheetProps, IBgColorProps, IPickerTitleProps {
     landscape?: boolean;
     hideHeader?: boolean;
@@ -10,3 +12,12 @@ export interface IPickerSlots {
     default?: () => any;
     actions?: () => any;
 }
+/*********************************************************
+ * IPickerEmits
+ *
+ * @description
+ * `<OrigamPicker>` is a pure layout shell (header / body / actions grid
+ * around `<OrigamSheet>`) — it never calls `emit(...)` in its script.
+ ********************************************************/
+export interface IPickerEmits {
+}

package/dist/src/interfaces/Progress/progress-circular.interface.d.ts

@@ -1,7 +1,10 @@
-import type { IProgressTypeProps, ISizeProps } from '../../interfaces';
+import type { IProgressTypeProps } from './progress.interface';
+import type { ISizeProps } from '../Commons/size.interface';
 export interface IProgressCircularProps extends IProgressTypeProps, ISizeProps {
     rotate?: string | number;
 }
+export interface IProgressCircularEmits {
+}
 /** Slot signatures for `<OrigamProgressCircular>`. */
 export interface IProgressCircularSlots {
     default?: (data: {

package/dist/src/interfaces/Progress/progress-linear.interface.d.ts

@@ -1,10 +1,25 @@
-import type { ILocationProps, IProgressTypeProps, IRoundedProps } from '../../interfaces';
+import type { ICommonsComponentEmits } from '../Commons/commons.interface';
+import type { ILocationProps } from '../Commons/location.interface';
+import type { IProgressTypeProps } from './progress.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
 export interface IProgressLinearProps extends IProgressTypeProps, IRoundedProps, ILocationProps {
     bufferValue?: number | string;
     clickable?: boolean;
     reverse?: boolean;
     stream?: boolean;
 }
+/*********************************************************
+ * IProgressLinearEmits
+ *
+ * @description
+ * `<OrigamProgressLinear>` genuinely emits `update:modelValue` — when
+ * `clickable` is set, `handleClick` maps the click position to a value
+ * and assigns `progress.value = ...`, which drives `useVModel`'s setter
+ * (`vm.emit('update:modelValue', newValue)`) on this component's own
+ * instance. Not a fantom emit — it fires under real user interaction.
+ ********************************************************/
+export interface IProgressLinearEmits extends ICommonsComponentEmits {
+}
 /** Slot signatures for `<OrigamProgressLinear>`. */
 export interface IProgressLinearSlots {
     default?: (data: {

package/dist/src/interfaces/Progress/progress.interface.d.ts

@@ -1,8 +1,15 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IProgressCircularProps, IProgressLinearProps, ITagProps } from '../../interfaces';
-import type { TProgressType } from '../../types';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IProgressCircularProps } from './progress-circular.interface';
+import type { IProgressLinearProps } from './progress-linear.interface';
+import type { TProgressType } from '../../types/Progress/progress.type';
 export interface IProgressProps extends IProgressLinearProps, IProgressCircularProps {
     type?: TProgressType;
 }
+export interface IProgressEmits {
+}
 /** Slot signatures for `<OrigamProgress>`. */
 export interface IProgressSlots {
     default?: () => any;
@@ -16,9 +23,14 @@ export interface IProgressTypeProps extends ITagProps, ICommonsComponentProps, I
     max?: number | string;
     striped?: boolean;
     /**
-     * Accessible label for the progress bar (aria-label). When omitted,
-     * defaults to `'Loading'`. Pass a localised string via your i18n
-     * provider or the parent component's `labels` mechanism.
+     * Accessible label for the progress bar (aria-label). Carries a
+     * **locale key**, not final text — it is resolved through the DS
+     * `t()` mechanism, so it follows the active locale out of the box.
+     * Defaults to `'origam.loading'`.
+     *
+     * A raw string that matches no key is returned unchanged, so
+     * `label="Uploading photo"` still works for consumers who prefer to
+     * translate on their side.
      */
     label?: string;
 }

package/dist/src/interfaces/QrCode/qr-code.interface.d.ts

@@ -1,5 +1,15 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ISrcObject, IQrCodeLogo, ITagProps } from '../../interfaces';
-import type { TIcon, TQrCodeErrorCorrectionLevel } from '../../types';
+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 { 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 { ISizeProps } from '../Commons/size.interface';
+import type { ISrcObject } from '../Img/img.interface';
+import type { IQrCodeLogo } from './qr-code-logo.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TQrCodeErrorCorrectionLevel } from '../../types/QrCode/qr-code.type';
 /**
  * Per-matrix overrides — applied INSIDE the SVG (modules + quiet
  * zone) independently of the wrapper-level same-name props. Pass via
@@ -150,6 +160,16 @@ export interface IQrCodeSlots {
         size: number;
     }) => any;
 }
+/*********************************************************
+ * IQrCodeEmits
+ *
+ * @description
+ * `<OrigamQrCode>` is a pure SVG renderer — per its own top-of-script
+ * comment it "owns NO state, NO event, NO input". It never calls
+ * `emit(...)` in its script.
+ ********************************************************/
+export interface IQrCodeEmits {
+}
 /**
  * `useQrCode`'s option bag AFTER defaulting — every field resolved to a
  * concrete value, so the SVG builders downstream never re-apply a

package/dist/src/interfaces/Radio/radio-btn.interface.d.ts

@@ -1,9 +1,25 @@
-import type { IClickLabelEmits, ICommonsComponentEmits, ICommonsComponentProps, IFocusEmits, ISelectionControlProps } from '../../interfaces';
-import type { TColor, TIcon } from '../../types';
+import type { IClickLabelEmits, ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { ISelectionControlProps } from '../SelectionControl/selection-control.interface';
+import type { TColor } from '../../types/Commons/color.type';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface IRadioBtnProps extends ICommonsComponentProps, ISelectionControlProps {
 }
-/** Emits fired by `<OrigamRadioBtn>` — same surface as `<OrigamRadio>`. */
-export interface IRadioBtnEmits extends ICommonsComponentEmits, IFocusEmits, IClickLabelEmits {
+/**
+ * Emits fired by `<OrigamRadioBtn>` — same surface as `<OrigamRadio>`.
+ *
+ * ⛔ `IFocusEmits` was REMOVED from this list (LOT 3, unemitted-declarations
+ * guard). It declared `update:focused`, which this component cannot emit:
+ * it has no focus handling at all — no `focus`/`blur` handler, no
+ * `useFocus` call — and `focused` isn't even one of its props. The event
+ * was dead surface: declared, never emitted, impossible to trigger.
+ *
+ * Same precedent as `ICheckboxBtnEmits` (`checkbox-btn.interface.ts`), same
+ * reasoning: not an observable break — a consumer binding `@update:focused`
+ * received nothing before and receives nothing after. The only change is
+ * that the listener now flows through `$attrs` instead of being swallowed
+ * by a declaration that lied about firing it.
+ */
+export interface IRadioBtnEmits extends ICommonsComponentEmits, IClickLabelEmits {
 }
 /** Slot signatures for `<OrigamRadioBtn>` — forwarded, unscoped `default` /
  *  `label`, and the same `input` scope as `<OrigamSelectionControl>`. */

package/dist/src/interfaces/Radio/radio-group.interface.d.ts

@@ -1,4 +1,12 @@
-import type { IBorderProps, ICommonsComponentEmits, ICommonsComponentProps, IElevationProps, IInputProps, IMarginProps, IPaddingProps, IRadioProps, IRoundedProps, ISelectionControlGroupProps } from '../../interfaces';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IInputProps } from '../Input/input.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRadioProps } from './radio.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISelectionControlGroupProps } from '../SelectionControl/selection-control-group.interface';
 export interface IRadioGroupProps extends ICommonsComponentProps, Partial<Omit<IRadioProps, 'trueValue' | 'falseValue'>>, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IInputProps, Partial<Omit<ISelectionControlGroupProps, 'multiple'>> {
 }
 /** Emits fired by `<OrigamRadioGroup>` — v-model de la valeur choisie. */

package/dist/src/interfaces/Radio/radio.interface.d.ts

@@ -1,5 +1,18 @@
-import type { IActiveProps, IAdjacentSlots, IBorderProps, IClickLabelEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IHoverProps, IInputProps, IMarginProps, IPaddingProps, IRadioBtnProps, IRoundedProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IClickLabelEmits, ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IFocusEmits } from '../Commons/focus.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { IInputProps } from '../Input/input.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRadioBtnProps } from './radio-btn.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface IRadioProps extends ICommonsComponentProps, IInputProps, IRadioBtnProps, IDensityProps, IPaddingProps, IMarginProps, IRoundedProps, IColorProps, IBorderProps, IElevationProps, IActiveProps, IHoverProps {
 }
 /** Emits fired by `<OrigamRadio>` — v-model + focus + label click. */

package/dist/src/interfaces/RatingField/rating-field-item.interface.d.ts

@@ -1,5 +1,14 @@
-import type { IBorderProps, IClickEmits, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IClickEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IColorProps } from '../Commons/color.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 { IRippleProps } from '../Commons/ripple.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISizeProps } from '../Commons/size.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface IRatingFieldItemProps extends ICommonsComponentProps, ITagProps, IColorProps, IDensityProps, IRippleProps, ISizeProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, IElevationProps {
     name?: string;
     index?: number;

package/dist/src/interfaces/RatingField/rating-field.interface.d.ts

@@ -1,7 +1,28 @@
-import type { IAdjacentSlots, ICommonsComponentEmits, IInputProps, ILabelProps, IRippleProps, ITagProps } from '../../interfaces';
-import type { TBlock, TIcon } from '../../types';
+import type { IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { ICommonsComponentEmits, ITagProps } from '../Commons/commons.interface';
+import type { IInputProps } from '../Input/input.interface';
+import type { ILabelProps } from '../Label/label.interface';
+import type { IRippleProps } from '../Commons/ripple.interface';
+import type { TBlock } from '../../types/Commons/anchor.type';
+import type { TIcon } from '../../types/Icon/icon.type';
+/*********************************************************
+ * IRatingFieldProps
+ *
+ * @description
+ * `label` is the text of the field's own `<origam-label>`, rendered above
+ * the star row (`OrigamRatingField.vue`, `<origam-label :text="label">`).
+ *
+ * @description
+ * It is declared HERE since the `label` that used to arrive through
+ * `IInputProps → IValidationProps` was removed: a validation mixin carries
+ * no display surface, and `<OrigamInput>` — the one component built from
+ * that mixin alone — renders no label at all. `ILabelProps` below
+ * contributes `text`, which is `<OrigamLabel>`'s OWN prop, not this
+ * field's.
+ ********************************************************/
 export interface IRatingFieldProps extends IInputProps, IRippleProps, ITagProps, ILabelProps {
     name?: string;
+    label?: string;
     itemAriaLabel?: string;
     clearable?: boolean;
     disabled?: boolean;
@@ -22,7 +43,16 @@ export interface IRatingFieldEmits extends ICommonsComponentEmits {
  * Slot signatures for `<OrigamRatingField>` — the wrapping
  * `<OrigamInput>` chrome (`default` / `details` / `messages` /
  * `message`, plus `prepend` / `append`), `label`, and per-item labels
- * (`itemLabel.{index}` / `itemLabel`), all unscoped except `default`.
+ * (`itemLabel.{index}` / `itemLabel`).
+ *
+ * @description
+ * `itemLabel` and `itemLabel.{n}` are scoped with `{ label, index }` —
+ * `label` is the resolved `itemLabels[index]` entry (`undefined` when the
+ * consumer didn't provide one for that position) and `index` is the
+ * item's position in the row. The fallback content
+ * (`<span>{{ itemLabels?.[index] ?? '&nbsp;' }}</span>`) already depends
+ * on both, so an override that can't see them can only render the same
+ * markup for every item — see #452.
  */
 export interface IRatingFieldSlots extends IAdjacentSlots {
     default?: (data: {
@@ -33,7 +63,10 @@ export interface IRatingFieldSlots extends IAdjacentSlots {
         isValid: boolean | undefined;
     }) => any;
     label?: () => any;
-    itemLabel?: () => any;
+    itemLabel?: (data: {
+        label?: string;
+        index: number;
+    }) => any;
     details?: (props: any) => any;
     messages?: (data: {
         hasMessages: boolean;
@@ -42,5 +75,8 @@ export interface IRatingFieldSlots extends IAdjacentSlots {
     message?: (data: {
         message: any;
     }) => any;
-    [key: `itemLabel.${number}`]: (() => any) | undefined;
+    [key: `itemLabel.${number}`]: ((data: {
+        label?: string;
+        index: number;
+    }) => any) | undefined;
 }

package/dist/src/interfaces/Responsive/responsive.interface.d.ts

@@ -1,8 +1,14 @@
-import type { IBorderProps, ICommonsComponentProps, IDimensionProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
 export interface IResponsiveProps extends IDimensionProps, ICommonsComponentProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps {
     aspectRatio?: string | number;
     contentClass?: string;
-    inline?: boolean;
+}
+export interface IResponsiveEmits {
 }
 /** Slot signatures for `<OrigamResponsive>`. */
 export interface IResponsiveSlots {

package/dist/src/interfaces/Select/select.interface.d.ts

@@ -1,5 +1,25 @@
-import type { IAdjacentEmits, IAdjacentInnerEmits, IAdjacentInnerProps, IAdjacentProps, IAdjacentSlots, IBorderProps, IChipProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldProps, IFieldSlots, IFiltersProps, IFocusEmits, IInputProps, IInternalListItem, IItemProps, ILazyProps, IListProps, IMarginProps, IMenuProps, IPaddingProps, IRoundedProps, ITextFieldProps, ITransitionComponentProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { IAdjacentEmits, IAdjacentInnerEmits, IAdjacentInnerProps, IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IChipProps } from '../Chip/chip.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IFieldProps, IFieldSlots } from '../Field/field.interface';
+import type { IFiltersProps } from '../Commons/filters.interface';
+import type { IFocusEmits } from '../Commons/focus.interface';
+import type { IInputProps } from '../Input/input.interface';
+import type { IInternalListItem } from '../List/list-children.interface';
+import type { IItemProps } from '../Commons/item.interface';
+import type { ILazyProps } from '../Commons/lazy.interface';
+import type { IListProps } from '../List/list.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IMenuProps } from '../Menu/menu.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ITextFieldProps } from '../TextField/text-field.interface';
+import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface ISelectProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ITextFieldProps, IDensityProps, IAdjacentProps, IAdjacentInnerProps, IFieldProps, IInputProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IItemProps, ITransitionComponentProps, IFiltersProps, ILazyProps {
     chips?: boolean;
     closableChips?: boolean;

package/dist/src/interfaces/SelectionControl/selection-control-group.interface.d.ts

@@ -1,5 +1,8 @@
-import type { IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IRippleProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IRippleProps } from '../Commons/ripple.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 import { Ref } from 'vue';
 export interface ISelectionControlGroupProps extends ICommonsComponentProps, IColorProps, IDensityProps, IRippleProps {
     disabled?: boolean;

package/dist/src/interfaces/SelectionControl/selection-control.interface.d.ts

@@ -1,5 +1,13 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, ISelectionControlGroupProps, IHoverProps, IRoundedProps } from '../../interfaces';
-import type { TColor, TIcon } from '../../types';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { IRippleProps } from "../Commons/ripple.interface";
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TColor } from '../../types/Commons/color.type';
+import type { TIcon } from '../../types/Icon/icon.type';
 /**
  * `border` / `rounded` / `elevation` (props-first, issue #241) — declared
  * here so `OrigamSelectionControl` (the element that owns the visible
@@ -11,16 +19,23 @@ import type { TColor, TIcon } from '../../types';
  * forward these values down automatically through `filterProps` without
  * any additional wiring.
  */
-export interface ISelectionControlProps extends ICommonsComponentProps, Partial<Omit<ISelectionControlGroupProps, 'items'>>, IColorProps, IBgColorProps, IActiveProps, IHoverProps, IDensityProps, IBorderProps, IRoundedProps, IElevationProps {
+export interface ISelectionControlProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IHoverProps, IDensityProps, IBorderProps, IRoundedProps, IElevationProps, IRippleProps {
     label?: string;
     trueValue?: any;
     falseValue?: any;
     value?: any;
     required?: boolean;
-    /** @deprecated Use the `active` object prop instead. Kept for back-compat. */
-    activeColor?: TColor;
-    /** @deprecated Use the `active` object prop instead. Kept for back-compat. */
-    activeBgColor?: TColor;
+    disabled?: boolean;
+    error?: string | boolean;
+    name?: string;
+    readonly?: boolean;
+    type?: string;
+    modelValue?: any;
+    valueComparator?: (a: any, b: any) => boolean;
+    falseIcon?: TIcon;
+    trueIcon?: TIcon;
+    multiple?: boolean;
+    inline?: boolean;
 }
 export interface ISelectionControlEmits extends ICommonsComponentEmits {
     (e: 'click:label', event: MouseEvent): void;

package/dist/src/interfaces/Sheet/sheet-emits.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IActiveEmits } from '../../interfaces';
-import type { TSheetSnapId } from '../../types';
+import type { IActiveEmits } from '../Commons/active.interface';
+import type { TSheetSnapId } from '../../types/Sheet/sheet.type';
 /**
  * Emit signature for `<OrigamSheet>`.
  *
@@ -9,11 +9,18 @@ import type { TSheetSnapId } from '../../types';
  * - `update:open` is the v-model:open companion — emitted on the
  *   closed/non-closed boundary so two-way binding stays consistent
  *   when the user dismisses via swipe-down.
- * - `update:active` vient de `useActive(props)` : `onActive()` est câblé
- *   sur le clic ET sur `keydown.enter` / `keydown.space` du template, et
- *   écrit dans le v-model `active`. L'émission partait sans être
- *   déclarée. Prouvé au runtime dans
+ * - `update:active` vient de `useStateFlag(props, { state: 'active' })` :
+ *   son `toggle()` est câblé sur `@click` — et UNIQUEMENT là — puis écrit
+ *   dans le v-model `active`. L'émission partait sans être déclarée.
+ *   Prouvé au runtime dans
  *   `packages/tests/TU/origam/relay-emits-declaration.spec.ts`.
+ *
+ *   ⛔ Ce commentaire a longtemps annoncé « le clic ET `keydown.enter` /
+ *   `keydown.space` », et un composable `useActive` qui n'existe plus.
+ *   Ni l'un ni l'autre n'est vrai : le template de `OrigamSheet.vue` ne
+ *   lie que `@click`, et son `tag` par défaut est `div` — donc aucun
+ *   élément natif ne convertit une touche en clic. Le chemin clavier
+ *   n'existe pas.
  */
 export interface ISheetEmits extends IActiveEmits {
     (e: 'update:snap', id: TSheetSnapId): void;

package/dist/src/interfaces/Sheet/sheet-swipe-options.interface.d.ts

@@ -1,5 +1,5 @@
 import type { Ref } from 'vue';
-import type { TSheetSnapId, TSheetSnapPoint } from '../../types';
+import type { TSheetSnapId, TSheetSnapPoint } from '../../types/Sheet/sheet.type';
 /**
  * Options bag passed to `useSheetSwipe()` — the bottom-sheet drag
  * gesture composable.

package/dist/src/interfaces/Sheet/sheet-swipe-return.interface.d.ts

@@ -1,5 +1,5 @@
 import type { Ref } from 'vue';
-import type { TSheetSnapId } from '../../types';
+import type { TSheetSnapId } from '../../types/Sheet/sheet.type';
 /**
  * Public surface returned by `useSheetSwipe()`. Components consuming
  * the composable should bind `currentSnap` to a CSS height variable,

package/dist/src/interfaces/Sheet/sheet.interface.d.ts

@@ -1,5 +1,17 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IHoverProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TDirectionBoth, TSheetSnapId, TSheetSnapPoint } from '../../types';
+import type { IActiveProps } from '../Commons/active.interface';
+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 { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { ILocationProps } from '../Commons/location.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IPositionProps } from '../Commons/position.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TDirectionBoth } from '../../types/Commons/anchor.type';
+import type { TSheetSnapId, TSheetSnapPoint } from '../../types/Sheet/sheet.type';
 export interface ISheetProps extends ITagProps, ICommonsComponentProps, IPaddingProps, IMarginProps, IColorProps, IBgColorProps, IBorderProps, IRoundedProps, IElevationProps, IDimensionProps, ILocationProps, IPositionProps, IActiveProps, IHoverProps {
     /**
      * Edge the sheet is anchored to. Drives the bottom-swipe gesture
@@ -45,4 +57,22 @@ export interface ISheetProps extends ITagProps, ICommonsComponentProps, IPadding
      * by default). Mirrors `OrigamDialog`'s `persistent` semantics.
      */
     persistent?: boolean;
+    /*********************************************************
+     * handleLabel
+     *
+     * @description
+     * Accessible name of the drag handle (its `aria-label`). Carries a
+     * LOCALE KEY, not final text — it is resolved through the DS `t()`
+     * mechanism, so the announcement follows the active locale with no
+     * work from the consumer. Defaults to `'origam.sheet.handle.aria_label'`
+     * ("Drag handle" / "Poignée de déplacement").
+     * @description
+     * A raw string matching no key is returned unchanged, so
+     * `handle-label="Resize the panel"` still works for consumers who
+     * prefer to translate on their side.
+     * @description
+     * Only meaningful when the handle renders at all, i.e. when the sheet
+     * is both `swipeable` and `side="bottom"`.
+     ********************************************************/
+    handleLabel?: string;
 }