origam 2.3.0 → 2.5.0

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

@@ -0,0 +1,406 @@
+import type { Ref } from 'vue';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IMediaPlayerEmits, IMediaPlayerMethods, IMediaPlayerState, IPaddingProps, IPositionProps, IRoundedProps, ISrcObject, ITagProps, IVideoTrack } from '../../interfaces';
+import type { TAudioControls, TAudioLoopMode, TAudioVariant, TCoverPosition } from '../../types';
+/**
+ * Descriptor for a single track in an `<OrigamAudio>` playlist.
+ *
+ * The `src` field is mandatory; everything else is optional metadata
+ * surfaced on the player chrome when the track becomes active.
+ * `cover` defaults to the consumer-level `cover` prop when unset,
+ * `title` / `artist` / `album` fall back to the matching root props.
+ */
+export interface IAudioTrack {
+    /** Absolute or root-relative audio URL (or an array for codec
+     *  fallback / a single `{ src, type }` descriptor). */
+    src: string | IAudioSource | Array<IAudioSource>;
+    /** Display title for this track. Falls back to the root `title`
+     *  prop when omitted. */
+    title?: string;
+    /** Display artist. Falls back to the root `artist` prop. */
+    artist?: string;
+    /** Display album. Falls back to the root `album` prop. */
+    album?: string;
+    /** Cover image URL. Falls back to the root `cover` prop. */
+    cover?: string;
+    /** Optional pre-known duration in seconds (shown in the playlist
+     *  list before the audio is loaded). Once metadata loads the
+     *  runtime duration overrides this value for the active track. */
+    duration?: number;
+    /** Optional stable identifier — used as the `<li>` key in the
+     *  playlist list. Defaults to the array index when omitted. */
+    id?: string | number;
+}
+/**
+ * A single `<source>` entry when the consumer passes multiple audio
+ * URLs (typically one `mp3` + one `ogg` so the browser picks
+ * whichever codec it can decode).
+ *
+ * Mirrors `IVideoSource` minus the video-specific fields
+ * (`quality`, `label`).
+ */
+export interface IAudioSource {
+    /** Absolute or root-relative URL to the audio file. */
+    src: string;
+    /**
+     * MIME type — `"audio/mpeg"`, `"audio/ogg"`, `"audio/wav"`,
+     * `"application/vnd.apple.mpegurl"` for HLS, etc. Optional but
+     * recommended: it lets the browser skip sources it can't decode
+     * without a network round-trip.
+     */
+    type?: string;
+}
+/**
+ * Bindings handed to the `#controls` scoped slot of `<OrigamAudio>`.
+ * State is exposed as plain unwrapped values (snapshot at render
+ * time) — Vue's render-driven reactivity re-invokes the slot on
+ * every meaningful change.
+ */
+export interface IAudioScopedSlotBindings {
+    playing: boolean;
+    paused: boolean;
+    currentTime: number;
+    duration: number;
+    buffered: number;
+    volume: number;
+    muted: boolean;
+    playbackRate: number;
+    loading: boolean;
+    error: MediaError | Error | null;
+    methods: IAudioPlayerMethods;
+}
+/**
+ * Slot signatures for `<OrigamAudio>`.
+ */
+export interface IAudioSlots {
+    /** Override the entire title/artist/cover strip. */
+    metadata?: () => any;
+    /** Override the cover image / placeholder. */
+    cover?: () => any;
+    /** Override the title rendering. */
+    title?: () => any;
+    /** Override the default waveform `<canvas>` painter. Receives the
+     *  current peaks array + the playhead context so the consumer can
+     *  paint via SVG / WebGL / a custom canvas pass. Ported from
+     *  `ISoundSlots.waveform`. */
+    waveform?: (bindings: {
+        peaks: Array<number>;
+        currentTime: number;
+        duration: number;
+    }) => any;
+    /** Override the entire controls (replaces the default
+     *  `<OrigamMediaController>`). */
+    controls?: (bindings: IAudioScopedSlotBindings) => any;
+    /** Overlay rendered while the media is loading. */
+    loading?: () => any;
+    /** Overlay rendered when an error occurred. */
+    error?: (bindings: {
+        error: MediaError | Error;
+    }) => any;
+}
+/**
+ * Props for `<OrigamAudio>` — composes the headless `useAudioPlayer`
+ * with `<OrigamMediaController>` to paint an opinionated audio card
+ * (cover + title/artist + transport bar). Designed to drop into a
+ * page without surrounding chrome.
+ */
+export interface IAudioProps extends ICommonsComponentProps, ITagProps, IRoundedProps, IBorderProps, IMarginProps, IPaddingProps, IElevationProps, IPositionProps, IColorProps, IBgColorProps {
+    /**
+     * Visual variant of the audio surface.
+     *
+     * - `'expanded'` — full Stemtracks studio strip: 96 px cover,
+     *                  title / artist / album header, waveform mini
+     *                  scrubber above the transport row.
+     * - `'compact'`  — slim transport-only dock: 48 px cover, inline
+     *                  metadata, no waveform, transport row only.
+     *
+     * Legacy `'normal'` / `'minimal'` alias values remain accepted for
+     * backward compatibility and resolve to `'expanded'` / `'compact'`.
+     *
+     * @default 'expanded'
+     */
+    variant?: TAudioVariant;
+    /**
+     * Side of the surface where the album cover is painted. The
+     * controller column sits on the opposite side. Swap to keep the
+     * cover next to the page edge (e.g. against a left sidebar).
+     *
+     * @default 'left'
+     */
+    coverPosition?: TCoverPosition;
+    /**
+     * Media URL — either a single string for `<audio src>`, an
+     * `IAudioSource` object (`{ src, type }`), or an array of sources
+     * for codec fallback. The browser walks the array top-down and
+     * picks the first source whose `type` it can decode.
+     */
+    src: string | IAudioSource | Array<IAudioSource>;
+    /**
+     * Optional captions / chapters tracks attached to the `<audio>`.
+     * Reuses the video track shape (kind / src / srclang / label /
+     * default) so consumers learn the API once.
+     *
+     * @default []
+     */
+    tracks?: Array<IVideoTrack>;
+    /**
+     * Optional title shown above the controls (e.g. `"Podcast Episode 42"`).
+     */
+    title?: string;
+    /**
+     * Optional artist / author shown next to the title.
+     */
+    artist?: string;
+    /**
+     * Optional album name shown below the artist (ported from
+     * `ISoundMetadata.album`). Renders only when set.
+     */
+    album?: string;
+    /**
+     * Optional cover image shown next to the title. Accepts a URL
+     * string or an `ISrcObject` for srcset / lazy-src support.
+     */
+    cover?: string | ISrcObject;
+    /**
+     * Display the computed waveform above the controls. Pass `true`
+     * to force the computation (when supported); pass `'auto'` to
+     * activate it only when the browser supports `OfflineAudioContext`.
+     * SSR + jsdom fall through to `false`.
+     *
+     * The decoder lives in `useWaveform` — fetch + decode through
+     * `OfflineAudioContext` + downsample channel 0 to 200 peaks.
+     *
+     * @default false
+     */
+    waveform?: boolean | 'auto';
+    /**
+     * Stroke colour for the *played* portion of the waveform bars.
+     * Default `'currentColor'` so the waveform inherits the
+     * typographic theme. Override via the prop OR via
+     * `--origam-audio__waveform---color-played` directly on the wrapper.
+     *
+     * @default 'currentColor'
+     */
+    waveformColor?: string;
+    /**
+     * Starts playback as soon as `loadedmetadata` fires. Most
+     * browsers require `muted=true` alongside `autoplay`; the
+     * component forces `muted=true` when the consumer asks for
+     * autoplay without an explicit `muted` value.
+     *
+     * **Accessibility:** `autoplay` is suppressed when the user has
+     * requested reduced motion.
+     *
+     * @default false
+     */
+    autoplay?: boolean;
+    /**
+     * Starts the player muted.
+     *
+     * @default false
+     */
+    muted?: boolean;
+    /**
+     * Legacy loop flag. When `true` is mapped to `loopMode='one'` at
+     * runtime so a v0.x consumer keeps the "loop this track forever"
+     * behaviour without source change. Prefer `loopMode` for new code.
+     *
+     * @deprecated Use `loopMode` instead.
+     * @default false
+     */
+    loop?: boolean;
+    /**
+     * Tri-state loop strategy when a playlist is active. Cycled by the
+     * loop button in the transport row:
+     *   - `'none'` → no loop, playback stops after the last track
+     *   - `'all'`  → loop the playlist, wrap from last to first
+     *   - `'one'`  → loop the current track on its own `ended`
+     *
+     * For a single-track usage (`src` only, no `playlist`), `'one'`
+     * keeps the legacy `loop` behaviour and `'all'` is equivalent to
+     * `'one'` (there's no next track to wrap to).
+     *
+     * @default 'none'
+     */
+    loopMode?: TAudioLoopMode;
+    /**
+     * Shuffle the playlist order when navigating with prev / next or
+     * auto-advancing on track end. The shuffled order is computed
+     * deterministically (Fisher-Yates seeded by playlist length) so
+     * consumers can re-render predictably; opt out of stability by
+     * controlling the playlist array externally.
+     *
+     * Has no visible effect when no `playlist` is provided.
+     *
+     * @default false
+     */
+    shuffle?: boolean;
+    /**
+     * Optional list of tracks to play sequentially. When set, the
+     * `prev` / `next` transport buttons navigate the list instead of
+     * skipping 10 s, the cover / metadata strip switches to the active
+     * track, and a clickable list renders below the transport.
+     *
+     * Mutually informative with the top-level `src` prop: if `src`
+     * AND `playlist` are both set, `playlist` wins and `src` is
+     * ignored. The active track is `playlist[currentTrackIndex]`.
+     */
+    playlist?: Array<IAudioTrack>;
+    /**
+     * Index of the currently-active track in the `playlist`. Supports
+     * `v-model:currentTrackIndex` for two-way binding (parent stays the
+     * source of truth for which track is playing).
+     *
+     * @default 0
+     */
+    currentTrackIndex?: number;
+    /**
+     * Buffering hint. `'metadata'` (default) loads just enough to
+     * compute the duration; `'none'` defers everything until the
+     * user presses play; `'auto'` lets the browser pre-buffer.
+     *
+     * @default 'metadata'
+     */
+    preload?: 'none' | 'metadata' | 'auto';
+    /**
+     * Mirrors the native `crossorigin` attribute. Required when the
+     * media is served from a CORS-enabled origin and the consumer
+     * needs WebAudio access to the decoded samples.
+     */
+    crossorigin?: string;
+    /**
+     * Which control surface to render. `'custom'` paints the
+     * `<OrigamMediaController>` shell; `'native'` exposes the
+     * browser's built-in `controls` attribute on the `<audio>`.
+     *
+     * @default 'custom'
+     */
+    controls?: TAudioControls;
+    /**
+     * Available playback rates exposed via the config menu.
+     *
+     * @default [0.5, 0.75, 1, 1.25, 1.5, 2]
+     */
+    playbackRates?: ReadonlyArray<number>;
+    /**
+     * Initial playback rate. The runtime value is exposed via the
+     * `update:playbackRate` emit.
+     *
+     * @default 1
+     */
+    playbackRate?: number;
+    /**
+     * Enable the cast / AirPlay button (Remote Playback API). The
+     * button only renders when this flag is true AND at least one
+     * cast-capable device is detected.
+     *
+     * @default false
+     */
+    allowRemotePlayback?: boolean;
+    /**
+     * Adds a "Download" row to the cog menu that lets the listener
+     * download the currently-playing audio file.
+     *
+     * @default false
+     */
+    downloadable?: boolean;
+    /**
+     * Override the downloaded file name. Defaults to the trailing
+     * segment of the source URL.
+     */
+    downloadFilename?: string;
+}
+/**
+ * Emits surfaced by `<OrigamAudio>`. Event names mirror the native
+ * DOM events one-to-one so consumers can move between the wrapper
+ * and a vanilla `<audio>` without re-wiring listeners.
+ */
+export interface IAudioEmits {
+    (e: 'play'): void;
+    (e: 'pause'): void;
+    (e: 'ended'): void;
+    (e: 'timeupdate', event: Event): void;
+    (e: 'volumechange', event: Event): void;
+    (e: 'loadedmetadata', event: Event): void;
+    (e: 'error', payload: Event | MediaError | Error): void;
+    /** Two-way binding for the playback rate. The component DOES NOT
+     *  set this in response to the consumer's prop changes — only
+     *  when the user picks a rate from the config menu. */
+    (e: 'update:playbackRate', rate: number): void;
+    /** Fired when the listener clicks the "Download" row in the
+     *  config menu. Payload is the URL of the file. */
+    (e: 'download', url: string): void;
+    /** Fires once per waveform recomputation (typically when `src`
+     *  changes). Payload is the downsampled peaks array (0..1
+     *  amplitudes). Ported from `ISoundEmits['waveform']`. */
+    (e: 'waveform', peaks: Array<number>): void;
+    /** Fires when the listener clicks the "previous track" button.
+     *  Always emitted alongside the in-component navigation (playlist
+     *  jump if a playlist is set, otherwise the listener can implement
+     *  its own previous logic). */
+    (e: 'previous'): void;
+    /** Fires when the listener clicks the "next track" button. Same
+     *  contract as `previous`. */
+    (e: 'next'): void;
+    /** Two-way binding for the active playlist index. Fires when the
+     *  user clicks a track in the list, presses prev / next, or when
+     *  the player auto-advances on `ended`. */
+    (e: 'update:currentTrackIndex', index: number): void;
+    /** Two-way binding for the loop mode. Fires when the user cycles
+     *  the loop button (`none` → `all` → `one` → `none`). */
+    (e: 'update:loopMode', mode: TAudioLoopMode): void;
+    /** Two-way binding for the shuffle flag. Fires when the user
+     *  toggles the shuffle button. */
+    (e: 'update:shuffle', shuffle: boolean): void;
+    /** Fires whenever the active track changes (manual click, prev /
+     *  next, auto-advance). Payload is the new track descriptor. */
+    (e: 'track-change', track: IAudioTrack, index: number): void;
+}
+/**
+ * Reactive state surface returned by `useAudioPlayer` (Audio
+ * namespace). For the moment audio does not expose any state beyond
+ * the media-agnostic baseline — the alias exists so future
+ * audio-specific extensions (e.g. waveform analysis, frequency bins
+ * via Web Audio API) have a home without breaking the
+ * `IAudioPlayerState` import path on consumers.
+ *
+ * Note: distinct from `ISoundPlayerState` exposed by `<OrigamSound>`,
+ * which carries its own waveform-aware composable.
+ */
+export interface IAudioPlayerState extends IMediaPlayerState {
+}
+/**
+ * Imperative methods returned by `useAudioPlayer` (Audio namespace).
+ * Like the state, no audio-specific commands today — kept as a
+ * separate symbol so the Composable layer can grow without churn on
+ * consumer types.
+ */
+export interface IAudioPlayerMethods extends IMediaPlayerMethods {
+}
+/**
+ * Emit signatures recommended for audio host components. Same shape
+ * as the media baseline — composable does NOT emit; this interface
+ * is for the host SFC's `defineEmits` contract.
+ */
+export interface IAudioPlayerEmits extends IMediaPlayerEmits {
+}
+/**
+ * Options accepted by `useAudioPlayer` (Audio namespace). Named
+ * distinctly from the legacy `IUseAudioPlayerOptions` in the Sound
+ * 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;
+    /** Loop on `ended`. */
+    loop?: boolean;
+    /** Buffering hint. */
+    preload?: 'none' | 'metadata' | 'auto';
+    /**
+     * Resolves to the `HTMLAudioElement` to drive. When omitted, the
+     * composable creates an empty ref and expects the consumer to
+     * `bind` it on a `<audio ref>` themselves.
+     */
+    audioRef?: Ref<HTMLAudioElement | null>;
+}

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

