origam 2.3.0 → 2.6.1

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,5 +1,5 @@
-import type { ICommonsComponentProps, IDensityProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TBracketVariant, TIntent } from '../../types';
+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';
 /**
  * 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, 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
@@ -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
@@ -68,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-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/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-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,12 +1,24 @@
-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 { 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. */
+export interface IBtnEmits extends IAdjacentEmits, IGroupEmits {
 }

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

@@ -0,0 +1,164 @@
+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 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. */
+    currentDate?: Date | string;
+    /** Event list. Recurring events are expanded internally. */
+    events?: Array<IEvent>;
+    /**
+     * First weekday rendered as the leftmost column. `1` (Monday) for
+     * EU/ISO, `0` (Sunday) for US. Default `1`.
+     */
+    firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** Clock format for time labels. Default `'24h'`. */
+    timeFormat?: TCalendarTimeFormat;
+    /** BCP 47 locale tag — drives weekday / month names. */
+    locale?: string;
+    /** Enable drag-select on the grid. Default `true`. */
+    selectable?: boolean;
+    /**
+     * Which property of `IEvent` to read for colouring. Default
+     * `'category'`. Setting to `'color'` makes the calendar use the
+     * direct override exclusively.
+     */
+    eventColorKey?: 'category' | 'color' | string;
+    /**
+     * Map category string → intent / CSS colour. Skip the prop to
+     * fall back to the neutral surface for all categories.
+     */
+    categoryColors?: Record<string, TIntent | string>;
+    /** Tint Saturday + Sunday in month / week views. Default `true`. */
+    weekendHighlight?: boolean;
+    /**
+     * Render a leading ISO week-number column. Useful for project /
+     * billing calendars. Default `false`.
+     */
+    showWeekNumbers?: boolean;
+    /** First hour rendered in week / day views. Default `0`. */
+    dayStartHour?: number;
+    /** Last hour rendered in week / day views. Default `24`. */
+    dayEndHour?: number;
+    /**
+     * Minutes per row in the timeline. `30` for half-hour granularity
+     * (default), `15` for fine-grained drag-create, `60` for compact.
+     */
+    slotDuration?: number;
+    /** Lower navigation bound. The toolbar disables `<` past this. */
+    minDate?: Date | string;
+    /** Upper navigation bound. The toolbar disables `>` past this. */
+    maxDate?: Date | string;
+    /**
+     * Cells to grey out. Accepts an array (Dates or ISO strings) or a
+     * predicate when the disabling rule is too dynamic to enumerate.
+     */
+    disabledDates?: Array<Date | string> | ((d: Date) => boolean);
+}
+/**
+ * Default values applied by `<OrigamCalendar>` and consumed by the
+ * composable. Kept here as a single source of truth for the
+ * "non-undefined" prop surface — the SFC still inlines the literals
+ * inside `withDefaults` (cf. CLAUDE.md rule), this interface is for
+ * the composable to type its merged options.
+ */
+export interface IResolvedCalendarOptions {
+    view: TCalendarView;
+    currentDate: Date;
+    events: Array<IEvent>;
+    firstDayOfWeek: number;
+    timeFormat: TCalendarTimeFormat;
+    locale: string;
+    selectable: boolean;
+    eventColorKey: string;
+    categoryColors: Record<string, TIntent | string>;
+    weekendHighlight: boolean;
+    showWeekNumbers: boolean;
+    dayStartHour: number;
+    dayEndHour: number;
+    slotDuration: number;
+    minDate: Date | null;
+    maxDate: Date | null;
+    disabledDatesPredicate: (date: Date) => boolean;
+}
+/**
+ * Emits surfaced by `<OrigamCalendar>`. Mirrors the doc — every
+ * payload is plain serialisable data (Date instances + the original
+ * event reference) so consumers can forward them through a Pinia
+ * action or a websocket without unwrapping refs.
+ */
+export interface ICalendarEmits {
+    (e: 'update:view', view: TCalendarView): void;
+    (e: 'update:currentDate', date: Date): void;
+    (e: 'event-click', event: IEvent, originalDOMEvent: MouseEvent): void;
+    (e: 'date-click', date: Date): void;
+    (e: 'range-select', start: Date, end: Date): void;
+    (e: 'create-event-request', start: Date, end: Date): void;
+    (e: 'view-change', view: TCalendarView): void;
+    (e: 'navigate', direction: TCalendarNavigate): void;
+}
+/**
+ * Slot signatures. The default toolbar can be replaced wholesale via
+ * `#header`, individual day cells via `#day` / `#dayHeader`, and the
+ * event card via `#event`. Empty agenda state via `#empty`.
+ */
+export interface ICalendarSlots {
+    header?: (bindings: ICalendarHeaderSlotBindings) => any;
+    event?: (bindings: ICalendarEventSlotBindings) => any;
+    day?: (bindings: ICalendarDaySlotBindings) => any;
+    dayHeader?: (bindings: {
+        date: Date;
+    }) => any;
+    empty?: (bindings: {
+        view: TCalendarView;
+    }) => any;
+}
+/** Bindings handed to the `#event` slot — one per visible event. */
+export interface ICalendarEventSlotBindings {
+    event: IEvent;
+    view: TCalendarView;
+    isPast: boolean;
+    isToday: boolean;
+}
+/** Bindings handed to the `#day` slot — one per cell in month view. */
+export interface ICalendarDaySlotBindings {
+    date: Date;
+    events: Array<IEvent>;
+    isToday: boolean;
+    isPast: boolean;
+    isOutside: boolean;
+    isWeekend: boolean;
+    isDisabled: boolean;
+}
+/** Bindings handed to the `#header` slot — full toolbar replacement. */
+export interface ICalendarHeaderSlotBindings {
+    view: TCalendarView;
+    title: string;
+    canPrev: boolean;
+    canNext: boolean;
+    setView: (next: TCalendarView) => void;
+    navigate: (direction: TCalendarNavigate) => void;
+}
+/** Composable options — strict version of the props after defaulting. */
+export interface IUseCalendarOptions {
+    events: () => Array<IEvent>;
+    view: () => TCalendarView;
+    currentDate: () => Date;
+    firstDayOfWeek: () => number;
+    slotDuration: () => number;
+    dayStartHour: () => number;
+    dayEndHour: () => number;
+    minDate?: () => Date | null;
+    maxDate?: () => Date | null;
+    locale?: () => string;
+}

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

