@appsbd/vue3-appsbd-ui 1.0.4 → 1.0.5

package/.ai/ai_ref_abEventBus.md

@@ -1,66 +1,66 @@
-# 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`. |
+# 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`. |

package/.ai/ai_ref_abRequestParam.md

@@ -1,40 +1,40 @@
-# abRequestParam (Library)
-
-Data-transfer classes for building structured API request parameters for paginated, sorted, and filtered data queries.
-
-## Usage
-
-```javascript
-import abRequestParam from "@vue3-appsbd-ui/libraries/abRequestParam";
-
-const params = new abRequestParam();
-params.limit = 25;
-params.page = 1;
-params.AddSortItem("created_at", "desc");
-params.AddSrcItem("status", "active", "eq");
-params.AddSrcItem("name", "John", "like");
-```
-
-## API Reference
-
-### `abRequestParam` Class
-
-**Properties**
-
-| Property | Type | Description |
-|---|---|---|
-| `data` | `any` | Arbitrary payload attached to the request. |
-| `limit` | `string\|number` | Number of records per page. |
-| `page` | `string\|number` | Current page number. |
-| `filter_prop` | `string` | Optional filter property identifier. |
-| `sort_by` | `abSortParam[]` | Array of sort descriptors. |
-| `src_by` | `abSrcParam[]` | Array of filter/search descriptors. |
-| `group_by` | `string[]` | Array of property names to group results by. |
-| `force` | `boolean` | Forces the server to bypass cache. |
-
-**Methods**
-
-| Method | Signature | Description |
-|---|---|---|
-| `AddSortItem(prop, ord)` | `Function` | Appends a sort rule. `ord` defaults to `'asc'`, accepts `'asc' \| 'desc'`. |
-| `AddSrcItem(prop, val, opr)` | `Function` | Appends a search rule. `opr` defaults to `'eq'`, accepts `'eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'like', 'in'`. |
+# abRequestParam (Library)
+
+Data-transfer classes for building structured API request parameters for paginated, sorted, and filtered data queries.
+
+## Usage
+
+```javascript
+import abRequestParam from "@vue3-appsbd-ui/libraries/abRequestParam";
+
+const params = new abRequestParam();
+params.limit = 25;
+params.page = 1;
+params.AddSortItem("created_at", "desc");
+params.AddSrcItem("status", "active", "eq");
+params.AddSrcItem("name", "John", "like");
+```
+
+## API Reference
+
+### `abRequestParam` Class
+
+**Properties**
+
+| Property | Type | Description |
+|---|---|---|
+| `data` | `any` | Arbitrary payload attached to the request. |
+| `limit` | `string\|number` | Number of records per page. |
+| `page` | `string\|number` | Current page number. |
+| `filter_prop` | `string` | Optional filter property identifier. |
+| `sort_by` | `abSortParam[]` | Array of sort descriptors. |
+| `src_by` | `abSrcParam[]` | Array of filter/search descriptors. |
+| `group_by` | `string[]` | Array of property names to group results by. |
+| `force` | `boolean` | Forces the server to bypass cache. |
+
+**Methods**
+
+| Method | Signature | Description |
+|---|---|---|
+| `AddSortItem(prop, ord)` | `Function` | Appends a sort rule. `ord` defaults to `'asc'`, accepts `'asc' \| 'desc'`. |
+| `AddSrcItem(prop, val, opr)` | `Function` | Appends a search rule. `opr` defaults to `'eq'`, accepts `'eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'like', 'in'`. |

package/.ai/ai_ref_abVeeRules.md

