origam 2.16.0 → 2.17.1

package/dist/src/interfaces/Skeleton/skeleton.interface.d.ts

@@ -1,9 +1,37 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentProps, IRoundedProps, ISizeProps } from '../../interfaces';
-import type { TSkeletonVariant } from '../../types';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISizeProps } from '../Commons/size.interface';
+import type { TSkeletonVariant } from '../../types/Skeleton/skeleton.type';
 export interface ISkeletonProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IRoundedProps {
     variant?: TSkeletonVariant;
     width?: string | number;
     height?: string | number;
     loading?: boolean;
     pulse?: boolean;
+    /*********************************************************
+     * label
+     *
+     * @description
+     * Accessible label announced on the `role="status"` placeholder
+     * (aria-label). Carries a LOCALE KEY, not final text — it is resolved
+     * through the DS `t()` mechanism, so it follows the active locale out
+     * of the box. Defaults to `'origam.loading'`, the shared key also used
+     * by Progress / Video / Audio / Switch for this same announcement.
+     * @description
+     * A raw string that matches no key is returned unchanged, so
+     * `label="Loading your invoices"` still works for consumers who prefer
+     * to translate on their side.
+     ********************************************************/
+    label?: string;
+}
+/*********************************************************
+ * ISkeletonEmits
+ *
+ * @description
+ * Emits fired by `<OrigamSkeleton>` — none. `loading` drives whether
+ * the placeholder or the `#default` slot renders; no state is
+ * reported back.
+ ********************************************************/
+export interface ISkeletonEmits {
 }

package/dist/src/interfaces/Slide/slide-group.interface.d.ts

@@ -1,5 +1,12 @@
-import type { IBorderProps, ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IDisplayProps, IGroupProps, IGroupProvide, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDirectionProps } from '../Commons/direction.interface';
+import type { IDisplayProps } from '../Commons/display.interface';
+import type { IGroupProps, IGroupProvide } from '../Commons/group.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface ISlideGroupProps extends ICommonsComponentProps, ITagProps, IDirectionProps, IGroupProps, IPaddingProps, IMarginProps, IRoundedProps, IBorderProps, IDisplayProps {
     centerActive?: boolean;
     nextIcon?: TIcon;

package/dist/src/interfaces/SliderField/slider-field-track.interface.d.ts

@@ -1,5 +1,8 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentProps, IRoundedProps, ISizeProps } from '../../interfaces';
-import type { TAlways, TTick } from '../../types';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISizeProps } from '../Commons/size.interface';
+import type { TAlways, TTick } from '../../types/SliderField/slider-field.type';
 export interface ISliderFieldTrackProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IRoundedProps {
     start?: number;
     stop?: number;
@@ -21,6 +24,16 @@ export interface ISliderFieldTrackProps extends ICommonsComponentProps, IColorPr
     /** Pre-computed tick descriptors — parent owns the math. */
     ticks?: Array<TTick>;
 }
+/*********************************************************
+ * ISliderFieldTrackEmits
+ *
+ * @description
+ * `<OrigamSliderFieldTrack>` emits nothing of its own — it's a purely
+ * presentational track/fill/ticks renderer driven entirely by props
+ * computed by the parent `<OrigamSliderField>`.
+ ********************************************************/
+export interface ISliderFieldTrackEmits {
+}
 /**
  * Slot signatures for `<OrigamSliderFieldTrack>`. `item` and the
  * per-tick `item.{index}` share the same `{ tick, index }` scope — the

package/dist/src/interfaces/SliderField/slider-field.interface.d.ts

@@ -1,5 +1,19 @@
-import type { IAdjacentSlots, IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IElevationProps, IFocusEmits, IFocusProps, IInputProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISliderFieldTrackProps, ISliderFieldTrackSlots } from '../../interfaces';
-import type { TAlways, TSize, TSliderFieldVariant } from '../../types';
+import type { IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDirectionProps } from '../Commons/direction.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IFocusEmits, IFocusProps } from '../Commons/focus.interface';
+import type { IInputProps } from '../Input/input.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRippleProps } from '../Commons/ripple.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISliderFieldTrackProps, ISliderFieldTrackSlots } from './slider-field-track.interface';
+import type { TAlways, TSliderFieldVariant } from '../../types/SliderField/slider-field.type';
+import type { TSize } from '../../types/Commons/size.type';
 export interface ISliderFieldProps extends ICommonsComponentProps, IDensityProps, IColorProps, IInputProps, IFocusProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IRippleProps, IDirectionProps {
     disabled?: boolean;
     required?: boolean;

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

@@ -1,4 +1,5 @@
-import type { TIcon, TIntent } from '../../types';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * Action button descriptor attached to a snackbar stack item.
  *

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

@@ -1,6 +1,7 @@
 import type { Ref } from 'vue';
-import type { ICommonsComponentProps, ISnackbarGroupItem, ISnackbarGroupItemOptions, ITagProps } from '../../interfaces';
-import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../types';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { ISnackbarGroupItem, ISnackbarGroupItemOptions } from './snackbar-group-item.interface';
+import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../types/Snackbar/snackbar-group.type';
 /**
  * Props for `<OrigamSnackbarGroup>` — a multi-toast container that
  * orchestrates a queue of `OrigamSnackbar` instances driven through
@@ -63,6 +64,26 @@ export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
      */
     direction?: TSnackbarGroupDirection;
 }
