@pequity/squirrel 8.4.4 → 8.5.0

package/dist/squirrel/components/p-file-upload/p-file-upload.vue.d.ts

@@ -1,10 +1,18 @@
 import { type FileUploadFile } from './p-file-upload.types';
 import { type PropType } from 'vue';
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The current file(s) value (v-model).
+     * Supports both single file and multiple files based on the multiple prop.
+     */
     modelValue: {
         type: PropType<FileUploadFile | FileUploadFile[]>;
         default: () => never[];
     };
+    /**
+     * Whether multiple files can be selected.
+     * When true, allows selecting multiple files at once.
+     */
     multiple: {
         type: BooleanConstructor;
         default: boolean;
@@ -17,39 +25,71 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: PropType<string[] | readonly string[]>;
         default: () => never[];
     };
+    /**
+     * Whether the file upload is disabled.
+     * Prevents user interaction when true.
+     */
     disabled: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Whether the file upload is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Error message to display below the file upload.
+     * When provided, the upload area will show error styling.
+     */
     errorMsg: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Text label for the file upload field.
+     * Displayed above the upload area.
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Maximum file size in bytes.
+     * Files exceeding this size will be rejected with an error message.
+     */
     maxSizeInBytes: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Maximum number of files that can be uploaded.
+     * Only applies when multiple is true.
+     */
     maxNumberOfFiles: {
         type: NumberConstructor;
         default: number;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (...args: any[]) => void;
-    "file-removed": (...args: any[]) => void;
-    "file-added": (...args: any[]) => void;
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: FileUploadFile | FileUploadFile[]) => any;
+    "file-removed": (file: FileUploadFile) => any;
+    "file-added": (files: FileUploadFile[]) => any;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The current file(s) value (v-model).
+     * Supports both single file and multiple files based on the multiple prop.
+     */
     modelValue: {
         type: PropType<FileUploadFile | FileUploadFile[]>;
         default: () => never[];
     };
+    /**
+     * Whether multiple files can be selected.
+     * When true, allows selecting multiple files at once.
+     */
     multiple: {
         type: BooleanConstructor;
         default: boolean;
@@ -62,34 +102,58 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: PropType<string[] | readonly string[]>;
         default: () => never[];
     };
+    /**
+     * Whether the file upload is disabled.
+     * Prevents user interaction when true.
+     */
     disabled: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Whether the file upload is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Error message to display below the file upload.
+     * When provided, the upload area will show error styling.
+     */
     errorMsg: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Text label for the file upload field.
+     * Displayed above the upload area.
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Maximum file size in bytes.
+     * Files exceeding this size will be rejected with an error message.
+     */
     maxSizeInBytes: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Maximum number of files that can be uploaded.
+     * Only applies when multiple is true.
+     */
     maxNumberOfFiles: {
         type: NumberConstructor;
         default: number;
     };
 }>> & Readonly<{
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
-    "onFile-removed"?: ((...args: any[]) => any) | undefined;
-    "onFile-added"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: FileUploadFile | FileUploadFile[]) => any) | undefined;
+    "onFile-removed"?: ((file: FileUploadFile) => any) | undefined;
+    "onFile-added"?: ((files: FileUploadFile[]) => any) | undefined;
 }>, {
     label: string;
     disabled: boolean;

package/dist/squirrel/components/p-icon/p-icon.types.d.ts

@@ -35,5 +35,6 @@ export declare const P_ICON_ALIASES: {
     readonly info: "streamline:information-circle";
     readonly help: "ph:question";
     readonly search: "streamline:magnifying-glass-solid";
+    readonly warning: "ri:error-warning-line";
 };
 export type PIconAlias = keyof typeof P_ICON_ALIASES;

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

@@ -2,7 +2,11 @@ import 'iconify-icon';
 import { type PIconAlias } from './p-icon.types';
 import { type IconifyIconProperties } from 'iconify-icon';
 interface Props extends /* @vue-ignore */ IconifyIconProperties {
+    /**
+     * The icon to display. Can be an icon alias or any valid Iconify icon name.
+     * Icon aliases provide consistent icon naming across the application.
+     */
     icon: PIconAlias | (string & {});
 }
-declare const _default: import("vue").DefineComponent<Props, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/squirrel/components/p-info-icon/p-info-icon.vue.d.ts

@@ -1,11 +1,18 @@
+type __VLS_Slots = {
+    /**
+     * Custom tooltip content - overrides the text prop.
+     * Use this slot for custom tooltip content instead of the text prop.
+     */
+    default?: () => unknown;
+};
 type Props = {
+    /**
+     * Text content for the tooltip.
+     * If not provided, you can use the default slot instead.
+     */
     text?: string | null;
 };
-declare var __VLS_12: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_12) => any;
-};
-declare const __VLS_component: import("vue").DefineComponent<Props, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     text: string | null;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

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

