@omnitend/dashboard-for-laravel 0.44.0 → 0.46.0

package/dist/types/navigation.d.ts

@@ -7,7 +7,13 @@ export interface NavigationItem {
     active?: boolean;
     visible?: boolean;
 }
-export interface NavigationGroup {
+/**
+ * A group of sidebar links. `TItem` is the app's own item type, for menus whose
+ * items carry extra keys (a permission, a route name): DXDashboard and
+ * DXDashboardSidebar infer it from the `navigation` prop, so the `link` slot's
+ * `item` has those keys too. Defaults to `NavigationItem`.
+ */
+export interface NavigationGroup<TItem extends NavigationItem = NavigationItem> {
     label?: string;
     /**
      * Stable identifier for the group's collapsible open/closed state. Defaults
@@ -16,7 +22,7 @@ export interface NavigationGroup {
      * state attached to the right group.
      */
     key?: string;
-    items: NavigationItem[];
+    items: TItem[];
     /**
      * Per-group override for the sidebar's `collapsibleGroups` behaviour.
      * Set to `false` to keep a group permanently expanded (no toggle header)
@@ -27,7 +33,23 @@ export interface NavigationGroup {
     collapsed?: boolean;
     visible?: boolean;
 }
-export type Navigation = NavigationGroup[];
+/** The sidebar's navigation: its groups, in order. See `NavigationGroup` for `TItem`. */
+export type Navigation<TItem extends NavigationItem = NavigationItem> = NavigationGroup<TItem>[];
+/**
+ * The item type of a navigation, as the `link` slot's `item` receives it:
+ * `NavigationItemOf<Navigation<AppItem>>` is `AppItem`. An `any` navigation
+ * (untyped page props) gives `any`, and an empty `[]` gives `NavigationItem`.
+ *
+ * DXDashboard and DXDashboardSidebar are generic over the whole navigation
+ * (`TNavigation`) and derive the item from it, rather than generic over the
+ * item: TypeScript infers `any` for a type parameter that IS the prop's type,
+ * but not for one nested inside it (`{ items: TItem[] }[]`), where an `any`
+ * navigation would have fallen back to `NavigationItem` and rejected the app's
+ * extra keys.
+ */
+export type NavigationItemOf<TNavigation extends Navigation> = [
+    TNavigation[number]["items"][number]
+] extends [never] ? NavigationItem : TNavigation[number]["items"][number];
 /**
  * Horizontal alignment of the navbar search slot content within its region:
  * `"start"` = flush left (after the title from `md` up), `"center"` = centred.
@@ -49,3 +71,131 @@ export type SidebarVariant = "light" | "dark";
  * Shared by DXDashboard (which forwards it) and DXDashboardNavbar.
  */
 export type NavbarActionsOnMobile = "wrap" | "hide";
+/**
+ * The signed-in user DXDashboardNavbar (and DXDashboard, which forwards it)
+ * shows in the avatar dropdown. Extra keys are allowed and reach the
+ * user-menu slots.
+ */
+export interface DashboardUser {
+    name: string;
+    email: string;
+    [key: string]: any;
+}
+/** A slot that receives no props. */
+type NoSlotProps = Record<never, never>;
+/** Slots of DXDashboardNavbar, with their slot props. All are optional. */
+export interface DashboardNavbarSlots {
+    /** Custom hamburger/menu icon. Defaults to a three-line SVG. */
+    "menu-icon"?(props: NoSlotProps): any;
+    /**
+     * Search input or component. Fills the middle of the bar at every width,
+     * aligned per `searchAlign`. The region is a size container named
+     * `dx-navbar-search`; a `<kbd>` hint inside it is hidden when it is
+     * narrower than 16rem.
+     */
+    "search"?(props: NoSlotProps): any;
+    /**
+     * Page-level primary actions (e.g. a Create button). Right-aligned next to
+     * the user menu from `md` up; below, wraps to its own full-width row or is
+     * hidden entirely per `actionsOnMobile`.
+     */
+    "actions"?(props: {
+        /** The current page title, for context. */
+        pageTitle: string;
+    }): any;
+    /** Replaces the entire user menu (the default avatar dropdown). */
+    "user-menu"?(props: {
+        /** The signed-in user; `null` for a guest. */
+        user: DashboardUser | null;
+    }): any;
+    /**
+     * Custom user avatar/icon in the dropdown trigger. To decorate the default
+     * avatar (e.g. add a notification dot) rather than replace it, render
+     * `DXUserAvatar`. Only rendered for a signed-in user.
+     */
+    "user-icon"?(props: {
+        /** The first letter of the user's name. */
+        initial: string;
+        /** The signed-in user. */
+        user: DashboardUser;
+    }): any;
+    /** Items for the default user dropdown menu. Only rendered for a signed-in user. */
+    "user-menu-items"?(props: {
+        /** The signed-in user. */
+        user: DashboardUser;
+    }): any;
+}
+/**
+ * Slots of DXDashboardSidebar, with their slot props. All are optional.
+ * `TItem` is the navigation's item type (see `NavigationGroup`).
+ */
+export interface DashboardSidebarSlots<TItem extends NavigationItem = NavigationItem> {
+    /**
+     * Brand/logo area in the sidebar header. Defaults to the title's initial
+     * plus the full title (hidden when collapsed).
+     */
+    "brand"?(props: {
+        /** Whether the sidebar rail is collapsed to icons only. */
+        collapsed: boolean;
+        /** The sidebar title text. */
+        title: string;
+    }): any;
+    /**
+     * Renders a single navigation item link. Defaults to an anchor with
+     * optional icon, label, and badge.
+     */
+    "link"?(props: {
+        /**
+         * The navigation item (label, url, icon, badge, badgeColor), typed as the
+         * app's own item type when its items carry extra keys.
+         */
+        item: TItem;
+        /** Whether this item matches the current route. */
+        isActive: boolean;
+        /** Whether the sidebar rail is collapsed to icons only. */
+        collapsed: boolean;
+        /** Whether the item's group is currently expanded. */
+        isExpanded: boolean;
+    }): any;
+    /**
+     * Utility/secondary links pinned to the bottom of the sidebar (help,
+     * changelog, sign-out, …), below the nav groups.
+     */
+    "footer"?(props: {
+        /** Whether the sidebar rail is collapsed to icons only. */
+        collapsed: boolean;
+    }): any;
+}
+/**
+ * The two bindings DXDashboard adds to every forwarded `sidebar-*` and
+ * `navbar-*` slot. They are bound after the child's own slot props, so they
+ * win a name clash.
+ */
+export interface DashboardSlotExtras {
+    /** Shows/hides the sidebar. */
+    toggleSidebar: () => void;
+    /** Whether the sidebar is currently hidden. */
+    sidebarHidden: boolean;
+}
+/** The props a (possibly optional) slot function receives. */
+type SlotPropsOf<Slot> = NonNullable<Slot> extends (props: infer Props) => any ? Props : never;
+/**
+ * A child component's slots renamed with `Prefix` and given the dashboard's
+ * extra bindings: `{ brand(props: P) }` becomes
+ * `{ "sidebar-brand"(props: P & DashboardSlotExtras) }`. Derived from the
+ * child's slot types, so a slot added to the child is typed here for free.
+ */
+export type PrefixedDashboardSlots<Slots, Prefix extends string> = {
+    [Name in keyof Slots as `${Prefix}${Name & string}`]?: (props: Omit<SlotPropsOf<Slots[Name]>, keyof DashboardSlotExtras> & DashboardSlotExtras) => any;
+};
+/**
+ * Slots of DXDashboard: the page content (`default`), every
+ * DXDashboardSidebar slot as `sidebar-<name>` and every DXDashboardNavbar
+ * slot as `navbar-<name>`. An unprefixed name (`#search`) is not forwarded.
+ * `TItem` is the navigation's item type (see `NavigationGroup`).
+ */
+export type DashboardSlots<TItem extends NavigationItem = NavigationItem> = {
+    /** The main page content. */
+    default?(props: NoSlotProps): any;
+} & PrefixedDashboardSlots<DashboardSidebarSlots<TItem>, "sidebar-"> & PrefixedDashboardSlots<DashboardNavbarSlots, "navbar-">;
+export {};

package/dist/utils/statCardFit.d.ts

@@ -0,0 +1,19 @@
+/** One card's fit: its elements, and the box width it was last fitted to. */
+export interface FitTarget {
+    box: HTMLElement;
+    value: HTMLElement;
+    /** Only numeric values are fitted; text wraps instead. */
+    isNumeric: () => boolean;
+    /** -1 when the next resize entry must refit whatever its width. */
+    fittedBoxWidth: number;
+}
+/**
+ * Queue a fit. "microtask" runs before the next paint, for mounts, content
+ * changes, reactivation and font loads. "frame" is for ResizeObserver
+ * callbacks: a fit inside the observer's delivery (microtasks run there
+ * too) changes the box's HEIGHT, which the browser reports as a
+ * "ResizeObserver loop" error, so a resize refits in the next frame.
+ */
+export declare function queueFit(target: FitTarget, timing: "microtask" | "frame"): void;
+export declare function registerTarget(target: FitTarget): void;
+export declare function unregisterTarget(target: FitTarget): void;

package/docs/public/api-reference.json

@@ -1,8 +1,8 @@
 {
-  "generated": "2026-10-09T16:42:41.495Z",
+  "generated": "2026-10-15T11:16:01.160Z",
   "package": {
     "name": "@omnitend/dashboard-for-laravel",
-    "version": "0.44.0"
+    "version": "0.46.0"
   },
   "components": {
     "base": [
@@ -556,6 +556,27 @@
         ],
         "methods": []
       },
+      {
+        "name": "DFormFile",
+        "category": "base",
+        "filePath": "resources/js/components/base/DFormFile.vue",
+        "description": "Type-safe wrapper around Bootstrap Vue Next BFormFile component. File picker with a browse button, file-name display and drag-and-drop zone. `v-model` is a `File` (single), `File[]` (`multiple`/`directory`) or `null`; setting it to `null` (or `[]`) also clears the native input. A disabled control (the prop, or a disabled fieldset) ignores dropped files. Slots: `label`, `placeholder`, `file-name` (`{ files, names }`) and `drop-placeholder`. Exposes BFormFile's `focus`, `blur` and `reset`.",
+        "props": [],
+        "events": [],
+        "slots": [
+          {
+            "name": "name",
+            "description": "",
+            "bindings": [
+              {
+                "name": "name",
+                "title": "binding"
+              }
+            ]
+          }
+        ],
+        "methods": []
+      },
       {
         "name": "DFormGroup",
         "category": "base",
@@ -798,6 +819,27 @@
         "slots": [],
         "methods": []
       },
+      {
+        "name": "DFormValidFeedback",
+        "category": "base",
+        "filePath": "resources/js/components/base/DFormValidFeedback.vue",
+        "description": "",
+        "props": [],
+        "events": [],
+        "slots": [
+          {
+            "name": "name",
+            "description": "",
+            "bindings": [
+              {
+                "name": "name",
+                "title": "binding"
+              }
+            ]
+          }
+        ],
+        "methods": []
+      },
       {
         "name": "DImage",
         "category": "base",
@@ -1564,7 +1606,7 @@
         "props": [
           {
             "name": "navigation",
-            "type": "Navigation",
+            "type": "TNavigation",
             "required": true,
             "description": "Navigation structure for sidebar"
           },
@@ -1856,7 +1898,7 @@
         "props": [
           {
             "name": "navigation",
-            "type": "Navigation",
+            "type": "TNavigation",
             "required": true,
             "description": "Grouped navigation to render: an array of groups, each with a label and items."
           },
@@ -2932,8 +2974,8 @@
             "name": "delay",
             "type": "number",
             "required": false,
-            "default": "300",
-            "description": ""
+            "default": "600",
+            "description": "Milliseconds to wait before showing anything. Most loads finish\n sooner, and one that has already taken this long is likely to take\n longer, so a quick load never flashes a loader."
           }
         ],
         "events": [],
@@ -4579,8 +4621,8 @@
     ]
   },
   "stats": {
-    "totalComponents": 90,
-    "baseComponents": 60,
+    "totalComponents": 92,
+    "baseComponents": 62,
     "extendedComponents": 30
   }
 }

package/docs/public/docs-map.md

@@ -1,7 +1,7 @@
 # Documentation Map
 
 > Auto-generated hierarchical overview of all documentation
-> Last updated: 2026-10-09T16:42:41.546Z
+> Last updated: 2026-10-15T11:16:01.216Z
 
 This file provides a complete map of all available documentation for AI agents and developers.
 
@@ -33,6 +33,7 @@ This file provides a complete map of all available documentation for AI agents a
 - [DDropdownItem](/components/base/DDropdownItem): Type-safe wrapper around Bootstrap Vue Next's BDropdownItem component
 - [DForm](/components/base/DForm): Type-safe wrapper around Bootstrap Vue Next's BForm component
 - [DFormCheckbox](/components/base/DFormCheckbox): Type-safe wrapper around Bootstrap Vue Next's BFormCheckbox component
+- [DFormFile](/components/base/DFormFile): Type-safe wrapper around Bootstrap Vue Next's BFormFile component
 - [DFormGroup](/components/base/DFormGroup): Type-safe wrapper around Bootstrap Vue Next's BFormGroup component
 - [DFormInput](/components/base/DFormInput): Type-safe wrapper around Bootstrap Vue Next's BFormInput component
 - [DFormInvalidFeedback](/components/base/DFormInvalidFeedback): Type-safe wrapper around Bootstrap Vue Next's BFormInvalidFeedback component
@@ -43,6 +44,7 @@ This file provides a complete map of all available documentation for AI agents a
 - [DFormTags](/components/base/DFormTags): Type-safe wrapper around Bootstrap Vue Next's BFormTags component
 - [DFormText](/components/base/DFormText): Type-safe wrapper around Bootstrap Vue Next's BFormText component
 - [DFormTextarea](/components/base/DFormTextarea): Type-safe wrapper around Bootstrap Vue Next's BFormTextarea component
+- [DFormValidFeedback](/components/base/DFormValidFeedback): Type-safe wrapper around Bootstrap Vue Next's BFormValidFeedback component
 - [DImage](/components/base/DImage): Type-safe wrapper around Bootstrap Vue Next's BImage component
 - [DInputGroup](/components/base/DInputGroup): Type-safe wrapper around Bootstrap Vue Next's BInputGroup component
 - [DLink](/components/base/DLink): Type-safe wrapper around Bootstrap Vue Next's BLink component
@@ -106,4 +108,4 @@ This file provides a complete map of all available documentation for AI agents a
 
 ---
 
-**Total Pages**: 82
+**Total Pages**: 84

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 80 Vue 3 components for building Laravel dashboards with Bootstrap Vue Next.
+> A dual-package library (NPM + Composer) providing 82 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 (60 components)
+## Base Components (62 components)
 
 Lightweight type-safe wrappers around Bootstrap Vue Next components providing API stability and consistent theming.
 
@@ -46,6 +46,7 @@ Lightweight type-safe wrappers around Bootstrap Vue Next components providing AP
 - [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
+- [DFormFile](/components/base/dformfile): Bootstrap Vue Next FormFile 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
@@ -57,6 +58,7 @@ Lightweight type-safe wrappers around Bootstrap Vue Next components providing AP
 - [DFormTags](/components/base/dformtags): Bootstrap Vue Next FormTags wrapper
 - [DFormText](/components/base/dformtext): Bootstrap Vue Next FormText wrapper
 - [DFormTextarea](/components/base/dformtextarea): Bootstrap Vue Next FormTextarea wrapper
+- [DFormValidFeedback](/components/base/dformvalidfeedback): Bootstrap Vue Next FormValidFeedback wrapper
 - [DImage](/components/base/dimage): Bootstrap Vue Next Image wrapper
 - [DInputGroup](/components/base/dinputgroup): Bootstrap Vue Next InputGroup wrapper
 - [DLink](/components/base/dlink): Bootstrap Vue Next Link wrapper

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnitend/dashboard-for-laravel",
-  "version": "0.44.0",
+  "version": "0.46.0",
   "description": "Vue 3 dashboard components for Laravel with Bootstrap Vue Next",
   "type": "module",
   "main": "./dist/dashboard-for-laravel.umd.cjs",
@@ -36,13 +36,14 @@
     "dev": "vite build --watch",
     "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",
+    "typecheck": "vue-tsc --noEmit && vue-tsc --noEmit -p tests/types/tsconfig.json",
     "pretest": "npm run build:lib",
     "test": "vitest",
     "pretest:ui": "npm run build:lib",
     "test:ui": "vitest --ui",
     "pretest:headless": "npm run build:lib",
     "test:headless": "vitest --run --browser.headless",
+    "test:linux": "bash scripts/test-linux.sh",
     "docs:dev": "astro dev",
     "docs:build": "npm run docs:generate:ai && astro build && node scripts/check-docs-base-links.mjs",
     "docs:preview": "astro preview",