+/*********************************************************
+ * ISnackbarGroupEmits
+ *
+ * @description
+ * `<OrigamSnackbarGroup>` emits nothing of its own — dismiss/action
+ * handling mutates the shared store directly (`useSnackbarGroupInternal`),
+ * and the `onDismiss` / action `handler` callbacks come from the item
+ * descriptor passed to `notify()`, not from an emit on this instance.
+ ********************************************************/
+export interface ISnackbarGroupEmits {
+}
+/*********************************************************
+ * ISnackbarGroupSlots
+ *
+ * @description
+ * `<OrigamSnackbarGroup>` renders no `<slot>` — every visible item is
+ * a data-driven `<OrigamSnackbarItem>` built from the store's queue.
+ ********************************************************/
+export interface ISnackbarGroupSlots {
+}
 /**
  * Per-`id` singleton store backing `useSnackbarGroup`.
  *

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

@@ -1,6 +1,8 @@
-import type { ICommonsComponentProps, ITypographyProps } from '../../interfaces';
-import type { TIcon, TIntent } from '../../types';
-import type { ISnackbarGroupItemAction } from '../../interfaces';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TIntent } from '../../types/Commons/intent.type';
+import type { ISnackbarGroupItemAction } from './snackbar-group-item.interface';
 /**
  * Props for `<OrigamSnackbarItem>` — the pure visual layer of a single
  * toast notification. This component owns:
@@ -17,7 +19,7 @@ import type { ISnackbarGroupItemAction } from '../../interfaces';
  * Both `OrigamSnackbar` and `OrigamSnackbarGroup` consume this component
  * so all visual intent / layout logic lives in one place only.
  */
