npm - origam - Versions diffs - 2.5.0 → 2.6.1 - Mend

origam 2.5.0 → 2.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (523) hide show

package/dist/src/interfaces/Commons/commons.interface.d.ts CHANGED Viewed

@@ -1,8 +1,17 @@
 import type { ExtractPropTypes, StyleValue } from 'vue';
 import type * as Components from "../../components";
 import type * as Directives from "../../directives";
-import type { IDateOptions, IDisplayOptions, IGoToOptions, ILocaleOptions, IRtlOptions } from '../../interfaces';
+import type { IDateOptions, IDisplayOptions, IGoToOptions, ILocaleOptions, IOrigamTheme, IRtlOptions } from '../../interfaces';
 import { TIconOptions, TOrigamPluginOptionsImport, TSSROptions } from '../../types';
+/**
+ * Runtime text-contrast guard config (consumed by the `v-contrast` directive).
+ * `enabled` toggles the whole feature; `threshold` is the minimum acceptable
+ * WCAG contrast ratio (default 4.5:1 — AA for normal text).
+ */
+export interface IContrastOptions {
+    enabled?: boolean;
+    threshold?: number;
+}
 export interface IOrigamOptions {
     aliases?: any;
     blueprint?: IBlueprint;
@@ -14,6 +23,30 @@ export interface IOrigamOptions {
     goTo?: IGoToOptions;
     date?: IDateOptions;
     locale?: ILocaleOptions & IRtlOptions;
+    /**
+     * Runtime text-contrast guard. `true` (default) enables the WCAG check
+     * that auto-corrects illegible text colours and warns; `false` disables
+     * it. Pass an object to tune the threshold.
+     */
+    contrast?: boolean | IContrastOptions;
+    /**
+     * Optional runtime theme. When supplied, `createOrigam` resolves it to a
+     * block of `--origam-*` CSS variables and injects it into `<head>` at
+     * install time (browser only — SSR-safe no-op on the server). Accepts a
+     * pre-resolved var map and/or a DTCG-shaped token tree; see `IOrigamTheme`.
+     */
+    theme?: IOrigamTheme;
+    /**
+     * Optional list of runtime themes installed together (the consumer install
+     * path — see ADR-003). Each object is injected as its own name×mode scoped
+     * `--origam-*` block via the same machinery as `theme`. The distinct brand
+     * names are exposed through `useInstalledThemes()` so a switcher can derive
+     * its list from the install rather than a hard-coded const.
+     *
+     * `theme` (singular) and `themes` (plural) may both be supplied; all are
+     * injected. SSR-safe (injection is a no-op without `document`).
+     */
+    themes?: IOrigamTheme[];
 }
 export interface IOrigamPluginOptions {
     autoImport?: TOrigamPluginOptionsImport;

package/dist/src/interfaces/Commons/filters.interface.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ import type { TFilterFunction, TFilterKeyFunctions, TFilterKeys, TFilterMode } f
 export interface IFiltersProps {
     customFilter?: TFilterFunction;
     customKeyFilter?: TFilterKeyFunctions;
-    filterKeys: TFilterKeys;
-    filterMode: TFilterMode;
+    filterKeys?: TFilterKeys;
+    filterMode?: TFilterMode;
     noFilter?: boolean;
 }

package/dist/src/interfaces/Commons/hover.interface.d.ts CHANGED Viewed

@@ -21,10 +21,23 @@ import type { IHoverState } from '../../interfaces';
 export interface IHoverProps {
     hover?: boolean | IHoverState;
 }
+/**
+ * Object config accepted by the `v-hover` directive.
+ *
+ *   • `class`      — class toggled on the element while hovered
+ *                    (defaults to `{componentName}--hover` when omitted).
+ *   • `mouseenter` — handler called on pointer/touch enter.
+ *   • `mouseleave` — handler called on pointer/touch leave.
+ *
+ * Both handlers receive the hovered element and the originating event.
+ */
+export interface IHoverDirectiveConfig {
+    class?: string;
+    mouseenter?: (el: HTMLElement, e: Event) => void;
+    mouseleave?: (el: HTMLElement, e: Event) => void;
+}
 export interface IHoverDirectiveBinding extends Omit<DirectiveBinding, 'modifiers' | 'value'> {
-    value?: boolean | {
-        class: string;
-    };
+    value?: boolean | IHoverDirectiveConfig;
     modifiers: {
         callback: () => void;
         stop?: boolean;
@@ -41,6 +54,8 @@ export interface IHoverHtmlElementHover {
     class?: string;
     touched?: boolean;
     isTouch?: boolean;
+    mouseenter?: (el: HTMLElement, e: Event) => void;
+    mouseleave?: (el: HTMLElement, e: Event) => void;
 }
 /** Emit signature for components that propagate their hover state. */
 export interface IHoverEmits {

package/dist/src/interfaces/Commons/scroll.interface.d.ts CHANGED Viewed

@@ -1,7 +1,14 @@
 import type { TScrollBehavior, TScrollStrategy, TScrollStrategyFn } from '../../types';
 import type { Ref } from 'vue';
 export interface IScrollProps {
-    scrollBehavior?: TScrollBehavior;
+    /**
+     * Space-separated list of scroll behaviours, e.g. `"hide inverted"` or
+     * `"elevate active"`. `inverted` is a MODIFIER that flips the trigger of
+     * `hide` / `collapse` / `elevate` and does nothing on its own. The
+     * `(string & {})` member keeps single-token autocomplete while allowing
+     * multi-token combinations.
+     */
+    scrollBehavior?: TScrollBehavior | (string & {});
     scrollTarget?: string;
     scrollThreshold?: string | number;
 }

package/dist/src/interfaces/Commons/typography.interface.cjs ADDED Viewed

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

package/dist/src/interfaces/Commons/typography.interface.d.ts ADDED Viewed

@@ -0,0 +1,52 @@
+import type { TFontFamily, TFontSize, TFontWeight, TLetterSpacing, TLineHeight } from '../../types';
+/**
+ * Cross-cutting typography surface — the font equivalent of
+ * `IColorProps` / `IBorderProps` / `IMarginProps`. Every prop is optional
+ * and maps a primitive font token key to the matching component CSS
+ * variable via `useTypography`. When a prop is unset the component keeps
+ * its theme value (no override emitted).
+ *
+ * | Prop            | CSS property      | Primitive token group        |
+ * |-----------------|-------------------|------------------------------|
+ * | `fontFamily`    | `font-family`     | `--origam-font__family---*`        |
+ * | `fontSize`      | `font-size`       | `--origam-font__size---*`          |
+ * | `fontWeight`    | `font-weight`     | `--origam-font__weight---*`        |
+ * | `lineHeight`    | `line-height`     | `--origam-font__lineHeight---*`    |
+ * | `letterSpacing` | `letter-spacing`  | `--origam-font__letterSpacing---*` |
+ *
+ * Collision-free names by design: `fontSize` / `fontWeight` / `fontFamily`
+ * (not `size` / `weight` / `family`) so the surface composes with
+ * `ISizeProps.size` on Btn / Chip / Avatar / Kbd without clashing.
+ */
+export interface ITypographyProps {
+    /**
+     * Font family token. Maps to `--origam-font__family---{fontFamily}`
+     * (sans · mono · serif).
+     * When unset, the component keeps its theme font-family.
+     */
+    fontFamily?: TFontFamily;
+    /**
+     * Font size token. Maps to `--origam-font__size---{fontSize}`
+     * (xs · sm · md · lg · xl · 2xl · 3xl · 4xl · 5xl).
+     * When unset, the component keeps its theme / density font-size.
+     */
+    fontSize?: TFontSize;
+    /**
+     * Font weight token. Maps to `--origam-font__weight---{fontWeight}`
+     * (regular 400 · medium 500 · semibold 600 · bold 700 · extrabold 800 · black 900).
+     * When unset, the component keeps its theme font-weight.
+     */
+    fontWeight?: TFontWeight;
+    /**
+     * Line-height token. Maps to `--origam-font__lineHeight---{lineHeight}`
+     * (none 1 · tight 1.25 · snug 1.375 · normal 1.5 · relaxed 1.625 · loose 2).
+     * When unset, the component keeps its theme line-height.
+     */
+    lineHeight?: TLineHeight;
+    /**
+     * Letter-spacing token. Maps to `--origam-font__letterSpacing---{letterSpacing}`
+     * (tight -0.025em · normal 0em · wide 0.0094em · wider 0.0125em · widest 0.0893em).
+     * When unset, the component keeps its theme letter-spacing.
+     */
+    letterSpacing?: TLetterSpacing;
+}

package/dist/src/interfaces/Commons/typography.interface.js ADDED Viewed

File without changes

package/dist/src/interfaces/Commons/validation.interface.d.ts CHANGED Viewed

@@ -2,7 +2,9 @@ import type { IFocusProps } from '../../interfaces';
 import type { TValidateOn } from '../../types';
 export interface IValidationProps extends IFocusProps {
     disabled?: boolean;
-    error?: boolean;
+    /** Field-level error flag. Accepts a `boolean` (error on/off) or a `string`
+     *  (error message rendered inline by consumers such as `FileField`). */
+    error?: string | boolean;
     errorMessages?: Array<string> | string;
     maxErrors?: number | string;
     name?: string;

package/dist/src/interfaces/Counter/counter.interface.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITransitionComponentProps } from "../../interfaces";
-export interface ICounterProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IColorProps, IElevationProps, IDensityProps, ITransitionComponentProps {
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITransitionComponentProps } from "../../interfaces";
+export interface ICounterProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IColorProps, IBgColorProps, IElevationProps, IDensityProps, ITransitionComponentProps {
     active?: boolean;
     disabled?: boolean;
     max?: string | number;

package/dist/src/interfaces/DataList/data-list.interface.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import type { IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDataListKVItem, IDataTextProps, IDataTitleProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps } from "../../interfaces";
+import type { IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDataListKVItem, IDataTextProps, IDataTitleProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITypographyProps } from "../../interfaces";
 /**
  * Layout mode of `<OrigamDataList>`.
  *
@@ -14,7 +14,7 @@ import type { IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommons
  *   Items conform to {@link IDataListKVItem}.
  */
 export type TDataListMode = 'avatar' | 'kv';
-export interface IDataListProps extends ICommonsComponentProps, IAdjacentProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IDensityProps, IBorderProps, IRoundedProps, IElevationProps {
+export interface IDataListProps extends ICommonsComponentProps, IAdjacentProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IDensityProps, IBorderProps, IRoundedProps, IElevationProps, ITypographyProps {
     /**
      * Selects the layout. Defaults to `"avatar"` so existing call sites
      * keep their current rendering. Set to `"kv"` for the PDF-aligned

package/dist/src/interfaces/DataList/data-text.interface.d.ts CHANGED Viewed

@@ -1,4 +1,9 @@
 import type { IAdjacentProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps } from "../../interfaces";
+import type { TColor } from "../../types";
 export interface IDataTextProps extends ICommonsComponentProps, IAdjacentProps, IDensityProps, IMarginProps, IPaddingProps, IColorProps, IBgColorProps {
     text: string | number;
+    /** @deprecated Use the `hover` object prop instead. Kept for back-compat. */
+    hoverColor?: TColor;
+    /** @deprecated Use the `hover` object prop instead. Kept for back-compat. */
+    hoverBgColor?: TColor;
 }

package/dist/src/interfaces/DataList/data-title.interface.d.ts CHANGED Viewed

@@ -1,4 +1,9 @@
 import type { IAdjacentProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps } from "../../interfaces";
+import type { TColor } from "../../types";
 export interface IDataTitleProps extends ICommonsComponentProps, IAdjacentProps, IDensityProps, IMarginProps, IPaddingProps, IColorProps, IBgColorProps {
     text: string | number;
+    /** @deprecated Use the `hover` object prop instead. Kept for back-compat. */
+    hoverColor?: TColor;
+    /** @deprecated Use the `hover` object prop instead. Kept for back-compat. */
+    hoverBgColor?: TColor;
 }

package/dist/src/interfaces/DataTable/headers.interface.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import type { ComputedRef, Ref, UnwrapRef } from 'vue';
 import { ALIGN } from '../../enums';
-import type { IAdjacentEmits, IColorProps, ICommonsComponentProps, IDataTableItem, IDataTableSortItem, IDisplayProps, ILoaderProps } from '../../interfaces';
-import type { TAlign, TDataTableCompareFunction, TDataTableHeaderCell, TFilterFunction, TIcon, TSelectItemKey } from '../../types';
+import type { IAdjacentEmits, IBgColorProps, IColorProps, ICommonsComponentProps, IDataTableItem, IDataTableSortItem, IDisplayProps, ILoaderProps } from '../../interfaces';
+import type { TDataTableCompareFunction, TDataTableHeaderCell, TFilterFunction, TIcon, TSelectItemKey } from '../../types';
 export interface IHeaderCellProps extends ICommonsComponentProps, IColorProps {
     disableSort?: boolean;
     headerProps?: any;
@@ -24,7 +24,7 @@ export interface IDataTableHeadersCellMobileEmits extends IAdjacentEmits {
 export interface IDataTableHeadersCellProps extends ICommonsComponentProps, IColorProps, IHeaderCellProps {
     headers: Array<Array<IInternalDataTableHeader>>;
 }
-export interface IDataTableHeaderCellProps extends ICommonsComponentProps, IHeaderCellProps, IColorProps {
+export interface IDataTableHeaderCellProps extends ICommonsComponentProps, IHeaderCellProps, IColorProps, IBgColorProps {
     column: IInternalDataTableHeader;
     x: number;
     y: number;
@@ -37,7 +37,7 @@ export interface IDataTableHeadersSlotProps {
     allSelected: UnwrapRef<ComputedRef<boolean>>;
     toggleSort: (column: IInternalDataTableHeader) => void;
     selectAll: (value: boolean) => void;
-    getSortIcon: (column: IInternalDataTableHeader) => TIcon;
+    getSortIcon: (column: IInternalDataTableHeader) => TIcon | undefined;
     isSorted: (column: IInternalDataTableHeader) => boolean;
 }
 export interface IDataTableHeaderProps {
@@ -49,7 +49,7 @@ export interface IDataTableHeader<T = any> {
     value?: TSelectItemKey<T>;
     title?: string;
     fixed?: boolean;
-    align?: Omit<TAlign, ALIGN.BASELINE | ALIGN.STRETCH>;
+    align?: ALIGN.START | ALIGN.END | ALIGN.CENTER;
     width?: number | string;
     minWidth?: string;
     maxWidth?: string;

package/dist/src/interfaces/DataTable/row.interface.d.ts CHANGED Viewed

@@ -13,11 +13,11 @@ export interface IDataTableRowProps extends ICommonsComponentProps, IDisplayProp
 }
 /** Emits fired by `<OrigamDataTableRow>` — row-level expand / select. */
 export interface IDataTableRowEmits {
-    (e: 'expand', payload: {
+    (e: 'expand', payload?: {
         item: IDataTableItem;
         value: boolean;
     }): void;
-    (e: 'select', payload: {
+    (e: 'select', payload?: {
         item: IDataTableItem;
         value: boolean;
     }): void;

package/dist/src/interfaces/DatePicker/date-picker-controls.interface.d.ts CHANGED Viewed

@@ -1,7 +1,13 @@
-import type { ICommonsComponentProps } from "../../interfaces";
+import type { IActiveState, ICommonsComponentProps } from "../../interfaces";
 import type { TDateMode, TIcon } from "../../types";
 export interface IDatePickerControlsProps extends ICommonsComponentProps {
-    active?: string | Array<string>;
+    /**
+     * Highlighted item(s) in the controls toolbar. Widened to include
+     * `boolean | IActiveState` so that IDatePickerProps can extend both this
+     * interface and IPickerProps (which via ISheetProps → IActiveProps declares
+     * `active?: boolean | IActiveState`) without TS2320.
+     */
+    active?: string | Array<string> | boolean | IActiveState;
     disabled?: boolean;
     disabledMonth?: boolean;
     disabledYear?: boolean;
@@ -14,11 +20,13 @@ export interface IDatePickerControlsProps extends ICommonsComponentProps {
     viewMode?: TDateMode;
 }
 /** Emits fired by `<OrigamDatePickerControls>` — clicks on the five
- *  toolbar buttons (year / month / prev / next / text label). */
+ *  toolbar buttons (year / month / prev / next / text label).
+ *  `event` is optional: the click handlers call `emits('click:prev')`
+ *  etc. without forwarding the originating MouseEvent. */
 export interface IDatePickerControlsEmits {
-    (e: 'click:year', event: MouseEvent): void;
-    (e: 'click:month', event: MouseEvent): void;
-    (e: 'click:prev', event: MouseEvent): void;
-    (e: 'click:next', event: MouseEvent): void;
-    (e: 'click:text', event: MouseEvent): void;
+    (e: 'click:year', event?: MouseEvent): void;
+    (e: 'click:month', event?: MouseEvent): void;
+    (e: 'click:prev', event?: MouseEvent): void;
+    (e: 'click:next', event?: MouseEvent): void;
+    (e: 'click:text', event?: MouseEvent): void;
 }

package/dist/src/interfaces/DatePicker/date-picker-header.interface.d.ts CHANGED Viewed

@@ -1,9 +1,12 @@
-import type { IAdjacentProps, IClickEmits, IColorProps, ICommonsComponentProps, IDensityProps } from "../../interfaces";
+import type { IAdjacentProps, IColorProps, ICommonsComponentProps, IDensityProps } from "../../interfaces";
 import type { TTransitionProps } from "../../types";
 export interface IDatePickerHeaderProps extends ICommonsComponentProps, IColorProps, IAdjacentProps, IDensityProps {
     header?: string;
     transition?: TTransitionProps;
 }
-/** Emits fired by `<OrigamDatePickerHeader>` — click on the header text. */
-export interface IDatePickerHeaderEmits extends IClickEmits {
+/** Emits fired by `<OrigamDatePickerHeader>` — click on the header text.
+ *  `event` is optional: the handler calls `emits('click')` without forwarding
+ *  the originating MouseEvent. */
+export interface IDatePickerHeaderEmits {
+    (e: 'click', event?: MouseEvent): void;
 }

package/dist/src/interfaces/DatePicker/date-picker-months.interface.d.ts CHANGED Viewed

@@ -2,8 +2,8 @@ import type { IColorProps, ICommonsComponentProps, IDimensionProps } from "../..
 export interface IDatePickerMonthsProps extends ICommonsComponentProps, IColorProps, IDimensionProps {
     min?: unknown;
     max?: unknown;
-    month: number;
-    year: number;
+    month?: number;
+    year?: number;
 }
 /** Emits fired by `<OrigamDatePickerMonths>` — click on a month tile. */
 export interface IDatePickerMonthsEmits {

package/dist/src/interfaces/DatePicker/date-picker-years.interface.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ import type { IColorProps, ICommonsComponentProps, IDimensionProps } from "../..
 export interface IDatePickerYearsProps extends ICommonsComponentProps, IColorProps, IDimensionProps {
     min?: unknown;
     max?: unknown;
-    year: number;
+    year?: number;
 }
 /** Emits fired by `<OrigamDatePickerYears>` — click on a year tile. */
 export interface IDatePickerYearsEmits {

package/dist/src/interfaces/DatePicker/date-picker.interface.d.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import type { IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDatePickerControlsProps, IDatePickerHeaderProps, IDatePickerMonthProps, IDatePickerMonthsProps, IDatePickerYearsProps, IElevationProps, IMarginProps, IPaddingProps, IPickerProps, IRoundedProps } from "../../interfaces";
 import type { TDateMode } from "../../types";
-export interface IDatePickerProps extends ICommonsComponentProps, IColorProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IPickerProps, IDatePickerControlsProps, IDatePickerMonthProps, IDatePickerMonthsProps, IDatePickerYearsProps, IDatePickerHeaderProps {
+export interface IDatePickerProps extends ICommonsComponentProps, IColorProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IPickerProps, Omit<IDatePickerControlsProps, 'active'>, IDatePickerMonthProps, IDatePickerMonthsProps, IDatePickerYearsProps, IDatePickerHeaderProps {
     modelValue?: string | Date | Array<string | Date>;
 }
 /** Emits fired by `<OrigamDatePicker>` — main v-model + the three navigation

package/dist/src/interfaces/Dialog/dialog-confirmation.interface.d.ts CHANGED Viewed

@@ -4,6 +4,6 @@ export interface IDialogConfirmationProps extends IDialogProps {
 }
 /** Emits fired by `<OrigamDialogConfirmation>` — confirm/cancel buttons. */
 export interface IDialogConfirmationEmits {
-    (e: 'validate', event: MouseEvent): void;
-    (e: 'cancel', event: MouseEvent): void;
+    (e: 'validate', event?: MouseEvent): void;
+    (e: 'cancel', event?: MouseEvent): void;
 }

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

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { TEmptyStateAlign, TEmptyStatePreset, TEmptyStateSize, TIcon, TIntent } from '../../types';
 /**
  * Props for `<OrigamEmptyState>` — placeholder shown when a list, table
@@ -10,8 +10,15 @@ import type { TEmptyStateAlign, TEmptyStatePreset, TEmptyStateSize, TIcon, TInte
  * sides can be overridden via the `icon` and `iconColor` props for the
  * 5% case. Slots are provided to replace the icon (with an SVG / img),
  * title, description, or the entire layout for custom illustrations.
+ *
+ * Typography (`ITypographyProps`): `fontFamily` / `fontSize` / `fontWeight`
+ * / `lineHeight` apply to BOTH text surfaces (title + description) at once,
+ * each re-pointing the matching `--origam-empty-state__{title|description}---*`
+ * variable. `fontSize` overrides the size-driven font-size (generic-first).
+ * `letterSpacing` is inert here — neither text surface reads a
+ * `letter-spacing` rule.
  */
-export interface IEmptyStateProps extends ICommonsComponentProps, ITagProps {
+export interface IEmptyStateProps extends ICommonsComponentProps, ITagProps, ITypographyProps {
     /**
      * Visual preset. Bundles a default icon and intent — see
      * `EMPTY_STATE_PRESET_CONFIG`. The preset is the starting point;

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

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

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

@@ -1,5 +1,6 @@
-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 {
+import type { IActiveEmits, IActiveProps, IAdjacentInnerEmits, IAdjacentInnerProps, IAdjacentInnerSlots, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IFocusProps, ILabelProps, ILoaderProps, IRoundedProps, ISizeProps, ITypographyProps, IVariantProps } from '../../interfaces';
+import type { TColor } from '../../types';
+export interface IFieldProps extends ICommonsComponentProps, ILoaderProps, IColorProps, IBgColorProps, IAdjacentInnerProps, IFocusProps, IDensityProps, ILabelProps, IActiveProps, IVariantProps, IRoundedProps, IElevationProps, ISizeProps, ITypographyProps {
     centerAffix?: boolean;
     dirty?: boolean;
     disabled?: boolean;
@@ -22,6 +23,10 @@ export interface IFieldProps extends ICommonsComponentProps, ILoaderProps, IColo
     reverse?: boolean;
     singleLine?: boolean;
     required?: boolean;
+    /** @deprecated Use the `active` object prop instead. Kept for back-compat. */
+    activeColor?: TColor;
+    /** @deprecated Use the `active` object prop instead. Kept for back-compat. */
+    activeBgColor?: TColor;
 }
 /**
  * Aggregate of every emit a `<OrigamField>` is expected to relay. Bundles

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

@@ -1,5 +1,5 @@
-import type { IColorProps, ICommonsComponentProps } from '../../interfaces';
-export interface IFileFieldDragNDropItemProps extends ICommonsComponentProps, IColorProps {
+import type { IColorProps, ICommonsComponentProps, ITypographyProps } from '../../interfaces';
+export interface IFileFieldDragNDropItemProps extends ICommonsComponentProps, IColorProps, ITypographyProps {
     file: File;
     index: number;
     progress?: number;

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

@@ -1,5 +1,5 @@
-import type { IColorProps, ICommonsComponentProps } from '../../interfaces';
-export interface IFileFieldListItemProps extends ICommonsComponentProps, IColorProps {
+import type { IColorProps, ICommonsComponentProps, ITypographyProps } from '../../interfaces';
+export interface IFileFieldListItemProps extends ICommonsComponentProps, IColorProps, ITypographyProps {
     file: File;
     index: number;
     progress?: number;

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

@@ -76,7 +76,7 @@ export interface IFileFieldSlots extends IFieldSlots, Omit<IInputSlots, 'default
         id: string;
         isDisabled: boolean;
         isDirty: boolean;
-        isValid: boolean;
+        isValid: boolean | undefined;
         isReadonly: boolean;
     }) => any;
     dropzone?: (data: {

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

@@ -1,5 +1,5 @@
 import type { ComponentInternalInstance, ComputedRef, Raw, Ref } from 'vue';
-import type { ICommonsComponentProps, ICommonsComponentSlots } from '../../interfaces';
+import type { ICommonsComponentProps, ICommonsComponentSlots, ITypographyProps } from '../../interfaces';
 import type { TValidateOn } from '../../types';
 export interface IFormProvide {
     register: (item: {
@@ -18,7 +18,7 @@ export interface IFormProvide {
     isValid: Ref<boolean | null | undefined>;
     validateOn: Ref<TValidateOn | undefined>;
 }
-export interface IFormProps extends ICommonsComponentProps {
+export interface IFormProps extends ICommonsComponentProps, ITypographyProps {
     disabled?: boolean;
     fastFail?: boolean;
     readonly?: boolean;

package/dist/src/interfaces/Grids/row.interface.d.ts CHANGED Viewed

@@ -1,6 +1,6 @@
-import type { IAlignProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IJustifyProps, IMarginProps, IPaddingProps, ITagProps } from '../../interfaces';
+import type { IAlignProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IJustifyProps, IMarginProps, IPaddingProps, ITagProps } from '../../interfaces';
 import type { TFlexDirection } from '../../types';
-export interface IRowProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IColorProps, IDensityProps, IAlignProps, IJustifyProps {
+export interface IRowProps extends ICommonsComponentProps, ITagProps, IPaddingProps, IMarginProps, IBorderProps, IColorProps, IBgColorProps, IDensityProps, IAlignProps, IJustifyProps {
     gutters?: string | number;
     direction?: TFlexDirection;
 }

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

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

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

@@ -1,4 +1,4 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { ICommonsComponentProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { TInlineEditInputType } from '../../types';
 /**
  * Signature of a validator passed to `<OrigamInlineEdit>` (and to the
@@ -11,6 +11,14 @@ import type { TInlineEditInputType } from '../../types';
  * resolves.
  */
 export type TInlineEditValidator = (value: string) => true | string | Promise<true | string>;
+/**
+ * A single validation rule for `<OrigamInlineEdit>`. Matches the
+ * contract shared by all DS form fields (`IValidationProps.rules`):
+ * a function that receives the current string value and returns
+ * `true` when it passes, or an error message string when it fails.
+ * Async rules (returning a `Promise`) are supported.
+ */
+export type TInlineEditRule = (value: string) => true | string | Promise<true | string>;
 /**
  * Props for `<OrigamInlineEdit>` — edit-in-place pattern.
  *
@@ -22,7 +30,7 @@ export type TInlineEditValidator = (value: string) => true | string | Promise<tr
  * is true) — wrapping a heavier component (TextField, …) is not
  * needed and would defeat the keyboard-driven UX.
  */
-export interface IInlineEditProps extends ICommonsComponentProps, ITagProps {
+export interface IInlineEditProps extends ICommonsComponentProps, ITagProps, ITypographyProps {
     /**
      * Current value (v-model target). Accepts both `string` and
      * `number` for ergonomics — the internal draft is normalised to a
@@ -36,6 +44,19 @@ export interface IInlineEditProps extends ICommonsComponentProps, ITagProps {
      * `t()` if they need i18n.
      */
     placeholder?: string;
+    /**
+     * Array of validation rules using the standard DS contract
+     * (same as `OrigamTextField` / `OrigamInput` rules). Each rule
+     * is a function receiving the current string value and returning
+     * `true` (pass) or an error message string (fail). Rules are
+     * evaluated sequentially on confirm; the first failure surfaces
+     * as the inline error and blocks the commit.
+     *
+     * When both `rules` and `validate` are provided, `rules` are
+     * evaluated first. If any rule fails, `validate` is skipped.
+     * Only the first error message is displayed.
+     */
+    rules?: Array<TInlineEditRule>;
     /**
      * Validation callback. Returns `true` (or `Promise<true>`) when
      * the draft is acceptable, or an error message string that will
@@ -43,6 +64,9 @@ export interface IInlineEditProps extends ICommonsComponentProps, ITagProps {
      *
      * Sync validators run on every Enter / blur. Async validators
      * keep the editor open until the returned Promise settles.
+     *
+     * When both `rules` and `validate` are provided, `rules` are
+     * evaluated first. `validate` only runs if all rules pass.
      */
     validate?: TInlineEditValidator;
     /**
@@ -219,6 +243,11 @@ export interface IInlineEditSlots {
  * Options for the `useInlineEdit` composable.
  */
 export interface IUseInlineEditOptions {
+    /**
+     * Array of validation rules — evaluated in order before `validate`.
+     * First failure blocks the commit and surfaces the error message.
+     */
+    rules?: Array<TInlineEditRule>;
     /** Sync or async validator — see `TInlineEditValidator`. */
     validate?: TInlineEditValidator;
     /**

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

@@ -1,5 +1,5 @@
-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 {
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IDimensionProps, IDirectionProps, IElevationProps, IFocusEmits, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ITypographyProps, IValidationProps } from '../../interfaces';
+export interface IInputProps extends ICommonsComponentProps, IDensityProps, IPaddingProps, IMarginProps, IRoundedProps, IColorProps, IBgColorProps, IBorderProps, IElevationProps, IDimensionProps, IDirectionProps, IValidationProps, IAdjacentProps, ISizeProps, ITypographyProps {
     centerAffix?: boolean;
     hideDetails?: boolean | string;
     hideSpinButtons?: boolean;
@@ -23,9 +23,10 @@ export interface IInputEmits extends ICommonsComponentEmits, IAdjacentEmits, IFo
 export interface IInputSlots extends IAdjacentSlots {
     default?: (data: {
         id: string;
+        messagesId: string;
         isDisabled: boolean;
         isDirty: boolean;
-        isValid: boolean;
+        isValid: boolean | undefined;
         isReadonly: boolean;
     }) => any;
     messages?: (data: {

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

@@ -1,6 +1,6 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IRoundedProps, ISizeProps } from '../../interfaces';
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IRoundedProps, ISizeProps, ITypographyProps } from '../../interfaces';
 import type { TKbdVariant } from '../../types';
-export interface IKbdProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IBorderProps, IRoundedProps {
+export interface IKbdProps extends ICommonsComponentProps, IColorProps, IBgColorProps, ISizeProps, IBorderProps, IRoundedProps, ITypographyProps {
     /** 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']). */

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

@@ -1,5 +1,5 @@
-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 {
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, ICommonsComponentSlots, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
+export interface ILabelProps extends ICommonsComponentProps, IMarginProps, IPaddingProps, IBorderProps, IRoundedProps, IColorProps, IBgColorProps, ITagProps, ITypographyProps {
     text?: string;
     floating?: boolean;
     required?: boolean;

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

@@ -12,5 +12,8 @@ export interface IListActivatorProps extends ICommonsComponentProps, ITagProps {
 /** Emits fired by `<OrigamListGroup>` — click on the activator chrome
  *  (used by parents to toggle the open state). */
 export interface IListGroupEmits {
-    (e: 'click:activator', event: MouseEvent): void;
+    (e: 'click:activator', payload: {
+        open: boolean;
+        event: Event;
+    }): void;
 }