origam 2.14.1 → 2.15.0

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/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

@@ -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/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;
+}

package/dist/src/interfaces/Window/window-item.interface.d.ts

@@ -6,3 +6,7 @@ export interface IWindowItemProps extends ICommonsComponentProps, ILazyProps, IG
 /** Emits fired by `<OrigamWindowItem>` — group membership lifecycle. */
 export interface IWindowItemEmits extends IGroupEmits {
 }
+/** Slot signatures for `<OrigamWindowItem>`. */
+export interface IWindowItemSlots {
+    default?: () => any;
+}

package/dist/src/interfaces/Window/window.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITouchHandlers } from '../../interfaces';
+import type { IActiveProps, IBgColorProps, IBorderProps, ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IElevationProps, IGroupProvide, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITouchHandlers } from '../../interfaces';
 import type { TIcon } from '../../types';
 import type { ComputedRef, Ref } from 'vue';
 export interface IWindowProps extends ICommonsComponentProps, ITagProps, IDirectionProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, IElevationProps, IBgColorProps, IHoverProps, IActiveProps {
@@ -23,3 +23,33 @@ export interface IWindowProvide {
 /** Emits fired by `<OrigamWindow>` — v-model on the active slide. */
 export interface IWindowEmits extends ICommonsComponentEmits {
 }
+/** Navigation button props forwarded by `<OrigamWindow>` to its
+ *  prev/next `<origam-btn>` (spread via `v-bind`). */
+export interface IWindowNavBtnProps {
+    icon: TIcon;
+    class: string;
+    onClick: () => void;
+    'aria-label': string;
+}
+/** Slot signatures for `<OrigamWindow>`. `default` / `additional`
+ *  receive the window's own selection/navigation API (`useGroup`
+ *  return value); `arrows` / `prev` / `next` receive the pre-built
+ *  navigation button props. */
+export interface IWindowSlots {
+    default?: (group: IGroupProvide) => any;
+    arrows?: (data: {
+        prevProps: IWindowNavBtnProps;
+        nextProps: IWindowNavBtnProps;
+        canMoveBack: boolean;
+        canMoveForward: boolean;
+    }) => any;
+    prev?: (data: {
+        props: IWindowNavBtnProps;
+        canMove: boolean;
+    }) => any;
+    next?: (data: {
+        props: IWindowNavBtnProps;
+        canMove: boolean;
+    }) => any;
+    additional?: (group: IGroupProvide) => any;
+}

package/dist/src/interfaces/index.cjs

@@ -344,6 +344,17 @@ Object.keys(_chipGroup).forEach(function (key) {
     }
   });
 });
+var _clientOnly = require("./ClientOnly/client-only.interface.cjs");
+Object.keys(_clientOnly).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _clientOnly[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _clientOnly[key];
+    }
+  });
+});
 var _clipboard = require("./Clipboard/clipboard.interface.cjs");
 Object.keys(_clipboard).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -2324,6 +2335,17 @@ Object.keys(_textMask).forEach(function (key) {
     }
   });
 });
+var _themeProvider = require("./ThemeProvider/theme-provider.interface.cjs");
+Object.keys(_themeProvider).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _themeProvider[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _themeProvider[key];
+    }
+  });
+});
 var _title = require("./Title/title.interface.cjs");
 Object.keys(_title).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

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

@@ -29,6 +29,7 @@ export * from './Checkbox/checkbox.interface';
 export * from './Checkbox/checkbox-btn.interface';
 export * from './Chip/chip.interface';
 export * from './Chip/chip-group.interface';
+export * from './ClientOnly/client-only.interface';
 export * from './Clipboard/clipboard.interface';
 export * from './Code/code.interface';
 export * from './ColorPicker/color-picker.interface';
@@ -209,6 +210,7 @@ export * from './Textarea/textarea-rich.interface';
 export * from './Textarea/textarea-toolbar.interface';
 export * from './TextField/text-field.interface';
 export * from './TextMask/text-mask.interface';
