origam 2.16.0 → 2.17.0

package/dist/src/interfaces/Main/main.interface.d.ts

@@ -1,4 +1,20 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } 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 { 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';
 export interface IMainProps extends ITagProps, ICommonsComponentProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IDimensionProps, IElevationProps, IBgColorProps, IColorProps {
     scrollable?: boolean;
 }
+/*********************************************************
+ * IMainEmits
+ *
+ * @description
+ * `<OrigamMain>` emits nothing of its own — it's a layout landmark
+ * (scrollable region chrome) with no interactive behaviour.
+ ********************************************************/
+export interface IMainEmits {
+}

package/dist/src/interfaces/Masonry/masonry.interface.d.ts

@@ -1,5 +1,13 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TGridGapSize, TMasonryAlign } 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 { 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 { TGridGapSize } from '../../types/Grid/grid.type';
+import type { TMasonryAlign } from '../../types/Masonry/masonry.type';
 import type { Ref } from 'vue';
 /**
  * Map of `min-width` (px) → number of columns to apply when the
@@ -79,6 +87,16 @@ export interface IMasonryProps extends ICommonsComponentProps, ITagProps, IDimen
      */
     align?: TMasonryAlign;
 }
+/*********************************************************
+ * IMasonryEmits
+ *
+ * @description
+ * `<OrigamMasonry>` emits nothing of its own — layout is either pure
+ * CSS or driven by the internal `useMasonry` bucket-fill, with no
+ * user-facing event surface.
+ ********************************************************/
+export interface IMasonryEmits {
+}
 /**
  * Internal layout descriptor produced by the bucket-fill algorithm.
  * One entry per measured item. Coordinates are expressed in CSS px,

package/dist/src/interfaces/Media/media-controller.interface.d.ts

@@ -1,5 +1,7 @@
-import type { ICommonsComponentProps, IMediaPlayerMethods, IMediaPlayerState } from '../../interfaces';
-import type { TAudioLoopMode, TQualityOption } from '../../types';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IMediaPlayerMethods, IMediaPlayerState } from './media-player.interface';
+import type { TAudioLoopMode } from '../../types/Audio/audio.type';
+import type { TQualityOption } from '../../types/Media/quality-option.type';
 /**
  * Props for `<OrigamMediaController>` — the universal media-controls
  * shell consumed by `<OrigamVideo>` and `<OrigamAudio>`. Both parents

package/dist/src/interfaces/Media/media-player.interface.d.ts

@@ -1,4 +1,4 @@
-import type { Ref } from 'vue';
+import type { MaybeRefOrGetter, Ref } from 'vue';
 /**
  * Reactive state surface returned by `useMediaPlayer` — the
  * media-agnostic base shared between `useVideoPlayer` and
@@ -104,10 +104,30 @@ export interface IMediaPlayerEmits {
  * — `mediaRef` accepts any `HTMLMediaElement` (audio OR video).
  */
 export interface IUseMediaPlayerOptions {
-    /** Suppress autoplay when the user has requested reduced motion. */
-    autoplay?: boolean;
-    /** Initial muted state. */
-    muted?: boolean;
+    /**
+     * Suppress autoplay when the user has requested reduced motion.
+     *
+     * @description
+     * Accepts a plain `boolean`, a `Ref<boolean>`, or a getter
+     * (`() => boolean`) in addition to a literal. `useMediaPlayer` only
+     * reads this value LAZILY, inside `bind()` (`onMounted`) — never at
+     * the composable's own setup time. A caller building this option
+     * from a component prop (e.g. `OrigamAudio`/`OrigamVideo`) MUST pass
+     * a getter (`() => props.autoplay`), not `props.autoplay` itself:
+     * the latter snapshots the value once, before the ADR-005 theme
+     * resolver has had a chance to write a theme default onto
+     * `props.autoplay` (see `theme-props-resolver.composable.ts`) — see
+     * issue #661.
+     */
+    autoplay?: MaybeRefOrGetter<boolean>;
+    /**
+     * Initial muted state.
+     *
+     * @description
+     * Same lazy-read contract as `autoplay` above — pass a getter when
+     * the value is sourced from a component prop.
+     */
+    muted?: MaybeRefOrGetter<boolean>;
     /** Loop on `ended`. */
     loop?: boolean;
     /** Buffering hint. */

package/dist/src/interfaces/Media/media-scrubber.interface.d.ts

@@ -1,5 +1,7 @@
-import type { IColorProps, ICommonsComponentProps, IRoundedProps } from '../../interfaces';
-import type { TMediaScrubberOrientation } from '../../types';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TMediaScrubberOrientation } from '../../types/Media/media-scrubber.type';
 /**
  * Props for `<OrigamMediaScrubber>` — a headless, media-agnostic
  * value-on-a-track widget. Owns NO state: the parent controls

package/dist/src/interfaces/Media/media-volume-control.interface.d.ts

@@ -1,4 +1,8 @@
-import type { ICommonsComponentProps } from '../../interfaces';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISizeProps } from '../Commons/size.interface';
 /**
  * Props for `<OrigamMediaVolumeControl>` — the mute / unmute button
  * AND the YouTube-style vertical scrubber tooltip that opens on
@@ -14,8 +18,33 @@ import type { ICommonsComponentProps } from '../../interfaces';
  * `methods.setVolume()` calls — emits `update:muted` and
  * `update:volume` so the parent stays the source of truth for
  * media-side mutations.
+ *
+ * ## Design surface (#429)
+ *
+ * The component shipped with NO visual prop and NO declared token, so a
+ * theme could reach it neither through `IOrigamTheme.components` (nothing
+ * to name) nor through `IOrigamTheme.vars` (nothing declared) — only a
+ * raw CSS override worked, which inverts the DS's props-first rule.
+ *
+ * It now extends the four Commons surfaces that carry real meaning for a
+ * round icon button, each consumed by its own composable rather than a
+ * hand-rolled parser:
+ *
+ *  - {@link IColorProps}   → `useTextColor`  — the icon / `currentColor`
+ *    channel. The hover wash and the scrubber inside the tooltip are both
+ *    `color-mix(… currentColor …)`, so `color` repaints the whole widget.
+ *  - {@link IRoundedProps} → `useRounded`    — corner radius, `full` by
+ *    default (the historic hardcoded `50%`).
+ *  - {@link ISizeProps}    → `useSize`       — the button box, five rungs
+ *    plus the free-form escape hatch (`size="28px"`, `size={28}`).
+ *  - {@link IDensityProps} → `useDensity`    — a ±8px offset ON TOP of the
+ *    size rung, same grammar as `OrigamBtn` / `OrigamSelectionControl`, so
+ *    a controller row can tighten every control at once.
+ *
+ * Everything else is themeable through the `--origam-media-volume-control*`
+ * tokens declared in `assets/css/tokens/{light,dark}.css`.
  */
