@omnitend/dashboard-for-laravel 0.28.0 → 0.29.0

package/docs/public/api-reference.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-07-18T13:55:43.374Z",
+  "generated": "2026-07-19T09:16:53.630Z",
   "package": {
     "name": "@omnitend/dashboard-for-laravel",
     "version": "0.28.0"
@@ -53,7 +53,15 @@
         "category": "base",
         "filePath": "resources/js/components/base/DAlert.vue",
         "description": "",
-        "props": [],
+        "props": [
+          {
+            "name": "modelValue",
+            "type": "union",
+            "required": false,
+            "default": "true",
+            "description": ""
+          }
+        ],
         "events": [],
         "slots": [
           {
@@ -481,6 +489,27 @@
         ],
         "methods": []
       },
+      {
+        "name": "DFormCheckboxGroup",
+        "category": "base",
+        "filePath": "resources/js/components/base/DFormCheckboxGroup.vue",
+        "description": "Type-safe wrapper around Bootstrap Vue Next BFormCheckboxGroup component. Renders a group of checkboxes from an `options` array (or slot content); the `v-model` is the ARRAY of checked option values (\"pick any of N\").",
+        "props": [],
+        "events": [],
+        "slots": [
+          {
+            "name": "name",
+            "description": "",
+            "bindings": [
+              {
+                "name": "name",
+                "title": "binding"
+              }
+            ]
+          }
+        ],
+        "methods": []
+      },
       {
         "name": "DFormGroup",
         "category": "base",
@@ -3481,8 +3510,8 @@
     ]
   },
   "stats": {
-    "totalComponents": 75,
-    "baseComponents": 56,
+    "totalComponents": 76,
+    "baseComponents": 57,
     "extendedComponents": 19
   }
 }

package/docs/public/docs-map.md

@@ -1,7 +1,7 @@
 # Documentation Map
 
 > Auto-generated hierarchical overview of all documentation
-> Last updated: 2026-07-18T13:55:43.432Z
+> Last updated: 2026-07-19T09:16:53.689Z
 
 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 68 Vue 3 components for building Laravel dashboards with Bootstrap Vue Next.
+> A dual-package library (NPM + Composer) providing 69 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 (56 components)
+## Base Components (57 components)
 
 Lightweight type-safe wrappers around Bootstrap Vue Next components providing API stability and consistent theming.
 
@@ -43,6 +43,7 @@ Lightweight type-safe wrappers around Bootstrap Vue Next components providing AP
 - [DDropdownItem](/components/base/ddropdownitem): Bootstrap Vue Next DropdownItem wrapper
 - [DForm](/components/base/dform): Bootstrap Vue Next Form wrapper
 - [DFormCheckbox](/components/base/dformcheckbox): Bootstrap Vue Next FormCheckbox wrapper
+- [DFormCheckboxGroup](/components/base/dformcheckboxgroup): Bootstrap Vue Next FormCheckboxGroup wrapper
 - [DFormGroup](/components/base/dformgroup): Bootstrap Vue Next FormGroup wrapper
 - [DFormInput](/components/base/dforminput): Bootstrap Vue Next FormInput wrapper
 - [DFormInvalidFeedback](/components/base/dforminvalidfeedback): Bootstrap Vue Next FormInvalidFeedback wrapper

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnitend/dashboard-for-laravel",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Vue 3 dashboard components for Laravel with Bootstrap Vue Next",
   "type": "module",
   "main": "./dist/dashboard-for-laravel.umd.cjs",
@@ -15,6 +15,11 @@
       "import": "./dist/dashboard-for-laravel.js",
       "require": "./dist/dashboard-for-laravel.umd.cjs"
     },
+    "./charts": {
+      "types": "./dist/charts.d.ts",
+      "import": "./dist/charts.js",
+      "require": "./dist/charts.umd.cjs"
+    },
     "./style.css": "./dist/style.css",
     "./theme.css": "./dist/style.css",
     "./theme.scss": "./resources/css/theme.scss"
