origam 2.3.0 → 2.5.0

package/dist/src/interfaces/Media/media-volume-control.interface.d.ts

@@ -0,0 +1,68 @@
+import type { ICommonsComponentProps } from '../../interfaces';
+/**
+ * Props for `<OrigamMediaVolumeControl>` — the mute / unmute button
+ * AND the YouTube-style vertical scrubber tooltip that opens on
+ * hover above it.
+ *
+ * Owns:
+ *  - the off/low/medium/high icon swap (driven by `volume` + `muted`),
+ *  - the resolvedVolume collapse (slider sits at 0 when muted=true so
+ *    the user can drag-up to unmute in a single gesture),
+ *  - the tooltip percentage formatter.
+ *
+ * Does NOT own the underlying `methods.toggleMute()` /
+ * `methods.setVolume()` calls — emits `update:muted` and
+ * `update:volume` so the parent stays the source of truth for
+ * media-side mutations.
+ */
+export interface IMediaVolumeControlProps extends ICommonsComponentProps {
+    /**
+     * Linear volume in `[0, 1]`. Typically `state.volume.value`.
+     * Required.
+     */
+    volume: number;
+    /**
+     * Whether the media is muted. When `true`, the slider collapses
+     * to 0 (resolvedVolume rule) and the icon becomes VOLUME_OFF.
+     * Required.
+     */
+    muted: boolean;
+    /**
+     * `aria-label` rendered on the toggle button when the media is
+     * NOT muted (clicking will mute). Already-translated. Required.
+     */
+    muteLabel: string;
+    /**
+     * `aria-label` rendered on the toggle button when the media IS
+     * muted (clicking will unmute). Already-translated. Required.
+     */
+    unmuteLabel: string;
+    /**
+     * `aria-label` rendered on the vertical scrubber inside the
+     * tooltip. Already-translated. Required.
+     */
+    volumeLabel: string;
+    /**
+     * Optional `data-cy` prefix used on the toggle button. The
+     * tooltip wrapper + scrubber expose their own selectors via
+     * convention (`${dataCy}-wrapper`, `${dataCy}-scrubber`).
+     *
+     * @default 'origam-media-volume-control'
+     */
+    dataCy?: string;
+}
+/**
+ * Emits surfaced by `<OrigamMediaVolumeControl>`. The atom does NOT
+ * call `methods.*` directly; the parent owns the media-side
+ * mutations.
+ */
+export interface IMediaVolumeControlEmits {
+    /** The mute toggle button was clicked. Payload is the proposed
+     *  new muted state (i.e. `!muted`). */
+    (e: 'update:muted', muted: boolean): void;
+    /** The vertical scrubber moved. Payload is the new linear
+     *  volume in `[0, 1]`. The parent must call `setVolume()` AND
+     *  toggle mute as appropriate (rising from 0 → unmute, falling
+     *  to 0 → mute). */
+    (e: 'update:volume', volume: number): void;
+}

