@appsbd/vue3-appsbd-ui 1.0.8 → 1.0.10

package/.ai/ai_ref_AbButton.md

@@ -28,6 +28,7 @@ const isSaving = ref(false);
 
 | Name | Type | Default | Description |
 | --- | --- | --- | --- |
+| `mode` | `String` | `"button"` | Sets the root tag (`button`, `link`, `router-link`). |
 | `type` | `String` | `"button"` | Native button type (`button`, `submit`, `reset`). |
 | `color` | `String` | `"primary"` | Color variant (primary, secondary, success, danger, warning, info, light, dark). |
 | `size` | `String` | `"md"` | Button size (`xs`, `sm`, `md`, `lg`, `xl`, `xxl`). |

package/.ai/ai_ref_AbField.md

@@ -34,14 +34,14 @@ Polymorphic field wrapper — renders text, textarea, select, multiselect, tag,
 | Name | Type | Default | Description |
 | --- | --- | --- | --- |
 | `val` | `any` | `null` | Initial value (used when `modelValue` is empty). |
-| `label` | `String` | **required** | Field label. |
-| `name` | `String` | **required** | VeeValidate field name. |
+| `label` | `String` | `undefined` | Field label. |
+| `name` | `String` | `""` | VeeValidate field name. |
 | `type` | `String` | `"text"` | `text`, `email`, `password`, `number`, `url`, `textarea`, `select`, `multiselect`, `tag`, `checkbox`, `radio`, `toggle`, `switch`. |
 | `prefix` | `String` | `""` | Prefix text/icon. |
 | `postfix` | `String` | `""` | Postfix text/icon. |
 | `modelValue` | `String \| Number \| Boolean \| Array \| Object` | `""` | Two-way-bound value. |
 | `isCodeInput` | `Boolean` | `false` | Applies monospace styling. |
-| `containerClass` | `String` | `""` | Wrapper class. |
+| `containerClass` | `String` | `undefined` | Wrapper class. |
 | `maxlength` | `String \| Number` | `""` | Native maxlength. |
 | `minlength` | `String \| Number` | `""` | Native minlength. |
 | `placeholder` | `String` | `""` | Input placeholder. |
@@ -51,19 +51,25 @@ Polymorphic field wrapper — renders text, textarea, select, multiselect, tag,
 | `labelKey` | `String` | `"title"` | Option label property. |
 | `valueKey` | `String` | `"val"` | Option value property. |
 | `max` | `Number` | `-1` | Max selections (multiselect/tag); `-1` = unlimited. |
-| `size` | `String` | `"md"` | Field size. |
+| `size` | `String` | `undefined` | Field size. |
 | `object` | `Boolean` | `false` | Return full objects instead of values (multiselect). |
 | `searchable` | `Boolean` | `false` | Enable search (select). |
 | `description` | `String` | `""` | Secondary description. |
 | `helptext` | `String` | `""` | Help text. |
 | `isInline` | `Boolean` | `false` | Inline layout (checkbox/radio). |
-| `trueValue` | `any` | `"Y"` | Toggle/switch on value. |
-| `falseValue` | `any` | `"N"` | Toggle/switch off value. |
+| `trueValue` | `any` | `undefined` | Toggle/switch on value. |
+| `falseValue` | `any` | `undefined` | Toggle/switch off value. |
 | `title` | `String \| null` | `null` | Toggle/switch title. |
 | `isLeftIconBorder` | `Boolean` | `false` | Border on left icon. |
 | `isRightIconBorder` | `Boolean` | `false` | Border on right icon. |
+| `passIconPosition` | `String` | `"right"` | Position of the show password icon. |
 | `isHideLabel` | `Boolean` | `false` | Hide the label visually. |
-| `iconPosition` | `String` | `"right"` | Position of the custom `#icon` slot (`"left"`, `"right"`). |
+| `iconPosition` | `String` | `undefined` | Position of the custom `#icon` slot (`"left"`, `"right"`). |
+| `onSearch` | `Function` | `null` | Async handler `(query) => Promise<options>`. |
+| `isAjaxSearch` | `Boolean` | `false` | Enable async search via `onSearch`. |
+| `hideSelected` | `Boolean` | `true` | Hide already-selected items from dropdown. |
+| `loading` | `Boolean` | `false` | Show a loading spinner. |
+| `appendToBody` | `Boolean` | `true` | Teleport the dropdown to `<body>`. |
 
 ## Events
 

package/.ai/ai_ref_AbInputField.md

@@ -32,18 +32,22 @@ const form = reactive({ email: '' });
 | `label` | `String` | `""` | Field label. |
 | `placeholder` | `String` | `""` | Input placeholder. |
 | `type` | `String` | `"text"` | Native input type (`text`, `email`, `password`, `number`, `tel`, …). |
-| `name` | `String` | **required** | VeeValidate field name. |
+| `name` | `String` | `""` | VeeValidate field name. |
 | `isCodeInput` | `Boolean` | `false` | Applies monospace / code-input styling. |