-export interface IMediaVolumeControlProps extends ICommonsComponentProps {
+export interface IMediaVolumeControlProps extends ICommonsComponentProps, IColorProps, IRoundedProps, ISizeProps, IDensityProps {
     /**
      * Linear volume in `[0, 1]`. Typically `state.volume.value`.
      * Required.
@@ -66,3 +95,12 @@ export interface IMediaVolumeControlEmits {
      *  to 0 → mute). */
     (e: 'update:volume', volume: number): void;
 }
+/*********************************************************
+ * IMediaVolumeControlSlots
+ *
+ * @description
+ * Slot signatures for `<OrigamMediaVolumeControl>` — none. The button
+ * icon, tooltip and scrubber are entirely driven by props.
+ ********************************************************/
+export interface IMediaVolumeControlSlots {
+}

package/dist/src/interfaces/Menu/menu.interface.d.ts

@@ -1,4 +1,7 @@
-import type { ICommonsComponentEmits, IListItemProps, IListProps, IOverlayProps } from '../../interfaces';
+import type { ICommonsComponentEmits } from '../Commons/commons.interface';
+import type { IListItemProps } from '../List/list-item.interface';
+import type { IListProps } from '../List/list.interface';
+import type { IOverlayProps } from '../Overlay/overlay.interface';
 export interface IMenuProvide {
     register(): void;
     unregister(): void;

package/dist/src/interfaces/Messages/messages.interface.d.ts

@@ -1,5 +1,14 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITransitionComponentProps, ITypographyProps } from '../../interfaces';
-export interface IMessagesProps extends ICommonsComponentProps, ITagProps, ITransitionComponentProps, IColorProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, IDensityProps, IElevationProps, ITypographyProps {
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IColorProps } from '../Commons/color.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';
+import type { ITypographyProps } from '../Commons/typography.interface';
+export interface IMessagesProps extends ICommonsComponentProps, ITagProps, ITransitionComponentProps, IColorProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, IDensityProps, IElevationProps, Pick<ITypographyProps, 'fontSize' | 'lineHeight'> {
     active?: boolean;
     messages?: Array<string> | string;
 }
@@ -8,3 +17,12 @@ export interface IMessagesSlots {
         message: string;
     }) => any;
 }
