origam 2.15.0 → 2.17.0

package/dist/src/interfaces/DataTable/data-table-rows.interface.d.ts

@@ -0,0 +1,100 @@
+import type { IDataTableGroup, IDataTableGroupHeaderRowGroupSlot, IDataTableGroupHeaderRowSelectSlot, IDataTableGroupHeaderSlot } from './group.interface';
+import type { IDataTableHeaderCellColumnSlot, IDataTableItem, IDataTableItemBaseSlot, IDataTableItemKey, IDataTableItemSlot } from './items.interface';
+import type { IDisplayProps } from '../Commons/display.interface';
+import type { ILoaderProps } from '../Commons/loader.interface';
+import type { TDataTableCell, TDataTableRow } from '../../types/DataTable/data-table.type';
+/*********************************************************
+ * IDataTableRowsProps
+ *
+ * @description
+ * Props for `<OrigamDataTableRows>` — the only consumer. Split out of
+ * `interfaces/DataTable/row.interface.ts` under issue #364, which used
+ * to hold two distinct component surfaces (Rows / Row) in one file.
+ ********************************************************/
+/*********************************************************
+ * IDataTableRowsProps
+ *
+ * @description
+ * ⛔ `class`, `style` et `tag` sont RETIRES de la surface heritee de
+ * `ILoaderProps` (qui etend lui-meme `ICommonsComponentProps` et
+ * `ITagProps`). `<OrigamDataTableRows>` rend un FRAGMENT — jusqu'a cinq
+ * `<tr>` squelettes, ou une ligne par item — sans racine unique, donc sans
+ * rien sur quoi Vue puisse appliquer un fallthrough. `tag` n'a pas d'objet
+ * non plus : le contenu d'un `<tbody>` ne peut etre qu'un `<tr>`.
+ *
+ * @description
+ * Les declarer etait PIRE que de les omettre : une prop declaree sort de
+ * `$attrs`, donc un consommateur qui ecrivait `class="x"` perdait sa classe
+ * en silence, sans meme l'avertissement « Extraneous non-props attributes »
+ * que Vue emet sur un fragment. Mesure : `packages/tests/TU/components/
+ * DataTable/data-table-rows-dead-props.spec.ts`. Meme cas structurel
+ * qu'`<OrigamDefaultsProvider>`, dont le template est un `<slot/>` nu.
+ * Issue #550, critere C1.
+ *
+ * @description
+ * `id` reste : il sert de racine aux identifiants de ligne generes
+ * (`${id}-row-${index}`, `${id}-skeleton-row-${index}`). `color` reste et
+ * est desormais CABLE — il peint la ligne de chargement et la ligne
+ * « aucune donnee » via `useTextColor`, ce que le controle « Loader Color »
+ * de la story annoncait deja sans effet.
+ ********************************************************/
+export interface IDataTableRowsProps extends Omit<ILoaderProps, 'class' | 'style' | 'tag'>, IDisplayProps {
+    hideNoData?: boolean;
+    items?: Array<IDataTableItem | IDataTableGroup> | readonly (IDataTableItem | IDataTableGroup)[];
+    noDataText?: string;
+    rowProps?: TDataTableRow<any>;
+    cellProps?: TDataTableCell<any>;
+}
+/*********************************************************
+ * IDataTableRowsSlots
+ *
+ * @description
+ * Signatures de slots pour `<OrigamDataTableRows>` — le rendu au niveau de
+ * la liste : lignes de chargement, d'absence de donnees, d'items, de groupes
+ * et de depliage.
+ *
+ * @description
+ * ⛔ Quatre entrees ne sont rendues par AUCUN `<slot>` de ce composant : elles
+ * sont declarees ici pour que leur nom survive au saut depuis
+ * `<OrigamDataTable>`. `data-table-group` (la bascule du groupe) et
+ * `data-table-select` (sa case tout selectionner) repartent vers
+ * `<OrigamDataTableGroupHeaderRow>` ; la famille indexee `item.{cle}` — ou
+ * `{cle}` est la `key` d'une definition de colonne, connue au seul runtime —
+ * et le titre de colonne de la disposition mobile repartent vers
+ * `<OrigamDataTableRow>`.
+ ********************************************************/
+export interface IDataTableRowsSlots<T = any> {
+    loading?: () => any;
+    'no-data'?: () => any;
+    'group-header'?: (props: IDataTableGroupHeaderSlot) => any;
+    item?: (props: IDataTableItemSlot<T>) => any;
+    'expanded-row'?: (props: IDataTableItemBaseSlot<T>) => any;
+    'data-table-group'?: (props: IDataTableGroupHeaderRowGroupSlot) => any;
+    'data-table-select'?: (props: IDataTableGroupHeaderRowSelectSlot) => any;
+    [key: `item.${string}`]: ((props: IDataTableItemKey) => any) | undefined;
+    [key: `header.${string}`]: ((props: IDataTableHeaderCellColumnSlot) => any) | undefined;
+}
+/*********************************************************
+ * IDataTableRowsEmits
+ *
+ * @description
+ * Group interaction travels through `useExpanded` / `useSelection` /
+ * `useGroupBy` (shared provide/inject state) and the `:row.*` /
+ * `:group-header.*` attr-forwarded handlers.
+ *
+ * @description
+ * `expand` / `select` are the exception: they are ROW-level events, and
+ * `<OrigamDataTableRow>` is mounted here, so this component is the only
+ * place that can carry them up to `<OrigamDataTable>`. Both are re-fired
+ * verbatim — same payload, no enrichment.
+ ********************************************************/
+export interface IDataTableRowsEmits {
+    (e: 'expand', payload?: {
+        item: IDataTableItem;
+        value: boolean;
+    }): void;
+    (e: 'select', payload?: {
+        item: IDataTableItem;
+        value: boolean;
+    }): void;
+}

