origam 2.14.1 → 2.16.0

package/dist/src/interfaces/Sheet/sheet-emits.interface.d.ts

@@ -1,3 +1,4 @@
+import type { IActiveEmits } from '../../interfaces';
 import type { TSheetSnapId } from '../../types';
 /**
  * Emit signature for `<OrigamSheet>`.
@@ -8,8 +9,17 @@ import type { TSheetSnapId } from '../../types';
  * - `update:open` is the v-model:open companion — emitted on the
  *   closed/non-closed boundary so two-way binding stays consistent
  *   when the user dismisses via swipe-down.
+ * - `update:active` vient de `useActive(props)` : `onActive()` est câblé
+ *   sur le clic ET sur `keydown.enter` / `keydown.space` du template, et
+ *   écrit dans le v-model `active`. L'émission partait sans être
+ *   déclarée. Prouvé au runtime dans
+ *   `packages/tests/TU/origam/relay-emits-declaration.spec.ts`.
  */
-export interface ISheetEmits {
+export interface ISheetEmits extends IActiveEmits {
     (e: 'update:snap', id: TSheetSnapId): void;
     (e: 'update:open', value: boolean): void;
 }
+/** Slot signatures for `<OrigamSheet>`. */
+export interface ISheetSlots {
+    default?: () => any;
+}

package/dist/src/interfaces/Slide/slide-group.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBorderProps, ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IDisplayProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IBorderProps, ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IDisplayProps, IGroupProps, IGroupProvide, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface ISlideGroupProps extends ICommonsComponentProps, ITagProps, IDirectionProps, IGroupProps, IPaddingProps, IMarginProps, IRoundedProps, IBorderProps, IDisplayProps {
     centerActive?: boolean;
@@ -9,3 +9,11 @@ export interface ISlideGroupProps extends ICommonsComponentProps, ITagProps, IDi
 /** Emits fired by `<OrigamSlideGroup>` — v-model on the active slide. */
 export interface ISlideGroupEmits extends ICommonsComponentEmits {
 }
+/** Slot signatures for `<OrigamSlideGroup>`. */
+export interface ISlideGroupSlots {
+    prev?: () => any;
+    /** Receives the group's own navigation/selection API so custom
+     *  content can drive the slide group without re-injecting it. */
+    default?: (data: Pick<IGroupProvide, 'next' | 'prev' | 'select' | 'isSelected'>) => any;
+    next?: () => any;
+}

package/dist/src/interfaces/SliderField/slider-field-track.interface.d.ts

@@ -21,3 +21,19 @@ export interface ISliderFieldTrackProps extends ICommonsComponentProps, IColorPr
     /** Pre-computed tick descriptors — parent owns the math. */
     ticks?: Array<TTick>;
 }
+/**
+ * Slot signatures for `<OrigamSliderFieldTrack>`. `item` and the
+ * per-tick `item.{index}` share the same `{ tick, index }` scope — the
+ * indexed form is the fallback the un-indexed `item` slot itself falls
+ * back to.
+ */
+export interface ISliderFieldTrackSlots {
+    item?: (data: {
+        tick: TTick;
+        index: number;
+    }) => any;
+    [key: `item.${number}`]: ((data: {
+        tick: TTick;
+        index: number;
+    }) => any) | undefined;
+}

package/dist/src/interfaces/SliderField/slider-field.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IFocusEmits, IFocusProps, IInputProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISliderFieldTrackProps } from '../../interfaces';
+import type { IAdjacentSlots, IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IFocusEmits, IFocusProps, IInputProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISliderFieldTrackProps, ISliderFieldTrackSlots } from '../../interfaces';
 import type { TAlways, TSize, TSliderFieldVariant } from '../../types';
 export interface ISliderFieldProps extends ICommonsComponentProps, IDensityProps, IColorProps, IInputProps, IFocusProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IRippleProps, IDirectionProps {
     disabled?: boolean;
@@ -92,3 +92,29 @@ export interface ISliderFieldEmits extends ICommonsComponentEmits, IFocusEmits {
     (e: 'start', value: number | string | Array<number> | Array<string>): void;
     (e: 'end', value: number | string | Array<number> | Array<string>): void;
 }
+/**
+ * Slot signatures for `<OrigamSliderField>`. `prepend` / `append` are
+ * unscoped ("field" variant only — `hasPrepend`/`slots.append` gate
+ * them). `default` is scoped when the field variant renders, `label`
+ * is unscoped, `item` forwards straight through to the nested
+ * `<OrigamSliderFieldTrack>`'s own `item` slot.
+ */
+export interface ISliderFieldSlots extends IAdjacentSlots {
+    default?: (data: {
+        id: string;
+        messagesId: string;
+        isDisabled: boolean;
+        isReadonly: boolean;
+        isValid: boolean | undefined;
+    }) => any;
+    label?: () => any;
+    item?: ISliderFieldTrackSlots['item'];
+    details?: (props: any) => any;
+    messages?: (data: {
+        hasMessages: boolean;
+        messages: Array<string> | Record<string, string>;
+    }) => any;
+    message?: (data: {
+        message: any;
+    }) => any;
+}

package/dist/src/interfaces/Snackbar/snackbar-group.interface.d.ts

@@ -1,4 +1,5 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { Ref } from 'vue';
+import type { ICommonsComponentProps, ISnackbarGroupItem, ISnackbarGroupItemOptions, ITagProps } from '../../interfaces';
 import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../types';
 /**
  * Props for `<OrigamSnackbarGroup>` — a multi-toast container that
@@ -39,7 +40,11 @@ export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
     /**
      * Default auto-dismiss timeout (ms) applied to items that do not
      * supply their own `duration`. Pass `0` to make all items sticky
-     * by default.
+     * by default. Registered into the shared stack store on mount (and
+     * kept in sync reactively), so it applies to `notify()` calls from
+     * ANY `useSnackbarGroup({ id })` instance targeting this stack —
+     * not only calls that repeat `defaultDuration` as a composable
+     * option.
      *
      * @default 5000
      */
@@ -58,3 +63,58 @@ export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
      */
     direction?: TSnackbarGroupDirection;
 }
