@omnitend/dashboard-for-laravel 0.33.0 → 0.34.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/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,8 +1,28 @@
+import type { FieldDefinition, LabelCols } from "../../types";
 export type FilterType = 'text' | 'select' | 'number' | 'date' | false;
 export interface FilterOption {
     value: string;
     text: string;
 }
+/**
+ * Adapts the built-in `apiUrl` provider's request/response to a backend whose
+ * convention differs from dfl's (spatie query-builder params, an envelope
+ * without the `{data, pagination}` shape). The sanctioned replacement for the
+ * axios-interceptor bridges #132 removed the route for: `request` maps the
+ * outgoing params (its return is what goes on the wire); `response` maps the
+ * body back, receiving the ORIGINAL dfl-shape params (`page`, `perPage`, …)
+ * so it can synthesize paginator metadata a foreign envelope lacks.
+ */
+export interface DXTableApiAdapter {
+    request?: (params: Record<string, any>) => Record<string, any>;
+    response?: (body: any, context: {
+        params: Record<string, any>;
+    }) => {
+        data: any[];
+        pagination?: PaginationData;
+        filterValues?: Record<string, string[]>;
+    };
+}
 export interface TableField {
     key: string;
     label?: string;
@@ -98,6 +118,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;
@@ -109,6 +158,16 @@ export interface Props<TItem = any> {
     provider?: BTableProvider<TItem>;
     /** API endpoint URL for auto-provider mode (alternative to provider function) */
     apiUrl?: string;
+    /** 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) */
@@ -176,14 +235,44 @@ export interface Props<TItem = any> {
      * data-heavy admin index pages that read as busy inside a card.
      */
     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.
+     */
+    editLayout?: 'vertical' | 'horizontal';
+    /**
+     * 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;
     /**

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,20 @@ 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). */
+    layout?: 'vertical' | 'horizontal';
+    /** 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 +74,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;

package/dist/composables/useAsyncOptions.d.ts

@@ -0,0 +1,20 @@
+import { type ComputedRef, type Ref } from "vue";
+import type { FieldDefinition, FieldOption } from "../types";
+/**
+ * Async option loading for a `DXField`: runs `field.optionsLoader` on mount and
+ * (when `field.reloadOptionsOnChange` is set) whenever the model changes,
+ * exposing the loaded options. A monotonic request token guards against
+ * out-of-order responses clobbering newer ones; loader failures are swallowed
+ * so the last good options (or the static `field.options` fallback) stay put.
+ *
+ * Extracted verbatim from DXField's inline logic (#135) — behaviour unchanged.
+ * `getField` is an accessor (props aren't destructurable without losing
+ * reactivity); `effectiveModel` is the model passed to the loader.
+ */
+export interface UseAsyncOptionsReturn {
+    /** Options returned by the most recent successful load, or null if none yet. */
+    loadedOptions: Ref<FieldOption[] | null>;
+    /** Trigger a load (no-op when the field has no `optionsLoader`). */
+    loadOptions: () => Promise<void>;
+}
+export declare function useAsyncOptions(getField: () => FieldDefinition, effectiveModel: ComputedRef<any> | Ref<any>): UseAsyncOptionsReturn;

package/dist/composables/useResourceEditor.d.ts

@@ -1,4 +1,5 @@
 import { type Ref } from "vue";
+import type { FieldDefinition } from "../types";
 /**
  * The subset of `DXTable`'s props the resource editor reads. Declared
  * structurally (not imported from DXTable.vue) so the composable stays a
@@ -7,7 +8,7 @@ import { type Ref } from "vue";
  */
 export interface ResourceEditorProps<T = any> {
     /** Field definitions for the edit/create modal (enables edit-on-row-click). */
-    editFields?: any[];
+    editFields?: FieldDefinition[];
     /** Tab definitions — only their `key` is read here (DXForm consumes the rest). */
     editTabs?: Array<{
         key: string;