@@ -1,7 +1,11 @@
-import type { IActiveProps, IAvatarProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ITagProps } from "../../interfaces";
+import type { IActiveEmits, IActiveProps, IAvatarProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IHoverEmits, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ITagProps } from "../../interfaces";
 export interface IAvatarGroupProps extends ICommonsComponentProps, IDirectionProps, IDensityProps, IRoundedProps, ISizeProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps, IHoverProps, IActiveProps {
     items?: Array<IAvatarProps>;
     max?: number;
     expandOnHover?: boolean;
     expandOnClick?: boolean;
 }
+/** Emits fired by `<OrigamAvatarGroup>` — propagates active + hover from
+ *  the underlying avatars. */
+export interface IAvatarGroupEmits extends IActiveEmits, IHoverEmits {
+}

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

@@ -1,4 +1,4 @@
-import type { IActiveProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ISrcObject, ITagProps } from '../../interfaces';
+import type { IActiveEmits, IActiveProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverEmits, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ISrcObject, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface IAvatarProps extends ICommonsComponentProps, IDensityProps, IRoundedProps, ISizeProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps, IHoverProps, IActiveProps {
     start?: boolean;
@@ -11,3 +11,6 @@ export interface IAvatarProps extends ICommonsComponentProps, IDensityProps, IRo
     image?: string | ISrcObject;
     text?: string;
 }
+/** Emits fired by `<OrigamAvatar>` — active + hover state propagation. */
+export interface IAvatarEmits extends IActiveEmits, IHoverEmits {
+}

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

@@ -0,0 +1,84 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { TBlockquoteAlign, TBlockquoteLang, TBlockquoteVariant, TIntent } from '../../types';
+/**
+ * Props for `<OrigamBlockquote>` — typographic citation component.
+ *
+ * A thin layer on top of the native `<blockquote>` element. Adds five
+ * visual variants, optional author/source attribution, locale-aware
+ * decorative quote marks (for `variant="quoted"`) and an intent-driven
+ * accent color (consumed by the accent bar / quote marks / author
+ * label depending on the variant).
+ *
+ * The component never imposes a layout beyond what's required for the
+ * variant — outer margins are the parent's responsibility.
+ */
+export interface IBlockquoteProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * Visual variant. See `TBlockquoteVariant` for the per-variant
+     * typographic contract.
+     *
+     * @default 'default'
+     */
+    variant?: TBlockquoteVariant;
+    /**
+     * Author of the citation. Rendered after the body as `— Author`.
+     * When `source` is also set, the two are joined with a comma.
+     * Can be overridden via the `#author` slot for custom rendering
+     * (e.g. wrap in a link to a bio page).
+     */
+    author?: string;
+    /**
+     * Source of the citation (book, publication, URL label, …).
+     * Rendered after `author` as `, Source`. Can be overridden via
+     * the `#source` slot. When `cite` is also set on the prop, the
+     * source label is wrapped in a `<cite>` element pointing at the
+     * URL.
+     */
+    source?: string;
+    /**
+     * URL the citation references. Maps 1:1 to the HTML `cite`
+     * attribute on the rendered `<blockquote>` (or `<q>`). Pass a
+     * fully-qualified URL — the browser exposes it to assistive tech
+     * and to user-agent inspectors but does not render it visually.
+     */
+    cite?: string;
+    /**
+     * Locale hint that determines which decorative quote glyphs render
+     * for `variant="quoted"`. See `TBlockquoteLang`.
+     *
+     * @default 'auto'
+     */
+    lang?: TBlockquoteLang;
+    /**
+     * Horizontal alignment of the citation body and attribution. The
+     * `pull` variant forces `'center'` when this prop is left empty;
+     * other variants default to `'left'`.
+     *
+     * @default 'left'
+     */
+    align?: TBlockquoteAlign;
+    /**
+     * Semantic accent color. Drives:
+     * - the left accent bar (`default`).
+     * - the decorative quote marks (`quoted`).
+     * - the author label and pull-quote top/bottom rules (`pull`).
+     *
+     * Maps to the `--origam-color__action--{intent}---bg` token. Pass
+     * one of the semantic intents (`'primary'`, `'secondary'`,
+     * `'success'`, `'danger'`, …) — raw hex/rgb values are NOT
+     * supported here on purpose (keeps the token contract clean).
+     */
+    color?: TIntent;
+}
+/**
+ * Slot signatures for `<OrigamBlockquote>`. The `default` slot owns the
+ * citation body; `author` and `source` are optional overrides for
+ * custom rendering (links, badges, locale-formatted dates, …). When
+ * an override slot is provided it WINS over the matching prop —
+ * priority order is `slot > prop`.
+ */
+export interface IBlockquoteSlots {
+    default?: () => any;
+    author?: () => any;
+    source?: () => any;
+}

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