+/**
+ * Per-`id` singleton store backing `useSnackbarGroup`.
+ *
+ * One entry per stack `id`, held in a module-level map for the lifetime
+ * of the module, so any number of components / composables addressing
+ * the same `id` share state (notify here, dismiss there).
+ */
+export interface ISnackbarGroupState {
+    items: Ref<Array<ISnackbarGroupItem>>;
+    timers: Map<string, number>;
+    counter: {
+        current: number;
+    };
+    /**
+     * Fallback `duration` (ms) for this stack, registered by the
+     * mounted `<OrigamSnackbarGroup defaultDuration="…">` instance (see
+     * `useSnackbarGroupInternal`'s `registerDefaultDuration`). Lets
+     * `notify()` — called from ANYWHERE, independent of which
+     * `useSnackbarGroup({ id })` call site fired it — honour the
+     * component's declared default without requiring every caller to
+     * repeat `defaultDuration` as a composable option. See #snackbar-
+     * group-default-duration-bug: before this, the component's prop and
+     * the composable's `notify()` never met, so `defaultDuration` on
+     * `<OrigamSnackbarGroup>` was purely decorative.
+     */
+    defaultDuration: Ref<number>;
+}
+/** Options accepted by `useSnackbarGroup`. */
+export interface IUseSnackbarGroupOptions {
+    id?: string;
+    /**
+     * Maximum number of items kept in the stack. When `notify` would
+     * push past this number, the oldest item is evicted FIFO. When
+     * undefined, the stack is unbounded (the rendering component
+     * still caps the visible count via its `max` prop).
+     */
+    max?: number;
+    /**
+     * Fallback `duration` applied to items that omit their own.
+     * Defaults to `SNACKBAR_GROUP_DEFAULT_DURATION` (5 000 ms).
+     */
+    defaultDuration?: number;
+}
+/**
+ * Public API returned by `useSnackbarGroup`. The `items` ref is the
+ * same reactive reference shared with the matching
+ * `<OrigamSnackbarGroup id="…">` instance, so direct mutation outside
+ * of `notify` / `dismiss` is discouraged.
+ */
+export interface IUseSnackbarGroupReturn {
+    items: Readonly<Ref<ReadonlyArray<ISnackbarGroupItem>>>;
+    notify: (opts: ISnackbarGroupItemOptions) => string;
+    dismiss: (itemId: string) => void;
+    dismissAll: () => void;
+}

