origam 2.14.1 → 2.16.0

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

@@ -1,25 +1,19 @@
-export * from './Icon/mdi.enum';
+export * from './Commons/mdi.enum';
 export * from './Img/img.enum';
-export * from './Audio/audio-variant.enum';
-export * from './Audio/audio-loop-mode.enum';
-export * from './Audio/cover-position.enum';
+export * from './Audio/audio.enum';
 export * from './Chart/chart.enum';
-export * from './Chart/chart-cartesian-kind.enum';
-export * from './Chart/chart-polar-kind.enum';
-export * from './Chart/chart-pyramid-kind.enum';
-export * from './Chart/chart-honeycomb-orientation.enum';
-export * from './Chart/chart-honeycomb-color-mode.enum';
-export * from './Chart/chart-treemap-algorithm.enum';
-export * from './Chart/chart-word-cloud-rotation.enum';
-export * from './Chart/chart-pictorial-direction.enum';
-export * from './Chart/chart-pictorial-mode.enum';
-export * from './Chart/chart-streamgraph-offset.enum';
-export * from './Chart/chart-bullet-orientation.enum';
-export * from './Chart/chart-map-mode.enum';
-export * from './Chart/chart-sparkline-kind.enum';
-export * from './Chart/chart-stacking.enum';
-export * from './Code/code-lang.enum';
-export * from './Code/code-theme.enum';
+export * from './Chart/chart-cartesian.enum';
+export * from './Chart/chart-polar.enum';
+export * from './Chart/chart-pyramid.enum';
+export * from './Chart/chart-honeycomb.enum';
+export * from './Chart/chart-treemap.enum';
+export * from './Chart/chart-word-cloud.enum';
+export * from './Chart/chart-pictorial.enum';
+export * from './Chart/chart-streamgraph.enum';
+export * from './Chart/chart-map.enum';
+export * from './Chart/chart-sparkline.enum';
+export * from './Chart/chart-sunburst.enum';
+export * from './Code/code.enum';
 export * from './ColorPicker/color-picker.enum';
 export * from './Commons/commons.enum';
 export * from './Commons/align.enum';
@@ -37,6 +31,7 @@ export * from './Commons/mode.enum';
 export * from './Commons/drag.enum';
 export * from './Commons/hotkey.enum';
 export * from './Commons/direction.enum';
+export * from './Commons/intent.enum';
 export * from './Commons/validation.enum';
 export * from './Commons/adjacent.enum';
 export * from './Commons/location.enum';
@@ -47,6 +42,15 @@ export * from './Commons/calendar.enum';
 export * from './Commons/sort.enum';
 export * from './Commons/status.enum';
 export * from './Commons/touch.enum';
+export * from './Commons/controls.enum';
+export * from './Commons/color.enum';
+export * from './Commons/font-family.enum';
+export * from './Commons/font-size.enum';
+export * from './Commons/font-weight.enum';
+export * from './Commons/letter-spacing.enum';
+export * from './Commons/line-height.enum';
+export * from './Commons/loader.enum';
+export * from './Commons/theme.enum';
 export * from './List/list.enum';
 export * from './List/list-item.enum';
 export * from './Toolbar/toolbar.enum';
@@ -55,26 +59,38 @@ export * from './Progress/progress.enum';
 export * from './Grids/row.enum';
 export * from './Grids/col.enum';
 export * from './Transition/transition.enum';
-export * from './Blockquote/blockquote-variant.enum';
-export * from './Blockquote/blockquote-lang.enum';
-export * from './Bracket/bracket-variant.enum';
-export * from './BottomNav/bottom-nav-position.enum';
-export * from './Bracket/bracket-match-status.enum';
+export * from './Blockquote/blockquote.enum';
+export * from './Bracket/bracket.enum';
+export * from './Bracket/bracket-round.enum';
+export * from './BottomNav/bottom-nav.enum';
+export * from './Bracket/bracket-match.enum';
 export * from './Card/card.enum';
 export * from './InfiniteScroll/infinite-scroll.enum';
 export * from './TextField/text-field.enum';
-export * from './Textarea/textarea-mode.enum';
-export * from './Textarea/textarea-output.enum';
-export * from './Textarea/textarea-toolbar-command.enum';
-export * from './Textarea/textarea-toolbar-position.enum';
+export * from './TextareaField/textarea-field.enum';
+export * from './RichToolbar/rich-toolbar.enum';
 export * from './Parallax/parallax.enum';
 export * from './Parallax/parallax-element.enum';
