origam 2.14.0 → 2.15.0

package/dist/src/interfaces/Chart/chart-gauge.interface.d.ts

@@ -47,8 +47,19 @@ export interface IChartGaugeProps extends IChartBaseProps {
 }
 /** Emits surfaced by `<OrigamChartGauge>`. Mirrors the base family. */
 export type IChartGaugeEmits = IChartBaseEmits;
-/** Slot signatures exposed by `<OrigamChartGauge>`. */
-export interface IChartGaugeSlots extends IChartBaseSlots {
+/**
+ * Slot signatures exposed by `<OrigamChartGauge>`.
+ *
+ * Deliberately `Omit`s `tooltip` and `legend-item` from the base
+ * family — a gauge reads a single value from the first datum, so
+ * it renders neither a per-point tooltip nor a series legend.
+ * Declaring `defineSlots<IChartGaugeSlots>()` with the full,
+ * un-narrowed `IChartBaseSlots` would type-check a `#tooltip` /
+ * `#legend-item` slot on the consumer side that the template never
+ * forwards — a silently-ignored slot, same failure mode as a prop
+ * the `<style>` block never reads.
+ */
+export interface IChartGaugeSlots extends Omit<IChartBaseSlots, 'tooltip' | 'legend-item'> {
     /**
      * Replace the centre value label. Receives the formatted value
      * + raw datum + ratio (0..1) for custom rendering.

package/dist/src/interfaces/Chart/chart-heatmap.interface.d.ts

@@ -66,8 +66,15 @@ export interface IChartHeatmapProps extends IChartBaseProps {
 }
 /** Emits surfaced by `<OrigamChartHeatmap>`. Mirrors the base family. */
 export type IChartHeatmapEmits = IChartBaseEmits;
-/** Slot signatures exposed by `<OrigamChartHeatmap>`. */
-export interface IChartHeatmapSlots extends IChartBaseSlots {
+/**
+ * Slot signatures exposed by `<OrigamChartHeatmap>`.
+ *
+ * Omits `legend-item` from the base family — the heatmap renders a
+ * continuous colour-gradient legend (min/max labels + a gradient
+ * swatch), not a discrete per-series legend list, so there is no
+ * `<slot name="legend-item">` in the template to forward it to.
+ */
+export interface IChartHeatmapSlots extends Omit<IChartBaseSlots, 'legend-item'> {
     /**
      * Replace the tooltip body for a hovered cell.
      * Receives the hovered point, its resolved colour, and

package/dist/src/interfaces/Chart/chart-map.interface.d.ts

@@ -1,5 +1,5 @@
 import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots, IChartPoint, IChartSeries } from '../../interfaces';
-import type { TChartMapMode } from '../../types/Chart/chart-map-mode.type';
+import type { TChartMapMode } from '../../types/Chart/chart-map.type';
 import type { TIntent } from '../../types';
 /**
  * A single choropleth data point keyed by ISO-3166-1 alpha-2 code.
@@ -121,8 +121,15 @@ export interface IChartMapProps extends IChartBaseProps {
 }
 /** Emits surfaced by `<OrigamChartMap>`. Mirrors the base family. */
 export type IChartMapEmits = IChartBaseEmits;
-/** Slot signatures exposed by `<OrigamChartMap>`. */
-export interface IChartMapSlots extends IChartBaseSlots {
+/**
+ * Slot signatures exposed by `<OrigamChartMap>`.
+ *
+ * Omits `legend-item` from the base family — the map's series
+ * represent choropleth regions / flight routes, not a discrete
+ * toggleable legend list, so the template never renders a
+ * `<slot name="legend-item">` to forward it to.
+ */
+export interface IChartMapSlots extends Omit<IChartBaseSlots, 'legend-item'> {
     /**
      * Replace the default tooltip body.
      * Receives the hovered point, series, and category label.

package/dist/src/interfaces/Chart/chart-pictorial.interface.d.ts

@@ -1,5 +1,5 @@
 import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots, IChartPoint, IChartSeries } from '../../interfaces';
-import type { TChartPictorialDirection, TChartPictorialMode, TIntent } from '../../types';
+import type { TChartPictorialMode, TDirection, TIntent } from '../../types';
 /**
  * Props for `<OrigamChartPictorial>` — the pictorial / isotype family.
  *
@@ -37,8 +37,16 @@ export interface IChartPictorialProps extends IChartBaseProps {
      * - `'vertical'` — icons stacked bottom-to-top (traditional column).
      * - `'horizontal'` — icons stacked left-to-right.
      * Default `'vertical'`.
+     *
+     * Typed via the shared `TDirection` (Commons) rather than a
+     * component-local union — the value set (`horizontal`/`vertical`)
+     * is identical and this is a plain layout axis, not a distinct
+     * concept (contrast `PARALLAX_DIRECTION`, which legitimately keeps
+     * its own enum because it adds a third `'both'` value with no
+     * equivalent in `DIRECTION`). A former `TChartPictorialDirection`
+     * duplicated `TDirection` exactly.
      */
-    direction?: TChartPictorialDirection;
+    direction?: TDirection;
     /**
      * Rendering mode.
      * - `'stack'` — classic isotype: rows of small repeated icons (default).

package/dist/src/interfaces/Chart/chart-radar.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IChartBaseProps } from '../../interfaces';
+import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots } from '../../interfaces';
 /**
  * Props for `<OrigamChartRadar>` — radar / spider chart
  *
@@ -8,3 +8,14 @@ import type { IChartBaseProps } from '../../interfaces';
  */
 export interface IChartRadarProps extends IChartBaseProps {
 }
+/** Emits surfaced by `<OrigamChartRadar>`. Mirrors the base family. */
+export type IChartRadarEmits = IChartBaseEmits;
+/**
+ * Slot signatures exposed by `<OrigamChartRadar>`.
+ *
+ * Omits `tooltip` from the base family — the radar spoke geometry
+ * has no per-point hover tooltip wired in the template (no
+ * `<slot name="tooltip">` to forward it to), unlike the other
+ * per-type chart components.
+ */
+export type IChartRadarSlots = Omit<IChartBaseSlots, 'tooltip'>;

package/dist/src/interfaces/Chart/chart-range-selector.interface.d.ts

@@ -36,3 +36,29 @@ export interface IChartRangeSelector {
     /** Zero-based index of the initially selected button. */
     selected?: number;
 }
+/**
+ * Props for `<OrigamChartRangeSelector>` — the band-style preset
+ * toolbar rendered above `<OrigamChartCartesian>` when
+ * `rangeSelector.enabled` is `true`. Distinct from `IChartRangeSelector`
+ * above, which is the *configuration object* a consumer passes to
+ * `<OrigamChartCartesian rangeSelector="…">`; this is the standalone
+ * sub-component's own prop surface.
+ */
+export interface IChartRangeSelectorProps {
+    /** Buttons to render, in order. */
+    buttons: Array<IChartRangeSelectorButton>;
+    /** Zero-based index of the currently active button. `-1` = none selected. */
+    activeIndex?: number;
+    /** Total category count — the window each button computes against. */
+    dataLength?: number;
+}
+/**
+ * Emits surfaced by `<OrigamChartRangeSelector>`.
+ */
+export interface IChartRangeSelectorEmits {
+    /**
+     * Fired when a button is activated (click or keyboard). Carries the
+     * button's index and the resolved `[start, end]` category window.
+     */
+    (e: 'select', index: number, start: number, end: number): void;
+}

package/dist/src/interfaces/Chart/chart-treemap.interface.d.ts

@@ -104,3 +104,16 @@ export interface IChartTreemapSlots extends IChartBaseSlots {
         visible: boolean;
     }) => any;
 }
+/**
+ * Plain SVG-space rectangle (`x`, `y`, `w`, `h`) shared by both layout
+ * algorithms (`squarify` / `sliceDice`). Moved out of
+ * `OrigamChartTreemap.vue` (was a bare `interface Rect` local to the
+ * `<script setup>`) so the `.vue` file only imports it, per the
+ * "no declarations in .vue" rule.
+ */
+export interface IChartTreemapRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}

package/dist/src/interfaces/Chart/chart-word-cloud.interface.d.ts

@@ -1,5 +1,5 @@
 import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots } from '../../interfaces';
-import type { TChartWordCloudRotation } from '../../types/Chart/chart-word-cloud-rotation.type';
+import type { TChartWordCloudRotation } from '../../types/Chart/chart-word-cloud.type';
 /**
  * A single processed word datum used by the layout engine.
  * Computed from `IChartSeries.data` entries after sorting and font-size mapping.

package/dist/src/interfaces/Chip/chip-group.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ISlideGroupProps, ITagProps, IActiveState, IHoverState } from '../../interfaces';
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IGroupProps, IGroupProvide, IMarginProps, IPaddingProps, IRoundedProps, ISlideGroupProps, ITagProps, IActiveState, IHoverState } from '../../interfaces';
 export interface IChipGroupProps extends ICommonsComponentProps, ITagProps, IGroupProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IBorderProps, IRoundedProps, ISlideGroupProps {
     column?: boolean;
     filter?: boolean;
@@ -9,3 +9,10 @@ export interface IChipGroupProps extends ICommonsComponentProps, ITagProps, IGro
 /** Emits fired by `<OrigamChipGroup>` — v-model on the active chip set. */
 export interface IChipGroupEmits extends ICommonsComponentEmits {
 }
+/** Slot signatures for `<OrigamChipGroup>`. `selected` is bound
+ *  unwrapped (template auto-unref of `IGroupProvide.selected`). */
+export interface IChipGroupSlots {
+    default?: (data: {
+        selected: Readonly<Array<number>>;
+    } & Pick<IGroupProvide, 'isSelected' | 'select' | 'next' | 'prev'>) => any;
+}

package/dist/src/interfaces/Chip/chip.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IClickCloseEmits, IClickEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IGroupEmits, IGroupItemProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps, ITypographyProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, IBgColorProps, IClickCloseEmits, IClickEmits, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IGroupEmits, IGroupItemProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps, ITypographyProps } from '../../interfaces';
 import type { TIcon } from '../../types';
 export interface IChipProps extends ICommonsComponentProps, IAdjacentProps, ITagProps, IColorProps, IBgColorProps, IRippleProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IGroupItemProps, ILinkProps, ISizeProps, IElevationProps, IActiveProps, IHoverProps, ITypographyProps {
     closable?: boolean;
@@ -17,3 +17,23 @@ export interface IChipProps extends ICommonsComponentProps, IAdjacentProps, ITag
  *  membership, prepend/append icons, and v-model on dismissal. */
 export interface IChipEmits extends ICommonsComponentEmits, IClickEmits, IClickCloseEmits, IAdjacentEmits, IGroupEmits {
 }
+/** Slot signatures for `<OrigamChip>`. */
+export interface IChipSlots extends IAdjacentSlots {
+    /** Shown while `filter` is set and the chip is selected. */
+    filter?: (data: {
+        filterIcon: TIcon | undefined;
+    }) => any;
+    /** Overrides the `text` prop, receives the group-membership API when
+     *  the chip lives inside an `<OrigamChipGroup>`. */
+    default?: (data: {
+        isSelected: boolean | undefined;
+        selectedClass: Array<string | undefined> | false | undefined;
+        select: ((value: boolean) => void) | undefined;
+        toggle: (() => void) | undefined;
+        value: unknown;
+        disabled: boolean | undefined;
+    }) => any;
+    close?: (data: {
+        closeIcon: TIcon | undefined;
+    }) => any;
+}

package/dist/src/interfaces/ClientOnly/client-only.interface.d.ts

@@ -0,0 +1,6 @@
+/** Slot signatures for `<OrigamClientOnly>`. */
+export interface IClientOnlySlots {
+    default?: () => any;
+    /** SSR / pre-hydration placeholder, shown until the component mounts. */
+    fallback?: () => any;
+}

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

@@ -77,6 +77,24 @@ export interface ICodeProps extends ICommonsComponentProps, ITagProps, IBorderPr
      */
     prompt?: string;
 }
+/** Emits fired by `<OrigamCode>` — copy-to-clipboard confirmation. */
+export interface ICodeEmits {
+    (e: 'copy', code: string): void;
+}
+/** Slot signatures for `<OrigamCode>`. */
+export interface ICodeSlots {
+    /** Custom header content — receives the copy-button wiring so a
+     *  consumer can rebuild the default filename/lang badge + copy button. */
+    header?: (data: {
+        filename: string | undefined;
+        langName: TCodeLang | undefined;
+        copy: () => Promise<void>;
+        copied: boolean;
+    }) => any;
+    footer?: () => any;
+    /** Source for the highlighted code when the `code` prop is omitted. */
+    default?: () => any;
+}
 /**
  * Public surface of the `useCode` composable. Lazily instantiates a shiki
  * highlighter on first call and reuses it across every `OrigamCode`

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

@@ -1,4 +1,4 @@
-import type { IBorderProps, IColorPickerCanvasProps, IColorPickerEditProps, IColorPickerPreviewProps, IColorPickerSwatchesProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IPickerProps, IRoundedProps } from "../../interfaces";
+import type { IBorderProps, IColorPickerCanvasProps, IColorPickerEditProps, IColorPickerPreviewProps, IColorPickerSwatchesProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IPickerProps, IPickerSlots, IRoundedProps } from "../../interfaces";
 import type { TColorModes, THSVA } from "../../types";
 /** Shared emit shape for sub-components driving the HSVA model
  *  (Canvas / Edit / Preview / Swatches all push their changes up the
@@ -37,3 +37,7 @@ export interface IColorPickerMode {
  *  plus the active input mode. */
 export interface IColorPickerEmits extends ICommonsComponentEmits, IColorModeEmits {
 }
+/** Slot signatures for `<OrigamColorPicker>` — thin wrapper forwarding
+ *  the exact same slots as the underlying `<OrigamPicker>`. */
+export interface IColorPickerSlots extends IPickerSlots {
+}

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

@@ -1,4 +1,4 @@
-import type { IMenuProps, ITextFieldProps, ITransitionComponentProps } from "../../interfaces";
+import type { IAdjacentSlots, IFieldSlots, IMenuProps, ITextFieldProps, ITransitionComponentProps } from "../../interfaces";
 export interface IColorPickerFieldProps extends ITextFieldProps, ITransitionComponentProps {
     menu?: boolean;
     menuProps?: IMenuProps;
@@ -7,3 +7,11 @@ export interface IColorPickerFieldProps extends ITextFieldProps, ITransitionComp
     openText?: string;
     closeOnSelect?: boolean;
 }
+/** Slot signatures for `<OrigamColorPickerField>` — the field chrome
+ *  slots (`IFieldSlots` minus its scoped `default`, since this field
+ *  renders its own swatch/value markup instead) plus `prepend` /
+ *  `append` (`IAdjacentSlots`) and the color-swatch override. */
+export interface IColorPickerFieldSlots extends Omit<IFieldSlots, 'default'>, IAdjacentSlots {
+    /** Overrides the selected color's text/swatch representation. */
+    colorSelection?: () => any;
+}

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

@@ -0,0 +1,12 @@
+import type { ICommand } from './command.interface';
+import type { IFuzzyMatchResult } from '../../utils/CommandPalette/fuzzy-match.util';
+/**
+ * Internal implementation detail of `<OrigamCommandPalette>`'s grouping
+ * computation — NOT part of the component's public props/emits/slots
+ * surface. Deliberately not re-exported from `src/interfaces/index.ts`:
+ * nothing outside `OrigamCommandPalette.vue` consumes this shape.
+ */
+export interface IRenderedGroup {
+    label: string | null;
+    items: ReadonlyArray<IFuzzyMatchResult<ICommand>>;
+}

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

@@ -5,7 +5,23 @@ export interface IBorderProps {
     borderLeft?: boolean | number | string;
     borderBottom?: boolean | number | string;
     borderRight?: boolean | number | string;
+    /**
+     * Logical-axis shorthand for the block-start + block-end edges (top +
+     * bottom in the default horizontal-tb writing mode). Resolves to the
+     * native CSS `border-block-{width,style,color}` properties — same
+     * value grammar as `borderTop` / `borderRight` / `borderBottom` /
+     * `borderLeft` (boolean opt-in, bare width number, or a free-form
+     * `"width style color"` string). Precedence: beats the global `border`
+     * shorthand for the edges it targets, but a physical `borderTop` /
+     * `borderBottom` still wins over it for that specific edge — see
+     * `useBorder` JSDoc for the full precedence table.
+     */
     borderBlock?: boolean | number | string;
+    /**
+     * Logical-axis shorthand for the inline-start + inline-end edges (left
+     * + right in LTR). Same grammar and precedence rules as `borderBlock`,
+     * mapped onto `border-inline-{width,style,color}`.
+     */
     borderInline?: boolean | number | string;
     borderColor?: string;
     borderStyle?: string;

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

@@ -10,3 +10,7 @@ export interface ILazyComponentProps extends ICommonsComponentProps, IDimensionP
  *  observer flips the wrapper to "visible". */
 export interface ILazyEmits extends ICommonsComponentEmits {
 }
+/** Slot signatures for `<OrigamLazy>`. */
+export interface ILazySlots {
+    default?: () => any;
+}

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

@@ -4,3 +4,8 @@ export interface ILoaderProps extends ICommonsComponentProps, ITagProps, IColorP
     loading?: TLoadingValue;
     loadingText?: string;
 }
+/** Slot signatures for `<OrigamLoader>`. */
+export interface ILoaderSlots {
+    loader?: () => any;
+    default?: () => any;
+}

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

@@ -5,3 +5,13 @@ export interface ICounterProps extends ICommonsComponentProps, ITagProps, IPaddi
     max?: string | number;
     value?: string | number;
 }
