origam 2.3.0 → 2.5.0

package/dist/src/interfaces/EmptyState/empty-state.interface.d.ts

@@ -0,0 +1,100 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { TEmptyStateAlign, TEmptyStatePreset, TEmptyStateSize, TIcon, TIntent } from '../../types';
+/**
+ * Props for `<OrigamEmptyState>` — placeholder shown when a list, table
+ * or collection has nothing to render.
+ *
+ * Five visual presets (`no-data`, `no-results`, `error`, `offline`,
+ * `locked`) cover the most common cases: each preset bundles an icon
+ * and an intent so callers do not have to wire those by hand. Both
+ * sides can be overridden via the `icon` and `iconColor` props for the
+ * 5% case. Slots are provided to replace the icon (with an SVG / img),
+ * title, description, or the entire layout for custom illustrations.
+ */
+export interface IEmptyStateProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * Visual preset. Bundles a default icon and intent — see
+     * `EMPTY_STATE_PRESET_CONFIG`. The preset is the starting point;
+     * `icon` and `iconColor` win when both are passed.
+     *
+     * @default 'no-data'
+     */
+    preset?: TEmptyStatePreset;
+    /**
+     * Primary heading. Rendered as a `<h2>`-equivalent element with
+     * the chosen `size`. Override entirely via the `#title` slot when
+     * richer markup is needed (a link, an icon-prefix, …).
+     */
+    title?: string;
+    /**
+     * Optional sub-heading rendered below the title. Multiple lines
+     * supported; the SCSS layer clamps the readable width via the
+     * `--origam-empty-state---max-width` token.
+     */
+    description?: string;
+    /**
+     * Override the preset icon. Accepts the same `TIcon` shape as
+     * `<OrigamIcon>`: a MDI / iconify string, an array of SVG path
+     * tuples, or a Vue `Component`. Use the `#icon` slot for full
+     * SVG / `<img>` illustrations.
+     */
+    icon?: TIcon;
+    /**
+     * Override the preset's icon color (the semantic intent that maps
+     * to `--origam-color__action--{intent}---bg` /
+     * `--origam-color__feedback--{intent}---bg`).
+     */
+    iconColor?: TIntent;
+    /**
+     * Vertical density. Drives icon size, title / description font
+     * sizes, padding and gap.
+     *
+     * @default 'md'
+     */
+    size?: TEmptyStateSize;
+    /**
+     * Horizontal alignment of the icon / title / description / actions
+     * stack.
+     *
+     * @default 'center'
+     */
+    align?: TEmptyStateAlign;
+}
+/**
+ * Slot signatures for `<OrigamEmptyState>`. All slots are optional.
+ * When the `default` slot is provided, it replaces the entire built-in
+ * layout — the parent regains full control over the placeholder
+ * markup. Use the targeted slots (`icon`, `title`, `description`,
+ * `actions`) to swap one piece at a time.
+ */
+export interface IEmptyStateSlots {
+    /**
+     * Replaces the entire built-in layout (icon + title + description
+     * + actions). Use this for a fully bespoke layout — e.g. a hero
+     * empty page with a custom illustration and a multi-column CTA
+     * grid.
+     */
+    default?: () => any;
+    /**
+     * Replaces the default `<OrigamIcon>` rendering. Use for SVG /
+     * `<img>` illustrations. Mark the surface `aria-hidden="true"`
+     * when it is purely decorative.
+     */
+    icon?: () => any;
+    /**
+     * Replaces the rendered title element. Slot wins over the `title`
+     * prop when both are provided.
+     */
+    title?: () => any;
+    /**
+     * Replaces the rendered description element. Slot wins over the
+     * `description` prop when both are provided.
+     */
+    description?: () => any;
+    /**
+     * Actions row rendered below the description (or the title when
+     * `description` is absent). Typically holds 1–2 buttons (Create,
+     * Retry, Switch to offline mode, Sign in).
+     */
+    actions?: () => any;
+}

