origam 2.2.1 → 2.5.0

package/dist/src/interfaces/Parallax/parallax-layer.interface.cjs

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

package/dist/src/interfaces/Parallax/parallax-layer.interface.d.ts

@@ -0,0 +1,39 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+export interface IParallaxLayerProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * Parallax speed multiplier for this layer.
+     *  - `0`   → fixed (no movement, sticks to host)
+     *  - `0.5` → half the scroll speed (background — far)
+     *  - `1`   → moves with the scroll (neutral)
+     *  - `>1`  → faster than the scroll (foreground — near)
+     *
+     * Negative values reverse the direction.
+     */
+    speed?: number;
+    /**
+     * Static X-axis offset (px) applied on top of the parallax translation.
+     * Useful to nudge a layer without changing its speed.
+     */
+    offsetX?: number;
+    /**
+     * Static Y-axis offset (px) applied on top of the parallax translation.
+     */
+    offsetY?: number;
+    /**
+     * Optional `z-index` override. By default layers stack in document order.
+     */
+    zIndex?: number;
+}
+export interface IParallaxLayerRegistry {
+    /**
+     * Internal layer descriptor as registered into the parent OrigamParallax
+     * via `provide` / `inject`. The parent reads `speed`, `offsetX`,
+     * `offsetY` to compute the per-frame transform, then applies it via the
+     * shared `target` HTMLElement.
+     */
+    id: symbol;
+    speed: number;
+    offsetX: number;
+    offsetY: number;
+    target: HTMLElement;
+}

package/dist/src/interfaces/Parallax/parallax.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IAudioProps, IBorderProps, IBox, IBgColorProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TParallaxEvent, TPoint } from '../../types';
+import type { IAudioProps, IBorderProps, IBox, IBgColorProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, IParallaxLayerRegistry } from '../../interfaces';
+import type { TParallaxDirection, TParallaxEasing, TParallaxEvent, TPoint } from '../../types';
 import type { Ref } from 'vue';
 export interface IParallaxProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IDimensionProps, IAudioProps {
     /**
@@ -10,11 +10,49 @@ export interface IParallaxProps extends ICommonsComponentProps, ITagProps, IColo
      * console warning is emitted at runtime to flag the migration.
      */
     animationDuration?: number;
-    easing?: string;
+    /**
+     * Easing curve. Accepts either:
+     *  - a TParallaxEasing keyword (`'linear' | 'ease-out' | 'spring'`),
+     *    routed through the scroll-driven multi-layer code path,
+     *  - or any raw CSS timing-function string (legacy mouse / scroll
+     *    transition path, e.g. `'cubic-bezier(...)'`).
+     *
+     * The keyword form is preferred for new code; the raw string form is
+     * kept for backwards compatibility with v2.x.
+     */
+    easing?: TParallaxEasing | string;
     perspective?: number;
     event?: TParallaxEvent;
     active?: boolean;
     duration?: number;
+    /**
+     * Direction of the parallax effect.
+     *  - `'vertical'` (default) → translateY based on vertical scroll progress.
+     *  - `'horizontal'`         → translateX based on vertical scroll progress.
+     *  - `'both'`               → translate on both axes; on `event="move"`
+     *                            this maps to a 2D mouse ratio.
+     */
+    direction?: TParallaxDirection;
+    /**
+     * Global parallax speed multiplier when no `<OrigamParallaxLayer>` is
+     * provided (single-layer mode). Equivalent to wrapping the slot in a
+     * single layer with this speed. Default `0.5`.
+     */
+    speed?: number;
+    /**
+     * Force the parallax effect OFF (translate stays at 0 regardless of
+     * scroll / events). Distinct from `active` which only freezes the
+     * mouse-driven mode. Useful for SSR, snapshot tests, or `prefers-
+     * reduced-motion` integrations.
+     */
+    disabled?: boolean;
+    /**
+     * Proportion (0 → 1) of the host that must enter the viewport before
+     * the parallax effect activates. `0` (default) starts the effect the
+     * moment the host's top edge crosses the bottom of the viewport;
+     * `0.3` waits until 30% of the host is visible.
+     */
+    threshold?: number;
 }
 export interface IParallaxProvide {
     audioData: Ref<any>;
@@ -30,3 +68,45 @@ export interface IParallaxProvide {
     easing: Ref<string>;
     shape: Ref<IBox | null>;
 }
+/**
+ * Provide context exposed by the enriched OrigamParallax to its
+ * `<OrigamParallaxLayer>` children. Distinct from the legacy
+ * `IParallaxProvide` consumed by `<OrigamParallaxElement>` (kept
+ * separate to avoid coupling the two APIs).
+ */
+export interface IParallaxLayerProvide {
+    direction: Ref<TParallaxDirection>;
+    easing: Ref<TParallaxEasing | string>;
+    disabled: Ref<boolean>;
+    /**
+     * Live scroll progress, normalised to `[0, 1]`. `0` = host just entered
+     * the viewport, `1` = host just left.
+     */
+    progress: Ref<number>;
+    /**
+     * Live mouse-ratio for `direction="both"` on `event="move"` —
+     * `{ x: 0..1, y: 0..1 }`. Falls back to `{ x: 0.5, y: 0.5 }` when no
+     * mouse data is available.
+     */
+    mouseRatio: Ref<{
+        x: number;
+        y: number;
+    }>;
+    /**
+     * Whether the runtime is using the CSS scroll-driven path (true) or the
+     * JS rAF fallback (false). Layers may opt out of the JS work when the
+     * CSS path is active.
+     */
+    cssScrollDriven: Ref<boolean>;
+    /**
+     * Whether `prefers-reduced-motion: reduce` is honoured — layers MUST
+     * stay at offset 0 when this is true.
+     */
+    reducedMotion: Ref<boolean>;
+    /**
+     * Register / unregister a layer with the parent. The parent reads the
+     * registry to compute and apply per-layer transforms each frame.
+     */
+    register: (layer: IParallaxLayerRegistry) => void;
+    unregister: (id: symbol) => void;
+}

package/dist/src/interfaces/PasswordField/password-field.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IAdjacentInnerProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldEmits, IFieldSlots, IInputEmits, IInputSlots, IMenuProps, IPasswordRequirement, IRoundedProps, ITextFieldProps } from '../../interfaces';
+import type { IFieldEmits, IFieldSlots, IInputEmits, IInputSlots, IMenuProps, IPasswordRequirement, ITextFieldProps } from '../../interfaces';
 import type { TIcon, TPasswordStrengthLevel } from '../../types';
 /**
  * Props for `<OrigamPasswordField>` — a TextField specialised for password
@@ -14,7 +14,7 @@ import type { TIcon, TPasswordStrengthLevel } from '../../types';
  * Extends `ITextFieldProps` so anything you can pass to TextField
  * (counter, placeholder, persistentPlaceholder, etc.) flows through.
  */