+/** Slot signatures for `<OrigamCounter>`. `value` defaults to `0`
+ *  (`withDefaults`) so it's always defined at runtime; `max` has no
+ *  default and stays optional. */
+export interface ICounterSlots {
+    default?: (data: {
+        counter: string;
+        max?: string | number;
+        value: string | number;
+    }) => any;
+}

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

@@ -41,3 +41,62 @@ export interface IDataItem extends IAdjacentProps {
         [key: string]: IDataTextProps;
     };
 }
+/**
+ * Slot signatures for `<OrigamDataList>`.
+ *
+ * Both layout modes (`avatar` / `kv`) share the same `default` slot name
+ * but a different scope shape, so `default` widens to the union of both.
+ * Per-row overrides are only known at runtime (`item-{index}` / `item-
+ * {index}.key` / …), so they're expressed as template-literal index
+ * signatures alongside the un-indexed fallback names (`item`, `key`,
+ * `value`, `item.title`, …) the template also checks.
+ */
+export interface IDataListSlots {
+    default?: (data: {
+        items: Array<IDataItem>;
+    } | {
+        items: Array<IDataListKVItem>;
+    }) => any;
+    key?: (data: {
+        key: string;
+        item: IDataListKVItem;
+        index: number;
+    }) => any;
+    value?: (data: {
+        key: string;
+        value: IDataListKVItem['value'];
+        item: IDataListKVItem;
+        index: number;
+    }) => any;
+    item?: (data: {
+        item: IDataItem;
+        index: number;
+    }) => any;
+    'item.title'?: (data: Record<string, unknown>) => any;
+    'item.title.append'?: () => any;
+    'item.title.prepend'?: () => any;
+    'item.text'?: () => any;
+    'item.text.append'?: () => any;
+    'item.text.prepend'?: () => any;
+    [key: `item-${number}.key`]: ((data: {
+        key: string;
+        item: IDataListKVItem;
+        index: number;
+    }) => any) | undefined;
+    [key: `item-${number}.value`]: ((data: {
+        key: string;
+        value: IDataListKVItem['value'];
+        item: IDataListKVItem;
+        index: number;
+    }) => any) | undefined;
+    [key: `item-${number}.title.append`]: (() => any) | undefined;
+    [key: `item-${number}.title.prepend`]: (() => any) | undefined;
+    [key: `item-${number}.title`]: ((data: Record<string, unknown>) => any) | undefined;
+    [key: `item-${number}.text.append`]: (() => any) | undefined;
+    [key: `item-${number}.text.prepend`]: (() => any) | undefined;
+    [key: `item-${number}.text`]: (() => any) | undefined;
+    [key: `item-${number}`]: ((data: {
+        item: IDataItem;
+        index: number;
+    }) => any) | undefined;
+}

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