package/dist/src/interfaces/Snackbar/snackbar-item.interface.d.ts

@@ -77,3 +77,17 @@ export interface ISnackbarItemProps extends ICommonsComponentProps, ITypographyP
      */
     dataCy?: string;
 }
+/** Emits fired by `<OrigamSnackbarItem>` — dismissal and action-button
+ *  activation. */
+export interface ISnackbarItemEmits {
+    (e: 'dismiss'): void;
+    (e: 'action', action: ISnackbarGroupItemAction): void;
+}
+/** Slot signatures for `<OrigamSnackbarItem>`. */
+export interface ISnackbarItemSlots {
+    prepend?: () => any;
+    title?: () => any;
+    message?: () => any;
+    default?: () => any;
+    actions?: () => any;
+}

package/dist/src/interfaces/Snackbar/snackbar.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IMarginProps, IOverlayProps, IPaddingProps, IPositionProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IMarginProps, IOverlayProps, IPaddingProps, IPositionProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
 export interface ISnackbarProps extends ICommonsComponentProps, ITagProps, IStatusProps, IColorProps, IBgColorProps, IOverlayProps, IPositionProps, ILocationProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, ITransitionComponentProps, IActiveProps, IHoverProps {
     multiLine?: boolean;
     text?: string;
@@ -6,3 +6,19 @@ export interface ISnackbarProps extends ICommonsComponentProps, ITagProps, IStat
     timeout?: number | string;
     vertical?: boolean;
 }
+/** Emits fired by `<OrigamSnackbar>` — fermeture auto ou par geste. */
+export interface ISnackbarEmits extends ICommonsComponentEmits {
+}
+/** Slot signatures for `<OrigamSnackbar>` — the nested
+ *  `<OrigamSnackbarItem>`'s `prepend` / `title` / `message` chrome,
+ *  plus the unscoped `default` and the `action` slot. */
+export interface ISnackbarSlots {
+    prepend?: () => any;
+    title?: () => any;
+    text?: () => any;
+    message?: () => any;
+    default?: () => any;
+    action?: (data: {
+        isActive: boolean;
+    }) => any;
+}

package/dist/src/interfaces/Stepper/stepper.interface.d.ts

@@ -29,3 +29,16 @@ export interface IStepperItemProps extends ICommonsComponentProps {
     status?: TStepperItemStatus;
     clickable?: boolean;
 }
+/** Emits fired by `<OrigamStepper>` — v-model echo for the active step. */
+export interface IStepperEmits {
+    (e: 'update:modelValue', value: number): void;
+}
+/** Slot signatures for `<OrigamStepper>`. */
+export interface IStepperSlots {
+    /** Overrides the whole auto-generated item list. */
+    default?: () => any;
+}
+/** Emits fired by `<OrigamStepperItem>` — click on a clickable step. */
+export interface IStepperItemEmits {
+    (e: 'click', index: number): void;
+}