+export * from './ThemeProvider/theme-provider.interface';
 export * from './Title/title.interface';
 export * from './Toolbar/toolbar.interface';
 export * from './Tooltip/tooltip.interface';

package/dist/src/interfaces/index.js

@@ -29,6 +29,7 @@ export * from "./Checkbox/checkbox.interface.js";
 export * from "./Checkbox/checkbox-btn.interface.js";
 export * from "./Chip/chip.interface.js";
 export * from "./Chip/chip-group.interface.js";
+export * from "./ClientOnly/client-only.interface.js";
 export * from "./Clipboard/clipboard.interface.js";
 export * from "./Code/code.interface.js";
 export * from "./ColorPicker/color-picker.interface.js";
@@ -209,6 +210,7 @@ export * from "./Textarea/textarea-rich.interface.js";
 export * from "./Textarea/textarea-toolbar.interface.js";
 export * from "./TextField/text-field.interface.js";
 export * from "./TextMask/text-mask.interface.js";
+export * from "./ThemeProvider/theme-provider.interface.js";
 export * from "./Title/title.interface.js";
 export * from "./Toolbar/toolbar.interface.js";
 export * from "./Tooltip/tooltip.interface.js";

package/dist/src/types/Audio/audio.type.d.ts

@@ -0,0 +1,37 @@
+import { OrigamAudio } from '../../components';
+import { AUDIO_LOOP_MODE, AUDIO_VARIANT } from '../../enums';
+import type { TControlsSource } from '../Commons/controls.type';
+import type { TInline } from '../Commons/anchor.type';
+export type TOrigamAudio = InstanceType<typeof OrigamAudio>;
+/**
+ * Controls rendering strategy for `<OrigamAudio>`.
+ *
+ * - `'custom'` (default): the component paints `<OrigamMediaController>`
+ *   on top of the `<audio>` element. The `<audio>` is rendered WITHOUT
+ *   the native `controls` attribute so the two UIs do not stack.
+ * - `'native'`: the `<audio>` element receives the native `controls`
+ *   attribute and the browser paints its own bar. No custom UI is
+ *   rendered. Useful when the platform's accessibility shortcuts
+ *   matter more than a unified visual identity.
+ *
+ * `custom | native` subset of the Commons `TControlsSource` (see
+ * `Commons/controls.type.ts`) — Audio has no `'none'` variant, unlike
+ * `TVideoControls`.
+ */
+export type TAudioControls = Exclude<TControlsSource, 'none'>;
+/**
+ * String-typed equivalent of {@link AUDIO_LOOP_MODE}.
+ */
+export type TAudioLoopMode = `${AUDIO_LOOP_MODE}`;
+/**
+ * String-typed equivalent of {@link AUDIO_VARIANT}. Lets callers pass
+ * literal `'normal' | 'minimal'` strings on the SFC prop API while the
+ * runtime still recognises the enum members.
+ */
+export type TAudioVariant = `${AUDIO_VARIANT}`;
+/**
+ * String-typed equivalent of {@link COVER_POSITION}, which itself
+ * mirrors {@link INLINE} (see `Commons/anchor.enum.ts`). Drives the
+ * `coverPosition` prop of `<OrigamAudio>`.
+ */
+export type TCoverPosition = TInline;

package/dist/src/types/Blockquote/blockquote.type.d.ts