@@ -1,33 +1,33 @@
-# abVeeRules (Library)
-
-Pre-configured VeeValidate validation rules integrated with localization via `abTranslate`.
-
-## Usage
-
-```javascript
-import { abAllRules } from "@vue3-appsbd-ui/libraries/abVeeRules";
-import { defineRule } from "vee-validate";
-
-Object.keys(abAllRules).forEach(rule => {
-  defineRule(rule, abAllRules[rule]);
-});
-```
-
-## API Reference
-
-### `abAllRules` Object
-
-Validation functions conforming to VeeValidate's custom rule signature `(value, params, field)`.
-
-Included rules:
-- `required`: Returns translated `%{fld_name} is required`.
-- `numeric`: Returns translated `%{fld_name} should be numeric`.
-- `email`: Returns translated `%{fld_name} not a valid email address`.
-- `min`: Native min validation.
-- `min_value`: Returns translated `%{fld_name} should be more than X`.
-- `max`: Native max validation.
-- `max_value`: Returns translated `%{fld_name} should be less than X`.
-- `confirmed`: Checks password confirmation match.
-- `url`: Validates URL format.
-- `isUnique`: Custom stub for async uniqueness check.
-- `isValid`: Custom stub for async validity check.
+# abVeeRules (Library)
+
+Pre-configured VeeValidate validation rules integrated with localization via `abTranslate`.
+
+## Usage
+
+```javascript
+import { abAllRules } from "@vue3-appsbd-ui/libraries/abVeeRules";
+import { defineRule } from "vee-validate";
+
+Object.keys(abAllRules).forEach(rule => {
+  defineRule(rule, abAllRules[rule]);
+});
+```
+
+## API Reference
+
+### `abAllRules` Object
+
+Validation functions conforming to VeeValidate's custom rule signature `(value, params, field)`.
+
+Included rules:
+- `required`: Returns translated `%{fld_name} is required`.
+- `numeric`: Returns translated `%{fld_name} should be numeric`.
+- `email`: Returns translated `%{fld_name} not a valid email address`.
+- `min`: Native min validation.
+- `min_value`: Returns translated `%{fld_name} should be more than X`.
+- `max`: Native max validation.
+- `max_value`: Returns translated `%{fld_name} should be less than X`.
+- `confirmed`: Checks password confirmation match.
+- `url`: Validates URL format.
+- `isUnique`: Custom stub for async uniqueness check.
+- `isValid`: Custom stub for async validity check.

package/.ai/ai_ref_global_config.md