package/dist/src/interfaces/Switch/switch.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IBorderProps, IClickLabelEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IHoverProps, IIndeterminateEmits, IInputProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ISelectionControlProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IBorderProps, IClickLabelEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IHoverProps, IIndeterminateEmits, IInputProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ISelectionControlProps, ISwitchTrackSlotsProps, ITagProps } from '../../interfaces';
 export interface ISwitchProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IInputProps, ISelectionControlProps, ILoaderProps, IColorProps, IDensityProps, IElevationProps, IActiveProps, IHoverProps {
     indeterminate?: boolean;
     inset?: boolean;
@@ -8,3 +8,12 @@ export interface ISwitchProps extends ICommonsComponentProps, ITagProps, IPaddin
  *  (three-state) + label click. */
 export interface ISwitchEmits extends ICommonsComponentEmits, IFocusEmits, IIndeterminateEmits, IClickLabelEmits {
 }
+/** Slot signatures for `<OrigamSwitch>`. `track.true` / `track.false`
+ *  forward straight through to the nested `<OrigamSwitchTrack>`'s own
+ *  slots of the same name; `loader` overrides the circular spinner
+ *  painted on the thumb during an async toggle. */
+export interface ISwitchSlots {
+    'track.true'?: (props: ISwitchTrackSlotsProps) => any;
+    'track.false'?: (props: ISwitchTrackSlotsProps) => any;
+    loader?: () => any;
+}

package/dist/src/interfaces/Table/table.interface.d.ts

@@ -6,3 +6,11 @@ export interface ITableProps extends ICommonsComponentProps, IBorderProps, IRoun
     captionVisible?: boolean;
     ariaRowcount?: number;
 }
+/** Slot signatures for `<OrigamTable>`. */
+export interface ITableSlots {
+    top?: () => any;
+    /** Overrides the whole `<table>` element. */
+    wrapper?: () => any;
+    default?: () => any;
+    bottom?: () => any;
+}

package/dist/src/interfaces/Tabs/tab-panel.interface.d.ts

@@ -10,3 +10,7 @@ import type { ICommonsComponentProps, IGroupItemProps, ILazyProps, ITagProps } f
 export interface ITabPanelProps extends ICommonsComponentProps, ITagProps, IGroupItemProps, ILazyProps {
     tag?: string;
 }
+/** Slot signatures for `<OrigamTabPanel>`. */
+export interface ITabPanelSlots {
+    default?: () => any;
+}

package/dist/src/interfaces/Tabs/tab-panels.interface.d.ts

@@ -1,4 +1,4 @@
-import type { ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IGroupProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IGroupProps, IGroupProvide, ITagProps } from '../../interfaces';
 import type { ComputedRef, Ref } from 'vue';
 /**
  * Props for `<OrigamTabPanels>` — the content area that mirrors the
@@ -29,3 +29,15 @@ export interface ITabPanelsProvide {
 /** Emits fired by `<OrigamTabPanels>` — v-model mirrors the parent tablist. */
 export interface ITabPanelsEmits extends ICommonsComponentEmits {
 }
+/** Scope forwarded to the `default` slot — the raw `useGroup()`
+ *  selection API, forwarded as-is (its `selected` field stays a `Ref`,
+ *  mirroring `ITabsSlotProps` / `IItemGroupSlots`). `items` is
+ *  unwrapped from the `ComputedRef` returned by `useGroup` into the
+ *  plain array. */
+export interface ITabPanelsSlotProps extends Pick<IGroupProvide, 'isSelected' | 'select' | 'next' | 'prev' | 'selected'> {
+    items: IGroupProvide['items']['value'];
+}
+/** Slot signatures for `<OrigamTabPanels>`. */
+export interface ITabPanelsSlots {
+    default?: (data: ITabPanelsSlotProps) => any;
+}

package/dist/src/interfaces/Tabs/tab.interface.d.ts

