@omnitend/dashboard-for-laravel 0.33.1 → 0.34.0

package/docs/public/api-reference.json

@@ -1,8 +1,8 @@
 {
-  "generated": "2026-07-20T14:11:55.309Z",
+  "generated": "2026-07-21T07:46:13.035Z",
   "package": {
     "name": "@omnitend/dashboard-for-laravel",
-    "version": "0.33.1"
+    "version": "0.34.0"
   },
   "components": {
     "base": [
@@ -351,6 +351,26 @@
         ],
         "methods": []
       },
+      {
+        "name": "DCarousel",
+        "category": "base",
+        "filePath": "resources/js/index.ts",
+        "description": "Bootstrap Vue Next Carousel (re-exported as DCarousel).",
+        "props": [],
+        "events": [],
+        "slots": [],
+        "methods": []
+      },
+      {
+        "name": "DCarouselSlide",
+        "category": "base",
+        "filePath": "resources/js/index.ts",
+        "description": "Bootstrap Vue Next CarouselSlide (re-exported as DCarouselSlide).",
+        "props": [],
+        "events": [],
+        "slots": [],
+        "methods": []
+      },
       {
         "name": "DCol",
         "category": "base",
@@ -1169,6 +1189,16 @@
         "slots": [],
         "methods": []
       },
+      {
+        "name": "DTab",
+        "category": "base",
+        "filePath": "resources/js/index.ts",
+        "description": "Bootstrap Vue Next Tab (re-exported as DTab).",
+        "props": [],
+        "events": [],
+        "slots": [],
+        "methods": []
+      },
       {
         "name": "DTable",
         "category": "base",
@@ -1329,7 +1359,7 @@
           },
           {
             "name": "options",
-            "type": "Record",
+            "type": "ChartOptions",
             "required": false,
             "description": "Chart.js options; deep-merged over the themed defaults."
           },
@@ -1385,6 +1415,65 @@
         ],
         "methods": []
       },
+      {
+        "name": "DXChoiceField",
+        "category": "extended",
+        "filePath": "resources/js/components/extended/DXChoiceField.vue",
+        "description": "The choice control family for DXField: `select` (plain or `searchable`), `radio`, and `checkbox-group`. Extracted from DXField (#135) unchanged. These share the \"no native readonly\" convention (read-only is expressed as `disabled`, hence the pre-merged `disabled` + `controlProps`). The parent DXField still owns the value/options/guards and the `setValue` coercion; this component only renders the control and emits the edited value up. Plain-text `autocomplete` (a text input + datalist) stays in DXField itself, with the text-family controls, because it uses the native-readonly guard path rather than this disabled-only convention.",
+        "props": [
+          {
+            "name": "field",
+            "type": "FieldDefinition",
+            "required": true,
+            "description": "Field definition (type select/radio/checkbox-group + `searchable`)."
+          },
+          {
+            "name": "modelValue",
+            "type": "any",
+            "required": true,
+            "description": "Current model value."
+          },
+          {
+            "name": "options",
+            "type": "Array",
+            "required": false,
+            "description": "Resolved options (async-loaded or static)."
+          },
+          {
+            "name": "state",
+            "type": "union",
+            "required": false,
+            "description": "Validation state passed to the control."
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": "Pre-merged disabled state (`isDisabled || isReadonly || isPlaintext`)."
+          },
+          {
+            "name": "controlProps",
+            "type": "Record",
+            "required": false,
+            "description": "Escape-hatch control props, already guard-merged by DXField."
+          },
+          {
+            "name": "optionsReady",
+            "type": "boolean",
+            "required": false,
+            "description": "Whether async options have resolved (a searchable select must not render\nbefore its options load, or it shows the raw id instead of the label)."
+          }
+        ],
+        "events": [
+          {
+            "name": "update:modelValue",
+            "description": "",
+            "properties": []
+          }
+        ],
+        "slots": [],
+        "methods": []
+      },
       {
         "name": "DXCurrencyInput",
         "category": "extended",
@@ -1912,7 +2001,7 @@
         "name": "DXField",
         "category": "extended",
         "filePath": "resources/js/components/extended/DXField.vue",
-        "description": "Renders a single `FieldDefinition` of any type (text, select, autocomplete, checkbox, switch, repeater, currency, percentage, file/image, component, etc.) with its label, validation error, hint and help. Used by `DXForm` and `DXTable`'s edit modal; exposes `value`, `span`, `info`, `info-popover`, `hint` and `repeater-row` slots for per-field customisation.",
+        "description": "Renders a single `FieldDefinition` of any type (text, select, autocomplete, checkbox, switch, repeater, currency, percentage, file/image, component, etc.) with its label, validation error, hint and help. Used by `DXForm` and `DXTable`'s edit modal; exposes `value`, `span`, `info`, `info-popover`, `hint` and `repeater-row` slots for per-field customisation. Structure (#135): a thin DISPATCHER. The shared chrome (label + validation feedback + hint + help + info) lives in `DXFieldShell`; the numeric controls (currency/percentage/number) in `DXNumericField`; the choice controls (select/searchable/radio/checkbox-group) in `DXChoiceField`; and the async option loading in the `useAsyncOptions` composable. This file decides which control to render inside the shell by `field.type`. None of those pieces are exported — they exist only to keep this component factored.",
         "props": [
           {
             "name": "field",
@@ -2005,7 +2094,7 @@
           },
           {
             "name": "hint",
-            "description": "Overrides the field's hint text shown below the control.",
+            "description": "Overrides the field's hint text shown below the control (or, in horizontal layout, in the label column).",
             "bindings": [
               {
                 "title": "binding",
@@ -2026,8 +2115,8 @@
             ]
           },
           {
-            "name": "value",
-            "description": "Replaces the built-in control with a custom value editor.",
+            "name": "info",
+            "description": "Rich info block rendered below the control.",
             "bindings": [
               {
                 "title": "binding",
@@ -2044,28 +2133,12 @@
                 },
                 "name": "model",
                 "description": "The model passed to field predicates (defaults to the live form data)."
-              },
-              {
-                "title": "binding",
-                "type": {
-                  "name": "any"
-                },
-                "name": "value",
-                "description": "The current field value."
-              },
-              {
-                "title": "binding",
-                "type": {
-                  "name": "(value: any) => void"
-                },
-                "name": "update",
-                "description": "Setter that writes the value back and clears the field's validation error."
               }
             ]
           },
           {
-            "name": "info",
-            "description": "Rich info block rendered below the control.",
+            "name": "value",
+            "description": "Replaces the built-in control with a custom value editor.",
             "bindings": [
               {
                 "title": "binding",
@@ -2082,6 +2155,22 @@
                 },
                 "name": "model",
                 "description": "The model passed to field predicates (defaults to the live form data)."
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "any"
+                },
+                "name": "value",
+                "description": "The current field value."
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "(value: any) => void"
+                },
+                "name": "update",
+                "description": "Setter that writes the value back and clears the field's validation error."
               }
             ]
           },
