origam 2.3.0 → 2.5.0

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

@@ -1,6 +1,23 @@
 import type { IBgColorProps, IColorProps, ICommonsComponentProps, IRoundedProps, ISizeProps } from '../../interfaces';
+import type { TAlways, TTick } from '../../types';
 export interface ISliderFieldTrackProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IRoundedProps {
     start?: number;
     stop?: number;
     disabled?: boolean;
+    /** Forces `danger` intent on both color channels — driven by the parent
+     *  slider's `error` flag. */
+    error?: boolean;
+    /** Boundaries for tick filtering (first / last suppression). */
+    min?: number;
+    max?: number;
+    /** Orientation hint passed by the parent — controls logical CSS axis. */
+    isVertical?: boolean;
+    /** Inverts the start direction when `reverse` is on or in vertical mode. */
+    indexFromEnd?: boolean;
+    /** Tick visibility. Same semantics as the parent's `showTicks`. */
+    showTicks?: TAlways;
+    /** Tick dot size — px or token unit. */
+    tickSize?: number | string;
+    /** Pre-computed tick descriptors — parent owns the math. */
+    ticks?: Array<TTick>;
 }

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

@@ -1,7 +1,5 @@
-import { useSteps } from '../../composables';
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IFocusProps, IInputProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISliderFieldThumbProps, ISliderFieldTrackProps } from '../../interfaces';
-import type { TAlways, TColor, TDirectionBoth, TOrigamSliderFieldThumb, TOrigamSliderFieldTrack, TSize, TSliderData, TTick } from '../../types';
-import { Ref } from 'vue';
+import type { IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IFocusEmits, IFocusProps, IInputProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISliderFieldTrackProps } 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;
     required?: boolean;
@@ -11,66 +9,86 @@ export interface ISliderFieldProps extends ICommonsComponentProps, IDensityProps
     max?: number | string;
     min?: number | string;
     step?: number | string;
-    thumbProps?: ISliderFieldThumbProps;
+    /**
+     * Visual props forwarded to the track sub-component (rail / fill / ticks).
+     * Color / size / rounded only — pointer math is owned by the native
+     * `<input type="range">`.
+     */
     trackProps?: ISliderFieldTrackProps;
     reverse?: boolean;
     modelValue?: number | string | Array<number> | Array<string>;
     range?: boolean;
     showTicks?: TAlways;
-    ticks?: Array<number> | string;
+    ticks?: Array<number> | Record<string, string>;
     tickSize?: TSize | number;
+    /**
+     * Compact "inset" style — the draggable thumb sits **inside** the
+     * track (smaller, no overflow). Mirrors `OrigamSwitch`'s `inset`
+     * flag. Useful in tight contexts like a volume tooltip or a compact
+     * form row.
+     *
+     * @default false
+     */
+    inset?: boolean;
+    /**
+     * Visual variant of the slider.
+     *
+     * - `'field'`  → default, wraps the slider in `<origam-input>` chrome
+     *               (label, messages, prepend/append). Use for form-grade
+     *               sliders (e.g. settings panels, ColorPicker HSL slider).
+     * - `'timer'`  → bare wrapper without `<origam-input>`. Hairline rail
+     *               (2 px at rest, 4 px on hover/focus), thumb hidden
+     *               until hover/focus/scrub. Use for media-scrubber-style
+     *               UI (video timeline, volume slider).
+     * - `'audio'`  → same as `timer`, plus a waveform background painted
+     *               from `peaks`. Use for `OrigamAudio` waveform scrubbing.
+     *
+     * @default 'field'
+     */
+    variant?: TSliderFieldVariant;
+    /**
+     * Secondary fill rendered from `min` to `buffered`, layered behind
+     * the active fill at reduced opacity. Mirrors a video player's
+     * "loaded ranges" indicator. Has no effect when undefined.
+     */
+    buffered?: number;
+    /**
+     * Hide the thumb at rest and only reveal it on container `:hover`,
+     * `:focus-within`, or during a drag. CSS-only — no JS state.
+     *
+     * For `variant='timer'` and `variant='audio'`, this is effectively
+     * always on (forced via the variant's class). For `variant='field'`,
+     * the consumer must opt in explicitly.
+     *
+     * @default false
+     */
+    showThumbOnHoverOnly?: boolean;
+    /**
+     * Render a small floating tooltip above the rail showing the value
+     * under the cursor. The cursor X position is forwarded as a CSS
+     * variable updated in a single RAF-throttled `pointermove` handler.
+     *
+     * @default false
+     */
+    showHoverTooltip?: boolean;
+    /**
+     * Formatter applied to the hover tooltip text. Receives the value
+     * under the cursor (clamped to `[min, max]`).
+     *
+     * @default (value: number) => String(value)
+     */
+    formatHoverTooltip?: (value: number) => string;
+    /**
+     * Waveform peaks in the range `[0, 1]`. When set with
+     * `variant='audio'`, peaks are painted as vertical bars BEHIND the
+     * track via inline SVG: bars left of the thumb use the active color,
+     * bars right use a 35 %-mixed fade. No effect for other variants.
+     */
+    peaks?: ReadonlyArray<number>;
 }