@@ -1,11 +1,16 @@
-import type { ICommonsComponentProps, IGroupItemProps, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { IAdjacentProps, ICommonsComponentProps, IGroupItemProps, ITagProps, ITypographyProps } from '../../interfaces';
+import type { TIcon, TTabVariant } from '../../types';
 /**
  * Props for `<OrigamTab>` — a single registered tab inside an
  * `<OrigamTabs>` tablist.
  *
- * The slot scope is the default text label. Optional `icon` /
- * `appendIcon` render at the leading / trailing edge respectively.
+ * The slot scope is the default text label. Leading / trailing content
+ * is driven by the standard `IAdjacentProps` surface (`prependIcon` /
+ * `appendIcon` / `prependAvatar` / `appendAvatar`) — the same contract
+ * every other adjacent-icon component in the DS uses (`OrigamBtn`,
+ * `OrigamChip`, `OrigamListItem`, …). Before this fix `icon` /
+ * `appendIcon` were declared by hand, without `prependIcon` — an icon
+ * could only ever be placed on the trailing edge, never the leading one.
  *
  * ARIA wiring (`role="tab"`, `aria-selected`, `aria-controls`, `id`,
  * `tabindex`) is computed inside the component — consumers only
@@ -16,8 +21,30 @@ import type { TIcon } from '../../types';
  * `lineHeight` is intentionally excluded — the SCSS hard-codes `line-height: 1`
  * with no CSS-var hook.
  */
-export interface ITabProps extends ICommonsComponentProps, ITagProps, IGroupItemProps, ITypographyProps {
+export interface ITabProps extends ICommonsComponentProps, ITagProps, IGroupItemProps, ITypographyProps, IAdjacentProps {
     tag?: string;
+    /** Text label — used when the `default` slot is not provided. */
+    text?: string;
+    /** Visual treatment, mirrored down from the parent `<OrigamTabs>` (`default`, `pills`, `underline`). */
+    variant?: TTabVariant;
+    /**
+     * @deprecated Use `prependIcon` instead — same leading-icon position,
+     * kept for backward compatibility. Ignored when `prependIcon` is set.
+     */
     icon?: TIcon;
-    appendIcon?: TIcon;
+}
+/** Scope forwarded to the `default` slot — the resolved selection
+ *  state from `useGroupItem`, unwrapped from its `Ref`s (unlike
+ *  `ITabsSlotProps`, which forwards the parent's raw `useGroup()` API
+ *  as-is). */
+export interface ITabSlotProps {
+    isSelected: boolean;
+    toggle: () => void;
+    select: (value: boolean) => void;
+    value: unknown;
+    disabled: boolean | undefined;
+}
+/** Slot signatures for `<OrigamTab>`. */
+export interface ITabSlots {
+    default?: (data: ITabSlotProps) => any;
 }

package/dist/src/interfaces/Tabs/tabs.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IGroupProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IGroupProps, IGroupProvide, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TTabVariant } from '../../types';
 /**
  * Props for `<OrigamTabs>` — a stateful tablist container.
@@ -27,3 +27,14 @@ export interface ITabsProps extends ICommonsComponentProps, ITagProps, IDirectio
 /** Emits fired by `<OrigamTabs>` — v-model on the active tab. */
 export interface ITabsEmits extends ICommonsComponentEmits {
 }
+/** Scope forwarded to the `default` slot — the raw `useGroup()`
+ *  selection API, forwarded as-is (its `selected` field stays a `Ref`,
+ *  mirroring `IItemGroupSlots`). `items` is unwrapped from the
+ *  `ComputedRef` returned by `useGroup` into the plain array. */
+export interface ITabsSlotProps extends Pick<IGroupProvide, 'isSelected' | 'select' | 'next' | 'prev' | 'selected'> {
+    items: IGroupProvide['items']['value'];
+}
+/** Slot signatures for `<OrigamTabs>`. */
+export interface ITabsSlots {
+    default?: (data: ITabsSlotProps) => any;
+}

package/dist/src/interfaces/Theme/origam-theme.interface.d.ts

@@ -1,6 +1,21 @@
+import type { Ref } from 'vue';
 import type { IThemeVars, TThemeVars } from '../../types';
-import type { TMode } from '../../types/Theme/theme.type';
+import type { TMode, TTheme } from '../../types/Theme/theme.type';
 import type { IDefault } from '../DefaultProvider/default-provider.interface';
+/**
+ * Shape of the `useTheme()` singleton state.
+ *
+ * Held on `globalThis` in the browser (so duplicated module instances
+ * within the same JS realm share it) and as a plain module-level object
+ * on the server (so per-request theme state cannot leak across
+ * concurrent requests). See `theme.composable.ts` for the full rationale.
+ */
+export interface IOrigamThemeSingletonState {
+    theme: Ref<TTheme> | null;
+    mode: Ref<TMode> | null;
+    systemPrefersDark: Ref<boolean> | null;
+    mediaInitDone: boolean;
+}
 /**
  * Runtime theme object ingested by `createOrigam({ themes })`. At install time
  * the DS resolves it to a block of `--origam-*` CSS variables injected into

package/dist/src/interfaces/ThemeProvider/theme-provider.interface.d.ts

@@ -0,0 +1,31 @@
+import type { ITagProps } from '../Commons/commons.interface';
+import type { TMode, TTheme } from '../../types';
+/** Props for `<OrigamThemeProvider>` — the sub-tree theme/mode override wrapper. */
+export interface IThemeProviderProps extends ITagProps {
+    /**
+     * Theme (brand) to apply to this sub-tree. Children that read CSS vars
+     * resolve them against this `data-theme` instead of the document root.
+     *
+     * Use `'auto'` to defer to the closest ancestor (no `data-theme`
+     * attribute is rendered).
+     */
+    theme?: TTheme;
+    /**
+     * Color mode to force on this sub-tree, applied as `data-mode`.
+     * Orthogonal to `theme`: a branded sub-tree can be pinned to light
+     * or dark independently of the document mode.
+     *
+     * Use `'auto'` to defer to the closest ancestor (no `data-mode`
+     * attribute is rendered).
+     */
+    mode?: TMode;
+    /**
+     * HTML tag for the wrapper. Default `div`. Use `section`/`article`/etc.
+     * when the wrapper carries semantic meaning.
+     */
+    tag?: string;
+}
+/** Slot signatures for `<OrigamThemeProvider>`. */
+export interface IThemeProviderSlots {
+    default?: () => any;
+}

package/dist/src/interfaces/Timeline/timeline.interface.d.ts

@@ -1,5 +1,5 @@
 import type { IColorProps, ICommonsComponentProps, IDensityProps, ISizeProps, ITagProps } from '../../interfaces';
-import type { TIcon, TIntent, TTimelineOrientation } from '../../types';
+import type { TIcon, TIntent, TTimelineOrientation, TTimelineSide } from '../../types';
 /**
  * Shape of the context object provided by OrigamTimeline to its
  * nested OrigamTimelineItem children. Used via inject so each item
@@ -10,7 +10,7 @@ import type { TIcon, TIntent, TTimelineOrientation } from '../../types';
  * `src/consts/Timeline/timeline.const.ts` (TIMELINE_CONTEXT_KEY).
  */
 export interface ITimelineContext {
-    side: 'start' | 'end' | 'alternating';
+    side: TTimelineSide;
     truncateLine: boolean;
     orientation: TTimelineOrientation;
     color?: string;
@@ -33,7 +33,7 @@ export interface ITimelineProps extends ICommonsComponentProps, ITagProps, IColo
      *    Content (title/subtitle/body) renders BELOW each dot.
      */
     orientation?: TTimelineOrientation;
-    side?: 'start' | 'end' | 'alternating';
+    side?: TTimelineSide;
     truncateLine?: boolean;
     ariaLabel?: string;
 }
@@ -44,7 +44,7 @@ export interface ITimelineItemProps extends ICommonsComponentProps, IColorProps,
     intent?: TIntent;
     isLast?: boolean;
     truncateLine?: boolean;
-    side?: 'start' | 'end' | 'alternating';
+    side?: TTimelineSide;
     /**
      * Layout direction forwarded by the parent OrigamTimeline. When unset
      * the item assumes vertical layout. Items rarely set this directly —
@@ -53,3 +53,15 @@ export interface ITimelineItemProps extends ICommonsComponentProps, IColorProps,
     orientation?: TTimelineOrientation;
     index?: number;
 }
+/** Slot signatures for `<OrigamTimeline>`. */
+export interface ITimelineSlots {
+    /** Overrides the whole auto-generated `<OrigamTimelineItem>` list. */
+    default?: () => any;
+}
+/** Slot signatures for `<OrigamTimelineItem>`. */
+export interface ITimelineItemSlots {
+    dot?: () => any;
+    /** Overrides the whole title/subtitle header + body block. */
+    default?: () => any;
+    body?: () => any;
+}

package/dist/src/interfaces/Title/title.interface.d.ts

@@ -2,3 +2,8 @@ import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps,
 export interface ITitleProps extends ITagProps, ICommonsComponentProps, IColorProps, IBgColorProps, IDensityProps, IPaddingProps, IMarginProps, IBorderProps, ITypographyProps {
     text?: string;
 }
+/** Slot signatures for `<OrigamTitle>`. The `default` slot wins over
+ *  the `text` prop. */
+export interface ITitleSlots {
+    default?: () => any;
+}

package/dist/src/interfaces/Toolbar/toolbar.interface.d.ts

@@ -6,3 +6,18 @@ export interface IToolbarProps extends ITagProps, ICommonsComponentProps, IBorde
     title?: string;
     modelValue?: boolean;
 }
