origam 2.3.0 → 2.6.1

package/dist/src/interfaces/Radio/radio-btn.interface.d.ts

@@ -1,3 +1,6 @@
-import type { ICommonsComponentProps, ISelectionControlProps } from '../../interfaces';
+import type { IClickLabelEmits, ICommonsComponentEmits, ICommonsComponentProps, IFocusEmits, ISelectionControlProps } from '../../interfaces';
 export interface IRadioBtnProps extends ICommonsComponentProps, ISelectionControlProps {
 }
+/** Emits fired by `<OrigamRadioBtn>` — same surface as `<OrigamRadio>`. */
+export interface IRadioBtnEmits extends ICommonsComponentEmits, IFocusEmits, IClickLabelEmits {
+}

package/dist/src/interfaces/Radio/radio.interface.d.ts

@@ -1,3 +1,6 @@
-import type { IActiveProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, IInputProps, IMarginProps, IPaddingProps, IRadioBtnProps, IRoundedProps } from '../../interfaces';
+import type { IActiveProps, IBorderProps, IClickLabelEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IHoverProps, IInputProps, IMarginProps, IPaddingProps, IRadioBtnProps, IRoundedProps } from '../../interfaces';
 export interface IRadioProps extends ICommonsComponentProps, IInputProps, IRadioBtnProps, IDensityProps, IPaddingProps, IMarginProps, IRoundedProps, IColorProps, IBorderProps, IElevationProps, IActiveProps, IHoverProps {
 }
+/** Emits fired by `<OrigamRadio>` — v-model + focus + label click. */
+export interface IRadioEmits extends ICommonsComponentEmits, IFocusEmits, IClickLabelEmits {
+}

package/dist/src/interfaces/RatingField/rating-field-item.interface.d.ts

@@ -1,10 +1,11 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
+import type { IBorderProps, IClickEmits, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface IRatingFieldItemProps extends ICommonsComponentProps, ITagProps, IColorProps, IDensityProps, IRippleProps, ISizeProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, IElevationProps {
     name?: string;
     index?: number;
     value: number;
     label?: string;
+    itemAriaLabel?: string;
     showStar?: boolean;
     isFilled?: boolean;
     isHovered?: boolean;
@@ -15,5 +16,11 @@ export interface IRatingFieldItemProps extends ICommonsComponentProps, ITagProps
     emptyIcon?: TIcon;
     halfIncrements?: boolean;
     checked?: boolean;
-    length?: number;
+    length?: number | string;
+}
+/** Emits fired by `<OrigamRatingFieldItem>` — click + hover surface
+ *  (pointer enter / leave drive the half-rating preview). */
+export interface IRatingFieldItemEmits extends IClickEmits {
+    (e: 'mouseenter', event: MouseEvent): void;
+    (e: 'mouseleave', event: MouseEvent): void;
 }

package/dist/src/interfaces/RatingField/rating-field.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IInputProps, ILabelProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentEmits, IInputProps, ILabelProps, IRippleProps, ITagProps } from '../../interfaces';
 import type { TBlock, TIcon } from '../../types';