-export interface ISliderFieldProvide {
-    activeThumbRef: Ref<HTMLElement | undefined>;
-    decimals: Ref<number>;
-    disabled: Ref<boolean | null | undefined>;
-    readonly: Ref<boolean | null | undefined>;
-    error: Ref<boolean | null | undefined>;
-    elevation: Ref<string | number | undefined>;
-    rounded: Ref<string | number | boolean | null | undefined>;
-    border: Ref<string | number | boolean | TDirectionBoth | Array<TDirectionBoth> | null | undefined>;
-    ripple: Ref<boolean | {
-        class: string;
-    } | undefined>;
-    color: Ref<TColor>;
-    hoverColor: Ref<TColor>;
-    activeColor: Ref<TColor>;
-    bgColor: Ref<TColor>;
-    hoverBgColor: Ref<TColor>;
-    activeBgColor: Ref<TColor>;
-    min: Ref<number>;
-    max: Ref<number>;
-    mousePressed: Ref<boolean>;
-    numTicks: Ref<number>;
-    onSliderMousedown: (e: MouseEvent) => void;
-    onSliderTouchstart: (e: TouchEvent) => void;
-    parseMouseMove: (e: MouseEvent | TouchEvent) => number;
-    position: (val: number) => number;
-    roundValue: (value: number) => number;
-    showTicks: Ref<TAlways | undefined>;
-    startOffset: Ref<number>;
-    step: Ref<number>;
-    ticks: Ref<number[] | string | undefined>;
-    tickSize: Ref<number>;
-    origamSliderFieldTrackRef: Ref<TOrigamSliderFieldTrack | null | undefined>;
-    origamSliderFieldThumbRef: Ref<TOrigamSliderFieldThumb | null | undefined>;
-    origamSliderFieldStartThumbRef: Ref<TOrigamSliderFieldThumb | null | undefined>;
-    origamSliderFieldStopThumbRef: Ref<TOrigamSliderFieldThumb | null | undefined>;
-    isVertical: Ref<boolean>;
-    parsedTicks: Ref<Array<TTick>>;
-    hasLabels: Ref<boolean>;
-    isReversed: Ref<boolean | undefined>;
-    indexFromEnd: Ref<boolean>;
-}
-export interface ISliderField {
-    origamSliderFieldTrackRef: Ref<TOrigamSliderFieldTrack | null | undefined>;
-    origamSliderFieldThumbRef: Ref<TOrigamSliderFieldThumb | null | undefined>;
-    origamSliderFieldStartThumbRef: Ref<TOrigamSliderFieldThumb | null | undefined>;
-    origamSliderFieldStopThumbRef: Ref<TOrigamSliderFieldThumb | null | undefined>;
-    props: ISliderFieldProps;
-    steps: ReturnType<typeof useSteps>;
-    onSliderEnd: (data: TSliderData) => void;
-    onSliderStart: (data: TSliderData) => void;
-    onSliderMove: (data: TSliderData) => void;
-    getActiveThumb: (e: MouseEvent | TouchEvent) => HTMLElement;
+/** Emits fired by `<OrigamSliderField>` — v-model + focus + drag lifecycle
+ *  (`start` fires on pointerdown of a thumb, `end` on pointerup). */
+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;
 }

