@pequity/squirrel 8.4.3 → 8.4.5

package/dist/es/chunks/p-pagination.js

@@ -1,8 +1,7 @@
-import { defineComponent, computed, createElementBlock, openBlock, Fragment, createBlock, createCommentVNode, createElementVNode, normalizeClass, renderList, toDisplayString } from "vue";
+import { defineComponent, computed, createElementBlock, openBlock, Fragment, createBlock, createCommentVNode, createElementVNode, normalizeClass, createVNode, renderList, toDisplayString } from "vue";
+import { _ as _sfc_main$1 } from "./p-icon.js";
 import PSkeletonLoader from "../p-skeleton-loader.js";
 import { createPagingRange } from "../pagination.js";
-const _imports_0 = "data:image/svg+xml,%3csvg%20width='8'%20height='12'%20viewBox='0%200%208%2012'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cpath%20d='M0.25%205.99968C0.25%205.64968%200.4%205.34968%200.65%205.14968L6.25%200.249681C6.65%20-0.100319%207.2%20-0.0503187%207.55%200.349681C7.85%200.749681%207.85%201.29968%207.45%201.59968L2.55%205.89968C2.5%205.94968%202.5%205.99968%202.55%206.04968L7.45%2010.3497C7.85%2010.6997%207.9%2011.2497%207.55%2011.6497C7.2%2012.0497%206.65%2012.0997%206.25%2011.7497C6.25%2011.7497%206.25%2011.7497%206.2%2011.6997L0.65%206.84968C0.4%206.64968%200.25%206.29968%200.25%205.99968Z'%20fill='%23918da1'%20/%3e%3c/svg%3e";
-const _imports_1 = "data:image/svg+xml,%3csvg%20width='8'%20height='14'%20viewBox='0%200%208%2014'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cpath%20d='M7.75695%206.98136C7.75695%207.33136%207.60695%207.63136%207.35695%207.83136L1.75695%2012.7814C1.35695%2013.1314%200.756947%2013.0814%200.456947%2012.6814C0.156947%2012.2814%200.156947%2011.7314%200.556947%2011.3814L5.45695%207.08136C5.50695%207.03136%205.50695%206.98136%205.45695%206.88136L0.556947%202.58136C0.156947%202.23136%200.156947%201.63136%200.506947%201.28136C0.856947%200.931361%201.40695%200.881361%201.80695%201.18136L7.40695%206.08136C7.60695%206.33136%207.75695%206.63136%207.75695%206.98136Z'%20fill='%23918da1'%20/%3e%3c/svg%3e";
 const _hoisted_1 = {
   key: 1,
   class: "flex text-p-gray-40"
@@ -21,35 +20,40 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "p-pagination",
   props: {
     /**
-     * The current page.
+     * The current page number (v-model).
+     * Controls which page is visually active and navigable.
      */
     modelValue: {
       type: Number,
       default: null
     },
     /**
-     * The amount of data pagination should iterate through.
+     * The total amount of items to paginate through.
+     * Used to calculate the total number of pages.
      */
     count: {
       type: Number,
       default: 0
     },
     /**
-     * The amount of data to be displayed at 1 page. Used to calculate the length of pagination.
+     * The number of items to display per page.
+     * Used to calculate the total number of pages.
      */
     pageSize: {
       type: Number,
       default: 10
     },
     /**
-     * The amount of pages to be displayed before and after the current page.
+     * The number of pages to show before and after the current page.
+     * Controls the range of page numbers displayed around the current page.
      */
     pageOffset: {
       type: Number,
       default: 2
     },
     /**
-     * Whether the pagination is loading.
+     * Whether the pagination is in a loading state.
+     * When true, shows a skeleton loader instead of the pagination controls.
      */
     loading: {
       type: Boolean,
@@ -82,9 +86,12 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             class: normalizeClass([BTN_CLASS, Number(__props.modelValue) <= 1 ? ARROW_INACTIVE_CLASS : ARROW_ACTIVE_CLASS]),
             "aria-label": "go to the previous page",
             onClick: _cache[0] || (_cache[0] = ($event) => setPage(Number(__props.modelValue) - 1))
-          }, _cache[2] || (_cache[2] = [
-            createElementVNode("img", { src: _imports_0 }, null, -1)
-          ]), 2),
+          }, [
+            createVNode(_sfc_main$1, {
+              icon: "chevron-left",
+              width: "24px"
+            })
+          ], 2),
           (openBlock(true), createElementBlock(Fragment, null, renderList(pages.value, (page, index) => {
             return openBlock(), createElementBlock("div", {
               key: index,
@@ -106,9 +113,12 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             class: normalizeClass([BTN_CLASS, __props.modelValue === pageCount.value ? ARROW_INACTIVE_CLASS : ARROW_ACTIVE_CLASS]),
             "aria-label": "go to the next page",
             onClick: _cache[1] || (_cache[1] = ($event) => setPage(Number(__props.modelValue) + 1))
-          }, _cache[3] || (_cache[3] = [
-            createElementVNode("img", { src: _imports_1 }, null, -1)
-          ]), 2)
+          }, [
+            createVNode(_sfc_main$1, {
+              icon: "chevron-right",
+              width: "24px"
+            })
+          ], 2)
         ])) : createCommentVNode("", true)
       ], 64);
     };

