@pequity/squirrel 8.4.4 → 8.5.0

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
 };

package/dist/es/p-dropdown.js

@@ -23,6 +23,7 @@ const _sfc_main = defineComponent({
     },
     /**
      * Enables closing the dropdown with the Escape key.
+     * When true, pressing Escape will close the dropdown.
      */
     enableCloseOnEsc: {
       type: Boolean,
@@ -30,7 +31,7 @@ const _sfc_main = defineComponent({
     },
     /**
      * v-tooltip wraps the popper trigger with a div that has `display: inline-block` set by default.
-     * This prop is used to override the CSS style of that wrapper div
+     * This prop is used to override the CSS style of that wrapper div.
      */
     triggerStyle: {
       type: Object,

package/dist/es/p-icon.js

@@ -34,7 +34,8 @@ const P_ICON_ALIASES = {
   upload: "tdesign:upload",
   info: "streamline:information-circle",
   help: "ph:question",
-  search: "streamline:magnifying-glass-solid"
+  search: "streamline:magnifying-glass-solid",
+  warning: "ri:error-warning-line"
 };
 export {
   P_ICON_ALIASES

package/dist/es/p-input-search.js

@@ -10,10 +10,18 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-input-search",
   props: {
+    /**
+     * The search query value (v-model).
+     * Controls the input field content and visibility of the clear button.
+     */
     modelValue: {
       type: String,
       default: ""
     },
+    /**
+     * The size of the search input.
+     * Affects the overall dimensions and icon positioning.
+     */
     size: {
       type: String,
       default: "md",
@@ -21,6 +29,10 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
         return SIZES.includes(value);
       }
     },
+    /**
+     * Whether to show the enter key icon when the input is focused.
+     * Provides visual feedback that pressing enter will trigger a search.
+     */
     showEnterIcon: {
       type: Boolean,
       default: false
@@ -114,7 +126,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const PInputSearch = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-0e51ff56"]]);
+const PInputSearch = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-ce44730a"]]);
 export {
   PInputSearch as default
 };

package/dist/es/p-loading.js

@@ -9,7 +9,7 @@ const _hoisted_1$1 = {
   viewBox: "0 0 24 24"
 };
 function render(_ctx, _cache) {
-  return openBlock(), createElementBlock("svg", _hoisted_1$1, _cache[0] || (_cache[0] = [
+  return openBlock(), createElementBlock("svg", _hoisted_1$1, [..._cache[0] || (_cache[0] = [
     createElementVNode("path", {
       fill: "currentColor",
       d: "M12 1a11 11 0 1 0 11 11A11 11 0 0 0 12 1m0 19a8 8 0 1 1 8-8 8 8 0 0 1-8 8",
@@ -27,7 +27,7 @@ function render(_ctx, _cache) {
         values: "0 12 12;360 12 12"
       })
     ], -1)
-  ]));
+  ])]);
 }
 const PLoadingSpinner = { render };
 const _hoisted_1 = {
@@ -115,7 +115,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const pLoading = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-9ad56d4f"]]);
+const pLoading = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-7e116004"]]);
 export {
   pLoading as default
 };

package/dist/es/p-modal.js

@@ -25,82 +25,162 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-modal",
   props: {
+    /**
+     * Unique name for the modal when using the modal service.
+     * Used for programmatic control of the modal.
+     */
     name: {
       type: String,
       default: ""
     },
+    /**
+     * Title displayed in the modal header.
+     * Used for accessibility and visual identification.
+     */
     title: {
       type: String,
       default: ""
     },
+    /**
+     * Base z-index for the modal.
+     * Higher values ensure the modal appears above other content.
+     */
     baseZindex: {
       type: Number,
       default: 1051
     },
+    /**
+     * CSS classes for the backdrop element.
+     * Controls the appearance of the modal overlay.
+     */
     bgClass: {
       type: [String, Object, Array],
       default: "fixed bottom-0 left-0 right-0 top-0 bg-black/20"
     },
+    /**
+     * CSS classes for the modal wrapper element.
+     * Controls the positioning and layout of the modal container.
+     */
     wrapperClass: {
       type: [String, Object, Array],
       default: "fixed bottom-0 left-0 right-0 top-0 flex flex-col items-center justify-center overflow-y-auto overflow-x-hidden outline-none"
     },
+    /**
+     * Base CSS classes for the modal content.
+     * Controls the appearance of the modal dialog itself.
+     */
     modalBaseClass: {
       type: [String, Object, Array],
-      default: "pm relative flex flex-col rounded-2xl pb-6 cursor-default bg-surface shadow-xl"
+      default: "pm relative flex flex-col rounded-2xl cursor-default bg-surface shadow-xl"
     },
+    /**
+     * Additional CSS classes for the modal content.
+     * Merged with modalBaseClass for custom styling.
+     */
     modalClass: {
       type: [String, Object, Array],
       default: ""
     },
+    /**
+     * Inline styles for the modal content.
+     * Applied directly to the modal element.
+     */
     modalStyle: {
       type: [String, Object, Array],
       default: ""
     },
+    /**
+     * CSS class for the modal entrance animation.
+     * Controls how the modal appears.
+     */
     inClass: {
       type: String,
       default: "slideInTop"
     },
+    /**
+     * CSS class for the modal exit animation.
+     * Controls how the modal disappears.
+     */
     outClass: {
       type: String,
       default: "slideOutTop"
     },
+    /**
+     * CSS class for the backdrop entrance animation.
+     * Controls how the backdrop appears.
+     */
     bgInClass: {
       type: String,
       default: "fadeIn"
     },
+    /**
+     * CSS class for the backdrop exit animation.
+     * Controls how the backdrop disappears.
+     */
     bgOutClass: {
       type: String,
       default: "fadeOut"
     },
+    /**
+     * Target element to append the modal to.
+     * Usually 'body' for proper z-index stacking.
+     */
     appendTo: {
       type: String,
       default: "body"
     },
+    /**
+     * Whether the modal should be mounted immediately.
+     * Useful for modals that are always present in the DOM.
+     */
     live: {
       type: Boolean,
       default: false
     },
+    /**
+     * Whether the modal can be closed by user interaction.
+     * Controls close button visibility and backdrop click behavior.
+     */
     enableClose: {
       type: Boolean,
       default: true
     },
+    /**
+     * Controls the visibility of the modal (v-model).
+     * Supports two-way binding for modal 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 the modal content is disabled.
+     * Prevents user interaction with modal content.
+     */
     disabled: {
       type: Boolean,
       default: false
     },
+    /**
+     * Error message to display in the modal.
+     * Shows an error alert above the modal content.
+     */
     errorMsg: {
       type: String,
       default: ""
     },
+    /**
+     * Maximum width of the modal.
+     * Controls the responsive behavior of the modal.
+     */
     maxWidth: {
       type: String,
       default: "500px"
@@ -109,7 +189,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   emits: ["before-open", "opening", "opened", "before-close", "closing", "closed", "update:modelValue", "click:overlay"],
   setup(__props, { emit: __emit }) {
     useCssVars((_ctx) => ({
-      "29225c6f": __props.maxWidth
+      "a8364442": __props.maxWidth
     }));
     let animatingZIndex = 0;
     const emit = __emit;
@@ -309,49 +389,51 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
               createElementVNode("div", {
                 ref: "pm",
                 "data-pm-id": id.value,
-                class: normalizeClass([__props.modalBaseClass, __props.modalClass]),
+                class: normalizeClass([__props.modalBaseClass, __props.modalClass, { "pb-6": !_ctx.$slots["modal-wrapper"] }]),
                 style: normalizeStyle(__props.modalStyle)
               }, [
-                renderSlot(_ctx.$slots, "title-wrapper", {}, () => [
-                  createElementVNode("div", _hoisted_4, [
-                    __props.title ? (openBlock(), createElementBlock("h3", {
-                      key: 0,
-                      id: `${id.value}-title`,
-                      class: "mr-auto pt-4 text-xl font-semibold"
-                    }, toDisplayString(__props.title), 9, _hoisted_5)) : createCommentVNode("", true),
-                    createElementVNode("div", _hoisted_6, [
-                      createVNode(PCloseBtn, {
-                        disabled: __props.disabled,
-                        class: normalizeClass({ invisible: !__props.enableClose }),
-                        "aria-label": __props.closeLabel,
-                        onClick: withModifiers(close, ["prevent"])
-                      }, null, 8, ["disabled", "class", "aria-label"])
+                renderSlot(_ctx.$slots, "modal-wrapper", {}, () => [
+                  renderSlot(_ctx.$slots, "title-wrapper", {}, () => [
+                    createElementVNode("div", _hoisted_4, [
+                      __props.title ? (openBlock(), createElementBlock("h3", {
+                        key: 0,
+                        id: `${id.value}-title`,
+                        class: "mr-auto pt-4 text-xl font-semibold"
+                      }, toDisplayString(__props.title), 9, _hoisted_5)) : createCommentVNode("", true),
+                      createElementVNode("div", _hoisted_6, [
+                        createVNode(PCloseBtn, {
+                          disabled: __props.disabled,
+                          class: normalizeClass({ invisible: !__props.enableClose }),
+                          "aria-label": __props.closeLabel,
+                          onClick: withModifiers(close, ["prevent"])
+                        }, null, 8, ["disabled", "class", "aria-label"])
+                      ])
                     ])
-                  ])
-                ], true),
-                __props.errorMsg ? (openBlock(), createElementBlock("div", _hoisted_7, [
-                  createVNode(_sfc_main$1, { type: "error" }, {
-                    default: withCtx(() => [
-                      createTextVNode(toDisplayString(__props.errorMsg), 1)
-                    ]),
-                    _: 1
-                  })
-                ])) : createCommentVNode("", true),
-                renderSlot(_ctx.$slots, "content-wrapper", {}, () => [
-                  createElementVNode("div", {
-                    id: `${id.value}-content`,
-                    class: normalizeClass([
-                      "relative grow overflow-y-auto overflow-x-hidden px-8",
-                      { "pointer-events-none opacity-50": __props.disabled }
-                    ])
-                  }, [
-                    renderSlot(_ctx.$slots, "default", {}, void 0, true)
-                  ], 10, _hoisted_8)
-                ], true),
-                renderSlot(_ctx.$slots, "footer-wrapper", {}, () => [
-                  _ctx.$slots.footer ? (openBlock(), createElementBlock("div", _hoisted_9, [
-                    renderSlot(_ctx.$slots, "footer", {}, void 0, true)
-                  ])) : createCommentVNode("", true)
+                  ], true),
+                  __props.errorMsg ? (openBlock(), createElementBlock("div", _hoisted_7, [
+                    createVNode(_sfc_main$1, { type: "error" }, {
+                      default: withCtx(() => [
+                        createTextVNode(toDisplayString(__props.errorMsg), 1)
+                      ]),
+                      _: 1
+                    })
+                  ])) : createCommentVNode("", true),
+                  renderSlot(_ctx.$slots, "content-wrapper", {}, () => [
+                    createElementVNode("div", {
+                      id: `${id.value}-content`,
+                      class: normalizeClass([
+                        "relative grow overflow-y-auto overflow-x-hidden px-8",
+                        { "pointer-events-none opacity-50": __props.disabled }
+                      ])
+                    }, [
+                      renderSlot(_ctx.$slots, "default", {}, void 0, true)
+                    ], 10, _hoisted_8)
+                  ], true),
+                  renderSlot(_ctx.$slots, "footer-wrapper", {}, () => [
+                    _ctx.$slots.footer ? (openBlock(), createElementBlock("div", _hoisted_9, [
+                      renderSlot(_ctx.$slots, "footer", {}, void 0, true)
+                    ])) : createCommentVNode("", true)
+                  ], true)
                 ], true)
               ], 14, _hoisted_3)
             ], 46, _hoisted_2), [
@@ -364,7 +446,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const pModal = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-a511ac01"]]);
+const pModal = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-5c370dbc"]]);
 export {
   pModal as default
 };

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

@@ -14,26 +14,51 @@ const getOffsetValues = (container) => {
 const _sfc_main = defineComponent({
   name: "PSelectPill",
   props: {
+    /**
+     * The currently selected value (v-model).
+     * Should match one of the item values in the items array.
+     */
     modelValue: {
       type: [String, Number],
       default: ""
     },
+    /**
+     * Array of options to display as pills.
+     * Each option should have text, value, and optional subtext and disabled properties.
+     */
     items: {
       type: Array,
       default: () => []
     },
+    /**
+     * Property name to use as the item display text.
+     * Used for button label content.
+     */
     itemText: {
       type: String,
       default: "text"
     },
+    /**
+     * Property name to use as the item subtext.
+     * Displayed below the main text when provided.
+     */
     itemSubtext: {
       type: String,
       default: "subtext"
     },
+    /**
+     * Property name to use as the item value.
+     * Used for selection comparison and v-model binding.
+     */
     itemValue: {
       type: [String, Number],
       default: "value"
     },
+    /**
+     * The size of the pill buttons.
+     * Valid values: 'sm', 'md', 'lg'
+     * @values sm, md, lg
+     */
     size: {
       type: String,
       default: "md",
@@ -42,7 +67,13 @@ const _sfc_main = defineComponent({
       }
     }
   },
-  emits: ["update:modelValue"],
+  emits: {
+    /**
+     * Emitted when the selected value changes.
+     * @param {string | number} value - The new selected value
+     */
+    "update:modelValue": (value) => true
+  },
   data() {
     return {
       SIZES,
@@ -69,7 +100,10 @@ const _sfc_main = defineComponent({
   methods: {
     click(e, option) {
       if (!option.disabled) {
-        this.$emit("update:modelValue", option[this.itemValue]);
+        const value = option[this.itemValue];
+        if (typeof value === "string" || typeof value === "number") {
+          this.$emit("update:modelValue", value);
+        }
       }
     },
     setPillStyle() {

package/dist/es/p-skeleton-loader.js

@@ -17,6 +17,10 @@ const hexToRgb = (hex) => `${hex.match(/\w\w/g)?.map((x) => +`0x${x}`)}`;
 const _sfc_main = defineComponent({
   name: "PSkeletonLoader",
   props: {
+    /**
+     * The shape type of the skeleton loader.
+     * Determines the border radius and overall appearance.
+     */
     type: {
       type: String,
       default: LOADER_TYPES.rectangle,
@@ -24,14 +28,26 @@ const _sfc_main = defineComponent({
         return Object.values(LOADER_TYPES).includes(value);
       }
     },
+    /**
+     * The background CSS class for the skeleton loader.
+     * Controls the base color of the loading placeholder.
+     */
     bgClass: {
       type: String,
       default: "bg-p-gray-30"
     },
+    /**
+     * Additional CSS classes to apply to the loader.
+     * Allows for custom styling beyond the default type-based classes.
+     */
     cssClass: {
       type: String,
       default: ""
     },
+    /**
+     * The color of the shimmer effect in hex format.
+     * Controls the color of the animated shimmer overlay.
+     */
     shimmerColor: {
       type: String,
       default: SHIMMER_COLOR
@@ -65,7 +81,7 @@ function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
     renderSlot(_ctx.$slots, "default", {}, void 0, true)
   ], 2);
 }
-const PSkeletonLoader = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render], ["__scopeId", "data-v-3d77f34f"]]);
+const PSkeletonLoader = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render], ["__scopeId", "data-v-1beaf57b"]]);
 export {
   PSkeletonLoader as default
 };