@omnitend/dashboard-for-laravel 0.4.14 → 0.5.0

package/docs/public/api-reference.json

@@ -1,8 +1,8 @@
 {
-  "generated": "2025-12-02T13:23:09.065Z",
+  "generated": "2026-06-28T12:36:46.436Z",
   "package": {
     "name": "@omnitend/dashboard-for-laravel",
-    "version": "0.4.8"
+    "version": "0.5.0"
   },
   "components": {
     "base": [
@@ -503,6 +503,27 @@
         ],
         "methods": []
       },
+      {
+        "name": "DFormRadioGroup",
+        "category": "base",
+        "filePath": "resources/js/components/base/DFormRadioGroup.vue",
+        "description": "",
+        "props": [],
+        "events": [],
+        "slots": [
+          {
+            "name": "name",
+            "description": "",
+            "bindings": [
+              {
+                "name": "name",
+                "title": "binding"
+              }
+            ]
+          }
+        ],
+        "methods": []
+      },
       {
         "name": "DFormSelect",
         "category": "base",
@@ -1154,71 +1175,18 @@
         "category": "extended",
         "filePath": "resources/js/components/extended/DXBasicForm.vue",
         "description": "",
-        "props": [
-          {
-            "name": "form",
-            "type": "UseFormReturn",
-            "required": true,
-            "description": "Form instance from useForm composable"
-          },
-          {
-            "name": "fields",
-            "type": "Array",
-            "required": true,
-            "description": "Field definitions"
-          },
-          {
-            "name": "submitText",
-            "type": "string",
-            "required": false,
-            "default": "\"Submit\"",
-            "description": "Submit button text"
-          },
-          {
-            "name": "submitLoadingText",
-            "type": "string",
-            "required": false,
-            "default": "\"Submitting...\"",
-            "description": "Submit button loading text"
-          },
-          {
-            "name": "showSubmit",
-            "type": "boolean",
-            "required": false,
-            "default": "true",
-            "description": "Show submit button"
-          }
-        ],
-        "events": [
-          {
-            "name": "submit",
-            "description": "",
-            "properties": []
-          }
-        ],
+        "props": [],
+        "events": [],
         "slots": [
           {
-            "name": "`field-${field.key}`",
+            "name": "name",
             "description": "",
             "bindings": [
               {
                 "name": "name",
                 "title": "binding"
-              },
-              {
-                "name": "field",
-                "title": "binding"
-              },
-              {
-                "name": "form",
-                "title": "binding"
               }
             ]
-          },
-          {
-            "name": "footer",
-            "description": "",
-            "bindings": []
           }
         ],
         "methods": []
@@ -1459,6 +1427,125 @@
         ],
         "methods": []
       },
