@omnitend/dashboard-for-laravel 0.45.0 → 0.47.0

package/dist/types/index.d.ts

@@ -215,6 +215,19 @@ export interface FieldDefinition {
      * `FormFieldDefinition` re-declares this as required for inference.)
      */
     default?: any;
+    /**
+     * For a field whose value is a list of rows (a `repeater`, or a span
+     * field that renders its own rows and owns `key.N.*` error keys): the
+     * row's own name, called with the row (`model[key][index]`, or `{}` when
+     * the model has no such row) and its 0-based index. When it returns a
+     * non-empty string, the error summary lists that row's errors under it
+     * alone ("Chaucer Ale (Pint): Enter a price.") instead of
+     * "<sub-field label> (line N)". Returning `undefined`, `null` or `""`
+     * (a row with no name yet), or throwing, keeps the line-number label.
+     * Only labels: which field owns the error, and what a click on the
+     * summary row focuses, are unchanged.
+     */
+    rowLabel?: (row: Record<string, any>, index: number) => string | null | undefined;
     /** Label for a repeater's "add row" button (default: "Add"). */
     addLabel?: string;
     /** Minimum / maximum number of repeater rows. */
@@ -295,6 +308,10 @@ export interface FieldDefinition {
      * every `editFields` key, so those decorative fields are POSTed alongside
      * the real ones (an empty string, an empty array) purely because they were
      * declared.
+     *
+     * Applies per KEY (#228): DXTable drops a key only when no field with that
+     * key is both submitting and visible, so a `submit: false` display twin
+     * does not strip the value of a visible editable field sharing its key.
      */
     submit?: boolean;
     /**
@@ -444,6 +461,7 @@ export interface ComponentFieldDef extends BaseFieldDef {
 export interface RepeaterFieldDef extends BaseFieldDef {
     type: "repeater";
     fields?: FieldDef[];
+    rowLabel?: (row: Record<string, any>, index: number) => string | null | undefined;
     addLabel?: string;
     minItems?: number;
     maxItems?: number;
@@ -488,6 +506,48 @@ export interface FormTab {
     /** Lazily mount tab content until first activated */
     lazy?: boolean;
 }
+/**
+ * Slot props of DXField's `password-actions` slot (DXForm:
+ * `password-actions(<key>)`): content placed beside a password input, inside
+ * its input group after the reveal (eye) toggle, such as a "Generate password"
+ * button. `setRevealed` drives the same state the eye toggles.
+ *
+ * ```vue
+ * <template #password-actions(password)="{ update, setRevealed, disabled }">
+ *   <DButton variant="outline-secondary" :disabled="disabled"
+ *     @click="update(generatePassword()); setRevealed(true)">Generate</DButton>
+ * </template>
+ * ```
+ */
+export interface PasswordActionsSlotProps {
+    /** The field definition being rendered. */
+    field: FieldDefinition;
+    /** The model passed to field predicates (defaults to the live form data). */
+    model: any;
+    /** The current field value. */
+    value: any;
+    /** Write a new value (also marks the field touched and clears its error). */
+    update: (value: any) => void;
+    /** Whether the password is currently shown as plain text. */
+    revealed: boolean;
+    /**
+     * Show (`true`) or mask (`false`) the password, exactly as the eye does.
+     * A no-op on a `revealable: false` field, which never unmasks.
+     */
+    setRevealed: (revealed: boolean) => void;
+    /** Whether the field is disabled or read-only. */
+    disabled: boolean;
+}
+/**
+ * Slot props of DXTable's `edit-password-actions(<key>)` slot, the edit/create
+ * modal's form of {@link PasswordActionsSlotProps}. `item` is the row being
+ * edited, `null` in create mode. (`model` is not passed, as with the modal's
+ * other field slots.)
+ */
+export interface EditPasswordActionsSlotProps extends Omit<PasswordActionsSlotProps, "model"> {
+    /** The row being edited; `null` in create mode. */
+    item: any;
+}
 /**
  * The theme's extra colour variant, `pending`: waiting, and the next move is
  * not yours ("awaiting payment", "sent to printer, not yet confirmed").

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/formErrorTargets.d.ts

@@ -25,7 +25,10 @@ export interface ErrorTarget {
     fieldKey: string | null;
     /** The tab holding the owning field, or `null` (flat form, or unowned). */
     tabKey: string | null;
-    /** A readable name for the key: "Price (line 1)", "Delivery date". */
+    /**
+     * A readable name for the key: "Price (line 1)", "Delivery date", or a
+     * row's own name from the field's `rowLabel`.
+     */
     label: string;
 }
 export interface ResolveErrorTargetsOptions {
@@ -75,7 +78,8 @@ export declare function humaniseErrorKey(key: string): string;
  *
  * Labels: the owning field's label; for `field.N.sub` the sub-field's label
  * (when the field defines `fields` and one has that key) or the field's own,
- * plus "(line N+1)"; for any other nested key (a media map's
+ * plus "(line N+1)" — unless the field's `rowLabel` names that row, when
+ * the row's name is the whole label; for any other nested key (a media map's
  * `image_media.<uuid>`) the field's label. An unowned key is humanised.
  *
  * Display lines: "Label: message", except that the label is left off when

package/dist/utils/formSchema.d.ts

@@ -57,3 +57,19 @@ export declare function isFieldVisible(field: {
 export declare function isSubmittableField(field: {
     submit?: boolean;
 }): boolean;
+/**
+ * The payload keys to drop on submit: every field key for which NO field with
+ * that key is both submittable (`submit !== false`) and visible (#228).
+ *
+ * Decided per KEY, across all the fields that share it, never per field. Two
+ * fields may share a key: an editable select plus a read-only display twin
+ * (`submit: false`) that shows instead for system-created rows. Stripping a
+ * key because ONE of its fields is presentational or hidden removed it from
+ * every save, including while the select was the visible field in use. A key
+ * whose fields are all presentational (#110) or all hidden (#117) is still
+ * dropped.
+ */
+export declare function nonSubmittedFieldKeys<TField extends {
+    key: string;
+    submit?: boolean;
+}>(fields: readonly TField[], isVisible: (field: TField) => boolean): Set<string>;

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-11T09:08:08.777Z",
+  "generated": "2026-10-21T10:08:54.451Z",
   "package": {
     "name": "@omnitend/dashboard-for-laravel",
-    "version": "0.45.0"
+    "version": "0.47.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."
           },
@@ -2076,7 +2118,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. 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.",
+        "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`, `repeater-row` and `password-actions` 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",
@@ -2275,6 +2317,64 @@
             "name": "repeater-row",
             "description": "Custom layout for a single repeater row, forwarded to `DXRepeater`'s `row` slot with its row props (row index, item, remove handler, etc.).",
             "bindings": []
+          },
+          {
+            "name": "password-actions",
+            "description": "Extra controls beside a password input, after its input group (the input and the reveal (eye) toggle), e.g. a \"Generate password\" button. They sit on the input's row while it keeps `--dx-password-input-min-width`, and wrap below it when the row is too narrow. Use an ordinary button (a `secondary` `DButton` matches the form's other buttons). Not rendered on a `plaintext` field.",
+            "bindings": [
+              {
+                "title": "binding",
+                "type": {
+                  "name": "FieldDefinition"
+                },
+                "name": "field",
+                "description": "The field definition being rendered."
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "any"
+                },
+                "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."
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "boolean"
+                },
+                "name": "revealed",
+                "description": "Whether the password is currently shown as plain text."
+              },
+              {
+                "name": "set-revealed",
+                "title": "binding"
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "boolean"
+                },
+                "name": "disabled",
+                "description": "Whether the field is disabled or read-only, so actions that change the value can disable themselves."
+              }
+            ]
           }
         ],
         "methods": []
