origam 2.5.0 → 2.6.2

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

@@ -0,0 +1,24 @@
+import type { IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps } from '../../interfaces';
+/**
+ * Props for the `<OrigamApp>` application shell.
+ *
+ * App is a thin wrapper over `<OrigamLayout>` whose only surface concern is
+ * the page background / default text colour — it intentionally does NOT
+ * expose the full layout design surface (border / rounded / elevation /
+ * dimension / spacing): an application root has no business carrying a
+ * corner radius, a shadow or margins. Those remain available on
+ * `<OrigamLayout>` directly for embedded / sized layouts.
+ *
+ * `color` / `bgColor` are forwarded to the underlying layout: `bgColor`
+ * paints the app surface, and `color` sets the root text colour which
+ * cascades to descendants through normal CSS inheritance.
+ */
+export interface IAppProps extends ICommonsComponentProps, IColorProps, IBgColorProps {
+    /** Stretch the layout to the full viewport (`100vw` / `100vh`). Default `true`. */
+    fullHeight?: boolean;
+    /** 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 {
+}

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

@@ -1,5 +1,5 @@
 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 { 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';
 /**
  * Descriptor for a single track in an `<OrigamAudio>` playlist.
@@ -103,7 +103,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, IMarginProps, IPaddingProps, IElevationProps, IPositionProps, IColorProps, IBgColorProps {
+export interface IAudioProps extends ICommonsComponentProps, ITagProps, IRoundedProps, IBorderProps, IDimensionProps, IMarginProps, IPaddingProps, IElevationProps, IPositionProps, IColorProps, IBgColorProps, ITypographyProps {
     /**
      * Visual variant of the audio surface.
      *
@@ -355,6 +355,27 @@ export interface IAudioEmits {
      *  next, auto-advance). Payload is the new track descriptor. */
     (e: 'track-change', track: IAudioTrack, index: number): void;
 }
+/**
+ * Options accepted by `useWaveform()` to configure how the audio file
+ * is fetched and decoded into waveform peak data.
+ */
+export interface IUseWaveformOptions {
+    /**
+     * Number of amplitude buckets (bars) to downsample the decoded
+     * audio into. A higher value produces a finer-grained waveform but
+     * costs more processing time.
+     *
+     * @default 200
+     */
+    bins?: number;
+    /**
+     * CORS credentials mode forwarded to `fetch()`.
+     *
+     * - `'use-credentials'` — include cookies / auth headers.
+     * - any other value (or `undefined`) — `'same-origin'` semantics.
+     */
+    crossOrigin?: string;
+}
 /**
  * Reactive state surface returned by `useAudioPlayer` (Audio
  * namespace). For the moment audio does not expose any state beyond

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

@@ -1,8 +1,6 @@
-import type { IActiveEmits, IActiveProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverEmits, 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, 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 {
-    start?: boolean;
-    end?: boolean;
+export interface IAvatarProps extends ICommonsComponentProps, IDensityProps, IRoundedProps, ISizeProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps, IHoverProps, IActiveProps, ITypographyProps {
     /**
      * 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,5 +1,5 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
-export interface IBadgeProps extends ICommonsComponentProps, ITagProps, IBorderProps, IColorProps, IBgColorProps, ILocationProps, IRoundedProps, ITransitionComponentProps, IStatusProps, IHoverProps, IElevationProps {
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps, ITypographyProps } from '../../interfaces';
+export interface IBadgeProps extends ICommonsComponentProps, ITagProps, IBorderProps, IColorProps, IBgColorProps, ILocationProps, IRoundedProps, ITransitionComponentProps, IStatusProps, IHoverProps, IElevationProps, ITypographyProps {
     content?: number | string;
     dot?: boolean;
     floating?: boolean;

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

@@ -1,18 +1,32 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
-import type { TBlockquoteAlign, TBlockquoteLang, TBlockquoteVariant, TIntent } from '../../types';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
+import type { TBlockquoteAlign, TBlockquoteLang, TBlockquoteVariant } 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).
+ * visual variants, optional author/source attribution and locale-aware
+ * decorative quote marks (for `variant="quoted"`).
  *
- * The component never imposes a layout beyond what's required for the
- * variant — outer margins are the parent's responsibility.
+ * ## Colour model (two independent axes)
+ *
+ * - **`color`** drives the **citation text** itself (the body). Defaults
+ *   to `text-primary`. An intent resolves to its readable-on-light shade
+ *   (`fgSubtle`); a custom value is applied verbatim.
+ * - **`bgColor`** drives the **accent**: the decorative bar / pull rules
+ *   (the "borders"), the big background quote glyph and the author label.
+ *   Defaults to `primary`. It does NOT paint a surface fill — the
+ *   blockquote stays transparent (see ROADMAP: future rename to
+ *   `accentColor`).
+ *
+ * The two axes are meant to contrast: a dark body (`color`) reads against
+ * a coloured accent (`bgColor`).
+ *
+ * Standard cross-cutting surfaces (`rounded`, `elevation`, `border`,
+ * `padding`, `margin`) are inherited from the Commons interfaces and
+ * consumed via the matching composables. The component never imposes an
+ * outer margin unless `margin` is passed.
  */