@@ -0,0 +1,54 @@
+import type { TIntent } from '../../types';
+/**
+ * Public event shape consumed by `<OrigamCalendar>` and the
+ * `useCalendar` composable. Designed to be friendly to JSON
+ * round-trips — `start` / `end` may be passed as ISO-8601 strings,
+ * Date objects, or epoch numbers; the calendar normalises them
+ * internally.
+ *
+ * `rrule` follows a strict subset of RFC 5545 (see
+ * `src/utils/Calendar/rrule.util.ts`): `FREQ=DAILY|WEEKLY|MONTHLY`
+ * + `INTERVAL=N` + `COUNT=N` + `UNTIL=...` + `BYDAY=...`. Anything
+ * else is ignored — flag this in the consumer-facing doc.
+ */
+export interface IEvent {
+    /** Stable identifier — used as `:key` and for click-target wiring. */
+    id: string | number;
+    /** Displayed title — also read by the default `aria-label`. */
+    title: string;
+    /** Optional long-form description — surfaced in the agenda view. */
+    description?: string;
+    /** Start instant. ISO-8601 strings and `Date` instances both work. */
+    start: string | Date;
+    /**
+     * End instant. Omitted when `allDay=true` (the calendar treats the
+     * event as a single-day block) or for "point-in-time" events with
+     * no measurable duration.
+     */
+    end?: string | Date;
+    /**
+     * `true` to render the event in the all-day band above the time
+     * grid (week / day views). Has no effect in month view.
+     */
+    allDay?: boolean;
+    /**
+     * Free-form category string — used as the lookup key for
+     * `categoryColors`. Useful when multiple events share a colour
+     * (e.g. "meeting", "focus", "personal").
+     */
+    category?: string;
+    /**
+     * Direct colour override. Wins over `category` when both are set.
+     * Accepts a `TIntent` (matches the design-token rail) or any CSS
+     * colour string.
+     */
+    color?: TIntent | string;
+    /**
+     * RRULE subset string. The calendar expands the recurrence to
+     * the visible range at render time; the original event is **not**
+     * mutated.
+     */
+    rrule?: string;
+    /** Free-form metadata — passed through to the `event-click` payload. */
+    metadata?: Record<string, unknown>;
+}

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

@@ -1,5 +1,8 @@
-import type { 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;
 }
+/** Emits fired by `<OrigamCardHeader>` — clicks on prepend/append slots. */
+export interface ICardHeaderEmits extends IAdjacentEmits {
+}

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/Card/card.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveEmits, IActiveProps, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverEmits, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TCardType } from '../../types';
 export interface ICardProps extends ICommonsComponentProps, ITagProps, IBorderProps, IColorProps, IBgColorProps, IDensityProps, IDimensionProps, IElevationProps, ILoaderProps, ILocationProps, IPositionProps, IRoundedProps, IMarginProps, IPaddingProps, ILinkProps, IRippleProps, IAdjacentProps, IActiveProps {
     disabled?: boolean;
@@ -11,3 +11,7 @@ export interface ICardProps extends ICommonsComponentProps, ITagProps, IBorderPr
     title?: string | number;
     type?: TCardType;
 }