package/dist/src/interfaces/Menu/menu.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IListItemProps, IListProps, IOverlayProps } from '../../interfaces';
+import type { ICommonsComponentEmits, IListItemProps, IListProps, IOverlayProps } from '../../interfaces';
 export interface IMenuProvide {
     register(): void;
     unregister(): void;
@@ -7,3 +7,9 @@ export interface IMenuProvide {
 export interface IMenuProps extends IOverlayProps, IListProps, IListItemProps {
     id?: string;
 }
+/** Emits fired by `<OrigamMenu>` — v-model on the open state plus the
+ *  native `contextmenu` bubble forwarded for parents that want to
+ *  show their own context menu instead. */
+export interface IMenuEmits extends ICommonsComponentEmits {
+    (e: 'contextmenu', event: MouseEvent): void;
+}

package/dist/src/interfaces/NumberField/number-field.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IAdjacentInnerProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldEmits, IFieldProps, IFieldSlots, IInputEmits, IInputProps, IInputSlots, IMarginProps, IPaddingProps, IRoundedProps, IVariantProps } from "../../interfaces";
+import type { IFieldEmits, IFieldProps, IFieldSlots, IInputEmits, IInputProps, IInputSlots, IVariantProps } from "../../interfaces";
 import type { TIcon } from "../../types";
-export interface INumberFieldProps extends ICommonsComponentProps, IColorProps, IDensityProps, IFieldProps, IInputProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IVariantProps, IAdjacentInnerProps {
+export interface INumberFieldProps extends IFieldProps, IInputProps, IVariantProps {
     autofocus?: boolean;
     placeholder?: string;
     persistentPlaceholder?: boolean;

package/dist/src/interfaces/NumberFormat/number-format.interface.cjs

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

package/dist/src/interfaces/NumberFormat/number-format.interface.d.ts

@@ -0,0 +1,161 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { TNumberFormatCompactDisplay, TNumberFormatCurrencyDisplay, TNumberFormatFormat, TNumberFormatLocale, TNumberFormatNotation, TNumberFormatSignDisplay, TNumberFormatUnitDisplay, TNumberFormatUseGrouping } from '../../types';
+/**
+ * Props for `<OrigamNumberFormat>` — pure-display i18n number renderer
+ * powered by `Intl.NumberFormat` (zero external dep).
+ *
+ * The component owns NO state: it transforms `value` through the
+ * resolved `Intl` instance and emits the result into a `<tag>` element
+ * (default `<span>`). Consumers who want to override the rendering
+ * granularly use the scoped `#default` slot which exposes
+ * `{ formatted, parts, value }`.
+ */
+export interface INumberFormatProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * Number to render. Strings are parsed via `Number()` — callers can
+     * pass a stringified BigInt-like to preserve precision before
+     * coercion (the actual formatting still goes through `Number`, so
+     * values beyond `Number.MAX_SAFE_INTEGER` may lose accuracy).
+     */
+    value: number | string;
+    /**
+     * High-level format dialect — see `TNumberFormatFormat`.
+     *
+     * @default 'decimal'
+     */
+    format?: TNumberFormatFormat;
+    /**
+     * BCP-47 locale tag (or array, for fallback chains). The literal
+     * string `'auto'` triggers the runtime resolution chain (`<html
+     * lang>` → `navigator.language` → `'en-US'`).
+     *
+     * @default 'auto'
+     */
+    locale?: TNumberFormatLocale;
+    /**
+     * ISO 4217 currency code. Required when `format === 'currency'`; we
+     * fall back to `'USD'` rather than throwing so storybook controls
+     * remain forgiving.
+     *
+     * @default 'USD' (only when format === 'currency')
+     */
+    currency?: string;
+    /**
+     * Currency-symbol rendering — `'symbol'` (`$`), `'narrowSymbol'`
+     * (`$` instead of `US$`), `'code'` (`USD`) or `'name'`
+     * (`US dollar`).
+     *
+     * @default 'symbol'
+     */
+    currencyDisplay?: TNumberFormatCurrencyDisplay;
+    /**
+     * Sanctioned unit identifier (e.g. `'kilometer-per-hour'`,
+     * `'celsius'`, `'liter'`). Required when `format === 'unit'`. The
+     * full ECMAScript-sanctioned list is exposed under
+     * `Intl.supportedValuesOf('unit')` at runtime.
+     */
+    unit?: string;
+    /**
+     * Unit-label rendering — `'short'` (`km/h`), `'long'`
+     * (`kilometers per hour`) or `'narrow'` (`kph`).
+     *
+     * @default 'short'
+     */
+    unitDisplay?: TNumberFormatUnitDisplay;
+    /**
+     * Raw `notation` override. Auto-set to `'compact'` when `format ===
+     * 'compact'`, to `'scientific'` / `'engineering'` for the matching
+     * formats. Explicit values still win — useful for `format:
+     * 'decimal'` with `notation: 'scientific'`.
+     */
+    notation?: TNumberFormatNotation;
+    /**
+     * Compact-notation rendering — `'short'` (`1M`) or `'long'`
+     * (`1 million`). Only honoured when `notation === 'compact'`.
+     *
+     * @default 'short'
+     */
+    compactDisplay?: TNumberFormatCompactDisplay;
+    /** Minimum digits after the decimal point. */
+    minimumFractionDigits?: number;
+    /** Maximum digits after the decimal point. */
+    maximumFractionDigits?: number;
+    /** Minimum significant digits (mutually exclusive with fraction digits). */
+    minimumSignificantDigits?: number;
+    /** Maximum significant digits (mutually exclusive with fraction digits). */
+    maximumSignificantDigits?: number;
+    /**
+     * Thousands-separator behaviour. `true` / `'auto'` keep the locale
+     * default, `false` removes them, `'always'` forces them on, `'min2'`
+     * only renders them when the integer part has at least 2 groups.
+     *
+     * @default true
+     */
+    useGrouping?: TNumberFormatUseGrouping;
+    /**
+     * Sign-display strategy. `'auto'` (default — only negatives),
+     * `'always'`, `'except-zero'`, `'negative'`, `'never'`.
+     *
+     * @default 'auto'
+     */
+    signDisplay?: TNumberFormatSignDisplay;
+}
+/**
+ * Bindings exposed by the scoped `#default` slot. Consumers use these
+ * to highlight specific parts of the formatted output (currency symbol,
+ * decimal separator, …) without re-running `Intl.NumberFormat`
+ * themselves.
+ */
+export interface INumberFormatScopedSlotBindings {
+    /** The locale-formatted string, ready to render. */
+    formatted: string;
+    /** The structured parts (`Intl.NumberFormatPart[]`). */
+    parts: Intl.NumberFormatPart[];
+    /** The numeric value after string-to-number coercion. */
+    value: number;
+}
+/**
+ * Slot signatures for `<OrigamNumberFormat>`.
+ */
+export interface INumberFormatSlots {
+    /**
+     * Custom render override. Scoped — receives the resolved value plus
+     * the structured parts so consumers can paint individual segments.
+     */
+    default?: (bindings: INumberFormatScopedSlotBindings) => any;
+}
+/**
+ * Options accepted by `useNumberFormat`. Mirrors the public props of
+ * `<OrigamNumberFormat>` minus the wiring concerns (`tag`, `class`,
+ * `style`).
+ */
+export interface IUseNumberFormatOptions {
+    /** Same semantics as `INumberFormatProps.format`. */
+    format?: TNumberFormatFormat;
+    /** Same semantics as `INumberFormatProps.locale`. */
+    locale?: TNumberFormatLocale;
+    /** Same semantics as `INumberFormatProps.currency`. */
+    currency?: string;
+    /** Same semantics as `INumberFormatProps.currencyDisplay`. */
+    currencyDisplay?: TNumberFormatCurrencyDisplay;
+    /** Same semantics as `INumberFormatProps.unit`. */
+    unit?: string;
+    /** Same semantics as `INumberFormatProps.unitDisplay`. */
+    unitDisplay?: TNumberFormatUnitDisplay;
+    /** Same semantics as `INumberFormatProps.notation`. */
+    notation?: TNumberFormatNotation;
+    /** Same semantics as `INumberFormatProps.compactDisplay`. */
+    compactDisplay?: TNumberFormatCompactDisplay;
+    /** Same semantics as `INumberFormatProps.minimumFractionDigits`. */
+    minimumFractionDigits?: number;
+    /** Same semantics as `INumberFormatProps.maximumFractionDigits`. */
+    maximumFractionDigits?: number;
+    /** Same semantics as `INumberFormatProps.minimumSignificantDigits`. */
+    minimumSignificantDigits?: number;
+    /** Same semantics as `INumberFormatProps.maximumSignificantDigits`. */
+    maximumSignificantDigits?: number;
+    /** Same semantics as `INumberFormatProps.useGrouping`. */
+    useGrouping?: TNumberFormatUseGrouping;
+    /** Same semantics as `INumberFormatProps.signDisplay`. */
+    signDisplay?: TNumberFormatSignDisplay;
+}

package/dist/src/interfaces/OtpInputField/otp-input-field.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IFieldEmits, IFieldProps, IFieldSlots, IFocusProps, IInputEmits, IInputProps, IInputSlots, IRoundedProps, IVariantProps } from "../../interfaces";
+import type { IFieldEmits, IFieldProps, IFieldSlots, IInputEmits, IInputProps, IInputSlots, IVariantProps } from "../../interfaces";
 import type { TOtpInputFieldType } from "../../types";
-export interface IOtpInputFieldProps extends ICommonsComponentProps, IColorProps, IDensityProps, IDimensionProps, IFieldProps, IInputProps, IRoundedProps, IElevationProps, IVariantProps, IFocusProps {
+export interface IOtpInputFieldProps extends IFieldProps, IInputProps, IVariantProps {
     autofocus?: boolean;
     divider?: string;
     focusAll?: boolean;

package/dist/src/interfaces/Overlay/overlay-scrim.interface.d.ts

@@ -1,7 +1,14 @@
-import type { ICommonsComponentProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
+import type { IClickEmits, ICommonsComponentProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
 export interface IOverlayScrimProps extends ICommonsComponentProps, ITagProps, ITransitionComponentProps, IScrimProps {
     active?: boolean;
 }
 export interface IScrimProps {
     scrim?: boolean | string;
 }
+/** Emits fired by `<OrigamOverlayScrim>` — click + pointer hover events
+ *  surface to the parent overlay (so it can close on backdrop click
+ *  or pause its auto-close timer while the pointer is over the scrim). */
+export interface IOverlayScrimEmits extends IClickEmits {
+    (e: 'mouseenter', event: MouseEvent): void;
+    (e: 'mouseleave', event: MouseEvent): void;
+}

package/dist/src/interfaces/Overlay/overlay.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActivatorProps, ICommonsComponentProps, IDimensionProps, ILazyProps, ILocationStrategyProps, IScrimProps, IScrollStrategyProps, ITransitionComponentProps } from '../../interfaces';
+import type { IActivatorProps, IClickOutsideEmits, ICommonsComponentEmits, ICommonsComponentProps, IDimensionProps, ILazyProps, ILocationStrategyProps, IScrimProps, IScrollStrategyProps, ITransitionComponentProps } from '../../interfaces';
 export interface IOverlayProps extends ICommonsComponentProps, IDimensionProps, IActivatorProps, ILocationStrategyProps, IScrollStrategyProps, ILazyProps, ITransitionComponentProps, IScrimProps {
     absolute?: boolean;
     attach?: boolean | string | Element;
@@ -12,3 +12,10 @@ export interface IOverlayProps extends ICommonsComponentProps, IDimensionProps,
     disableGlobalStack?: boolean;
     persistent?: boolean;
 }
+/** Emits fired by `<OrigamOverlay>` — v-model on the open state, outside
+ *  click, transition lifecycle hooks, and keyboard bubble. */
+export interface IOverlayEmits extends ICommonsComponentEmits, IClickOutsideEmits {
+    (e: 'afterEnter'): void;
+    (e: 'afterLeave'): void;
+    (e: 'keydown', event: KeyboardEvent): void;
+}

package/dist/src/interfaces/Pagination/pagination.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, ISizeProps, ITagProps } from "../../interfaces";
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, ISizeProps, ITagProps } from "../../interfaces";
 import type { TIcon } from "../../types";
 export interface IPaginationProps extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, ISizeProps, IDensityProps {
     start?: number;
@@ -57,3 +57,11 @@ export interface IPaginationProps extends ICommonsComponentProps, ITagProps, ICo
      */
     nextText?: string;
 }
+/** Emits fired by `<OrigamPagination>` — current page v-model + the four
+ *  navigation shortcuts (first / prev / next / last). */
+export interface IPaginationEmits extends ICommonsComponentEmits {
+    (e: 'first', value: number): void;
+    (e: 'prev', value: number): void;
+    (e: 'next', value: number): void;
+    (e: 'last', value: number): 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 {
+}