@pequity/squirrel 8.4.4 → 8.5.0

package/dist/es/p-table-filter-icon.js

@@ -7,6 +7,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-table-filter-icon",
   props: {
+    /**
+     * Whether the filter icon is active (filtered state).
+     */
     active: {
       type: Boolean,
       default: false
@@ -20,7 +23,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const PTableFilterIcon = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-84864117"]]);
+const PTableFilterIcon = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-5c047926"]]);
 export {
   PTableFilterIcon as default
 };

package/dist/es/p-table-header-cell.js

@@ -2,7 +2,7 @@ import { _ as _sfc_main$1 } from "./chunks/p-info-icon.js";
 import PTableFilterIcon from "./p-table-filter-icon.js";
 import { defineComponent, resolveComponent, createElementBlock, openBlock, createElementVNode, createCommentVNode, createVNode, normalizeStyle, normalizeClass, toDisplayString, createBlock } from "vue";
 import { _ as _export_sfc } from "./chunks/_plugin-vue_export-helper.js";
-const DEFAULT_CLASSES = `text-xs leading-5 font-semibold truncate shrink`;
+const DEFAULT_CLASSES = `text-xs leading-5 font-semibold line-clamp-2 break-words hyphens-auto whitespace-normal max-h-10 shrink`;
 const _sfc_main = defineComponent({
   name: "PTableHeaderCell",
   components: {
@@ -10,31 +10,60 @@ const _sfc_main = defineComponent({
     PInfoIcon: _sfc_main$1
   },
   props: {
+    /**
+     * The text content to display in the header cell.
+     * Also used as the title attribute for accessibility.
+     */
     text: {
       type: String,
       default: ""
     },
+    /**
+     * CSS classes to apply to the text element.
+     * Can be a string, object, or array for flexible styling.
+     */
     textClass: {
       type: [String, Object, Array],
       default: "text-left"
     },
+    /**
+     * Whether the filter icon is in an active state.
+     * Controls the visual appearance of the filter icon and text color.
+     */
     filterActive: {
       type: Boolean,
       default: false
     },
+    /**
+     * Whether to show the filter icon.
+     * When false, the filter icon is hidden regardless of other states.
+     */
     showFilterIcon: {
       type: Boolean,
       default: false
     },
+    /**
+     * Tooltip text to display when hovering over the info icon.
+     * When provided, shows an info icon with the tooltip content.
+     */
     tooltipText: {
       type: String,
       default: ""
     },
+    /**
+     * Custom text color to apply to the header text.
+     * Overrides the default text color when provided.
+     */
     textColor: {
       type: String,
       default: ""
     }
   },
+  /**
+   * Emitted when the filter icon is clicked.
+   * @param {Event} event - The click event
+   * @param {boolean} filterActive - The current filter active state
+   */
   emits: ["click-filter-icon"],
   data() {
     return {
@@ -68,7 +97,8 @@ function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
     createElementVNode("div", {
       class: normalizeClass([_ctx.DEFAULT_CLASSES, _ctx.textClass, _ctx.textColorClass, { "mr-auto": !_ctx.tooltipText }]),
       style: normalizeStyle(_ctx.style),
-      title: _ctx.text
+      title: _ctx.text,
+      "data-p-table-header-text": ""
     }, toDisplayString(_ctx.text), 15, _hoisted_2),
     _ctx.tooltipText ? (openBlock(), createElementBlock("div", _hoisted_3, [
       _ctx.tooltipText ? (openBlock(), createBlock(_component_PInfoIcon, {

package/dist/es/p-table-td.js

@@ -81,7 +81,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const PTableTd = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-c9978e26"]]);
+const PTableTd = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-9a0c95c7"]]);
 export {
   PTableTd as default
 };

package/dist/es/p-table.js

@@ -3,7 +3,9 @@ const isFirstColFixedInjectionKey = Symbol("isFirstColFixed");
 const isLastColFixedInjectionKey = Symbol("isLastColFixed");
 const isColsResizableInjectionKey = Symbol("isColsResizable");
 const MIN_WIDTH_COL_RESIZE = 80;
+const HEADER_CELL_ONE_LINE_HEIGHT = 20;
 export {
+  HEADER_CELL_ONE_LINE_HEIGHT,
   MIN_WIDTH_COL_RESIZE,
   colsInjectionKey,
   isColsResizableInjectionKey,

package/dist/es/p-toggle.js

@@ -34,22 +34,43 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   __name: "p-toggle",
   props: {
+    /**
+     * The current toggle state (v-model).
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
       type: Boolean,
       default: false
     },
+    /**
+     * Text label for the toggle switch.
+     * If not provided, you can use the label slot instead.
+     */
     label: {
       type: String,
       default: ""
     },
+    /**
+     * Error message to display below the toggle.
+     * When provided, the toggle will show error styling.
+     */
     errorMsg: {
       type: String,
       default: ""
     },
+    /**
+     * Whether the toggle is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
       type: Boolean,
       default: false
     },
+    /**
+     * The size of the toggle switch.
+     * Valid values: 'sm', 'md', 'lg'
+     * @values sm, md, lg
+     */
     size: {
       type: String,
       default: "md",
@@ -122,7 +143,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const pToggle = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-c544a8a9"]]);
+const pToggle = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-af725f56"]]);
 export {
   pToggle as default
 };

package/dist/es/usePTableHeaderWrap.js

@@ -0,0 +1,38 @@
+import { HEADER_CELL_ONE_LINE_HEIGHT } from "./p-table.js";
+import { ref, onMounted, onBeforeUnmount } from "vue";
+const usePTableHeaderWrap = (theadRef) => {
+  let headerObserver = null;
+  const hasWrap = ref(false);
+  const setupObserver = () => {
+    if (!theadRef.value) return;
+    headerObserver = new ResizeObserver(() => {
+      if (theadRef.value) {
+        const textDivs = theadRef.value.querySelectorAll("[data-p-table-header-text]");
+        for (const div of textDivs) {
+          if (div.offsetHeight > HEADER_CELL_ONE_LINE_HEIGHT) {
+            hasWrap.value = true;
+            return;
+          }
+        }
+        hasWrap.value = false;
+      }
+    });
+    headerObserver.observe(theadRef.value);
+  };
+  const cleanupObserver = () => {
+    if (headerObserver) {
+      headerObserver.disconnect();
+      headerObserver = null;
+    }
+  };
+  onMounted(() => {
+    setupObserver();
+  });
+  onBeforeUnmount(() => {
+    cleanupObserver();
+  });
+  return { hasWrap };
+};
+export {
+  usePTableHeaderWrap
+};

package/dist/squirrel/components/p-action-bar/p-action-bar.vue.d.ts

@@ -1,14 +1,26 @@
 import { type PActionBarAction } from './p-action-bar.types';
 type Props = {
+    /**
+     * Controls visibility of the action bar.
+     * When true, the action bar is displayed at the bottom of the screen.
+     */
     show: boolean;
+    /**
+     * The main text displayed in the action bar.
+     * Provides context for the available actions.
+     */
     label: string;
+    /**
+     * Array of action objects to be rendered as buttons or dropdowns.
+     * Each action can have an icon, label, and optional sub-actions.
+     */
     actions: PActionBarAction[];
 };
-declare const _default: import("vue").DefineComponent<Props, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "click:dismiss": () => any;
-    "click:action": (args_0: string | undefined) => any;
+    "click:action": (name: string | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     "onClick:dismiss"?: (() => any) | undefined;
-    "onClick:action"?: ((args_0: string | undefined) => any) | undefined;
+    "onClick:action"?: ((name: string | undefined) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/squirrel/components/p-alert/p-alert.vue.d.ts

@@ -18,23 +18,36 @@ declare const ALERT_TYPES: {
     };
 };
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The type of the alert which determines its appearance and icon
+     */
     type: {
         type: PropType<keyof typeof ALERT_TYPES>;
         default: string;
         validator(value: keyof typeof ALERT_TYPES): boolean;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The type of the alert which determines its appearance and icon
+     */
     type: {
         type: PropType<keyof typeof ALERT_TYPES>;
         default: string;
         validator(value: keyof typeof ALERT_TYPES): boolean;
     };
 }>> & Readonly<{}>, {
-    type: "info" | "error" | "success" | "warning";
+    type: "info" | "warning" | "error" | "success";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
-    icon?: (props: {}) => any;
-} & {
-    default?: (props: {}) => any;
+    /**
+     * Custom icon slot - use this to override the default alert type icon.
+     * If not provided, a default icon will be shown based on the alert type.
+     */
+    icon?: () => unknown;
+    /**
+     * Default slot - the main content of the alert message.
+     * This should contain the text or HTML to display in the alert.
+     */
+    default?: () => unknown;
 }>;
 export default _default;
 type __VLS_WithSlots<T, S> = T & {

package/dist/squirrel/components/p-avatar/p-avatar.vue.d.ts

@@ -1,46 +1,81 @@
 import { type PropType } from 'vue';
+/**
+ * Available avatar shapes
+ */
 declare const SHAPES: readonly ["rectangle", "circle"];
 type Shape = (typeof SHAPES)[number];
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The shape of the avatar
+     */
     shape: {
         type: PropType<Shape>;
         default: string;
         validator: (value: Shape) => boolean;
     };
+    /**
+     * URL of the image to display
+     */
     imageSrc: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Text to display when image is not available
+     * Also used as the alt text for the image
+     */
     label: {
         type: StringConstructor;
         required: true;
     };
+    /**
+     * Additional CSS classes to apply to the image
+     */
     imageClass: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Additional CSS classes to apply to the label container
+     */
     labelClass: {
         type: StringConstructor;
         default: string;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The shape of the avatar
+     */
     shape: {
         type: PropType<Shape>;
         default: string;
         validator: (value: Shape) => boolean;
     };
+    /**
+     * URL of the image to display
+     */
     imageSrc: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Text to display when image is not available
+     * Also used as the alt text for the image
+     */
     label: {
         type: StringConstructor;
         required: true;
     };
+    /**
+     * Additional CSS classes to apply to the image
+     */
     imageClass: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Additional CSS classes to apply to the label container
+     */
     labelClass: {
         type: StringConstructor;
         default: string;

package/dist/squirrel/components/p-btn/p-btn.vue.d.ts

@@ -3,6 +3,9 @@ import PIcon from '../p-icon/p-icon.vue';
 import { type VariantProps } from 'tailwind-variants';
 import { type PropType } from 'vue';
 import { type RouteLocationRaw } from 'vue-router';
+/**
+ * Type for the icon prop
+ */
 type Icon = InstanceType<typeof PIcon>['$props']['icon'];
 declare const btn: import("tailwind-variants").TVReturnType<{
     readonly type: {
@@ -212,6 +215,9 @@ declare const btn: import("tailwind-variants").TVReturnType<{
     readonly loader: "absolute bottom-0 left-0 right-0 top-0 flex items-center justify-center font-medium";
     readonly icon: "shrink-0";
 }, undefined, unknown, unknown, undefined>>;
+/**
+ * Native button types (HTML attribute values)
+ */
 declare const BUTTON_NATIVE_TYPES: readonly ["button", "submit", "reset"];
 type ButtonNativeType = (typeof BUTTON_NATIVE_TYPES)[number];
 type ButtonType = NonNullable<VariantProps<typeof btn>['type']>;
@@ -269,11 +275,14 @@ declare const _default: __VLS_WithSlots<import("vue").DefineComponent<import("vu
         type: PropType<Icon>;
         default: string;
     };
+    /**
+     * The icon to display on the right side of the button
+     */
     iconRight: {
         type: PropType<Icon>;
         default: string;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     /**
      * The button style e.g primary, secondary, primary-outline, secondary-outline, error, success, primary-link
      */
@@ -327,21 +336,28 @@ declare const _default: __VLS_WithSlots<import("vue").DefineComponent<import("vu
         type: PropType<Icon>;
         default: string;
     };
+    /**
+     * The icon to display on the right side of the button
+     */
     iconRight: {
         type: PropType<Icon>;
         default: string;
     };
 }>> & Readonly<{}>, {
-    icon: "delete" | "edit" | "send" | "settings" | "empty" | "chevron-left" | "chevron-right" | "chevron-up" | "chevron-down" | "ok-circle" | "cancel-circle" | "ok" | "cancel" | "ok-bold" | "cancel-bold" | "archive" | "lock" | "drag-horizontal" | "email" | "location" | "calendar" | "save" | "copy" | "plus" | "add" | "more" | "filters" | "bar-chart" | "list" | "formula" | "refresh" | "download" | "upload" | "info" | "help" | "search" | (string & {});
-    type: ButtonType;
+    icon: "delete" | "edit" | "send" | "settings" | "empty" | "chevron-left" | "chevron-right" | "chevron-up" | "chevron-down" | "ok-circle" | "cancel-circle" | "ok" | "cancel" | "ok-bold" | "cancel-bold" | "archive" | "lock" | "drag-horizontal" | "email" | "location" | "calendar" | "save" | "copy" | "plus" | "add" | "more" | "filters" | "bar-chart" | "list" | "formula" | "refresh" | "download" | "upload" | "info" | "help" | "search" | "warning" | (string & {});
     size: "sm" | "md" | "lg";
+    type: ButtonType;
     nativeType: "button" | "submit" | "reset";
     loading: boolean;
     selected: boolean;
     to: string | import("vue-router").RouteLocationAsRelativeGeneric | import("vue-router").RouteLocationAsPathGeneric;
-    iconRight: "delete" | "edit" | "send" | "settings" | "empty" | "chevron-left" | "chevron-right" | "chevron-up" | "chevron-down" | "ok-circle" | "cancel-circle" | "ok" | "cancel" | "ok-bold" | "cancel-bold" | "archive" | "lock" | "drag-horizontal" | "email" | "location" | "calendar" | "save" | "copy" | "plus" | "add" | "more" | "filters" | "bar-chart" | "list" | "formula" | "refresh" | "download" | "upload" | "info" | "help" | "search" | (string & {});
+    iconRight: "delete" | "edit" | "send" | "settings" | "empty" | "chevron-left" | "chevron-right" | "chevron-up" | "chevron-down" | "ok-circle" | "cancel-circle" | "ok" | "cancel" | "ok-bold" | "cancel-bold" | "archive" | "lock" | "drag-horizontal" | "email" | "location" | "calendar" | "save" | "copy" | "plus" | "add" | "more" | "filters" | "bar-chart" | "list" | "formula" | "refresh" | "download" | "upload" | "info" | "help" | "search" | "warning" | (string & {});
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
-    default?: (props: {}) => any;
+    /**
+     * Default slot - the content of the button.
+     * This should contain the text or HTML to display inside the button.
+     */
+    default?: () => void;
 }>;
 export default _default;
 type __VLS_WithSlots<T, S> = T & {

package/dist/squirrel/components/p-card/p-card.vue.d.ts

@@ -1,17 +1,30 @@
-declare var __VLS_1: {
-    titleClass: "text-xl font-medium leading-none text-p-purple-60";
-}, __VLS_3: {};
-type __VLS_Slots = {} & {
-    title?: (props: typeof __VLS_1) => any;
-} & {
-    default?: (props: typeof __VLS_3) => any;
+type __VLS_Slots = {
+    /**
+     * Title slot - custom content for the card title.
+     * Receives the titleClass prop for consistent styling.
+     */
+    title?: (props: {
+        titleClass: string;
+    }) => void;
+    /**
+     * Default slot - the main content of the card.
+     */
+    default?: () => void;
 };
 declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The title of the card - displayed at the top
+     * If not provided, you can use the title slot instead
+     */
     title: {
         type: StringConstructor;
         default: string;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The title of the card - displayed at the top
+     * If not provided, you can use the title slot instead
+     */
     title: {
         type: StringConstructor;
         default: string;

package/dist/squirrel/components/p-checkbox/p-checkbox.vue.d.ts

@@ -1,31 +1,49 @@
-declare var __VLS_1: {}, __VLS_3: {};
-type __VLS_Slots = {} & {
-    'label-before'?: (props: typeof __VLS_1) => any;
-} & {
-    label?: (props: typeof __VLS_3) => any;
+type __VLS_Slots = {
+    /**
+     * Content displayed before the checkbox
+     */
+    'label-before'?: () => void;
+    /**
+     * Custom label content - overrides the label prop
+     */
+    label?: () => void;
 };
 declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The checked state of the checkbox (v-model)
+     */
     modelValue: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Text label for the checkbox
+     * Ignored if using the label slot
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (...args: any[]) => void;
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (val: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The checked state of the checkbox (v-model)
+     */
     modelValue: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Text label for the checkbox
+     * Ignored if using the label slot
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
 }>> & Readonly<{
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((val: boolean) => any) | undefined;
 }>, {
     label: string;
     modelValue: boolean;

package/dist/squirrel/components/p-chips/p-chips.vue.d.ts

@@ -1,8 +1,24 @@
+/**
+ * A chips component that displays a horizontal list of items with overflow handling.
+ * Automatically calculates how many chips can fit in the available space and shows
+ * an overflow indicator when there are more items than can be displayed.
+ * Supports custom item text properties and before/after slot content.
+ *
+ * @displayName PChips
+ */
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * Array of items to display as chips.
+     * Can be strings or objects with a text property.
+     */
     items: {
         type: ArrayConstructor;
         default: () => never[];
     };
+    /**
+     * Property name to use as the item display text.
+     * Used when items are objects to extract the text value.
+     */
     itemText: {
         type: StringConstructor;
         default: string;
@@ -13,10 +29,18 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     resizeFilterChips(): void;
     getItemText<T>(item: T): "" | (T & string) | (T & object)[keyof T];
 }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("click:chip" | "click:overflow")[], "click:chip" | "click:overflow", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * Array of items to display as chips.
+     * Can be strings or objects with a text property.
+     */
     items: {
         type: ArrayConstructor;
         default: () => never[];
     };
+    /**
+     * Property name to use as the item display text.
+     * Used when items are objects to extract the text value.
+     */
     itemText: {
         type: StringConstructor;
         default: string;

package/dist/squirrel/components/p-close-btn/p-close-btn.vue.d.ts

@@ -1,11 +1,24 @@
 import { type PropType } from 'vue';
+/**
+ * Available visual variants for the close button.
+ */
 type Variant = 'transparent' | 'gray' | 'dark';
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The visual variant of the close button.
+     * Controls the background color and hover effects.
+     * Valid values: 'transparent', 'gray', 'dark'
+     */
     variant: {
         type: PropType<Variant>;
         default: string;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The visual variant of the close button.
+     * Controls the background color and hover effects.
+     * Valid values: 'transparent', 'gray', 'dark'
+     */
     variant: {
         type: PropType<Variant>;
         default: string;

package/dist/squirrel/components/p-date-picker/p-date-picker.vue.d.ts

@@ -1,14 +1,30 @@
 import { type VueDatePickerProps } from '@vuepic/vue-datepicker';
 type Props = {
+    /**
+     * Text label for the date picker field.
+     * Passed to the underlying PInput component.
+     */
     label?: string;
+    /**
+     * Error message to display below the date picker.
+     * Passed to the underlying PInput component and shows error styling.
+     */
     errorMsg?: string;
+    /**
+     * Whether the date picker is required.
+     * Passed to the underlying PInput component and adds visual indicator.
+     */
     required?: boolean;
 } & VueDatePickerProps;
 type __VLS_Props = Props;
 type __VLS_PublicProps = __VLS_Props & {
+    /**
+     * The selected date value (v-model).
+     * Supports two-way binding for form inputs.
+     */
     modelValue?: Date | string | null;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string | Date | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | Date | null) => any) | undefined;