+/** Slot signatures for `<OrigamToolbar>`. None are scoped — every slot
+ *  is a plain content override on top of the default wrapper layout
+ *  (prepend / title / content / append). */
+export interface IToolbarSlots {
+    /** Replaces the entire wrapper (prepend + title + content + append). */
+    default?: () => any;
+    /** Leading content, before the title. */
+    prepend?: () => any;
+    /** Overrides the rendered title. Slot wins over the `title` prop. */
+    title?: () => any;
+    /** Main bar content. */
+    content?: () => any;
+    /** Trailing content, after the main content. */
+    append?: () => any;
+}

package/dist/src/interfaces/Tooltip/tooltip.interface.d.ts

@@ -6,3 +6,15 @@ export interface ITooltipProps extends ICommonsComponentProps, IOverlayProps, IC
 /** Emits fired by `<OrigamTooltip>` — v-model on the open state. */
 export interface ITooltipEmits extends ICommonsComponentEmits {
 }
+/** Slot signatures for `<OrigamTooltip>`. */
+export interface ITooltipSlots {
+    /** Overrides the activator element. Receives the props the overlay
+     *  wants bound onto it (`aria-describedby`, event listeners, …) —
+     *  mirrors `IMenuSlots.activator`, minus the `isActive` flag that
+     *  `<OrigamOverlay>` exposes but `<OrigamTooltip>` doesn't forward. */
+    activator?: (data: {
+        props: Record<string, unknown>;
+    }) => any;
+    /** Tooltip body. Falls back to the `text` prop when omitted. */
+    default?: () => any;
+}