@@ -2144,6 +2233,123 @@
         ],
         "methods": []
       },
+      {
+        "name": "DXFieldShell",
+        "category": "extended",
+        "filePath": "resources/js/components/extended/DXFieldShell.vue",
+        "description": "The chrome every DXField branch shares: the optional label (with its info affordance and, in horizontal layout, its hint), the control (default slot), and the trailing validation feedback + info block + hint + static help. Before #135 this markup was re-rendered separately in each of DXField's ~7 branches; it now lives here once. Two shapes: - `mode=\"group\"` — root is a `DFormGroup` that owns the `#label` column and holds the control + trailing block inside it (standard / horizontal checkbox / horizontal switch). - `mode=\"plain\"` — root is a plain `div`; the control renders its own inline label (vertical checkbox/switch), or a heading/rows (switch-list), or a nested group (repeater). The trailing block follows the control in the div. The `hint` and `info` slots are forwarded down from DXField (content AND slot props). `hint` falls back to `{{ resolvedHint }}` when no slot is supplied.",
+        "props": [
+          {
+            "name": "field",
+            "type": "FieldDefinition",
+            "required": true,
+            "description": "The field definition (for `field.help` and slot props)."
+          },
+          {
+            "name": "form",
+            "type": "UseFormReturn",
+            "required": true,
+            "description": "Form instance owning the field's errors."
+          },
+          {
+            "name": "errorKey",
+            "type": "string",
+            "required": true,
+            "description": "Error key for validation lookups."
+          },
+          {
+            "name": "model",
+            "type": "any",
+            "required": false,
+            "description": "Model passed to `hint`/`info` slot props."
+          },
+          {
+            "name": "mode",
+            "type": "union",
+            "required": true,
+            "description": "Layout shape. `group` = DFormGroup root with a label column; `plain` =\nplain div, the control owning its own inline label/heading."
+          },
+          {
+            "name": "wrapperClass",
+            "type": "string",
+            "required": false,
+            "description": "Wrapper class (`field.class || 'mb-3'`)."
+          },
+          {
+            "name": "groupAttrs",
+            "type": "Record",
+            "required": false,
+            "description": "BFormGroup attrs (horizontal label-cols etc.); group mode only."
+          },
+          {
+            "name": "label",
+            "type": "string",
+            "required": true,
+            "description": "Resolved label text (group mode). Always supplied by DXField."
+          },
+          {
+            "name": "info",
+            "type": "string",
+            "required": false,
+            "description": "Resolved info text for the label popover (group mode)."
+          },
+          {
+            "name": "hideLabel",
+            "type": "boolean",
+            "required": false,
+            "description": "Skip the label column entirely (group mode)."
+          },
+          {
+            "name": "hintInLabel",
+            "type": "boolean",
+            "required": false,
+            "description": "Whether the hint sits in the label column (horizontal) rather than below\nthe control. Group mode only; plain mode always renders the hint below."
+          },
+          {
+            "name": "resolvedHint",
+            "type": "string",
+            "required": false,
+            "description": "Resolved hint text (fallback when no `hint` slot is supplied)."
+          }
+        ],
+        "events": [],
+        "slots": [
+          {
+            "name": "hint",
+            "description": "",
+            "bindings": [
+              {
+                "name": "field",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              }
+            ]
+          },
+          {
+            "name": "default",
+            "description": "",
+            "bindings": []
+          },
+          {
+            "name": "info",
+            "description": "",
+            "bindings": [
+              {
+                "name": "field",
+                "title": "binding"
+              },
+              {
+                "name": "model",
+                "title": "binding"
+              }
+            ]
+          }
+        ],
+        "methods": []
+      },
       {
         "name": "DXForm",
         "category": "extended",
@@ -2469,7 +2675,7 @@
           },
           {
             "name": "options",
-            "type": "Record",
+            "type": "ChartOptions",
             "required": false,
             "description": "Chart.js options; deep-merged over the themed defaults."
           },