@@ -1,4 +1,4 @@
-import type { IAdjacentProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps } from "../../interfaces";
+import type { IAdjacentProps, IAdjacentSlots, 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;
@@ -7,3 +7,7 @@ export interface IDataTextProps extends ICommonsComponentProps, IAdjacentProps,
     /** @deprecated Use the `hover` object prop instead. Kept for back-compat. */
     hoverBgColor?: TColor;
 }
+/** Slot signatures for `<OrigamDataText>`. */
+export interface IDataTextSlots extends IAdjacentSlots {
+    default?: () => any;
+}

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

@@ -1,4 +1,4 @@
-import type { IAdjacentProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps } from "../../interfaces";
+import type { IAdjacentProps, IAdjacentSlots, 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;
@@ -7,3 +7,9 @@ export interface IDataTitleProps extends ICommonsComponentProps, IAdjacentProps,
     /** @deprecated Use the `hover` object prop instead. Kept for back-compat. */
     hoverBgColor?: TColor;
 }
+/** Slot signatures for `<OrigamDataTitle>`. */
+export interface IDataTitleSlots extends IAdjacentSlots {
+    default?: (data: {
+        text: string | number;
+    }) => any;
+}

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

@@ -7,3 +7,9 @@ export interface IDataTableColumnProps extends ICommonsComponentProps, ITagProps
     lastFixed?: boolean;
     nowrap?: boolean;
 }