@@ -1,56 +1,57 @@
-# Global UI Configuration (`AppsbdUIConfigure`)
-
-Call `AppsbdUIConfigure` once during app initialization to set library-wide locale and formatting defaults. Components follow a strict "prop > global config > built-in default" resolution order.
-
-## Usage
-
-```javascript
-import { AppsbdUIConfigure } from "@vue3-appsbd-ui";
-
-const banglaDigits = ["০", "১", "২", "৩", "৪", "৫", "৬", "৭", "৮", "৯"];
-
-AppsbdUIConfigure({
-  monthNames: ["জানুয়ারি", "ফেব্রুয়ারি", "মার্চ", "এপ্রিল", "মে", "জুন", "জুলাই", "আগস্ট", "সেপ্টেম্বর", "অক্টোবর", "নভেম্বর", "ডিসেম্বর"],
-  monthNamesShort: ["জানু", "ফেব্রু", "মার্চ", "এপ্রি", "মে", "জুন", "জুলাই", "আগস্ট", "সেপ্টে", "অক্টো", "নভে", "ডিসে"],
-  dayNames: ["শনি", "রবি", "সোম", "মঙ্গল", "বুধ", "বৃহঃ", "শুক্র"],
-  formatDigit: (val) => String(val).replace(/\d/g, (d) => banglaDigits[d]),
-  is24Hour: false,
-  rangeSeparator: " থেকে ",
-  dateDataFormat: "YYYY-MM-DD",
-  dateDisplayFormat: "DD/MM/YYYY",
-  datetimeDataFormat: "YYYY-MM-DD HH:mm",
-  datetimeDisplayFormat: "DD/MM/YYYY hh:mm a",
-  timeDataFormat: "HH:mm",
-  timeDisplayFormat: "hh:mm a",
-});
-```
-
-## Options Reference
-
-| Property | Type | Default | Description |
-| :--- | :--- | :--- | :--- |
-| `monthNames` | `String[]` | English full names | Array of 12 full month names. |
-| `monthNamesShort` | `String[]` | English short names | Array of 12 short month names. |
-| `dayNames` | `String[]` | English 3-letter names | Array of 7 short day names (Sat-first). |
-| `formatDigit` | `Function` | `(val) => String(val)` | Digit formatter applied to `AbNumberField` (display-only) and `AbDateTimePicker`. |
-| `rangeSeparator` | `String` | `' ↔ '` | Separator for date ranges in `AbDateTimePicker`. |
-| `is24Hour` | `Boolean` | `false` | Whether to use 24-hour format in `AbDateTimePicker`. |
-| `dateDataFormat` | `String` | `'YYYY-MM-DD'` | Global format for date data. |
-| `dateDisplayFormat` | `String` | `'YYYY-MM-DD'` | Global format for date display. |
-| `datetimeDataFormat` | `String` | `'YYYY-MM-DD HH:mm'` | Global format for datetime data. |
-| `datetimeDisplayFormat` | `String` | `'YYYY-MM-DD HH:mm'` | Global format for datetime display. |
-| `timeDataFormat` | `String` | `'HH:mm'` | Global format for time data. |
-| `timeDisplayFormat` | `String` | `'HH:mm'` | Global format for time display. |
-| `inputContainerClass` | `String` | `'mb-3'` | Global class for input containers. |
-| `toastPosition` | `String` | `'top-right'` | Default toast position. |
-| `toastDesign` | `String` | `'default'` | Default toast design. |
-| `toastTimeout` | `Number` | `5000` | Default toast timeout in ms. |
-| `toastCloseButton` | `Boolean` | `true` | Default toast close button visibility. |
-| `toastPauseOnHover` | `Boolean` | `true` | Default toast pause on hover. |
-| `toastPauseOnFocusLoss` | `Boolean` | `true` | Default toast pause on focus loss. |
-| `toastShowProgress` | `Boolean` | `true` | Default toast show progress. |
-| `trueValue` | `any` | `'Y'` | Default true value for toggles/switches. |
-| `falseValue` | `any` | `'N'` | Default false value for toggles/switches. |
-| `size` | `String` | `'md'` | Global size for components. |
-| `iconPosition` | `String` | `'right'` | Global default icon position (`left`, `right`). |
-| `isModalBorder` | `Boolean` | `true` | Global default modal border. |
+# Global UI Configuration (`AppsbdUIConfigure`)
+
+Call `AppsbdUIConfigure` once during app initialization to set library-wide locale and formatting defaults. Components follow a strict "prop > global config > built-in default" resolution order.
+
+## Usage
+
+```javascript
+import { AppsbdUIConfigure } from "@vue3-appsbd-ui";
+
+const banglaDigits = ["০", "১", "২", "৩", "৪", "৫", "৬", "৭", "৮", "৯"];
+
+AppsbdUIConfigure({
+  monthNames: ["জানুয়ারি", "ফেব্রুয়ারি", "মার্চ", "এপ্রিল", "মে", "জুন", "জুলাই", "আগস্ট", "সেপ্টেম্বর", "অক্টোবর", "নভেম্বর", "ডিসেম্বর"],
+  monthNamesShort: ["জানু", "ফেব্রু", "মার্চ", "এপ্রি", "মে", "জুন", "জুলাই", "আগস্ট", "সেপ্টে", "অক্টো", "নভে", "ডিসে"],
+  dayNames: ["শনি", "রবি", "সোম", "মঙ্গল", "বুধ", "বৃহঃ", "শুক্র"],
+  formatDigit: (val) => String(val).replace(/\d/g, (d) => banglaDigits[d]),
+  is24Hour: false,
+  rangeSeparator: " থেকে ",
+  dateDataFormat: "YYYY-MM-DD",
+  dateDisplayFormat: "DD/MM/YYYY",
+  datetimeDataFormat: "YYYY-MM-DD HH:mm",
+  datetimeDisplayFormat: "DD/MM/YYYY hh:mm a",
+  timeDataFormat: "HH:mm",
+  timeDisplayFormat: "hh:mm a",
+});
+```
+
+## Options Reference
+
+| Property | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `monthNames` | `String[]` | English full names | Array of 12 full month names. |
+| `monthNamesShort` | `String[]` | English short names | Array of 12 short month names. |
+| `dayNames` | `String[]` | English 3-letter names | Array of 7 short day names (Sat-first). |
+| `formatDigit` | `Function` | `(val) => String(val)` | Digit formatter applied to `AbNumberField` (display-only) and `AbDateTimePicker`. |
+| `rangeSeparator` | `String` | `' ↔ '` | Separator for date ranges in `AbDateTimePicker`. |
+| `is24Hour` | `Boolean` | `false` | Whether to use 24-hour format in `AbDateTimePicker`. |
+| `dateDataFormat` | `String` | `'YYYY-MM-DD'` | Global format for date data. |
+| `dateDisplayFormat` | `String` | `'YYYY-MM-DD'` | Global format for date display. |
+| `datetimeDataFormat` | `String` | `'YYYY-MM-DD HH:mm'` | Global format for datetime data. |
+| `datetimeDisplayFormat` | `String` | `'YYYY-MM-DD HH:mm'` | Global format for datetime display. |
+| `timeDataFormat` | `String` | `'HH:mm'` | Global format for time data. |
+| `timeDisplayFormat` | `String` | `'HH:mm'` | Global format for time display. |
+| `inputContainerClass` | `String` | `'mb-3'` | Global class for input containers. |
+| `toastPosition` | `String` | `'top-right'` | Default toast position. |
+| `toastDesign` | `String` | `'default'` | Default toast design. |
+| `toastTimeout` | `Number` | `5000` | Default toast timeout in ms. |
+| `toastCloseButton` | `Boolean` | `true` | Default toast close button visibility. |
+| `toastPauseOnHover` | `Boolean` | `true` | Default toast pause on hover. |
+| `toastPauseOnFocusLoss` | `Boolean` | `true` | Default toast pause on focus loss. |
+| `toastShowProgress` | `Boolean` | `true` | Default toast show progress. |
+| `trueValue` | `any` | `'Y'` | Default true value for toggles/switches. |
+| `falseValue` | `any` | `'N'` | Default false value for toggles/switches. |
+| `size` | `String` | `'md'` | Global size for components. |
+| `input.iconPosition` | `String` | `'right'` | Global default icon position for input components (`left`, `right`). |
+| `button.iconPosition` | `String` | `'left'` | Global default icon position for buttons (`left`, `right`). |
+| `isModalBorder` | `Boolean` | `true` | Global default modal border. |