@@ -2504,6 +2710,65 @@
         "slots": [],
         "methods": []
       },
+      {
+        "name": "DXNumericField",
+        "category": "extended",
+        "filePath": "resources/js/components/extended/DXNumericField.vue",
+        "description": "The numeric control family for DXField: `currency`, `percentage`, `number`. Extracted from DXField (#135) unchanged. The parent DXField still owns the value/guards/`setValue` coercion — this component only renders the control and emits the raw edited value back up. The `percentage` `asFraction` display scaling (model holds a 0–1 fraction, input shows 0–100) lives here because it is purely presentational to this control.",
+        "props": [
+          {
+            "name": "field",
+            "type": "FieldDefinition",
+            "required": true,
+            "description": "Field definition (type currency/percentage/number + numeric options)."
+          },
+          {
+            "name": "modelValue",
+            "type": "any",
+            "required": true,
+            "description": "Current model value."
+          },
+          {
+            "name": "state",
+            "type": "union",
+            "required": false,
+            "description": "Validation state passed to the control."
+          },
+          {
+            "name": "isDisabled",
+            "type": "boolean",
+            "required": false,
+            "description": "Disabled state (`isDisabled`)."
+          },
+          {
+            "name": "isReadonly",
+            "type": "boolean",
+            "required": false,
+            "description": "Readonly state (`isReadonly`)."
+          },
+          {
+            "name": "isPlaintext",
+            "type": "boolean",
+            "required": false,
+            "description": "Plaintext (display-only) state (`isPlaintext`)."
+          },
+          {
+            "name": "inputProps",
+            "type": "Record",
+            "required": false,
+            "description": "Escape-hatch input props, already guard-merged by DXField."
+          }
+        ],
+        "events": [
+          {
+            "name": "update:modelValue",
+            "description": "",
+            "properties": []
+          }
+        ],
+        "slots": [],
+        "methods": []
+      },
       {
         "name": "DXRepeater",
         "category": "extended",
@@ -2540,6 +2805,83 @@
           {
             "name": "row",
             "description": "Custom layout for a single repeater row, replacing the default sub-field stack (including the built-in Remove control — call `remove()` yourself). In table layout, rendered as the `<tr>`'s children: supply one `<td>` per sub-field plus a trailing `<td>` to match the header's column count (the header always includes an empty column for the built-in remove button).",
+            "bindings": []
+          }
+        ],
+        "methods": []
+      },
+      {
+        "name": "DXRepeaterCards",
+        "category": "extended",
+        "filePath": "resources/js/components/extended/DXRepeaterCards.vue",
+        "description": "DXRepeaterCards — the cards layout for DXRepeater: each row is its own bordered card with sub-fields stacked vertically, plus the add-row button. Internal to DXRepeater (not exported). It exists because DXRepeater rendered this exact markup TWICE — as the default `repeaterLayout: \"cards\"` branch and as the responsive fallback when the `\"table\"` layout lacks room — and the two copies would drift (#135). DXRepeater owns all the row state and passes it in; this component is presentational. The `.dx-repeater-row*` scoped styles live here (a scoped rule can't reach markup in another component), so the cards chrome moves as one unit with the markup it styles.",
+        "props": [
+          {
+            "name": "visibleRows",
+            "type": "Array",
+            "required": true,
+            "description": "Rows shown in the UI, each paired with its real (unfiltered) array index."
+          },
+          {
+            "name": "subFields",
+            "type": "Array",
+            "required": true,
+            "description": "Sub-field definitions for a row."
+          },
+          {
+            "name": "form",
+            "type": "UseFormReturn",
+            "required": true,
+            "description": "Form instance owning the repeater array."
+          },
+          {
+            "name": "field",
+            "type": "FieldDefinition",
+            "required": true,
+            "description": "The repeater field definition (for `showRowIndex` and `addLabel`)."
+          },
+          {
+            "name": "minItems",
+            "type": "number",
+            "required": true,
+            "description": "Minimum rows — the Remove button disables at this count."
+          },
+          {
+            "name": "maxItems",
+            "type": "union",
+            "required": true,
+            "description": "Maximum rows — the Add button disables at this count."
+          },
+          {
+            "name": "rowKey",
+            "type": "TSFunctionType",
+            "required": true,
+            "description": "Stable v-for key for a row (owned by DXRepeater — row identity, not index)."
+          },
+          {
+            "name": "rowPath",
+            "type": "TSFunctionType",
+            "required": true,
+            "description": "Dot path into form.data for a row at the given true index."
+          },
+          {
+            "name": "removeRow",
+            "type": "TSFunctionType",
+            "required": true,
+            "description": "Remove the row at the given true index (respects minItems / soft-delete)."
+          },
+          {
+            "name": "addRow",
+            "type": "TSFunctionType",
+            "required": true,
+            "description": "Append a fresh row (respects maxItems)."
+          }
+        ],
+        "events": [],
+        "slots": [
+          {
+            "name": "row",
+            "description": "Custom layout for a single repeater row, replacing the default sub-field stack (including the built-in Remove control — call `remove()` yourself).",
             "bindings": [
               {
                 "title": "binding",
@@ -2813,6 +3155,12 @@
             "required": false,
             "description": "Adapts the built-in provider's request params / response body to a\n backend convention that differs from dfl's (see DXTableApiAdapter)."
           },
+          {
+            "name": "source",
+            "type": "DXTableSource",
+            "required": false,
+            "description": "Discriminated data-source (#130) — the type-safe alternative to the\nlegacy `items` / `provider` / `apiUrl` / `inertiaUrl` / `clientSide`\nprops. When set it WINS over those props; when omitted, the legacy props\napply unchanged. See `DXTableSource`."
+          },
           {
             "name": "fields",
             "type": "Array",
@@ -2972,7 +3320,7 @@
             "name": "editFields",
             "type": "Array",
             "required": false,
-            "description": "Form field definitions for edit modal (if provided, enables edit on row click)"
+            "description": "Form field definitions for edit modal (if provided, enables edit on row\nclick). `import type` is erased at compile time, so this creates no\nruntime import cycle (#131)."
           },
           {
             "name": "editTabs",
@@ -2993,6 +3341,44 @@
             "default": "\"lg\"",
             "description": "Edit modal size"
           },
+          {
+            "name": "editLayout",
+            "type": "union",
+            "required": false,
+            "default": "\"horizontal\"",
+            "description": "Field layout for the edit/create modal's form, forwarded to its `DXForm`\n(\"vertical\" = label above input, \"horizontal\" = label left). Defaults to\n**\"horizontal\"** to match the Omni Tend form convention (a raw modal form\npreviously fell back to DXForm's vertical default, which looked out of\nplace next to horizontal page forms). Pass `\"vertical\"` to opt out."
+          },
+          {
+            "name": "editLabelCols",
+            "type": "LabelCols",
+            "required": false,
+            "description": "Label column width for the edit modal's horizontal layout, forwarded to\n`DXForm`'s `labelCols` (a single width or a per-breakpoint object). Only\nmeaningful when `editLayout` is \"horizontal\"."
+          },
+          {
+            "name": "editCard",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Wrap the edit/create modal's form in a bordered card. Off by default (the\nmodal body already provides a boundary); opt in for a more contained,\npanelled look around a tabbed edit form."
+          },
+          {
+            "name": "saveText",
+            "type": "string",
+            "required": false,
+            "description": "Override the modal's Save button label (default: \"Save {item}\")."
+          },
+          {
+            "name": "createText",
+            "type": "string",
+            "required": false,
+            "description": "Override the modal's Create button label (default: \"Create {item}\")."
+          },
+          {
+            "name": "deleteText",
+            "type": "string",
+            "required": false,
+            "description": "Override the modal's Delete button label (default: \"Delete {item}\")."
+          },
           {
             "name": "editUrl",
             "type": "string",
@@ -3288,6 +3674,48 @@
             "type": "string",
             "required": false,
             "description": "Delete endpoint — gates the Delete button."
+          },
+          {
+            "name": "layout",
+            "type": "union",
+            "required": false,
+            "description": "Field layout forwarded to the modal's DXForm (defaults handled upstream)."
+          },
+          {
+            "name": "labelCols",
+            "type": "LabelCols",
+            "required": false,
+            "description": "Label column width forwarded to DXForm (horizontal layout)."
+          },
+          {
+            "name": "card",
+            "type": "boolean",
+            "required": false,
+            "description": "Wrap the modal form in a card (opt-in — off by default)."
+          },
+          {
+            "name": "itemName",
+            "type": "string",
+            "required": false,
+            "description": "Singular item noun for the default button labels (e.g. \"customer\")."
+          },
+          {
+            "name": "saveText",
+            "type": "string",
+            "required": false,
+            "description": "Override the Save button label (edit mode)."
+          },
+          {
+            "name": "createText",
+            "type": "string",
+            "required": false,
+            "description": "Override the Create button label (create mode)."
+          },
+          {
+            "name": "deleteText",
+            "type": "string",
+            "required": false,
+            "description": "Override the Delete button label."
           }
         ],
         "events": [
@@ -3643,8 +4071,8 @@
     ]
   },
   "stats": {
-    "totalComponents": 77,
-    "baseComponents": 57,
-    "extendedComponents": 20
+    "totalComponents": 84,
+    "baseComponents": 60,
+    "extendedComponents": 24
   }
 }

package/docs/public/docs-map.md

@@ -1,7 +1,7 @@
 # Documentation Map
 
 > Auto-generated hierarchical overview of all documentation
-> Last updated: 2026-07-20T14:11:55.365Z
+> Last updated: 2026-07-21T07:46:13.078Z
 
 This file provides a complete map of all available documentation for AI agents and developers.
 

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 70 Vue 3 components for building Laravel dashboards with Bootstrap Vue Next.
+> A dual-package library (NPM + Composer) providing 73 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 (57 components)
+## Base Components (60 components)
 
 Lightweight type-safe wrappers around Bootstrap Vue Next components providing API stability and consistent theming.
 
@@ -35,6 +35,8 @@ Lightweight type-safe wrappers around Bootstrap Vue Next components providing AP
 - [DButtonGroup](/components/base/dbuttongroup): Bootstrap Vue Next ButtonGroup wrapper
 - [DButtonToolbar](/components/base/dbuttontoolbar): Bootstrap Vue Next ButtonToolbar wrapper
 - [DCard](/components/base/dcard): Bootstrap Vue Next Card wrapper
+- [DCarousel](/components/base/dcarousel): Bootstrap Vue Next Carousel wrapper
+- [DCarouselSlide](/components/base/dcarouselslide): Bootstrap Vue Next CarouselSlide wrapper
 - [DCol](/components/base/dcol): Bootstrap Vue Next Col wrapper
 - [DCollapse](/components/base/dcollapse): Bootstrap Vue Next Collapse wrapper
 - [DContainer](/components/base/dcontainer): Bootstrap Vue Next Container wrapper
@@ -75,6 +77,7 @@ Lightweight type-safe wrappers around Bootstrap Vue Next components providing AP
 - [DProgress](/components/base/dprogress): Bootstrap Vue Next Progress wrapper
 - [DRow](/components/base/drow): Bootstrap Vue Next Row wrapper
 - [DSpinner](/components/base/dspinner): Bootstrap Vue Next Spinner wrapper
+- [DTab](/components/base/dtab): Bootstrap Vue Next Tab wrapper
 - [DTable](/components/base/dtable): Bootstrap Vue Next Table wrapper
 - [DTabs](/components/base/dtabs): Bootstrap Vue Next Tabs wrapper
 - [DToast](/components/base/dtoast): Bootstrap Vue Next Toast wrapper

package/package.json

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