origam 0.3.10 → 2.3.0

package/dist/src/interfaces/DefaultProvider/default-provider.interface.d.ts

@@ -0,0 +1,59 @@
+import type { ICommonsComponentProps } from '../../interfaces';
+/**
+ * Defaults map shape consumed by `<OrigamDefaultsProvider>` and resolved
+ * by `useDefaults()` in components.
+ *
+ * - `global` keys apply to every component in the subtree.
+ * - Any other top-level key is matched against the component's name
+ *   (kebab-case `getCurrentInstanceName()`), so `OrigamBtn`'s instance
+ *   name `origam-btn` reads from `defaults['origam-btn']`.
+ *
+ * Example
+ * ```ts
+ * <OrigamDefaultsProvider :defaults="{
+ *   global:        { density: 'comfortable' },
+ *   'origam-btn':  { color:   'primary' },
+ *   'origam-chip': { variant: 'outlined' }
+ * }">
+ *   ...
+ * </OrigamDefaultsProvider>
+ * ```
+ */
+export interface IDefault {
+    global?: Record<string, unknown>;
+    [key: string]: Record<string, unknown> | undefined;
+}
+export interface IDefaultProviderProps extends ICommonsComponentProps {
+    /** Map of defaults keyed by `global` or component name. */
+    defaults?: IDefault;
+    /**
+     * When `true`, parent defaults are passed through unchanged — useful to
+     * temporarily disable an outer DefaultsProvider without unmounting it.
+     */
+    disabled?: boolean;
+    /**
+     * When set, parent defaults are NOT inherited; the subtree starts from
+     * this provider's defaults only. The value is opaque (string/number) but
+     * can be used to track resets in DevTools.
+     */
+    reset?: string | number;
+    /**
+     * Marks the provider as a root scope. Equivalent to `reset` in behaviour
+     * (no parent inheritance) but communicates a different intent (this is
+     * the top of a defaults tree, not a mid-tree override).
+     */
+    root?: string | number;
+    /**
+     * When `true`, parent defaults are not merged in — the subtree only
+     * sees this provider's defaults. Same as `reset` but expressed
+     * declaratively without needing a discriminator value.
+     */
+    scoped?: boolean;
+}
+/**
+ * Slots for `<OrigamDefaultsProvider>`. The component is structurally
+ * transparent (no rendered chrome), so `default` carries the subtree.
+ */
+export interface IDefaultProviderSlots {
+    default(): unknown;
+}

package/dist/src/interfaces/Dialog/dialog.interface.d.ts

@@ -1,6 +1,8 @@
 import type { ICardProps, ICommonsComponentProps, IOverlayProps, IStatusProps } from '../../interfaces';
+import type { TSize } from '../../types';
 export interface IDialogProps extends ICommonsComponentProps, IOverlayProps, ICardProps, IStatusProps {
     fullscreen?: boolean;
     retainFocus?: boolean;
     scrollable?: boolean;
+    size?: TSize;
 }