+/** Emits fired by `<OrigamCard>` — prepend/append clicks + active/hover
+ *  state propagation. */
+export interface ICardEmits extends IAdjacentEmits, IActiveEmits, IHoverEmits {
+}

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

@@ -1,6 +1,6 @@
-import type { IColorProps, 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;
@@ -9,3 +9,6 @@ export interface ICarouselProps extends IWindowProps, IColorProps, ICommonsCompo
     progress?: boolean;
     verticalDelimiters?: boolean | TInline;
 }
+/** Emits fired by `<OrigamCarousel>` — v-model on the active slide index. */
+export interface ICarouselEmits extends ICommonsComponentEmits {
+}

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

@@ -0,0 +1,99 @@
+import type { TIntent } from '../../types';
+/**
+ * A single overlay annotation drawn on top of a cartesian chart's
+ * SVG surface. Annotations are positioned in data coordinates and
+ * projected to pixel space by the chart's X/Y scales. They are
+ * cartesian-only — polar, radar, gauge and other non-cartesian
+ * families ignore this prop.
+ *
+ * Four kinds are supported:
+ *
+ * - `'arrow'`   — a directed line with an arrowhead at the head end,
+ *                 optional text label near the tail.
+ * - `'label'`   — a rounded-rect callout box with text, connected to
+ *                 the data point by a thin leader line.
+ * - `'circle'`  — a stroked circle centred on the data point,
+ *                 optional text label next to it.
+ * - `'bracket'` — a horizontal or L-shaped bracket spanning two data
+ *                 coordinates, centered text label above/below.
+ */
+export interface IChartAnnotation {
+    /** Annotation kind. */
+    kind: 'arrow' | 'label' | 'circle' | 'bracket';
+    /** Source / anchor data coordinate on the X axis (category string or numeric index). */
+    x: number | string;
+    /** Source / anchor data coordinate on the Y axis. */
+    y: number;
+    /**
+     * End-point X coordinate in data space.
+     * Required for `'arrow'` (head position) and `'bracket'` (right edge).
+     */
+    x2?: number | string;
+    /**
+     * End-point Y coordinate in data space.
+     * Optional for `'bracket'` — when omitted the bracket stays
+     * horizontal (`y2 === y`).
+     */
+    y2?: number;
+    /** Text content rendered alongside the annotation. */
+    text?: string;
+    /** Stroke / fill colour — accepts a `TIntent` name or any CSS colour string. */
+    color?: TIntent | string;
+    /** Stroke width in SVG units. Default `1.5`. */
+    width?: number;
+    /** Circle radius in SVG units. Applies to the `'circle'` kind only. Default `12`. */
+    radius?: number;
+    /**
+     * Horizontal offset of the text label relative to its anchor
+     * point, in SVG units. Positive values push the label right.
+     * Default `0`.
+     */
+    dx?: number;
+    /**
+     * Vertical offset of the text label relative to its anchor
+     * point, in SVG units. Positive values push the label down.
+     * Default `-14`.
+     */
+    dy?: number;
+}
+/**
+ * Resolved SVG geometry for one annotation. Produced by
+ * `computeAnnotationGeometry` in `chart.composable.ts` and consumed
+ * directly by `<OrigamChartCartesian>` for rendering. Fields are
+ * gated per `kind` — the renderer checks `kind` before reading each
+ * optional field.
+ */
+export interface IChartAnnotationGeo {
+    kind: IChartAnnotation['kind'];
+    /** Resolved CSS colour string. */
+    stroke: string;
+    strokeWidth: number;
+    /** Anchor pixel coordinate (tail of arrow / anchor of label / centre of circle / left edge of bracket). */
+    ax: number;
+    ay: number;
+    /** End pixel coordinate (head of arrow / right edge of bracket). Equals `(ax, ay)` when unused. */
+    bx: number;
+    by: number;
+    /** Arrowhead polygon `points` attribute — populated for `kind === 'arrow'`. */
+    arrowPoints?: string;
+    /** Text content to display alongside the annotation. */
+    text?: string;
+    /** Resolved horizontal text offset in SVG units. */
+    dx: number;
+    /** Resolved vertical text offset in SVG units. */
+    dy: number;
+    /** Circle radius in SVG units — populated for `kind === 'circle'`. */
+    radius: number;
+    /** Callout rounded-rect geometry — populated for `kind === 'label'`. */
+    callout?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Bottom-centre of the callout box where the leader line terminates — populated for `kind === 'label'`. */
+    leaderEnd?: {
+        x: number;
+        y: number;
+    };
+}