+      {
+        "name": "DXField",
+        "category": "extended",
+        "filePath": "resources/js/components/extended/DXField.vue",
+        "description": "",
+        "props": [
+          {
+            "name": "field",
+            "type": "FieldDefinition",
+            "required": true,
+            "description": "Field definition to render"
+          },
+          {
+            "name": "form",
+            "type": "UseFormReturn",
+            "required": true,
+            "description": "Form instance owning the field's data and errors"
+          },
+          {
+            "name": "model",
+            "type": "any",
+            "required": false,
+            "description": "Model passed to predicates (label/hint/when/disabled/readonly).\nDefaults to the live form data; a parent may widen it (e.g. a table\nmerging the original row)."
+          },
+          {
+            "name": "keyPath",
+            "type": "string",
+            "required": false,
+            "description": "Dot path into form.data for the value (defaults to field.key)."
+          },
+          {
+            "name": "errorKey",
+            "type": "string",
+            "required": false,
+            "description": "Error key for validation lookups (defaults to keyPath/field.key)."
+          }
+        ],
+        "events": [],
+        "slots": [
+          {
+            "name": "span",
+            "description": "",
+            "bindings": [
+              {
+                "name": "field",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              },
+              {
+                "name": "value",
+                "title": "binding"
+              },
+              {
+                "name": "update",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "value",
+            "description": "",
+            "bindings": [
+              {
+                "name": "field",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              },
+              {
+                "name": "value",
+                "title": "binding"
+              },
+              {
+                "name": "update",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "info",
+            "description": "",
+            "bindings": [
+              {
+                "name": "field",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "hint",
+            "description": "",
+            "bindings": [
+              {
+                "name": "field",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "repeater-row",
+            "description": "",
+            "bindings": []
+          }
+        ],
+        "methods": []
+      },
       {
         "name": "DXForm",
         "category": "extended",
@@ -1467,9 +1554,27 @@
         "props": [
           {
             "name": "form",
-            "type": "DefineFormReturn",
+            "type": "union",
             "required": true,
-            "description": "Form object from defineForm"
+            "description": "Form instance — either a raw `useForm` return or a `defineForm`\nreturn (`{ form, fields }`). With the latter, `fields` may be\nomitted and is taken from the form object."
+          },
+          {
+            "name": "fields",
+            "type": "Array",
+            "required": false,
+            "description": "Field definitions (optional when `form` is a defineForm return)."
+          },
+          {
+            "name": "tabs",
+            "type": "Array",
+            "required": false,
+            "description": "Tab definitions. When omitted, a flat single-column form renders."
+          },
+          {
+            "name": "context",
+            "type": "Record",
+            "required": false,
+            "description": "Extra context merged under the live form data when evaluating\npredicates (label/hint/when/disabled). E.g. a table passes the\noriginal row so predicates can read non-edited columns."
           },
           {
             "name": "submitText",
@@ -1490,7 +1595,14 @@
             "type": "boolean",
             "required": false,
             "default": "true",
-            "description": "Show submit button"
+            "description": "Show the submit button"
+          },
+          {
+            "name": "autoErrorTab",
+            "type": "boolean",
+            "required": false,
+            "default": "true",
+            "description": "Auto-switch to the first tab containing a validation error."
           }
         ],
         "events": [
@@ -1502,12 +1614,138 @@
         ],
         "slots": [
           {
-            "name": "name",
+            "name": "`tab-content(${tab.key})`",
+            "description": "",
+            "bindings": [
+              {
+                "name": "name",
+                "title": "binding"
+              },
+              {
+                "name": "tab",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "`tab-before(${tab.key})`",
             "description": "",
             "bindings": [
               {
                 "name": "name",
                 "title": "binding"
+              },
+              {
+                "name": "tab",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "slotName",
+            "description": "",
+            "bindings": [
+              {
+                "name": "name",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "`tab-after(${tab.key})`",
+            "description": "",
+            "bindings": [
+              {
+                "name": "name",
+                "title": "binding"
+              },
+              {
+                "name": "tab",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "footer",
+            "description": "",
+            "bindings": [
+              {
+                "name": "form",
+                "title": "binding"
+              }
+            ]
+          }
+        ],
+        "methods": []
+      },
+      {
+        "name": "DXRepeater",
+        "category": "extended",
+        "filePath": "resources/js/components/extended/DXRepeater.vue",
+        "description": "",
+        "props": [
+          {
+            "name": "form",
+            "type": "UseFormReturn",
+            "required": true,
+            "description": "Form instance owning the repeater array"
+          },
+          {
+            "name": "field",
+            "type": "FieldDefinition",
+            "required": true,
+            "description": "The repeater field definition (provides sub-fields, limits, labels)"
+          },
+          {
+            "name": "keyPath",
+            "type": "string",
+            "required": false,
+            "description": "Dot path into form.data for the array (defaults to field.key)"
+          },
+          {
+            "name": "model",
+            "type": "any",
+            "required": false,
+            "description": "Model passed to predicates from the parent context"
+          }
+        ],
+        "events": [],
+        "slots": [
+          {
+            "name": "row",
+            "description": "",
+            "bindings": [
+              {
+                "name": "row",
+                "title": "binding"
+              },
+              {
+                "name": "index",
+                "title": "binding"
+              },
+              {
+                "name": "fields",
+                "title": "binding"
+              },
+              {
+                "name": "remove",
+                "title": "binding"
+              },
+              {
+                "name": "path",
+                "title": "binding"
               }
             ]
           }
@@ -1728,6 +1966,18 @@
             "type": "string",
             "required": false,
             "description": "API endpoint pattern for deletions (e.g., \"/api/products/:id\")"
+          },
+          {
+            "name": "createUrl",
+            "type": "string",
+            "required": false,
+            "description": "API endpoint for creating new items (e.g., \"/api/products\") — enables \"New\" button"
+          },
+          {
+            "name": "clientSide",
+            "type": "boolean",
+            "required": false,
+            "description": "Enable client-side filtering, sorting, and pagination on items array"
           }
         ],
         "events": [
@@ -1756,6 +2006,16 @@
             "description": "",
             "properties": []
           },
+          {
+            "name": "rowCreated",
+            "description": "",
+            "properties": []
+          },
+          {
+            "name": "createError",
+            "description": "",
+            "properties": []
+          },
           {
             "name": "rowUpdated",
             "description": "",
@@ -1814,7 +2074,7 @@
             ]
           },
           {
-            "name": "`tab-content(${tab.key})`",
+            "name": "`edit-value(${key})`",
             "description": "",
             "bindings": [
               {
@@ -1826,31 +2086,21 @@
                 "title": "binding"
               },
               {
-                "name": "tab",
-                "title": "binding"
-              }
-            ]
-          },
-          {
-            "name": "`tab-before(${tab.key})`",
-            "description": "",
-            "bindings": [
-              {
-                "name": "name",
+                "name": "value",
                 "title": "binding"
               },
               {
-                "name": "item",
+                "name": "update",
                 "title": "binding"
               },
               {
-                "name": "tab",
+                "name": "field",
                 "title": "binding"
               }
             ]
           },
           {
-            "name": "`edit-span(${fieldKey})`",
+            "name": "`edit-span(${key})`",
             "description": "",
             "bindings": [
               {
@@ -1876,7 +2126,7 @@
             ]
           },
           {
-            "name": "`edit-value(${fieldKey})`",
+            "name": "`tab-content(${key})`",
             "description": "",
             "bindings": [
               {
@@ -1888,21 +2138,31 @@
                 "title": "binding"
               },
               {
-                "name": "value",
+                "name": "tab",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "`tab-before(${key})`",
+            "description": "",
+            "bindings": [
+              {
+                "name": "name",
                 "title": "binding"
               },
               {
-                "name": "update",
+                "name": "item",
                 "title": "binding"
               },
               {
-                "name": "field",
+                "name": "tab",
                 "title": "binding"
               }
             ]
           },
           {
-            "name": "`tab-after(${tab.key})`",
+            "name": "`tab-after(${key})`",
             "description": "",
             "bindings": [
               {
@@ -1925,8 +2185,8 @@
     ]
   },
   "stats": {
-    "totalComponents": 61,
-    "baseComponents": 55,
-    "extendedComponents": 6
+    "totalComponents": 64,
+    "baseComponents": 56,
+    "extendedComponents": 8
   }
 }

package/docs/public/docs-map.md

@@ -1,7 +1,7 @@
 # Documentation Map
 
 > Auto-generated hierarchical overview of all documentation
-> Last updated: 2025-12-02T13:23:09.125Z
+> Last updated: 2026-06-28T12:36:46.494Z
 
 This file provides a complete map of all available documentation for AI agents and developers.
 
@@ -69,11 +69,12 @@ This file provides a complete map of all available documentation for AI agents a
 
 ### Extended
 
-- [DXBasicForm](/components/extended/DXBasicForm): Form instance from useForm composable
 - [DXDashboard](/components/extended/DXDashboard): Complete dashboard layout component that combines sidebar navigation, top navbar, and content area. 
 - [DXDashboardNavbar](/components/extended/DXDashboardNavbar): A responsive top navigation bar component for Laravel dashboards with user menu, search functionalit
 - [DXDashboardSidebar](/components/extended/DXDashboardSidebar): A collapsible sidebar navigation component for Laravel dashboards with support for navigation groups
-- [DXForm](/components/extended/DXForm): Form object from defineForm
+- [DXField](/components/extended/DXField): The single-field renderer that powers `DXForm` and
+- [DXForm](/components/extended/DXForm): The canonical form renderer. Drive it with field definitions; add `tabs` when
+- [DXRepeater](/components/extended/DXRepeater): A repeatable sub-form (field array) primitive for nested, dynamic collections —
 - [DXTable](/components/extended/DXTable): A comprehensive data table component with built-in pagination, sorting, filtering, and CRUD operatio
 
 ### Examples
@@ -93,4 +94,4 @@ This file provides a complete map of all available documentation for AI agents a
 
 ---
 
-**Total Pages**: 69
+**Total Pages**: 70

package/docs/public/llms.txt

@@ -2,7 +2,7 @@
 
 > Vue 3 dashboard components for Laravel with Bootstrap Vue Next
 >
-> A dual-package library (NPM + Composer) providing 61 Vue 3 components for building Laravel dashboards with Bootstrap Vue Next.
+> A dual-package library (NPM + Composer) providing 64 Vue 3 components for building Laravel dashboards with Bootstrap Vue Next.
 
 ## Installation
 
@@ -19,7 +19,7 @@
 - [Theming](/guide/theming): Customize appearance with CSS variables
 - [TypeScript](/guide/typescript): TypeScript types and best practices
 
-## Base Components (55 components)
+## Base Components (56 components)
 
 Lightweight type-safe wrappers around Bootstrap Vue Next components providing API stability and consistent theming.
 
@@ -47,6 +47,7 @@ Lightweight type-safe wrappers around Bootstrap Vue Next components providing AP
 - [DFormInput](/components/base/dforminput): Bootstrap Vue Next FormInput wrapper
 - [DFormInvalidFeedback](/components/base/dforminvalidfeedback): Bootstrap Vue Next FormInvalidFeedback wrapper
 - [DFormRadio](/components/base/dformradio): Bootstrap Vue Next FormRadio wrapper
+- [DFormRadioGroup](/components/base/dformradiogroup): Bootstrap Vue Next FormRadioGroup wrapper
 - [DFormSelect](/components/base/dformselect): Bootstrap Vue Next FormSelect wrapper
 - [DFormSpinbutton](/components/base/dformspinbutton): Bootstrap Vue Next FormSpinbutton wrapper
 - [DFormTags](/components/base/dformtags): Bootstrap Vue Next FormTags wrapper
@@ -79,15 +80,17 @@ Lightweight type-safe wrappers around Bootstrap Vue Next components providing AP
 - [DToaster](/components/base/dtoaster): Bootstrap Vue Next Toaster wrapper
 - [DTooltip](/components/base/dtooltip): Bootstrap Vue Next Tooltip wrapper
 
-## Extended Components (6 components)
+## Extended Components (8 components)
 
 Custom dashboard components with advanced functionality beyond Bootstrap Vue Next.
 
-- [DXBasicForm](/components/extended/dxbasicform): Auto-generated forms from field definitions
+- [DXBasicForm](/components/extended/dxbasicform): Extended dashboard component
 - [DXDashboard](/components/extended/dxdashboard): Complete dashboard layout with sidebar and navbar
 - [DXDashboardNavbar](/components/extended/dxdashboardnavbar): Top navbar with user dropdown
 - [DXDashboardSidebar](/components/extended/dxdashboardsidebar): Collapsible sidebar with navigation
-- [DXForm](/components/extended/dxform): Advanced form wrapper with defineForm integration
+- [DXField](/components/extended/dxfield): Single-field renderer for any field type with value/span/info/hint slots
+- [DXForm](/components/extended/dxform): Form renderer driven by field definitions, with optional tabs, conditional fields, per-field slots, async options, nested repeaters, and auto error-tab switching
+- [DXRepeater](/components/extended/dxrepeater): Repeatable nested sub-form (field array) primitive
 - [DXTable](/components/extended/dxtable): Data table with pagination, filtering, and sorting
 
 ## Composables

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnitend/dashboard-for-laravel",
-  "version": "0.4.14",
+  "version": "0.5.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/base/DFormRadioGroup.vue

@@ -0,0 +1,21 @@
+/**
+ * @component
+ * Type-safe wrapper around Bootstrap Vue Next BFormRadioGroup component.
+ * Renders a group of radio inputs from an `options` array or slot content.
+ */
+<script setup lang="ts">
+import { BFormRadioGroup } from "bootstrap-vue-next";
+
+defineOptions({
+  inheritAttrs: false,
+});
+</script>
+
+<template>
+  <BFormRadioGroup v-bind="$attrs">
+    <!-- Dynamically pass through all named slots with their props -->
+    <template v-for="(_, name) in $slots" :key="name" #[name]="slotProps">
+      <slot :name="name" v-bind="slotProps" />
+    </template>
+  </BFormRadioGroup>
+</template>