origam 2.2.1 → 2.5.0

package/dist/src/interfaces/Chip/chip-group.interface.d.ts

@@ -1,6 +1,9 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ISlideGroupProps, ITagProps } from '../../interfaces';
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ISlideGroupProps, ITagProps } from '../../interfaces';
 export interface IChipGroupProps extends ICommonsComponentProps, ITagProps, IGroupProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IBorderProps, IRoundedProps, ISlideGroupProps {
     column?: boolean;
     filter?: boolean;
     valueComparator?: (a: any, b: any) => boolean;
 }
+/** Emits fired by `<OrigamChipGroup>` — v-model on the active chip set. */
+export interface IChipGroupEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/Chip/chip.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IGroupItemProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IClickCloseEmits, IClickEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IGroupEmits, IGroupItemProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface IChipProps extends ICommonsComponentProps, IAdjacentProps, ITagProps, IColorProps, IBgColorProps, IRippleProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IGroupItemProps, ILinkProps, ISizeProps, IElevationProps, IActiveProps, IHoverProps {
     closable?: boolean;
@@ -13,3 +13,7 @@ export interface IChipProps extends ICommonsComponentProps, IAdjacentProps, ITag
     text?: string;
     modelValue?: boolean;
 }
+/** Emits fired by `<OrigamChip>` — generic click, close button, group
+ *  membership, prepend/append icons, and v-model on dismissal. */
+export interface IChipEmits extends ICommonsComponentEmits, IClickEmits, IClickCloseEmits, IAdjacentEmits, IGroupEmits {
+}

package/dist/src/interfaces/Clipboard/clipboard.interface.cjs

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

package/dist/src/interfaces/Clipboard/clipboard.interface.d.ts