package/dist/src/interfaces/Transition/transition.interface.d.ts

@@ -19,3 +19,9 @@ export interface ITranslateScaleProps extends ITransitionProps {
 export interface ITransitionWindowProps extends ITransitionProps {
     window?: IWindowProvide;
 }
+/** Slot signatures shared by every `<Origam*>` transition wrapper
+ *  (Fade, SlideX/Y, ExpandX/Y, ScaleRotate, TranslateScale, …) — a
+ *  single unscoped `default` slot holding the transitioned content. */
+export interface ITransitionSlots {
+    default?: () => any;
+}

package/dist/src/interfaces/Treeview/treeview.interface.d.ts

@@ -24,6 +24,14 @@ export interface ITreeviewNodeProps extends ICommonsComponentProps {
     node: ITreeviewNode;
     depth?: number;
 }
+/** Emits fired by `<OrigamTreeview>` — v-model echoes (selection,
+ *  expansion) and node select/toggle lifecycle. */
+export interface ITreeviewEmits {
+    (e: 'update:modelValue', value: string[] | string): void;
+    (e: 'update:expandedValue', value: string[]): void;
+    (e: 'select', id: string): void;
+    (e: 'toggle', id: string, expanded: boolean): void;
+}
 export interface ITreeviewProvide {
     toggleExpanded: (id: string) => void;
     toggleSelected: (id: string) => void;

package/dist/src/interfaces/Video/video.interface.d.ts

@@ -1,6 +1,6 @@
 import type { Ref } from 'vue';
 import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IMediaPlayerEmits, IMediaPlayerMethods, IMediaPlayerState, IPaddingProps, IRoundedProps, ITypographyProps, IUseMediaPlayerOptions, IVideoSource, IVideoTrack } from '../../interfaces';
-import type { TVideoControls } from '../../types';
+import type { TCrossOrigin, TVideoControls } from '../../types';
 /**
  * Bindings passed to the `#controls` scoped slot of `<OrigamVideo>`.
  *
@@ -160,7 +160,7 @@ export interface IVideoProps extends ICommonsComponentProps, IColorProps, IBgCol
      * the consumer needs canvas / WebAudio access to the decoded
      * frames. Affects how cookies are sent on the request.
      */
-    crossorigin?: 'anonymous' | 'use-credentials';
+    crossorigin?: TCrossOrigin;
     /**
      * Disables the picture-in-picture button (and the matching
      * keyboard shortcut). Useful for content where PIP would defeat

package/dist/src/interfaces/VirtualScroll/virtual-scroll-item.interface.d.ts

@@ -8,3 +8,14 @@ export interface IVirtualScrollItemProps extends ICommonsComponentProps {
 export interface IVirtualScrollItemEmits {
     (e: 'update:height', value: number): void;
 }
+/** Slot signatures for `<OrigamVirtualScrollItem>`. */
+export interface IVirtualScrollItemSlots {
+    /** Renderless mode only (`renderless: true`) — receives the
+     *  resize-observed element ref so the consumer can attach it to
+     *  their own markup instead of the built-in wrapper `<div>`. */
+    renderless?: (data: {
+        itemRef: HTMLElement | null | undefined;
+    }) => any;
+    /** Default (non-renderless) content, rendered inside the wrapper `<div>`. */
+    default?: () => any;
+}

package/dist/src/interfaces/VirtualScroll/virtual-scroll.interface.d.ts

@@ -3,3 +3,42 @@ export interface IVirtualScrollProps extends ICommonsComponentProps, IDimensionP
     items?: Array<any>;
     renderless?: boolean;
 }