package/dist/src/interfaces/Snackbar/snackbar-group-item.interface.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/interfaces/{SnackbarStack/snackbar-stack-item.interface.d.ts → Snackbar/snackbar-group-item.interface.d.ts}

@@ -7,21 +7,21 @@ import type { TIcon, TIntent } from '../../types';
  * to keep the snackbar visible after the click (e.g. for a multi-step
  * confirmation).
  */
-export interface ISnackbarStackItemAction {
+export interface ISnackbarGroupItemAction {
     label: string;
     handler: () => void;
     intent?: TIntent;
     keepOpen?: boolean;
 }
 /**
- * Options accepted by `useSnackbarStack().notify(opts)`.
+ * Options accepted by `useSnackbarGroup().notify(opts)`.
  *
  * Every field is optional except that the resulting item must surface
  * SOMETHING to the user — either a `title`, a `message`, or both.
  * The composable does not enforce this at runtime; emitting an empty
  * item is a no-op but is allowed for programmatic flexibility.
  */
-export interface ISnackbarStackItemOptions {
+export interface ISnackbarGroupItemOptions {
     /** Bold first line. Useful for short labels (e.g. "Saved"). */
     title?: string;
     /** Body text under the title (or sole line when `title` absent). */
@@ -43,7 +43,7 @@ export interface ISnackbarStackItemOptions {
      */
     icon?: TIcon;
     /** Optional action buttons rendered in the snackbar footer. */
-    actions?: ReadonlyArray<ISnackbarStackItemAction>;
+    actions?: ReadonlyArray<ISnackbarGroupItemAction>;
     /** Whether to show the close (`X`) button. Default `true`. */
     dismissible?: boolean;
     /** Callback fired once the item leaves the stack. */
@@ -54,7 +54,7 @@ export interface ISnackbarStackItemOptions {
  * `id` to the option shape so callers can address the item afterwards
  * (`dismiss(id)`).
  */
-export interface ISnackbarStackItem extends ISnackbarStackItemOptions {
+export interface ISnackbarGroupItem extends ISnackbarGroupItemOptions {
     id: string;
     createdAt: number;
 }

package/dist/src/interfaces/Snackbar/snackbar-group.interface.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/interfaces/{SnackbarStack/snackbar-stack.interface.d.ts → Snackbar/snackbar-group.interface.d.ts}

@@ -1,19 +1,19 @@
 import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
-import type { TSnackbarStackDirection, TSnackbarStackLocation } from '../../types';
+import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../types';
 /**
- * Props for `<OrigamSnackbarStack>` — a multi-toast container that
+ * Props for `<OrigamSnackbarGroup>` — a multi-toast container that
  * orchestrates a queue of `OrigamSnackbar` instances driven through
- * the `useSnackbarStack({ id })` composable.
+ * the `useSnackbarGroup({ id })` composable.
  *
  * The component itself owns NO local visual state — every notification
  * is added via `notify()` and removed via `dismiss()` or auto-timeout.
  * The component subscribes to its registered stack `id` and re-renders
  * when the underlying `items` ref changes.
  */
-export interface ISnackbarStackProps extends ICommonsComponentProps, ITagProps {
+export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
     /**
      * Identifier of the stack this container renders. Pair with
-     * `useSnackbarStack({ id })` to spawn items into the same stack.
+     * `useSnackbarGroup({ id })` to spawn items into the same stack.
      * Multiple stacks can coexist (e.g. a global one + a per-region
      * one) — each one is keyed independently.
      *
@@ -27,7 +27,7 @@ export interface ISnackbarStackProps extends ICommonsComponentProps, ITagProps {
      *
      * @default 'bottom-right'
      */
-    location?: TSnackbarStackLocation;
+    location?: TSnackbarGroupLocation;
     /**
      * Maximum number of items rendered concurrently. When `notify()`
      * pushes a new item past `max`, the oldest item in the stack is
@@ -56,5 +56,5 @@ export interface ISnackbarStackProps extends ICommonsComponentProps, ITagProps {
      * `top-*` locations and `'bottom-up'` for `bottom-*` locations
      * — matching the natural reading direction of fresh items.
      */
-    direction?: TSnackbarStackDirection;
+    direction?: TSnackbarGroupDirection;
 }

package/dist/src/interfaces/Snackbar/snackbar-item.interface.cjs

@@ -0,0 +1 @@
+"use strict";

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

@@ -0,0 +1,79 @@
+import type { ICommonsComponentProps } from '../../interfaces';
+import type { TIcon, TIntent } from '../../types';
+import type { ISnackbarGroupItemAction } from '../../interfaces';
+/**
+ * Props for `<OrigamSnackbarItem>` — the pure visual layer of a single
+ * toast notification. This component owns:
+ *   - Intent theming (surface colour, border, icon tinting)
+ *   - Icon + title + message layout
+ *   - Action buttons rendering
+ *   - Dismiss button rendering
+ *   - ARIA semantics (role, aria-live, aria-atomic)
+ *
+ * It does NOT own positioning, transitions, overlay, or auto-dismiss
+ * logic — those concerns belong to the parent (`OrigamSnackbar` or
+ * `OrigamSnackbarGroup`).
+ *
+ * Both `OrigamSnackbar` and `OrigamSnackbarGroup` consume this component
+ * so all visual intent / layout logic lives in one place only.
+ */
+export interface ISnackbarItemProps extends ICommonsComponentProps {
+    /**
+     * Semantic intent — drives icon defaults and surface colouring via
+     * `--origam-color__feedback--{intent}---*` tokens.
+     *
+     * @default 'info'
+     */
+    intent?: TIntent;
+    /**
+     * Optional title rendered as a bold first line.
+     * Useful for short labels (e.g. "Saved", "Error").
+     */
+    title?: string;
+    /**
+     * Body text rendered under the title (or as the sole line when
+     * `title` is absent). Can be omitted when content is provided
+     * via the `default` slot.
+     */
+    message?: string;
+    /**
+     * Prepend icon override. When omitted, defaults to the per-intent
+     * icon (`mdiCheckCircle` for success, `mdiAlertCircle` for danger,
+     * etc.). Pass `false` to suppress the icon entirely.
+     */
+    icon?: TIcon | false;
+    /**
+     * Action buttons rendered inline after the text block.
+     * Each action fires `handler()` and dismisses the item by default
+     * unless `keepOpen: true`.
+     */
+    actions?: ReadonlyArray<ISnackbarGroupItemAction>;
+    /**
+     * Whether to render the close (✕) dismiss button.
+     *
+     * @default true
+     */
+    dismissible?: boolean;
+    /**
+     * Accessible label for the dismiss button.
+     *
+     * @default 'Dismiss notification'
+     */
+    dismissLabel?: string;
+    /**
+     * ARIA role for the item element. Inferred from `intent` when not
+     * set explicitly: `warning` / `danger` → `'alert'`, others → `'status'`.
+     */
+    role?: 'status' | 'alert';
+    /**
+     * ARIA live region politeness. Inferred from `intent` when not set
+     * explicitly: `warning` / `danger` → `'assertive'`, others → `'polite'`.
+     */
+    ariaLive?: 'polite' | 'assertive';
+    /**
+     * `data-cy` attribute injected on the root item element, forwarded
+     * from the parent stack/snackbar so each toast is addressable in e2e
+     * tests.
+     */
+    dataCy?: string;
+}

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

@@ -1,5 +1,5 @@
 import type { ComputedRef, Ref } from 'vue';
-import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, ISizeProps } from '../../interfaces';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 import type { TStepperItemStatus, TStepperOrientation } from '../../types';
 export interface IStepperItem {
@@ -8,7 +8,7 @@ export interface IStepperItem {
     icon?: TIcon;
     status?: TStepperItemStatus;
 }
-export interface IStepperProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IDensityProps {
+export interface IStepperProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, IBorderProps {
     items?: IStepperItem[];
     modelValue?: number;
     orientation?: 'horizontal' | 'vertical';

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

@@ -40,4 +40,12 @@ export interface ISwitchTrackSlotsProps {
 export interface ISwitchTrackSlots extends ICommonsComponentSlots {
     'track.true'?: (props: ISwitchTrackSlotsProps) => any;
     'track.false'?: (props: ISwitchTrackSlotsProps) => any;
+    /**
+     * Free-form overlay rendered inside the track AFTER the
+     * `track.true` / `track.false` half-labels. Used by `OrigamSwitch`
+     * to host a linear progress bar when `loading={ type: 'line' }`,
+     * but consumers can put any absolute-positioned decoration here
+     * (gradient sweep, sparkles, …) without subclassing the track.
+     */
+    overlay?: (props: ISwitchTrackSlotsProps) => any;
 }

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

@@ -1,6 +1,10 @@
-import type { IActiveProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, 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, 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;
     flat?: boolean;
 }
+/** Emits fired by `<OrigamSwitch>` — v-model + focus + indeterminate
+ *  (three-state) + label click. */
+export interface ISwitchEmits extends ICommonsComponentEmits, IFocusEmits, IIndeterminateEmits, IClickLabelEmits {
+}

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

@@ -2,4 +2,7 @@ import type { IBorderProps, ICommonsComponentProps, IDensityProps, IDimensionPro
 export interface ITableProps extends ICommonsComponentProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IHoverProps, IDimensionProps, IDensityProps, ITagProps {
     fixedHeader?: boolean;
     fixedFooter?: boolean;
+    caption?: string;
+    captionVisible?: boolean;
+    ariaRowcount?: number;
 }

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

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps, IDirectionProps, IGroupProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IGroupProps, ITagProps } from '../../interfaces';
 import type { ComputedRef, Ref } from 'vue';
 /**
  * Props for `<OrigamTabPanels>` — the content area that mirrors the
@@ -26,3 +26,6 @@ export interface ITabPanelsProvide {
     transition: ComputedRef<string | false>;
     isReversed: Ref<boolean>;
 }
+/** Emits fired by `<OrigamTabPanels>` — v-model mirrors the parent tablist. */
+export interface ITabPanelsEmits extends ICommonsComponentEmits {
+}

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

@@ -1,4 +1,4 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDirectionProps, IGroupProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IGroupProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TTabVariant } from '../../types';
 /**
  * Props for `<OrigamTabs>` — a stateful tablist container.
@@ -24,3 +24,6 @@ export interface ITabsProps extends ICommonsComponentProps, ITagProps, IDirectio
     fixed?: boolean;
     centered?: boolean;
 }
+/** Emits fired by `<OrigamTabs>` — v-model on the active tab. */
+export interface ITabsEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/TextMask/text-mask.interface.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/interfaces/TextMask/text-mask.interface.d.ts

@@ -0,0 +1,112 @@
+import type { ICommonsComponentProps, IGradient, ITagProps } from '../../interfaces';
+import type { TBlockquoteAlign, TTextMaskAnimation } from '../../types';
+/**
+ * Props for `<OrigamTextMask>` — typographic "window" component.
+ *
+ * Paints arbitrary text (or rich slot content) as a transparent fill
+ * over an animated background, leveraging `background-clip: text`. The
+ * background can be:
+ *
+ *   - a structured {@link IGradient} object (intent-aware, theme-aware),
+ *   - a raw CSS gradient string (`linear-gradient(...)`, `radial-gradient(...)`,
+ *     `conic-gradient(...)`),
+ *   - a preset name (`gradient-sunset`, `gradient-ocean`, …) resolved to
+ *     `var(--origam-gradient---{slug})`,
+ *   - an `url(...)` value pointing at an image, video poster or data-URL.
+ *
+ * The text content is preserved in the DOM (visible to screen readers
+ * and search engines) — the visual transform is purely CSS.
+ */
+export interface ITextMaskProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * Text to mask. Ignored when the `default` slot is provided.
+     *
+     * Rich markup (e.g. multi-line headlines, inline `<span>` overrides)
+     * should go through the slot instead.
+     */
+    text?: string;
+    /**
+     * Background painted behind the text glyphs. REQUIRED.
+     *
+     * Accepts:
+     *   - A structured {@link IGradient} object — resolved via
+     *     `resolveGradient()` and emitted as a `linear|radial|conic-gradient`
+     *     CSS function call. Stops can reference intents (`primary`,
+     *     `success`, …) — the resolver swaps them for token-driven CSS
+     *     variables, so the gradient re-tints automatically when the
+     *     theme changes.
+     *   - A raw CSS gradient string (`linear-gradient(...)`, …) — emitted
+     *     verbatim.
+     *   - A preset name (`gradient-sunset`, etc.) — resolves to the
+     *     matching `--origam-gradient---{slug}` CSS variable.
+     *   - Any other string — used as a raw `background-image` value
+     *     (typical: `url(/hero.jpg)` for an image, `url(data:...)` for an
+     *     inline asset).
+     */
+    background: string | IGradient;
+    /**
+     * Animate the background. Combined with `animationType` to pick a
+     * keyframe set.
+     *
+     * @default false
+     */
+    animated?: boolean;
+    /**
+     * Duration of one animation cycle. Accepts any CSS `<time>` value
+     * (`'3s'`, `'750ms'`, …). Forwarded to `animation-duration`.
+     *
+     * @default '3s'
+     */
+    animationDuration?: string;
+    /**
+     * Animation strategy. See {@link TTextMaskAnimation}.
+     *
+     * @default 'pan'
+     */
+    animationType?: TTextMaskAnimation;
+    /**
+     * `font-size` of the masked text. Numbers are interpreted as `px`.
+     *
+     * @default 'inherit'
+     */
+    fontSize?: string | number;
+    /**
+     * `font-weight` of the masked text. Accepts numeric weights (100–900)
+     * or keywords (`'bold'`, `'normal'`, …).
+     *
+     * @default 'inherit'
+     */
+    fontWeight?: string | number;
+    /**
+     * `font-family` stack applied to the masked text.
+     *
+     * @default 'inherit'
+     */
+    fontFamily?: string;
+    /**
+     * `line-height` applied to the masked text. Tight by default so the
+     * glyph baseline aligns nicely on large display text.
+     *
+     * @default 1.1
+     */
+    lineHeight?: string | number;
+    /**
+     * `letter-spacing` applied to the masked text. Optional — defaults to
+     * the CSS initial value (i.e. inherits from the document).
+     */
+    letterSpacing?: string;
+    /**
+     * `text-align` of the masked content.
+     *
+     * @default 'left'
+     */
+    align?: TBlockquoteAlign;
+}
+/**
+ * Slot signatures for `<OrigamTextMask>`. The `default` slot wins over
+ * the `text` prop and accepts arbitrary markup (multiple lines, nested
+ * `<h1>` / `<span>` / `<em>` …).
+ */
+export interface ITextMaskSlots {
+    default?: () => any;
+}

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

@@ -1,5 +1,8 @@
-import type { IActivatorProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDimensionProps, ILazyProps, ILocationStrategyProps, IOverlayProps, IScrimProps, IScrollStrategyProps, ITransitionComponentProps } from '../../interfaces';
+import type { IActivatorProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDimensionProps, ILazyProps, ILocationStrategyProps, IOverlayProps, IScrimProps, IScrollStrategyProps, ITransitionComponentProps } from '../../interfaces';
 export interface ITooltipProps extends ICommonsComponentProps, IOverlayProps, IColorProps, IBgColorProps, IDimensionProps, IActivatorProps, ILocationStrategyProps, IScrollStrategyProps, ILazyProps, ITransitionComponentProps, IScrimProps {
     id?: string;
     text?: string;
 }
+/** Emits fired by `<OrigamTooltip>` — v-model on the open state. */
+export interface ITooltipEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/Video/video-track.interface.cjs

@@ -0,0 +1 @@
+"use strict";

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

@@ -0,0 +1,76 @@
+import type { TVideoTrackKind } from '../../types';
+/**
+ * A single `<track>` declaration attached to the `<video>` element.
+ * Mirrors the HTML attributes of the native element 1:1 so consumers
+ * don't have to learn a new shape — pass the same dictionary they'd
+ * pass to a vanilla `<video>` markup.
+ *
+ * The component renders one `<track>` per item, and the custom captions
+ * toggle picks the first item whose `default` is true; the user can
+ * then cycle through the others via the in-toolbar dropdown.
+ */
+export interface IVideoTrack {
+    /**
+     * `kind` of the track. `'captions'` is the default — used by the
+     * built-in captions switcher. `'subtitles'` is treated the same way
+     * for switching purposes; `'descriptions'` and `'chapters'` are
+     * declared but not surfaced in the default toolbar (consumers
+     * needing those expose their own `#controls` slot).
+     */
+    kind: TVideoTrackKind;
+    /**
+     * URL of the WebVTT file. Same-origin or CORS-enabled, otherwise
+     * the browser silently rejects the track.
+     */
+    src: string;
+    /**
+     * BCP-47 language tag — `'en'`, `'fr'`, `'pt-BR'`, … Drives the
+     * language label shown in the captions switcher and is exposed to
+     * assistive technology via the underlying `<track srclang>`.
+     */
+    srclang: string;
+    /**
+     * Human-readable label shown in the switcher (`"English"`,
+     * `"Français"`, …). Defaults to the uppercased `srclang` when
+     * omitted.
+     */
+    label?: string;
+    /**
+     * Marks this track as the one to enable on load. At most one track
+     * per kind should be flagged — if multiple are passed, the first
+     * one wins.
+     */
+    default?: boolean;
+}
+/**
+ * A single `<source>` entry when the consumer passes multiple media
+ * URLs (typically one `mp4` + one `webm` so the browser picks whichever
+ * codec it can decode).
+ */
+export interface IVideoSource {
+    /** Absolute or root-relative URL to the media file. */
+    src: string;
+    /**
+     * MIME type — `"video/mp4"`, `"video/webm"`, `"application/vnd.apple.mpegurl"`
+     * for HLS, etc. Optional but recommended: it lets the browser skip
+     * sources it can't decode without a network round-trip.
+     */
+    type?: string;
+    /**
+     * Quality identifier used to group multiple sources of the same
+     * content at different resolutions / bitrates (e.g. `"1080p"`,
+     * `"720p"`, `"480p"`, `"4K"`, `"auto"`).
+     *
+     * When ≥ 2 sources expose distinct `quality` values, OrigamVideo
+     * shows a "Quality" entry in the settings (cog) menu and lets the
+     * user swap between them. The currently-playing source is then
+     * matched on `quality` rather than on codec.
+     */
+    quality?: string;
+    /**
+     * Optional human-readable label override for the quality switcher
+     * menu. Defaults to the `quality` value when not provided. Use
+     * this for cases like `quality: "auto"` rendered as `"Auto (720p)"`.
+     */
+    label?: string;
+}

package/dist/src/interfaces/Video/video.interface.cjs

@@ -0,0 +1 @@
+"use strict";