@omnitend/dashboard-for-laravel 0.26.0 → 0.28.0

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

@@ -7,6 +7,7 @@ export declare function mergeOptions(base: Record<string, any>, override: Record
  * available — chart.js is an external peer dep, so this adds no bundle weight.
  */
 export declare function registerCharts(): void;
+export declare const PALETTE_VARS: Array<[string, string]>;
 /** Resolve the themed categorical palette from the document root. */
 export declare function getPalette(): string[];
 /** Add an alpha channel to a hex or rgb() colour (best-effort). */

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

@@ -220,6 +220,12 @@ export interface Props<TItem = any> {
 }
 declare const _default: <T = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly onRowCreated?: ((item: any, response: any) => any) | undefined;
+        readonly onCreateError?: ((error: any) => any) | undefined;
+        readonly onRowUpdated?: ((item: T, response: any) => any) | undefined;
+        readonly onEditError?: ((item: T, error: any) => any) | undefined;
+        readonly onRowDeleted?: ((item: T, response: any) => any) | undefined;
+        readonly onDeleteError?: ((item: T, error: any) => any) | undefined;
         readonly "onUpdate:sortBy"?: ((sortBy: BTableSortBy[]) => any) | undefined;
         readonly "onUpdate:busy"?: ((busy: boolean) => any) | undefined;
         readonly onRowClicked?: ((item: T, index: number, event: MouseEvent) => any) | undefined;
@@ -231,15 +237,9 @@ declare const _default: <T = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_
         }) => any) | undefined;
         readonly onFilterChange?: ((filters: Record<string, string>) => any) | undefined;
         readonly onPerPageChange?: ((perPage: number) => any) | undefined;
-        readonly onRowCreated?: ((item: any, response: any) => any) | undefined;
-        readonly onCreateError?: ((error: any) => any) | undefined;
-        readonly onRowUpdated?: ((item: T, response: any) => any) | undefined;
-        readonly onEditError?: ((item: T, error: any) => any) | undefined;
-        readonly onRowDeleted?: ((item: T, response: any) => any) | undefined;
-        readonly onDeleteError?: ((item: T, error: any) => any) | undefined;
         readonly "onUpdate:filters"?: ((filters: Record<string, string>) => any) | undefined;
         readonly "onUpdate:perPage"?: ((perPage: number) => any) | undefined;