+/** Scope forwarded to the per-index `item.{index}` slot — the index is
+ *  implied by the slot's own name, so it isn't repeated in the scope
+ *  (unlike the `item` fallback below). `item` is typed `any` because
+ *  `IVirtualScrollProps.items` itself is declared `Array<any>`. */
+export interface IVirtualScrollItemSlotProps {
+    item: any;
+}
+/** Scope forwarded to the un-indexed `item` fallback slot (used when no
+ *  `item.{index}` override exists for the current row) — same as
+ *  `IVirtualScrollItemSlotProps` plus the explicit `index`, since the
+ *  fallback isn't keyed by position. */
+export interface IVirtualScrollFallbackItemSlotProps extends IVirtualScrollItemSlotProps {
+    index: number;
+}
+/** Scope forwarded to the per-index `item.renderless.{index}` slot
+ *  (renderless mode). Adds the resize-observed element ref forwarded
+ *  by the child `<OrigamVirtualScrollItem>`'s own `renderless` slot. */
+export interface IVirtualScrollRenderlessItemSlotProps extends IVirtualScrollItemSlotProps {
+    itemRef: HTMLElement | null | undefined;
+}
+/** Scope forwarded to the un-indexed `item.renderless` fallback slot. */
+export interface IVirtualScrollRenderlessFallbackItemSlotProps extends IVirtualScrollRenderlessItemSlotProps {
+    index: number;
+}
+/**
+ * Slot signatures for `<OrigamVirtualScroll>`.
+ *
+ * Per-row overrides are only known at runtime (`item.{index}` and
+ * `item.renderless.{index}`), so they're expressed as template-literal
+ * index signatures alongside the un-indexed fallback names the
+ * template also checks (`slot name="item.renderless"` / `slot
+ * name="item"`), mirroring `IExpansionPanelsSlots`.
+ */
+export interface IVirtualScrollSlots {
+    item?: (data: IVirtualScrollFallbackItemSlotProps) => any;
+    'item.renderless'?: (data: IVirtualScrollRenderlessFallbackItemSlotProps) => any;
+    [key: `item.${number}`]: ((data: IVirtualScrollItemSlotProps) => any) | undefined;
+    [key: `item.renderless.${number}`]: ((data: IVirtualScrollRenderlessItemSlotProps) => any) | undefined;
+}