origam 2.16.0 → 2.17.1

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

@@ -68,7 +68,7 @@ export * from './Card/card.enum';
 export * from './InfiniteScroll/infinite-scroll.enum';
 export * from './TextField/text-field.enum';
 export * from './TextareaField/textarea-field.enum';
-export * from './RichToolbar/rich-toolbar.enum';
+export * from './TextareaField/textarea-field-rich-toolbar.enum';
 export * from './Parallax/parallax.enum';
 export * from './Parallax/parallax-element.enum';
 export * from './DataTable/data-table.enum';

package/dist/src/enums/index.js

@@ -68,7 +68,7 @@ export * from "./Card/card.enum.js";
 export * from "./InfiniteScroll/infinite-scroll.enum.js";
 export * from "./TextField/text-field.enum.js";
 export * from "./TextareaField/textarea-field.enum.js";
-export * from "./RichToolbar/rich-toolbar.enum.js";
+export * from "./TextareaField/textarea-field-rich-toolbar.enum.js";
 export * from "./Parallax/parallax.enum.js";
 export * from "./Parallax/parallax-element.enum.js";
 export * from "./DataTable/data-table.enum.js";

package/dist/src/interfaces/Alert/alert.interface.d.ts

@@ -1,6 +1,20 @@
-import type { IAdjacentProps, IAdjacentSlots, IBorderProps, IBgColorProps, IClickCloseEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverEmits, IHoverProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRoundedProps, IStatusProps, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TIcon } from '../../types';
-export interface IAlertProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IBorderProps, IDimensionProps, IPaddingProps, IMarginProps, IDensityProps, IElevationProps, ILocationProps, IPositionProps, IRoundedProps, IStatusProps, IHoverProps, IAdjacentProps, ITypographyProps {
+import type { IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { IClickCloseEmits, ICommonsComponentEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverEmits, 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 { IStatusProps } from '../Commons/status.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+export interface IAlertProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IBorderProps, IDimensionProps, IPaddingProps, IMarginProps, IDensityProps, IElevationProps, ILocationProps, IPositionProps, IRoundedProps, IStatusProps, IHoverProps, IAdjacentProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     closable?: boolean;
     closeIcon?: TIcon;
     closeLabel?: string;

package/dist/src/interfaces/App/app-bar.interface.d.ts

@@ -1,5 +1,9 @@
-import type { ICommonsComponentEmits, IImgProps, ILayoutItemProps, IScrollProps, IToolbarProps } from '../../interfaces';
-import type { TBlock } from "../../types";
+import type { ICommonsComponentEmits } from '../Commons/commons.interface';
+import type { IImgProps } from '../Img/img.interface';
+import type { ILayoutItemProps } from '../Commons/layout.interface';
+import type { IScrollProps } from '../Commons/scroll.interface';
+import type { IToolbarProps } from '../Toolbar/toolbar.interface';
+import type { TBlock } from '../../types/Commons/anchor.type';
 /**
  * A docked AppBar's cross-axis size (`width` for a top/bottom bar) is owned by
  * the layout engine — it always spans `calc(100% - reservedLeft - reservedRight)`
@@ -25,11 +29,27 @@ export interface IAppBarProps extends Omit<IToolbarProps, 'width' | 'minWidth' |
 /** Emits fired by `<OrigamAppBar>` — v-model on the rail/expanded state. */
 export interface IAppBarEmits extends ICommonsComponentEmits {
 }
-/** Slot signatures for `<OrigamAppBar>`. */
+/*********************************************************
+ * IAppBarSlots
+ *
+ * @description
+ * Signatures des slots de `<OrigamAppBar>`. Tous sont RELAYES a
+ * `<origam-toolbar>`, sauf `img` qui est rendu par l'AppBar elle-meme dans
+ * la zone `prepend`.
+ *
+ * @description
+ * ⛔ `title` etait documente et expose par la story (« Slots - Title »)
+ * sans etre declare ici, et le template ne transmettait aucun
+ * `<template #title>` : le contenu du slot etait perdu, jamais rendu. Le
+ * Toolbar declare pourtant bien ce slot (`IToolbarSlots.title`) — il ne
+ * manquait que le relais. Comme sur le Toolbar, le slot l'emporte sur la
+ * prop `title`.
+ ********************************************************/
 export interface IAppBarSlots {
     append?: () => any;
     prepend?: () => any;
     img?: () => any;
+    title?: () => any;
     content?: () => any;
     default?: () => any;
 }

package/dist/src/interfaces/App/app.interface.d.ts

@@ -1,4 +1,5 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps } from '../../interfaces';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
 /**
  * Props for the `<OrigamApp>` application shell.
  *
@@ -19,8 +20,14 @@ export interface IAppProps extends ICommonsComponentProps, IColorProps, IBgColor
     /** IDs of layout items allowed to overlap each other (forwarded to the layout). */
     overlaps?: Array<string>;
 }
-/** Emits fired by `<OrigamApp>` — none beyond the shared component contract. */
-export interface IAppEmits extends ICommonsComponentEmits {
+/**
+ * Emits fired by `<OrigamApp>` — none. The component never calls
+ * `emit(...)`; it only forwards props to `<OrigamLayout>`. Previously
+ * extended `ICommonsComponentEmits` (which declares `update:modelValue`)
+ * even though `<OrigamApp>` has no `modelValue` prop and never fires
+ * it — a phantom emit fixed here.
+ */
+export interface IAppEmits {
 }
 /** Slot signatures for `<OrigamApp>`. */
 export interface IAppSlots {

package/dist/src/interfaces/Audio/audio-player.interface.d.ts

@@ -1,6 +1,18 @@
-import type { Ref } from 'vue';
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IMediaPlayerEmits, IMediaPlayerMethods, IMediaPlayerState, IPaddingProps, IPositionProps, IRoundedProps, ISrcObject, ITagProps, ITypographyProps, IVideoTrack } from '../../interfaces';
-import type { TAudioControls, TAudioLoopMode, TAudioVariant, TCoverPosition } from '../../types';
+import type { MaybeRefOrGetter, Ref } from 'vue';
+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 { IMediaPlayerEmits, IMediaPlayerMethods, IMediaPlayerState } from '../Media/media-player.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IPositionProps } from '../Commons/position.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISrcObject } from '../Img/img.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { IVideoTrack } from '../Video/video-track.interface';
+import type { TAudioControls, TAudioLoopMode, TAudioVariant, TCoverPosition } from '../../types/Audio/audio.type';
 /**
  * Descriptor for a single track in an `<OrigamAudio>` playlist.
  *
@@ -114,7 +126,7 @@ export interface IAudioSlots {
  * (cover + title/artist + transport bar). Designed to drop into a
  * page without surrounding chrome.
  */
-export interface IAudioProps extends ICommonsComponentProps, ITagProps, IRoundedProps, IBorderProps, IDimensionProps, IMarginProps, IPaddingProps, IElevationProps, IPositionProps, IColorProps, IBgColorProps, ITypographyProps {
+export interface IAudioProps extends ICommonsComponentProps, ITagProps, IRoundedProps, IBorderProps, IDimensionProps, IMarginProps, IPaddingProps, IElevationProps, IPositionProps, IColorProps, IBgColorProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight'> {
     /**
      * Visual variant of the audio surface.
      *
@@ -384,8 +396,16 @@ export interface IUseWaveformOptions {
      *
      * - `'use-credentials'` — include cookies / auth headers.
      * - any other value (or `undefined`) — `'same-origin'` semantics.
+     *
+     * @description
+     * Accepts a plain `string`, a `Ref<string>`, or a getter
+     * (`() => string`) — `useWaveform` reads it LAZILY, inside
+     * `compute()`, on every (re-)computation. A caller sourcing this
+     * from a component prop MUST pass a getter (`() => props.crossorigin`)
+     * so a theme default written after `setup()` (ADR-005) is still
+     * picked up the next time `compute()` runs. See issue #661.
      */
-    crossOrigin?: string;
+    crossOrigin?: MaybeRefOrGetter<string | undefined>;
 }
 /**
  * Reactive state surface returned by `useAudioPlayer` (Audio
@@ -421,10 +441,17 @@ export interface IAudioPlayerEmits extends IMediaPlayerEmits {
  * namespace so both can coexist in the public barrel.
  */
 export interface IUseOrigamAudioPlayerOptions {
-    /** 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
+     * Same lazy-read contract as `IUseMediaPlayerOptions.autoplay` —
+     * pass a getter (`() => props.autoplay`) when sourcing this from a
+     * component prop, never the prop value itself (see #661).
+     */
+    autoplay?: MaybeRefOrGetter<boolean>;
+    /** Initial muted state. Same lazy-read contract as `autoplay`. */
+    muted?: MaybeRefOrGetter<boolean>;
     /** Loop on `ended`. */
     loop?: boolean;
     /** Buffering hint. */

package/dist/src/interfaces/Audio/audio-waveform.interface.d.ts

@@ -0,0 +1,36 @@
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+/*********************************************************
+ * IAudioWaveformProps
+ *
+ * @description
+ * Props for `<OrigamAudioWaveform>` — the peak bars painted behind an
+ * audio scrubber.
+ *
+ * @description
+ * Extracted from `OrigamSliderField` on 2026-09-02 (remarque utilisateur,
+ * ligne L169 du classeur d'inspection). It was the ONLY markup the
+ * component's second HTML branch owned that the first did not, and it is
+ * audio-specific by nature: a form slider has no waveform. Keeping it
+ * inside `OrigamSliderField` was what forced that component to carry two
+ * whole template branches instead of one.
+ *
+ * @description
+ * The component is deliberately dumb: it owns no audio state, reads no
+ * media element, and does not know what a "current time" is. It draws
+ * bars and colours them against a percentage its parent computes.
+ *
+ * @description
+ * `peaks` — peak amplitudes, each expected in `[0..1]`. Values outside
+ * that range are clamped and non-finite values become `0`: a waveform is
+ * decorative and must never throw on malformed input. An empty array
+ * renders nothing at all, leaving no empty `<svg>` in the DOM.
+ *
+ * @description
+ * `progress` — playback position as a percentage in `[0..100]`, default
+ * `0`. Bars at or before it are painted `--active`, the rest
+ * `--inactive`.
+ ********************************************************/
+export interface IAudioWaveformProps extends ICommonsComponentProps {
+    peaks?: readonly number[];
+    progress?: number;
+}

package/dist/src/interfaces/Avatar/avatar-group.interface.d.ts

@@ -1,4 +1,16 @@
-import type { IActiveEmits, IActiveProps, IAvatarProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IHoverEmits, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ITagProps } from "../../interfaces";
+import type { IActiveEmits, IActiveProps } from '../Commons/active.interface';
+import type { IAvatarProps } from './avatar.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } 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 { IHoverEmits, IHoverProps } from '../Commons/hover.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';
 export interface IAvatarGroupProps extends ICommonsComponentProps, IDirectionProps, IDensityProps, IRoundedProps, ISizeProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps, IHoverProps, IActiveProps {
     items?: Array<IAvatarProps>;
     max?: number;

package/dist/src/interfaces/Avatar/avatar.interface.d.ts

@@ -1,6 +1,18 @@
-import type { IActiveEmits, IActiveProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverEmits, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ISrcObject, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TIcon } from '../../types';
-export interface IAvatarProps extends ICommonsComponentProps, IDensityProps, IRoundedProps, ISizeProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps, IHoverProps, IActiveProps, ITypographyProps {
+import type { IActiveEmits, IActiveProps } from '../Commons/active.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, 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 { IHoverEmits, IHoverProps } from '../Commons/hover.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 { ITypographyProps } from '../Commons/typography.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+export interface IAvatarProps extends ICommonsComponentProps, IDensityProps, IRoundedProps, ISizeProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps, IHoverProps, IActiveProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     /**
      * Renders an icon inside the avatar (centered). Mutually exclusive
      * with `image` and `text`: image wins, then icon, then text.

package/dist/src/interfaces/Badge/badge.interface.d.ts

@@ -1,4 +1,14 @@
-import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps, ITypographyProps } from '../../interfaces';
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverEmits, IHoverProps } from '../Commons/hover.interface';
+import type { ILocationProps } from '../Commons/location.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { IStatusProps } from '../Commons/status.interface';
+import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
 /**
  * `IAdjacentProps` is pulled in explicitly (not just inherited through
  * `IStatusProps`) because `useStatus()` reads `props.prependIcon` /
@@ -11,7 +21,7 @@ import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, IBgC
  * effect at all despite the SCSS already anticipating an avatar image
  * (`:deep(img)` sizing rule). Only the `prepend` / `append` slots worked.
  */
-export interface IBadgeProps extends ICommonsComponentProps, ITagProps, IBorderProps, IColorProps, IBgColorProps, ILocationProps, IRoundedProps, ITransitionComponentProps, IStatusProps, IHoverProps, IElevationProps, ITypographyProps, IAdjacentProps {
+export interface IBadgeProps extends ICommonsComponentProps, ITagProps, IBorderProps, IColorProps, IBgColorProps, ILocationProps, IRoundedProps, ITransitionComponentProps, IStatusProps, IHoverProps, IElevationProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight'>, IAdjacentProps {
     content?: number | string;
     dot?: boolean;
     floating?: boolean;
@@ -23,8 +33,22 @@ export interface IBadgeProps extends ICommonsComponentProps, ITagProps, IBorderP
     offsetY?: number | string;
 }
 /** Emits fired by `<OrigamBadge>` — clicks on the prepend/append slots
- *  (same contract as `OrigamBtn` / `OrigamAlert`, via `useAdjacent`). */
-export interface IBadgeEmits extends IAdjacentEmits {
+ *  (same contract as `OrigamBtn` / `OrigamAlert`, via `useAdjacent`),
+ *  plus `update:hover` (C7).
+ *
+ *  ⛔ `update:hover` PARTAIT DEJA sans etre declare ici. Badge cable un vrai
+ *  survol — `useStateFlag(props, {state:'hover'})` + `@mouseenter` /
+ *  `@mouseleave` sur la racine — dont `set()` / `unset()` ecrivent a travers
+ *  le v-model. Vue lit le gestionnaire dans `vnode.props`, ou un
+ *  `onUpdate:hover` non declare atterrit quand meme via les attrs : l'emit
+ *  fonctionnait donc PAR ACCIDENT, et Vue le faisait EN PLUS retomber en
+ *  ecouteur natif sur l'element racine.
+ *
+ *  Le declarer aligne trois choses qui divergeaient : le type public, la
+ *  Variant « Events - update:hover » que la story expose depuis toujours
+ *  (OrigamBadge.story.vue:146), et le comportement reel. Mesure : cf.
+ *  packages/tests/TU/components/Badge/badge-hover-emit-declared.spec.ts */
+export interface IBadgeEmits extends IAdjacentEmits, IHoverEmits {
 }
 /** Slot signatures for `<OrigamBadge>`. */
 export interface IBadgeSlots extends IAdjacentSlots {

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

@@ -1,5 +1,12 @@
-import type { IAccentColorProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TBlockquoteAlign, TBlockquoteLang, TBlockquoteVariant } from '../../types';
+import type { IAccentColorProps, 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 { ITypographyProps } from '../Commons/typography.interface';
+import type { TBlockquoteAlign, TBlockquoteLang, TBlockquoteVariant } from '../../types/Blockquote/blockquote.type';
 /**
  * Props for `<OrigamBlockquote>` — typographic citation component.
  *
@@ -91,3 +98,12 @@ export interface IBlockquoteSlots {
     author?: () => any;
     source?: () => any;
 }
+/*********************************************************
+ * IBlockquoteEmits
+ *
+ * @description
+ * Emits fired by `<OrigamBlockquote>` — none. Purely typographic,
+ * renders a native `<blockquote>` with no interactive state.
+ ********************************************************/
+export interface IBlockquoteEmits {
+}

package/dist/src/interfaces/BottomNav/bottom-nav.interface.d.ts

@@ -1,5 +1,20 @@
-import type { IActiveEmits, IActiveProps, IBorderProps, IBtnProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupProps, IHoverEmits, IHoverProps, ILayoutItemProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
-import type { TBottomNavPosition, TNavMode } from '../../types';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBtnProps } from '../Btn/btn.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 { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IGroupProps } from '../Commons/group.interface';
+import type { IHoverEmits, IHoverProps } from '../Commons/hover.interface';
+import type { ILayoutItemProps } from '../Commons/layout.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 { TBottomNavPosition } from '../../types/BottomNav/bottom-nav.type';
+import type { TNavMode } from '../../types/Commons/mode.type';
 export interface IBottomNavProps extends ITagProps, ICommonsComponentProps, IColorProps, IBgColorProps, IPaddingProps, IBorderProps, IElevationProps, IMarginProps, IDimensionProps, IDensityProps, IRoundedProps, ILayoutItemProps, IGroupProps, IHoverProps, IActiveProps, ITransitionComponentProps {
     grow?: boolean;
     mode?: TNavMode;
@@ -13,9 +28,22 @@ export interface IBottomNavProps extends ITagProps, ICommonsComponentProps, ICol
      */
     position?: TBottomNavPosition;
 }
-/** Emits fired by `<OrigamBottomNav>` — active item v-model + hover/active
- *  propagation. */
-export interface IBottomNavEmits extends ICommonsComponentEmits, IActiveEmits, IHoverEmits {
+/** Emits fired by `<OrigamBottomNav>` — visibility v-model (`modelValue`) +
+ *  hover propagation.
+ *
+ *  ⛔ Does NOT extend `IActiveEmits` (#unemitted-declarations lot 2/4).
+ *  `active` state is sourced from `modelValue`
+ *  (`useStateFlag(props, {state: 'active', source: 'modelValue'})` in
+ *  `OrigamBottomNav.vue`), not from the `active` prop — the `active` /
+ *  `activeClass` props (via `IActiveProps`, still extended by
+ *  `IBottomNavProps`) are a PASS-THROUGH default forwarded to child
+ *  `<origam-btn>` items, never a v-model the nav itself writes back to. A
+ *  `update:active` emit therefore had no real writer: verified by mutation
+ *  (`packages/tests/TU/origam/bottom-nav-active-dead.spec.ts`) that no
+ *  interaction ever fires it, while `update:hover` (kept) genuinely does via
+ *  the `useStateFlag`/`useVModel` relay — see
+ *  `guards/lib/dead-emits.mjs`'s `computeStateFlagEmitted()`. */
+export interface IBottomNavEmits extends ICommonsComponentEmits, IHoverEmits {
 }
 /** Slot signatures for `<OrigamBottomNav>`. `item.{index}` (e.g.
  *  `item.0`) overrides a single button by position; `item` is the

package/dist/src/interfaces/Bracket/bracket-competitor-component.interface.d.ts

@@ -1,4 +1,15 @@
-import type { IActiveEmits, IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
+import type { IActiveEmits, 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 { IDensityProps } from '../Commons/density.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverProps } from '../Commons/hover.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 { IBracketCompetitor } from './bracket-competitor.interface';
 /**
  * Props for `<OrigamBracketCompetitor>` — a single competitor row.
@@ -8,7 +19,7 @@ import type { IBracketCompetitor } from './bracket-competitor.interface';
  * dimension, padding, margin) so a standalone row behaves like any
  * other origam component.
  */
-export interface IBracketCompetitorProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IHoverProps, IActiveProps, IRoundedProps, IElevationProps, IBorderProps, IDensityProps, IDimensionProps, IPaddingProps, IMarginProps, ITypographyProps {
+export interface IBracketCompetitorProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IHoverProps, IActiveProps, IRoundedProps, IElevationProps, IBorderProps, IDensityProps, IDimensionProps, IPaddingProps, IMarginProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight'> {
     /**
      * The competitor payload. `null` renders a "TBD" placeholder — used
      * when the match's participant is not yet determined (winner of an
@@ -67,3 +78,12 @@ export interface IBracketCompetitorProps extends ICommonsComponentProps, ITagPro
 export interface IBracketCompetitorEmits extends IActiveEmits {
     (e: 'click', event: MouseEvent | KeyboardEvent): void;
 }
+/*********************************************************
+ * IBracketCompetitorSlots
+ *
+ * @description
+ * `<OrigamBracketCompetitor>` renders a static row (seed / avatar / name /
+ * forfeit / advantage / score) — no `<slot>` in the template.
+ ********************************************************/
+export interface IBracketCompetitorSlots {
+}

package/dist/src/interfaces/Bracket/bracket-match-component.interface.d.ts

@@ -1,5 +1,15 @@
-import type { IActiveEmits, IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TBracketMatchStatus } from '../../types';
+import type { IActiveEmits, 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 { IDensityProps } from '../Commons/density.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TBracketMatchStatus } from '../../types/Bracket/bracket-match.type';
 import type { IBracketCompetitor } from './bracket-competitor.interface';
 import type { IBracketMatch } from './bracket-match.interface';
 /**

package/dist/src/interfaces/Bracket/bracket-match.interface.d.ts

@@ -1,4 +1,4 @@
-import type { TBracketMatchStatus } from '../../types';
+import type { TBracketMatchStatus } from '../../types/Bracket/bracket-match.type';
 import type { IBracketCompetitor } from './bracket-competitor.interface';
 /**
  * Head-start carried into a match by one competitor — the classic

package/dist/src/interfaces/Bracket/bracket-round-component.interface.d.ts

@@ -1,14 +1,17 @@
-import type { ICommonsComponentProps, IDirectionProps, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TIntent } from '../../types';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDirectionProps } from '../Commons/direction.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { TIntent } from '../../types/Commons/intent.type';
 import type { IBracketCompetitor } from './bracket-competitor.interface';
 import type { IBracketMatch } from './bracket-match.interface';
+import type { IBracketMatchCompetitorSlot } from './bracket-match-component.interface';
 import type { IBracketRound } from './bracket-round.interface';
 /**
  * Props for `<OrigamBracketRound>` — a single round (column in
  * horizontal mode, row in vertical mode). Exported so consumers can
  * render a round standalone (e.g. inside a custom layout).
  */
-export interface IBracketRoundProps extends ICommonsComponentProps, ITagProps, IDirectionProps, ITypographyProps {
+export interface IBracketRoundProps extends ICommonsComponentProps, ITagProps, IDirectionProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'letterSpacing'> {
     /** The round payload to render. */
     round: IBracketRound;
     /** Index of the round inside its bracket — drives the vertical offset. */
@@ -47,7 +50,18 @@ export interface IBracketRoundMatchSlot {
     round: IBracketRound;
     isFinal: boolean;
 }
+/*********************************************************
+ * IBracketRoundSlots
+ *
+ * @description
+ * #388 — `competitor` is relayed straight through to each
+ * `<OrigamBracketMatch>` this round renders via its default `match`
+ * slot content. Before this fix `OrigamBracketRound` never forwarded
+ * it: a consumer providing `#competitor` at `OrigamBracket` level saw
+ * the default `OrigamBracketCompetitor` row render anyway.
+ ********************************************************/
 export interface IBracketRoundSlots {
     'round-title'?: (props: IBracketRoundTitleSlot) => any;
     match?: (props: IBracketRoundMatchSlot) => any;
+    competitor?: (props: IBracketMatchCompetitorSlot) => any;
 }

package/dist/src/interfaces/Bracket/bracket-round.interface.d.ts

@@ -1,4 +1,4 @@
-import type { TBracketRoundSide } from '../../types';
+import type { TBracketRoundSide } from '../../types/Bracket/bracket-round.type';
 import type { IBracketMatch } from './bracket-match.interface';
 /**
  * A round (column in horizontal mode, row in vertical mode) of the

package/dist/src/interfaces/Bracket/bracket-surface.interface.d.ts

@@ -1,4 +1,4 @@
-import type { TBracketBorder, TBracketColor, TBracketElevation, TBracketRounded } from '../../types';
+import type { TBracketBorder, TBracketColor, TBracketElevation, TBracketRounded } from '../../types/Bracket/bracket.type';
 /**
  * Prop bag consumed by `bracketSurfaceVars` to paint one match card.
  *

package/dist/src/interfaces/Bracket/bracket.interface.d.ts

@@ -1,5 +1,14 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TBracketConnectorPath, TBracketVariant } 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 { IDensityProps } from '../Commons/density.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 { ITypographyProps } from '../Commons/typography.interface';
+import type { TBracketConnectorPath, TBracketVariant } from '../../types/Bracket/bracket.type';
 import type { IBracketCompetitor } from './bracket-competitor.interface';
 import type { IBracketMatchCompetitorSlot } from './bracket-match-component.interface';
 import type { IBracketMatch } from './bracket-match.interface';
@@ -15,7 +24,7 @@ import type { IBracketRound } from './bracket-round.interface';
  * data and re-render. No internal state is held about scores or
  * winners — the data passed in is the source of truth.
  */
-export interface IBracketProps extends ICommonsComponentProps, ITagProps, IDensityProps, IRoundedProps, IColorProps, IBgColorProps, IBorderProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, ITypographyProps {
+export interface IBracketProps extends ICommonsComponentProps, ITagProps, IDensityProps, IRoundedProps, IColorProps, IBgColorProps, IBorderProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'letterSpacing'> {
     /**
      * Required. Pre-ordered list of rounds. For single-elimination,
      * the rounds are laid out from earliest (e.g. round-of-16) to

package/dist/src/interfaces/Breadcrumb/breadcrumb-divider.interface.d.ts

@@ -1,5 +1,10 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, ISizeProps, ITagProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } 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';
+import type { ISizeProps } from '../Commons/size.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 /** Slot signatures for `<OrigamBreadcrumbDivider>`. */
 export interface IBreadcrumbDividerSlots {
     default?: () => any;
@@ -7,3 +12,12 @@ export interface IBreadcrumbDividerSlots {
 export interface IBreadcrumbDividerProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IDensityProps, IColorProps, IBgColorProps, ISizeProps {
     divider: string | TIcon;
 }
+/*********************************************************
+ * IBreadcrumbDividerEmits
+ *
+ * @description
+ * Emits fired by `<OrigamBreadcrumbDivider>` — none. Purely
+ * presentational, renders the `divider` prop verbatim.
+ ********************************************************/
+export interface IBreadcrumbDividerEmits {
+}

package/dist/src/interfaces/Breadcrumb/breadcrumb-item.interface.d.ts

@@ -1,4 +1,14 @@
-import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { ILinkProps } from '../Commons/router.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
 export interface IBreadcrumbItemProps extends ICommonsComponentProps, ITagProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, ILinkProps, IColorProps, IBgColorProps, IDensityProps, IAdjacentProps, IHoverProps, IActiveProps {
     title: string;
     disabled?: boolean;

package/dist/src/interfaces/Breadcrumb/breadcrumb.interface.d.ts

@@ -1,10 +1,30 @@
-import type { IActiveProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TBreadcrumbItem, TIcon } from '../../types';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, 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 { IHoverProps } from '../Commons/hover.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TBreadcrumbItem } from '../../types/Breadcrumb/breadcrumb.type';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface IBreadcrumbProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps, IHoverProps, IActiveProps {
     disabled?: boolean;
     divider?: string | TIcon;
     items?: Array<TBreadcrumbItem>;
 }
+/*********************************************************
+ * IBreadcrumbEmits
+ *
+ * @description
+ * Emits fired by `<OrigamBreadcrumb>` — none. Item interaction (click,
+ * navigation) is owned by `<OrigamBreadcrumbItem>` / the consumer's
+ * own `item`/`href` handling, not by the list wrapper.
+ ********************************************************/
+export interface IBreadcrumbEmits {
+}
 /** Slot signatures for `<OrigamBreadcrumb>`. `item.{index}` /
  *  `divider.{index}` override a single item/divider by position;
  *  `item` / `divider` are the fallback used by every index without its