@omnitend/dashboard-for-laravel 0.33.1 → 0.35.0

package/dist/components/charts/useThemedChart.d.ts

@@ -0,0 +1,35 @@
+import { type ComputedRef } from "vue";
+import type { ChartData, ChartDataset, ChartOptions } from "chart.js";
+import { type ChartValueFormat } from "./chartTheme";
+/**
+ * Shared props for the value-axis chart wrappers (`DXBarChart`, `DXLineChart`).
+ * `DXBarChart` and `DXLineChart` differ ONLY in the chart.js component they
+ * render and the palette kind — everything else (theming, option-merge,
+ * legend-default) is identical, and lived duplicated in both SFCs (#135).
+ */
+export interface ThemedChartProps<TType extends "bar" | "line"> {
+    /** X-axis category labels. */
+    labels: string[];
+    /** Chart.js datasets. Colours are themed when a dataset omits them. */
+    datasets: ChartDataset<TType>[];
+    /** Chart.js options; deep-merged over the themed defaults. */
+    options?: ChartOptions<TType>;
+    /** Format value-axis ticks and tooltips. */
+    valueFormat?: ChartValueFormat;
+    /** Currency symbol for valueFormat: "currency" (default "£"). */
+    currencySymbol?: string;
+    /** Locale for number formatting. */
+    locale?: string;
+    /** Show the legend (default: only when there is more than one dataset). */
+    showLegend?: boolean;
+}
+/**
+ * The themed-chart body shared by `DXBarChart` and `DXLineChart`: applies the
+ * data-viz palette to un-coloured datasets and deep-merges the consumer's
+ * `options` over the dashboard-friendly defaults. Pass the reactive `props`
+ * object (property access stays reactive inside the computeds).
+ */
+export declare function useThemedChart<TType extends "bar" | "line">(type: TType, props: ThemedChartProps<TType>): {
+    chartData: ComputedRef<ChartData<TType>>;
+    mergedOptions: ComputedRef<ChartOptions<TType>>;
+};

package/dist/components/extended/DXChoiceField.vue.d.ts