package/dist/src/interfaces/DataTable/data-table.interface.d.ts

@@ -1,5 +1,17 @@
 import type { UnwrapRef } from 'vue';
-import type { ICommonsComponentEmits, IDataTableExpandProps, IDataTableFooterProps, IDataTableGroup, IDataTableGroupableItem, IDataTableGroupProps, IDataTableHeaderProps, IDataTableHeadersProps, IDataTableHeadersSlotProps, IDataTableItem, IDataTableItemsProps, IDataTablePaginationProps, IDataTableProvideExpanded, IDataTableProvideGroup, IDataTableProvidePagination, IDataTableProvideSelection, IDataTableProvideSort, IDataTableRowProps, IDataTableSelectProps, IDataTableSortItem, IDataTableSortProps, IFiltersProps, IInternalDataTableHeader, ITableProps } from '../../interfaces';
+import type { ICommonsComponentEmits } from '../Commons/commons.interface';
+import type { IDataTableExpandProps, IDataTableProvideExpanded } from './expand.interface';
+import type { IDataTableFooterProps } from './footer.interface';
+import type { IDataTableGroup, IDataTableGroupableItem, IDataTableGroupHeaderRowGroupSlot, IDataTableGroupHeaderRowSelectSlot, IDataTableGroupHeaderSlot, IDataTableGroupProps, IDataTableProvideGroup } from './group.interface';
+import type { IDataTableHeaderProps, IInternalDataTableHeader } from './data-table-header.interface';
+import type { IDataTableHeadersProps, IDataTableHeadersSlotProps } from './data-table-headers.interface';
+import type { IDataTableItem, IDataTableItemBaseSlot, IDataTableItemKey, IDataTableItemSlot, IDataTableItemsProps } from './items.interface';
+import type { IDataTablePaginationProps, IDataTableProvidePagination } from './pagination.interface';
+import type { IDataTableProvideSelection, IDataTableSelectProps } from './select.interface';
+import type { IDataTableProvideSort, IDataTableSortItem, IDataTableSortProps } from './sort.interface';
+import type { IDataTableRowProps } from './data-table-row.interface';
+import type { IFiltersProps } from '../Commons/filters.interface';
+import type { ITableProps } from '../Table/table.interface';
 export interface IDataTableProps extends ITableProps, IDataTableRowProps, IDataTableExpandProps, IDataTableGroupProps, IDataTableHeaderProps, IDataTableItemsProps, IDataTableSelectProps, IDataTableSortProps, IDataTableHeadersProps, IDataTablePaginationProps, IFiltersProps, IDataTableFooterProps {
     hideDefaultBody?: boolean;
     hideDefaultFooter?: boolean;
@@ -46,24 +58,88 @@ export interface IDataTableSlotProps<T> {
     columns: Array<IInternalDataTableHeader>;
     headers: Array<Array<IInternalDataTableHeader>>;
 }
-/** Emits fired by `<OrigamDataTable>` — pagination, sorting, grouping,
- *  expansion, selection, and the v-model that ties them together. */
+/*********************************************************
+ * IDataTableEmits
+ *
+ * @description
+ * Emits de `<OrigamDataTable>` — pagination, tri, expansion, selection, et
+ * le v-model qui les relie.
+ *
+ * @description
+ * `expand` et `select` signalent l'activation de la bascule de depliage et
+ * de la case a cocher d'une ligne, relayees depuis `<OrigamDataTableRow>` a
+ * travers `<OrigamDataTableRows>` ; leur charge nomme la ligne et l'etat
+ * atteint. ⛔ Leur relation aux `update:` correspondants est constante :
+ * `update:expanded` et `update:modelValue` portent l'ENSEMBLE resultant,
+ * ces deux-la portent la ligne qui l'a provoque.
+ *
+ * @description
+ * ⛔ `update:groupBy` n'est deliberement PAS declare ici. `groupBy` est une
+ * prop en lecture seule vue de l'interieur : `toggleGroup()` (expose par
+ * `provideGroupBy`) ne fait qu'ouvrir ou fermer une section deja groupee —
+ * il n'ecrit jamais `groupBy.value`, et rien d'autre dans l'arbre ne le fait
+ * (`grep -rn "groupBy\.value\s*=" packages/ds/src/` ne rend aucune ligne).
+ * Declarer un emit que Vue n'emet jamais ne fait que retirer l'ecouteur
+ * `@update:group-by` d'un consommateur de `$attrs`, pour rien — voir le
+ * garde `unemitted-declarations`. Retire par l'audit qui a corrige
+ * #373/#376/#416/#430/#446.
+ ********************************************************/
 export interface IDataTableEmits extends ICommonsComponentEmits {
     (e: 'update:page', value: number): void;
     (e: 'update:itemsPerPage', value: number): void;
     (e: 'update:sortBy', value: UnwrapRef<IDataTableProvideSort['sortBy']>): void;
     (e: 'update:options', value: Record<string, unknown>): void;
-    (e: 'update:groupBy', value: UnwrapRef<IDataTableProvideGroup['groupBy']>): void;
     (e: 'update:expanded', value: ReadonlySet<unknown>): void;
     (e: 'update:currentItems', value: Array<IDataTableItem>): void;
+    (e: 'expand', payload?: {
+        item: IDataTableItem;
+        value: boolean;
+    }): void;
+    (e: 'select', payload?: {
+        item: IDataTableItem;
+        value: boolean;
+    }): void;
 }
-/** Slot signatures for `<OrigamDataTable>`. `default` / `colgroup` /
- *  `thead` / `prepend` / `body` / `append` all share `IDataTableSlotProps`
- *  (pagination, sort, selection and expansion state + actions). `header`
- *  and `header.mobile` forward `<OrigamDataTableHeaders>`'s own scope
- *  1:1. `top`, `header.loader` and `bottom` render with no scope — the
- *  header's own `loader` slot (forwarded as `header.loader`) never binds
- *  props from its default `<origam-progress>` render either. */
+/*********************************************************
+ * IDataTableSlots
+ *
+ * @description
+ * Signatures de slots pour `<OrigamDataTable>`. `default` / `colgroup` /
+ * `thead` / `prepend` / `body` / `append` partagent tous
+ * `IDataTableSlotProps` (etat et actions de pagination, tri, selection,
+ * expansion). `header` et `header.mobile` relaient 1:1 la portee propre
+ * d'`<OrigamDataTableHeaders>`. `top`, `header.loader` et `bottom` rendent
+ * sans portee — le slot `loader` de l'en-tete, relaye en `header.loader`,
+ * ne lie rien non plus depuis son `<origam-progress>` par defaut.
+ *
+ * @description
+ * Les quatre slots de LIGNE sont relayes a `<OrigamDataTableRows>`, qui les
+ * possede : `loading` remplace la ligne « chargement », `no-data` la ligne
+ * « aucune donnee », `item` une ligne de donnees entiere (`<tr>` compris,
+ * avec la liaison exacte qu'aurait recue le `<OrigamDataTableRow>` par
+ * defaut), et `expanded-row` la ligne supplementaire rendue sous une ligne
+ * depliee. ⛔ Tous rendent DANS `<tbody>` : leur contenu doit avoir la forme
+ * d'un `<tr>`.
+ *
+ * @description
+ * `group-header` remplace une ligne d'en-tete de groupe. Ses deux cellules
+ * — `data-table-group` (la bascule) et `data-table-select` (le tout
+ * selectionner) — voyagent sur DEUX sauts, via `<OrigamDataTableRows>` puis
+ * `<OrigamDataTableGroupHeaderRow>`.
+ *
+ * @description
+ * Deux familles indexees par colonne ferment l'interface. `item.{cle}` porte
+ * le contenu d'une cellule, `{cle}` etant la `key` d'une definition de
+ * colonne ; `item.data-table-select` et `item.data-table-expand` adressent
+ * les deux colonnes systeme integrees. `header.{cle}` porte le contenu d'un
+ * en-tete et atteint les DEUX bouts de la table : le `<th>`, et le titre par
+ * cellule dans la disposition mobile.
+ *
+ * @description
+ * ⛔ `header.mobile` et `header.loader` ne font PAS partie de cette derniere
+ * famille : ce sont les deux slots nommes plus haut, adresses a
+ * `<OrigamDataTableHeaders>` lui-meme.
+ ********************************************************/
 export interface IDataTableSlots<T = any> {
     top?: () => any;
     default?: (props: IDataTableSlotProps<T>) => any;
@@ -76,4 +152,13 @@ export interface IDataTableSlots<T = any> {
     body?: (props: IDataTableSlotProps<T>) => any;
     append?: (props: IDataTableSlotProps<T>) => any;
     bottom?: () => any;
+    loading?: () => any;
+    'no-data'?: () => any;
+    item?: (props: IDataTableItemSlot<T>) => any;
+    'group-header'?: (props: IDataTableGroupHeaderSlot) => any;
+    'expanded-row'?: (props: IDataTableItemBaseSlot<T>) => any;
+    'data-table-group'?: (props: IDataTableGroupHeaderRowGroupSlot) => any;
+    'data-table-select'?: (props: IDataTableGroupHeaderRowSelectSlot) => any;
+    [key: `item.${string}`]: ((props: IDataTableItemKey) => any) | undefined;
+    [key: `header.${string}`]: ((props: any) => any) | undefined;
 }

package/dist/src/interfaces/DataTable/expand.interface.d.ts

@@ -1,6 +1,6 @@
 import type { Ref } from 'vue';
-import type { IDataTableItem } from '../../interfaces';
-import type { TVModel } from '../../types';
+import type { IDataTableItem } from './items.interface';
+import type { TVModel } from '../../types/Commons/v-model.type';
 export interface IDataTableExpandProps {
     expandOnClick?: boolean;
     showExpand?: boolean;

package/dist/src/interfaces/DataTable/footer.interface.d.ts

@@ -1,5 +1,9 @@
-import type { IAdjacentSlots, IAlignProps, IColorProps, ICommonsComponentProps, IPaddingProps } from "../../interfaces";
-import type { TIcon } from "../../types";
+import type { IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IAlignProps } from '../Commons/align.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface IDataTableFooterProps extends ICommonsComponentProps, IColorProps, IPaddingProps, IAlignProps {
     prevIcon?: TIcon;
     nextIcon?: TIcon;
@@ -22,3 +26,13 @@ export interface IDataTableFooterProps extends ICommonsComponentProps, IColorPro
  *  row), so the shared `IAdjacentSlots` contract applies unchanged. */
 export interface IDataTableFooterSlots extends IAdjacentSlots {
 }
+/*********************************************************
+ * IDataTableFooterEmits
+ *
+ * @description
+ * `<OrigamDataTableFooter>` delegates every interaction to the nested
+ * `<origam-select>` / `<origam-pagination>` (both handled internally
+ * via composables) — nothing is emitted upward.
+ ********************************************************/
+export interface IDataTableFooterEmits {
+}

package/dist/src/interfaces/DataTable/group.interface.d.ts

@@ -1,6 +1,11 @@
 import type { ComputedRef, Ref } from 'vue';
-import type { IColorProps, ICommonsComponentProps, IDataTableItem, IDataTableItemBase, IDataTableSelectableItem, IDataTableSortItem, IInternalDataTableHeader, IPaddingProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDataTableItem, IDataTableItemBase } from './items.interface';
+import type { IDataTableSelectableItem } from './select.interface';
+import type { IDataTableSortItem } from './sort.interface';
+import type { IInternalDataTableHeader } from './data-table-header.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface IDataTableGroupProps {
     groupBy?: Array<IDataTableSortItem>;
 }
@@ -35,15 +40,38 @@ export interface IDataTableGroupHeaderSlot<T = IDataTableGroup> extends IDataTab
     toggleGroup: (group: IDataTableGroup) => void;
     isGroupOpen: (group: IDataTableGroup) => boolean;
 }
