@appsbd/vue3-appsbd-ui 1.0.3 → 1.0.4

package/.ai/ai_ref_AbScrollbar.md

@@ -2,22 +2,12 @@
 
 Styled custom scrollbar wrapper for overflowing content. Emits scroll position events and supports hover-expand.
 
-## Installation
-
-Globally registered by the plugin.
-
 ## Usage
 
 ```vue
 <template>
-  <ab-scrollbar
-    size="md"
-    is-hover-increase
-    @scroll-end="loadMore"
-  >
-    <div style="height: 2000px">
-      <!-- long content -->
-    </div>
+  <ab-scrollbar size="md" is-hover-increase @scroll-end="loadMore">
+    <div style="height: 2000px"><!-- long content --></div>
   </ab-scrollbar>
 </template>
 ```

package/.ai/ai_ref_AbSettingsForm.md

@@ -1,10 +1,6 @@
 # AbSettingsForm — AI Reference
 
-Composite settings-style form layout. When nested inside an `AbWizardStep` / `AbWizard`, auto-registers itself as the wizard step's validator — returning `false` from `onSubmit` blocks the wizard from advancing.
-
-## Installation
-
-Globally registered by the plugin.
+Composite settings-style form layout. When nested inside an `AbWizardStep`, auto-registers itself as the wizard step's validator — returning `false` from `onSubmit` blocks the wizard from advancing.
 
 ## Usage
 
