@omnitend/dashboard-for-laravel 0.10.0 → 0.11.0

package/docs/public/api-reference.json

@@ -1,8 +1,8 @@
 {
-  "generated": "2026-07-04T12:57:30.569Z",
+  "generated": "2026-07-04T13:10:37.448Z",
   "package": {
     "name": "@omnitend/dashboard-for-laravel",
-    "version": "0.10.0"
+    "version": "0.11.0"
   },
   "components": {
     "base": [
@@ -1250,6 +1250,18 @@
             "default": "''",
             "description": "Page title shown in navbar"
           },
+          {
+            "name": "fluid",
+            "type": "boolean",
+            "required": false,
+            "description": "Render the page content full-width and left-aligned instead of the default\ncentred, reading-width (`col-xl-10`) column. Use for data-heavy admin pages\n(wide tables)."
+          },
+          {
+            "name": "contentClass",
+            "type": "string",
+            "required": false,
+            "description": "Extra class(es) applied to the content container/column."
+          },
           {
             "name": "user",
             "type": "union",
@@ -1307,7 +1319,7 @@
           },
           {
             "name": "default",
-            "description": "Default slot for the main page content, rendered in the centred content column.",
+            "description": "Default slot for the main page content. Full-width when `fluid`, otherwise a centred reading-width column.",
             "bindings": []
           }
         ],
@@ -2209,6 +2221,12 @@
             "required": false,
             "description": "API endpoint pattern for deletions (e.g., \"/api/products/:id\")"
           },
+          {
+            "name": "deleteGuard",
+            "type": "TSFunctionType",
+            "required": false,
+            "description": "Guard run when Delete is clicked, before the confirm dialog and request.\nReturn a message for a non-deletable item to show it immediately (as a\ntoast) and skip both the confirm and the delete request; return\n`null`/`undefined` to proceed with the normal confirm + delete. Lets you\nshort-circuit a doomed delete (e.g. a record with dependents that the\nserver would reject) with an immediate, specific reason."
+          },
           {
             "name": "createUrl",
             "type": "string",

package/docs/public/docs-map.md

@@ -1,7 +1,7 @@
 # Documentation Map
 
 > Auto-generated hierarchical overview of all documentation
-> Last updated: 2026-07-04T12:57:30.629Z
+> Last updated: 2026-07-04T13:10:37.517Z
 
 This file provides a complete map of all available documentation for AI agents and developers.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnitend/dashboard-for-laravel",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Vue 3 dashboard components for Laravel with Bootstrap Vue Next",
   "type": "module",
   "main": "./dist/dashboard-for-laravel.umd.cjs",

package/resources/js/components/extended/DXDashboard.vue

@@ -52,10 +52,15 @@
 
       <!-- Page Content -->
       <main class="dashboard-main p-4">
-        <DContainer fluid>
+        <!-- Fluid: full-width, left-aligned content (for wide tables / admin
+             pages). Default: a centred reading-width column. -->
+        <DContainer v-if="fluid" fluid :class="contentClass">
+          <!-- @slot Default slot for the main page content. Full-width when `fluid`, otherwise a centred reading-width column. -->
+          <slot />
+        </DContainer>
+        <DContainer v-else fluid>
           <DRow class="justify-content-center">
-            <DCol cols="12" xl="10">
-              <!-- @slot Default slot for the main page content, rendered in the centred content column. -->
+            <DCol cols="12" xl="10" :class="contentClass">
               <slot />
             </DCol>
           </DRow>
@@ -89,6 +94,16 @@ interface Props {
   /** Page title shown in navbar */
   pageTitle?: string;
 
+  /**
+   * Render the page content full-width and left-aligned instead of the default
+   * centred, reading-width (`col-xl-10`) column. Use for data-heavy admin pages
+   * (wide tables).
+   */
+  fluid?: boolean;
+
+  /** Extra class(es) applied to the content container/column. */
+  contentClass?: string;
+
   /** User object for navbar dropdown */
   user?: { name: string; email: string } | null;
 

package/resources/js/components/extended/DXTable.vue

@@ -794,6 +794,16 @@ export interface Props<TItem = any> {
     /** API endpoint pattern for deletions (e.g., "/api/products/:id") */
     deleteUrl?: string;
 
+    /**
+     * Guard run when Delete is clicked, before the confirm dialog and request.
+     * Return a message for a non-deletable item to show it immediately (as a
+     * toast) and skip both the confirm and the delete request; return
+     * `null`/`undefined` to proceed with the normal confirm + delete. Lets you
+     * short-circuit a doomed delete (e.g. a record with dependents that the
+     * server would reject) with an immediate, specific reason.
+     */
+    deleteGuard?: (item: TItem) => string | null | undefined;
+
     /** API endpoint for creating new items (e.g., "/api/products") — enables "New" button */
     createUrl?: string;
 
@@ -1733,6 +1743,19 @@ const handleEditCancel = () => {
 const handleDelete = async () => {
     if (!editForm.value || !selectedItem.value || !props.deleteUrl) return;
 
+    // Delete guard: a non-null message means this item can't be deleted — show
+    // it immediately and skip the confirm and the request entirely.
+    const guardMessage = props.deleteGuard?.(selectedItem.value as T);
+    if (guardMessage) {
+        createToast?.({
+            title: 'Cannot delete',
+            body: guardMessage,
+            variant: 'danger',
+            modelValue: 5000,
+        });
+        return;
+    }
+
     // Confirm deletion
     const itemName = (selectedItem.value as any).name || (selectedItem.value as any).title || singularItemName.value;
     const confirmed = window.confirm(`Are you sure you want to delete "${itemName}"? This action cannot be undone.`);
@@ -1786,6 +1809,12 @@ const handleDelete = async () => {
 
 defineExpose({
     refresh,
+    /**
+     * Open the built-in create modal (same as clicking the default "New {item}"
+     * button). Lets the create action live outside the table card — e.g. in a
+     * page header or the dashboard navbar. No-op unless `editFields` are set.
+     */
+    openCreate: handleCreateNew,
 });
 </script>