-export interface IPasswordFieldProps extends ICommonsComponentProps, IColorProps, IDensityProps, ITextFieldProps, IRoundedProps, IElevationProps, IAdjacentInnerProps {
+export interface IPasswordFieldProps extends ITextFieldProps {
     /** Icon shown when the password is HIDDEN (toggle reveals). */
     onIcon?: TIcon;
     /** Icon shown when the password is VISIBLE (toggle hides). */

package/dist/src/interfaces/Picker/picker.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IPickerTitleProps, IRoundedProps, ISheetProps } from "../../interfaces";
-export interface IPickerProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISheetProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, IRoundedProps, IPickerTitleProps {
+import type { IBgColorProps, IPickerTitleProps, ISheetProps } from "../../interfaces";
+export interface IPickerProps extends ISheetProps, IBgColorProps, IPickerTitleProps {
     landscape?: boolean;
     hideHeader?: boolean;
 }

package/dist/src/interfaces/QrCode/qr-code-logo.interface.cjs

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

package/dist/src/interfaces/QrCode/qr-code-logo.interface.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Optional logo overlay rendered at the centre of an OrigamQrCode.
+ *
+ * The overlay is painted **on top** of the QR matrix — any module
+ * underneath becomes unreadable. Error-correction takes care of the
+ * loss as long as the overlay stays small enough:
+ *
+ *   - L  →  do not use a logo (≤7% redundancy budget).
+ *   - M  →  ≤10% of QR width.
+ *   - Q  →  ≤20% of QR width.
+ *   - H  →  ≤25–30% of QR width.
+ *
+ * `<OrigamQrCode>` does **not** enforce these caps — the consumer
+ * decides what's acceptable. We warn (`console.warn`) when `size` is
+ * configured above 0.3 because no error-correction level survives that.
+ */
+export interface IQrCodeLogo {
+    /**
+     * Logo source. Any URL accepted by `<image href>` works — SVG, PNG,
+     * data-URI, …. The SVG fragment loads the asset asynchronously; if
+     * it fails the QR remains valid (only the overlay disappears).
+     */
+    src: string;
+    /**
+     * Logo width as a proportion of the QR width (0..1).
+     *
+     * @default 0.2
+     */
+    size?: number;
+    /**
+     * Pixel padding of the (opaque) backdrop drawn around the logo.
+     * Keeps the modules immediately adjacent to the logo readable —
+     * without padding, the scanner sees a soft-edged blob and fails.
+     *
+     * @default 6
+     */
+    padding?: number;
+    /**
+     * Backdrop colour painted under the logo (and within the padding
+     * box). Defaults to the QR background; pass a different value to
+     * paint a coloured halo (e.g. brand colour for a logotype that
+     * already includes its own white box).
+     *
+     * @default — falls back to the QR `background` prop.
+     */
+    background?: string;
+}

package/dist/src/interfaces/QrCode/qr-code.interface.cjs

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

package/dist/src/interfaces/QrCode/qr-code.interface.d.ts

@@ -0,0 +1,152 @@
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ISrcObject, ITagProps } from '../../interfaces';
+import type { TIcon, TQrCodeErrorCorrectionLevel } from '../../types';
+/**
+ * Per-matrix overrides — applied INSIDE the SVG (modules + quiet
+ * zone) independently of the wrapper-level same-name props. Pass via
+ * the `qrCodeProps` slot on `<OrigamQrCode>`:
+ *
+ *   - `qrCodeProps.color`   → modules colour (overrides the wrapper
+ *                             `color` for the matrix paint only).
+ *   - `qrCodeProps.bgColor` → fill of the SVG's quiet-zone rect.
+ *   - `qrCodeProps.rounded` → per-module corner radius (mapped to
+ *                             [0, 0.5] module units via
+ *                             `resolveQrCornerRadius`).
+ *
+ * The DS-shape values (intents, hex, `currentColor`, named rungs)
+ * are transformed by `resolveQrColor` / `resolveQrCornerRadius` in
+ * `src/utils/QrCode/qr-code-adapters.util.ts` — consumers always pass
+ * canonical DS values, the component handles the SVG-side translation.
+ */
+export interface IQrCodeOptions extends IRoundedProps, IBgColorProps, IColorProps {
+}
+/**
+ * Props for `<OrigamQrCode>` — SVG QR code renderer.
+ *
+ * The component owns no state: every prop change rebuilds the
+ * underlying matrix through `qrcode-generator` and re-emits the SVG.
+ * The renderer is SSR-safe — no `window` / `document` / `canvas` API
+ * is touched.
+ *
+ * DS transverse props (all applied to the WRAPPER element, the
+ * standard chrome you get on every Origam component):
+ *
+ *   - `color`     (`IColorProps`)     — wrapper `color:` (text colour).
+ *                                       The SVG modules inherit this via
+ *                                       `fill="currentColor"` unless
+ *                                       `qrCodeProps.color` overrides.
+ *   - `bgColor`   (`IBgColorProps`)   — wrapper `background-color:`.
+ *   - `rounded`   (`IRoundedProps`)   — wrapper `border-radius`.
+ *   - `border`    (`IBorderProps`)    — wrapper `border`.
+ *   - `size`      (`ISizeProps`)      — wrapper width/height.
+ *   - `padding`   (`IPaddingProps`)   — wrapper inner spacing.
+ *   - `margin`    (`IMarginProps`)    — wrapper outer spacing.
+ *   - `elevation` (`IElevationProps`) — wrapper `box-shadow`.
+ *
+ * QR-internal props (apply to the SVG itself, NOT the wrapper):
+ *
+ *   - `qrCodeProps.color` / `.bgColor` / `.rounded` — see
+ *     `IQrCodeOptions` above for the full mapping.
+ */
+export interface IQrCodeProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IRoundedProps, IBorderProps, IElevationProps, ISizeProps, IPaddingProps, IMarginProps {
+    /**
+     * Text or URL encoded into the QR matrix. UTF-8 is supported via
+     * the underlying `qrcode-generator` Byte mode.
+     */
+    value: string;
+    /**
+     * Optional heading rendered above the QR matrix inside the
+     * wrapper. Useful when the QR is presented alongside meta
+     * (campaign name, recipient, …) — no manual extra markup needed.
+     */
+    title?: string;
+    /**
+     * Per-matrix overrides — see `IQrCodeOptions`. When omitted, the
+     * SVG inherits the wrapper-level `color` / `bgColor` / and
+     * defaults to square modules.
+     */
+    qrCodeProps?: IQrCodeOptions;
+    /**
+     * Reed-Solomon redundancy level. Higher levels reserve more matrix
+     * cells for correction codewords (and therefore tolerate more
+     * damage / overlay). See `TQrCodeErrorCorrectionLevel` for the
+     * tradeoff matrix.
+     *
+     * @default 'M'
+     */
+    errorCorrectionLevel?: TQrCodeErrorCorrectionLevel;
+    /**
+     * Number of modules reserved as quiet-zone padding around the
+     * matrix. The ISO spec mandates ≥4 — anything smaller risks
+     * scanner failures, anything larger is purely aesthetic.
+     *
+     * @default 4
+     */
+    quietZone?: number;
+    /**
+     * Optional centred icon overlay — rendered via `<OrigamIcon>` on
+     * top of the matrix. Coexists with `image`; the `#center` slot
+     * overrides both when provided.
+     */
+    icon?: TIcon;
+    /**
+     * Optional centred image overlay. Accepts a raw URL (string) or
+     * the standard `ISrcObject` shape (src / srcset / lazySrc /
+     * aspectRatio / alt). Rendered as an `<OrigamAvatar>` overlay.
+     */
+    image?: string | ISrcObject;
+    /**
+     * Accessible label used as `aria-label`. When omitted, the
+     * component falls back to `"QR code for {value}"`.
+     */
+    ariaLabel?: string;
+}
+/**
+ * Options accepted by `useQrCode`. Lower-level than `IQrCodeProps`:
+ * the composable does not speak the canonical DS contracts. It only
+ * owns the raw SVG string — the wrapper component is responsible for
+ * mapping `color` / `bgColor` / `rounded` (wrapper or qrCodeProps)
+ * down to the primitive `foreground` / `background` / `cornerRadius`
+ * keys here.
+ */
+export interface IUseQrCodeOptions {
+    /** Reed-Solomon level — same semantics as `IQrCodeProps`. */
+    errorCorrectionLevel?: TQrCodeErrorCorrectionLevel;
+    /** Raw CSS colour painted on dark modules. */
+    foreground?: string;
+    /** Raw CSS colour painted behind the matrix (quiet zone). */
+    background?: string;
+    /** Quiet-zone padding in module units. */
+    margin?: number;
+    /**
+     * Per-module corner radius in module units (0 → square,
+     * 0.5 → circle). The component layer derives this from the
+     * public `qrCodeProps.rounded` prop via `resolveQrCornerRadius`.
+     */
+    cornerRadius?: number;
+    /**
+     * Optional logo overlay rendered inside the SVG via `<image>`.
+     * Public consumers should use the `image` prop on
+     * `<OrigamQrCode>`; this lower-level shape stays here for direct
+     * `useQrCode` consumers.
+     */
+    logo?: {
+        src: string;
+        size?: number;
+        padding?: number;
+        background?: string;
+    };
+}
+/**
+ * Slot signatures for `<OrigamQrCode>`.
+ *
+ * - `center` — replaces the default `icon` / `image` overlay.
+ *   Receives the resolved size of the central reserved square (in
+ *   matrix module units) so the consumer can paint a custom SVG /
+ *   icon without re-deriving the geometry. When this slot is
+ *   provided, both `icon` and `image` props are ignored.
+ */
+export interface IQrCodeSlots {
+    center?: (bindings: {
+        size: number;
+    }) => any;
+}

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,4 +1,4 @@
-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;
@@ -17,3 +17,9 @@ export interface IRatingFieldItemProps extends ICommonsComponentProps, ITagProps
     checked?: boolean;
     length?: number;
 }
+/** 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/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";