@@ -29,13 +34,14 @@
   ],
   "scripts": {
     "dev": "vite build --watch",
-    "build": "vite build && node scripts/extract-icon-font.mjs && vue-tsc --declaration --emitDeclarationOnly --outDir dist",
+    "build:lib": "vite build && vite build --config vite.config.charts.ts && node scripts/extract-icon-font.mjs",
+    "build": "npm run build:lib && vue-tsc --declaration --emitDeclarationOnly --outDir dist",
     "typecheck": "vue-tsc --noEmit",
-    "pretest": "vite build",
+    "pretest": "npm run build:lib",
     "test": "vitest",
-    "pretest:ui": "vite build",
+    "pretest:ui": "npm run build:lib",
     "test:ui": "vitest --ui",
-    "pretest:headless": "vite build",
+    "pretest:headless": "npm run build:lib",
     "test:headless": "vitest --run --browser.headless",
     "docs:dev": "astro dev",
     "docs:build": "npm run docs:generate:ai && astro build && node scripts/check-docs-base-links.mjs",

package/resources/css/theme.scss

@@ -436,14 +436,17 @@ $bootstrap-icons-font-src: url("bootstrap-icons/font/fonts/bootstrap-icons.woff2
 
   // Semantic variants: subtle tinted surface, driven through the CSS variable
   // the base `.toast` rule (above, and Bootstrap's own) already reads.
-  @each $name, $color in (
-    "success": $success,
-    "danger": $danger,
-    "warning": $warning,
-    "info": $info
-  ) {
+  //
+  // Sourced from each variant's `soft-bg` in $dx-variants (#143) — the same
+  // vivid-derived soft family badges/alerts use — so the toast hue tracks the
+  // palette and editing a `soft-bg` moves toasts too. Previously these mixed the
+  // dark *emphasis* base colours (greyer success/warning) and danger's saturated
+  // red (a pink, not the soft system's plum). Mixed 50% with white so a large
+  // toast surface stays fainter than a small badge while keeping the hue.
+  @each $name in ("success", "danger", "warning", "info") {
+    $variant: map.get($dx-variants, $name);
     &.toast-#{$name} {
-      --bs-toast-bg: #{color.mix($color, $white, 8%)};
+      --bs-toast-bg: #{color.mix(map.get($variant, "soft-bg"), $white, 50%)};
     }
   }
 }
@@ -581,6 +584,17 @@ $dx-chart-palette: (#2563eb, #65a30d, #7c3aed, #0d9488, #ea580c, #0891b2, #d9770
   }
 }
 
+// The chart container used by DXBarChart/DXLineChart/DXDoughnutChart (shipped
+// from the `@omnitend/dashboard-for-laravel/charts` entry, #142). Global rather
+// than a component scoped style so the charts entry emits NO CSS — chart
+// consumers already import this stylesheet for the theme + palette variables.
+.dx-chart {
+  position: relative;
+  width: 100%;
+  height: 100%;
+  min-height: 240px;
+}
+
 // ----------------------------------------------------------------------------
 // Autocomplete
 // ----------------------------------------------------------------------------

package/resources/js/charts.ts

@@ -0,0 +1,19 @@
+/**
+ * Chart entry point — `@omnitend/dashboard-for-laravel/charts` (#142).
+ *
+ * The chart components are the ONLY ones that need `chart.js` / `vue-chartjs`,
+ * so they live behind this separate subpath entry. The main entry
+ * (`@omnitend/dashboard-for-laravel`) never references the chart libraries, so
+ * they are genuinely OPTIONAL peers: a consumer that renders no charts installs
+ * neither and their build no longer fails resolving them.
+ *
+ *   import { DXBarChart } from '@omnitend/dashboard-for-laravel/charts';
+ *
+ * Chart containers are styled by `.dx-chart` in the main stylesheet
+ * (`@omnitend/dashboard-for-laravel/style.css`), which chart consumers already
+ * import for the theme and the `--dx-chart-*` palette variables — so this entry
+ * ships no CSS of its own.
+ */
+export { default as DXBarChart } from "./components/charts/DXBarChart.vue";
+export { default as DXLineChart } from "./components/charts/DXLineChart.vue";
+export { default as DXDoughnutChart } from "./components/charts/DXDoughnutChart.vue";