-export * from './Parallax/parallax-direction.enum';
-export * from './Parallax/parallax-easing.enum';
 export * from './DataTable/data-table.enum';
 export * from './DatePicker/date-picker.enum';
-export * from './SliderField/slider-field-variant.enum';
-export * from './Tabs/tab-variant.enum';
-export * from './Mask/mask.enum';
-export * from './EmptyState/empty-state-preset.enum';
-export * from './InlineEdit/inline-edit-action.enum';
+export * from './SliderField/slider-field.enum';
+export * from './Tabs/tab.enum';
+export * from './EmptyState/empty-state.enum';
+export * from './InlineEdit/inline-edit.enum';
+export * from './Stepper/stepper.enum';
+export * from './Kbd/kbd.enum';
+export * from './Video/video.enum';
+export * from './Snackbar/snackbar-group.enum';
+export * from './PasswordField/password-field.enum';
+export * from './QrCode/qr-code.enum';
+export * from './FileField/file-field.enum';
+export * from './Masonry/masonry.enum';
+export * from './TextMask/text-mask.enum';
+export * from './Calendar/calendar.enum';
+export * from './Treeview/treeview.enum';
+export * from './Timeline/timeline.enum';
+export * from './DataList/data-list.enum';
+export * from './Grid/grid.enum';
+export * from './NumberFormat/number-format.enum';
+export * from './Sheet/sheet.enum';
+export * from './Skeleton/skeleton.enum';

package/dist/src/enums/index.js

@@ -1,25 +1,19 @@
-export * from "./Icon/mdi.enum.js";
+export * from "./Commons/mdi.enum.js";
 export * from "./Img/img.enum.js";
-export * from "./Audio/audio-variant.enum.js";
-export * from "./Audio/audio-loop-mode.enum.js";
-export * from "./Audio/cover-position.enum.js";
+export * from "./Audio/audio.enum.js";
 export * from "./Chart/chart.enum.js";
-export * from "./Chart/chart-cartesian-kind.enum.js";
-export * from "./Chart/chart-polar-kind.enum.js";
-export * from "./Chart/chart-pyramid-kind.enum.js";
-export * from "./Chart/chart-honeycomb-orientation.enum.js";
-export * from "./Chart/chart-honeycomb-color-mode.enum.js";
-export * from "./Chart/chart-treemap-algorithm.enum.js";
-export * from "./Chart/chart-word-cloud-rotation.enum.js";
-export * from "./Chart/chart-pictorial-direction.enum.js";
-export * from "./Chart/chart-pictorial-mode.enum.js";
-export * from "./Chart/chart-streamgraph-offset.enum.js";
-export * from "./Chart/chart-bullet-orientation.enum.js";
-export * from "./Chart/chart-map-mode.enum.js";
-export * from "./Chart/chart-sparkline-kind.enum.js";
-export * from "./Chart/chart-stacking.enum.js";
-export * from "./Code/code-lang.enum.js";
-export * from "./Code/code-theme.enum.js";
+export * from "./Chart/chart-cartesian.enum.js";
+export * from "./Chart/chart-polar.enum.js";
+export * from "./Chart/chart-pyramid.enum.js";
+export * from "./Chart/chart-honeycomb.enum.js";
+export * from "./Chart/chart-treemap.enum.js";
+export * from "./Chart/chart-word-cloud.enum.js";
+export * from "./Chart/chart-pictorial.enum.js";
+export * from "./Chart/chart-streamgraph.enum.js";
+export * from "./Chart/chart-map.enum.js";
+export * from "./Chart/chart-sparkline.enum.js";
+export * from "./Chart/chart-sunburst.enum.js";
+export * from "./Code/code.enum.js";
 export * from "./ColorPicker/color-picker.enum.js";
 export * from "./Commons/commons.enum.js";
 export * from "./Commons/align.enum.js";
@@ -37,6 +31,7 @@ export * from "./Commons/mode.enum.js";
 export * from "./Commons/drag.enum.js";
 export * from "./Commons/hotkey.enum.js";
 export * from "./Commons/direction.enum.js";