@@ -39,10 +35,6 @@ async function validateProfile(values) {
 | --- | --- | --- | --- |
 | `onSubmit` | `Function` | `() => {}` | Called with form values on submit. Return `false` (or throw) to block wizard progression. |
 
-## Events
-
-None at the component level — form submission is handled via the `onSubmit` prop.
-
 ## Slots
 
 | Name | Description |

package/.ai/ai_ref_AbSideMenuItem.md

@@ -1,26 +1,19 @@
 # AbSideMenuItem — AI Reference
 
-Single entry in an `AbSidebar`. Can render as a router-link, a plain anchor, a section title, or a parent node with a submenu.
-
-## Installation
-
-Globally registered by the plugin.
+Single entry in an `AbSidebar`. Renders as a router-link, plain anchor, section title, or parent node with a submenu.
 
 ## Usage
 
 ```vue
-<!-- Router-link item -->
 <ab-side-menu-item :to="{ name: 'dashboard' }">
   <template #icon><i class="bi bi-house"></i></template>
   Dashboard
 </ab-side-menu-item>
 
-<!-- Section title -->
 <ab-side-menu-item>
   <template #sectiontitle>Account</template>
 </ab-side-menu-item>
 
-<!-- Parent with submenu -->
 <ab-side-menu-item href="#">
   <template #icon><i class="bi bi-gear"></i></template>
   Settings
@@ -38,10 +31,6 @@ Globally registered by the plugin.
 | `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. |
 
-## Events
-
-None.
-
 ## Slots
 
 | Name | Description |

package/.ai/ai_ref_AbSidebar.md

@@ -1,10 +1,6 @@
 # AbSidebar — AI Reference
 
-Collapsible application sidebar. Hosts `AbSideMenuItem` children, supports a header/footer, optional search, and persists its collapse state to `localStorage`.
-
-## Installation
-
-Globally registered by the plugin.
+Collapsible application sidebar. Hosts `AbSideMenuItem` children, supports header/footer, optional search, and persists collapse state to `localStorage`.
 
 ## Usage
 
@@ -44,16 +40,12 @@ Globally registered by the plugin.
 
 | Name | Type | Default | Description |
 | --- | --- | --- | --- |
-| `appUniqueId` | `String` | `"apbd"` | Unique key used for the `localStorage` entry that stores collapse state. |
+| `appUniqueId` | `String` | `"apbd"` | Unique key for the `localStorage` entry that stores collapse state. |
 | `hideSeperator` | `Boolean` | `false` | Hide dividers between sections. |
 | `mobileFullHeight` | `Boolean` | `false` | Force full-viewport height on mobile. |
 | `enableSearch` | `Boolean` | `false` | Show a search box that filters menu items. |
 | `searchTargetClass` | `String` | `"nav-item"` | CSS class of items that the search should match. |
 
-## Events
-
-None.
-
 ## Slots
 
 | Name | Description |

package/.ai/ai_ref_AbSkeleton.md

@@ -2,18 +2,12 @@
 
 Pulsing placeholder for loading states. Forwards all `$attrs` to the root `<div>`, so size and shape are controlled through utility classes or inline styles.
 
-## Installation
-
-Globally registered by the plugin.
-
 ## Usage
 
 ```vue
 <template>
-  <!-- Heading skeleton -->
   <ab-skeleton style="height: 24px; width: 60%;" />
 
-  <!-- Card skeleton -->
   <ab-card>
     <template #body>
       <ab-skeleton style="height: 160px; border-radius: 8px;" />
@@ -24,18 +18,6 @@ Globally registered by the plugin.
 </template>
 ```
 
-## Props
-
-No declared props.
-
-## Events
-
-None.
-
-## Slots
-
-None.
-
 ## Notes
 
 Apply `width`, `height`, `border-radius`, etc. via `style` or a utility class.

package/.ai/ai_ref_AbSlider.md

@@ -2,29 +2,14 @@
 
 Single or range numeric slider with custom thumb rendering and size variants.
 
-## Installation
-
-Globally registered by the plugin.
-
 ## Usage
 
 ```vue
 <template>
-  <!-- Single -->
   <ab-slider v-model="volume" :min="0" :max="100" label="Volume" show-labels />
 
-  <!-- Range -->
-  <ab-slider
-    v-model="priceRange"
-    :min="0"
-    :max="5000"
-    :step="50"
-    range
-    show-labels
-    :format-label="v => '$' + v"
-  />
+  <ab-slider v-model="priceRange" :min="0" :max="5000" :step="50" range show-labels :format-label="v => '$' + v" />
 
-  <!-- Custom thumb -->
   <ab-slider v-model="progress" show-labels>
     <template #thumb="{ value, type }">
       <div class="custom-thumb">{{ value }}</div>
@@ -65,7 +50,3 @@ Globally registered by the plugin.
 | `postfix` | — | Postfix content (after the track). |
 | `thumb` | `{ value, type }` | Custom thumb rendering. `type` is `"min"`, `"max"`, or `"single"`. |
 | `hints` | — | Custom hints. |
-
-## v-model
-
-Yes.

package/.ai/ai_ref_AbTab.md

@@ -2,10 +2,6 @@
 
 Single tab pane / link. Must be used inside an `AbTabs` parent.
 
-## Installation
-
-Globally registered by the plugin.
-
 ## Usage
 
 ```vue
@@ -26,10 +22,6 @@ Globally registered by the plugin.
 | `selected` | `Boolean` | `false` | Mark this tab as initially selected. |
 | `to` | `String \| Object` | `null` | Router-link target (only used when the parent `AbTabs` has `is-route-mode`). |
 
-## Events
-
-None.
-
 ## Slots
 
 | Name | Description |

package/.ai/ai_ref_AbTable.md

@@ -2,10 +2,6 @@
 
 Data grid with column definitions, per-cell and per-header slot overrides, and an `empty` slot.
 
-## Installation
-
-Globally registered by the plugin.
-
 ## Usage
 
 ```vue
@@ -19,10 +15,8 @@ Globally registered by the plugin.
       { key: 'actions', label: '' },
     ]"
   >
-    <!-- Custom header -->
     <template #head(name)>Full Name</template>
 
-    <!-- Custom cell -->
     <template #cell(role)="{ value }">
       <ab-badge class="bg-primary">{{ value }}</ab-badge>
     </template>
@@ -44,10 +38,6 @@ Globally registered by the plugin.
 | `fields` | `Array` | `[]` | Column definitions — each string key or `{ key, label }`. |
 | `tableClass` | `String \| Array \| Object` | `""` | CSS class(es) applied to the `<table>`. |
 
-## Events
-
-None.
-
 ## Slots
 
 | Name | Scope | Description |

package/.ai/ai_ref_AbTabs.md

@@ -1,23 +1,17 @@
 # AbTabs — AI Reference
 
-Parent container for tabbed interfaces. Pair with `AbTab` children. Supports both "content-switching" mode (default) and "router-link" mode for navigation-driven tabs.
-
-## Installation
-
-Globally registered by the plugin.
+Parent container for tabbed interfaces. Pair with `AbTab` children. Supports content-switching mode (default) and router-link mode for navigation-driven tabs.
 
 ## Usage
 
 ```vue
 <template>
-  <!-- Content-switching tabs -->
   <ab-tabs nav-class="nav-pills">
     <ab-tab title="Overview" selected>Overview content</ab-tab>
     <ab-tab title="Billing">Billing content</ab-tab>
     <ab-tab title="Security">Security content</ab-tab>
   </ab-tabs>
 
-  <!-- Router-link tabs -->
   <ab-tabs is-route-mode>
     <ab-tab title="Users" :to="{ name: 'users' }" />
     <ab-tab title="Teams" :to="{ name: 'teams' }" />
@@ -36,10 +30,6 @@ Globally registered by the plugin.
 | `tabClass` | `String` | `""` | Class on each individual tab link. |
 | `isRouteMode` | `Boolean` | `false` | When `true`, tab clicks perform router navigation. |
 
-## Events
-
-None.
-
 ## Slots
 
 | Name | Description |

package/.ai/ai_ref_AbToggle.md

@@ -2,29 +2,13 @@
 
 Accessible switch/toggle control. Supports title + description layout and custom `trueValue` / `falseValue` values (defaults to `"Y"` / `"N"`).
 
-## Installation
-
-Globally registered by the plugin.
-
 ## Usage
 
 ```vue
 <template>
-  <ab-toggle
-    v-model="settings.notifications"
-    name="notifications"
-    title="Email notifications"
-    description="Receive weekly digest emails."
-  />
+  <ab-toggle v-model="settings.notifications" name="notifications" title="Email notifications" description="Receive weekly digest emails." />
 
-  <!-- Boolean values -->
-  <ab-toggle
-    v-model="isActive"
-    name="active"
-    :true-value="true"
-    :false-value="false"
-    label="Active"
-  />
+  <ab-toggle v-model="isActive" name="active" :true-value="true" :false-value="false" label="Active" />
 </template>
 ```
 
@@ -33,7 +17,8 @@ Globally registered by the plugin.
 | Name | Type | Default | Description |
 | --- | --- | --- | --- |
 | `modelValue` | `any` | — | v-model binding. |
-| `label` | `String \| null` | `null` | Field label (above the toggle). |
+| `label` | `String \| null` | `null` | Field label. |
+| `variant` | `String` | `"inline"` | Layout variant (`"inline"` or `"column"`). |
 | `val` | `any` | `"N"` | Initial value when `modelValue` is empty. |
 | `name` | `String` | **required** | VeeValidate field name. |
 | `containerClass` | `String` | `"mb-3"` | Wrapper class. |
@@ -59,7 +44,3 @@ Globally registered by the plugin.
 | `description` | Custom description. |
 | `descriptionContainer` | Wraps the entire title + description block. |
 | `hints` | Custom hints. |
-
-## v-model
-
-Yes.

package/.ai/ai_ref_AbTooltip.md

@@ -1,21 +1,15 @@
 # AbTooltip — AI Reference
 
-Programmatic tooltip component. Complements the `v-tooltip` directive — use this when you need slot-driven rich content or interactive tooltips.
-
-## Installation
-
-Globally registered by the plugin.
+Programmatic tooltip component. Use when you need slot-driven rich content or interactive tooltips; use the `v-tooltip` directive for simple string hints.
 
 ## Usage
 
 ```vue
 <template>
-  <!-- Simple -->
   <ab-tooltip content="Save changes" placement="top">
     <ab-button class="btn-primary"><i class="bi bi-save"></i></ab-button>
   </ab-tooltip>
 
-  <!-- Rich content -->
   <ab-tooltip placement="bottom" interactive>
     <ab-button class="btn-outline-secondary">Info</ab-button>
     <template #content>
@@ -37,17 +31,9 @@ Globally registered by the plugin.
 | `arrow` | `Boolean` | `true` | Show the arrow pointer. |
 | `interactive` | `Boolean` | `false` | Allow hovering the tooltip without it hiding. |
 
-## Events
-
-None.
-
 ## Slots
 
 | Name | Description |
 | --- | --- |
 | `default` | Trigger element. |
 | `content` | Tooltip body (overrides the `content` prop). |
-
-## See also
-
-- `v-tooltip` directive for simple string hints (`<ab-button v-tooltip="'Hello'">`).

package/.ai/ai_ref_AbWizard.md

@@ -1,10 +1,6 @@
 # AbWizard — AI Reference
 
-Multi-step wizard container. Hosts `AbWizardStep` children, supports horizontal / vertical orientations, and multiple visual variants (including modal-rendered wizards).
-
-## Installation
-
-Globally registered by the plugin.
+Multi-step wizard container. Hosts `AbWizardStep` children, supports horizontal/vertical orientations, and multiple visual variants including modal-rendered wizards.
 
 ## Usage
 
@@ -17,27 +13,18 @@ Globally registered by the plugin.
     @finished="handleFinished"
     @step-changed="onStepChange"
   >
-    <ab-wizard-step title="Account" description="Basic info">
-      <!-- step content -->
-    </ab-wizard-step>
-
-    <ab-wizard-step title="Profile">
-      <!-- step content -->
-    </ab-wizard-step>
-
-    <ab-wizard-step title="Confirm">
-      <!-- step content -->
-    </ab-wizard-step>
+    <ab-wizard-step title="Account" description="Basic info"><!-- step content --></ab-wizard-step>
+    <ab-wizard-step title="Profile"><!-- step content --></ab-wizard-step>
+    <ab-wizard-step title="Confirm"><!-- step content --></ab-wizard-step>
   </ab-wizard>
 </template>
 
 <script setup>
 async function handleBeforeNext(currentStepIndex) {
-  // Return false to block navigation
-  return true;
+  return true; // return false to block navigation
 }
-function handleFinished() { /* all steps done */ }
-function onStepChange(newIndex) { /* active step changed */ }
+function handleFinished() {}
+function onStepChange(newIndex) {}
 </script>
 ```
 

package/.ai/ai_ref_AbWizardStep.md

@@ -2,19 +2,11 @@
 
 Single step inside an `AbWizard`. Declares its title, optional description, and an optional icon shown in the stepper.
 
-## Installation
-
-Globally registered by the plugin.
-
 ## Usage
 
 ```vue
 <ab-wizard>
-  <ab-wizard-step
-    title="Account"
-    description="Create your account"
-    :icon="UserIcon"
-  >
+  <ab-wizard-step title="Account" description="Create your account" :icon="UserIcon">
     <ab-input-field v-model="form.email" name="email" label="Email" rules="required|email" />
   </ab-wizard-step>
 
@@ -33,10 +25,6 @@ Globally registered by the plugin.
 | `icon` | `Object \| String \| Function` | `null` | Icon component, icon class string, or render function. |
 | `disableClose` | `Boolean` | `false` | Disable the close button while this step is active. |
 
-## Events
-
-None.
-
 ## Slots
 
 | Name | Description |

package/.ai/ai_ref_abEventBus.md

@@ -1,94 +1,66 @@
-# abEventBus (abEmitter)
-
-A lightweight, global event bus built on top of `tiny-emitter`. Provides a Vue 3 plugin for the `$eventBus` global property and a standalone `emitterObj` for non-component usage.
-
-## Installation
-
-```javascript
-npm install @vue3-appsbd-ui
-```
-
-## Usage
-
-### Standalone (Composable / Utilities)
-
-Import `emitterObj` directly for use outside of Vue components — utilities, stores, service modules, etc.
-
-```javascript
-import { emitterObj } from "@vue3-appsbd-ui";
-import { onUnmounted } from "vue";
-
-function handler(data) {
-  console.log("Received:", data);
-}
-
-// Subscribe
-emitterObj.$on("my-event", handler);
-
-// Emit
-emitterObj.$emit("my-event", { message: "Hello" });
-
-// Cleanup
-onUnmounted(() => {
-  emitterObj.$off("my-event", handler);
-});
-```
-
-### Plugin Usage (Options API or `this` context)
-
-Register the event bus as a Vue plugin to access `$eventBus` from any component via `this.$eventBus`.
-
-```javascript
-// main.js
-import { createApp } from "vue";
-import abEventBus from "@vue3-appsbd-ui/libraries/abEmitter";
-
-const app = createApp(App);
-app.use(abEventBus);
-app.mount("#app");
-```
-
-```javascript
-// Inside any Options-API component:
-export default {
-  mounted() {
-    this.$eventBus.$on("my-event", this.handleEvent);
-  },
-  beforeUnmount() {
-    this.$eventBus.$off("my-event", this.handleEvent);
-  },
-  methods: {
-    handleEvent(payload) {
-      console.log("Received:", payload);
-    }
-  }
-}
-```
-
-### One-Time Listener
-
-Use `$once` to subscribe to an event that automatically unsubscribes after the first invocation.
-
-```javascript
-emitterObj.$once("init-complete", () => {
-  console.log("Initialization done — this runs only once.");
-});
-```
-
-## API Reference
-
-### `emitterObj` Methods
-
-| Method | Signature | Description |
-|---|---|---|
-| `$on` | `(event: string, callback: Function)` | Subscribe to an event. |
-| `$once` | `(event: string, callback: Function)` | Subscribe to an event; auto-unsubscribe after first fire. |
-| `$off` | `(event: string, callback: Function)` | Unsubscribe from an event (pass the same handler reference). |
-| `$emit` | `(event: string, ...args: any[])` | Fire an event with optional payload arguments. |
-
-### Plugin (default export)
-
-| Property | Type | Description |
-|---|---|---|
-| `emitterObj` | `Object` | Direct reference to the emitter wrapper. |
-| `install(app)` | `Function` | Vue plugin install hook — registers `$eventBus` on `globalProperties`. |
+# abEventBus (abEmitter)
+
+Lightweight global event bus built on `tiny-emitter`. Provides a Vue 3 plugin for the `$eventBus` global property and a standalone `emitterObj` for non-component usage.
+
+## Usage
+
+### Standalone (Composable / Utilities)
+
+```javascript
+import { emitterObj } from "@vue3-appsbd-ui";
+import { onUnmounted } from "vue";
+
+function handler(data) { console.log("Received:", data); }
+
+emitterObj.$on("my-event", handler);
+emitterObj.$emit("my-event", { message: "Hello" });
+
+onUnmounted(() => {
+  emitterObj.$off("my-event", handler);
+});
+```
+
+### Plugin Usage (Options API)
+
+```javascript
+// main.js
+import abEventBus from "@vue3-appsbd-ui/libraries/abEmitter";
+app.use(abEventBus);
+```
+
+```javascript
+// Inside any Options-API component:
+export default {
+  mounted() { this.$eventBus.$on("my-event", this.handleEvent); },
+  beforeUnmount() { this.$eventBus.$off("my-event", this.handleEvent); },
+  methods: {
+    handleEvent(payload) { console.log("Received:", payload); }
+  }
+}
+```
+
+### One-Time Listener
+
+```javascript
+emitterObj.$once("init-complete", () => {
+  console.log("Runs only once.");
+});
+```
+
+## API Reference
+
+### `emitterObj` Methods
+
+| Method | Signature | Description |
+|---|---|---|
+| `$on` | `(event: string, callback: Function)` | Subscribe to an event. |
+| `$once` | `(event: string, callback: Function)` | Subscribe; auto-unsubscribe after first fire. |
+| `$off` | `(event: string, callback: Function)` | Unsubscribe (pass the same handler reference). |
+| `$emit` | `(event: string, ...args: any[])` | Fire an event with optional payload arguments. |
+
+### Plugin (default export)
+
+| Property | Type | Description |
+|---|---|---|
+| `emitterObj` | `Object` | Direct reference to the emitter wrapper. |
+| `install(app)` | `Function` | Vue plugin install hook — registers `$eventBus` on `globalProperties`. |