-export interface IBlockquoteProps extends ICommonsComponentProps, ITagProps {
+export interface IBlockquoteProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IRoundedProps, IElevationProps, IBorderProps, IPaddingProps, IMarginProps, ITypographyProps {
     /**
      * Visual variant. See `TBlockquoteVariant` for the per-variant
      * typographic contract.
@@ -57,18 +71,6 @@ export interface IBlockquoteProps extends ICommonsComponentProps, ITagProps {
      * @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

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

@@ -1,9 +1,17 @@
-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 {
+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';
+export interface IBottomNavProps extends ITagProps, ICommonsComponentProps, IColorProps, IBgColorProps, IPaddingProps, IBorderProps, IElevationProps, IMarginProps, IDimensionProps, IDensityProps, IRoundedProps, ILayoutItemProps, IGroupProps, IHoverProps, IActiveProps, ITransitionComponentProps {
     grow?: boolean;
-    mode?: TMode;
+    mode?: TNavMode;
     items?: Array<IBtnProps>;
+    /**
+     * Horizontal placement of the bar when it does not span the full width
+     * (e.g. a custom `width`): `'start'` (inline-start), `'center'` or
+     * `'end'` (inline-end).
+     *
+     * @default 'start'
+     */
+    position?: TBottomNavPosition;
 }
 /** Emits fired by `<OrigamBottomNav>` — active item v-model + hover/active
  *  propagation. */

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

@@ -1,12 +1,14 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
-import type { TIntent } from '../../types';
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { IBracketCompetitor } from './bracket-competitor.interface';
 /**
  * Props for `<OrigamBracketCompetitor>` — a single competitor row.
  * Exported so consumers can render a competitor row standalone (e.g.
- * inside a custom match slot).
+ * inside a custom match slot). Carries the full cross-cutting prop
+ * surface (color, bgColor, rounded, elevation, border, density,
+ * dimension, padding, margin) so a standalone row behaves like any
+ * other origam component.
  */
-export interface IBracketCompetitorProps extends ICommonsComponentProps, ITagProps {
+export interface IBracketCompetitorProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IHoverProps, IActiveProps, IRoundedProps, IElevationProps, IBorderProps, IDensityProps, IDimensionProps, IPaddingProps, IMarginProps, ITypographyProps {
     /**
      * The competitor payload. `null` renders a "TBD" placeholder — used
      * when the match's participant is not yet determined (winner of an
@@ -48,6 +50,15 @@ export interface IBracketCompetitorProps extends ICommonsComponentProps, ITagPro
      * @default true
      */
     interactive?: boolean;
-    /** Intent color driving the winner highlight. */
-    color?: TIntent;
+    /**
+     * Head-start carried into the match by this competitor, in rounds /
+     * sets. When set (`> 0`), a `+N` badge is rendered next to the name
+     * — used for the Winner Bracket champion's Grand Final advantage.
+     */
+    advantageRounds?: number;
+    /**
+     * Marks this competitor as the one that FORFEITED the match — the
+     * name is struck through and a "forfeit" tag is shown.
+     */
+    forfeit?: boolean;
 }

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

@@ -1,12 +1,15 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
-import type { TBracketMatchStatus, TIntent } from '../../types';
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { TBracketMatchStatus } from '../../types';
 import type { IBracketMatch } from './bracket-match.interface';
 /**
  * Props for `<OrigamBracketMatch>` — a single match card rendered
  * inside `<OrigamBracket>`. Exported so consumers can render a match
- * card outside the full bracket (e.g. on a match-details page).
+ * card outside the full bracket (e.g. on a match-details page). Carries
+ * the full cross-cutting surface (color, bgColor, rounded, elevation,
+ * border, density, dimension, padding, margin) so a standalone card
+ * behaves like any other origam component.
  */
-export interface IBracketMatchProps extends ICommonsComponentProps, ITagProps {
+export interface IBracketMatchProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IHoverProps, IActiveProps, IRoundedProps, IElevationProps, IBorderProps, IDensityProps, IDimensionProps, IPaddingProps, IMarginProps {
     /** The match payload to render. */
     match: IBracketMatch;
     /**
@@ -14,6 +17,12 @@ export interface IBracketMatchProps extends ICommonsComponentProps, ITagProps {
      * to force a status (e.g. preview a "live" badge from a story).
      */
     status?: TBracketMatchStatus;
+    /**
+     * Destination of the "Watch live" link, shown in the meta header only
+     * when the match is `live`. A URL (rendered as an `<a>` opening in a
+     * new tab). Omit to hide the link.
+     */
+    to?: string;
     /**
      * Hoists the match into the "final" visual treatment — bigger
      * card, shadow, and rounded corners.
@@ -40,6 +49,4 @@ export interface IBracketMatchProps extends ICommonsComponentProps, ITagProps {
      * @default true
      */
     interactive?: boolean;
-    /** Intent color for the winner highlight. */
-    color?: TIntent;
 }

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

@@ -1,5 +1,21 @@
 import type { TBracketMatchStatus } from '../../types';
 import type { IBracketCompetitor } from './bracket-competitor.interface';
+/**
+ * Head-start carried into a match by one competitor — the classic
+ * double-elimination Grand Final advantage, where the Winner Bracket
+ * champion starts the (single) Grand Final already up by one round /
+ * set.
+ */
+export interface IBracketMatchAdvantage {
+    /** Id of the competitor that starts ahead. */
+    competitorId: string | number;
+    /**
+     * Size of the head start, in rounds / sets.
+     *
+     * @default 1
+     */
+    rounds?: number;
+}
 /**
  * A single match between two competitors.
  *
@@ -44,6 +60,12 @@ export interface IBracketMatch {
      * mapping is used.
      */
     nextMatchId?: string | number;
+    /**
+     * Optional head-start for one competitor — the Winner Bracket
+     * champion's one-round advantage in a double-elimination Grand
+     * Final. Rendered as a `+N` badge on the favoured competitor row.
+     */
+    advantage?: IBracketMatchAdvantage;
     /** ISO date string — informative only, displayed when present. */
     scheduledAt?: string;
     /** Free-form payload — never read by the component. */

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

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps, IDirectionProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentProps, IDirectionProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { TIntent } from '../../types';
 import type { IBracketRound } from './bracket-round.interface';
 /**
@@ -6,7 +6,7 @@ import type { IBracketRound } from './bracket-round.interface';
  * 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 {
+export interface IBracketRoundProps extends ICommonsComponentProps, ITagProps, IDirectionProps, ITypographyProps {
     /** The round payload to render. */
     round: IBracketRound;
     /** Index of the round inside its bracket — drives the vertical offset. */

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

@@ -1,4 +1,4 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { TBracketVariant } from '../../types';
 import type { IBracketRound } from './bracket-round.interface';
 /**
@@ -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, IColorProps, IBgColorProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps {
+export interface IBracketProps extends ICommonsComponentProps, ITagProps, IDensityProps, IRoundedProps, IColorProps, IBgColorProps, IBorderProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, ITypographyProps {
     /**
      * Required. Pre-ordered list of rounds. For single-elimination,
      * the rounds are laid out from earliest (e.g. round-of-16) to
@@ -61,4 +61,19 @@ export interface IBracketProps extends ICommonsComponentProps, ITagProps, IDensi
      * @default true
      */
     interactive?: boolean;
+    /**
+     * Heading shown above the winner-bracket tree in a
+     * double-elimination layout. Pre-translate before passing — the
+     * component never calls `useT`.
+     *
+     * @default 'Winners bracket'
+     */
+    winnersLabel?: string;
+    /**
+     * Heading shown above the loser-bracket tree in a
+     * double-elimination layout.
+     *
+     * @default 'Losers bracket'
+     */
+    losersLabel?: string;
 }

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

@@ -1,5 +1,5 @@
-import type { IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, ISizeProps, ITagProps } from '../../interfaces';
+import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, ISizeProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
-export interface IBreadcrumbDividerProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IDensityProps, IColorProps, ISizeProps {
+export interface IBreadcrumbDividerProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IDensityProps, IColorProps, IBgColorProps, ISizeProps {
     divider: string | TIcon;
 }

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

@@ -1,7 +1,6 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TBreadcrumbItem, TIcon } from '../../types';
-export interface IBreadcrumbProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps {
-    activeClass?: string;
+export interface IBreadcrumbProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps, IHoverProps, IActiveProps {
     disabled?: boolean;
     divider?: string | TIcon;
     items?: Array<TBreadcrumbItem>;

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

@@ -1,5 +1,5 @@
-import type { IBorderProps, IBtnProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface IBtnGroupProps extends ITagProps, ICommonsComponentProps, IRoundedProps, IBorderProps, IDensityProps, IElevationProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps {
+import type { IActiveProps, IBorderProps, IBtnProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+export interface IBtnGroupProps extends ITagProps, ICommonsComponentProps, IRoundedProps, IBorderProps, IDensityProps, IElevationProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IHoverProps, IActiveProps {
     divided?: boolean;
     items?: Array<IBtnProps>;
 }

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

@@ -1,14 +1,22 @@
-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 { IActiveState, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupEmits, IGroupItemProps, IHoverProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps, ITypographyProps, 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;
+import type { TStatus, TStatusPosition } from '../../types';
+/** Btn needs `status` / `statusIconPosition` from IStatusProps but its own
+ *  `icon` prop accepts `boolean | TIcon` (boolean = icon-only mode) which is
+ *  wider than `IIconProps.icon?: TIcon`.  Pulling the two status props in
+ *  directly avoids the TS2430 incompatible-extends error. */
+export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ISizeProps, ILinkProps, IRippleProps, ILoaderProps, IPositionProps, ILocationProps, IGroupItemProps, IPaddingProps, IMarginProps, IAdjacentProps, IHoverProps, IVariantProps, ITypographyProps {
+    active?: boolean | IActiveState;
     /** @deprecated Use `variant="flat"` instead. Kept for backward compat. */
     flat?: boolean;
+    /** Pass `true` to activate icon-only mode; pass a `TIcon` value to set the icon. */
     icon?: boolean | TIcon;
     block?: boolean;
     slim?: boolean;
     stacked?: boolean;
     text?: string;
+    status?: TStatus;
+    statusIconPosition?: TStatusPosition;
 }
 /** Emits fired by `<OrigamBtn>` — clicks on prepend/append slots and
  *  group-membership lifecycle. */

package/dist/src/interfaces/Calendar/calendar.interface.d.ts

@@ -1,11 +1,16 @@
-import type { ICommonsComponentProps, IEvent } from '../../interfaces';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IEvent, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
 import type { TCalendarNavigate, TCalendarTimeFormat, TCalendarView, TIntent } from '../../types';
 /**
  * Props for `<OrigamCalendar>`. Two-way bindings on `view` and
  * `currentDate` so the parent can sync with router state or persist
  * across page reloads without owning a watcher.
+ *
+ * The full cross-cutting surface (color, bgColor, rounded, elevation,
+ * border, density, dimension, padding, margin) is inherited from the
+ * Commons interfaces and consumed via the standard composables, so the
+ * calendar paints / sizes / spaces like any other origam component.
  */
-export interface ICalendarProps extends ICommonsComponentProps {
+export interface ICalendarComponentProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IRoundedProps, IElevationProps, IBorderProps, IDensityProps, IDimensionProps, IPaddingProps, IMarginProps {
     /** Active view mode. v-model:view. */
     view?: TCalendarView;
     /** Anchor date. v-model:currentDate. */

package/dist/src/interfaces/Card/card-header.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IAdjacentEmits, IAdjacentProps, IBorderProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface ICardHeaderProps extends ITagProps, ICommonsComponentProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IAdjacentProps {
+import type { IAdjacentEmits, IAdjacentProps, IBorderProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
+export interface ICardHeaderProps extends ITagProps, ICommonsComponentProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IAdjacentProps, ITypographyProps {
     subtitle?: string | number;
     title?: string | number;
 }

package/dist/src/interfaces/Card/card-text.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBorderProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface ICardTextProps extends ICommonsComponentProps, ITagProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps {
+import type { IBorderProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
+export interface ICardTextProps extends ICommonsComponentProps, ITagProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, ITypographyProps {
     text?: string | number;
 }

package/dist/src/interfaces/Carousel/carousel.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDimensionProps, ITagProps, IWindowProps } from '../../interfaces';
+import type { IActiveProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDimensionProps, IHoverProps, ITagProps, IWindowProps } from '../../interfaces';
 import type { TIcon, TInline } from '../../types';
-export interface ICarouselProps extends IWindowProps, IColorProps, ICommonsComponentProps, ITagProps, IDimensionProps {
+export interface ICarouselProps extends IWindowProps, IColorProps, IBgColorProps, ICommonsComponentProps, ITagProps, IDimensionProps, IHoverProps, IActiveProps {
     cycle?: boolean;
     delimiterIcon?: TIcon;
     hideDelimiters?: boolean;

package/dist/src/interfaces/Chart/chart-base.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBgColorProps, IChartPoint, IChartSeries, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
+import type { IBgColorProps, IChartPoint, IChartSeries, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITypographyProps } from '../../interfaces';
 import type { TChartLegendPosition, TIntent } from '../../types';
 /**
  * Props shared across every chart type. Per-type components
@@ -11,7 +11,7 @@ import type { TChartLegendPosition, TIntent } from '../../types';
  * stays available for advanced consumers — it uses `IChartProps`
  * which is `IChartBaseProps + type + all type-specific options`.
  */
-export interface IChartBaseProps extends ICommonsComponentProps, IDimensionProps, IMarginProps, IPaddingProps, IRoundedProps, IElevationProps, IBgColorProps {
+export interface IChartBaseProps extends ICommonsComponentProps, IDimensionProps, IMarginProps, IPaddingProps, IRoundedProps, IElevationProps, IBgColorProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight'> {
     /** Data series — one or more. Empty array renders the `#empty` slot. */
     series: Array<IChartSeries>;
     /**
@@ -68,12 +68,13 @@ export interface IChartBaseEmits {
  * Identical to `IChartSlots` from the universal `<OrigamChart>`.
  */
 export interface IChartBaseSlots {
-    /** Replace the default tooltip body. */
-    tooltip?: (bindings: {
-        point: IChartPoint;
-        series: IChartSeries;
-        category: string | number;
-    }) => any;
+    /**
+     * Replace the default tooltip body.
+     * Sub-chart interfaces extend this with a narrower binding signature;
+     * the parameter is typed `any` here so those overrides satisfy the
+     * TypeScript function-parameter assignability check (TS2430).
+     */
+    tooltip?: (bindings: any) => any;
     /** Replace one legend entry. */
     'legend-item'?: (bindings: {
         series: IChartSeries;

package/dist/src/interfaces/Chart/chart-word-cloud.interface.d.ts

@@ -39,7 +39,7 @@ export interface IChartWordCloudWord extends IChartWordCloudDatum {
  * `{ text, value, color? }` object or a plain number (ignored — use
  * object form for word clouds).
  */
-export interface IChartWordCloudProps extends IChartBaseProps {
+export interface IChartWordCloudProps extends Omit<IChartBaseProps, 'fontWeight'> {
     /**
      * Minimum font size in px applied to the word with the lowest value.
      * Default `12`.

package/dist/src/interfaces/Chart/chart.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBgColorProps, IChartAnnotation, IChartPlotBand, IChartPlotLine, IChartPoint, IChartSecondaryYAxis, IChartSeries, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
+import type { IBgColorProps, IChartAnnotation, IChartDrilldownProps, IChartPlotBand, IChartPlotLine, IChartPoint, IChartSecondaryYAxis, IChartSeries, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
 import type { TChartLegendPosition, TChartSmoothing, TChartStacking, TChartType, TIntent } from '../../types';
 /**
  * Props accepted by `<OrigamChart>`. Single component for eight
@@ -121,6 +121,17 @@ export interface IChartProps extends ICommonsComponentProps, IDimensionProps, IM
      * coordinates. Four kinds: `'arrow'`, `'label'`, `'circle'`, `'bracket'`.
      */
     annotations?: Array<IChartAnnotation>;
+    /**
+     * Drilldown configuration forwarded to `<OrigamChartCartesian>` and
+     * `<OrigamChartPolar>`. Ignored by other families (radar, gauge, …).
+     */
+    drilldown?: IChartDrilldownProps;
+    /**
+     * Secondary (right-hand) Y axis configuration. Forwarded to
+     * `<OrigamChartCartesian>` only — ignored for other families.
+     * When absent the engine ignores `series.yAxis === 1` assignments.
+     */
+    secondaryYAxis?: IChartSecondaryYAxis;
 }
 /**
  * Emits surfaced by `<OrigamChart>`. All payloads are plain

package/dist/src/interfaces/Checkbox/checkbox-btn.interface.d.ts

@@ -11,9 +11,9 @@ export interface ICheckboxBtnSlots extends ICommonsComponentSlots {
     label?: () => any;
     input?: (data: {
         props: any;
-        icon: TIcon;
-        textColorStyles: TColor;
-        backgroundColorStyles: TColor;
+        icon?: TIcon;
+        textColorStyles?: TColor;
+        backgroundColorStyles?: TColor;
         model: any;
     }) => any;
 }

package/dist/src/interfaces/Checkbox/checkbox.interface.d.ts

@@ -5,19 +5,20 @@ export interface ICheckboxProps extends ICommonsComponentProps, IInputProps, ICh
 export interface ICheckboxEmits extends ICommonsComponentEmits, IFocusEmits, ISelectionControlEmits {
 }
 export interface ICheckboxSlots {
-    default?: (data: {
-        id: string;
-        messagesId: string;
-        isDisabled: boolean;
-        isReadonly: boolean;
-        isValid: boolean;
+    /** Slot data is provided when called from OrigamInput; absent when re-forwarded from OrigamCheckboxBtn. */
+    default?: (data?: {
+        id?: string;
+        messagesId?: string;
+        isDisabled?: boolean;
+        isReadonly?: boolean;
+        isValid?: boolean | undefined;
     }) => any;
     label?: () => any;
     input?: (data: {
         props: any;
-        icon: TIcon;
-        textColorStyles: TColor;
-        backgroundColorStyles: TColor;
+        icon?: TIcon;
+        textColorStyles?: TColor;
+        backgroundColorStyles?: TColor;
         model: any;
     }) => any;
 }

package/dist/src/interfaces/Chip/chip-group.interface.d.ts

@@ -1,8 +1,10 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ISlideGroupProps, ITagProps } from '../../interfaces';
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ISlideGroupProps, ITagProps, IActiveState, IHoverState } from '../../interfaces';
 export interface IChipGroupProps extends ICommonsComponentProps, ITagProps, IGroupProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IBorderProps, IRoundedProps, ISlideGroupProps {
     column?: boolean;
     filter?: boolean;
     valueComparator?: (a: any, b: any) => boolean;
+    active?: IActiveState;
+    hover?: IHoverState;
 }
 /** Emits fired by `<OrigamChipGroup>` — v-model on the active chip set. */
 export interface IChipGroupEmits extends ICommonsComponentEmits {

package/dist/src/interfaces/Chip/chip.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IClickCloseEmits, IClickEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IGroupEmits, IGroupItemProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IClickCloseEmits, IClickEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IGroupEmits, IGroupItemProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { TIcon } from '../../types';
-export interface IChipProps extends ICommonsComponentProps, IAdjacentProps, ITagProps, IColorProps, IBgColorProps, IRippleProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IGroupItemProps, ILinkProps, ISizeProps, IElevationProps, IActiveProps, IHoverProps {
+export interface IChipProps extends ICommonsComponentProps, IAdjacentProps, ITagProps, IColorProps, IBgColorProps, IRippleProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IGroupItemProps, ILinkProps, ISizeProps, IElevationProps, IActiveProps, IHoverProps, ITypographyProps {
     closable?: boolean;
     closeIcon?: TIcon;
     closeLabel?: string;

package/dist/src/interfaces/Clipboard/clipboard.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
 /**
  * Props for `<OrigamClipboard>` — copy-to-clipboard wrapper.
  *
@@ -12,7 +12,7 @@ import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps,
  * inline pill, animation, …) pass a `#default` scoped slot exposing
  * `{ copy, copied, error }` and render whatever they want.
  */
-export interface IClipboardProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IBorderProps, IRoundedProps, IMarginProps, IPaddingProps {
+export interface IClipboardProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IBorderProps, IRoundedProps, IMarginProps, IPaddingProps, ITypographyProps {
     /**
      * Text payload written to the clipboard on `copy()`. Required.
      * Re-read each time the trigger fires, so a parent that mutates