-export interface ISnackbarItemProps extends ICommonsComponentProps, ITypographyProps {
+export interface ISnackbarItemProps extends ICommonsComponentProps, Pick<ITypographyProps, 'fontSize'> {
     /**
      * Semantic intent — drives icon defaults and surface colouring via
      * `--origam-color__feedback--{intent}---*` tokens.

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

@@ -1,4 +1,17 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IMarginProps, IOverlayProps, IPaddingProps, IPositionProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { ILocationProps } from '../Commons/location.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IOverlayProps } from '../Overlay/overlay.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IPositionProps } from '../Commons/position.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { IStatusProps } from '../Commons/status.interface';
+import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
 export interface ISnackbarProps extends ICommonsComponentProps, ITagProps, IStatusProps, IColorProps, IBgColorProps, IOverlayProps, IPositionProps, ILocationProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, ITransitionComponentProps, IActiveProps, IHoverProps {
     multiLine?: boolean;
     text?: string;

package/dist/src/interfaces/Stepper/stepper-item.interface.cjs

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

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

@@ -0,0 +1,33 @@
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TStepperItemStatus } from '../../types/Stepper/stepper.type';
+/*********************************************************
+ * IStepperItemProps / IStepperItemEmits
+ *
+ * @description
+ * Props/emits for `<OrigamStepperItem>` — the only consumer. Split out
+ * of `interfaces/Stepper/stepper.interface.ts` under issue #364, which
+ * used to hold two distinct component surfaces (Stepper / StepperItem)
+ * in one file.
+ ********************************************************/
+export interface IStepperItemProps extends ICommonsComponentProps {
+    index?: number;
+    title?: string;
+    subtitle?: string;
+    icon?: TIcon;
+    status?: TStepperItemStatus;
+    clickable?: boolean;
+}
+/** Emits fired by `<OrigamStepperItem>` — click on a clickable step. */
+export interface IStepperItemEmits {
+    (e: 'click', index: number): void;
+}
+/*********************************************************
+ * IStepperItemSlots
+ *
+ * @description
+ * Slot signatures for `<OrigamStepperItem>` — none. Indicator icon,
+ * title and subtitle are entirely derived from props.
+ ********************************************************/
+export interface IStepperItemSlots {
+}

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

@@ -1,7 +1,26 @@
 import type { ComputedRef, Ref } from 'vue';
-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';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISizeProps } from '../Commons/size.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TStepperItemStatus, TStepperOrientation } from '../../types/Stepper/stepper.type';
+/*********************************************************
+ * IStepperItem / IStepperProps / IStepperProvide
+ *
+ * @description
+ * `IStepperItemProps` / `IStepperItemEmits` (the actual
+ * `<OrigamStepperItem>` component surface) moved out to
+ * `interfaces/Stepper/stepper-item.interface.ts` under issue #364 —
+ * this file used to hold both distinct component surfaces
+ * (Stepper / StepperItem).
+ ********************************************************/
 export interface IStepperItem {
     title: string;
     subtitle?: string;
@@ -21,14 +40,6 @@ export interface IStepperProvide {
     clickable: ComputedRef<boolean>;
     color: ComputedRef<string | undefined>;
 }
-export interface IStepperItemProps extends ICommonsComponentProps {
-    index?: number;
-    title?: string;
-    subtitle?: string;
-    icon?: TIcon;
-    status?: TStepperItemStatus;
-    clickable?: boolean;
-}
 /** Emits fired by `<OrigamStepper>` — v-model echo for the active step. */
 export interface IStepperEmits {
     (e: 'update:modelValue', value: number): void;
@@ -38,7 +49,3 @@ export interface IStepperSlots {
     /** Overrides the whole auto-generated item list. */
     default?: () => any;
 }
-/** Emits fired by `<OrigamStepperItem>` — click on a clickable step. */
-export interface IStepperItemEmits {
-    (e: 'click', index: number): void;
-}

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

@@ -1,11 +1,20 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, ICommonsComponentSlots, IElevationProps, IRoundedProps } from '../../interfaces';
-/**
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentProps, ICommonsComponentSlots } from '../Commons/commons.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TColor } from '../../types/Commons/color.type';
+/*********************************************************
+ * ISwitchTrackProps
+ *
+ * @description
  * Props for `<OrigamSwitchTrack>` — the rounded "rail" sitting behind the
  * Switch thumb. The track owns its own visual surface (background, border,
  * inset variant, error state, rounded/elevation identity) and exposes slots
  * for content shown on the `true` (left) and `false` (right) sides of the
  * rail.
  *
+ * @description
  * Color contract — strict channel separation:
  *  • `bgColor` paints the rail (the box behind the thumb).
  *  • `color`   is the foreground intent inherited from the parent
@@ -13,6 +22,7 @@ import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentEmits,
  *              not the track) — exposed here so the slot content can
  *              react to it (e.g. an icon inside `track.true`).
  *
+ * @description
  * `border` / `rounded` / `elevation` (props-first, lot 4 theming fix):
  * previously declared on `ISwitchProps` (inherited from the Commons
  * interfaces) but never consumed anywhere — `OrigamSwitch.vue` accepted
@@ -22,7 +32,7 @@ import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentEmits,
  * and nothing would render differently. Declared here now because the
  * track is the element that owns the visual surface these props target —
  * `OrigamSwitch` forwards its own values down via `filterProps`.
- */
+ ********************************************************/
 export interface ISwitchTrackProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IBorderProps, IRoundedProps, IElevationProps {
     /** Whether the switch is currently ON. Drives the `--dirty` modifier. */
     modelValue?: boolean;
@@ -43,14 +53,46 @@ export interface ISwitchTrackProps extends ICommonsComponentProps, IColorProps,
     /** Inset (Material) variant — taller, fully-rounded rail. */
     inset?: boolean;
 }
-export interface ISwitchTrackEmits extends ICommonsComponentEmits {
+/*********************************************************
+ * ISwitchTrackEmits
+ *
+ * @description
+ * ⛔ Does NOT extend `ICommonsComponentEmits` (LOT 3, unemitted-declarations
+ * guard). That interface only declares `update:modelValue`, which this
+ * component cannot emit: `modelValue` is a plain, read-only display prop
+ * here — `props.modelValue: boolean`, driving the `--dirty` CSS modifier —
+ * there is no `useVModel` call, no `modelValue.value =` write, nothing.
+ * The track only ever forwards a raw `click` upward; `OrigamSwitch` decides
+ * whether that toggles the real `modelValue` it owns (`v-model="model"` on
+ * `<origam-selection-control>`, several layers above). Same reasoning as
+ * `ICheckboxBtnEmits` for `update:focused` — dead surface, not an
+ * observable break: a consumer binding `@update:model-value` on
+ * `<origam-switch-track>` directly received nothing before and receives
+ * nothing after; the listener now flows through `$attrs` instead of being
+ * swallowed by a declaration that lied about firing it.
+ ********************************************************/
+export interface ISwitchTrackEmits {
     (e: 'click', event: MouseEvent): void;
 }
-/**
+/*********************************************************
+ * ISwitchTrackSlotsProps
+ *
+ * @description
  * Slot payload — `model` and `isValid` are forwarded so the consumer can
  * render contextual content (a checkmark on ON, an `x` on OFF, …).
- */
+ *
+ * @description
+ * ⛔ `color` is part of the payload AT RUNTIME (`slotProps` in
+ * `OrigamSwitchTrack.vue` spreads `color: props.color`) but was missing
+ * from this type, so a TypeScript consumer destructuring
+ * `#track.true="{ color }"` got an error on a value that is genuinely
+ * there. Declared here to close the gap — the track still does NOT paint
+ * with it (the foreground channel lives on the surrounding
+ * SelectionControl, see the note on `ISwitchTrackProps`); it is forwarded
+ * precisely so slot content can react to it.
+ ********************************************************/
 export interface ISwitchTrackSlotsProps {
+    color?: TColor;
     model: boolean;
     isValid: boolean | null;
 }

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

@@ -1,8 +1,21 @@
-import type { IActiveProps, IBorderProps, IClickLabelEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IHoverProps, IIndeterminateEmits, IInputProps, ILoaderProps, IMarginProps, IPaddingProps, IRoundedProps, ISelectionControlProps, ISwitchTrackSlotsProps, ITagProps } from '../../interfaces';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IClickLabelEmits, ICommonsComponentEmits, ICommonsComponentProps, IIndeterminateEmits, ITagProps } from '../Commons/commons.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IFocusEmits } from '../Commons/focus.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { IInputProps } from '../Input/input.interface';
+import type { ILoaderProps } from '../Commons/loader.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ISelectionControlProps } from '../SelectionControl/selection-control.interface';
+import type { ISwitchTrackSlotsProps } from './switch-track.interface';
 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. */

package/dist/src/interfaces/SystemBar/system-bar.interface.d.ts

@@ -1,4 +1,20 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, ILayoutItemProps, IRoundedProps, ITagProps, ITypographyProps } from "../../interfaces";
-export interface ISystemBarProps extends ICommonsComponentProps, ITagProps, IElevationProps, IColorProps, IBgColorProps, ILayoutItemProps, IRoundedProps, IBorderProps, IDimensionProps, ITypographyProps {
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { ILayoutItemProps } from '../Commons/layout.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+export interface ISystemBarProps extends ICommonsComponentProps, ITagProps, IElevationProps, IColorProps, IBgColorProps, ILayoutItemProps, IRoundedProps, IBorderProps, IDimensionProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     window?: boolean;
 }
+/*********************************************************
+ * ISystemBarEmits
+ *
+ * @description
+ * `<OrigamSystemBar>` is a static layout item (registers itself via
+ * `useLayoutItem`) — nothing is emitted.
+ ********************************************************/
+export interface ISystemBarEmits {
+}

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

@@ -1,11 +1,22 @@
-import type { IBorderProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
-export interface ITableProps extends ICommonsComponentProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IHoverProps, IDimensionProps, IDensityProps, ITagProps, ITypographyProps {
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+export interface ITableProps extends ICommonsComponentProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IHoverProps, IDimensionProps, IDensityProps, ITagProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight'> {
     fixedHeader?: boolean;
     fixedFooter?: boolean;
     caption?: string;
     captionVisible?: boolean;
     ariaRowcount?: number;
 }
+export interface ITableEmits {
+}
 /** Slot signatures for `<OrigamTable>`. */
 export interface ITableSlots {
     top?: () => any;

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

@@ -1,4 +1,6 @@
-import type { ICommonsComponentProps, IGroupItemProps, ILazyProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IGroupEmits, IGroupItemProps } from '../Commons/group.interface';
+import type { ILazyProps } from '../Commons/lazy.interface';
 /**
  * Props for `<OrigamTabPanel>` — a single tab content panel.
  *
@@ -10,6 +12,16 @@ import type { ICommonsComponentProps, IGroupItemProps, ILazyProps, ITagProps } f
 export interface ITabPanelProps extends ICommonsComponentProps, ITagProps, IGroupItemProps, ILazyProps {
     tag?: string;
 }
+/*********************************************************
+ * ITabPanelEmits
+ *
+ * @description
+ * `<OrigamTabPanel>` self-registers into the `ORIGAM_TAB_PANELS_KEY`
+ * group via `useGroupItem`, which genuinely emits `group:selected` on
+ * this component's own instance whenever `isSelected` changes.
+ ********************************************************/
+export interface ITabPanelEmits extends IGroupEmits {
+}
 /** Slot signatures for `<OrigamTabPanel>`. */
 export interface ITabPanelSlots {
     default?: () => any;

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

@@ -1,4 +1,6 @@
-import type { ICommonsComponentEmits, ICommonsComponentProps, IDirectionProps, IGroupProps, IGroupProvide, ITagProps } from '../../interfaces';
+import type { ICommonsComponentEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDirectionProps } from '../Commons/direction.interface';
+import type { IGroupProps, IGroupProvide } from '../Commons/group.interface';
 import type { ComputedRef, Ref } from 'vue';
 /**
  * Props for `<OrigamTabPanels>` — the content area that mirrors the

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

@@ -1,5 +1,9 @@
-import type { IAdjacentProps, ICommonsComponentProps, IGroupItemProps, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TIcon, TTabVariant } from '../../types';
+import type { IAdjacentProps } from '../Commons/adjacent.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IGroupEmits, IGroupItemProps } from '../Commons/group.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TTabVariant } from '../../types/Tabs/tab.type';
 /**
  * Props for `<OrigamTab>` — a single registered tab inside an
  * `<OrigamTabs>` tablist.
@@ -21,7 +25,7 @@ import type { TIcon, TTabVariant } from '../../types';
  * `lineHeight` is intentionally excluded — the SCSS hard-codes `line-height: 1`
  * with no CSS-var hook.
  */
-export interface ITabProps extends ICommonsComponentProps, ITagProps, IGroupItemProps, ITypographyProps, IAdjacentProps {
+export interface ITabProps extends ICommonsComponentProps, ITagProps, IGroupItemProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'letterSpacing'>, IAdjacentProps {
     tag?: string;
     /** Text label — used when the `default` slot is not provided. */
     text?: string;
@@ -33,6 +37,18 @@ export interface ITabProps extends ICommonsComponentProps, ITagProps, IGroupItem
      */
     icon?: TIcon;
 }
+/*********************************************************
+ * ITabEmits
+ *
+ * @description
+ * `<OrigamTab>` self-registers into the parent `<OrigamTabs>` group via
+ * `useGroupItem`, which watches `isSelected` and emits `group:selected`
+ * on this component's own instance whenever selection state changes —
+ * a genuine, always-active emit (see `IGroupEmits`), not conditional
+ * on a specific handler.
+ ********************************************************/
+export interface ITabEmits extends IGroupEmits {
+}
 /** Scope forwarded to the `default` slot — the resolved selection
  *  state from `useGroupItem`, unwrapped from its `Ref`s (unlike
  *  `ITabsSlotProps`, which forwards the parent's raw `useGroup()` API

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

@@ -1,5 +1,10 @@
-import type { IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDirectionProps, IGroupProps, IGroupProvide, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TTabVariant } from '../../types';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDirectionProps } from '../Commons/direction.interface';
+import type { IGroupProps, IGroupProvide } from '../Commons/group.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TTabVariant } from '../../types/Tabs/tab.type';
 /**
  * Props for `<OrigamTabs>` — a stateful tablist container.
  *

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

@@ -1,5 +1,16 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldEmits, IFieldProps, IFieldSlots, IInputEmits, IInputProps, IInputSlots, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
-import type { TMask, TTextFieldType } from '../../types';
+import type { IAdjacentInnerEmits } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IFocusEmits } from '../Commons/focus.interface';
+import type { IFieldProps, IFieldSlots } from '../Field/field.interface';
+import type { IInputEmits, IInputProps, IInputSlots } from '../Input/input.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TMask, TTextFieldType } from '../../types/TextField/text-field.type';
 export interface ITextFieldProps extends ICommonsComponentProps, IColorProps, IDensityProps, IFieldProps, IInputProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps {
     autofocus?: boolean;
     counter?: boolean | number | string;
@@ -21,8 +32,23 @@ export interface ITextFieldProps extends ICommonsComponentProps, IColorProps, ID
 /**
  * Aggregate emits for `<OrigamTextField>` — re-exports field/input lifecycle
  * events plus the click events on the control surface.
+ *
+ * ⛔ Extends `IFocusEmits` + `IAdjacentInnerEmits` DIRECTLY rather than the
+ * full `IFieldEmits` — `<OrigamTextField>` calls its OWN `useFocus(props)`
+ * (line ~253) and its OWN `useAdjacentInner(props)`, so `update:focused` /
+ * `click:appendInner` / `click:prependInner` / `click:clear` are genuinely
+ * emitted at THIS level. `IFieldEmits` also carries `IActiveEmits`
+ * (`update:active`), deliberately excluded: the nested `<origam-field>`
+ * lives inside a scoped-slot template (not this component's own root), so
+ * Vue's automatic attrs-fallthrough never reaches it, and this component
+ * computes its OWN `isActive` (`isActive || isDirty`, passed DOWN to
+ * `<origam-field>` as a plain prop) rather than relaying the child's
+ * internal toggle — no `@update:active` listener is wired on
+ * `<origam-field>` anywhere in the template. Declaring it here promised an
+ * event nobody ever fired (issue: guard `unemitted-declarations`,
+ * `TextField:update:active`).
  */
-export interface ITextFieldEmits extends IFieldEmits, IInputEmits {
+export interface ITextFieldEmits extends IFocusEmits, IAdjacentInnerEmits, IInputEmits {
     (e: 'click:control', value: MouseEvent): void;
     (e: 'mousedown:control', value: MouseEvent): void;
     /**

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

@@ -1,5 +1,8 @@
-import type { ICommonsComponentProps, IGradient, ITagProps, ITypographyProps } from '../../interfaces';
-import type { TBlockquoteAlign, TTextMaskAnimation } from '../../types';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IGradient } from '../Commons/gradient.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
+import type { TBlockquoteAlign } from '../../types/Blockquote/blockquote.type';
+import type { TTextMaskAnimation } from '../../types/TextMask/text-mask.type';
 /**
  * Props for `<OrigamTextMask>` — typographic "window" component.
  *
@@ -84,3 +87,12 @@ export interface ITextMaskProps extends ICommonsComponentProps, ITagProps, ITypo
 export interface ITextMaskSlots {
     default?: () => any;
 }
+/*********************************************************
+ * ITextMaskEmits
+ *
+ * @description
+ * `<OrigamTextMask>` only paints text via CSS `background-clip: text` —
+ * it never calls `emit(...)` in its script.
+ ********************************************************/
+export interface ITextMaskEmits {
+}

package/dist/src/interfaces/TextareaField/textarea-field-rich-toolbar.interface.cjs

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