@@ -0,0 +1,26 @@
+import type { FieldDefinition, FieldOption } from "../../types";
+interface Props {
+    /** Field definition (type select/radio/checkbox-group + `searchable`). */
+    field: FieldDefinition;
+    /** Current model value. */
+    modelValue: any;
+    /** Resolved options (async-loaded or static). */
+    options?: FieldOption[];
+    /** Validation state passed to the control. */
+    state?: boolean | null;
+    /** Pre-merged disabled state (`isDisabled || isReadonly || isPlaintext`). */
+    disabled?: boolean;
+    /** Escape-hatch control props, already guard-merged by DXField. */
+    controlProps?: Record<string, any>;
+    /**
+     * Whether async options have resolved (a searchable select must not render
+     * before its options load, or it shows the raw id instead of the label).
+     */
+    optionsReady?: boolean;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/extended/DXDashboardSidebar.vue.d.ts

@@ -46,8 +46,8 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onToggle?: (() => any) | undefined;
 }>, {
-    title: string;
     hidden: boolean;
+    title: string;
     collapsed: boolean;
     collapsibleGroups: boolean;
     autoCollapseInactiveGroups: boolean;

package/dist/components/extended/DXField.vue.d.ts

@@ -42,142 +42,39 @@ declare var __VLS_1: {
     model: any;
     value: any;
     update: typeof setValue;
-}, __VLS_9: {
+}, __VLS_6: {
     field: FieldDefinition;
     model: any;
-}, __VLS_11: {
+}, __VLS_8: {
     field: FieldDefinition;
     model: any;
-    value: any;
-    update: typeof setValue;
-}, __VLS_22: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_27: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_32: {
+}, __VLS_10: {
     field: FieldDefinition;
     model: any;
     value: any;
     update: typeof setValue;
-}, __VLS_43: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_48: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_59: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_61: {
-    field: FieldDefinition;
-    model: any;
-    value: any;
-    update: typeof setValue;
-}, __VLS_72: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_77: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_82: {
-    field: FieldDefinition;
-    model: any;
-    value: any;
-    update: typeof setValue;
-}, __VLS_93: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_98: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_119: {
+}, __VLS_52: {
     option: FieldOption;
     on: boolean;
-}, __VLS_124: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_129: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_144: {
+}, __VLS_64: {
     row: any;
     index: number;
     fields: FieldDefinition[];
     remove: () => void;
     path: string;
-}, __VLS_146: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_151: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_162: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_164: {
-    field: FieldDefinition;
-    model: any;
-    value: any;
-    update: typeof setValue;
-}, __VLS_230: {
-    field: FieldDefinition;
-    model: any;
-}, __VLS_235: {
-    field: FieldDefinition;
-    model: any;
 };
 type __VLS_Slots = {} & {
     span?: (props: typeof __VLS_1) => any;
 } & {
-    hint?: (props: typeof __VLS_9) => any;
-} & {
-    value?: (props: typeof __VLS_11) => any;
-} & {
-    info?: (props: typeof __VLS_22) => any;
-} & {
-    hint?: (props: typeof __VLS_27) => any;
-} & {
-    value?: (props: typeof __VLS_32) => any;
-} & {
-    info?: (props: typeof __VLS_43) => any;
-} & {
-    hint?: (props: typeof __VLS_48) => any;
-} & {
-    hint?: (props: typeof __VLS_59) => any;
-} & {
-    value?: (props: typeof __VLS_61) => any;
-} & {
-    info?: (props: typeof __VLS_72) => any;
-} & {
-    hint?: (props: typeof __VLS_77) => any;
-} & {
-    value?: (props: typeof __VLS_82) => any;
-} & {
-    info?: (props: typeof __VLS_93) => any;
-} & {
-    hint?: (props: typeof __VLS_98) => any;
-} & {
-    'switch-list-item'?: (props: typeof __VLS_119) => any;
-} & {
-    info?: (props: typeof __VLS_124) => any;
-} & {
-    hint?: (props: typeof __VLS_129) => any;
-} & {
-    'repeater-row'?: (props: typeof __VLS_144) => any;
-} & {
-    info?: (props: typeof __VLS_146) => any;
-} & {
-    hint?: (props: typeof __VLS_151) => any;
+    hint?: (props: typeof __VLS_6) => any;
 } & {
-    hint?: (props: typeof __VLS_162) => any;
+    info?: (props: typeof __VLS_8) => any;
 } & {
-    value?: (props: typeof __VLS_164) => any;
+    value?: (props: typeof __VLS_10) => any;
 } & {
-    info?: (props: typeof __VLS_230) => any;
+    'switch-list-item'?: (props: typeof __VLS_52) => any;
 } & {
-    hint?: (props: typeof __VLS_235) => any;
+    'repeater-row'?: (props: typeof __VLS_64) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/components/extended/DXFieldShell.vue.d.ts

@@ -0,0 +1,73 @@
+import type { UseFormReturn } from "../../composables/useForm";
+import type { FieldDefinition } from "../../types";
+interface Props {
+    /** The field definition (for `field.help` and slot props). */
+    field: FieldDefinition;
+    /** Form instance owning the field's errors. */
+    form: UseFormReturn<any>;
+    /** Error key for validation lookups. */
+    errorKey: string;
+    /** Model passed to `hint`/`info` slot props. */
+    model?: any;
+    /**
+     * Layout shape. `group` = DFormGroup root with a label column; `plain` =
+     * plain div, the control owning its own inline label/heading.
+     */
+    mode: "group" | "plain";
+    /** Wrapper class (`field.class || 'mb-3'`). */
+    wrapperClass?: string;
+    /** BFormGroup attrs (horizontal label-cols etc.); group mode only. */
+    groupAttrs?: Record<string, any>;
+    /** Resolved label text (group mode). Always supplied by DXField. */
+    label: string;
+    /** Resolved info text for the label popover (group mode). */
+    info?: string;
+    /** Skip the label column entirely (group mode). */
+    hideLabel?: boolean;
+    /**
+     * Whether the hint sits in the label column (horizontal) rather than below
+     * the control. Group mode only; plain mode always renders the hint below.
+     */
+    hintInLabel?: boolean;
+    /** Resolved hint text (fallback when no `hint` slot is supplied). */
+    resolvedHint?: string;
+}
+declare var __VLS_8: {
+    field: FieldDefinition;
+    model: any;
+}, __VLS_10: {}, __VLS_15: {
+    field: FieldDefinition;
+    model: any;
+}, __VLS_20: {
+    field: FieldDefinition;
+    model: any;
+}, __VLS_25: {}, __VLS_30: {
+    field: FieldDefinition;
+    model: any;
+}, __VLS_35: {
+    field: FieldDefinition;
+    model: any;
+};
+type __VLS_Slots = {} & {
+    hint?: (props: typeof __VLS_8) => any;
+} & {
+    default?: (props: typeof __VLS_10) => any;
+} & {
+    info?: (props: typeof __VLS_15) => any;
+} & {
+    hint?: (props: typeof __VLS_20) => any;
+} & {
+    default?: (props: typeof __VLS_25) => any;
+} & {
+    info?: (props: typeof __VLS_30) => any;
+} & {
+    hint?: (props: typeof __VLS_35) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/extended/DXForm.vue.d.ts

@@ -44,12 +44,33 @@ interface Props {
      */
     cardTabs?: boolean;
     /**
-     * Form-wide field layout: "vertical" (default, label above input) or
-     * "horizontal" (label left, input right). Overridable per-field via
-     * `field.layout`. A field with `span: true` always renders full-width,
-     * regardless of layout.
+     * Form-wide field layout:
+     *
+     * - `"vertical"` (default) — label above input, always.
+     * - `"horizontal"` — label left, input right, always.
+     * - `"auto"` — horizontal when the form's **own container** is at least
+     *   `layoutThreshold` px wide, vertical below that. Container-driven, not
+     *   viewport-driven: a page narrowed by the dashboard sidebar, or a form
+     *   inside a modal, stacks even though the window is wide (which no
+     *   Bootstrap media query can see).
+     *
+     * Overridable per-field via `field.layout`. A field with `span: true`
+     * always renders full-width, regardless of layout.
      */
-    layout?: "vertical" | "horizontal";
+    layout?: "vertical" | "horizontal" | "auto";
+    /**
+     * Container width (px) at or above which `layout: "auto"` goes horizontal.
+     * Ignored for the explicit `"vertical"`/`"horizontal"` layouts.
+     *
+     * Default 640, measured rather than guessed: with the default 3-column
+     * label the label's text area is `containerWidth / 4 - 18` px, so 640 gives
+     * it 142px — enough for a ~20-character label ("Unit price (ex VAT)"
+     * measures 128px at the theme's label font) to stay on one line, with the
+     * control column still 474px. Below ~584px that label starts wrapping,
+     * which is the cramped-label symptom this exists to avoid. Raise it if your
+     * labels run longer, or lower `labelCols` instead.
+     */
+    layoutThreshold?: number;
     /**
      * Label column width for horizontal layout (mirrors BFormGroup's
      * `labelCols`/`labelCols*` props). Overridable per-field via
@@ -73,13 +94,14 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps,
     onSubmit?: (() => any) | undefined;
     "onUpdate:activeTab"?: ((value: number) => any) | undefined;
 }>, {
-    layout: "vertical" | "horizontal";
+    layout: "vertical" | "horizontal" | "auto";
     card: boolean;
     submitText: string;
     submitLoadingText: string;
     showSubmit: boolean;
     autoErrorTab: boolean;
     cardTabs: boolean;
+    layoutThreshold: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/components/extended/DXNumericField.vue.d.ts

@@ -0,0 +1,23 @@
+import type { FieldDefinition } from "../../types";
+interface Props {
+    /** Field definition (type currency/percentage/number + numeric options). */
+    field: FieldDefinition;
+    /** Current model value. */
+    modelValue: any;
+    /** Validation state passed to the control. */
+    state?: boolean | null;
+    /** Disabled state (`isDisabled`). */
+    isDisabled?: boolean;
+    /** Readonly state (`isReadonly`). */
+    isReadonly?: boolean;
+    /** Plaintext (display-only) state (`isPlaintext`). */
+    isPlaintext?: boolean;
+    /** Escape-hatch input props, already guard-merged by DXField. */
+    inputProps?: Record<string, any>;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/extended/DXRepeater.vue.d.ts

@@ -16,13 +16,13 @@ declare var __VLS_1: {
     fields: FieldDefinition[];
     remove: () => void;
     path: string;
-}, __VLS_24: {
+}, __VLS_27: {
     row: any;
     index: number;
     fields: FieldDefinition[];
     remove: () => void;
     path: string;
-}, __VLS_43: {
+}, __VLS_32: {
     row: any;
     index: number;
     fields: FieldDefinition[];
@@ -32,9 +32,9 @@ declare var __VLS_1: {
 type __VLS_Slots = {} & {
     row?: (props: typeof __VLS_1) => any;
 } & {
-    row?: (props: typeof __VLS_24) => any;
+    row?: (props: typeof __VLS_27) => any;
 } & {
-    row?: (props: typeof __VLS_43) => any;
+    row?: (props: typeof __VLS_32) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/components/extended/DXRepeaterCards.vue.d.ts

@@ -0,0 +1,45 @@
+import type { UseFormReturn } from "../../composables/useForm";
+import type { FieldDefinition } from "../../types";
+interface Props {
+    /** Rows shown in the UI, each paired with its real (unfiltered) array index. */
+    visibleRows: Array<{
+        row: any;
+        index: number;
+    }>;
+    /** Sub-field definitions for a row. */
+    subFields: FieldDefinition[];
+    /** Form instance owning the repeater array. */
+    form: UseFormReturn<any>;
+    /** The repeater field definition (for `showRowIndex` and `addLabel`). */
+    field: FieldDefinition;
+    /** Minimum rows — the Remove button disables at this count. */
+    minItems: number;
+    /** Maximum rows — the Add button disables at this count. */
+    maxItems: number | undefined;
+    /** Stable v-for key for a row (owned by DXRepeater — row identity, not index). */
+    rowKey: (row: any, fallbackPosition: number) => string | number;
+    /** Dot path into form.data for a row at the given true index. */
+    rowPath: (index: number) => string;
+    /** Remove the row at the given true index (respects minItems / soft-delete). */
+    removeRow: (index: number) => void;
+    /** Append a fresh row (respects maxItems). */
+    addRow: () => void;
+}
+declare var __VLS_1: {
+    row: any;
+    index: number;
+    fields: FieldDefinition[];
+    remove: () => void;
+    path: string;
+};
+type __VLS_Slots = {} & {
+    row?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/extended/DXTable.vue.d.ts

@@ -1,3 +1,4 @@
+import type { FieldDefinition, LabelCols } from "../../types";
 export type FilterType = 'text' | 'select' | 'number' | 'date' | false;
 export interface FilterOption {
     value: string;
@@ -66,6 +67,21 @@ export interface TableField {
     filter?: FilterType;
     filterOptions?: FilterOption[];
     filterPlaceholder?: string;
+    /**
+     * For a `select` filter on a **client-side** table: derive the dropdown's
+     * options from the distinct values present in the loaded rows. Defaults to
+     * `true` — with no `filterOptions` and no server `filterValues` the
+     * alternative is an empty dropdown, which can only ever be a bug.
+     *
+     * Set `false` to opt out (e.g. a column whose raw values are opaque ids you
+     * would rather label yourself via `filterOptions`).
+     *
+     * Explicit `filterOptions` and server-supplied `filterValues` still WIN, in
+     * that order. Provider/API and Inertia modes ignore this flag: they only
+     * ever hold one page of rows, so there is no complete value set to derive
+     * from (see `getFieldFilterOptions`).
+     */
+    deriveFilterOptions?: boolean;
     /**
      * Fixed width for this column, applied via a `<colgroup>` `<col>`. A number
      * is treated as pixels (`200` → `200px`); a string is used verbatim
@@ -117,6 +133,35 @@ export interface EditTab {
     /** Lazy load tab content (optional, default false) */
     lazy?: boolean;
 }
+/**
+ * Discriminated data-source descriptor (#130). The additive, type-safe
+ * replacement for the legacy `items` / `provider` / `apiUrl` / `inertiaUrl` /
+ * `clientSide` prop matrix, in which every prop was independently optional and
+ * the mode was inferred by precedence — so invalid combinations compiled and
+ * some were silently ignored.
+ *
+ * Pass ONE `source`: the mode is explicit and its required companion prop is
+ * enforced by the compiler (`{ mode: 'provider' }` without a `provider` won't
+ * type-check). The legacy props still work and take over when `source` is
+ * omitted; a future major removes them with a codemod (#130 Phase 3).
+ *
+ * `apiAdapter` (transport translation) and `pagination` (server-supplied page
+ * metadata) stay sibling props — they're orthogonal to which mode is active.
+ */
+export type DXTableSource<TItem = any> = {
+    mode: 'client';
+    items: TItem[];
+} | {
+    mode: 'provider';
+    provider: BTableProvider<TItem>;
+} | {
+    mode: 'api';
+    url: string;
+} | {
+    mode: 'inertia';
+    items: TItem[];
+    url?: string;
+};
 export interface Props<TItem = any> {
     /** Table title */
     title?: string;
@@ -131,6 +176,13 @@ export interface Props<TItem = any> {
     /** Adapts the built-in provider's request params / response body to a
      *  backend convention that differs from dfl's (see DXTableApiAdapter). */
     apiAdapter?: DXTableApiAdapter;
+    /**
+     * Discriminated data-source (#130) — the type-safe alternative to the
+     * legacy `items` / `provider` / `apiUrl` / `inertiaUrl` / `clientSide`
+     * props. When set it WINS over those props; when omitted, the legacy props
+     * apply unchanged. See `DXTableSource`.
+     */
+    source?: DXTableSource<TItem>;
     /** Table field definitions */
     fields: TableField[];
     /** Sort configuration (v-model support) */
@@ -196,16 +248,64 @@ export interface Props<TItem = any> {
      * borderless variant — the same header, filter row, table and pagination
      * rendered directly on the page background (no card border/shadow), for
      * data-heavy admin index pages that read as busy inside a card.
+     *
+     * The table renders FLUSH to the card border (rows and stripes reach the
+     * edge) while the header and pagination stay padded, which requires the card
+     * to clip to its radius (`overflow: hidden`).
+     *
+     * **Consequence for slot content:** anything you render into a slot that
+     * positions itself OUTSIDE the card and does not teleport is clipped at the
+     * card edge. Library components are unaffected — `DDropdown` teleports to
+     * `<body>` by default, and the column-filter menus position themselves
+     * `fixed` — so this only bites a hand-rolled `position: absolute` overlay
+     * (a custom popover in a `cell(<key>)` or `#header` slot). Teleport it, or
+     * use `:card="false"`. Narrowing the clip to the table region is tracked
+     * as #166.
      */
     card?: boolean;
-    /** Form field definitions for edit modal (if provided, enables edit on row click) */
-    editFields?: any[];
+    /**
+     * Form field definitions for edit modal (if provided, enables edit on row
+     * click). `import type` is erased at compile time, so this creates no
+     * runtime import cycle (#131).
+     */
+    editFields?: FieldDefinition[];
     /** Tab definitions for organizing edit modal content */
     editTabs?: EditTab[];
     /** Edit modal title (can be function for dynamic titles) */
     editModalTitle?: string | ((item: any) => string);
     /** Edit modal size */
     editModalSize?: 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * Field layout for the edit/create modal's form, forwarded to its `DXForm`
+     * ("vertical" = label above input, "horizontal" = label left). Defaults to
+     * **"horizontal"** to match the Omni Tend form convention (a raw modal form
+     * previously fell back to DXForm's vertical default, which looked out of
+     * place next to horizontal page forms). Pass `"vertical"` to opt out.
+     *
+     * `"auto"` hands the decision to `DXForm`'s container-width observer, which
+     * measures the FORM rather than the window — so a modal narrowed by its own
+     * breakpoint stacks to vertical even on a wide viewport, where a media query
+     * would still report "plenty of room". See `useContainerWidth`.
+     */
+    editLayout?: 'vertical' | 'horizontal' | 'auto';
+    /**
+     * Label column width for the edit modal's horizontal layout, forwarded to
+     * `DXForm`'s `labelCols` (a single width or a per-breakpoint object). Only
+     * meaningful when `editLayout` is "horizontal".
+     */
+    editLabelCols?: LabelCols;
+    /**
+     * Wrap the edit/create modal's form in a bordered card. Off by default (the
+     * modal body already provides a boundary); opt in for a more contained,
+     * panelled look around a tabbed edit form.
+     */
+    editCard?: boolean;
+    /** Override the modal's Save button label (default: "Save {item}"). */
+    saveText?: string;
+    /** Override the modal's Create button label (default: "Create {item}"). */
+    createText?: string;
+    /** Override the modal's Delete button label (default: "Delete {item}"). */
+    deleteText?: string;
     /** API endpoint pattern for updates (e.g., "/api/products/:id") */
     editUrl?: string;
     /**
@@ -323,6 +423,11 @@ declare const _default: <T = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_
     }>): void;
     attrs: any;
     slots: {
+        [x: `head-end(${string})`]: ((props: {
+            field: TableField;
+            label: string;
+        }) => any) | undefined;
+    } & {
         [x: string]: ((props: any) => any) | undefined;
     } & {
         [x: string]: ((props: any) => any) | undefined;

package/dist/components/extended/DXTableEditorModal.vue.d.ts

@@ -1,4 +1,5 @@
 import type { EditTab } from "./DXTable.vue";
+import type { LabelCols } from "../../types";
 interface Props {
     /** Whether the modal is open (v-model:show). */
     show: boolean;
@@ -26,6 +27,25 @@ interface Props {
     pendingAction: 'save' | 'delete' | null;
     /** Delete endpoint — gates the Delete button. */
     deleteUrl?: string;
+    /**
+     * Field layout forwarded to the modal's DXForm (defaults handled upstream).
+     * Includes `"auto"`, which lets the form stack to vertical when the MODAL is
+     * narrow even though the viewport is wide — the container-query case a
+     * viewport media query cannot see.
+     */
+    layout?: 'vertical' | 'horizontal' | 'auto';
+    /** Label column width forwarded to DXForm (horizontal layout). */
+    labelCols?: LabelCols;
+    /** Wrap the modal form in a card (opt-in — off by default). */
+    card?: boolean;
+    /** Singular item noun for the default button labels (e.g. "customer"). */
+    itemName?: string;
+    /** Override the Save button label (edit mode). */
+    saveText?: string;
+    /** Override the Create button label (create mode). */
+    createText?: string;
+    /** Override the Delete button label. */
+    deleteText?: string;
 }
 declare var __VLS_21: `edit-value(${string})`, __VLS_22: {
     item: any;
@@ -59,16 +79,16 @@ type __VLS_Slots = {} & {
     [K in NonNullable<typeof __VLS_37>]?: (props: typeof __VLS_38) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    cancel: () => any;
     delete: () => any;
     "update:activeTab": (value: number) => any;
     save: () => any;
-    cancel: () => any;
     "update:show": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
     onDelete?: (() => any) | undefined;
     "onUpdate:activeTab"?: ((value: number) => any) | undefined;
     onSave?: (() => any) | undefined;
-    onCancel?: (() => any) | undefined;
     "onUpdate:show"?: ((value: boolean) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/components/extended/DXUserAvatar.vue.d.ts

@@ -22,11 +22,11 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    initial: string;
     user: {
         name: string;
         [key: string]: any;
     } | null;
-    initial: string;
     badge: boolean;
     badgeVariant: ColorVariant;
     badgeLabel: string;