+/*********************************************************
+ * IMessagesEmits
+ *
+ * @description
+ * `<OrigamMessages>` renders a static list of messages inside a
+ * transition — nothing is emitted.
+ ********************************************************/
+export interface IMessagesEmits {
+}

package/dist/src/interfaces/NumberField/number-field.interface.d.ts

@@ -1,5 +1,9 @@
-import type { IFieldEmits, IFieldProps, IFieldSlots, IInputEmits, IInputProps, IInputSlots, IVariantProps } from "../../interfaces";
-import type { TIcon } from "../../types";
+import type { IAdjacentInnerEmits } from '../Commons/adjacent.interface';
+import type { IFocusEmits } from '../Commons/focus.interface';
+import type { IFieldProps, IFieldSlots } from '../Field/field.interface';
+import type { IInputEmits, IInputProps, IInputSlots } from '../Input/input.interface';
+import type { IVariantProps } from '../Commons/variant.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface INumberFieldProps extends IFieldProps, IInputProps, IVariantProps {
     autofocus?: boolean;
     placeholder?: string;
@@ -20,8 +24,35 @@ export interface INumberFieldProps extends IFieldProps, IInputProps, IVariantPro
     split?: boolean;
     hideControls?: boolean;
     compact?: boolean;
+    /*********************************************************
+     * decrementAriaLabel / incrementAriaLabel
+     *
+     * @description
+     * i18n keys for the compact-mode decrement / increment buttons'
+     * `aria-label` (#459 — previously hardcoded "Decrement" / "Increment"
+     * literals). Default to 'origam.number_field.aria_label.decrement' /
+     * 'origam.number_field.aria_label.increment'.
+     ********************************************************/
+    decrementAriaLabel?: string;
+    incrementAriaLabel?: string;
 }