@@ -0,0 +1,106 @@
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+/**
+ * Props for `<OrigamClipboard>` — copy-to-clipboard wrapper.
+ *
+ * The component is intentionally chrome-less: it owns the copy
+ * pipeline (`navigator.clipboard.writeText` + `execCommand` fallback)
+ * and the auto-resetting `copied` flag, but it does NOT impose any
+ * visual on the trigger. The built-in trigger (rendered when no slot
+ * is provided) is a single button whose label flips to `feedbackText`
+ * while `copied` is true — that's the only feedback surface the
+ * component owns. Consumers needing a different feedback shape (toast,
+ * inline pill, animation, …) pass a `#default` scoped slot exposing
+ * `{ copy, copied, error }` and render whatever they want.
+ */
+export interface IClipboardProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IBorderProps, IRoundedProps, IMarginProps, IPaddingProps {
+    /**
+     * Text payload written to the clipboard on `copy()`. Required.
+     * Re-read each time the trigger fires, so a parent that mutates
+     * the value between mounts still copies the up-to-date string.
+     */
+    value: string;
+    /**
+     * Duration (ms) the `copied` flag stays true after a successful
+     * write. The state auto-resets after this window — there is no
+     * need to clear it from the consumer side.
+     *
+     * @default 2000
+     */
+    feedbackDuration?: number;
+    /**
+     * Label rendered inside the built-in feedback overlay (and the
+     * auto-rendered button label when no slot is provided). Consumers
+     * wrap with `t()` if they need full i18n.
+     *
+     * @default 'Copied!'
+     */
+    feedbackText?: string;
+    /**
+     * Alias for `feedbackText`. Takes precedence when both are passed.
+     * Provided for callers who prefer the "success" framing in their
+     * codebase.
+     */
+    successText?: string;
+    /**
+     * Disables the copy action. The default trigger becomes
+     * non-interactive (`disabled` attribute) and `copy()` becomes a
+     * no-op. The scoped slot still receives the `copy` function so
+     * consumers can decide what to render — but it will short-circuit.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+}
+/**
+ * Emits for `<OrigamClipboard>`.
+ */
+export interface IClipboardEmits {
+    /** Fired after a successful write. Carries the payload string. */
+    (e: 'copy', value: string): void;
+    /** Fired after a failed write (clipboard API denied, no permission, …). */
+    (e: 'error', err: Error): void;
+}
+/**
+ * Bindings exposed via the `#default` scoped slot. Consumers use these
+ * to wire any trigger — button, icon, span, custom widget — to the
+ * copy pipeline without re-implementing the timing logic.
+ */
+export interface IClipboardScopedSlotBindings {
+    /** Triggers the copy pipeline. Promise resolves true on success. */
+    copy: () => Promise<boolean>;
+    /** True for `feedbackDuration` ms after a successful copy. */
+    copied: boolean;
+    /** Set when the last copy attempt threw, null otherwise. */
+    error: Error | null;
+}
+/**
+ * Slot signatures for `<OrigamClipboard>`.
+ */
+export interface IClipboardSlots {
+    /**
+     * Custom trigger. Scoped — receives `{ copy, copied, error }`.
+     * When omitted, the component renders a default icon button with
+     * `mdi:mdi-content-copy`.
+     */
+    default?: (bindings: IClipboardScopedSlotBindings) => any;
+    /**
+     * Custom feedback marker rendered when `showFeedback` is true and
+     * `copied` is true. Scoped — receives the boolean for symmetry
+     * with the default slot.
+     */
+    feedback?: (bindings: {
+        copied: boolean;
+    }) => any;
+}
+/**
+ * Options for the `useClipboard` composable.
+ */
+export interface IUseClipboardOptions {
+    /**
+     * Duration (ms) the returned `copied` ref stays true after a
+     * successful write before auto-resetting.
+     *
+     * @default 2000
+     */
+    feedbackDuration?: number;
+}

package/dist/src/interfaces/Code/code.interface.cjs

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

package/dist/src/interfaces/Code/code.interface.d.ts

@@ -0,0 +1,89 @@
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../index';
+import type { TCodeLang } from '../../types';
+/**
+ * Props for `<OrigamCode>` — a shiki-powered code block with line numbers,
+ * line highlighting, copy button and theme awareness.
+ *
+ * Backward-compat note: the v2.x `<OrigamCode>` was a thin `<pre>` wrapper
+ * with a `code` prop only. Every new prop below is optional with a
+ * conservative default so existing call sites keep their behaviour
+ * (plain-text, no line numbers, copy button visible).
+ */
+export interface ICodeProps extends ICommonsComponentProps, ITagProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IDimensionProps, IColorProps, IBgColorProps {
+    /**
+     * The code to highlight. When omitted, the default slot is used as the
+     * source — useful for multi-line snippets that are nicer to read in
+     * the template than as a JS string literal. When both are provided,
+     * the prop wins.
+     */
+    code?: string;
+    /**
+     * Language grammar to apply. One of the values in `SUPPORTED_LANGS`.
+     * Unknown values fall back to `plaintext` (with a one-shot console
+     * warning).
+     */
+    lang?: TCodeLang;
+    /**
+     * Show a left gutter with line numbers. Pure CSS — uses a CSS counter
+     * incremented per `.origam-code__row`, no JS layout work.
+     */
+    lineNumbers?: boolean;
+    /**
+     * Lines to highlight. Accepts either a pre-computed array of 1-based
+     * line numbers (`[2, 5, 6, 7]`) or a comma/range string (`'2,5-7'`)
+     * that the component parses via `parseHighlightLines()`. `null` /
+     * empty disables the feature.
+     */
+    highlightLines?: number[] | string | null;
+    /**
+     * Show the copy-to-clipboard button in the top-right corner. Defaults
+     * to `true` — most code blocks benefit from it.
+     */
+    copyable?: boolean;
+    /**
+     * Auto-format the code before highlighting. Reserved for v3 — prettier
+     * is intentionally NOT bundled at runtime to keep the tarball small.
+     * Currently a no-op; passing `true` warns once in dev and pre-formats
+     * via a best-effort whitespace trim only.
+     */
+    format?: boolean;
+    /**
+     * Wrap long lines instead of scrolling horizontally. Off by default so
+     * the visual column matches the source file.
+     */
+    wrap?: boolean;
+    /**
+     * Optional filename rendered in the header bar (e.g. `'App.vue'`).
+     * When provided AND `copyable` is true, the header also hosts the copy
+     * button; otherwise the copy button is absolutely positioned in the
+     * top-right corner of the code surface.
+     */
+    filename?: string;
+}
+/**
+ * Public surface of the `useCode` composable. Lazily instantiates a shiki
+ * highlighter on first call and reuses it across every `OrigamCode`
+ * instance for the lifetime of the page.
+ */
+export interface IUseCodeReturn {
+    /**
+     * Render `code` to a pre-tokenised HTML string. Resolves once the
+     * underlying shiki highlighter has loaded the requested language /
+     * theme (lazy; ~200 ms cold, instant on subsequent calls).
+     */
+    highlight(code: string, lang: TCodeLang): Promise<string>;
+    /**
+     * Force the highlighter to load. Useful for stories / tests that want
+     * to warm the cache before mounting consumers.
+     */
+    prime(): Promise<void>;
+    /**
+     * Whether the singleton highlighter is ready. `false` on first paint,
+     * flips to `true` once the dynamic import finishes.
+     */
+    isReady(): boolean;
+    /**
+     * Wipe the LRU cache. Test-only — production code never needs this.
+     */
+    resetCacheForTesting(): void;
+}

package/dist/src/interfaces/ColorPicker/color-picker-canvas.interface.d.ts

@@ -1,7 +1,11 @@
-import type { ICommonsComponentProps, IDimensionProps } from "../../interfaces";
+import type { IColorHsvEmits, ICommonsComponentProps, IDimensionProps } from "../../interfaces";
 import type { THSVA } from "../../types";
 export interface IColorPickerCanvasProps extends ICommonsComponentProps, IDimensionProps {
     colorHsv?: THSVA | null;
     disabled?: boolean;
     dotSize?: string | number;
+    ariaLabel?: string;
+}
+/** Emits fired by `<OrigamColorPickerCanvas>` — drag/click updates the HSVA. */
+export interface IColorPickerCanvasEmits extends IColorHsvEmits {
 }

package/dist/src/interfaces/ColorPicker/color-picker-edit.interface.d.ts

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps } from "../../interfaces";
+import type { IColorHsvEmits, IColorModeEmits, ICommonsComponentProps } from "../../interfaces";
 import type { TColorModes, THSVA } from "../../types";
 export interface IColorPickerEditProps extends ICommonsComponentProps {
     colorHsv?: THSVA | null;
@@ -6,3 +6,7 @@ export interface IColorPickerEditProps extends ICommonsComponentProps {
     mode?: TColorModes;
     modes?: Array<TColorModes>;
 }
+/** Emits fired by `<OrigamColorPickerEdit>` — input edits the HSVA and
+ *  flips between the active mode. */
+export interface IColorPickerEditEmits extends IColorHsvEmits, IColorModeEmits {
+}

package/dist/src/interfaces/ColorPicker/color-picker-preview.interface.d.ts

@@ -1,7 +1,10 @@
-import type { ICommonsComponentProps, IDimensionProps } from "../../interfaces";
+import type { IColorHsvEmits, ICommonsComponentProps, IDimensionProps } from "../../interfaces";
 import type { THSVA } from "../../types";
 export interface IColorPickerPreviewProps extends ICommonsComponentProps, IDimensionProps {
     colorHsv?: THSVA | null;
     disabled?: boolean;
     hideAlpha?: boolean;
 }
+/** Emits fired by `<OrigamColorPickerPreview>` — alpha slider updates the HSVA. */
+export interface IColorPickerPreviewEmits extends IColorHsvEmits {
+}

package/dist/src/interfaces/ColorPicker/color-picker-swatches.interface.d.ts

@@ -1,7 +1,11 @@
-import type { ICommonsComponentProps, IDimensionProps } from "../../interfaces";
+import type { IColorHsvEmits, ICommonsComponentProps, IDimensionProps } from "../../interfaces";
 import type { TColorType, THSVA } from "../../types";
 export interface IColorPickerSwatchesProps extends ICommonsComponentProps, IDimensionProps {
     colorHsv?: THSVA | null;
     disabled?: boolean;
     swatches?: Array<Array<TColorType>>;
 }
+/** Emits fired by `<OrigamColorPickerSwatches>` — click on a swatch tile
+ *  pushes the colour up the HSVA channel. */
+export interface IColorPickerSwatchesEmits extends IColorHsvEmits {
+}

package/dist/src/interfaces/ColorPicker/color-picker.interface.d.ts

@@ -1,5 +1,17 @@
-import type { IBorderProps, IColorPickerCanvasProps, IColorPickerEditProps, IColorPickerPreviewProps, IColorPickerSwatchesProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IPickerProps, IRoundedProps } from "../../interfaces";
-import type { THSVA } from "../../types";
+import type { IBorderProps, IColorPickerCanvasProps, IColorPickerEditProps, IColorPickerPreviewProps, IColorPickerSwatchesProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IPickerProps, IRoundedProps } from "../../interfaces";
+import type { TColorModes, THSVA } from "../../types";
+/** Shared emit shape for sub-components driving the HSVA model
+ *  (Canvas / Edit / Preview / Swatches all push their changes up the
+ *  same channel). Factored here so the four sub-component interfaces
+ *  can extend it without redeclaring. */
+export interface IColorHsvEmits {
+    (e: 'update:colorHsv', value: THSVA): void;
+}
+/** Shared emit shape for sub-components that flip between color modes
+ *  (RGB / HSL / HSV / HEX, …). */
+export interface IColorModeEmits {
+    (e: 'update:mode', value: TColorModes): void;
+}
 export interface IColorPickerProps extends ICommonsComponentProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IPickerProps, IColorProps, IColorPickerCanvasProps, IColorPickerPreviewProps, IColorPickerEditProps, IColorPickerSwatchesProps {
     canvasHeight?: string | number;
     canvasWidth?: string | number;
@@ -21,3 +33,7 @@ export interface IColorPickerMode {
     from: (color: any) => THSVA;
     to: (color: THSVA) => any;
 }
+/** Emits fired by `<OrigamColorPicker>` — v-model on the resolved colour
+ *  plus the active input mode. */
+export interface IColorPickerEmits extends ICommonsComponentEmits, IColorModeEmits {
+}

package/dist/src/interfaces/CommandPalette/command-palette.interface.cjs

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

package/dist/src/interfaces/CommandPalette/command-palette.interface.d.ts

@@ -0,0 +1,57 @@
+import type { ICommand } from './command.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+/**
+ * A hotkey is either a single combination (`['meta', 'k']`) or an
+ * array of alternatives — every entry being a list of normalised key
+ * tokens compatible with `useHotkey` (e.g. `[['meta', 'k'], ['ctrl', 'k']]`).
+ *
+ * The component normalises a single-combination input (`['meta', 'k']`)
+ * to the multi-combination shape (`[['meta', 'k']]`) before installing
+ * the listeners so consumers can pass either form interchangeably.
+ */
+export type TCommandPaletteHotkey = ReadonlyArray<string> | ReadonlyArray<ReadonlyArray<string>>;
+export interface ICommandPaletteProps extends ICommonsComponentProps {
+    /** v-model — whether the palette is open. */
+    modelValue?: boolean;
+    /**
+     * Global hotkey(s) that toggle the palette open. Defaults to
+     * `[['meta', 'k'], ['ctrl', 'k']]` (⌘K / Ctrl+K). Pass `null`
+     * to disable the global listener entirely.
+     */
+    hotkey?: TCommandPaletteHotkey | null;
+    /**
+     * Static command list. When omitted, the palette renders commands
+     * registered via the `useCommand()` global registry instead.
+     */
+    commands?: ReadonlyArray<ICommand>;
+    /** Placeholder of the search input (already-translated string). */
+    placeholder?: string;
+    /** Empty-state message when no command matches the query. */
+    emptyText?: string;
+    /** Max height of the result list. Number → px. */
+    maxHeight?: number | string;
+    /** Width of the palette dialog. Number → px. */
+    width?: number | string;
+    /** Display a loader inside the result list (use during async fetches). */
+    loading?: boolean;
+    /** Close the palette automatically when a command is selected. */
+    closeOnSelect?: boolean;
+    /** Close when the user presses Escape. */
+    closeOnEscape?: boolean;
+    /** Close when the user clicks the backdrop. */
+    closeOnBackdrop?: boolean;
+}
+export interface ICommandPaletteEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    (e: 'select', command: ICommand): void;
+    (e: 'query', text: string): void;
+}
+export interface ICommandPaletteSlotProps {
+    command: ICommand;
+    isActive: boolean;
+}
+export interface ICommandPaletteSlots {
+    item?: (props: ICommandPaletteSlotProps) => any;
+    empty?: () => any;
+    footer?: () => any;
+}

package/dist/src/interfaces/CommandPalette/command.interface.cjs

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

package/dist/src/interfaces/CommandPalette/command.interface.d.ts

@@ -0,0 +1,51 @@
+import type { TIcon } from '../../types';
+/**
+ * A single command/action exposed by `OrigamCommandPalette`.
+ *
+ * Commands are registered either declaratively through the
+ * `commands` prop on `<OrigamCommandPalette>` OR programmatically
+ * via the `useCommand().register(cmd)` composable. The composable
+ * route is preferred when commands need to spawn from feature code
+ * that owns the side-effect (router push, store mutation, …).
+ */
+export interface ICommand {
+    /**
+     * Stable identifier. Used as the v-for key, the ARIA
+     * `aria-activedescendant` target and as the dedup key in the
+     * registry — registering twice with the same `id` overwrites
+     * the previous entry instead of duplicating it.
+     */
+    id: string;
+    /** Visible primary label. Drives the default fuzzy-match input. */
+    label: string;
+    /** Secondary line shown under the label (optional). */
+    description?: string;
+    /** Optional prepend icon. */
+    icon?: TIcon;
+    /**
+     * Keyboard shortcut hint rendered through `<OrigamKbd>` next to
+     * the action. Display-only — it does NOT bind a global listener.
+     * (To bind a shortcut globally, use the `hotkey` prop on the
+     * palette OR the `useHotkey` composable on the call site.)
+     */
+    kbd?: ReadonlyArray<string>;
+    /**
+     * Group label (e.g. "Navigation", "Settings"). Commands sharing
+     * the same group render under the same subheader. Commands
+     * without a group fall back to a default bucket rendered first.
+     */
+    group?: string;
+    /**
+     * Extra search terms that should match the command (e.g.
+     * `['preferences', 'config']` for a "Settings" entry).
+     */
+    keywords?: ReadonlyArray<string>;
+    /**
+     * Handler invoked when the command is selected. May be async — the
+     * palette awaits the returned promise before closing (when
+     * `closeOnSelect` is `true`).
+     */
+    perform: () => void | Promise<void>;
+    /** Disabled commands stay visible but cannot be selected. */
+    disabled?: boolean;
+}

package/dist/src/interfaces/Commons/audio.interface.d.ts

@@ -1,4 +1,10 @@
-export interface IAudioProps {
+/**
+ * Props for the low-level Commons `useAudio` composable (frequency
+ * analyser + play-on-flag wiring). Renamed from the legacy
+ * `IAudioProps` symbol to avoid collision with the canonical
+ * `IAudioProps` of `<OrigamAudio>` (`src/interfaces/Audio/`).
+ */
+export interface IUseAudioProps {
     audio?: string;
     playAudio?: boolean;
 }

package/dist/src/interfaces/Commons/clickOutside.interface.d.ts

@@ -7,3 +7,8 @@ export interface IClickOutsideBindingArgs {
     closeConditional?: (e: Event) => boolean;
     include?: () => Array<HTMLElement>;
 }
+/** `click:outside` emit — fires when a pointer down event lands outside
+ *  the component's root (Dialog, Drawer, Sheet, …). */
+export interface IClickOutsideEmits {
+    (e: 'click:outside', event: MouseEvent): void;
+}

package/dist/src/interfaces/Commons/commons.interface.d.ts

@@ -32,6 +32,24 @@ export interface ICommonsComponentProps {
 export interface ICommonsComponentEmits {
     (e: 'update:modelValue', event: any): void;
 }
+/** Generic `click` emit — bubbles the native MouseEvent. */
+export interface IClickEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+/** `click:close` emit — surface for dismissable surfaces (Alert, Snackbar, …). */
+export interface IClickCloseEmits {
+    (e: 'click:close', event: MouseEvent): void;
+}
+/** `click:label` emit — fires when the user clicks the associated <label>
+ *  rather than the input chrome itself. Used by selection controls. */
+export interface IClickLabelEmits {
+    (e: 'click:label', event: MouseEvent): void;
+}
+/** `update:indeterminate` emit — companion to `update:modelValue` for
+ *  three-state controls (Switch, Checkbox, …). */
+export interface IIndeterminateEmits {
+    (e: 'update:indeterminate', value: boolean): void;
+}
 /** Default slot signature shared by container components. */
 export interface ICommonsComponentSlots {
     default?: () => any;

package/dist/src/interfaces/Commons/gradient.interface.cjs

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

package/dist/src/interfaces/Commons/gradient.interface.d.ts

@@ -0,0 +1,39 @@
+import type { TIntent } from '../../types';
+/**
+ * Single stop in a multi-stop gradient.
+ *
+ *   - `color` accepts either a {@link TIntent} (resolved to its
+ *     `--origam-color__action--{intent}---bg` token) or a raw CSS color
+ *     string (hex / rgb / hsl / named).
+ *   - `position` is a percentage in `[0..100]`.
+ */
+export interface IGradientStop {
+    color: TIntent | string;
+    position: number;
+}
+/**
+ * Structured gradient descriptor — second of the three accepted formats
+ * for `color` / `bgColor` / `textColor` props (the others are a raw CSS
+ * gradient string and a preset name like `'gradient-sunset'`).
+ *
+ * Two ways to define the colour ramp:
+ *
+ *   1. Short form — `from` + `to` (+ optional `via`) → emits a 2- or
+ *      3-stop gradient with stops auto-spaced.
+ *   2. Full form — `stops: [...]` overrides the short form entirely and
+ *      lets the consumer specify any number of stops with explicit
+ *      positions.
+ *
+ * `direction` accepts a numeric angle in degrees (default `135`) OR a
+ * CSS keyword such as `'to right'`, `'to bottom left'`, … For radial /
+ * conic gradients, `direction` is forwarded as the shape/position prefix
+ * (e.g. `'circle at center'` for radial).
+ */
+export interface IGradient {
+    type?: 'linear' | 'radial' | 'conic';
+    from?: TIntent | string;
+    to?: TIntent | string;
+    via?: TIntent | string;
+    direction?: number | string;
+    stops?: IGradientStop[];
+}

package/dist/src/interfaces/Commons/group.interface.d.ts

@@ -44,3 +44,9 @@ export interface IGroupItemProvide {
     disabled: Ref<boolean | undefined>;
     group: IGroupProvide;
 }
+/** Emit signature for components that are part of a selectable group. */
+export interface IGroupEmits {
+    (e: 'group:selected', value: {
+        value: boolean;
+    }): void;
+}

package/dist/src/interfaces/Commons/hover.interface.d.ts

@@ -42,3 +42,7 @@ export interface IHoverHtmlElementHover {
     touched?: boolean;
     isTouch?: boolean;
 }
+/** Emit signature for components that propagate their hover state. */
+export interface IHoverEmits {
+    (e: 'update:hover', value: boolean): void;
+}

package/dist/src/interfaces/Commons/layout.interface.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentInternalInstance, ComputedRef, CSSProperties, Ref } from 'vue';
-import type { ICommonsComponentProps } from '../../interfaces';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
 import type { TDirectionBoth } from '../../types';
 export interface ILayoutProvide {
     register: (vm: ComponentInternalInstance, options: {
@@ -36,7 +36,7 @@ export interface ILayerItem extends ILayer {
     size: number;
     position: TDirectionBoth;
 }
-export interface ILayoutProps extends ICommonsComponentProps {
+export interface ILayoutProps extends ICommonsComponentProps, IDimensionProps, IMarginProps, IPaddingProps, IRoundedProps, IElevationProps, IBgColorProps, IColorProps, IBorderProps {
     overlaps?: Array<string>;
     fullHeight?: boolean;
 }

package/dist/src/interfaces/Commons/lazy.interface.d.ts

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps, IDimensionProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
+import type { ICommonsComponentEmits, ICommonsComponentProps, IDimensionProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
 export interface ILazyProps {
     eager?: boolean;
 }
@@ -6,3 +6,7 @@ export interface ILazyComponentProps extends ICommonsComponentProps, IDimensionP
     modelValue?: boolean;
     options?: IntersectionObserverInit;
 }
+/** Emits fired by `<OrigamLazy>` — v-model fires when the intersection
+ *  observer flips the wrapper to "visible". */
+export interface ILazyEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/DataTable/data-table.interface.d.ts

@@ -1,5 +1,5 @@
 import type { UnwrapRef } from 'vue';
-import type { IDataTableExpandProps, IDataTableFooterProps, IDataTableGroup, IDataTableGroupProps, IDataTableHeaderProps, IDataTableHeadersProps, IDataTableItem, IDataTableItemsProps, IDataTablePaginationProps, IDataTableProvideExpanded, IDataTableProvideGroup, IDataTableProvidePagination, IDataTableProvideSelection, IDataTableProvideSort, IDataTableRowProps, IDataTableSelectProps, IDataTableSortProps, IFiltersProps, IInternalDataTableHeader, ITableProps } from '../../interfaces';
+import type { ICommonsComponentEmits, IDataTableExpandProps, IDataTableFooterProps, IDataTableGroup, IDataTableGroupProps, IDataTableHeaderProps, IDataTableHeadersProps, IDataTableItem, IDataTableItemsProps, IDataTablePaginationProps, IDataTableProvideExpanded, IDataTableProvideGroup, IDataTableProvidePagination, IDataTableProvideSelection, IDataTableProvideSort, IDataTableRowProps, IDataTableSelectProps, IDataTableSortProps, IFiltersProps, IInternalDataTableHeader, ITableProps } from '../../interfaces';
 export interface IDataTableProps extends ITableProps, IDataTableRowProps, IDataTableExpandProps, IDataTableGroupProps, IDataTableHeaderProps, IDataTableItemsProps, IDataTableSelectProps, IDataTableSortProps, IDataTableHeadersProps, IDataTablePaginationProps, IFiltersProps, IDataTableFooterProps {
     hideDefaultBody?: boolean;
     hideDefaultFooter?: boolean;
@@ -29,3 +29,14 @@ export interface IDataTableSlotProps<T> {
     columns: Array<IInternalDataTableHeader>;
     headers: Array<Array<IInternalDataTableHeader>>;
 }
+/** Emits fired by `<OrigamDataTable>` — pagination, sorting, grouping,
+ *  expansion, selection, and the v-model that ties them together. */
+export interface IDataTableEmits extends ICommonsComponentEmits {
+    (e: 'update:page', value: number): void;
+    (e: 'update:itemsPerPage', value: number): void;
+    (e: 'update:sortBy', value: UnwrapRef<IDataTableProvideSort['sortBy']>): void;
+    (e: 'update:options', value: Record<string, unknown>): void;
+    (e: 'update:groupBy', value: UnwrapRef<IDataTableProvideGroup['groupBy']>): void;
+    (e: 'update:expanded', value: ReadonlySet<unknown>): void;
+    (e: 'update:currentItems', value: Array<IDataTableItem>): void;
+}

package/dist/src/interfaces/DataTable/headers.interface.d.ts

@@ -1,6 +1,6 @@
 import type { ComputedRef, Ref, UnwrapRef } from 'vue';
 import { ALIGN } from '../../enums';
-import type { IColorProps, ICommonsComponentProps, IDataTableItem, IDataTableSortItem, IDisplayProps, ILoaderProps } from '../../interfaces';
+import type { IAdjacentEmits, IColorProps, ICommonsComponentProps, IDataTableItem, IDataTableSortItem, IDisplayProps, ILoaderProps } from '../../interfaces';
 import type { TAlign, TDataTableCompareFunction, TDataTableHeaderCell, TFilterFunction, TIcon, TSelectItemKey } from '../../types';
 export interface IHeaderCellProps extends ICommonsComponentProps, IColorProps {
     disableSort?: boolean;
@@ -16,6 +16,11 @@ export interface IDataTableHeadersCellMobileProps extends ICommonsComponentProps
     columns: Array<IInternalDataTableHeader>;
     colspan?: number;
 }
+/** Emits fired by `<OrigamDataTableHeadersCellMobile>` — clear button +
+ *  prepend / append slot clicks. */
+export interface IDataTableHeadersCellMobileEmits extends IAdjacentEmits {
+    (e: 'click:clear', event: MouseEvent): void;
+}
 export interface IDataTableHeadersCellProps extends ICommonsComponentProps, IColorProps, IHeaderCellProps {
     headers: Array<Array<IInternalDataTableHeader>>;
 }

package/dist/src/interfaces/DataTable/row.interface.d.ts

@@ -11,3 +11,14 @@ export interface IDataTableRowProps extends ICommonsComponentProps, IDisplayProp
     item: IDataTableItem;
     cellProps?: TDataTableCell<any>;
 }
+/** Emits fired by `<OrigamDataTableRow>` — row-level expand / select. */
+export interface IDataTableRowEmits {
+    (e: 'expand', payload: {
+        item: IDataTableItem;
+        value: boolean;
+    }): void;
+    (e: 'select', payload: {
+        item: IDataTableItem;
+        value: boolean;
+    }): void;
+}