@@ -0,0 +1,42 @@
+import { OrigamBlockquote } from '../../components';
+export type TOrigamBlockquote = InstanceType<typeof OrigamBlockquote>;
+/**
+ * Horizontal alignment of the citation body. `pull` variant defaults to
+ * `'center'`; every other variant defaults to `'left'`.
+ */
+export type TBlockquoteAlign = 'left' | 'center' | 'right';
+/**
+ * Locale hint for `<OrigamBlockquote>` decorative quote marks. Only
+ * relevant for `variant="quoted"` — the other variants ignore the prop.
+ *
+ * - `'fr'`   — French guillemets : « … »
+ * - `'en'`   — Curly double quotes: “ … ”
+ * - `'es'`   — Spanish angular quotes: « … » (same glyphs as fr,
+ *              kept distinct so future tweaks — e.g. spanish prefers
+ *              corner marks ｢ ｣ in some fonts — can branch cleanly).
+ * - `'de'`   — German low-9 / high-6 pair: „ … “
+ * - `'auto'` — honour the consumer-provided `lang` attribute on the
+ *              element OR `<html lang>` if none. Falls back to `'en'`
+ *              when no locale is reachable.
+ *
+ * Resolution lives in `src/consts/Blockquote/blockquote.const.ts`
+ * (`QUOTE_MARKS_BY_LANG`).
+ */
+export type TBlockquoteLang = 'fr' | 'en' | 'es' | 'de' | 'auto';
+/**
+ * Visual variants for `<OrigamBlockquote>`. Each variant is a self
+ * contained typographic treatment; consumers do not mix them — pick the
+ * one that fits the surrounding content density.
+ *
+ * - `default`  — left accent bar + comfortable padding-inline. Neutral
+ *                rhythm, fits most prose contexts.
+ * - `elegant`  — serif face, italic, more breathing room. Editorial
+ *                long-form content (essays, articles).
+ * - `quoted`   — large decorative open/close marks (locale-aware,
+ *                see `TBlockquoteLang`). Marketing pages, hero quotes.
+ * - `minimal`  — bare italic + small indent. Inline citations inside
+ *                technical docs where the visual must stay quiet.
+ * - `pull`     — pull quote: large body type, centred, extracted out of
+ *                the flow. Use sparingly — one per article max.
+ */
+export type TBlockquoteVariant = 'default' | 'elegant' | 'quoted' | 'minimal' | 'pull';

package/dist/src/types/BottomNav/bottom-nav.type.d.ts

@@ -1,4 +1,9 @@
 import { OrigamBottomNav } from '../../components';
 import type { BOTTOM_NAV_POSITION } from '../../enums';
 export type TOrigamBottomNav = InstanceType<typeof OrigamBottomNav>;
+/**
+ * String-typed equivalent of {@link BOTTOM_NAV_POSITION}, a strict
+ * `start | center | end` subset of the Commons `TAlign` scale — see
+ * `enums/BottomNav/bottom-nav-position.enum.ts`.
+ */
 export type TBottomNavPosition = `${BOTTOM_NAV_POSITION}`;

package/dist/src/types/Bracket/bracket-competitor.type.d.ts

@@ -0,0 +1,2 @@
+import { OrigamBracketCompetitor } from '../../components';
+export type TOrigamBracketCompetitor = InstanceType<typeof OrigamBracketCompetitor>;

package/dist/src/types/Bracket/bracket-match.type.d.ts

@@ -0,0 +1,4 @@
+import { BRACKET_MATCH_STATUS } from '../../enums';
+import { OrigamBracketMatch } from '../../components';
+export type TBracketMatchStatus = `${BRACKET_MATCH_STATUS}`;
+export type TOrigamBracketMatch = InstanceType<typeof OrigamBracketMatch>;

package/dist/src/types/Bracket/{bracket-round-side.type.d.ts → bracket-round.type.d.ts}

@@ -1,3 +1,4 @@
+import { OrigamBracketRound } from '../../components';
 /**
  * Optional side marker for double-elimination tournaments.
  *
@@ -10,3 +11,4 @@
  * `undefined`.
  */
 export type TBracketRoundSide = 'winner' | 'loser' | 'grand-final';
+export type TOrigamBracketRound = InstanceType<typeof OrigamBracketRound>;

package/dist/src/types/Bracket/bracket.type.d.ts

