origam 2.2.1 → 2.5.0

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

@@ -0,0 +1,60 @@
+import type { TIcon, TIntent } from '../../types';
+/**
+ * Action button descriptor attached to a snackbar stack item.
+ *
+ * Surfaces in the rendered snackbar as a button — clicking it invokes
+ * `handler` and (by default) dismisses the item. Set `keepOpen: true`
+ * to keep the snackbar visible after the click (e.g. for a multi-step
+ * confirmation).
+ */
+export interface ISnackbarGroupItemAction {
+    label: string;
+    handler: () => void;
+    intent?: TIntent;
+    keepOpen?: boolean;
+}
+/**
+ * Options accepted by `useSnackbarGroup().notify(opts)`.
+ *
+ * Every field is optional except that the resulting item must surface
+ * SOMETHING to the user — either a `title`, a `message`, or both.
+ * The composable does not enforce this at runtime; emitting an empty
+ * item is a no-op but is allowed for programmatic flexibility.
+ */
+export interface ISnackbarGroupItemOptions {
+    /** Bold first line. Useful for short labels (e.g. "Saved"). */
+    title?: string;
+    /** Body text under the title (or sole line when `title` absent). */
+    message?: string;
+    /**
+     * Semantic intent driving icon defaults, `role=status|alert`, and
+     * surface coloring. Defaults to `info`.
+     */
+    intent?: TIntent;
+    /**
+     * Auto-dismiss timeout in milliseconds. Overrides the stack-level
+     * `defaultDuration`. Pass `0` to make the item sticky (no auto
+     * dismiss — user has to dismiss it manually or programmatically).
+     */
+    duration?: number;
+    /**
+     * Prepend icon override. Defaults to the per-intent icon
+     * (`mdiCheckCircle` for success, `mdiAlertCircle` for danger, …).
+     */
+    icon?: TIcon;
+    /** Optional action buttons rendered in the snackbar footer. */
+    actions?: ReadonlyArray<ISnackbarGroupItemAction>;
+    /** Whether to show the close (`X`) button. Default `true`. */
+    dismissible?: boolean;
+    /** Callback fired once the item leaves the stack. */
+    onDismiss?: () => void;
+}
+/**
+ * Materialised item held inside the stack store. Adds the auto-generated
+ * `id` to the option shape so callers can address the item afterwards
+ * (`dismiss(id)`).
+ */
+export interface ISnackbarGroupItem extends ISnackbarGroupItemOptions {
+    id: string;
+    createdAt: number;
+}

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

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

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

@@ -0,0 +1,60 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../types';
+/**
+ * Props for `<OrigamSnackbarGroup>` — a multi-toast container that
+ * orchestrates a queue of `OrigamSnackbar` instances driven through
+ * the `useSnackbarGroup({ id })` composable.
+ *
+ * The component itself owns NO local visual state — every notification
+ * is added via `notify()` and removed via `dismiss()` or auto-timeout.
+ * The component subscribes to its registered stack `id` and re-renders
+ * when the underlying `items` ref changes.
+ */
+export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * Identifier of the stack this container renders. Pair with
+     * `useSnackbarGroup({ id })` to spawn items into the same stack.
+     * Multiple stacks can coexist (e.g. a global one + a per-region
+     * one) — each one is keyed independently.
+     *
+     * @default 'default'
+     */
+    id?: string;
+    /**
+     * Anchor location on the viewport. Drives both the absolute
+     * positioning (top/bottom + left/right/center pinning) and the
+     * `direction` default.
+     *
+     * @default 'bottom-right'
+     */
+    location?: TSnackbarGroupLocation;
+    /**
+     * Maximum number of items rendered concurrently. When `notify()`
+     * pushes a new item past `max`, the oldest item in the stack is
+     * evicted FIFO (its `onDismiss` callback still fires).
+     *
+     * @default 5
+     */
+    max?: number;
+    /**
+     * Default auto-dismiss timeout (ms) applied to items that do not
+     * supply their own `duration`. Pass `0` to make all items sticky
+     * by default.
+     *
+     * @default 5000
+     */
+    defaultDuration?: number;
+    /**
+     * Gap between stacked items (CSS dimension — `'12px'`, `'1rem'`,
+     * `8`, …).
+     *
+     * @default '12px'
+     */
+    spacing?: string | number;
+    /**
+     * Stacking order. When unset, defaults to `'top-down'` for
+     * `top-*` locations and `'bottom-up'` for `bottom-*` locations
+     * — matching the natural reading direction of fresh items.
+     */
+    direction?: TSnackbarGroupDirection;
+}

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

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

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

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

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

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

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

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

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

@@ -1,6 +1,10 @@
-import type { IActiveProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, IInputProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ISelectionControlProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IBorderProps, IClickLabelEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IHoverProps, IIndeterminateEmits, IInputProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ISelectionControlProps, ITagProps } from '../../interfaces';
 export interface ISwitchProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IInputProps, ISelectionControlProps, ILoaderProps, IColorProps, IDensityProps, IElevationProps, IActiveProps, IHoverProps {
     indeterminate?: boolean;
     inset?: boolean;
     flat?: boolean;
 }