-export interface IDataTableGroupHeaderRowProps<T = IDataTableGroup> extends ICommonsComponentProps, IColorProps, IPaddingProps {
+/*********************************************************
+ * IDataTableGroupHeaderRowProps
+ *
+ * @description
+ * ⛔ BREAKING (garde `unconsumed-props`) — cinq entrees ont ete retirees
+ * de cette interface parce que le composant ne pouvait rien en faire :
+ *
+ *   - `IPaddingProps` (7 props). La racine rendue est un `<tr>` : le
+ *     modele de boite CSS ignore `padding` sur `display: table-row`. La
+ *     binder aurait produit un vert de facade. Le padding des cellules
+ *     est deja porte par `<OrigamDataTableColumnCell>`, qui consomme
+ *     `usePadding`. La ligne d'items sœur, `IDataTableRowProps`, n'a
+ *     jamais etendu `IPaddingProps` — l'asymetrie etait accidentelle.
+ *   - `internalItem`, `isExpanded`, `toggleExpand`. Une ligne d'en-tete de
+ *     groupe n'expose AUCUNE affordance d'expand : il n'y avait pas de
+ *     site de consommation a ecrire.
+ *   - `toggleSelect`. Sa signature `(item) => void` BASCULE un item ; la
+ *     case de groupe doit POSER une valeur sur toutes les lignes
+ *     (`select(rows, v)`). Sur un groupe partiellement selectionne, la
+ *     basculer par item inverserait chaque ligne au lieu de les aligner.
+ *
+ * @description
+ * `isSelected` et `toggleGroup` restent declarees et sont desormais
+ * reellement lues par le composant, la prop l'emportant sur le retour de
+ * `useSelection()` / `useGroupBy()` — ce qui rend l'usage autonome (hors
+ * `<OrigamDataTable>`) possible.
+ ********************************************************/
+export interface IDataTableGroupHeaderRowProps<T = IDataTableGroup> extends ICommonsComponentProps, IColorProps {
     index: number;
     item: T;
-    internalItem: IDataTableItem<T>;
     columns: IInternalDataTableHeader[];
-    isExpanded: (item: IDataTableItem) => boolean;
-    toggleExpand: (item: IDataTableItem) => void;
     isSelected: (items: IDataTableSelectableItem | Array<IDataTableSelectableItem>) => boolean;
-    toggleSelect: (item: IDataTableSelectableItem) => void;
     toggleGroup: (group: IDataTableGroup) => void;
 }
 /** Scope for the `data-table-group` slot — the group's own toggle button
@@ -70,3 +98,13 @@ export interface IDataTableGroupHeaderRowSlots<T = IDataTableGroup> {
     'data-table-group'?: (props: IDataTableGroupHeaderRowGroupSlot<T>) => any;
     'data-table-select'?: (props: IDataTableGroupHeaderRowSelectSlot) => any;
 }
+/*********************************************************
+ * IDataTableGroupHeaderRowEmits
+ *
+ * @description
+ * `<OrigamDataTableGroupHeaderRow>` toggles group/selection state through
+ * `useGroupBy` / `useSelection` (shared provide/inject state) — nothing
+ * is emitted upward.
+ ********************************************************/
+export interface IDataTableGroupHeaderRowEmits {
+}

package/dist/src/interfaces/DataTable/header-cell-base.interface.d.ts

@@ -0,0 +1,24 @@
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+/*********************************************************
+ * IHeaderCellProps
+ *
+ * @description
+ * Shared base extended by every header-related DataTable surface —
+ * `IDataTableHeadersProps`, `IDataTableHeadersCellProps`,
+ * `IDataTableHeaderCellProps`, and `IDataTableHeadersCellMobileProps`
+ * each add their own members on top. Intra-family sharing only (all
+ * four consumers live under `interfaces/DataTable/`), so this does
+ * not block the family-as-a-module split (issue #364 / ADR-006) — it
+ * just has no single "owning" component, hence its own file rather
+ * than living inside one of the four sibling files.
+ ********************************************************/
+export interface IHeaderCellProps extends ICommonsComponentProps, IColorProps {
+    disableSort?: boolean;
+    headerProps?: any;
+    sticky?: boolean;
+    multiSort?: boolean;
+    sortAscIcon?: TIcon;
+    sortDescIcon?: TIcon;
+}

package/dist/src/interfaces/DataTable/items.interface.d.ts

@@ -1,5 +1,11 @@
-import type { IDataTableGroupableItem, IDataTableSelectableItem, IDataTableSortItem, IInternalDataTableHeader, IInternalItem } from '../../interfaces';
-import type { TDataTableCell, TDataTableRow, TIcon, TSelectItemKey } from '../../types';
+import type { IDataTableGroupableItem } from './group.interface';
+import type { IDataTableSelectableItem } from './select.interface';
+import type { IDataTableSortItem } from './sort.interface';
+import type { IInternalDataTableHeader } from './data-table-header.interface';
+import type { IInternalItem } from '../List/list-children.interface';
+import type { TDataTableCell, TDataTableRow } from '../../types/DataTable/data-table.type';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TSelectItemKey } from '../../types/Commons/commons.type';
 export interface IDataTableItemsProps {
     items?: Array<IDataTableItem>;
     itemValue?: TSelectItemKey;

package/dist/src/interfaces/DataTable/select.interface.d.ts

@@ -1,4 +1,4 @@
-import type { TDataTableSelectStrategy } from '../../types';
+import type { TDataTableSelectStrategy } from '../../types/DataTable/data-table.type';
 import type { ComputedRef } from 'vue';
 export interface IDataTableSelectableItem {
     value?: any;

package/dist/src/interfaces/DataTable/sort.interface.d.ts

@@ -1,5 +1,6 @@
-import type { IInternalDataTableHeader } from '../../interfaces';
-import type { TDataTableCompareFunction, TSortDirection } from '../../types';
+import type { IInternalDataTableHeader } from './data-table-header.interface';
+import type { TDataTableCompareFunction } from '../../types/DataTable/data-table.type';
+import type { TSortDirection } from '../../types/Commons/sort.type';
 import type { Ref } from 'vue';
 export interface IDataTableSortProps {
     sortBy?: Array<IDataTableSortItem>;

package/dist/src/interfaces/DatePicker/date-picker-calendar.interface.cjs

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

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

@@ -0,0 +1,52 @@
+import type { TCalendarStrategy } from '../../types/Commons/calendar.type';
+/*********************************************************
+ * ICalendarProps / IDay
+ *
+ * @description
+ * Despite the name, this surface has nothing to do with the
+ * `<OrigamCalendar>` component (its own props live in
+ * `interfaces/Calendar/calendar.interface.ts` as
+ * `ICalendarComponentProps` — a much larger, unrelated event-calendar
+ * surface). This one is the day-grid mixin consumed exclusively by
+ * `useDatePickerCalendar` (`composables/Commons/date-picker-calendar.
+ * composable.ts`) and `<OrigamDatePickerMonth>`
+ * (`interfaces/DatePicker/date-picker-month.interface.ts`).
+ *
+ * @description
+ * Issue #364 relocated it from `interfaces/Commons/calendar.
+ * interface.ts` to this DatePicker-only home — it was never
+ * transverse, it was misfiled under a name that collided with the
+ * unrelated Calendar family.
+ ********************************************************/
+export interface ICalendarProps {
+    allowedDates?: Array<unknown> | ((date: unknown) => boolean);
+    disabled?: boolean;
+    displayValue?: unknown;
+    date?: ReadonlyArray<unknown> | Array<unknown>;
+    month?: number;
+    max?: unknown;
+    min?: unknown;
+    showAdjacentMonths?: boolean;
+    year?: number;
+    weekdays?: Array<number>;
+    weeksInMonth?: TCalendarStrategy;
+    firstDayOfWeek?: number;
+}
+export interface IDay {
+    date: unknown;
+    isoDate: string;
+    formatted: string;
+    year: number;
+    month: number;
+    isDisabled: boolean;
+    isWeekStart: boolean;
+    isWeekEnd: boolean;
+    isToday: boolean;
+    isAdjacent: boolean;
+    isHidden: boolean;
+    isStart: boolean;
+    isSelected: boolean;
+    isEnd: boolean;
+    isSame: boolean;
+    localized: string;
+}

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

@@ -1,5 +1,7 @@
-import type { IActiveState, ICommonsComponentProps } from "../../interfaces";
-import type { TDateMode, TIcon } from "../../types";
+import type { IActiveState } from '../Commons/state-effect.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { TDateMode } from '../../types/DatePicker/date-picker.type';
+import type { TIcon } from '../../types/Icon/icon.type';
 export interface IDatePickerControlsProps extends ICommonsComponentProps {
     /**
      * Highlighted item(s) in the controls toolbar. Widened to include
@@ -19,8 +21,11 @@ export interface IDatePickerControlsProps extends ICommonsComponentProps {
     text?: string;
     viewMode?: TDateMode;
 }
-/** Emits fired by `<OrigamDatePickerControls>` — clicks on the five
- *  toolbar buttons (year / month / prev / next / text label).
+/** Emits fired by `<OrigamDatePickerControls>` — clicks on the four
+ *  toolbar buttons (year / month / prev / next). The month button
+ *  itself carries the `text` label (see `IDatePickerControlsProps.text`);
+ *  there is no button dedicated solely to the label, so there is no
+ *  separate `click:text` — a click on the label fires `click:month`.
  *  `event` is optional: the click handlers call `emits('click:prev')`
  *  etc. without forwarding the originating MouseEvent. */
 export interface IDatePickerControlsEmits {
@@ -28,5 +33,13 @@ export interface IDatePickerControlsEmits {
     (e: 'click:month', event?: MouseEvent): void;
     (e: 'click:prev', event?: MouseEvent): void;
     (e: 'click:next', event?: MouseEvent): void;
-    (e: 'click:text', event?: MouseEvent): void;
+}
+/*********************************************************
+ * IDatePickerControlsSlots
+ *
+ * @description
+ * `<OrigamDatePickerControls>` renders its own fixed toolbar (month
+ * label, mode toggle, prev/next buttons) — no `<slot>` in its template.
+ ********************************************************/
+export interface IDatePickerControlsSlots {
 }

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

@@ -1,5 +1,8 @@
-import type { IAdjacentProps, IAdjacentSlots, IColorProps, ICommonsComponentProps, IDensityProps } from "../../interfaces";
-import type { TTransitionProps } from "../../types";
+import type { IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { TTransitionProps } from '../../types/Transition/transition.type';
 export interface IDatePickerHeaderProps extends ICommonsComponentProps, IColorProps, IAdjacentProps, IDensityProps {
     header?: string;
     transition?: TTransitionProps;

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

@@ -1,5 +1,7 @@
-import type { ICalendarProps, IColorProps, ICommonsComponentProps, IDay } from "../../interfaces";
-import type { TTransitionProps } from "../../types";
+import type { ICalendarProps, IDay } from './date-picker-calendar.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { TTransitionProps } from '../../types/Transition/transition.type';
 export interface IDatePickerMonthProps extends ICommonsComponentProps, IColorProps, ICalendarProps {
     hideWeekdays?: boolean;
     multiple?: boolean | number | (string & {});
@@ -21,3 +23,23 @@ export interface IDatePickerMonthDaySlot {
 export interface IDatePickerMonthSlots {
     days?: (props: IDatePickerMonthDaySlot) => any;
 }
+/*********************************************************
+ * IDatePickerMonthEmits
+ *
+ * @description
+ * Emits fired by `<OrigamDatePickerMonth>`. `update:date` is the real
+ * v-model write-back: `useDatePickerCalendar` wires `date` through
+ * `useVModel`, and every click handler in this component (single /
+ * multiple / range selection) assigns `model.value = …`, which
+ * `useVModel`'s setter turns into `emit('update:date', …)`.
+ * @description
+ * `year` and `month` are ALSO wired through `useVModel` inside the same
+ * composable (so `update:year` / `update:month` exist on the emit
+ * surface at the Vue runtime level), but this component only ever
+ * READS `year.value` / `month.value` — it never assigns to them. They
+ * are therefore deliberately left off this interface: declaring them
+ * here would document an emit this component never actually fires.
+ ********************************************************/
+export interface IDatePickerMonthEmits {
+    (e: 'update:date', value: ReadonlyArray<unknown> | Array<unknown>): void;
+}

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

@@ -1,5 +1,7 @@
-import type { IColorProps, ICommonsComponentProps, IDimensionProps } from "../../interfaces";
-import type { TColor } from "../../types";
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { TColor } from '../../types/Commons/color.type';
 export interface IDatePickerMonthsProps extends ICommonsComponentProps, IColorProps, IDimensionProps {
     min?: unknown;
     max?: unknown;

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

@@ -1,5 +1,7 @@
-import type { IColorProps, ICommonsComponentProps, IDimensionProps } from "../../interfaces";
-import type { TColor } from "../../types";
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { TColor } from '../../types/Commons/color.type';
 export interface IDatePickerYearsProps extends ICommonsComponentProps, IColorProps, IDimensionProps {
     min?: unknown;
     max?: unknown;

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

@@ -1,5 +1,18 @@
-import type { IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDatePickerControlsProps, IDatePickerHeaderProps, IDatePickerMonthProps, IDatePickerMonthsProps, IDatePickerYearsProps, IElevationProps, IMarginProps, IPaddingProps, IPickerProps, IRoundedProps } from "../../interfaces";
-import type { TDateMode, TTransitionProps } from "../../types";
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDatePickerControlsProps } from './date-picker-controls.interface';
+import type { IDatePickerHeaderProps } from './date-picker-header.interface';
+import type { IDatePickerMonthProps } from './date-picker-month.interface';
+import type { IDatePickerMonthsProps } from './date-picker-months.interface';
+import type { IDatePickerYearsProps } from './date-picker-years.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IPickerProps } from '../Picker/picker.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TDateMode } from '../../types/DatePicker/date-picker.type';
+import type { TTransitionProps } from '../../types/Transition/transition.type';
 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>;
 }

package/dist/src/interfaces/DatePickerField/date-picker-field.interface.d.ts

@@ -1,4 +1,10 @@
-import type { IAdjacentSlots, IChipProps, IFieldSlots, IMenuProps, ITextFieldProps, ITransitionComponentProps } from "../../interfaces";
+import type { IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IChipProps } from '../Chip/chip.interface';
+import type { ICommonsComponentEmits } from '../Commons/commons.interface';
+import type { IFieldSlots } from '../Field/field.interface';
+import type { IMenuProps } from '../Menu/menu.interface';
+import type { ITextFieldProps } from '../TextField/text-field.interface';
+import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
 export interface IDatePickerFieldProps extends ITextFieldProps, ITransitionComponentProps {
     menu?: boolean;
     menuProps?: IMenuProps;
@@ -11,6 +17,17 @@ export interface IDatePickerFieldProps extends ITextFieldProps, ITransitionCompo
     chipProps?: IChipProps;
     closableChips?: boolean;
 }
+/*********************************************************
+ * IDatePickerFieldEmits
+ *
+ * @description
+ * Emits fired by `<OrigamDatePickerField>` — both are `useVModel`
+ * relays (`modelValue` selection, `menu` open state), not literal
+ * `emit(...)` calls in the component body.
+ ********************************************************/
+export interface IDatePickerFieldEmits extends ICommonsComponentEmits {
+    (e: 'update:menu', value: boolean): void;
+}
 /** Slot signatures for `<OrigamDatePickerField>` — the field chrome
  *  slots (`IFieldSlots` minus its scoped `default`, since this field
  *  renders its own selection markup instead) plus `prepend` / `append`

package/dist/src/interfaces/DefaultsProvider/defaults-provider.interface.cjs

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