package/resources/js/components/base/DAlert.vue

@@ -2,11 +2,29 @@
 import { BAlert } from "bootstrap-vue-next";
 import { useSlots } from "vue";
 
+/*
+ * bootstrap-vue-next's BAlert defaults `modelValue` to `false`, so a bare static
+ * `<DAlert variant="info">…</DAlert>` silently renders NOTHING — a footgun that
+ * bit our own docs repeatedly (#144). Default it to `true` (visible) at the
+ * wrapper; every call site that already passes `v-model`/`:model-value` is
+ * unaffected — only the bare-static case (which was always a bug) changes.
+ *
+ * Care (see DIVERGENCES.md): declaring `modelValue` as a prop strips it from
+ * `$attrs`, so it is re-bound explicitly below. `emits` is left UNDECLARED so an
+ * `update:modelValue` listener keeps flowing through `$attrs` to BAlert — that's
+ * what lets `v-model` dismissal (and the auto-dismiss countdown) still
+ * round-trip. The type stays `boolean | number` (a number is the auto-dismiss
+ * duration in ms) — don't narrow it.
+ */
+const props = withDefaults(defineProps<{ modelValue?: boolean | number }>(), {
+  modelValue: true,
+});
+
 const slots = useSlots();
 </script>
 
 <template>
-  <BAlert v-bind="$attrs">
+  <BAlert :model-value="props.modelValue" v-bind="$attrs">
     <template v-for="(_, name) in slots" :key="name" #[name]>
       <slot :name="name" />
     </template>

package/resources/js/components/base/DFormCheckboxGroup.vue

@@ -0,0 +1,22 @@
+/**
+ * @component
+ * Type-safe wrapper around Bootstrap Vue Next BFormCheckboxGroup component.
+ * Renders a group of checkboxes from an `options` array (or slot content); the
+ * `v-model` is the ARRAY of checked option values ("pick any of N").
+ */
+<script setup lang="ts">
+import { BFormCheckboxGroup } from "bootstrap-vue-next";
+
+defineOptions({
+  inheritAttrs: false,
+});
+</script>
+
+<template>
+  <BFormCheckboxGroup 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>
+  </BFormCheckboxGroup>
+</template>

package/resources/js/components/charts/DXBarChart.vue

@@ -68,12 +68,3 @@ const mergedOptions = computed(() =>
   ),
 );
 </script>
-
-<style scoped>
-.dx-chart {
-  position: relative;
-  width: 100%;
-  height: 100%;
-  min-height: 240px;
-}
-</style>

package/resources/js/components/charts/DXDoughnutChart.vue

@@ -74,12 +74,3 @@ const mergedOptions = computed(() =>
   ),
 );
 </script>
-
-<style scoped>
-.dx-chart {
-  position: relative;
-  width: 100%;
-  height: 100%;
-  min-height: 240px;
-}
-</style>

package/resources/js/components/charts/DXLineChart.vue

@@ -68,12 +68,3 @@ const mergedOptions = computed(() =>
   ),
 );
 </script>
-
-<style scoped>
-.dx-chart {
-  position: relative;
-  width: 100%;
-  height: 100%;
-  min-height: 240px;
-}
-</style>

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

@@ -370,6 +370,17 @@
             v-bind="controlPropsWithGuards"
         />
 