package/dist/src/interfaces/ExpensionPanel/expansion-panel-header.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IAdjacentProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface IExpansionPanelHeaderProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, IAdjacentProps, IRippleProps, IActiveProps, IHoverProps {
     expandIcon?: TIcon;
@@ -9,3 +9,6 @@ export interface IExpansionPanelHeaderProps extends IColorProps, IBgColorProps,
     readonly?: boolean;
     title?: string;
 }
+/** Emits fired by `<OrigamExpansionPanelHeader>` — prepend/append icon clicks. */
+export interface IExpansionPanelHeaderEmits extends IAdjacentEmits {
+}

package/dist/src/interfaces/ExpensionPanel/expansion-panel.interface.d.ts

@@ -1,3 +1,6 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IExpansionPanelContentProps, IExpansionPanelHeaderProps, IGroupItemProps, IHoverProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IExpansionPanelContentProps, IExpansionPanelHeaderProps, IGroupEmits, IGroupItemProps, IHoverProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 export interface IExpansionPanelProps extends ITagProps, ICommonsComponentProps, IDensityProps, IColorProps, IBgColorProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, IRoundedProps, IGroupItemProps, IExpansionPanelHeaderProps, IExpansionPanelContentProps, ILazyProps, ILoaderProps, IActiveProps, IHoverProps {
 }
+/** Emits fired by `<OrigamExpansionPanel>` — group membership lifecycle. */
+export interface IExpansionPanelEmits extends IGroupEmits {
+}

package/dist/src/interfaces/ExpensionPanel/expansion-panels.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IExpansionPanelProps, IGroupProps, IHoverProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IExpansionPanelProps, IGroupProps, IHoverProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface IExpansionPanelsProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IGroupProps, IDensityProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, ILazyProps, ILoaderProps, IElevationProps, IActiveProps, IHoverProps {
     flat?: boolean;
@@ -10,3 +10,6 @@ export interface IExpansionPanelsProps extends IColorProps, IBgColorProps, ITagP
     collapseIcon?: TIcon;
     hideActions?: boolean;
 }
+/** Emits fired by `<OrigamExpansionPanels>` — v-model on the active panel set. */
+export interface IExpansionPanelsEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/FileField/file-field-dragndrop-item.interface.d.ts