+| `size` | `String` | `undefined` | Adjusts component size (`xs`, `sm`, `md`, `lg`, `xl`, `xxl`). |
 | `rules` | `String \| Object` | `""` | VeeValidate rules. |
-| `containerClass` | `String` | `"mb-3"` | Class on the wrapper `<div>`. |
+| `containerClass` | `String` | `undefined` | Class on the wrapper `<div>`. |
 | `hints` | `String` | `""` | Helper text beneath the input. |
 | `prefix` | `String` | `""` | Prefix text/icon (shortcut for `#prefix` slot). |
 | `postfix` | `String` | `""` | Postfix text/icon. |
 | `maxlength` | `any` | `null` | Native `maxlength`. |
 | `isLeftIconBorder` | `Boolean` | `false` | Renders border between the prefix icon and the input. |
 | `isRightIconBorder` | `Boolean` | `false` | Renders border between the postfix icon and the input. |
+| `passIconPosition` | `String` | `"right"` | Position of the show password icon (`"left"`, `"right"`). |
 | `isHideLabel` | `Boolean` | `false` | Hide the label visually. |
-| `iconPosition` | `String` | `"right"` | Position of the custom `#icon` slot (`"left"`, `"right"`). |
+| `iconPosition` | `String` | `undefined` | Position of the custom `#icon` slot (`"left"`, `"right"`). |
+| `inputClass` | `String \| Object \| Array` | `undefined` | Additional class(es) for the input element. |
+| `inputStyle` | `String \| Object \| Array` | `undefined` | Additional style(s) for the input element. |
 
 ## Events
 

package/.ai/ai_ref_AbInputTag.md

@@ -25,11 +25,11 @@ const skills = ref([]);
 | `modelValue` | `Array` | `[]` | v-model array of selected tags. |
 | `options` | `Array` | `[]` | Each entry: `{ val, title }` or a plain string. |
 | `label` | `String` | `""` | Field label. |
-| `size` | `String` | `"md"` | Adjusts component size (`xs`, `sm`, `md`, `lg`, `xl`, `xxl`). |
+| `size` | `String` | `undefined` | Adjusts component size (`xs`, `sm`, `md`, `lg`, `xl`, `xxl`). |
 | `placeholder` | `String` | `""` | Placeholder text. |
-| `name` | `String` | **required** | VeeValidate field name. |
+| `name` | `String` | `""` | VeeValidate field name. |
 | `rules` | `String \| Object` | `""` | VeeValidate rules. |
-| `containerClass` | `String` | `"mb-3"` | Wrapper class. |
+| `containerClass` | `String` | `undefined` | Wrapper class. |
 | `hints` | `String` | `""` | Helper text. |
 | `prefix` | `String` | `""` | Prefix icon/text. |
 | `postfix` | `String` | `""` | Postfix icon/text. |
@@ -37,7 +37,7 @@ const skills = ref([]);
 | `isLeftIconBorder` | `Boolean` | `false` | Border on prefix icon. |
 | `isRightIconBorder` | `Boolean` | `false` | Border on postfix icon. |
 | `isHideLabel` | `Boolean` | `false` | Hide the label visually. |
-| `iconPosition` | `String` | `"right"` | Position of the custom `#icon` slot (`"left"`, `"right"`). |
+| `iconPosition` | `String` | `undefined` | Position of the custom `#icon` slot (`"left"`, `"right"`). |
 
 ## Events
 

package/.ai/ai_ref_AbModal.md

@@ -17,7 +17,9 @@ Full-featured dialog with a built-in VeeValidate `<Form>`, loader overlay, and "
   >
     <template #headerTitle>Edit profile</template>
 
-    <ab-input-field name="email" label="Email" rules="required|email" v-model="form.email" />
+    <template #body>
+      <ab-input-field name="email" label="Email" rules="required|email" v-model="form.email" />
+    </template>
 
     <template #footer="{ close }">
       <ab-button class="btn-outline-secondary" @click="close">Cancel</ab-button>