-export interface IRatingFieldProps extends ICommonsComponentProps, IRippleProps, IDensityProps, IPaddingProps, IBorderProps, IMarginProps, IRoundedProps, IElevationProps, IColorProps, ISizeProps, ITagProps, IInputProps, ILabelProps {
+export interface IRatingFieldProps extends IInputProps, IRippleProps, ITagProps, ILabelProps {
     name?: string;
     itemAriaLabel?: string;
     clearable?: boolean;
@@ -15,3 +15,6 @@ export interface IRatingFieldProps extends ICommonsComponentProps, IRippleProps,
     itemLabels?: Array<string>;
     itemLabelPosition?: TBlock;
 }
+/** Emits fired by `<OrigamRatingField>` — v-model on the rating value. */
+export interface IRatingFieldEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/Select/select.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IAdjacentInnerProps, IAdjacentProps, IBorderProps, IChipProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldProps, IFiltersProps, IInputProps, IItemProps, ILazyProps, IListProps, IMarginProps, IMenuProps, IPaddingProps, IRoundedProps, ITextFieldProps, ITransitionComponentProps } from '../../interfaces';
+import type { IAdjacentEmits, IAdjacentInnerEmits, IAdjacentInnerProps, IAdjacentProps, IBorderProps, IChipProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldProps, IFiltersProps, IFocusEmits, IInputProps, IItemProps, ILazyProps, IListProps, IMarginProps, IMenuProps, IPaddingProps, IRoundedProps, ITextFieldProps, ITransitionComponentProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface ISelectProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ITextFieldProps, IDensityProps, IAdjacentProps, IAdjacentInnerProps, IFieldProps, IInputProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IItemProps, ITransitionComponentProps, IFiltersProps, ILazyProps {
     chips?: boolean;
@@ -21,3 +21,11 @@ export interface ISelectProps extends ICommonsComponentProps, IColorProps, IBgCo
     closeText?: string;
     openText?: string;
 }
+/** Emits fired by `<OrigamSelect>` — v-model + focus + menu open/close +
+ *  click handlers on the control surface and the adjacent slots
+ *  (prepend / append / prependInner / appendInner / clear). */
+export interface ISelectEmits extends ICommonsComponentEmits, IFocusEmits, IAdjacentEmits, IAdjacentInnerEmits {
+    (e: 'click:control', event: MouseEvent): void;
+    (e: 'mousedown:control', event: MouseEvent): void;
+    (e: 'update:menu', value: boolean): void;
+}

package/dist/src/interfaces/SelectionControl/selection-control-group.interface.d.ts

@@ -3,7 +3,8 @@ import type { TIcon } from '../../types';
 import { Ref } from 'vue';
 export interface ISelectionControlGroupProps extends ICommonsComponentProps, IColorProps, IDensityProps, IRippleProps {
     disabled?: boolean;
-    error?: boolean;
+    /** Error state. Accepts `boolean` or a `string` error message (same contract as `IValidationProps`). */
+    error?: string | boolean;
     inline?: boolean;
     falseIcon?: TIcon;
     trueIcon?: TIcon;

package/dist/src/interfaces/SelectionControl/selection-control.interface.d.ts

@@ -1,17 +1,35 @@
-import type { IActiveProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, ISelectionControlGroupProps, IHoverProps } from '../../interfaces';
-import type { TIcon } from '../../types';
-export interface ISelectionControlProps extends ICommonsComponentProps, Partial<Omit<ISelectionControlGroupProps, 'items'>>, IColorProps, IBgColorProps, IActiveProps, IHoverProps {
+import type { IActiveProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, ISelectionControlGroupProps, IHoverProps } from '../../interfaces';
+import type { TColor, TIcon } from '../../types';
+export interface ISelectionControlProps extends ICommonsComponentProps, Partial<Omit<ISelectionControlGroupProps, 'items'>>, IColorProps, IBgColorProps, IActiveProps, IHoverProps, IDensityProps {
     label?: string;
     trueValue?: any;
     falseValue?: any;
     value?: any;
     required?: boolean;
+    /** @deprecated Use the `active` object prop instead. Kept for back-compat. */
+    activeColor?: TColor;
+    /** @deprecated Use the `active` object prop instead. Kept for back-compat. */
+    activeBgColor?: TColor;
 }
 export interface ISelectionControlEmits extends ICommonsComponentEmits {
     (e: 'click:label', event: MouseEvent): void;
 }
 export interface ISelectionControlSlots {
-    default?: (model: any, icon: TIcon, props: any) => any;
+    default?: (data: {
+        model: any;
+        color?: TColor;
+        bgColor?: TColor;
+        icon?: TIcon;
+        props: any;
+    }) => any;
     label?: () => any;
-    input?: (props: any, icon: TIcon, model: any) => any;
+    input?: (data: {
+        model: any;
+        color?: TColor;
+        bgColor?: TColor;
+        icon?: TIcon;
+        props: any;
+        textColorStyles?: any;
+        backgroundColorStyles?: any;
+    }) => any;
 }

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

@@ -1,6 +1,6 @@
-import type { IActiveProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IHoverProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IHoverProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TDirectionBoth, TSheetSnapId, TSheetSnapPoint } from '../../types';
-export interface ISheetProps extends ITagProps, ICommonsComponentProps, IPaddingProps, IMarginProps, IColorProps, IBorderProps, IRoundedProps, IElevationProps, IDimensionProps, ILocationProps, IPositionProps, IActiveProps, IHoverProps {
+export interface ISheetProps extends ITagProps, ICommonsComponentProps, IPaddingProps, IMarginProps, IColorProps, IBgColorProps, IBorderProps, IRoundedProps, IElevationProps, IDimensionProps, ILocationProps, IPositionProps, IActiveProps, IHoverProps {
     /**
      * Edge the sheet is anchored to. Drives the bottom-swipe gesture
      * (only `'bottom'` activates the touch-drag handle today; the other

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

@@ -1,4 +1,4 @@
-import type { IBorderProps, ICommonsComponentProps, IDirectionProps, IDisplayProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IBorderProps, ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IDisplayProps, IGroupProps, 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;
@@ -6,3 +6,6 @@ export interface ISlideGroupProps extends ICommonsComponentProps, ITagProps, IDi
     prevIcon?: TIcon;
     showArrows?: boolean | string;
 }
+/** Emits fired by `<OrigamSlideGroup>` — v-model on the active slide. */
+export interface ISlideGroupEmits extends ICommonsComponentEmits {
+}

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, ITypographyProps } 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, ITypographyProps {
+    /**
+     * 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/SystemBar/system-bar.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, ILayoutItemProps, IRoundedProps, ITagProps } from "../../interfaces";
-export interface ISystemBarProps extends ICommonsComponentProps, ITagProps, IElevationProps, IColorProps, IBgColorProps, ILayoutItemProps, IRoundedProps, IBorderProps, IDimensionProps {
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, ILayoutItemProps, IRoundedProps, ITagProps, ITypographyProps } from "../../interfaces";
+export interface ISystemBarProps extends ICommonsComponentProps, ITagProps, IElevationProps, IColorProps, IBgColorProps, ILayoutItemProps, IRoundedProps, IBorderProps, IDimensionProps, ITypographyProps {
     window?: boolean;
 }

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

@@ -1,5 +1,8 @@
-import type { IBorderProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface ITableProps extends ICommonsComponentProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IHoverProps, IDimensionProps, IDensityProps, ITagProps {
+import type { IBorderProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
+export interface ITableProps extends ICommonsComponentProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IHoverProps, IDimensionProps, IDensityProps, ITagProps, ITypographyProps {
     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/tab.interface.d.ts

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps, IGroupItemProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentProps, IGroupItemProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 /**
  * Props for `<OrigamTab>` — a single registered tab inside an
@@ -10,8 +10,13 @@ import type { TIcon } from '../../types';
  * ARIA wiring (`role="tab"`, `aria-selected`, `aria-controls`, `id`,
  * `tabindex`) is computed inside the component — consumers only
  * provide `value` (the canonical identifier) and `disabled`.
+ *
+ * Typography props (`fontSize`, `fontWeight`, `letterSpacing`) override
+ * the matching `--origam-tabs__item---*` variables on the tab element.
+ * `lineHeight` is intentionally excluded — the SCSS hard-codes `line-height: 1`
+ * with no CSS-var hook.
  */
-export interface ITabProps extends ICommonsComponentProps, ITagProps, IGroupItemProps {
+export interface ITabProps extends ICommonsComponentProps, ITagProps, IGroupItemProps, ITypographyProps {
     tag?: string;
     icon?: TIcon;
     appendIcon?: TIcon;

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 {
+}