+/** Slot signature for `<OrigamDataTableColumnCell>` — a plain content cell,
+ *  no scope passed through (the header/row callers compute their own
+ *  scoped props before forwarding into this wrapper). */
+export interface IDataTableColumnCellSlots {
+    default?: () => any;
+}

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

@@ -1,5 +1,5 @@
 import type { UnwrapRef } from 'vue';
-import type { ICommonsComponentEmits, IDataTableExpandProps, IDataTableFooterProps, IDataTableGroup, IDataTableGroupProps, IDataTableHeaderProps, IDataTableHeadersProps, IDataTableItem, IDataTableItemsProps, IDataTablePaginationProps, IDataTableProvideExpanded, IDataTableProvideGroup, IDataTableProvidePagination, IDataTableProvideSelection, IDataTableProvideSort, IDataTableRowProps, IDataTableSelectProps, IDataTableSortProps, IFiltersProps, IInternalDataTableHeader, ITableProps } from '../../interfaces';
+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';
 export interface IDataTableProps extends ITableProps, IDataTableRowProps, IDataTableExpandProps, IDataTableGroupProps, IDataTableHeaderProps, IDataTableItemsProps, IDataTableSelectProps, IDataTableSortProps, IDataTableHeadersProps, IDataTablePaginationProps, IFiltersProps, IDataTableFooterProps {
     hideDefaultBody?: boolean;
     hideDefaultFooter?: boolean;
@@ -9,7 +9,15 @@ export interface IDataTableProps extends ITableProps, IDataTableRowProps, IDataT
 export interface IDataTableSlotProps<T> {
     page: number;
     itemsPerPage: number;
-    sortBy: UnwrapRef<IDataTableProvideSort['sortBy']>;
+    /**
+     * `readonly … | undefined`, not `UnwrapRef<IDataTableProvideSort['sortBy']>`:
+     * this is the pre-`provide()` value straight out of `createSort()`'s
+     * `useVModel(props, 'sortBy', [])`, which mirrors the OPTIONAL
+     * `IDataTableSortProps.sortBy` prop type — not the always-defined,
+     * mutable array `IDataTableProvideSort` exposes to descendants after
+     * `provideSort()` runs.
+     */
+    sortBy: readonly IDataTableSortItem[] | undefined;
     pageCount: number;
     toggleSort: IDataTableProvideSort['toggleSort'];
     setItemsPerPage: IDataTableProvidePagination['setItemsPerPage'];
@@ -24,8 +32,17 @@ export interface IDataTableSlotProps<T> {
     isGroupOpen: IDataTableProvideGroup['isGroupOpen'];
     toggleGroup: IDataTableProvideGroup['toggleGroup'];
     items: T[];
-    internalItems: Array<IDataTableItem>;
-    groupedItems: Array<IDataTableItem<T> | IDataTableGroup<IDataTableItem<T>>>;
+    /**
+     * `IDataTableGroupableItem<T>`, not `IDataTableItem<T>`: this is
+     * `extractRows()`'s return type (flattened groups, no `key` / `index` /
+     * `columns` guaranteed by the type system — those DO exist on the real
+     * objects at runtime, but only because `OrigamDataTable`'s call site
+     * narrows the generic through an `as unknown as` cast upstream of
+     * `extractRows`, which this field can't see through).
+     */
+    internalItems: Array<IDataTableGroupableItem<T>>;
+    /** `readonly`: straight from `usePaginatedItems()`'s `Ref<readonly (T | IDataTableGroup<T>)[]>`. */
+    groupedItems: ReadonlyArray<IDataTableItem<T> | IDataTableGroup<IDataTableItem<T>>>;
     columns: Array<IInternalDataTableHeader>;
     headers: Array<Array<IInternalDataTableHeader>>;
 }
@@ -40,3 +57,23 @@ export interface IDataTableEmits extends ICommonsComponentEmits {
     (e: 'update:expanded', value: ReadonlySet<unknown>): void;
     (e: 'update:currentItems', value: Array<IDataTableItem>): 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. */
+export interface IDataTableSlots<T = any> {
+    top?: () => any;
+    default?: (props: IDataTableSlotProps<T>) => any;
+    colgroup?: (props: IDataTableSlotProps<T>) => any;
+    header?: (props: IDataTableHeadersSlotProps) => any;
+    'header.mobile'?: (props: IDataTableHeadersSlotProps) => any;
+    'header.loader'?: () => any;
+    thead?: (props: IDataTableSlotProps<T>) => any;
+    prepend?: (props: IDataTableSlotProps<T>) => any;
+    body?: (props: IDataTableSlotProps<T>) => any;
+    append?: (props: IDataTableSlotProps<T>) => any;
+    bottom?: () => any;
+}

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

@@ -1,4 +1,4 @@
-import type { IAlignProps, IColorProps, ICommonsComponentProps, IPaddingProps } from "../../interfaces";
+import type { IAdjacentSlots, IAlignProps, IColorProps, ICommonsComponentProps, IPaddingProps } from "../../interfaces";
 import type { TIcon } from "../../types";
 export interface IDataTableFooterProps extends ICommonsComponentProps, IColorProps, IPaddingProps, IAlignProps {
     prevIcon?: TIcon;
@@ -17,3 +17,8 @@ export interface IDataTableFooterProps extends ICommonsComponentProps, IColorPro
     }>;
     showCurrentPage?: boolean;
 }
+/** Slot signatures for `<OrigamDataTableFooter>` — both `prepend` and
+ *  `append` render with no scope (bracket the items-per-page / pagination
+ *  row), so the shared `IAdjacentSlots` contract applies unchanged. */
+export interface IDataTableFooterSlots extends IAdjacentSlots {
+}

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

@@ -1,5 +1,6 @@
 import type { ComputedRef, Ref } from 'vue';
 import type { IColorProps, ICommonsComponentProps, IDataTableItem, IDataTableItemBase, IDataTableSelectableItem, IDataTableSortItem, IInternalDataTableHeader, IPaddingProps } from '../../interfaces';
+import type { TIcon } from '../../types';
 export interface IDataTableGroupProps {
     groupBy?: Array<IDataTableSortItem>;
 }
@@ -45,3 +46,27 @@ export interface IDataTableGroupHeaderRowProps<T = IDataTableGroup> extends ICom
     toggleSelect: (item: IDataTableSelectableItem) => void;
     toggleGroup: (group: IDataTableGroup) => void;
 }
+/** Scope for the `data-table-group` slot — the group's own toggle button
+ *  (`props`) is pre-wired so a custom render can spread it onto any
+ *  trigger element and still collapse/expand correctly. */
+export interface IDataTableGroupHeaderRowGroupSlot<T = IDataTableGroup> {
+    item: T;
+    count: number;
+    props: {
+        icon: TIcon;
+        onClick: () => void;
+    };
+}
+/** Scope for the `data-table-select` slot — mirrors the group's row-select
+ *  checkbox binding (`v-bind="props"` reproduces the default checkbox). */
+export interface IDataTableGroupHeaderRowSelectSlot {
+    props: {
+        modelValue: boolean;
+        indeterminate: boolean;
+        'onUpdate:modelValue': (value: boolean) => void;
+    };
+}
+export interface IDataTableGroupHeaderRowSlots<T = IDataTableGroup> {
+    'data-table-group'?: (props: IDataTableGroupHeaderRowGroupSlot<T>) => any;
+    'data-table-select'?: (props: IDataTableGroupHeaderRowSelectSlot) => any;
+}