package/.ai/ai_ref_useAlert.md

@@ -1,45 +1,50 @@
-# useAlert (Composable)
-
-Provides a procedural API to trigger modal alerts, notifications, and confirmations using the global `$alert` instance.
-
-## Usage
-
-```html
-<script setup>
-import { useAlert } from "@vue3-appsbd-ui";
-
-const { alert } = useAlert();
-
-async function handleAction() {
-  const result = await alert({
-    type: "confirm",
-    title: "Delete item?",
-    message: "Are you sure you want to delete this?",
-    icon: "warning",
-    confirmText: "Yes, delete",
-    cancelText: "Cancel"
-  });
-
-  if (result) {
-    // User confirmed
-  }
-}
-</script>
-```
-
-## API Reference
-
-### `alert(options)`
-
-| Property | Type | Default | Description |
-|---|---|---|---|
-| `type` | `string` | `"alert"` | Variant: `"alert"`, `"confirm"`, or `"confirm-ajax"`. |
-| `title` | `string` | - | Headline text for the dialog. |
-| `message` | `string` | - | Detailed body text. |
-| `icon` | `string` | - | Status icon: `"success"`, `"error"`, `"warning"`, `"info"`, `"question"`. |
-| `variation` | `string` | `"default"` | Visual style: `"default"`, `"modern"`, `"minimal"`, `"top-color-bar"`. |
-| `size` | `string` | `"md"` | Width limit: `"sm"`, `"md"`, `"lg"`, `"xl"`, `"auto"`. |
-| `confirmText` | `string` | `"OK"` | Label for the primary accept button. |
-| `cancelText` | `string` | `"Cancel"` | Label for the cancel/decline button. |
-| `onConfirm` | `Function` | - | Async callback executed when accepting a `"confirm-ajax"` modal. |
-| `timer` | `number` | - | Auto-close timer in milliseconds (only for `"alert"` type). |
+# useAlert (Composable)
+
+Provides a procedural API to trigger modal alerts, notifications, and confirmations using the global `$alert` instance.
+
+## Usage
+
+```html
+<script setup>
+import { useAlert } from "@vue3-appsbd-ui";
+
+const { alert } = useAlert();
+
+async function handleAction() {
+  const result = await alert({
+    type: "confirm",
+    title: "Delete item?",
+    message: "Are you sure you want to delete this?",
+    icon: "warning",
+    confirmText: "Yes, delete",
+    cancelText: "Cancel"
+  });
+
+  if (result) {
+    // User confirmed
+  }
+}
+</script>
+```
+
+## API Reference
+
+### `alert(options)`
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `type` | `string` | `"alert"` | Variant: `"alert"`, `"confirm"`, or `"confirm-ajax"`. |
+| `title` | `string` | - | Headline text for the dialog. |
+| `message` | `string` | - | Detailed body text. |
+| `icon` | `string` | - | Status icon: `"success"`, `"error"`, `"warning"`, `"info"`, `"question"`. |
+| `variation` | `string` | `"default"` | Visual style: `"default"`, `"modern"`, `"minimal"`, `"top-color-bar"`. |
+| `size` | `string` | `"md"` | Width limit: `"sm"`, `"md"`, `"lg"`, `"xl"`, `"auto"`. |
+| `confirmText` | `string` | `"OK"` | Label for the primary accept button. |
+| `cancelText` | `string` | `"Cancel"` | Label for the cancel/decline button. |
+| `confirmBtnIcon` | `string \| Component` | `"save"` | Icon for the confirm button. Built-in names: `"save"`, `"cancel"`, `"delete"`, or Vue Component. |
+| `cancelBtnIcon` | `string \| Component` | `"cancel"` | Icon for the cancel button. Built-in names: `"save"`, `"cancel"`, `"delete"`, or Vue Component. |
+| `confirmBtnColor` | `string` | `"primary"` | Theme color for the confirm button (e.g., `"danger"`, `"success"`). |
+| `cancelBtnColor` | `string` | `"light"` | Theme color for the cancel button (e.g., `"secondary"`, `"light"`). |
+| `onConfirm` | `Function` | - | Async callback executed when accepting a `"confirm-ajax"` modal. |
+| `timer` | `number` | - | Auto-close timer in milliseconds (only for `"alert"` type). |
+| `responseMessage` | `string \| object` | `null` | Secondary message block. Can be a string or an object with string arrays for keys `error`, `info`, `debug`, `warning`. |