+export * from "./Commons/intent.enum.js";
 export * from "./Commons/validation.enum.js";
 export * from "./Commons/adjacent.enum.js";
 export * from "./Commons/location.enum.js";
@@ -47,6 +42,15 @@ export * from "./Commons/calendar.enum.js";
 export * from "./Commons/sort.enum.js";
 export * from "./Commons/status.enum.js";
 export * from "./Commons/touch.enum.js";
+export * from "./Commons/controls.enum.js";
+export * from "./Commons/color.enum.js";
+export * from "./Commons/font-family.enum.js";
+export * from "./Commons/font-size.enum.js";
+export * from "./Commons/font-weight.enum.js";
+export * from "./Commons/letter-spacing.enum.js";
+export * from "./Commons/line-height.enum.js";
+export * from "./Commons/loader.enum.js";
+export * from "./Commons/theme.enum.js";
 export * from "./List/list.enum.js";
 export * from "./List/list-item.enum.js";
 export * from "./Toolbar/toolbar.enum.js";
@@ -55,26 +59,38 @@ export * from "./Progress/progress.enum.js";
 export * from "./Grids/row.enum.js";
 export * from "./Grids/col.enum.js";
 export * from "./Transition/transition.enum.js";
-export * from "./Blockquote/blockquote-variant.enum.js";
-export * from "./Blockquote/blockquote-lang.enum.js";
-export * from "./Bracket/bracket-variant.enum.js";
-export * from "./BottomNav/bottom-nav-position.enum.js";
-export * from "./Bracket/bracket-match-status.enum.js";
+export * from "./Blockquote/blockquote.enum.js";
+export * from "./Bracket/bracket.enum.js";
+export * from "./Bracket/bracket-round.enum.js";
+export * from "./BottomNav/bottom-nav.enum.js";
+export * from "./Bracket/bracket-match.enum.js";
 export * from "./Card/card.enum.js";
 export * from "./InfiniteScroll/infinite-scroll.enum.js";
 export * from "./TextField/text-field.enum.js";
-export * from "./Textarea/textarea-mode.enum.js";
-export * from "./Textarea/textarea-output.enum.js";
-export * from "./Textarea/textarea-toolbar-command.enum.js";
-export * from "./Textarea/textarea-toolbar-position.enum.js";
+export * from "./TextareaField/textarea-field.enum.js";
+export * from "./RichToolbar/rich-toolbar.enum.js";
 export * from "./Parallax/parallax.enum.js";
 export * from "./Parallax/parallax-element.enum.js";
-export * from "./Parallax/parallax-direction.enum.js";
-export * from "./Parallax/parallax-easing.enum.js";
 export * from "./DataTable/data-table.enum.js";
 export * from "./DatePicker/date-picker.enum.js";
-export * from "./SliderField/slider-field-variant.enum.js";
-export * from "./Tabs/tab-variant.enum.js";
-export * from "./Mask/mask.enum.js";
-export * from "./EmptyState/empty-state-preset.enum.js";
-export * from "./InlineEdit/inline-edit-action.enum.js";
+export * from "./SliderField/slider-field.enum.js";
+export * from "./Tabs/tab.enum.js";
+export * from "./EmptyState/empty-state.enum.js";
+export * from "./InlineEdit/inline-edit.enum.js";
+export * from "./Stepper/stepper.enum.js";
+export * from "./Kbd/kbd.enum.js";
+export * from "./Video/video.enum.js";
+export * from "./Snackbar/snackbar-group.enum.js";
+export * from "./PasswordField/password-field.enum.js";
+export * from "./QrCode/qr-code.enum.js";
+export * from "./FileField/file-field.enum.js";
+export * from "./Masonry/masonry.enum.js";
+export * from "./TextMask/text-mask.enum.js";
+export * from "./Calendar/calendar.enum.js";
+export * from "./Treeview/treeview.enum.js";
+export * from "./Timeline/timeline.enum.js";
+export * from "./DataList/data-list.enum.js";
+export * from "./Grid/grid.enum.js";
+export * from "./NumberFormat/number-format.enum.js";
+export * from "./Sheet/sheet.enum.js";
+export * from "./Skeleton/skeleton.enum.js";

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