@@ -0,0 +1,54 @@
+import type { IBracketMatch, IBracketRound } from '../../interfaces';
+import type { TDirection } from '../Commons/direction.type';
+import { BRACKET_VARIANT } from '../../enums';
+import { OrigamBracket } from '../../components';
+/**
+ * One measured SVG connector link between two match cards
+ * (`<OrigamBracket>`'s `connectorPaths`). Computed from the LIVE DOM rects
+ * of the match cards (not a formula) so the link always lands on the
+ * exact centre of the card it leaves / enters — see the "Connector
+ * measurement" block in `OrigamBracket.vue` for why a formula was not
+ * reliable across density / title / score variations.
+ */
+export type TBracketConnectorPath = {
+    key: string;
+    d: string;
+    from: {
+        matchId: IBracketMatch['id'];
+        x: number;
+        y: number;
+    };
+    to: {
+        matchId: IBracketMatch['id'];
+        x: number;
+        y: number;
+    };
+    winner: boolean;
+};
+/**
+ * Layout axis of the bracket tree.
+ *
+ * - `'horizontal'` — each round is a column, matches stack vertically
+ *   within the column, connectors flow left-to-right.
+ * - `'vertical'`   — each round is a row, matches lay out horizontally,
+ *   connectors flow top-to-bottom.
+ *
+ * Mirrors the global `TDirection` so the bracket plays nicely with the
+ * rest of the design system's direction props.
+ */
+export type TBracketDirection = TDirection;
+/**
+ * One rendered tree of a double-elimination bracket (`<OrigamBracket>`'s
+ * `doubleSections` computed). A double-elimination tournament is really
+ * two independent trees — Winner Bracket and Loser Bracket — converging on
+ * a single Grand Final, so each section carries its own pre-translated
+ * label and the subset of `IBracketRound[]` that belongs to it. Empty
+ * sections are filtered out before render.
+ */
+export type TBracketDoubleSection = {
+    key: 'winners' | 'losers' | 'grand-final';
+    label: string;
+    rounds: IBracketRound[];
+};
+export type TBracketVariant = `${BRACKET_VARIANT}`;
+export type TOrigamBracket = InstanceType<typeof OrigamBracket>;

package/dist/src/types/Calendar/calendar.type.d.ts

@@ -0,0 +1,25 @@
+import { OrigamCalendar } from '../../components';
+export type TOrigamCalendar = InstanceType<typeof OrigamCalendar>;
+/**
+ * Clock format for time labels in week / day / agenda views.
+ *
+ * `'24h'` — 00:00 → 23:59. Default for everywhere except en-US.
+ * `'12h'` — 12:00 AM → 11:59 PM. Honours locale-specific AM/PM.
+ */
+export type TCalendarTimeFormat = '12h' | '24h';
+/**
+ * Navigation direction passed to `useCalendar().navigate(...)` and
+ * the `navigate` event. `'today'` jumps to "now" regardless of the
+ * current view.
+ */
+export type TCalendarNavigate = 'prev' | 'next' | 'today';
+/**
+ * Top-level view modes supported by `<OrigamCalendar>`.
+ *
+ * - `'month'` — 6×7 day grid; the canonical "month at a glance" view.
+ * - `'week'`  — 7-column vertical timeline with one row per slot.
+ * - `'day'`   — single-column vertical timeline (zoom into one day).
+ * - `'agenda'`— flat list grouped by day, useful for screen readers
+ *               and dense schedules.
+ */
+export type TCalendarView = 'month' | 'week' | 'day' | 'agenda';

package/dist/src/types/Chart/chart-axis.type.d.ts

@@ -0,0 +1,2 @@
+import { OrigamChartAxis } from '../../components';
+export type TOrigamChartAxis = InstanceType<typeof OrigamChartAxis>;

package/dist/src/types/Chart/chart-box-plot.type.d.ts

@@ -0,0 +1,2 @@
+import { OrigamChartBoxPlot } from '../../components';
+export type TOrigamChartBoxPlot = InstanceType<typeof OrigamChartBoxPlot>;