@@ -2754,7 +2854,7 @@
         "name": "DXFormField",
         "category": "extended",
         "filePath": "resources/js/components/extended/DXFormField.vue",
-        "description": "DXFormField — internal per-field renderer for DXForm. Owns the single per-field render block that DXForm's tabbed and flat layouts both need: the `field(<key>)` full-replacement slot, the `field-before(<key>)`/`field-after(<key>)` wrapper slots, and the `<DXField>` element with its `value`/`span`/`info`/`hint`/`repeater-row` slot forwarding. Extracted so those per-field props/slots are wired in ONE place — before this, DXForm carried two near-identical copies (tabbed + flat) and a new per-field prop had to be added to both, which was easy to miss (see #78/#83). DXForm forwards all of its slots into each instance; this component only reads the ones matching its field's key. Internal: not exported from the package index — consumers use DXForm.",
+        "description": "DXFormField — internal per-field renderer for DXForm. Owns the single per-field render block that DXForm's tabbed and flat layouts both need: the `field(<key>)` full-replacement slot, the `field-before(<key>)`/`field-after(<key>)` wrapper slots, and the `<DXField>` element with its `value`/`span`/`info`/`hint`/`repeater-row`/ `switch-list-item`/`password-actions` slot forwarding. Extracted so those per-field props/slots are wired in ONE place — before this, DXForm carried two near-identical copies (tabbed + flat) and a new per-field prop had to be added to both, which was easy to miss (see #78/#83). DXForm forwards all of its slots into each instance; this component only reads the ones matching its field's key. Internal: not exported from the package index — consumers use DXForm.",
         "props": [
           {
             "name": "field",
@@ -4084,7 +4184,7 @@
         "name": "DXTableEditorModal",
         "category": "extended",
         "filePath": "resources/js/components/extended/DXTableEditorModal.vue",
-        "description": "Internal edit/create modal for `DXTable` (#129). Renders the `DModal` + `DXForm` and maps DXTable's `edit-value`/`edit-span`/`tab-*` slots onto DXForm's `value`/`span`/`tab-*` slots, providing the row context and a `close` handle. Extracted so `DXTable` is a thin façade over the table render, the pagination, the editor logic (`useResourceEditor`) and this modal — rather than owning all four. The edit-modal slots reach here forwarded from DXTable (consumer → DXTable → here → DXForm). This component computes which keyed slots the consumer actually provided from its OWN `$slots`, so the slot-plumbing lives entirely with the modal, not the composable.",
+        "description": "Internal edit/create modal for `DXTable` (#129). Renders the `DModal` + `DXForm` and maps DXTable's `edit-value`/`edit-span`/`edit-password-actions`/ `tab-*` slots onto DXForm's `value`/`span`/`password-actions`/`tab-*` slots, providing the row context and a `close` handle. Extracted so `DXTable` is a thin façade over the table render, the pagination, the editor logic (`useResourceEditor`) and this modal — rather than owning all four. The edit-modal slots reach here forwarded from DXTable (consumer → DXTable → here → DXForm). This component computes which keyed slots the consumer actually provided from its OWN `$slots`, so the slot-plumbing lives entirely with the modal, not the composable.",
         "props": [
           {
             "name": "show",
@@ -4331,6 +4431,68 @@
               }
             ]
           },
+          {
+            "name": "`edit-password-actions(${key})`",
+            "description": "Extra controls beside password field `<key>`'s input in the edit/create modal, inside its input group after the reveal (eye) toggle — e.g. a \"Generate password\" button. Name it `edit-password-actions(<fieldKey>)`.",
+            "bindings": [
+              {
+                "name": "name",
+                "title": "binding"
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "object"
+                },
+                "name": "item",
+                "description": "The row being edited (null in create mode)."
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "any"
+                },
+                "name": "value",
+                "description": "The current field value."
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "Function"
+                },
+                "name": "update",
+                "description": "Call with a new value to update the field."
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "boolean"
+                },
+                "name": "revealed",
+                "description": "Whether the password is currently shown as plain text."
+              },
+              {
+                "name": "set-revealed",
+                "title": "binding"
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "boolean"
+                },
+                "name": "disabled",
+                "description": "Whether the field is disabled or read-only."
+              },
+              {
+                "title": "binding",
+                "type": {
+                  "name": "object"
+                },
+                "name": "field",
+                "description": "The field definition."
+              }
+            ]
+          },
           {
             "name": "`tab-content(${key})`",
             "description": "Replaces the auto-rendered fields of edit-modal tab `<key>` with custom content. Name it `tab-content(<tabKey>)`.",
@@ -4579,8 +4741,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-11T09:08:08.837Z
+> Last updated: 2026-10-21T10:08:54.546Z
 
 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