@@ -1,4 +1,4 @@
-import type { IAdjacentProps, IBorderProps, IBgColorProps, IClickCloseEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverEmits, IHoverProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRoundedProps, IStatusProps, ITagProps, ITypographyProps } from '../../interfaces';
+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 {
     closable?: boolean;
@@ -12,3 +12,12 @@ export interface IAlertProps extends ICommonsComponentProps, ITagProps, IColorPr
  *  hover propagation. */
 export interface IAlertEmits extends ICommonsComponentEmits, IClickCloseEmits, IHoverEmits {
 }
+/** Slot signatures for `<OrigamAlert>`. */
+export interface IAlertSlots extends IAdjacentSlots {
+    /** Overrides the whole prepend/content/append layout. */
+    wrapper?: () => any;
+    title?: () => any;
+    text?: () => any;
+    default?: () => any;
+    close?: () => any;
+}

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

@@ -25,3 +25,11 @@ 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>`. */
+export interface IAppBarSlots {
+    append?: () => any;
+    prepend?: () => any;
+    img?: () => any;
+    content?: () => any;
+    default?: () => any;
+}

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

@@ -22,3 +22,7 @@ export interface IAppProps extends ICommonsComponentProps, IColorProps, IBgColor
 /** Emits fired by `<OrigamApp>` — none beyond the shared component contract. */
 export interface IAppEmits extends ICommonsComponentEmits {
 }
+/** Slot signatures for `<OrigamApp>`. */
+export interface IAppSlots {
+    default?: () => any;
+}

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

@@ -72,6 +72,10 @@ export interface IAudioScopedSlotBindings {
  * Slot signatures for `<OrigamAudio>`.
  */
 export interface IAudioSlots {
+    /** Override the entire title/artist/cover header strip (cover +
+     *  metadata together). Takes priority over the individual
+     *  `cover` / `metadata` / `title` slots. */
+    header?: () => any;
     /** Override the entire title/artist/cover strip. */
     metadata?: () => any;
     /** Override the cover image / placeholder. */
@@ -90,6 +94,13 @@ export interface IAudioSlots {
     /** Override the entire controls (replaces the default
      *  `<OrigamMediaController>`). */
     controls?: (bindings: IAudioScopedSlotBindings) => any;
+    /** Override the playlist list rendered below the transport row.
+     *  Only rendered when `playlist` is set. */
+    playlist?: (bindings: {
+        tracks: Array<IAudioTrack> | undefined;
+        currentIndex: number;
+        select: (index: number) => void;
+    }) => any;
     /** Overlay rendered while the media is loading. */
     loading?: () => any;
     /** Overlay rendered when an error occurred. */

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

@@ -9,3 +9,18 @@ export interface IAvatarGroupProps extends ICommonsComponentProps, IDirectionPro
  *  the underlying avatars. */
 export interface IAvatarGroupEmits extends IActiveEmits, IHoverEmits {
 }
+/** Slot signatures for `<OrigamAvatarGroup>`. */
+export interface IAvatarGroupSlots {
+    /** One call per displayed item — overrides the default `<origam-avatar>`. */
+    avatar?: (data: {
+        item: IAvatarProps;
+        index: number;
+    }) => any;
+    /** Overrides the "+N" overflow chip. */
+    rest?: (data: {
+        rest: Array<IAvatarProps>;
+        length: number;
+    }) => any;
+    /** Overrides the "+N" label rendered inside the overflow chip. */
+    default?: () => any;
+}

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

@@ -12,3 +12,12 @@ export interface IAvatarProps extends ICommonsComponentProps, IDensityProps, IRo
 /** Emits fired by `<OrigamAvatar>` — active + hover state propagation. */
 export interface IAvatarEmits extends IActiveEmits, IHoverEmits {
 }
+/** Slot signatures for `<OrigamAvatar>`. Each overrides the matching
+ *  auto-rendered content (image / icon / text), `default` overrides the
+ *  whole image/icon/text switch. */
+export interface IAvatarSlots {
+    default?: () => any;
+    avatar?: () => any;
+    icon?: () => any;
+    text?: () => any;
+}

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

@@ -1,5 +1,17 @@
-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 {
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps, ITypographyProps } from '../../interfaces';
+/**
+ * `IAdjacentProps` is pulled in explicitly (not just inherited through
+ * `IStatusProps`) because `useStatus()` reads `props.prependIcon` /
+ * `props.appendIcon` as a user-override fallback (see
+ * `status.composable.ts`, which types its `props` param as
+ * `IStatusProps & IAdjacentProps`) — before this fix `IBadgeProps` never
+ * declared those fields, so a consumer's `prepend-icon` / `append-icon`
+ * attribute fell through to the DOM as an inert attribute instead of
+ * reaching the component, and `prependAvatar` / `appendAvatar` had no
+ * 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 {
     content?: number | string;
     dot?: boolean;
     floating?: boolean;
@@ -10,3 +22,12 @@ export interface IBadgeProps extends ICommonsComponentProps, ITagProps, IBorderP
     offsetX?: number | string;
     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 {
+}
+/** Slot signatures for `<OrigamBadge>`. */
+export interface IBadgeSlots extends IAdjacentSlots {
+    default?: () => any;
+    badge?: () => any;
+}

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

@@ -17,3 +17,16 @@ export interface IBottomNavProps extends ITagProps, ICommonsComponentProps, ICol
  *  propagation. */
 export interface IBottomNavEmits extends ICommonsComponentEmits, IActiveEmits, IHoverEmits {
 }
+/** Slot signatures for `<OrigamBottomNav>`. `item.{index}` (e.g.
+ *  `item.0`) overrides a single button by position; `item` is the
+ *  fallback used by every index without its own `item.{index}` slot. */
+export interface IBottomNavSlots {
+    default?: () => any;
+    [key: `item.${number}`]: ((data: {
+        props: IBtnProps;
+    }) => any) | undefined;
+    item?: (data: {
+        props: IBtnProps;
+        index: number;
+    }) => any;
+}

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

@@ -1,4 +1,4 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
+import type { IActiveEmits, 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.
@@ -62,3 +62,8 @@ export interface IBracketCompetitorProps extends ICommonsComponentProps, ITagPro
      */
     forfeit?: boolean;
 }
+/** Emits fired by `<OrigamBracketCompetitor>` — click (mouse) / activation
+ *  (Enter / Space when `interactive`) on the row. */
+export interface IBracketCompetitorEmits extends IActiveEmits {
+    (e: 'click', event: MouseEvent | KeyboardEvent): void;
+}

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

@@ -1,5 +1,6 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+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 { IBracketCompetitor } from './bracket-competitor.interface';
 import type { IBracketMatch } from './bracket-match.interface';
 /**
  * Props for `<OrigamBracketMatch>` — a single match card rendered
@@ -50,3 +51,23 @@ export interface IBracketMatchProps extends ICommonsComponentProps, ITagProps, I
      */
     interactive?: boolean;
 }
+/** Emits fired by `<OrigamBracketMatch>` — click on the card itself
+ *  (outside a competitor row), and the two per-competitor channels the
+ *  card re-emits on behalf of its `competitor` slot / default rows. */
+export interface IBracketMatchEmits extends IActiveEmits {
+    (e: 'click', match: IBracketMatch, event: MouseEvent): void;
+    (e: 'competitor-click', competitor: IBracketCompetitor, match: IBracketMatch, side: 'A' | 'B', event: MouseEvent | KeyboardEvent): void;
+    (e: 'winner-click', competitor: IBracketCompetitor, match: IBracketMatch, event: MouseEvent | KeyboardEvent): void;
+}
+/** Scope for the `competitor` slot — one side (`A` or `B`) of the match.
+ *  `competitor` is `null` for a not-yet-determined participant (renders
+ *  "TBD" by default). */
+export interface IBracketMatchCompetitorSlot {
+    competitor: IBracketCompetitor | null;
+    match: IBracketMatch;
+    isWinner: boolean;
+    side: 'A' | 'B';
+}
+export interface IBracketMatchSlots {
+    competitor?: (props: IBracketMatchCompetitorSlot) => any;
+}

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

@@ -1,5 +1,7 @@
 import type { ICommonsComponentProps, IDirectionProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { TIntent } from '../../types';
+import type { IBracketCompetitor } from './bracket-competitor.interface';
+import type { IBracketMatch } from './bracket-match.interface';
 import type { IBracketRound } from './bracket-round.interface';
 /**
  * Props for `<OrigamBracketRound>` — a single round (column in
@@ -24,3 +26,28 @@ export interface IBracketRoundProps extends ICommonsComponentProps, ITagProps, I
     /** Forward intent color. */
     color?: TIntent;
 }
+/** Emits fired by `<OrigamBracketRound>` — re-emitted from its default
+ *  `<OrigamBracketMatch>` renders (or from a custom `match` / `competitor`
+ *  slot render that wires the same handlers back up). */
+export interface IBracketRoundEmits {
+    (e: 'match-click', match: IBracketMatch, event: MouseEvent): void;
+    (e: 'competitor-click', competitor: IBracketCompetitor, match: IBracketMatch, side: 'A' | 'B', event: MouseEvent | KeyboardEvent): void;
+    (e: 'winner-click', competitor: IBracketCompetitor, match: IBracketMatch, event: MouseEvent | KeyboardEvent): void;
+}
+/** Scope for the `round-title` slot. */
+export interface IBracketRoundTitleSlot {
+    round: IBracketRound;
+    index: number;
+}
+/** Scope for the `match` slot — one match card slot in this round.
+ *  `isFinal` is `true` only for the round's single match when it's also
+ *  the bracket's last round (the championship match). */
+export interface IBracketRoundMatchSlot {
+    match: IBracketMatch;
+    round: IBracketRound;
+    isFinal: boolean;
+}
+export interface IBracketRoundSlots {
+    'round-title'?: (props: IBracketRoundTitleSlot) => any;
+    match?: (props: IBracketRoundMatchSlot) => any;
+}

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

@@ -0,0 +1,56 @@
+import type { TBracketBorder, TBracketColor, TBracketElevation, TBracketRounded } from '../../types';
+/**
+ * Prop bag consumed by `bracketSurfaceVars` to paint one match card.
+ *
+ * Mirrors the `IBgColorProps` / `IRoundedProps` / `IElevationProps` /
+ * `IBorderProps` surfaces that `IBracketProps` and
+ * `IBracketMatchProps` already extend — but it is a SEPARATE shape on
+ * purpose, and does not `extends` them.
+ *
+ * The reason is the target element. `IBorderProps.border` accepts a
+ * `TDirectionBoth[]` edge selector, which `useBorder` resolves onto the
+ * component ROOT. The bracket resolves its surface props onto the match
+ * CARD instead (each card is what the user sees shaped and bordered),
+ * through `--origam-bracket-match---*` custom properties, and a custom
+ * property cannot express "these edges only" the way `useBorder`'s
+ * class output can. Extending `IBorderProps` here would therefore
+ * declare a prop form this layer silently drops — the exact
+ * typed-but-inert failure the surrounding audit exists to remove.
+ *
+ * Every property type is nonetheless DERIVED from the matching Commons
+ * vocabulary (see the `TBracket*` aliases in
+ * `types/Bracket/bracket.type.ts`), so the two
+ * cannot drift on the value grammar they share.
+ */
+export interface IBracketSurfaceInput {
+    bgColor?: TBracketColor;
+    rounded?: TBracketRounded;
+    elevation?: TBracketElevation;
+    border?: TBracketBorder;
+    borderColor?: TBracketColor;
+    borderStyle?: string | null;
+    /**
+     * Per-corner radius and per-side border overrides.
+     *
+     * The bracket resolves `rounded` / `border` onto the MATCH CARD rather
+     * than its own root (each card is what the user sees shaped and
+     * bordered), so the directional rungs of `IRoundedProps` /
+     * `IBorderProps` have to follow the same target — otherwise
+     * `roundedTopLeft` is typed, editable in Histoire, and inert, which is
+     * exactly the class of bug this surface is being audited for.
+     */
+    roundedTopLeft?: TBracketRounded;
+    roundedTopRight?: TBracketRounded;
+    roundedBottomLeft?: TBracketRounded;
+    roundedBottomRight?: TBracketRounded;
+    borderTop?: TBracketBorder;
+    borderRight?: TBracketBorder;
+    borderBottom?: TBracketBorder;
+    borderLeft?: TBracketBorder;
+    borderBlock?: TBracketBorder;
+    borderInline?: TBracketBorder;
+    borderTopColor?: TBracketColor;
+    borderRightColor?: TBracketColor;
+    borderBottomColor?: TBracketColor;
+    borderLeftColor?: TBracketColor;
+}

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

@@ -1,5 +1,9 @@
 import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TBracketVariant } from '../../types';
+import type { TBracketConnectorPath, TBracketVariant } from '../../types';
+import type { IBracketCompetitor } from './bracket-competitor.interface';
+import type { IBracketMatchCompetitorSlot } from './bracket-match-component.interface';
+import type { IBracketMatch } from './bracket-match.interface';
+import type { IBracketRoundMatchSlot, IBracketRoundTitleSlot } from './bracket-round-component.interface';
 import type { IBracketRound } from './bracket-round.interface';
 /**
  * Props for `<OrigamBracket>` — a tournament tree renderer supporting
@@ -77,3 +81,29 @@ export interface IBracketProps extends ICommonsComponentProps, ITagProps, IDensi
      */
     losersLabel?: string;
 }
+/** Emits fired by `<OrigamBracket>` — bubbled up from every match /
+ *  competitor across every round (single-elim tree, both double-elim
+ *  trees, or the round-robin matrix). */
+export interface IBracketEmits {
+    (e: 'match-click', match: IBracketMatch, round: IBracketRound, event: MouseEvent): void;
+    (e: 'winner-click', competitor: IBracketCompetitor, match: IBracketMatch, event: MouseEvent | KeyboardEvent): void;
+    (e: 'competitor-click', competitor: IBracketCompetitor, match: IBracketMatch, event: MouseEvent | KeyboardEvent): void;
+}
+/** Scope for the `connector` slot — one measured SVG link between two
+ *  match cards (single/double-elimination only; round-robin has no
+ *  connectors). Overriding it replaces the default `<path>` render. */
+export interface IBracketConnectorSlot {
+    from: TBracketConnectorPath['from'];
+    to: TBracketConnectorPath['to'];
+}
+/** Slot signatures for `<OrigamBracket>`. `round-title` / `match` /
+ *  `competitor` are 1:1 forwards of `<OrigamBracketRound>` /
+ *  `<OrigamBracketMatch>`'s own slots (same scope, same names) — they
+ *  exist here so a consumer can override deeply-nested match/competitor
+ *  rendering without dropping down to the round component directly. */
+export interface IBracketSlots {
+    connector?: (props: IBracketConnectorSlot) => any;
+    'round-title'?: (props: IBracketRoundTitleSlot) => any;
+    match?: (props: IBracketRoundMatchSlot) => any;
+    competitor?: (props: IBracketMatchCompetitorSlot) => any;
+}

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

@@ -1,5 +1,9 @@
 import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, ISizeProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
+/** Slot signatures for `<OrigamBreadcrumbDivider>`. */
+export interface IBreadcrumbDividerSlots {
+    default?: () => any;
+}
 export interface IBreadcrumbDividerProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IDensityProps, IColorProps, IBgColorProps, ISizeProps {
     divider: string | TIcon;
 }

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

@@ -1,4 +1,4 @@
-import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IAdjacentSlots, 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;
@@ -6,3 +6,8 @@ export interface IBreadcrumbItemProps extends ICommonsComponentProps, ITagProps,
 /** Emits fired by `<OrigamBreadcrumbItem>` — clicks on prepend/append icons. */
 export interface IBreadcrumbItemEmits extends IAdjacentEmits {
 }
+/** Slot signatures for `<OrigamBreadcrumbItem>`. */
+export interface IBreadcrumbItemSlots extends IAdjacentSlots {
+    /** Overrides the item's title label. */
+    default?: () => any;
+}

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

@@ -5,3 +5,25 @@ export interface IBreadcrumbProps extends IColorProps, IBgColorProps, ITagProps,
     divider?: string | TIcon;
     items?: Array<TBreadcrumbItem>;
 }
+/** 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
+ *  own indexed slot. */
+export interface IBreadcrumbSlots {
+    default?: () => any;
+    [key: `item.${number}`]: ((data: {
+        item: TBreadcrumbItem;
+        index: number;
+    }) => any) | undefined;
+    item?: (data: {
+        item: TBreadcrumbItem;
+        index: number;
+    }) => any;
+    'item.title'?: () => any;
+    [key: `divider.${number}`]: ((data: {
+        divider: string | TIcon | undefined;
+    }) => any) | undefined;
+    divider?: (data: {
+        divider: string | TIcon | undefined;
+    }) => any;
+}