@@ -1,7 +1,11 @@
-import type { IBorderProps, IBtnProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupProps, IHoverProps, ILayoutItemProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
+import type { IActiveEmits, IBorderProps, IBtnProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupProps, IHoverEmits, IHoverProps, ILayoutItemProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
 import type { TMode } from '../../types';
 export interface IBottomNavProps extends ITagProps, ICommonsComponentProps, IColorProps, IBgColorProps, IPaddingProps, IBorderProps, IElevationProps, IMarginProps, IDimensionProps, IDensityProps, IRoundedProps, ILayoutItemProps, IGroupProps, IHoverProps, ITransitionComponentProps {
     grow?: boolean;
     mode?: TMode;
     items?: Array<IBtnProps>;
 }
+/** Emits fired by `<OrigamBottomNav>` — active item v-model + hover/active
+ *  propagation. */
+export interface IBottomNavEmits extends ICommonsComponentEmits, IActiveEmits, IHoverEmits {
+}

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

@@ -1,5 +1,5 @@
-import type { ICommonsComponentProps, IDensityProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TBracketVariant, TIntent } from '../../types';
+import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { TBracketVariant } from '../../types';
 import type { IBracketRound } from './bracket-round.interface';
 /**
  * Props for `<OrigamBracket>` — a tournament tree renderer supporting
@@ -11,7 +11,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 {
+export interface IBracketProps extends ICommonsComponentProps, ITagProps, IDensityProps, IRoundedProps, IColorProps, IBgColorProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps {
     /**
      * Required. Pre-ordered list of rounds. For single-elimination,
      * the rounds are laid out from earliest (e.g. round-of-16) to
@@ -53,13 +53,6 @@ export interface IBracketProps extends ICommonsComponentProps, ITagProps, IDensi
      * @default false
      */
     showSeed?: boolean;
-    /**
-     * Semantic intent driving the winner highlight color, the connector
-     * "winner" stroke, and any focus rings.
-     *
-     * @default 'primary'
-     */
-    color?: TIntent;
     /**
      * Whether match cards should be interactive (cursor, hover state,
      * keyboard focus). When `false`, click handlers still fire but the

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

@@ -1,5 +1,8 @@
-import type { IActiveProps, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 export interface IBreadcrumbItemProps extends ICommonsComponentProps, ITagProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, ILinkProps, IColorProps, IBgColorProps, IDensityProps, IAdjacentProps, IHoverProps, IActiveProps {
     title: string;
     disabled?: boolean;
 }
+/** Emits fired by `<OrigamBreadcrumbItem>` — clicks on prepend/append icons. */
+export interface IBreadcrumbItemEmits extends IAdjacentEmits {
+}

package/dist/src/interfaces/Btn/btn-toggle.interface.d.ts

@@ -1,3 +1,6 @@
-import type { IBtnGroupProps, IGroupProps } from '../../interfaces';
+import type { IBtnGroupProps, ICommonsComponentEmits, IGroupProps } from '../../interfaces';
 export interface IBtnToggleProps extends IBtnGroupProps, IGroupProps {
 }
+/** Emits fired by `<OrigamBtnToggle>` — v-model on the active toggle index. */
+export interface IBtnToggleEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/Btn/btn.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupItemProps, IHoverProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ISizeProps, IStatusProps, ITagProps, IVariantProps } from '../../interfaces';
+import type { IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupEmits, IGroupItemProps, IHoverProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ISizeProps, IStatusProps, ITagProps, IVariantProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ISizeProps, ILinkProps, IRippleProps, ILoaderProps, IPositionProps, ILocationProps, IGroupItemProps, IPaddingProps, IMarginProps, IAdjacentProps, IStatusProps, IHoverProps, IVariantProps {
     active?: boolean;
@@ -10,3 +10,7 @@ export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColor
     stacked?: boolean;
     text?: string;
 }
+/** Emits fired by `<OrigamBtn>` — clicks on prepend/append slots and
+ *  group-membership lifecycle. */
+export interface IBtnEmits extends IAdjacentEmits, IGroupEmits {
+}