package/.ai/ai_ref_useFileValidator.md

@@ -1,31 +1,31 @@
-# useFileValidator (Composable)
-
-Provides file validation utilities to check extensions, MIME types, and file sizes. Automatically spawns error toasts on validation failure and returns a structured file object with icon metadata.
-
-## Usage
-
-```html
-<script setup>
-import { useFileValidator } from "@vue3-appsbd-ui";
-
-const { getFileInfo, getFileIconByExt } = useFileValidator();
-
-function handleFileUpload(event) {
-  const file = event.target.files[0];
-  if (!file) return;
-
-  const validatedFile = getFileInfo(file, 2.0);
-  if (validatedFile) {
-    // validatedFile.isImage
-    // validatedFile.fileIcon
-  }
-}
-</script>
-```
-
-## API Reference
-
-| Method | Signature | Description |
-|---|---|---|
-| `getFileInfo(file, sizeLimitMb)` | `Function` | Validates a `File` object against allowed MIME types and max size (`sizeLimitMb`, default `1.0`). If invalid, spawns a toast error and returns `null`. If valid, returns the `file` augmented with `isImage` and `fileIcon` properties. |
-| `getFileIconByExt(ext, type)` | `Function` | Returns `{ isImage: boolean, fileIcon: Component\|String }` based on file extension and MIME type. Uses `lucide-vue-next` icons for known formats (pdf, zip, doc, xls, ppt, mp4). |
+# useFileValidator (Composable)
+
+Provides file validation utilities to check extensions, MIME types, and file sizes. Automatically spawns error toasts on validation failure and returns a structured file object with icon metadata.
+
+## Usage
+
+```html
+<script setup>
+import { useFileValidator } from "@vue3-appsbd-ui";
+
+const { getFileInfo, getFileIconByExt } = useFileValidator();
+
+function handleFileUpload(event) {
+  const file = event.target.files[0];
+  if (!file) return;
+
+  const validatedFile = getFileInfo(file, 2.0);
+  if (validatedFile) {
+    // validatedFile.isImage
+    // validatedFile.fileIcon
+  }
+}
+</script>
+```
+
+## API Reference
+
+| Method | Signature | Description |
+|---|---|---|
+| `getFileInfo(file, sizeLimitMb)` | `Function` | Validates a `File` object against allowed MIME types and max size (`sizeLimitMb`, default `1.0`). If invalid, spawns a toast error and returns `null`. If valid, returns the `file` augmented with `isImage` and `fileIcon` properties. |
+| `getFileIconByExt(ext, type)` | `Function` | Returns `{ isImage: boolean, fileIcon: Component\|String }` based on file extension and MIME type. Uses `lucide-vue-next` icons for known formats (pdf, zip, doc, xls, ppt, mp4). |

