origam 2.5.0 → 2.6.2

package/dist/src/interfaces/Code/code.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../index';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../index';
 import type { TCodeLang } from '../../types';
 /**
  * Props for `<OrigamCode>` — a shiki-powered code block with line numbers,
@@ -9,7 +9,7 @@ import type { TCodeLang } from '../../types';
  * conservative default so existing call sites keep their behaviour
  * (plain-text, no line numbers, copy button visible).
  */
-export interface ICodeProps extends ICommonsComponentProps, ITagProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IDimensionProps, IColorProps, IBgColorProps {
+export interface ICodeProps extends ICommonsComponentProps, ITagProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps, IDimensionProps, IColorProps, IBgColorProps, ITypographyProps {
     /**
      * The code to highlight. When omitted, the default slot is used as the
      * source — useful for multi-line snippets that are nicer to read in
@@ -59,6 +59,23 @@ export interface ICodeProps extends ICommonsComponentProps, ITagProps, IBorderPr
      * top-right corner of the code surface.
      */
     filename?: string;
+    /**
+     * Render the block as a single-line **pill** instead of a multi-line
+     * surface — ideal for a copyable install command (`npm install origam`).
+     * In compact mode the header, filename and line-numbers are suppressed,
+     * vertical padding shrinks to one line, the surface keeps its themed
+     * tokens, and the copy control collapses to a small icon button anchored
+     * inline at the end of the row (not a floating text "Copy"). The `<figure>
+     * <pre><code>` semantics are preserved.
+     */
+    compact?: boolean;
+    /**
+     * Decorative prompt prefix rendered BEFORE the code (e.g. `'$'` for a
+     * shell command). Purely visual: it is NOT part of the highlighted code
+     * and is NEVER included in the clipboard copy (only `code` is copied).
+     * Most useful paired with `compact` for an install-command pill.
+     */
+    prompt?: string;
 }
 /**
  * Public surface of the `useCode` composable. Lazily instantiates a shiki

package/dist/src/interfaces/ColorPickerField/color-picker-field.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IAdjacentInnerProps, IAdjacentProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IFieldProps, IInputProps, IMarginProps, IMenuProps, IPaddingProps, IRoundedProps, ITextFieldProps, ITransitionComponentProps } from "../../interfaces";
-export interface IColorPickerFieldProps extends ICommonsComponentProps, IColorProps, ITextFieldProps, IDensityProps, IAdjacentProps, IAdjacentInnerProps, IFieldProps, IInputProps, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, ITransitionComponentProps {
+import type { IMenuProps, ITextFieldProps, ITransitionComponentProps } from "../../interfaces";
+export interface IColorPickerFieldProps extends ITextFieldProps, ITransitionComponentProps {
     menu?: boolean;
     menuProps?: IMenuProps;
     openOnClear?: boolean;

package/dist/src/interfaces/CommandPalette/command-palette.interface.d.ts

@@ -1,5 +1,6 @@
 import type { ICommand } from './command.interface';
 import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { ITypographyProps } from '../Commons/typography.interface';
 /**
  * A hotkey is either a single combination (`['meta', 'k']`) or an
  * array of alternatives — every entry being a list of normalised key
@@ -10,7 +11,7 @@ import type { ICommonsComponentProps } from '../Commons/commons.interface';
  * the listeners so consumers can pass either form interchangeably.
  */
 export type TCommandPaletteHotkey = ReadonlyArray<string> | ReadonlyArray<ReadonlyArray<string>>;
-export interface ICommandPaletteProps extends ICommonsComponentProps {
+export interface ICommandPaletteProps extends ICommonsComponentProps, ITypographyProps {
     /** v-model — whether the palette is open. */
     modelValue?: boolean;
     /**

package/dist/src/interfaces/Commons/calendar.interface.d.ts

@@ -3,12 +3,12 @@ export interface ICalendarProps {
     allowedDates?: Array<unknown> | ((date: unknown) => boolean);
     disabled?: boolean;
     displayValue?: unknown;
-    date?: Array<unknown>;
-    month: number;
+    date?: ReadonlyArray<unknown> | Array<unknown>;
+    month?: number;
     max?: unknown;
     min?: unknown;
     showAdjacentMonths?: boolean;
-    year: number;
+    year?: number;
     weekdays?: Array<number>;
     weeksInMonth?: TCalendarStrategy;
     firstDayOfWeek?: number;

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

@@ -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

@@ -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

@@ -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

@@ -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

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

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

@@ -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/validation.interface.d.ts

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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;