@@ -1,5 +1,5 @@
-import { IColorProps, ICommonsComponentProps } from '../../interfaces';
-export interface IFileFieldDragNDropItemProps extends ICommonsComponentProps {
+import type { IColorProps, ICommonsComponentProps } from '../../interfaces';
+export interface IFileFieldDragNDropItemProps extends ICommonsComponentProps, IColorProps {
     file: File;
     index: number;
     progress?: number;
@@ -7,7 +7,6 @@ export interface IFileFieldDragNDropItemProps extends ICommonsComponentProps {
     removeIcon?: string;
     disabled?: boolean;
     readonly?: boolean;
-    color?: IColorProps['color'];
     showSize?: boolean | 1000 | 1024;
 }
 export interface IFileFieldDragNDropItemEmits {

package/dist/src/interfaces/FileField/file-field-list-item.interface.d.ts

@@ -1,5 +1,5 @@
-import { IColorProps, ICommonsComponentProps } from '../../interfaces';
-export interface IFileFieldListItemProps extends ICommonsComponentProps {
+import type { IColorProps, ICommonsComponentProps } from '../../interfaces';
+export interface IFileFieldListItemProps extends ICommonsComponentProps, IColorProps {
     file: File;
     index: number;
     progress?: number;
@@ -7,7 +7,6 @@ export interface IFileFieldListItemProps extends ICommonsComponentProps {
     removeIcon?: string;
     disabled?: boolean;
     readonly?: boolean;
-    color?: IColorProps['color'];
     showSize?: boolean | 1000 | 1024;
 }
 export interface IFileFieldListItemEmits {

package/dist/src/interfaces/Grid/grid-item.interface.cjs

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

package/dist/src/interfaces/Grid/grid-item.interface.d.ts

@@ -0,0 +1,55 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { TGridPlaceSelf } from '../../types';
+/**
+ * Object syntax for a grid line spec. The same shape is used for
+ * `column` and `row`. Either pass `start` + `end`, or `start` + `span`,
+ * or any subset (defaults are `auto`).
+ *
+ * `span` is mutually exclusive with `end` — when both are passed, `span`
+ * wins (it's the more common ergonomic case).
+ */
+export interface IGridLineSpec {
+    /** Inclusive starting grid line. Accepts a number or a named line. */
+    start?: number | string;
+    /** Exclusive ending grid line. Accepts a number or a named line. */
+    end?: number | string;
+    /** Span N tracks from `start`. Wins over `end` when both are set. */
+    span?: number;
+}
+/**
+ * Props for `<OrigamGridItem>` — a thin wrapper that emits the per-item
+ * CSS Grid placement properties. The component is optional: anyone can
+ * achieve the same result by setting `style="grid-area: …"` on a plain
+ * `<div>`. The wrapper exists to (a) avoid forcing consumers to remember
+ * the verbose CSS syntax, and (b) accept an ergonomic object syntax.
+ */
+export interface IGridItemProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * Inline-axis placement (`grid-column`). Two accepted shapes:
+     *
+     * - object: `{ start: 1, end: 5 }` or `{ start: 1, span: 4 }` —
+     *   the component serialises to the right CSS.
+     * - string: `'1 / 5'`, `'span 2'`, `'main-start / main-end'` —
+     *   passed verbatim.
+     */
+    column?: IGridLineSpec | string | number;
+    /**
+     * Block-axis placement (`grid-row`). Same accepted shapes as `column`.
+     */
+    row?: IGridLineSpec | string | number;
+    /**
+     * `grid-area` name. When set, overrides `column` / `row` (CSS rule).
+     * Use this in conjunction with the parent grid's `areas` prop.
+     */
+    area?: string;
+    /**
+     * Per-item `align-self` override. Falls back to the parent grid's
+     * `alignItems` when unset.
+     */
+    alignSelf?: TGridPlaceSelf;
+    /**
+     * Per-item `justify-self` override. Falls back to the parent grid's
+     * `justifyItems` when unset.
+     */
+    justifySelf?: TGridPlaceSelf;
+}

package/dist/src/interfaces/Grid/grid.interface.cjs

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

package/dist/src/interfaces/Grid/grid.interface.d.ts

@@ -0,0 +1,121 @@
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { TGridAutoFlow, TGridGapSize, TGridPlaceContent, TGridPlaceItems } from '../../types';
+/**
+ * Tracks definition accepted by `columns` / `rows` / `autoColumns` /
+ * `autoRows`. The three accepted shapes are intentionally permissive
+ * because CSS `grid-template-*` is itself extremely permissive:
+ *
+ * - `number`   → `repeat(N, 1fr)` — the 90 % case ("just give me 12 columns").
+ * - `string`   → passed verbatim — escape hatch for `repeat(auto-fill, minmax(200px, 1fr))`,
+ *               named lines, custom track lists, …
+ * - `string[]` → joined with a single space — useful when the consumer
+ *               wants per-track sizing without nested-string awkwardness
+ *               (`['200px', '1fr', '200px']`).
+ */
+export type TGridTracks = number | string | ReadonlyArray<string>;
+/**
+ * Props for `<OrigamGrid>` — a declarative CSS Grid container.
+ *
+ * The component is intentionally thin: it forwards every CSS Grid
+ * property through inline custom properties on the root element.
+ * No track measurement, no JS resize observation — modern browsers
+ * have shipped Grid since 2017 and we lean on that.
+ */
+export interface IGridProps extends ICommonsComponentProps, ITagProps, IDimensionProps, IMarginProps, IPaddingProps, IRoundedProps, IElevationProps, IBgColorProps, IColorProps, IBorderProps {
+    /**
+     * Track template for the inline axis (`grid-template-columns`).
+     *
+     * - `number` (e.g. `12`) — sugar for `repeat(N, 1fr)`.
+     * - `string` (e.g. `'1fr 2fr 1fr'` or `'repeat(auto-fill, minmax(200px, 1fr))'`)
+     *   — passed verbatim.
+     * - `string[]` (e.g. `['200px', '1fr', '200px']`) — joined with single space.
+     *
+     * @default 'auto'
+     */
+    columns?: TGridTracks;
+    /**
+     * Track template for the block axis (`grid-template-rows`).
+     * Same accepted shapes as `columns`.
+     *
+     * @default 'auto'
+     */
+    rows?: TGridTracks;
+    /**
+     * Both-axis gap. Accepts:
+     *
+     * - one of the size tokens `'xs' | 'sm' | 'md' | 'lg' | 'xl'`
+     *   (resolved via `tokens/component/grid.json`).
+     * - any CSS length string (`'24px'`, `'1rem'`, `'1rem 2rem'`).
+     * - a plain `number` interpreted as pixels.
+     *
+     * `columnGap` / `rowGap` take precedence on their respective axis.
+     *
+     * @default 'md'
+     */
+    gap?: TGridGapSize | string | number;
+    /**
+     * Inline-axis-only gap override. Same accepted shapes as `gap`.
+     */
+    columnGap?: TGridGapSize | string | number;
+    /**
+     * Block-axis-only gap override. Same accepted shapes as `gap`.
+     */
+    rowGap?: TGridGapSize | string | number;
+    /**
+     * `grid-template-areas`. Two accepted shapes:
+     *
+     * - `string[]` — every entry is one row of the template
+     *   (`['header header', 'sidebar main']`). Each entry is wrapped in
+     *   quotes by the component, so the consumer doesn't have to.
+     * - `string` — raw CSS, passed verbatim. Use it when you want to
+     *   inline `". header ."` style escape hatches with multiple double-
+     *   quoted rows yourself.
+     */
+    areas?: string | ReadonlyArray<string>;
+    /**
+     * `grid-auto-flow`. Controls how implicit tracks are filled when
+     * items don't declare an explicit area.
+     *
+     * @default 'row'
+     */
+    autoFlow?: TGridAutoFlow;
+    /**
+     * `grid-auto-columns` — sizes for implicit columns. Free-form CSS.
+     */
+    autoColumns?: string;
+    /**
+     * `grid-auto-rows` — sizes for implicit rows. Free-form CSS.
+     */
+    autoRows?: string;
+    /**
+     * `align-items` — block-axis alignment of grid items inside their cells.
+     *
+     * @default 'stretch'
+     */
+    alignItems?: TGridPlaceItems;
+    /**
+     * `justify-items` — inline-axis alignment of grid items inside their cells.
+     *
+     * @default 'stretch'
+     */
+    justifyItems?: TGridPlaceItems;
+    /**
+     * `align-content` — block-axis alignment of the whole grid inside
+     * its container (only relevant when the grid is smaller than its
+     * container on that axis).
+     */
+    alignContent?: TGridPlaceContent;
+    /**
+     * `justify-content` — inline-axis alignment of the whole grid
+     * inside its container.
+     */
+    justifyContent?: TGridPlaceContent;
+    /**
+     * Toggles `display: inline-grid` instead of `display: grid`. Useful
+     * for inline-flow layouts (e.g. a label + tag pill where you want
+     * the grid to size to its content).
+     *
+     * @default false
+     */
+    inline?: boolean;
+}

package/dist/src/interfaces/Icon/icon.interface.d.ts

@@ -1,9 +1,9 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, ISizeProps, ITagProps } from '../../interfaces';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
 import type { TIcon, TIconComponent } from '../../types';
 export interface IIconProps {
     icon?: TIcon;
 }
-export interface IIconComponentProps extends IIconProps, IColorProps, ICommonsComponentProps, ITagProps, ISizeProps, IPaddingProps, IMarginProps, IBorderProps {
+export interface IIconComponentProps extends IIconProps, IColorProps, IBgColorProps, ICommonsComponentProps, ITagProps, ISizeProps, IPaddingProps, IMarginProps, IBorderProps, IDimensionProps, IRoundedProps {
     disabled?: boolean;
 }
 export interface IIconAliases {

package/dist/src/interfaces/Img/img.interface.d.ts

@@ -21,3 +21,17 @@ export interface ISrcObject {
     aspectRatio: number;
     alt?: string;
 }
+/** Emits fired by `<OrigamImg>` — native <img> lifecycle (loadstart fires
+ *  before the network request, load when the resource is fully decoded,
+ *  error when the browser gives up). */
+export interface IImgEmits {
+    (e: 'loadstart', value: {
+        src: string;
+    }): void;
+    (e: 'load', value: {
+        src: string;
+    }): void;
+    (e: 'error', value: {
+        src: string;
+    }): void;
+}

package/dist/src/interfaces/InfiniteScroll/infinite-scroll.interface.d.ts

@@ -12,3 +12,19 @@ export interface IInfiniteScrollIntersectProps extends ICommonsComponentProps {
     rootRef: HTMLElement;
     margin?: string;
 }
+/** Emits fired by `<OrigamInfiniteScroll>` — `load` fires when the sentinel
+ *  enters the viewport and the parent should fetch the next page. */
+export interface IInfiniteScrollEmits {
+    (e: 'load', value: {
+        side: TInfiniteScrollSide;
+        done: (status: 'ok' | 'empty' | 'error') => void;
+    }): void;
+}
+/** Emits fired by `<OrigamInfiniteScrollIntersect>` — the lower-level
+ *  sentinel that just bubbles its IntersectionObserver entries. */
+export interface IInfiniteScrollIntersectEmits {
+    (e: 'intersect', value: {
+        isIntersecting: boolean;
+        side: TInfiniteScrollSide;
+    }): void;
+}

package/dist/src/interfaces/InlineEdit/inline-edit.interface.cjs

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

package/dist/src/interfaces/InlineEdit/inline-edit.interface.d.ts

@@ -0,0 +1,241 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { TInlineEditInputType } from '../../types';
+/**
+ * Signature of a validator passed to `<OrigamInlineEdit>` (and to the
+ * `useInlineEdit` composable). Returns `true` when the draft value is
+ * acceptable, or an error message (`string`) that the component will
+ * surface via `role="alert"`.
+ *
+ * Async validators are supported — return a `Promise` and the component
+ * will keep the editor open (and expose `isPending = true`) until it
+ * resolves.
+ */
+export type TInlineEditValidator = (value: string) => true | string | Promise<true | string>;
+/**
+ * Props for `<OrigamInlineEdit>` — edit-in-place pattern.
+ *
+ * The component is intentionally headless on the display side: by
+ * default it renders a button-styled span with the current value (or
+ * the placeholder when the value is empty); consumers can fully
+ * override the affordance via the scoped `#display` slot. In edit
+ * mode it renders a native `<input>` (or `<textarea>` when `multiline`
+ * is true) — wrapping a heavier component (TextField, …) is not
+ * needed and would defeat the keyboard-driven UX.
+ */
+export interface IInlineEditProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * Current value (v-model target). Accepts both `string` and
+     * `number` for ergonomics — the internal draft is normalised to a
+     * string, then `update:modelValue` re-emits with the same shape as
+     * the original (number stays number, string stays string).
+     */
+    modelValue: string | number;
+    /**
+     * Placeholder shown on the input AND surfaced inside the default
+     * `#display` slot when `modelValue` is empty. Consumers wrap with
+     * `t()` if they need i18n.
+     */
+    placeholder?: string;
+    /**
+     * Validation callback. Returns `true` (or `Promise<true>`) when
+     * the draft is acceptable, or an error message string that will
+     * be surfaced in a `role="alert"` element near the input.
+     *
+     * Sync validators run on every Enter / blur. Async validators
+     * keep the editor open until the returned Promise settles.
+     */
+    validate?: TInlineEditValidator;
+    /**
+     * Auto-focus the input when entering edit mode. Setting this to
+     * false is useful for forms where keyboard focus is managed by a
+     * parent (e.g. a wizard that steps focus through siblings).
+     *
+     * @default true
+     */
+    autoFocus?: boolean;
+    /**
+     * Select all the input's text when it gains focus on edit entry.
+     * Common for "click title to rename" patterns — the user can
+     * immediately type a replacement without selecting first.
+     *
+     * @default true
+     */
+    selectOnFocus?: boolean;
+    /**
+     * Confirm the draft when the input loses focus. When false, the
+     * editor stays open on blur and the user must explicitly Enter
+     * to confirm or Escape to cancel.
+     *
+     * @default true
+     */
+    confirmOnBlur?: boolean;
+    /**
+     * Confirm on `Enter`. Disable when the edit zone is a multiline
+     * textarea and Enter should produce a newline (Cmd/Ctrl+Enter to
+     * confirm is the convention — apps wire this manually).
+     *
+     * @default true
+     */
+    confirmOnEnter?: boolean;
+    /**
+     * Cancel (revert the draft) on `Escape`.
+     *
+     * @default true
+     */
+    cancelOnEscape?: boolean;
+    /**
+     * Disables the component — the display affordance becomes
+     * non-interactive (button `disabled`, span `aria-disabled`), the
+     * `edit()` method short-circuits, and any in-flight edit is
+     * cancelled (draft discarded).
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Render a `<textarea>` instead of a `<input>` in edit mode.
+     * When true, `confirmOnEnter` should generally be disabled by the
+     * consumer so newlines are not swallowed.
+     *
+     * @default false
+     */
+    multiline?: boolean;
+    /**
+     * Strip surrounding whitespace before emitting `update:modelValue`
+     * AND before running the validator. Disable for fields where
+     * trailing spaces are significant (passwords, …).
+     *
+     * @default true
+     */
+    trim?: boolean;
+    /**
+     * Native HTML input type when not in multiline mode.
+     *
+     * @default 'text'
+     */
+    inputType?: TInlineEditInputType;
+    /**
+     * Surface a loading affordance (CSS class hook) on the root while
+     * an async `validate` Promise is in flight. The component sets
+     * `aria-busy="true"` regardless — this prop only controls the
+     * visual hook.
+     *
+     * @default false
+     */
+    loadingOnConfirm?: boolean;
+    /**
+     * Render built-in action buttons (Edit / Confirm / Cancel) next to
+     * the component.
+     *
+     * When `false` (default), only keyboard shortcuts are available:
+     * Enter to confirm, Escape to cancel, click on the display to edit.
+     *
+     * When `true`, three icon buttons are rendered:
+     * - **Edit** — visible in display mode, enters edit mode on click.
+     * - **Confirm** — visible in edit mode, commits the draft on click.
+     * - **Cancel** — visible in edit mode, discards the draft on click.
+     *
+     * The `disabled` prop also disables all three buttons.
+     *
+     * @default false
+     */
+    showActions?: boolean;
+}
+/**
+ * Emits for `<OrigamInlineEdit>`.
+ */
+export interface IInlineEditEmits {
+    /** Final value after successful validation. Same shape as input. */
+    (e: 'update:modelValue', value: string | number): void;
+    /** Editor entered edit mode (display → input transition). */
+    (e: 'edit'): void;
+    /** Editor exited via cancel — the draft was discarded. */
+    (e: 'cancel'): void;
+    /**
+     * Confirmation attempt — fires AFTER validation passes, BEFORE
+     * `update:modelValue`. Consumers can intercept the value for
+     * server-side persistence; the v-model is updated regardless.
+     */
+    (e: 'confirm', value: string | number): void;
+    /** Validator returned an error message (sync or async). */
+    (e: 'validate-error', message: string): void;
+}
+/**
+ * Bindings exposed by the scoped `#display` slot. Consumers use these
+ * to drive any custom affordance (heading, badge, …) into edit mode.
+ */
+export interface IInlineEditDisplaySlotBindings {
+    /** Current value (already coerced to string). */
+    value: string;
+    /** Switches the component into edit mode. */
+    edit: () => void;
+    /** True when the value is empty / nullish — drives placeholder styling. */
+    isEmpty: boolean;
+    /** Resolved placeholder string (with sane fallback). */
+    placeholder: string;
+    /** Mirrors the `disabled` prop, for visual handling. */
+    disabled: boolean;
+}
+/**
+ * Bindings exposed by the scoped `#edit` slot. Consumers use these to
+ * render a fully custom input layout while keeping the same state
+ * machine.
+ */
+export interface IInlineEditEditSlotBindings {
+    /** Draft value (two-way; mutate to feed the validator). */
+    value: string;
+    /** Update the draft from the slot. */
+    setValue: (next: string) => void;
+    /** Run the validator and, if it passes, commit the draft. */
+    confirm: () => void;
+    /** Discard the draft and return to display mode. */
+    cancel: () => void;
+    /** Current validation error (null when no error). */
+    error: string | null;
+    /** True while an async validator is in flight. */
+    isPending: boolean;
+}
+/**
+ * Bindings exposed by the scoped `#actions` slot — typically used to
+ * render visible confirm / cancel buttons (X / ✓).
+ */
+export interface IInlineEditActionsSlotBindings {
+    /** Run the validator and commit if it passes. */
+    confirm: () => void;
+    /** Discard the draft and return to display mode. */
+    cancel: () => void;
+    /** True while an async validator is in flight. */
+    isPending: boolean;
+}
+/**
+ * Slot signatures for `<OrigamInlineEdit>`.
+ */
+export interface IInlineEditSlots {
+    display?: (bindings: IInlineEditDisplaySlotBindings) => any;
+    edit?: (bindings: IInlineEditEditSlotBindings) => any;
+    actions?: (bindings: IInlineEditActionsSlotBindings) => any;
+}
+/**
+ * Options for the `useInlineEdit` composable.
+ */
+export interface IUseInlineEditOptions {
+    /** Sync or async validator — see `TInlineEditValidator`. */
+    validate?: TInlineEditValidator;
+    /**
+     * Strip surrounding whitespace before running the validator and
+     * emitting the new value.
+     *
+     * @default true
+     */
+    trim?: boolean;
+    /**
+     * Called when the draft is committed. Use this when the composable
+     * is consumed outside the SFC's emit pipeline (e.g. inside a
+     * unit-test harness or a wrapper composable).
+     */
+    onConfirm?: (value: string) => void;
+    /** Called when the draft is discarded. */
+    onCancel?: () => void;
+    /** Called when a validator returns an error message. */
+    onError?: (message: string) => void;
+}

package/dist/src/interfaces/ItemGroup/item-group.interface.d.ts

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps, IGroupItemProps, IGroupProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentEmits, ICommonsComponentProps, IGroupItemProps, IGroupProps, ITagProps } from '../../interfaces';
 /**
  * Props for `<OrigamItemGroup>` — the renderless selection container.
  * Mirrors `IBtnToggleProps` minus the visual mixins (this group has
@@ -24,3 +24,6 @@ export interface IItemGroupProps extends ICommonsComponentProps, ITagProps, IGro
 export interface IItemGroupItemProps extends ICommonsComponentProps, ITagProps, IGroupItemProps {
     tag?: string;
 }
+/** Emits fired by `<OrigamItemGroup>` — v-model on the active item set. */
+export interface IItemGroupEmits extends ICommonsComponentEmits {
+}