package/.ai/ai_ref_useResponsive.md

@@ -1,41 +1,41 @@
-# useResponsive (Composable)
-
-Tracks browser viewport width in real-time with reactive helpers for responsive layout decisions, aligned with Bootstrap 5 breakpoints.
-
-## Usage
-
-```html
-<script setup>
-import { useResponsive } from "@vue3-appsbd-ui";
-
-const { ScreenWidth, ScreenType, isUptoTab } = useResponsive();
-// Or with custom tablet threshold:
-// const { isUptoTab } = useResponsive({ tabMaxWidth: 900 });
-</script>
-
-<template>
-  <div>
-    <p>Current Width: {{ ScreenWidth }}px — Breakpoint: {{ ScreenType }}</p>
-    <div v-if="isUptoTab">Mobile / Tablet Layout</div>
-    <div v-else>Desktop Layout</div>
-  </div>
-</template>
-```
-
-## API Reference
-
-### `useResponsive(options)`
-
-**Options**
-
-| Property | Type | Default | Description |
-|---|---|---|---|
-| `tabMaxWidth` | `number` | `0` | Custom max-width (px) to treat as "up-to tab". When `> 0`, screens at or below this width are considered tablet-sized regardless of breakpoint. |
-
-**Returned Properties**
-
-| Property | Type | Description |
-|---|---|---|
-| `ScreenWidth` | `ComputedRef<number>` | Raw viewport width in pixels. |
-| `ScreenType` | `ComputedRef<string>` | Current Bootstrap-style breakpoint (`'xs'`, `'sm'`, `'md'`, `'lg'`, `'xl'`, `'xxl'`). |
-| `isUptoTab` | `ComputedRef<boolean>` | `true` when viewport is tablet-sized or smaller (`xs`, `sm`, or `<=` `tabMaxWidth`). |
+# useResponsive (Composable)
+
+Tracks browser viewport width in real-time with reactive helpers for responsive layout decisions, aligned with Bootstrap 5 breakpoints.
+
+## Usage
+
+```html
+<script setup>
+import { useResponsive } from "@vue3-appsbd-ui";
+
+const { ScreenWidth, ScreenType, isUptoTab } = useResponsive();
+// Or with custom tablet threshold:
+// const { isUptoTab } = useResponsive({ tabMaxWidth: 900 });
+</script>
+
+<template>
+  <div>
+    <p>Current Width: {{ ScreenWidth }}px — Breakpoint: {{ ScreenType }}</p>
+    <div v-if="isUptoTab">Mobile / Tablet Layout</div>
+    <div v-else>Desktop Layout</div>
+  </div>
+</template>
+```
+
+## API Reference
+
+### `useResponsive(options)`
+
+**Options**
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `tabMaxWidth` | `number` | `0` | Custom max-width (px) to treat as "up-to tab". When `> 0`, screens at or below this width are considered tablet-sized regardless of breakpoint. |
+
+**Returned Properties**
+
+| Property | Type | Description |
+|---|---|---|
+| `ScreenWidth` | `ComputedRef<number>` | Raw viewport width in pixels. |
+| `ScreenType` | `ComputedRef<string>` | Current Bootstrap-style breakpoint (`'xs'`, `'sm'`, `'md'`, `'lg'`, `'xl'`, `'xxl'`). |
+| `isUptoTab` | `ComputedRef<boolean>` | `true` when viewport is tablet-sized or smaller (`xs`, `sm`, or `<=` `tabMaxWidth`). |