-export interface INumberFieldEmits extends IFieldEmits, IInputEmits {
+/*********************************************************
+ * INumberFieldEmits
+ *
+ * @description
+ * ⛔ Extends `IFocusEmits` + `IAdjacentInnerEmits` directly rather than the
+ * full `IFieldEmits` — `<OrigamNumberField>` calls its OWN `useFocus(props)`
+ * and its OWN `useAdjacentInner(props)` / `useAdjacent(props)` (see the
+ * component's "click:prepend / click:append relay" comment), so
+ * `update:focused` / `click:appendInner` / `click:prependInner` are
+ * genuinely emitted at THIS level. `IFieldEmits` also carries
+ * `IActiveEmits` (`update:active`), deliberately excluded: NumberField
+ * wraps `<origam-text-field>` (not `<origam-field>` directly) with no
+ * `@update:active` listener anywhere in the template — declaring it here
+ * promised an event nobody ever fired (issue: guard
+ * `unemitted-declarations`, `NumberField:update:active`).
+ ********************************************************/
+export interface INumberFieldEmits extends IFocusEmits, IAdjacentInnerEmits, IInputEmits {
     (e: 'click:control', event: MouseEvent): void;
     (e: 'mousedown:control', event: MouseEvent): void;
     (e: 'click:clear', event: MouseEvent): void;

package/dist/src/interfaces/NumberFormat/number-format.interface.d.ts

@@ -1,5 +1,5 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
-import type { TNumberFormatCompactDisplay, TNumberFormatCurrencyDisplay, TNumberFormatFormat, TNumberFormatLocale, TNumberFormatNotation, TNumberFormatSignDisplay, TNumberFormatUnitDisplay, TNumberFormatUseGrouping } from '../../types';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { TNumberFormatCompactDisplay, TNumberFormatCurrencyDisplay, TNumberFormatFormat, TNumberFormatLocale, TNumberFormatNotation, TNumberFormatSignDisplay, TNumberFormatUnitDisplay, TNumberFormatUseGrouping } from '../../types/NumberFormat/number-format.type';
 /**
  * Props for `<OrigamNumberFormat>` — pure-display i18n number renderer
  * powered by `Intl.NumberFormat` (zero external dep).
@@ -100,6 +100,8 @@ export interface INumberFormatProps extends ICommonsComponentProps, ITagProps {
      */
     signDisplay?: TNumberFormatSignDisplay;
 }
+export interface INumberFormatEmits {
+}
 /**
  * Bindings exposed by the scoped `#default` slot. Consumers use these
  * to highlight specific parts of the formatted output (currency symbol,

package/dist/src/interfaces/OtpInputField/otp-input-field.interface.d.ts

@@ -1,21 +1,82 @@
-import type { IFieldEmits, IFieldProps, IFieldSlots, IInputEmits, IInputProps, IInputSlots, IVariantProps } from "../../interfaces";
-import type { TOtpInputFieldType } from "../../types";
-export interface IOtpInputFieldProps extends IFieldProps, IInputProps, IVariantProps {
+import type { IAdjacentInnerEmits } from '../Commons/adjacent.interface';
+import type { ICommonsComponentEmits } from '../Commons/commons.interface';
+import type { IFocusEmits } from '../Commons/focus.interface';
+import type { IFieldProps, IFieldSlots } from '../Field/field.interface';
+import type { IInputProps, IInputSlots } from '../Input/input.interface';
+import type { IVariantProps } from '../Commons/variant.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { TOtpInputFieldType } from '../../types/OtpInputField/otp-input-field.type';
+/*********************************************************
+ * IOtpInputFieldProps — typography surface narrowed (issue #501)
+ *
+ * @description
+ * `fontWeight` / `lineHeight` / `letterSpacing` / `fontFamily` are typed on
+ * `IFieldProps` / `IInputProps` for THEIR OWN components (where each has a
+ * real effect — see the corrected typography-paint audit, issue #501), but
+ * `<OrigamOtpInputField>` never mounts an `<origam-input>` and only forwards
+ * to its per-cell `<origam-field>` with `label` explicitly excluded (see
+ * `fieldProps()` in `OrigamOtpInputField.vue`) — so none of those values
+ * reach a surface that paints them here.
+ *
+ * @description
+ * Only `fontSize` does (the visible `.origam-otp-input-field__field` cell).
+ * `Omit` strips the inherited surface back down before re-adding exactly
+ * what this component supports.
+ ********************************************************/
+export interface IOtpInputFieldProps extends Omit<IFieldProps, 'fontFamily' | 'fontWeight' | 'lineHeight' | 'letterSpacing'>, Omit<IInputProps, 'fontFamily' | 'fontWeight' | 'lineHeight' | 'letterSpacing'>, IVariantProps, Pick<ITypographyProps, 'fontSize'> {
     autofocus?: boolean;
     divider?: string;
     focusAll?: boolean;
     length?: number | string;
     modelValue?: number | string | null;
     placeholder?: string;
-    persistentPlaceholder?: boolean;
+    /*********************************************************
+     * role
+     *
+     * @description
+     * Rôle ARIA de la racine.
+     *
+     * @description
+     * ⛔ Était déclarée mais JAMAIS lue : le template codait `role="group"`
+     * en dur, donc la passer n'avait aucun effet. Elle est désormais liée,
+     * avec `'group'` pour défaut — la valeur qui était figée.
+     ********************************************************/
     role?: string;
     type?: TOtpInputFieldType;
 }
-export interface IOtpInputFieldEmits extends IFieldEmits, IInputEmits {
+/*********************************************************
+ * IOtpInputFieldEmits
+ *
+ * @description
+ * ⛔ Extends `ICommonsComponentEmits` + `IFocusEmits` + `IAdjacentInnerEmits`
+ * directly — NOT `IFieldEmits` nor `IInputEmits` wholesale.
+ * @description
+ * `update:modelValue` (`ICommonsComponentEmits`) — genuinely alive:
+ * `useVModel(props, 'modelValue', …)` (own call, line ~232). `update:focused`
+ * (`IFocusEmits`) — genuinely alive: `useFocus(props)` (own call, line
+ * ~222).
+ * @description
+ * `click:appendInner` / `click:prependInner` / `click:clear`
+ * (`IAdjacentInnerEmits`) — `<origam-field>` (one per OTP cell) already
+ * emits all three via its own `useAdjacentInner`; `click:clear` was already
+ * relayed explicitly (`handleClear`); `click:appendInner` /
+ * `click:prependInner` are now relayed the same way (see the
+ * `@click:append-inner` / `@click:prepend-inner` listeners added to every
+ * `<origam-field>` cell in the template).
+ * @description
+ * `IActiveEmits` (`update:active`) is deliberately EXCLUDED: with N
+ * `<origam-field>` cells per OTP, there is no single coherent "active"
+ * value to expose, and none is wired. `IAdjacentEmits` (`click:append` /
+ * `click:prepend`, from `IInputEmits`) is deliberately EXCLUDED:
+ * `<OrigamOtpInputField>` never mounts an `<origam-input>` and renders no
+ * outer prepend/append UI at all — there is no path that could ever fire
+ * either event (issue: guard `unemitted-declarations`,
+ * `OtpInputField:click:append,click:prepend`).
+ ********************************************************/
+export interface IOtpInputFieldEmits extends ICommonsComponentEmits, IFocusEmits, IAdjacentInnerEmits {
     (e: 'finish', value: string): void;
     (e: 'click:control', event: MouseEvent): void;
     (e: 'mousedown:control', event: MouseEvent): void;
-    (e: 'click:clear', event: MouseEvent): void;
 }
 export interface IOtpInputFieldSlots extends Omit<IFieldSlots, 'default'>, Omit<IInputSlots, 'default'> {
     /** Generic slot — no slot props. */

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

@@ -1,5 +1,6 @@
-import type { IClickEmits, ICommonsComponentProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
-export interface IOverlayScrimProps extends ICommonsComponentProps, ITagProps, ITransitionComponentProps, IScrimProps {
+import type { IClickEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { ITransitionHostProps } from '../Commons/transition-component.interface';
+export interface IOverlayScrimProps extends ICommonsComponentProps, ITagProps, ITransitionHostProps, IScrimProps {
     active?: boolean;
 }
 export interface IScrimProps {
@@ -12,3 +13,12 @@ export interface IOverlayScrimEmits extends IClickEmits {
     (e: 'mouseenter', event: MouseEvent): void;
     (e: 'mouseleave', event: MouseEvent): void;
 }
+/*********************************************************
+ * IOverlayScrimSlots
+ *
+ * @description
+ * `<OrigamOverlayScrim>` renders a single self-closing backdrop `<div>`
+ * (wrapped in `<OrigamTransition>`) — no `<slot>` in its template.
+ ********************************************************/
+export interface IOverlayScrimSlots {
+}

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

@@ -1,4 +1,12 @@
-import type { IActivatorProps, IClickOutsideEmits, ICommonsComponentEmits, ICommonsComponentProps, IDimensionProps, ILazyProps, ILocationStrategyProps, IScrimProps, IScrollStrategyProps, ITransitionComponentProps } from '../../interfaces';
+import type { IActivatorProps } from '../Commons/activator.interface';
+import type { IClickOutsideEmits } from '../Commons/clickOutside.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { ILazyProps } from '../Commons/lazy.interface';
+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 {
     absolute?: boolean;
     attach?: boolean | string | Element;

package/dist/src/interfaces/Pagination/pagination.interface.d.ts

@@ -1,5 +1,13 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, ISizeProps, ITagProps, ITypographyProps } from "../../interfaces";
-import type { TColor, TIcon } from "../../types";
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentEmits, 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 { ISizeProps } from '../Commons/size.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 /**
  * Deliberately NOT `extends IAdjacentProps`. `IAdjacentProps` models a
  * single leading/trailing pair around one piece of content (`prependIcon`
@@ -11,7 +19,7 @@ import type { TColor, TIcon } from "../../types";
  * `IBtnProps.IAdjacentProps` being consumed by the child, not a surface
  * this component itself exposes.
  */
-export interface IPaginationProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, ISizeProps, IDensityProps, ITypographyProps {
+export interface IPaginationProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, ISizeProps, IDensityProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight'> {
     start?: number;
     modelValue?: number;
     disabled?: boolean;
@@ -74,14 +82,6 @@ export interface IPaginationProps extends ICommonsComponentProps, ITagProps, ICo
      * @default 'origam.pagination.aria_label.page_number'
      */
     pageNumberAriaLabel?: string;
-    /** @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;
-    /** @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;
 }
 /** Emits fired by `<OrigamPagination>` — current page v-model + the four
  *  navigation shortcuts (first / prev / next / last). */

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

@@ -1,5 +1,15 @@
-import type { IBorderProps, IBox, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TAnchor, TAxis, TParallaxElementType, TParallaxEvent, TPoint } from '../../types';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBox } from '../Commons/box.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 { TAnchor } from '../../types/Commons/anchor.type';
+import type { TAxis } from '../../types/Commons/axis.type';
+import type { TParallaxElementType } from '../../types/Parallax/parallax-element.type';
+import type { TParallaxEvent } from '../../types/Parallax/parallax.type';
+import type { TPoint } from '../../types/Commons/point.type';
 export interface IParallaxElementTypeProps {
     type?: TParallaxElementType;
 }
@@ -29,6 +39,15 @@ export interface IParallaxElementMovement {
     maxX?: number;
     maxY?: number;
 }
+/*********************************************************
+ * IParallaxElementEmits
+ *
+ * @description
+ * `<OrigamParallaxElement>` emits nothing of its own — the transform
+ * is purely reactive to the injected parent `<OrigamParallax>` state.
+ ********************************************************/
+export interface IParallaxElementEmits {
+}
 /** Slot signatures for `<OrigamParallaxElement>`. */
 export interface IParallaxElementSlots {
     default?: () => any;

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

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
 export interface IParallaxLayerProps extends ICommonsComponentProps, ITagProps {
     /**
      * Parallax speed multiplier for this layer.
@@ -24,6 +24,16 @@ export interface IParallaxLayerProps extends ICommonsComponentProps, ITagProps {
      */
     zIndex?: number;
 }
+/*********************************************************
+ * IParallaxLayerEmits
+ *
+ * @description
+ * `<OrigamParallaxLayer>` emits nothing of its own — it registers into
+ * the parent `<OrigamParallax>` registry (via `provide`/`inject`) and
+ * is mutated directly by the host's rAF loop, outside Vue emit wiring.
+ ********************************************************/
+export interface IParallaxLayerEmits {
+}
 /** Slot signatures for `<OrigamParallaxLayer>`. */
 export interface IParallaxLayerSlots {
     default?: () => any;

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.