@@ -47,7 +49,7 @@ async function handleSubmit(values, { resetForm }) {
 | --- | --- | --- | --- |
 | `isModalVisible` | `Boolean` | — | Visibility state (`v-model:is-modal-visible`). |
 | `modalSize` | `String` | `""` | Bootstrap size class (`modal-sm`, `modal-lg`, `modal-xl`). |
-| `modalMsg` | `String` | `""` | Default message for message-only mode. |
+| `modalMsg` | `[String, Object]` | `{}` | Default message for message-only mode. |
 | `hideHeader` | `Boolean` | `false` | Hide the header section. |
 | `hideBody` | `Boolean` | `false` | Hide the body section. |
 | `hideFooter` | `Boolean` | `false` | Hide the footer section. |
@@ -55,7 +57,7 @@ async function handleSubmit(values, { resetForm }) {
 | `hideForm` | `Boolean` | `false` | Render root as plain `<div>` instead of VeeValidate `<Form>`. |
 | `bodyClass` | `String` | `""` | Extra class on the body section. |
 | `isModalCenter` | `Boolean` | `true` | Vertically center the modal. |
-| `isBorder` | `Boolean` | `false` | Border around modal content. |
+| `isBorder` | `Boolean` | `undefined` | Border around modal content. Defaults to global config. |
 | `iconContainerClass` | `String` | `""` | Extra class on the header icon container. |
 | `headerClass` | `String` | `""` | Extra class on the header. |
 | `headerrClass` | `String` | `""` | Legacy alias for `headerClass`. |
@@ -64,7 +66,8 @@ async function handleSubmit(values, { resetForm }) {
 
 | Event | Payload | Description |
 | --- | --- | --- |
-| `onSubmit` | `(event, { resetForm })` | Fired when the internal VeeValidate form is submitted. |
+| `onSubmit` | `(event, { resetForm, showMsgOnly, clearForm, showLoader })` | Fired when the internal VeeValidate form is submitted. |
+| `onLoading` | `({ showLoader, clearForm })` | Emitted on mounted to allow setting up initial loader state. |
 | `loading-status` | `Boolean` | Emitted when loader state toggles. |
 | `close` | — | Modal was closed (✕, Escape, or `close()`). |
 
@@ -72,7 +75,6 @@ async function handleSubmit(values, { resetForm }) {
 
 | Name | Scope | Description |
 | --- | --- | --- |
-| `default` | VeeValidate `Form` slot-props | Form body when `hideForm` is `false`. |
 | `header` | — | Overrides the entire header. |
 | `headerIcon` | — | Icon at the start of the header. |
 | `headerTitleContainer` | — | Overrides the title/subtitle wrapper. |

package/.ai/ai_ref_AbMultiSelect.md

@@ -24,14 +24,14 @@ Searchable single/multi/tag select. Custom built-in replacement for `@vueform/mu
 | `label` | `String` | `""` | Field label. |
 | `placeholder` | `String` | `""` | Placeholder text. |
 | `type` | `String` | `"text"` | Input type. |
-| `name` | `String` | **required** | VeeValidate field name. |
+| `name` | `String` | `""` | VeeValidate field name. |
 | `rules` | `String \| Object` | `""` | VeeValidate rules. |
-| `containerClass` | `String` | `"mb-3"` | Wrapper class. |
+| `containerClass` | `String` | `undefined` | Wrapper class. |
 | `hints` | `String` | `""` | Helper text. |
 | `multiple` | `Boolean` | `false` | Deprecated — use `mode` instead. |
 | `searchable` | `Boolean` | `false` | Enable option search/filter. |
 | `mode` | `String` | `"single"` | `single`, `multiple`, or `tags`. |
-| `size` | `String` | `"md"` | Adjusts component size (`xs`, `sm`, `md`, `lg`, `xl`, `xxl`). |
+| `size` | `String` | `undefined` | Adjusts component size (`xs`, `sm`, `md`, `lg`, `xl`, `xxl`). |
 | `options` | `Array` | `[]` | Available options. |
 | `labelKey` | `String` | `"title"` | Property to use for label. |
 | `valueKey` | `String` | `"val"` | Property to use for value. |
@@ -48,7 +48,7 @@ Searchable single/multi/tag select. Custom built-in replacement for `@vueform/mu
 | `isLeftIconBorder` | `Boolean` | `false` | Border on prefix icon. |
 | `isRightIconBorder` | `Boolean` | `false` | Border on postfix icon. |
 | `isHideLabel` | `Boolean` | `false` | Hide the label visually. |
-| `iconPosition` | `String` | `"right"` | Position of the custom `#icon` slot (`"left"`, `"right"`). |
+| `iconPosition` | `String` | `undefined` | Position of the custom `#icon` slot (`"left"`, `"right"`). |
 
 ## Events
 

package/.ai/ai_ref_AbPopover.md

@@ -37,6 +37,7 @@ Interactive popover with click, hover, focus, touch, or manual triggers. Content
 | `autoHide` | `Boolean` | `true` | Close when clicking outside. |
 | `contentClass` | `String` | `""` | Extra class on the content element. |
 | `referenceSelector` | `String` | `null` | CSS selector inside the trigger to anchor positioning. |
+| `width` | `String \| Number` | `null` | Fixed width for the popover content. |
 
 ## Events
 

package/.ai/ai_ref_AbSideMenuItem.md

@@ -26,10 +26,11 @@ Single entry in an `AbSidebar`. Renders as a router-link, plain anchor, section
 
 ## Props
 
-| Name | Type | Description |
-| --- | --- | --- |
-| `to` | `String \| Object` | Router-link target. When this item has a submenu, `to` makes the label clickable as a link. |
-| `href` | `String` | Plain anchor target. With a submenu, `href` makes the item a submenu toggle instead of a link. |
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| `to` | `String \| Object` | `undefined` | Router-link target. When this item has a submenu, `to` makes the label clickable as a link. |
+| `href` | `String` | `undefined` | Plain anchor target. With a submenu, `href` makes the item a submenu toggle instead of a link. |
+| `popoverTrigger` | `String` | `"hover"` | Trigger type for the popover submenu when collapsed (`"hover"`, `"click"`). |
 
 ## Slots