package/dist/es/chunks/p-select-btn.js

@@ -7,7 +7,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-select-btn",
   props: {
-    modelValue: { default: null },
+    modelValue: { type: [String, Number, Boolean, null, Array], default: null },
     items: { default: () => [] },
     itemValue: { default: "value" },
     itemText: { default: "text" },
@@ -55,6 +55,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           return index !== -1;
         }
       }
+      return false;
     };
     return (_ctx, _cache) => {
       const _directive_tooltip = resolveDirective("tooltip");

package/dist/es/chunks/p-select.js

@@ -12,26 +12,51 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-select",
   props: {
+    /**
+     * The current selected value (v-model).
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
       type: [String, Number, Boolean, null],
       default: ""
     },
+    /**
+     * Array of objects representing the select options.
+     * Each object should have properties specified by itemText and itemValue.
+     * @example [{ text: 'Option 1', value: 1 }, { text: 'Option 2', value: 2 }]
+     */
     items: {
       type: Array,
       default: () => []
     },
+    /**
+     * Text label for the select field.
+     * If not provided, you can use the label slot instead.
+     */
     label: {
       type: String,
       default: ""
     },
+    /**
+     * Error message to display below the select.
+     * When provided, the select will show error styling.
+     */
     errorMsg: {
       type: String,
       default: ""
     },
+    /**
+     * Whether the select is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
       type: Boolean,
       default: false
     },
+    /**
+     * The size of the select - affects padding, font size, and spacing.
+     * Valid values: 'sm', 'md', 'lg'
+     */
     size: {
       type: String,
       default: "md",
@@ -39,10 +64,18 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
         return SIZES.includes(value);
       }
     },
+    /**
+     * Property name to use as the display text for each option.
+     * Defaults to 'text' - each item should have this property.
+     */
     itemText: {
       type: String,
       default: "text"
     },
+    /**
+     * Property name to use as the value for each option.
+     * Defaults to 'value' - each item should have this property.
+     */
     itemValue: {
       type: [String, Number, Boolean, null],
       default: "value"

package/dist/es/chunks/p-table-loader.js

@@ -14,22 +14,42 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-table-loader",
   props: {
+    /**
+     * The number of rows to display in the skeleton table.
+     * Controls the vertical size of the loading placeholder.
+     */
     rows: {
       type: [Number, String],
       default: 4
     },
+    /**
+     * The number of columns to display in the skeleton table.
+     * Controls the horizontal size of the loading placeholder.
+     */
     columns: {
       type: [Number, String],
       default: 6
     },
+    /**
+     * CSS classes to apply to each table cell.
+     * Allows customization of cell padding and styling.
+     */
     tdClasses: {
       type: String,
       default: "px-4 py-5"
     },
+    /**
+     * CSS classes to apply to the skeleton loader within each cell.
+     * Controls the height and appearance of individual skeleton elements.
+     */
     tdSkeletonClasses: {
       type: String,
       default: "h-5"
     },
+    /**
+     * Whether to display subheaders in the table header.
+     * Adds an additional row below the main header for more complex table structures.
+     */
     withSubheader: {
       type: Boolean,
       default: false

package/dist/es/chunks/p-tabs.js

@@ -7,14 +7,26 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-tabs",
   props: {
+    /**
+     * Array of tab objects to display.
+     * Each tab should have a name, title, and optional icon and route.
+     */
     tabs: {
       type: Array,
       required: true
     },
+    /**
+     * The currently active tab name.
+     * Controls which tab is visually highlighted.
+     */
     activeTab: {
       type: String,
       required: true
     },
+    /**
+     * Left padding for the tabs container in pixels.
+     * Useful for aligning tabs with other content.
+     */
     tabsLeftPadding: {
       type: Number,
       default: 0

package/dist/es/chunks/p-textarea.js

@@ -10,22 +10,42 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-textarea",
   props: {
+    /**
+     * The current value of the textarea (v-model).
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
       type: [String, Number, null],
       default: ""
     },
+    /**
+     * Text label for the textarea field.
+     * If not provided, you can use the label slot instead.
+     */
     label: {
       type: String,
       default: ""
     },
+    /**
+     * Error message to display below the textarea.
+     * When provided, the textarea will show error styling.
+     */
     errorMsg: {
       type: String,
       default: ""
     },
+    /**
+     * Whether the textarea is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
       type: Boolean,
       default: false
     },
+    /**
+     * The size of the textarea - affects padding, font size, and spacing.
+     * Valid values: 'sm', 'md', 'lg'
+     */
     size: {
       type: String,
       default: "md",

package/dist/es/index.js

@@ -93,10 +93,18 @@ const _sfc_main$3 = /* @__PURE__ */ defineComponent({
   },
   __name: "p-file-upload",
   props: {
+    /**
+     * The current file(s) value (v-model).
+     * Supports both single file and multiple files based on the multiple prop.
+     */
     modelValue: {
       type: [Object, Array],
       default: () => []
     },
+    /**
+     * Whether multiple files can be selected.
+     * When true, allows selecting multiple files at once.
+     */
     multiple: {
       type: Boolean,
       default: false
@@ -109,27 +117,51 @@ const _sfc_main$3 = /* @__PURE__ */ defineComponent({
       type: Array,
       default: () => []
     },
+    /**
+     * Whether the file upload is disabled.
+     * Prevents user interaction when true.
+     */
     disabled: {
       type: Boolean,
       default: false
     },
+    /**
+     * Whether the file upload is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
       type: Boolean,
       default: false
     },
+    /**
+     * Error message to display below the file upload.
+     * When provided, the upload area will show error styling.
+     */
     errorMsg: {
       type: String,
       default: ""
     },
+    /**
+     * Text label for the file upload field.
+     * Displayed above the upload area.
+     */
     label: {
       type: String,
       default: ""
     },
+    /**
+     * Maximum file size in bytes.
+     * Files exceeding this size will be rejected with an error message.
+     */
     maxSizeInBytes: {
       type: Number,
       default: 256 * 1e3
       // 256 KB
     },
+    /**
+     * Maximum number of files that can be uploaded.
+     * Only applies when multiple is true.
+     */
     maxNumberOfFiles: {
       type: Number,
       default: 10
@@ -202,7 +234,7 @@ const _sfc_main$3 = /* @__PURE__ */ defineComponent({
       if (!f2) {
         return;
       }
-      const validatedFiles = props.fileTypes ? validateFiles(Array.from(f2)) : f2;
+      const validatedFiles = props.fileTypes ? validateFiles(Array.from(f2)) : Array.from(f2);
       files.value = props.multiple ? [...files.value, ...validatedFiles] : validatedFiles;
       emit("file-added", validatedFiles);
     };
@@ -264,7 +296,7 @@ const _sfc_main$3 = /* @__PURE__ */ defineComponent({
                 class: "text-p-gray-50"
               }),
               createElementVNode("div", _hoisted_4$3, [
-                _cache[3] || (_cache[3] = createTextVNode(" Drag or ")),
+                _cache[3] || (_cache[3] = createTextVNode(" Drag or ", -1)),
                 createElementVNode("span", _hoisted_5$3, "select " + toDisplayString(fileWord.value), 1)
               ])
             ])) : (openBlock(), createElementBlock("div", _hoisted_6$3, [
@@ -905,7 +937,7 @@ const _sfc_main$1 = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const pTable = /* @__PURE__ */ _export_sfc(_sfc_main$1, [["__scopeId", "data-v-ab73279a"]]);
+const pTable = /* @__PURE__ */ _export_sfc(_sfc_main$1, [["__scopeId", "data-v-b51c1939"]]);
 const _imports_0 = "data:image/svg+xml,%3csvg%20width='16'%20height='16'%20viewBox='0%200%2016%2016'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cg%20clip-path='url(%23clip0_1019_75838)'%3e%3cpath%20d='M11.6533%203.37331L8.47329%200.18664C8.41131%200.124154%208.33758%200.074558%208.25634%200.0407122C8.1751%200.00686641%208.08796%20-0.0105591%207.99995%20-0.0105591C7.91194%20-0.0105591%207.82481%200.00686641%207.74357%200.0407122C7.66233%200.074558%207.58859%200.124154%207.52662%200.18664L4.34662%203.37331C4.253%203.46615%204.18902%203.58468%204.16277%203.71388C4.13651%203.84309%204.14916%203.97719%204.19911%204.09921C4.24906%204.22123%204.33407%204.3257%204.44339%204.39941C4.55271%204.47312%204.68144%204.51275%204.81329%204.51331H6.81329C6.83571%204.51054%206.85846%204.51235%206.88016%204.51865C6.90186%204.52494%206.92205%204.53559%206.93951%204.54993C6.95697%204.56427%206.97133%204.58201%206.98172%204.60207C6.99211%204.62214%206.99832%204.6441%206.99995%204.66664V14.9933C6.99995%2015.2585%207.10531%2015.5129%207.29285%2015.7004C7.48038%2015.888%207.73474%2015.9933%207.99995%2015.9933C8.26517%2015.9933%208.51952%2015.888%208.70706%2015.7004C8.8946%2015.5129%208.99995%2015.2585%208.99995%2014.9933V4.66664C8.99995%204.62244%209.01751%204.58004%209.04877%204.54879C9.08002%204.51753%209.12242%204.49997%209.16662%204.49997H11.1666C11.2985%204.49942%2011.4272%204.45978%2011.5365%204.38608C11.6458%204.31237%2011.7308%204.2079%2011.7808%204.08587C11.8307%203.96385%2011.8434%203.82976%2011.8171%203.70055C11.7909%203.57134%2011.7269%203.45282%2011.6333%203.35997L11.6533%203.37331Z'%20fill='%23424E6E'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_1019_75838'%3e%3crect%20width='16'%20height='16'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e";
 const _imports_1 = "data:image/svg+xml,%3csvg%20width='16'%20height='16'%20viewBox='0%200%2016%2016'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cg%20clip-path='url(%23clip0_1019_80096)'%3e%3cpath%20d='M11.6533%203.37331L8.47329%200.18664C8.41131%200.124154%208.33758%200.074558%208.25634%200.0407122C8.1751%200.00686641%208.08796%20-0.0105591%207.99995%20-0.0105591C7.91194%20-0.0105591%207.82481%200.00686641%207.74357%200.0407122C7.66233%200.074558%207.58859%200.124154%207.52662%200.18664L4.34662%203.37331C4.253%203.46615%204.18902%203.58468%204.16277%203.71388C4.13651%203.84309%204.14916%203.97719%204.19911%204.09921C4.24906%204.22123%204.33407%204.3257%204.44339%204.39941C4.55271%204.47312%204.68144%204.51275%204.81329%204.51331H6.81329C6.83571%204.51054%206.85846%204.51235%206.88016%204.51865C6.90186%204.52494%206.92205%204.53559%206.93951%204.54993C6.95697%204.56427%206.97133%204.58201%206.98172%204.60207C6.99211%204.62214%206.99832%204.6441%206.99995%204.66664V14.9933C6.99995%2015.2585%207.10531%2015.5129%207.29285%2015.7004C7.48038%2015.888%207.73474%2015.9933%207.99995%2015.9933C8.26517%2015.9933%208.51952%2015.888%208.70706%2015.7004C8.8946%2015.5129%208.99995%2015.2585%208.99995%2014.9933V4.66664C8.99995%204.62244%209.01751%204.58004%209.04877%204.54879C9.08002%204.51753%209.12242%204.49997%209.16662%204.49997H11.1666C11.2985%204.49942%2011.4272%204.45978%2011.5365%204.38608C11.6458%204.31237%2011.7308%204.2079%2011.7808%204.08587C11.8307%203.96385%2011.8434%203.82976%2011.8171%203.70055C11.7909%203.57134%2011.7269%203.45282%2011.6333%203.35997L11.6533%203.37331Z'%20fill='%23323CEB'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_1019_80096'%3e%3crect%20width='16'%20height='16'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e";
 const _imports_2 = "data:image/svg+xml,%3csvg%20width='16'%20height='16'%20viewBox='0%200%2016%2016'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cg%20clip-path='url(%23clip0_1019_75842)'%3e%3cpath%20d='M11.8%2011.8933C11.75%2011.7716%2011.665%2011.6674%2011.5559%2011.5938C11.4467%2011.5203%2011.3183%2011.4807%2011.1866%2011.48H9.18664C9.16473%2011.4828%209.14248%2011.4812%209.12119%2011.4753C9.0999%2011.4694%209.07999%2011.4594%209.06262%2011.4457C9.04525%2011.4321%209.03077%2011.4151%209.02001%2011.3958C9.00926%2011.3765%209.00245%2011.3553%208.99997%2011.3333V1C8.99997%200.734784%208.89462%200.48043%208.70708%200.292893C8.51954%200.105357%208.26519%200%207.99997%200C7.73476%200%207.4804%200.105357%207.29287%200.292893C7.10533%200.48043%206.99997%200.734784%206.99997%201V11.3333C6.99997%2011.3775%206.98241%2011.4199%206.95116%2011.4512C6.9199%2011.4824%206.87751%2011.5%206.83331%2011.5H4.83331C4.70146%2011.5006%204.57273%2011.5402%204.46341%2011.6139C4.35409%2011.6876%204.26908%2011.7921%204.21913%2011.9141C4.16918%2012.0361%204.15653%2012.1702%204.18279%2012.2994C4.20904%2012.4286%204.27302%2012.5472%204.36664%2012.64L7.54664%2015.8267C7.60861%2015.8892%207.68235%2015.9387%207.76359%2015.9726C7.84483%2016.0064%207.93196%2016.0239%208.01997%2016.0239C8.10798%2016.0239%208.19512%2016.0064%208.27636%2015.9726C8.3576%2015.9387%208.43133%2015.8892%208.49331%2015.8267L11.6733%2012.64C11.7677%2012.5431%2011.8303%2012.4198%2011.853%2012.2864C11.8756%2012.153%2011.8571%2012.0159%2011.8%2011.8933Z'%20fill='%23424E6E'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_1019_75842'%3e%3crect%20width='16'%20height='16'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e";
@@ -934,6 +966,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-table-sort",
   props: {
+    /**
+     * The current sorting state (v-model).
+     * Valid values: 'asc', 'desc', 'no-sorting'
+     * Controls which sort option is visually active.
+     */
     modelValue: {
       type: String,
       default: SORTING_TYPES.NO_SORTING,

package/dist/es/p-checkbox.js

@@ -12,10 +12,17 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-checkbox",
   props: {
+    /**
+     * The checked state of the checkbox (v-model)
+     */
     modelValue: {
       type: Boolean,
       default: false
     },
+    /**
+     * Text label for the checkbox
+     * Ignored if using the label slot
+     */
     label: {
       type: String,
       default: ""
@@ -58,7 +65,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const pCheckbox = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-b394a2f0"]]);
+const pCheckbox = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-c0f571ea"]]);
 export {
   pCheckbox as default
 };

package/dist/es/p-chips.js

@@ -4,15 +4,31 @@ import { _ as _export_sfc } from "./chunks/_plugin-vue_export-helper.js";
 const _sfc_main = defineComponent({
   name: "PChips",
   props: {
+    /**
+     * Array of items to display as chips.
+     * Can be strings or objects with a text property.
+     */
     items: {
       type: Array,
       default: () => []
     },
+    /**
+     * Property name to use as the item display text.
+     * Used when items are objects to extract the text value.
+     */
     itemText: {
       type: String,
       default: "text"
     }
   },
+  /**
+   * Emitted when a chip is clicked.
+   * @param {any} item - The clicked item
+   */
+  /**
+   * Emitted when the overflow indicator is clicked.
+   * Indicates that there are more chips than can be displayed.
+   */
   emits: ["click:chip", "click:overflow"],
   data() {
     return {
@@ -102,7 +118,7 @@ function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
     ], 512)
   ], 512);
 }
-const pChips = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render], ["__scopeId", "data-v-57d9f151"]]);
+const pChips = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render], ["__scopeId", "data-v-a6ae49f4"]]);
 export {
   pChips as default
 };

package/dist/es/p-close-btn.js

@@ -6,6 +6,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-close-btn",
   props: {
+    /**
+     * The visual variant of the close button.
+     * Controls the background color and hover effects.
+     * Valid values: 'transparent', 'gray', 'dark'
+     */
     variant: {
       type: String,
       default: "transparent"
@@ -34,7 +39,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const PCloseBtn = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-2002dcc8"]]);
+const PCloseBtn = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-8232fb9d"]]);
 export {
   PCloseBtn as default
 };

package/dist/es/p-drawer.js

@@ -9,66 +9,132 @@ const __default__ = defineComponent({
     PCloseBtn
   },
   props: {
+    /**
+     * Target element to append the drawer to.
+     * Usually 'body' for proper z-index stacking.
+     */
     appendTo: {
       type: String,
       default: "body"
     },
+    /**
+     * Title displayed in the drawer header.
+     * Used for accessibility and visual identification.
+     */
     title: {
       type: String,
       default: ""
     },
+    /**
+     * Whether the drawer content is disabled.
+     * Prevents user interaction with drawer content.
+     */
     disabled: {
       type: Boolean,
       default: false
     },
+    /**
+     * Error message to display in the drawer.
+     * Shows an error alert above the drawer content.
+     */
     errorMsg: {
       type: String,
       default: ""
     },
+    /**
+     * The position of the drawer on the screen.
+     * Valid values: 'left', 'right'
+     * @values left, right
+     */
     position: {
       type: String,
       default: "right"
     },
+    /**
+     * Base z-index for the drawer.
+     * Higher values ensure the drawer appears above other content.
+     */
     zIndex: {
       type: Number,
       default: 900
     },
+    /**
+     * Inline styles for the drawer element.
+     * Applied directly to the drawer element.
+     */
     drawerStyle: {
       type: Object,
       default: () => ({})
     },
+    /**
+     * CSS class for the drawer container.
+     * Controls the base styling of the drawer.
+     */
     drawerClass: {
       type: String,
       default: "drawer"
     },
+    /**
+     * CSS class for the drawer entrance animation.
+     * Overrides the default position-based animation.
+     */
     inClass: {
       type: String,
       default: ""
     },
+    /**
+     * CSS class for the drawer exit animation.
+     * Overrides the default position-based animation.
+     */
     outClass: {
       type: String,
       default: ""
     },
+    /**
+     * Whether the drawer should be mounted immediately.
+     * Useful for drawers that are always present in the DOM.
+     */
     live: {
       type: Boolean,
       default: false
     },
+    /**
+     * Controls the visibility of the drawer (v-model).
+     * Supports two-way binding for drawer state.
+     */
     modelValue: {
       type: Boolean,
       default: false
     },
+    /**
+     * Accessibility label for the close button.
+     * Used by screen readers for better accessibility.
+     */
     closeLabel: {
       type: String,
       default: "Close"
     },
+    /**
+     * Whether to show the backdrop behind the drawer.
+     * When true, displays a semi-transparent overlay.
+     */
     showBackdrop: {
       type: Boolean,
       default: false
     },
+    /**
+     * Whether the drawer can be closed by user interaction.
+     * Controls close button visibility and backdrop click behavior.
+     */
     enableClose: {
       type: Boolean,
       default: true
     },
+    /**
+     * Width of the drawer.
+     * Must be a valid CSS width value ending with 'px'.
+     * @values 460px, 600px, 800px, etc.
+     */
     width: {
       type: String,
       default: "460px",
@@ -77,6 +143,28 @@ const __default__ = defineComponent({
       }
     }
   },
+  /**
+   * Emitted before the drawer starts opening.
+   */
+  /**
+   * Emitted when the drawer is opening (animation in progress).
+   */
+  /**
+   * Emitted when the drawer has finished opening.
+   */
+  /**
+   * Emitted before the drawer starts closing.
+   */
+  /**
+   * Emitted when the drawer is closing (animation in progress).
+   */
+  /**
+   * Emitted when the drawer has finished closing.
+   */
+  /**
+   * Emitted when the drawer visibility changes (v-model).
+   * @param {boolean} value - The new visibility state
+   */
   emits: ["update:modelValue", "before-open", "opening", "opened", "before-close", "closing", "closed"],
   data() {
     return {
@@ -148,7 +236,7 @@ const __default__ = defineComponent({
 });
 const __injectCSSVars__ = () => {
   useCssVars((_ctx) => ({
-    "508822d0": _ctx.width
+    "0ae27020": _ctx.width
   }));
 };
 const __setup__ = __default__.setup;
@@ -265,7 +353,7 @@ function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
     }, 8, ["enter-active-class", "leave-active-class", "onBeforeEnter", "onEnter", "onAfterEnter", "onBeforeLeave", "onLeave", "onAfterLeave"])
   ], 8, ["to"])) : createCommentVNode("", true);
 }
-const pDrawer = /* @__PURE__ */ _export_sfc(__default__, [["render", _sfc_render], ["__scopeId", "data-v-95d3e794"]]);
+const pDrawer = /* @__PURE__ */ _export_sfc(__default__, [["render", _sfc_render], ["__scopeId", "data-v-b08a9ced"]]);
 export {
   pDrawer as default
 };