package/dist/src/interfaces/Divider/divider.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IColorProps, ICommonsComponentProps, IDirectionProps, IMarginProps } from '../../interfaces';
-export interface IDividerProps extends ICommonsComponentProps, IColorProps, IMarginProps, IDirectionProps {
+import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDirectionProps, IMarginProps } from '../../interfaces';
+export interface IDividerProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IMarginProps, IDirectionProps {
     inset?: boolean;
     length?: number | string;
     thickness?: number | string;

package/dist/src/interfaces/Drawer/drawer.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, ILayoutItemProps, IMarginProps, IPaddingProps, IRoundedProps, IScrimProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
-export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorderProps, IElevationProps, ILayoutItemProps, IRoundedProps, IColorProps, IDensityProps, IPaddingProps, IMarginProps, ITransitionComponentProps, IScrimProps {
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, ILayoutItemProps, IMarginProps, IPaddingProps, IRoundedProps, IScrimProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
+export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorderProps, IElevationProps, ILayoutItemProps, IRoundedProps, IColorProps, IBgColorProps, IDensityProps, IPaddingProps, IMarginProps, ITransitionComponentProps, IScrimProps, IActiveProps, IHoverProps {
     disableResizeWatcher?: boolean;
     disableRouteWatcher?: boolean;
     expandOnHover?: boolean;
@@ -12,4 +12,39 @@ export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorder
     touchless?: boolean;
     width?: number | string;
     sticky?: boolean;
+    /**
+     * Whether the drawer reserves space in the layout grid (PUSHES the
+     * adjacent toolbar / main / footer / etc.) or overlays them.
+     *
+     *   • `true`  → drawer registers with the layout's reserved-space
+     *               system. Toolbar / main / footer adjacent to the
+     *               drawer offset themselves accordingly.
+     *   • `false` → drawer paints over the surrounding content (no
+     *               reservation, no offset).
+     *   • `null` (default) → derived from `permanent`: permanent
+     *               drawers push by default, temporary drawers don't.
+     *
+     * Declared as `boolean | null` (NOT `boolean | undefined`) because
+     * Vue's prop coercion turns absent boolean attributes into `false`,
+     * which would silently disable the push heuristic. `null` survives
+     * coercion and lets the runtime fall back to the permanent-derived
+     * default.
+     */
+    push?: boolean | null;
+    /**
+     * Whether the drawer slots BELOW any top-anchored layout item
+     * (typically the AppBar) instead of extending the full height of
+     * the layout.
+     *
+     *   • `true`  → drawer's effective layout order is bumped after
+     *               top items, so the drawer's top edge starts where
+     *               the AppBar's bottom edge ends.
+     *   • `false` → drawer keeps order 0, extending full height and
+     *               pushing the AppBar to its right (or claiming the
+     *               full left lane regardless of top items).
+     *   • `null` (default) → resolved from the HTML declaration order.
+     *               AppBar before Drawer → drawer below.
+     *               Drawer before AppBar → drawer full-height.
+     */
+    clipped?: boolean | null;
 }

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

@@ -1,5 +1,5 @@
 import { Component } from 'vue';
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface IExpansionPanelContentProps extends IColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, ILazyProps, ILoaderProps {
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+export interface IExpansionPanelContentProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, ILazyProps, ILoaderProps {
     content?: string | Component;
 }

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

@@ -1,6 +1,6 @@
-import type { IAdjacentProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
-export interface IExpansionPanelHeaderProps extends IColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, IAdjacentProps, IRippleProps {
+export interface IExpansionPanelHeaderProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, IAdjacentProps, IRippleProps, IActiveProps, IHoverProps {
     expandIcon?: TIcon;
     collapseIcon?: TIcon;
     hideActions?: boolean;

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

@@ -1,3 +1,3 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IExpansionPanelContentProps, IExpansionPanelHeaderProps, IGroupItemProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface IExpansionPanelProps extends ITagProps, ICommonsComponentProps, IDensityProps, IColorProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, IRoundedProps, IGroupItemProps, IExpansionPanelHeaderProps, IExpansionPanelContentProps, ILazyProps, ILoaderProps {
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IExpansionPanelContentProps, IExpansionPanelHeaderProps, 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 {
 }

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

@@ -1,6 +1,6 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IExpansionPanelProps, IGroupProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IExpansionPanelProps, IGroupProps, IHoverProps, ILazyProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
-export interface IExpansionPanelsProps extends IColorProps, ITagProps, ICommonsComponentProps, IGroupProps, IDensityProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, ILazyProps, ILoaderProps, IElevationProps {
+export interface IExpansionPanelsProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IGroupProps, IDensityProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, ILazyProps, ILoaderProps, IElevationProps, IActiveProps, IHoverProps {
     flat?: boolean;
     items?: Array<IExpansionPanelProps>;
     accordion?: boolean;

package/dist/src/interfaces/Field/field.interface.d.ts

@@ -1,11 +1,20 @@
-import type { IAdjacentInnerProps, IColorProps, ICommonsComponentProps, IDensityProps, IFocusProps, ILoaderProps } from '../../interfaces';
-export interface IFieldProps extends ICommonsComponentProps, ILoaderProps, IColorProps, IAdjacentInnerProps, IFocusProps, IDensityProps {
-    active?: boolean;
+import type { IActiveEmits, IActiveProps, IAdjacentInnerEmits, IAdjacentInnerProps, IAdjacentInnerSlots, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IFocusProps, ILabelProps, ILoaderProps, IRoundedProps, ISizeProps, IVariantProps } from '../../interfaces';
+export interface IFieldProps extends ICommonsComponentProps, ILoaderProps, IColorProps, IBgColorProps, IAdjacentInnerProps, IFocusProps, IDensityProps, ILabelProps, IActiveProps, IVariantProps, IRoundedProps, IElevationProps, ISizeProps {
     centerAffix?: boolean;
     dirty?: boolean;
     disabled?: boolean;
-    error?: boolean;
+    /**
+     * Error state for the field.
+     *   - `boolean` — paints the `--error` modifier (rules-driven flow).
+     *   - `string`  — paints the modifier AND becomes the inline error
+     *     message rendered by consumers that opt-in (e.g. FileField's
+     *     dropzone). For consumers that don't read the string, the
+     *     truthy semantics still apply.
+     *   - `false` / omitted — no error.
+     */
+    error?: string | boolean;
     flat?: boolean;
+    inline?: boolean;
     label?: string;
     prefix?: string;
     suffix?: string;
@@ -14,3 +23,37 @@ export interface IFieldProps extends ICommonsComponentProps, ILoaderProps, IColo
     singleLine?: boolean;
     required?: boolean;
 }
+/**
+ * Aggregate of every emit a `<OrigamField>` is expected to relay. Bundles
+ * the focus, the v-model echo, the clear/click-inner variants, and the
+ * activation lifecycle so that consuming components (TextField,
+ * NumberField, PasswordField, etc.) can `defineEmits<IFieldEmits>()`
+ * without having to repeat the underlying signatures.
+ */
+export interface IFieldEmits extends IFocusEmits, ICommonsComponentEmits, IAdjacentInnerEmits, IActiveEmits {
+}
+/**
+ * Default slot props passed to the `<OrigamField>` default slot —
+ * downstream input components destructure these to wire up their native
+ * `<input>` element.
+ */
+export interface IFieldDefaultSlotProps {
+    id: string;
+    'aria-describedby': string;
+    isActive: boolean;
+    isFocused: boolean | undefined;
+    ref: HTMLElement | undefined;
+    onBlur: () => void;
+    onFocus: () => void;
+}
+/** Slot signatures for `<OrigamField>` (default + label/prefix/suffix). */
+export interface IFieldSlots extends IAdjacentInnerSlots {
+    default?: (props: {
+        class?: string | Array<string>;
+    } & IFieldDefaultSlotProps) => any;
+    loader?: () => any;
+    label?: (props: ILabelProps) => any;
+    floatingLabel?: (props: ILabelProps) => any;
+    prefix?: () => any;
+    suffix?: () => any;
+}

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

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

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

@@ -0,0 +1,21 @@
+import { IColorProps, ICommonsComponentProps } from '../../interfaces';
+export interface IFileFieldDragNDropItemProps extends ICommonsComponentProps {
+    file: File;
+    index: number;
+    progress?: number;
+    fileIcon?: string;
+    removeIcon?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    color?: IColorProps['color'];
+    showSize?: boolean | 1000 | 1024;
+}
+export interface IFileFieldDragNDropItemEmits {
+    (e: 'click:remove', value: {
+        file: File;
+        index: number;
+    }): void;
+}
+export interface IFileFieldDragNDropItemSlots {
+    default?: () => any;
+}

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

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

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

@@ -0,0 +1,21 @@
+import { IColorProps, ICommonsComponentProps } from '../../interfaces';
+export interface IFileFieldListItemProps extends ICommonsComponentProps {
+    file: File;
+    index: number;
+    progress?: number;
+    fileIcon?: string;
+    removeIcon?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    color?: IColorProps['color'];
+    showSize?: boolean | 1000 | 1024;
+}
+export interface IFileFieldListItemEmits {
+    (e: 'click:remove', value: {
+        file: File;
+        index: number;
+    }): void;
+}
+export interface IFileFieldListItemSlots {
+    default?: () => any;
+}

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

@@ -1,5 +1,5 @@
-import type { IBorderProps, IChipProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldProps, IInputProps, IMarginProps, IPaddingProps, IRoundedProps } from "../../interfaces";
-import type { TFile, TFileSize } from "../../types";
+import type { IBorderProps, IChipProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldEmits, IFieldProps, IFieldSlots, IInputEmits, IInputProps, IInputSlots, IMarginProps, IPaddingProps, IRoundedProps } from "../../interfaces";
+import type { TFile, TFileFieldDisplay, TFileSize } from "../../types";
 export interface IFileFieldProps extends ICommonsComponentProps, IColorProps, IDensityProps, IFieldProps, IInputProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps {
     chips?: boolean;
     counter?: boolean;
@@ -13,4 +13,88 @@ export interface IFileFieldProps extends ICommonsComponentProps, IColorProps, ID
     modelValue?: TFile;
     chipProps?: IChipProps;
     divider?: string;
+    iconColor?: string;
+    maxFileSize?: number;
+    dragndrop?: boolean;
+    dragndropIcon?: string;
+    fileIcon?: string;
+    removeIcon?: string;
+    downloadIcon?: string;
+    downloadable?: boolean;
+    progress?: Array<number>;
+    dropzoneTitle?: string;
+    dropzoneSubtitle?: string;
+    browseText?: string;
+    maxFileSizeErrorString?: string;
+    /**
+     * How a multi-file selection is rendered:
+     *   - `'list'`     (default) — vertical card stack under the field.
+     *   - `'chips'`    — each file as a closable `<OrigamChip>` inline.
+     *   - `'counter'`  — single text "{n} files" + an `<OrigamCounter>`.
+     *
+     * Single-file selection ignores this prop and always shows the file
+     * name with a paperclip prepend.
+     */
+    display?: TFileFieldDisplay;
+    /**
+     * Render the field as a large outlined drop-zone instead of an inline
+     * input. Equivalent to (and aliased by) the legacy `dragndrop` prop —
+     * keep both for backward-compat. When `true`, the wrapper accepts
+     * native drag-and-drop events, paints a `--dragging` modifier on
+     * dragover, and falls back to a click-to-browse interaction.
+     */
+    dropzone?: boolean;
+}
+export interface IFileFieldEmits extends IFieldEmits, IInputEmits {
+    (e: 'click:control', value: MouseEvent): void;
+    (e: 'mousedown:control', value: MouseEvent): void;
+    (e: 'click:remove', value: {
+        file: File;
+        index: number;
+    }): void;
+    (e: 'click:download', value: {
+        file: File;
+        index: number;
+    }): void;
+    (e: 'drop', value: {
+        files: Array<File>;
+        event: DragEvent;
+    }): void;
+    (e: 'error:max-size', value: {
+        files: Array<File>;
+        maxFileSize: number;
+        message: Array<string>;
+    }): void;
+}
+export interface IFileFieldSlots extends IFieldSlots, Omit<IInputSlots, 'default'> {
+    counter?: (data: {
+        counter: string;
+        value: string | number;
+        max?: string | number;
+    }) => any;
+    field?: (data: {
+        id: string;
+        isDisabled: boolean;
+        isDirty: boolean;
+        isValid: boolean;
+        isReadonly: boolean;
+    }) => any;
+    dropzone?: (data: {
+        isDragging: boolean;
+        browse: () => void;
+    }) => any;
+    item?: (data: {
+        file: File;
+        index: number;
+        progress: number;
+        remove: () => void;
+        download: () => void;
+    }) => any;
+    chip?: (data: {
+        fileNames: string;
+        totalBytes: number;
+        totalBytesReadable: string;
+        props: Record<string, any>;
+    }) => any;
+    selection?: () => any;
 }

package/dist/src/interfaces/Form/form.interface.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentInternalInstance, ComputedRef, Raw, Ref } from 'vue';
-import type { ICommonsComponentProps } from '../../interfaces';
+import type { ICommonsComponentProps, ICommonsComponentSlots } from '../../interfaces';
 import type { TValidateOn } from '../../types';
 export interface IFormProvide {
     register: (item: {
@@ -24,6 +24,23 @@ export interface IFormProps extends ICommonsComponentProps {
     readonly?: boolean;
     modelValue?: boolean | null;
     validateOn?: TValidateOn;
+    rules?: Array<any>;
+    errorMessages?: Array<string> | string;
+    hint?: string;
+    messages?: Array<string> | string;
+    scrollToError?: boolean | ScrollIntoViewOptions;
+}
+export interface IFormSlots extends ICommonsComponentSlots {
+    messages?: () => any;
+    message?: () => any;
+    actions?: (data: {
+        submit: () => void;
+        reset: () => void;
+    }) => any;
+}
+export interface IFormEmits {
+    (e: 'submit', value: any): void;
+    (e: 'reset', value: any): void;
 }
 export interface IFormField {
     id: number | string;

package/dist/src/interfaces/Grids/col.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IAlignProps, IBorderProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, ITagProps } from '../../interfaces';
+import type { IAlignProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, ITagProps } from '../../interfaces';
 import type { TCols } from '../../types';
-export interface IColProps extends IColorProps, ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IAlignProps {
+export interface IColProps extends IColorProps, IBgColorProps, ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IAlignProps {
     cols?: TCols;
     sm?: TCols;
     md?: TCols;

package/dist/src/interfaces/Grids/container.interface.d.ts

@@ -1,5 +1,10 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface IContainerProps extends ICommonsComponentProps, ITagProps, IDimensionProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IColorProps {
+import type { IBorderProps, ICommonsComponentProps, IDimensionProps, IMarginProps, IPaddingProps, ITagProps } from '../../interfaces';
+/**
+ * Container is a structural wrapper. It deliberately does NOT extend
+ * `IColorProps` / `IRoundedProps` — chrome (background, border-radius)
+ * belongs on `Sheet` / `Card` / `Alert`, not on the page-level wrapper.
+ */
+export interface IContainerProps extends ICommonsComponentProps, ITagProps, IDimensionProps, IPaddingProps, IMarginProps, IBorderProps {
     fluid?: boolean;
     fullscreen?: boolean;
 }

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

@@ -1,6 +1,6 @@
-import type { IColorProps, IIntersectionObserverInit, ILazyProps, IResponsiveProps, ITransitionComponentProps } from '../../interfaces';
+import type { IBgColorProps, IColorProps, IIntersectionObserverInit, ILazyProps, IResponsiveProps, ITransitionComponentProps } from '../../interfaces';
 import type { TCrossOrigin, TReferrerPolicy } from '../../types';
-export interface IImgProps extends IColorProps, IResponsiveProps, ITransitionComponentProps, ILazyProps {
+export interface IImgProps extends IColorProps, IBgColorProps, IResponsiveProps, ITransitionComponentProps, ILazyProps {
     alt?: string;
     cover?: boolean;
     draggable?: boolean;

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

@@ -1,6 +1,6 @@
-import type { IColorProps, ICommonsComponentProps, IDimensionProps, IDirectionProps, ITagProps } from '../../interfaces';
+import type { IBgColorProps, IColorProps, ICommonsComponentProps, IDimensionProps, IDirectionProps, ITagProps } from '../../interfaces';
 import type { TInfiniteScrollMode, TInfiniteScrollSide } from '../../types';
-export interface IInfiniteScrollProps extends ICommonsComponentProps, IColorProps, IDimensionProps, ITagProps, IDirectionProps {
+export interface IInfiniteScrollProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IDimensionProps, ITagProps, IDirectionProps {
     side?: TInfiniteScrollSide;
     mode?: TInfiniteScrollMode;
     loadMoreText?: string;

package/dist/src/interfaces/Input/input.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IAdjacentProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IDirectionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, IValidationProps } from '../../interfaces';
-export interface IInputProps extends ICommonsComponentProps, IDensityProps, IPaddingProps, IMarginProps, IRoundedProps, IColorProps, IBorderProps, IElevationProps, IDimensionProps, IDirectionProps, IValidationProps, IAdjacentProps {
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDimensionProps, IDirectionProps, IElevationProps, IFocusEmits, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, IValidationProps } from '../../interfaces';
+export interface IInputProps extends ICommonsComponentProps, IDensityProps, IPaddingProps, IMarginProps, IRoundedProps, IColorProps, IBgColorProps, IBorderProps, IElevationProps, IDimensionProps, IDirectionProps, IValidationProps, IAdjacentProps, ISizeProps {
     centerAffix?: boolean;
     hideDetails?: boolean | string;
     hideSpinButtons?: boolean;
@@ -7,3 +7,31 @@ export interface IInputProps extends ICommonsComponentProps, IDensityProps, IPad
     persistentHint?: boolean;
     messages?: Array<string> | string;
 }
+/**
+ * Aggregate emits for `<OrigamInput>` — re-exports the v-model echo, the
+ * outer prepend/append clicks, and the focus state. Consumers
+ * (`<OrigamField>`, downstream typed inputs) consolidate these via
+ * `defineEmits<IInputEmits>()`.
+ */
+export interface IInputEmits extends ICommonsComponentEmits, IAdjacentEmits, IFocusEmits {
+}
+/**
+ * Slot signatures for `<OrigamInput>`. The `default` slot exposes the
+ * input control's identity + state so downstream components can wire up
+ * their native element with the right ARIA / event handlers.
+ */
+export interface IInputSlots extends IAdjacentSlots {
+    default?: (data: {
+        id: string;
+        isDisabled: boolean;
+        isDirty: boolean;
+        isValid: boolean;
+        isReadonly: boolean;
+    }) => any;
+    messages?: (data: {
+        hasMessages: boolean;
+        messages: Array<string> | Record<string, string>;
+    }) => any;
+    message?: (message: any) => any;
+    details?: (props: any) => any;
+}

package/dist/src/interfaces/ItemGroup/item-group.interface.cjs

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

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

@@ -0,0 +1,26 @@
+import type { ICommonsComponentProps, IGroupItemProps, IGroupProps, ITagProps } from '../../interfaces';
+/**
+ * Props for `<OrigamItemGroup>` — the renderless selection container.
+ * Mirrors `IBtnToggleProps` minus the visual mixins (this group has
+ * no chrome of its own).
+ *
+ * `tag` is explicitly redeclared here even though it lives on
+ * `ITagProps`. Vue 3's `defineProps<I>()` doesn't always extract
+ * inherited props from extends chains when the local interface body
+ * is empty — leaving consumers with `[Vue warn]: Property "tag" was
+ * accessed during render but is not defined on instance`. Shadowing
+ * the same property locally forces the runtime prop registration.
+ */
+export interface IItemGroupProps extends ICommonsComponentProps, ITagProps, IGroupProps {
+    tag?: string;
+}
+/**
+ * Props for `<OrigamItem>` — a single registered item inside the group.
+ * Named `IItemGroupItemProps` to avoid collision with the existing
+ * `IItemProps` in `List/list.interface.ts` (List's `items?` prop).
+ *
+ * `tag` shadowed locally — see the note on `IItemGroupProps`.
+ */
+export interface IItemGroupItemProps extends ICommonsComponentProps, ITagProps, IGroupItemProps {
+    tag?: string;
+}

package/dist/src/interfaces/Kbd/kbd.interface.cjs

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

package/dist/src/interfaces/Kbd/kbd.interface.d.ts

@@ -0,0 +1,12 @@
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IRoundedProps, ISizeProps } from '../../interfaces';
+import type { TKbdVariant } from '../../types';
+export interface IKbdProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IBorderProps, IRoundedProps {
+    /** Single key label (e.g. "⌘", "Ctrl", "A"). Overridden by the default slot. */
+    text?: string;
+    /** Composed shortcut rendered as individual nested `<kbd>` elements (e.g. ['Ctrl', 'Shift', 'Z']). */
+    combination?: string[];
+    /** Character shown between each key in a combination. Defaults to '+'. */
+    separator?: string;
+    /** Visual variant. Defaults to 'outlined'. */
+    variant?: TKbdVariant;
+}

package/dist/src/interfaces/Label/label.interface.d.ts

@@ -1,6 +1,12 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
-export interface ILabelProps extends ICommonsComponentProps, IMarginProps, IPaddingProps, IBorderProps, IRoundedProps, IColorProps {
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, ICommonsComponentSlots, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+export interface ILabelProps extends ICommonsComponentProps, IMarginProps, IPaddingProps, IBorderProps, IRoundedProps, IColorProps, IBgColorProps, ITagProps {
     text?: string;
     floating?: boolean;
     required?: boolean;
+    name?: string;
+}
+export interface ILabelEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+export interface ILabelSlots extends ICommonsComponentSlots {
 }

package/dist/src/interfaces/List/list-group.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IAdjacentProps, IBorderProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
-export interface IListGroupProps extends ITagProps, ICommonsComponentProps, IColorProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IAdjacentProps {
+export interface IListGroupProps extends ITagProps, ICommonsComponentProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IAdjacentProps, IActiveProps, IHoverProps {
     collapseIcon?: TIcon;
     expandIcon?: TIcon;
     fluid?: boolean;

package/dist/src/interfaces/List/list-item.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IAdjacentProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TLines } from '../../types';
-export interface IListItemProps extends IBorderProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ILinkProps, IColorProps, IRippleProps, IPaddingProps, IMarginProps, IAdjacentProps {
+export interface IListItemProps extends IBorderProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ILinkProps, IColorProps, IBgColorProps, IRippleProps, IPaddingProps, IMarginProps, IAdjacentProps, IActiveProps, IHoverProps {
     active?: boolean;
     activeClass?: string;
     disabled?: boolean;

package/dist/src/interfaces/List/list-subheader.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface IListSubheader extends ICommonsComponentProps, ITagProps, IColorProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps {
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+export interface IListSubheader extends ICommonsComponentProps, ITagProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps {
     inset?: boolean;
     sticky?: boolean;
     title?: string;

package/dist/src/interfaces/List/list.interface.d.ts

@@ -1,7 +1,7 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, INestedProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IMarginProps, INestedProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TLines, TSelectItemKey } from '../../types';
 import { deepEqual } from '../../utils';
-export interface IListProps extends ITagProps, ICommonsComponentProps, IElevationProps, IBorderProps, IDensityProps, IRoundedProps, IDimensionProps, INestedProps, IItemProps, IColorProps, IPaddingProps, IMarginProps {
+export interface IListProps extends ITagProps, ICommonsComponentProps, IElevationProps, IBorderProps, IDensityProps, IRoundedProps, IDimensionProps, INestedProps, IItemProps, IColorProps, IBgColorProps, IPaddingProps, IMarginProps {
     activeClass?: string;
     disabled?: boolean;
     expandIcon?: string;

package/dist/src/interfaces/Mask/mask-options.interface.cjs

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