+/** Emits fired by `<OrigamSwitch>` — v-model + focus + indeterminate
+ *  (three-state) + label click. */
+export interface ISwitchEmits extends ICommonsComponentEmits, IFocusEmits, IIndeterminateEmits, IClickLabelEmits {
+}

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

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

package/dist/src/interfaces/Tabs/tab-panel.interface.cjs

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

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

@@ -0,0 +1,12 @@
+import type { ICommonsComponentProps, IGroupItemProps, ILazyProps, ITagProps } from '../../interfaces';
+/**
+ * Props for `<OrigamTabPanel>` — a single tab content panel.
+ *
+ *  - `value`   identifier matching the sibling `<OrigamTab>`.
+ *  - `eager`   if `false` (default) the panel content is mounted
+ *              only when first activated and kept alive afterwards.
+ *              If `true`, the content is mounted from the start.
+ */
+export interface ITabPanelProps extends ICommonsComponentProps, ITagProps, IGroupItemProps, ILazyProps {
+    tag?: string;
+}

package/dist/src/interfaces/Tabs/tab-panels.interface.cjs

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

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

@@ -0,0 +1,31 @@
+import type { ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IGroupProps, ITagProps } from '../../interfaces';
+import type { ComputedRef, Ref } from 'vue';
+/**
+ * Props for `<OrigamTabPanels>` — the content area that mirrors the
+ * tablist selection. Uses its own `useGroup` registration (keyed on
+ * `ORIGAM_TAB_PANELS_KEY`) so the two siblings can be rendered as
+ * peers under any parent without sharing the tablist's ARIA role
+ * (`role="tablist"` vs `role` -less for the panels container).
+ *
+ *  - `transition`   transition name passed to `<OrigamTransition>`.
+ *                   Default is `'fade'`. Pass `false` to disable.
+ *  - `swipeable`    enables horizontal touch swipe between panels
+ *                   (delegated to `vTouch`). Off by default.
+ */
+export interface ITabPanelsProps extends ICommonsComponentProps, ITagProps, IDirectionProps, IGroupProps {
+    tag?: string;
+    transition?: string | false;
+    swipeable?: boolean;
+}
+/**
+ * Context exposed by `<OrigamTabPanels>` to descendant panels —
+ * lets `<OrigamTabPanel>` read transition + reverse direction
+ * without re-declaring the same props at every level.
+ */
+export interface ITabPanelsProvide {
+    transition: ComputedRef<string | false>;
+    isReversed: Ref<boolean>;
+}
+/** Emits fired by `<OrigamTabPanels>` — v-model mirrors the parent tablist. */
+export interface ITabPanelsEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/Tabs/tab.interface.cjs

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

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

@@ -0,0 +1,18 @@
+import type { ICommonsComponentProps, IGroupItemProps, ITagProps } from '../../interfaces';
+import type { TIcon } from '../../types';
+/**
+ * Props for `<OrigamTab>` — a single registered tab inside an
+ * `<OrigamTabs>` tablist.
+ *
+ * The slot scope is the default text label. Optional `icon` /
+ * `appendIcon` render at the leading / trailing edge respectively.
+ *
+ * ARIA wiring (`role="tab"`, `aria-selected`, `aria-controls`, `id`,
+ * `tabindex`) is computed inside the component — consumers only
+ * provide `value` (the canonical identifier) and `disabled`.
+ */
+export interface ITabProps extends ICommonsComponentProps, ITagProps, IGroupItemProps {
+    tag?: string;
+    icon?: TIcon;
+    appendIcon?: TIcon;
+}

package/dist/src/interfaces/Tabs/tabs.interface.cjs

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

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