@@ -1,21 +1,41 @@
 import { type VueDatePickerProps } from '@vuepic/vue-datepicker';
+type __VLS_Slots = {
+    /**
+     * Custom label content - overrides the label prop.
+     * @param {string} label - The label text
+     * @param {string} label-classes - CSS classes for the label
+     */
+    label?: (props: {
+        label: string;
+        labelClasses: string;
+    }) => unknown;
+};
 type Props = {
+    /**
+     * Text label for the date picker field.
+     * If not provided, you can use the label slot instead.
+     */
     label?: string;
+    /**
+     * Error message to display below the date picker.
+     * When provided, the date picker will show error styling.
+     */
     errorMsg?: string;
+    /**
+     * Whether the date picker is required.
+     * Adds required attribute and 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 var __VLS_1: {
-    label: string;
-    labelClasses: string;
-};
-type __VLS_Slots = {} & {
-    label?: (props: typeof __VLS_1) => any;
-};
-declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_component: 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;

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

@@ -7,88 +7,153 @@ declare const INPUT_TYPES: {
 type InputTypeKeys = keyof typeof INPUT_TYPES;
 type InputType = (typeof INPUT_TYPES)[InputTypeKeys];
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The current value of the input (v-model).
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
         type: PropType<string | number | boolean | null>;
         default: string;
     };
+    /**
+     * The type of the input field.
+     * Valid values: 'text', 'password'
+     */
     type: {
         type: PropType<InputType>;
         default: string;
         validator(value: InputType): boolean;
     };
+    /**
+     * Text label for the input field.
+     * If not provided, you can use the label slot instead.
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Error message to display below the input.
+     * When provided, the input will show error styling.
+     */
     errorMsg: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Whether the input is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * The size of the input - affects padding, font size, and spacing.
+     * Valid values: 'sm', 'md', 'lg'
+     */
     size: {
         type: PropType<Size>;
         default: string;
         validator(value: Size): boolean;
     };
+    /**
+     * Whether the input has rounded corners.
+     * Applies rounded styling to the input field.
+     */
     rounded: {
         type: BooleanConstructor;
         default: boolean;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (...args: any[]) => void;
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The current value of the input (v-model).
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
         type: PropType<string | number | boolean | null>;
         default: string;
     };
+    /**
+     * The type of the input field.
+     * Valid values: 'text', 'password'
+     */
     type: {
         type: PropType<InputType>;
         default: string;
         validator(value: InputType): boolean;
     };
+    /**
+     * Text label for the input field.
+     * If not provided, you can use the label slot instead.
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Error message to display below the input.
+     * When provided, the input will show error styling.
+     */
     errorMsg: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Whether the input is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * The size of the input - affects padding, font size, and spacing.
+     * Valid values: 'sm', 'md', 'lg'
+     */
     size: {
         type: PropType<Size>;
         default: string;
         validator(value: Size): boolean;
     };
+    /**
+     * Whether the input has rounded corners.
+     * Applies rounded styling to the input field.
+     */
     rounded: {
         type: BooleanConstructor;
         default: boolean;
     };
 }>> & Readonly<{
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
-    type: string;
     size: "sm" | "md" | "lg";
+    type: string;
     label: string;
     required: boolean;
     modelValue: string | number | boolean | null;
     rounded: boolean;
     errorMsg: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
+    /**
+     * Custom label content - overrides the label prop.
+     * @param {string} label - The label text
+     * @param {string} label-classes - CSS classes for the label
+     */
     label?: (props: {
         label: string;
         labelClasses: string;
-    }) => any;
-} & {
-    prefix?: (props: {}) => any;
-} & {
-    suffix?: (props: {}) => any;
+    }) => unknown;
+    /**
+     * Content displayed before the input field.
+     */
+    prefix?: () => unknown;
+    /**
+     * Content displayed after the input field.
+     */
+    suffix?: () => unknown;
 }>;
 export default _default;
 type __VLS_WithSlots<T, S> = T & {

package/dist/squirrel/components/p-input-number/p-input-number.vue.d.ts

@@ -1,44 +1,83 @@
 import { type Size } from '../p-btn/p-btn.types';
 import { type PropType } from 'vue';
-declare var __VLS_1: {
-    label: string;
-    labelClasses: string;
-}, __VLS_7: {};
-type __VLS_Slots = {} & {
-    label?: (props: typeof __VLS_1) => any;
-} & {
-    prefix?: (props: typeof __VLS_7) => any;
+type __VLS_Slots = {
+    /**
+     * Custom label content - overrides the label prop.
+     * @param {string} label - The label text
+     * @param {string} label-classes - CSS classes for the label
+     */
+    label?: (props: {
+        label: string;
+        labelClasses: string;
+    }) => unknown;
+    /**
+     * Custom prefix content - overrides the prefixString prop.
+     * Use this slot for custom prefix content instead of the prefixString prop.
+     */
+    prefix?: () => unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The current numeric value of the input (v-model).
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
         type: PropType<number | string | null | undefined>;
         default: null;
     };
+    /**
+     * Text label for the input field.
+     * If not provided, you can use the label slot instead.
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Error message to display below the input.
+     * When provided, the input will show error styling.
+     */
     errorMsg: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Whether the input is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * The size of the input - affects padding, font size, and spacing.
+     * Valid values: 'sm', 'md', 'lg'
+     */
     size: {
         type: PropType<Size>;
         default: string;
         validator(value: Size): boolean;
     };
+    /**
+     * Whether to select all text when the input receives focus.
+     * Provides better UX for number input fields.
+     */
     selectOnClick: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Text for the info tooltip displayed next to the label.
+     * Uses PInfoIcon component for consistent tooltip styling.
+     */
     tooltipText: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * String to display as prefix in the input field.
+     * Can be overridden by the prefix slot for custom content.
+     */
     prefixString: {
         type: StringConstructor;
         default: string;
@@ -46,45 +85,77 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
 }>, {
     setValue: (number: number | null) => void;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    change: (...args: any[]) => void;
-    "update:modelValue": (...args: any[]) => void;
+    change: (value: number | null) => any;
+    "update:modelValue": (value: number | null) => any;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The current numeric value of the input (v-model).
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
         type: PropType<number | string | null | undefined>;
         default: null;
     };
+    /**
+     * Text label for the input field.
+     * If not provided, you can use the label slot instead.
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Error message to display below the input.
+     * When provided, the input will show error styling.
+     */
     errorMsg: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * Whether the input is required.
+     * Adds required attribute and visual indicator.
+     */
     required: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * The size of the input - affects padding, font size, and spacing.
+     * Valid values: 'sm', 'md', 'lg'
+     */
     size: {
         type: PropType<Size>;
         default: string;
         validator(value: Size): boolean;
     };
+    /**
+     * Whether to select all text when the input receives focus.
+     * Provides better UX for number input fields.
+     */
     selectOnClick: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * Text for the info tooltip displayed next to the label.
+     * Uses PInfoIcon component for consistent tooltip styling.
+     */
     tooltipText: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * String to display as prefix in the input field.
+     * Can be overridden by the prefix slot for custom content.
+     */
     prefixString: {
         type: StringConstructor;
         default: string;
     };
 }>> & Readonly<{
-    onChange?: ((...args: any[]) => any) | undefined;
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    onChange?: ((value: number | null) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
 }>, {
     size: "sm" | "md" | "lg";
     label: string;

package/dist/squirrel/components/p-input-percent/p-input-percent.vue.d.ts

@@ -1,27 +1,47 @@
 import { type Size } from '../p-btn/p-btn.types';
 import { type PropType } from 'vue';
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * The current value (v-model).
+     * Stored as a decimal (0.5 = 50%) but displayed as a percentage.
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
         type: PropType<number | string | null | undefined>;
         default: null;
     };
+    /**
+     * The size of the input field.
+     * Valid values: 'sm', 'md', 'lg'
+     * @values sm, md, lg
+     */
     size: {
         type: PropType<Size>;
         default: string;
     };
-}>, void, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (...args: any[]) => void;
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: number | null) => any;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * The current value (v-model).
+     * Stored as a decimal (0.5 = 50%) but displayed as a percentage.
+     * Supports two-way binding for form inputs.
+     */
     modelValue: {
         type: PropType<number | string | null | undefined>;
         default: null;
     };
+    /**
+     * The size of the input field.
+     * Valid values: 'sm', 'md', 'lg'
+     * @values sm, md, lg
+     */
     size: {
         type: PropType<Size>;
         default: string;
     };
 }>> & Readonly<{
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
 }>, {
     size: "sm" | "md" | "lg";
     modelValue: string | number | null | undefined;