+        <!-- Checkbox group: "pick any of N" — the model is an ARRAY of the
+             checked option values (default the field to []). -->
+        <DFormCheckboxGroup
+            v-else-if="field.type === 'checkbox-group'"
+            v-model="fieldValue"
+            :options="resolvedOptions"
+            :state="fieldState"
+            :disabled="isDisabled || isReadonly || isPlaintext"
+            v-bind="controlPropsWithGuards"
+        />
+
         <!-- File / image upload -->
         <div v-else-if="field.type === 'image' || field.type === 'file'">
             <DFormInput
@@ -554,6 +565,7 @@ import DFormInput from "../base/DFormInput.vue";
 import DFormTextarea from "../base/DFormTextarea.vue";
 import DFormSelect from "../base/DFormSelect.vue";
 import DFormRadioGroup from "../base/DFormRadioGroup.vue";
+import DFormCheckboxGroup from "../base/DFormCheckboxGroup.vue";
 import DFormCheckbox from "../base/DFormCheckbox.vue";
 import DXSwitch from "./DXSwitch.vue";
 import DFormInvalidFeedback from "../base/DFormInvalidFeedback.vue";

package/resources/js/composables/useForm.ts

@@ -255,7 +255,16 @@ export function useForm<TData extends Record<string, any>>(
 
         const payloadRaw = (
             options.transform
-                ? options.transform(state.data as TData)
+                ? // Give `transform` a COPY of the form data (#150), so a transform
+                  // that MUTATES what it receives — `data.allergens = assemble();
+                  // return data` — shapes the outbound payload WITHOUT corrupting
+                  // form state. (This is why consumers reach for a transform instead
+                  // of mutating `form.data` in a validation guard.) A shallow copy:
+                  // returning a new object is still the tidiest style, and a
+                  // deeply-nested field should be replaced, not mutated in place.
+                  options.transform({
+                      ...(toRaw(state.data) as Record<string, any>),
+                  } as TData)
                 : (state.data as TData)
         ) as any;
 

package/resources/js/index.ts

@@ -11,9 +11,9 @@ export { default as DXField } from "./components/extended/DXField.vue";
 export { default as DXFieldLabel } from "./components/extended/DXFieldLabel.vue";
 export { default as DXSwitch } from "./components/extended/DXSwitch.vue";
 export { default as DXStatCard } from "./components/extended/DXStatCard.vue";
-export { default as DXBarChart } from "./components/charts/DXBarChart.vue";
-export { default as DXLineChart } from "./components/charts/DXLineChart.vue";
-export { default as DXDoughnutChart } from "./components/charts/DXDoughnutChart.vue";
+// Chart components moved to the `@omnitend/dashboard-for-laravel/charts` entry
+// (#142) so chart.js / vue-chartjs stay genuinely optional peers — the main
+// entry no longer references them. See resources/js/charts.ts.
 export { default as DXRepeater } from "./components/extended/DXRepeater.vue";
 /**
  * @deprecated Use `DXForm`. `DXBasicForm` is a thin wrapper around `DXForm`
@@ -53,6 +53,7 @@ export { default as DDropdownDivider } from "./components/base/DDropdownDivider.
 export { default as DDropdownItem } from "./components/base/DDropdownItem.vue";
 export { default as DForm } from "./components/base/DForm.vue";
 export { default as DFormCheckbox } from "./components/base/DFormCheckbox.vue";
+export { default as DFormCheckboxGroup } from "./components/base/DFormCheckboxGroup.vue";
 export { default as DFormGroup } from "./components/base/DFormGroup.vue";
 export { default as DFormInput } from "./components/base/DFormInput.vue";
 export { default as DFormInvalidFeedback } from "./components/base/DFormInvalidFeedback.vue";

package/resources/js/types/index.ts

@@ -31,6 +31,7 @@ export type FieldType =
     | "select"
     | "autocomplete"
     | "checkbox"
+    | "checkbox-group"
     | "switch"
     | "radio"
     | "image"