@@ -0,0 +1,29 @@
+import type { IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IGroupProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { TTabVariant } from '../../types';
+/**
+ * Props for `<OrigamTabs>` — a stateful tablist container.
+ *
+ * Mirrors `IBtnToggleProps` (re-uses `useGroup`) plus three tab-only
+ * facets:
+ *  - `variant`   visual treatment (`default`, `pills`, `underline`).
+ *  - `fixed`     equal-width distribution of children (justify-evenly).
+ *  - `centered`  centers the tablist within the container.
+ *
+ * `direction` is inherited from `IDirectionProps` and switches the
+ * tablist from horizontal (default) to vertical column layout. ARIA
+ * `aria-orientation` follows the same value.
+ *
+ * `mandatory` is forced to `true` by the component's `withDefaults`
+ * — Material/WAI-ARIA conventions say a tablist always has exactly
+ * one selected tab. Consumers can still pass `:mandatory="false"` to
+ * opt-out (rare).
+ */
+export interface ITabsProps extends ICommonsComponentProps, ITagProps, IDirectionProps, IDensityProps, IRoundedProps, IColorProps, IBgColorProps, IGroupProps {
+    tag?: string;
+    variant?: TTabVariant;
+    fixed?: boolean;
+    centered?: boolean;
+}
+/** Emits fired by `<OrigamTabs>` — v-model on the active tab. */
+export interface ITabsEmits extends ICommonsComponentEmits {
+}

package/dist/src/interfaces/TextField/text-field.interface.d.ts

@@ -1,5 +1,5 @@
 import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldEmits, IFieldProps, IFieldSlots, IInputEmits, IInputProps, IInputSlots, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
-import type { TTextFieldType } from '../../types';
+import type { TMask, TTextFieldType } from '../../types';
 export interface ITextFieldProps extends ICommonsComponentProps, IColorProps, IDensityProps, IFieldProps, IInputProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps {
     autofocus?: boolean;
     counter?: boolean | number | string;
@@ -10,6 +10,13 @@ export interface ITextFieldProps extends ICommonsComponentProps, IColorProps, ID
     role?: string;
     type?: TTextFieldType;
     modelModifiers?: string | boolean;
+    /**
+     * Mask spec — built-in preset key (`'phone:fr'`, …), a
+     * raw pattern (`'(##) ###-####'`) or a full options object.
+     * When set, `v-model` exposes the UNMASKED value; the DOM
+     * input displays the formatted (masked) string.
+     */
+    mask?: TMask;
 }
 /**
  * Aggregate emits for `<OrigamTextField>` — re-exports field/input lifecycle
@@ -18,6 +25,19 @@ export interface ITextFieldProps extends ICommonsComponentProps, IColorProps, ID
 export interface ITextFieldEmits extends IFieldEmits, IInputEmits {
     (e: 'click:control', value: MouseEvent): void;
     (e: 'mousedown:control', value: MouseEvent): void;
+    /**
+     * Emitted on every input/paste when a mask is active.
+     * Carries the current validity status (pattern + validator).
+     */
+    (e: 'valid', value: boolean): void;
+    /**
+     * Emitted when every consumer slot of the mask has been
+     * filled. The unmasked value is provided for convenience.
+     */
+    (e: 'complete', value: {
+        complete: boolean;
+        unmasked: string;
+    }): void;
 }
 /**
  * Slot signatures for `<OrigamTextField>`. Extends field and input slots with

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

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

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

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

package/dist/src/interfaces/Textarea/textarea-rich.interface.cjs

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

package/dist/src/interfaces/Textarea/textarea-rich.interface.d.ts

@@ -0,0 +1,41 @@
+import type { TTextareaToolbarCommand } from '../../types';
+/**
+ * Returned shape of the `useTextareaRich` composable. Components consume
+ * the public surface (refs + handlers) to render the contenteditable
+ * editor and bind the toolbar.
+ */
+export interface IUseTextareaRichOptions {
+    /**
+     * Whether the editor surface is currently editable. Bound to the
+     * `contenteditable` attribute downstream.
+     */
+    readonly disabled: () => boolean;
+    /**
+     * Initial / external HTML value (already sanitised by the host
+     * component when running in `output="html"` mode).
+     */
+    readonly value: () => string;
+    /**
+     * Sanitised HTML emit handler. Fired whenever the editor mutates.
+     */
+    readonly onUpdate: (raw: string) => void;
+    /**
+     * Notified each time a toolbar command runs.
+     */
+    readonly onFormat: (command: TTextareaToolbarCommand, value?: string) => void;
+}
+/**
+ * Reactive state describing which toolbar commands are currently active
+ * at the caret position. Used by the toolbar to render the
+ * `aria-pressed` state and the visual active class.
+ */
+export interface ITextareaRichActiveState {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    code: boolean;
+    link: boolean;
+    listBullet: boolean;
+    listOrdered: boolean;
+    heading: 0 | 1 | 2 | 3;
+}

package/dist/src/interfaces/Textarea/textarea-toolbar.interface.cjs

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

package/dist/src/interfaces/Textarea/textarea-toolbar.interface.d.ts

@@ -0,0 +1,31 @@
+import type { TTextareaToolbarCommand, TTextareaToolbarPosition } from '../../types';
+import type { ITextareaRichActiveState } from './textarea-rich.interface';
+/**
+ * Props for the internal `<OrigamRichToolbar>` sub-component. Kept
+ * private to the package (exposed via the `OrigamTextareaField` slots)
+ * so we can iterate on the API without breaking external consumers.
+ */
+export interface IRichToolbarProps {
+    items: ReadonlyArray<TTextareaToolbarCommand>;
+    active: ITextareaRichActiveState;
+    position?: TTextareaToolbarPosition;
+    disabled?: boolean;
+}
+/**
+ * Emits the toolbar surfaces upwards. `format` carries the command id
+ * and, for link insertion, the URL the user typed.
+ */
+export interface IRichToolbarEmits {
+    (e: 'format', command: TTextareaToolbarCommand, value?: string): void;
+}
+/**
+ * Public payload exposed by the `#toolbar` slot of `OrigamTextareaField`.
+ * Consumers can render a fully custom toolbar while still reusing the
+ * core formatting machinery.
+ */
+export interface ITextareaToolbarSlotProps {
+    format: (command: TTextareaToolbarCommand, value?: string) => void;
+    isFormat: (command: TTextareaToolbarCommand) => boolean;
+    items: ReadonlyArray<TTextareaToolbarCommand>;
+    active: ITextareaRichActiveState;
+}