-    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:sortBy" | "onUpdate:busy" | "onRowClicked" | "onUpdate:expandedItems" | "onPageChange" | "onSortChange" | "onFilterChange" | "onPerPageChange" | "onRowCreated" | "onCreateError" | "onRowUpdated" | "onEditError" | "onRowDeleted" | "onDeleteError" | "onUpdate:filters" | "onUpdate:perPage"> & Props<T> & Partial<{}>> & import("vue").PublicProps;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:sortBy" | "onUpdate:busy" | "onRowClicked" | "onUpdate:expandedItems" | "onRowCreated" | "onCreateError" | "onRowUpdated" | "onEditError" | "onRowDeleted" | "onDeleteError" | "onPageChange" | "onSortChange" | "onFilterChange" | "onPerPageChange" | "onUpdate:filters" | "onUpdate:perPage"> & Props<T> & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{
         refresh: () => void;
         /**
@@ -254,50 +254,15 @@ declare const _default: <T = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_
         [x: string]: ((props: any) => any) | undefined;
     } & {
         [x: string]: ((props: any) => any) | undefined;
-    } & {
-        [x: string]: ((props: any) => any) | undefined;
-    } & {
-        [x: `edit-value(${string})`]: ((props: {
-            item: import("@vue/reactivity").DistributeRef<[T | null] extends [import("vue").Ref<any, any>] ? import("@vue/shared").IfAny<import("vue").Ref<any, any> & T, import("vue").Ref<import("vue").Ref<any, any> & T, import("vue").Ref<any, any> & T>, import("vue").Ref<any, any> & T> : import("vue").Ref<import("vue").UnwrapRef<T> | null, T | import("vue").UnwrapRef<T> | null>>;
-            value: any;
-            update: any;
-            field: any;
-        }) => any) | undefined;
-    } & {
-        [x: `edit-span(${string})`]: ((props: {
-            item: import("@vue/reactivity").DistributeRef<[T | null] extends [import("vue").Ref<any, any>] ? import("@vue/shared").IfAny<import("vue").Ref<any, any> & T, import("vue").Ref<import("vue").Ref<any, any> & T, import("vue").Ref<any, any> & T>, import("vue").Ref<any, any> & T> : import("vue").Ref<import("vue").UnwrapRef<T> | null, T | import("vue").UnwrapRef<T> | null>>;
-            value: any;
-            update: any;
-            close: () => void;
-        }) => any) | undefined;
-    } & {
-        [x: `tab-content(${string})`]: ((props: {
-            item: import("@vue/reactivity").DistributeRef<[T | null] extends [import("vue").Ref<any, any>] ? import("@vue/shared").IfAny<import("vue").Ref<any, any> & T, import("vue").Ref<import("vue").Ref<any, any> & T, import("vue").Ref<any, any> & T>, import("vue").Ref<any, any> & T> : import("vue").Ref<import("vue").UnwrapRef<T> | null, T | import("vue").UnwrapRef<T> | null>>;
-            tab: any;
-        }) => any) | undefined;
-    } & {
-        [x: `tab-before(${string})`]: ((props: {
-            item: import("@vue/reactivity").DistributeRef<[T | null] extends [import("vue").Ref<any, any>] ? import("@vue/shared").IfAny<import("vue").Ref<any, any> & T, import("vue").Ref<import("vue").Ref<any, any> & T, import("vue").Ref<any, any> & T>, import("vue").Ref<any, any> & T> : import("vue").Ref<import("vue").UnwrapRef<T> | null, T | import("vue").UnwrapRef<T> | null>>;
-            tab: any;
-        }) => any) | undefined;
-    } & {
-        [x: `tab-after(${string})`]: ((props: {
-            item: import("@vue/reactivity").DistributeRef<[T | null] extends [import("vue").Ref<any, any>] ? import("@vue/shared").IfAny<import("vue").Ref<any, any> & T, import("vue").Ref<import("vue").Ref<any, any> & T, import("vue").Ref<any, any> & T>, import("vue").Ref<any, any> & T> : import("vue").Ref<import("vue").UnwrapRef<T> | null, T | import("vue").UnwrapRef<T> | null>>;
-            tab: any;
-        }) => any) | undefined;
     } & {
         header?: (props: {}) => any;
     } & {
         'thead-top'?: (props: any) => any;
-    } & {
-        'thead-top'?: (props: any) => any;
-    } & {
-        'thead-top'?: (props: any) => any;
     };
-    emit: ((evt: "update:sortBy", sortBy: BTableSortBy[]) => void) & ((evt: "update:busy", busy: boolean) => void) & ((evt: "rowClicked", item: T, index: number, event: MouseEvent) => void) & ((evt: "update:expandedItems", items: T[]) => void) & ((evt: "pageChange", page: number) => void) & ((evt: "sortChange", sort: {
+    emit: ((evt: "rowCreated", item: any, response: any) => void) & ((evt: "createError", error: any) => void) & ((evt: "rowUpdated", item: T, response: any) => void) & ((evt: "editError", item: T, error: any) => void) & ((evt: "rowDeleted", item: T, response: any) => void) & ((evt: "deleteError", item: T, error: any) => void) & ((evt: "update:sortBy", sortBy: BTableSortBy[]) => void) & ((evt: "update:busy", busy: boolean) => void) & ((evt: "rowClicked", item: T, index: number, event: MouseEvent) => void) & ((evt: "update:expandedItems", items: T[]) => void) & ((evt: "pageChange", page: number) => void) & ((evt: "sortChange", sort: {
         key: string;
         order: "asc" | "desc";
-    }) => void) & ((evt: "filterChange", filters: Record<string, string>) => void) & ((evt: "perPageChange", perPage: number) => void) & ((evt: "rowCreated", item: any, response: any) => void) & ((evt: "createError", error: any) => void) & ((evt: "rowUpdated", item: T, response: any) => void) & ((evt: "editError", item: T, error: any) => void) & ((evt: "rowDeleted", item: T, response: any) => void) & ((evt: "deleteError", item: T, error: any) => void) & ((evt: "update:filters", filters: Record<string, string>) => void) & ((evt: "update:perPage", perPage: number) => void);
+    }) => void) & ((evt: "filterChange", filters: Record<string, string>) => void) & ((evt: "perPageChange", perPage: number) => void) & ((evt: "update:filters", filters: Record<string, string>) => void) & ((evt: "update:perPage", perPage: number) => void);
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

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

@@ -0,0 +1,80 @@
+import type { EditTab } from "./DXTable.vue";
+interface Props {
+    /** Whether the modal is open (v-model:show). */
+    show: boolean;
+    /** Modal title. */
+    title: string;
+    /** Modal size. */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /** True while the full record is loading via showUrl. */
+    loading: boolean;
+    /** The edit/create form (a useForm instance), or null before first open. */
+    form: any;
+    /** Bumped per modal open to remount the DXForm subtree (fresh DXField state). */
+    formInstanceKey: number;
+    /** Active tab index (v-model:active-tab). */
+    activeTab: number;
+    /** Field definitions passed to DXForm. */
+    fields: any[];
+    /** Tab definitions passed to DXForm. */
+    tabs?: EditTab[];
+    /** The row being edited (null in create mode) — the slot/context row. */
+    item: any;
+    /** Whether the modal is in create mode (vs edit). */
+    isCreateMode: boolean;
+    /** Which action is in flight, so Save/Delete show their own loading label. */
+    pendingAction: 'save' | 'delete' | null;
+    /** Delete endpoint — gates the Delete button. */
+    deleteUrl?: string;
+}
+declare var __VLS_21: `edit-value(${string})`, __VLS_22: {
+    item: any;
+    value: any;
+    update: any;
+    field: any;
+}, __VLS_25: `edit-span(${string})`, __VLS_26: {
+    item: any;
+    value: any;
+    update: any;
+    close: () => void;
+}, __VLS_29: `tab-content(${string})`, __VLS_30: {
+    item: any;
+    tab: any;
+}, __VLS_33: `tab-before(${string})`, __VLS_34: {
+    item: any;
+    tab: any;
+}, __VLS_37: `tab-after(${string})`, __VLS_38: {
+    item: any;
+    tab: any;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_21>]?: (props: typeof __VLS_22) => any;
+} & {
+    [K in NonNullable<typeof __VLS_25>]?: (props: typeof __VLS_26) => any;
+} & {
+    [K in NonNullable<typeof __VLS_29>]?: (props: typeof __VLS_30) => any;
+} & {
+    [K in NonNullable<typeof __VLS_33>]?: (props: typeof __VLS_34) => any;
+} & {
+    [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, {
+    delete: () => any;
+    "update:activeTab": (value: number) => any;
+    save: () => any;
+    cancel: () => any;
+    "update:show": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    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>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,27 @@
+import type { PaginationData } from "./DXTable.vue";
+interface Props {
+    /** The active pagination metadata (client-side / inertia / provider). */
+    pagination: PaginationData;
+    /** The effective page size, shown in the selector. */
+    perPage: number;
+    /** Page sizes offered by the selector. */
+    perPageOptions: number[];
+    /** Whether to render the pager (still hidden when there is only one page). */
+    showPagination: boolean;
+    /** Whether to render the per-page selector. */
+    showPerPageSelector: boolean;
+    /** Singular item noun for the info line (e.g. "product"). */
+    singularItemName: string;
+    /** Plural item noun for the info line (e.g. "products"). */
+    pluralItemName: string;
+    /** Whether a column filter is active — gates the "Filtered from N" note. */
+    hasActiveFilters: boolean;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "page-change": (page: number) => any;
+    "per-page-change": (value: string | number | (string | number)[] | null) => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    "onPage-change"?: ((page: number) => any) | undefined;
+    "onPer-page-change"?: ((value: string | number | (string | number)[] | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/composables/useResourceEditor.d.ts

@@ -0,0 +1,74 @@
+import { type Ref } from "vue";
+/**
+ * The subset of `DXTable`'s props the resource editor reads. Declared
+ * structurally (not imported from DXTable.vue) so the composable stays a
+ * lower-level dependency — DXTable imports the composable, not the reverse.
+ * DXTable's full `Props` is structurally assignable to this.
+ */
+export interface ResourceEditorProps<T = any> {
+    /** Field definitions for the edit/create modal (enables edit-on-row-click). */
+    editFields?: any[];
+    /** Tab definitions — only their `key` is read here (DXForm consumes the rest). */
+    editTabs?: Array<{
+        key: string;
+    }>;
+    /** Modal title, or a function of the edited row. */
+    editModalTitle?: string | ((item: any) => string);
+    /** `PUT` endpoint pattern for updates, e.g. `/api/products/:id`. */
+    editUrl?: string;
+    /** `GET` endpoint pattern to fetch the full record on open, e.g. `/api/products/:id`. */
+    showUrl?: string;
+    /** `DELETE` endpoint pattern, e.g. `/api/products/:id`. */
+    deleteUrl?: string;
+    /** `POST` endpoint for creating new items, e.g. `/api/products`. */
+    createUrl?: string;
+    /** Guard run before delete — a message short-circuits with a toast. */
+    deleteGuard?: (item: T) => string | null | undefined;
+}
+/**
+ * The events the editor emits back through DXTable's `emit`. Declared as the
+ * exact call signatures it uses (a subset of DXTable's emits) so DXTable's typed
+ * `emit` is structurally assignable here.
+ */
+export interface ResourceEditorEmit<T = any> {
+    (event: 'rowCreated', item: any, response: any): void;
+    (event: 'createError', error: any): void;
+    (event: 'rowUpdated', item: T, response: any): void;
+    (event: 'editError', item: T, error: any): void;
+    (event: 'rowDeleted', item: T, response: any): void;
+    (event: 'deleteError', item: T, error: any): void;
+}
+export interface UseResourceEditorOptions {
+    /** Invalidate whichever data source is active, after a successful CRUD op. */
+    refresh: () => void;
+    /** Singular item noun (e.g. "product") — for toasts and the modal title. */
+    singularItemName: Ref<string>;
+}
+/**
+ * The resource editor for `DXTable` — the create/edit/delete concern lifted out
+ * of the god-component (#129). Owns the edit-modal state, form seeding and
+ * visibility rules, the `showUrl` full-record fetch, submission (create `POST` /
+ * edit `PUT` / delete), the success/error toasts, and the edit-modal slot-key
+ * computeds. It never touches the table's data source, sort, filter, per-page
+ * or pagination state — the only coupling back to the table is the `refresh`
+ * callback it calls after a successful op.
+ *
+ * DXTable keeps `handleRowClick` (which emits `rowClicked` regardless) and calls
+ * `openEdit` from it; `openEdit` is a no-op unless `editFields` are set.
+ */
+export declare function useResourceEditor<T = any>(props: ResourceEditorProps<T>, emit: ResourceEditorEmit<T>, options: UseResourceEditorOptions): {
+    showEditModal: Ref<boolean, boolean>;
+    editForm: Ref<any, any>;
+    editFormInstanceKey: Ref<number, number>;
+    activeTabIndex: Ref<number, number>;
+    selectedItem: [T | null] extends [Ref<any, any>] ? import("@vue/shared").IfAny<Ref<any, any> & T, Ref<Ref<any, any> & T, Ref<any, any> & T>, Ref<any, any> & T> : Ref<import("vue").UnwrapRef<T> | null, T | import("vue").UnwrapRef<T> | null>;
+    isCreateMode: Ref<boolean, boolean>;
+    pendingAction: Ref<"delete" | "save" | null, "delete" | "save" | null>;
+    editLoading: Ref<boolean, boolean>;
+    computedModalTitle: import("vue").ComputedRef<string>;
+    openEdit: (item: T) => void;
+    openCreate: () => void;
+    save: () => Promise<void>;
+    cancel: () => void;
+    remove: () => Promise<void>;
+};