bitboss-ui 2.1.113 → 2.1.115

package/dist/components/BaseDatePicker/types.d.ts

@@ -0,0 +1,100 @@
+import { HTMLAttributes } from 'vue';
+export type BaseDatePickerProps = {
+    /**
+     * Disables the component.
+     */
+    disabled?: boolean;
+    /**
+     * Defines the first day of the week with `0` meaning Sunday and `6` meaning Saturday.
+     * @defaultValue `1`
+     */
+    firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * If true the date will have a format YYYY-MM-DD instead of the default ISO string.
+     */
+    floating?: boolean;
+    /**
+     * The identifier of the component.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Shows or hides the header of the component.
+     */
+    header?: boolean;
+    /**
+     * Maximum selectable date.
+     */
+    max?: string;
+    /**
+     * Minimum selectable date.
+     */
+    min?: string;
+    /**
+     * Used by v-model. Can be null, a single string, or an array of strings based on whether a range or single date is needed.
+     */
+    modelValue: string | string[] | null;
+    /**
+     * Allows the selection of multiple items.
+     */
+    multiple?: boolean;
+    /**
+     * Selects a range of dates between two dates. It selects all of the days between start and end.
+     */
+    range?: boolean;
+    /**
+     * Sets the input in a readonly state.
+     */
+    readonly?: boolean;
+    /**
+     * Function that accepts a date string and returns a boolean. Returning `false` means the date cannot be selected.
+     */
+    selectable?: (date: string) => boolean;
+};
+export type BaseDatePickerEvents = {
+    /**
+     * Emitted whenever the selected date(s) change via calendar interaction.
+     * Payload is `null` for cleared values, a single ISO string for single-date mode,
+     * or an array of ISO strings for multiple/range mode.
+     */
+    (event: 'update:modelValue', value: string | string[] | null): void;
+};
+/**
+ * Props exposed by day slots (keyed by date string, e.g. `"2024-03-15"`, or `"day"` as a fallback for all days).
+ */
+export type BaseDatePickerDaySlotProps = {
+    /**
+     * Whether this day is the first in a selected range.
+     */
+    first: boolean;
+    /**
+     * Whether this day falls within the highlighted range.
+     */
+    highlighted: boolean;
+    /**
+     * The underlying date value for this day.
+     */
+    item: any;
+    /**
+     * The display label for this day (day number as string).
+     */
+    label: string;
+    /**
+     * Whether this day is the last in a selected range.
+     */
+    last: boolean;
+    /**
+     * Whether this day falls between the first and last of a selected range.
+     */
+    middle: boolean;
+    /**
+     * Whether this day is currently selected.
+     */
+    selected: boolean;
+};
+export type BaseDatePickerSlots = {
+    /**
+     * Named slot for a specific calendar day, identified by the formatted date string (e.g. `"2024-03-15"`),
+     * or `"day"` as a fallback for all days. Rendered alongside the default day button.
+     */
+    [key: string]: (props: BaseDatePickerDaySlotProps) => any;
+};

package/dist/components/BaseDatePickerInput/BaseDatePickerInput.vue.d.ts

@@ -1,224 +1,7 @@
-import { HTMLAttributes, InputHTMLAttributes } from 'vue';
-import { IconType } from '../../types/Icon';
-/**
- * Props for the low-level date-picker input that couples a segmented text field with a popover calendar.
- * Accepts ISO strings (or `YYYY-MM-DD` when `floating` is true) and can operate in single or range mode.
- * In both modes users type directly into segmented day / month / year inputs with auto-advance between them.
- */
-export type BaseDatePickerInputProps = {
-    /**
-     * Controls whether manual typing is allowed inside the text fields.
-     * Use `'not-mobile'` to disable typing on mobile devices while keeping it on desktop.
-     * Applies to both single and range modes.
-     * @default true
-     */
-    allowWriting?: boolean | 'not-mobile';
-    /**
-     * Name of the icon to render at the right hand side of the input.
-     */
-    'append:icon'?: IconType;
-    /**
-     * Browser autocomplete hint for the input.
-     * @default 'off'
-     */
-    autocomplete?: InputHTMLAttributes['autocomplete'];
-    /**
-     * Focus the first text field automatically when the component mounts.
-     */
-    autofocus?: InputHTMLAttributes['autofocus'];
-    /**
-     * Displays a clear button whenever a value is present and the control is interactive.
-     */
-    clearable?: boolean;
-    /**
-     * Applies the compact density styles to the control.
-     */
-    compact?: boolean;
-    /**
-     * Disables the input, calendar trigger, and popover.
-     */
-    disabled?: boolean;
-    /**
-     * Sets the first day of the week for the calendar (0 = Sunday, 6 = Saturday).
-     */
-    firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
-    /**
-     * Emit dates formatted as `YYYY-MM-DD` instead of ISO strings.
-     */
-    floating?: boolean;
-    /**
-     * Marks the control as invalid, applying error styles and setting `aria-invalid`.
-     */
-    hasErrors?: boolean;
-    /**
-     * Explicit id for the input element. Falls back to an auto-generated `bdpi-<uid>` value.
-     */
-    id?: HTMLAttributes['id'];
-    /**
-     * Shows loading visuals on the input.
-     */
-    loading?: boolean;
-    /**
-     * Maximum selectable date in `YYYY-MM-DD` format.
-     * Values outside the pattern throw during setup to surface configuration mistakes.
-     */
-    max?: string;
-    /**
-     * Minimum selectable date in `YYYY-MM-DD` format.
-     * Values outside the pattern throw during setup to surface configuration mistakes.
-     */
-    min?: string;
-    /**
-     * v-model value. Use `null` for empty, a single string for single selection,
-     * or a two-element string array (`[start, end]`) when `range` is true.
-     */
-    modelValue: string | string[] | null;
-    /**
-     * Name attribute forwarded to the native inputs. In single mode fields are named
-     * `${name}-day`, `${name}-month`, `${name}-year`; in range mode they are prefixed
-     * with the segment (`${name}-start-day`, `${name}-end-day`, …).
-     */
-    name?: InputHTMLAttributes['name'];
-    /**
-     * Placeholder text displayed when no value is present. Defaults to a format hint
-     * (`DD/MM/YYYY` or `DD/MM/YYYY – DD/MM/YYYY` for range mode).
-     */
-    placeholder?: InputHTMLAttributes['placeholder'];
-    /**
-     * Icon name rendered before the input field.
-     */
-    'prepend:icon'?: IconType;
-    /**
-     * Enables range selection. When active, v-model expects a two-element array `[start, end]`.
-     * Users can still type into the start and end segments as long as `allowWriting` is truthy.
-     */
-    range?: boolean;
-    /**
-     * Makes the text fields read-only and prevents opening the calendar.
-     */
-    readonly?: boolean;
-    /**
-     * Marks the inputs as required to the browser.
-     */
-    required?: boolean;
-    /**
-     * Predicate invoked for each candidate date. Return `false` to disable selection for that value.
-     */
-    selectable?: (date: string) => boolean;
-    /**
-     * Hides the calendar trigger button and prevents the calendar popover from opening.
-     * Use `'not-mobile'` to hide the popover on desktop while keeping it visible on mobile,
-     * complementing `allowWriting: 'not-mobile'` (desktop = keyboard-first, mobile = calendar-first).
-     * An error is thrown if both writing and the popover would be unavailable on the same platform.
-     */
-    hidePopover?: boolean | 'not-mobile';
-    /**
-     * Transition duration, in milliseconds, for the popover appearance.
-     */
-    transitionDuration?: number;
-};
-/**
- * Structured payload carried by every `error` event.
- *
- * | `code`                 | Trigger                            | `original`                   | `normalized`                                          |
- * |------------------------|------------------------------------|------------------------------|-------------------------------------------------------|
- * | `disabled_date`        | Typed single date is disabled      | The disabled date            | Snapped to `min`/`max`, or `null` if not normalizable |
- * | `disabled_range_start` | Typed range start is disabled      | `[start]` or `[start, end]`  | Snapped range, or `null` if start is not normalizable |
- * | `disabled_range_end`   | Typed range end is disabled        | `[start, end]`               | Snapped range (length 1 or 2), or `null`              |
- * | `end_before_start`     | Typed end is chronologically first | `[start, end]` (wrong order) | `[end, start]` — always the swapped pair              |
- */
-export type DatePickerInputError = {
-    code: 'disabled_date';
-    /** The value the user typed before normalization. */
-    original: string;
-    /** Snapped to the nearest `min`/`max` boundary, or `null` if disabled by `selectable`. */
-    normalized: string | null;
-} | {
-    code: 'disabled_range_start';
-    /** The range value before normalization (may be `[start]` or `[start, end]`). */
-    original: string[];
-    /** Snapped range, or `null` if start could not be normalized. */
-    normalized: string[] | null;
-} | {
-    code: 'disabled_range_end';
-    /** The full range before normalization. */
-    original: [string, string];
-    /** Range with end snapped, or `[start]` if end could not be normalized. */
-    normalized: string[] | null;
-} | {
-    code: 'end_before_start';
-    /** `[start, end]` in the order the user typed them. */
-    original: [string, string];
-    /** `[end, start]` — the chronologically corrected pair. */
-    normalized: [string, string];
-};
-/**
- * Events emitted by `BaseDatePickerInput`.
- * - `active` / `inactive`: fired when focus enters or leaves the composite control.
- * - `error`: emitted alongside every normalization or removal — see `DatePickerInputError` for the full code map.
- * - `focus`: forwarded from the native input focus event.
- * - `update:modelValue`: emitted whenever the selected value changes.
- */
-export type BaseDatePickerInputEvents = {
-    (e: 'active'): void;
-    (e: 'error', error: DatePickerInputError): void;
-    (e: 'focus', event: FocusEvent): void;
-    (e: 'inactive'): void;
-    (e: 'update:modelValue', value: BaseDatePickerInputProps['modelValue']): void;
-};
+import { BaseDatePickerInputProps, BaseDatePickerInputSlots, DatePickerInputError } from './types';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: Readonly<{
-        /**
-         * Content rendered before the entire input control, outside the input chrome.
-         */
-        'prepend-outer'?: (props: object) => any;
-        /**
-         * Content rendered before the date fields, at the start of the inner container.
-         */
-        prepend?: (props: object) => any;
-        /**
-         * Inline content rendered at the start of the input field area, before the date fields.
-         */
-        prefix?: (props: object) => any;
-        /**
-         * Content rendered after the date fields, at the end of the inner container (before the calendar toggle button).
-         */
-        append?: (props: object) => any;
-        /**
-         * Content rendered after the entire input control, outside the input chrome.
-         */
-        'append-outer'?: (props: object) => any;
-        /**
-         * Inline content rendered at the end of the input field area, after the date fields.
-         */
-        suffix?: (props: object) => any;
-    }> & {
-        /**
-         * Content rendered before the entire input control, outside the input chrome.
-         */
-        'prepend-outer'?: (props: object) => any;
-        /**
-         * Content rendered before the date fields, at the start of the inner container.
-         */
-        prepend?: (props: object) => any;
-        /**
-         * Inline content rendered at the start of the input field area, before the date fields.
-         */
-        prefix?: (props: object) => any;
-        /**
-         * Content rendered after the date fields, at the end of the inner container (before the calendar toggle button).
-         */
-        append?: (props: object) => any;
-        /**
-         * Content rendered after the entire input control, outside the input chrome.
-         */
-        'append-outer'?: (props: object) => any;
-        /**
-         * Inline content rendered at the end of the input field area, after the date fields.
-         */
-        suffix?: (props: object) => any;
-    };
+    slots: Readonly<BaseDatePickerInputSlots> & BaseDatePickerInputSlots;
     refs: {
         outerContainer: ({
             $: import('vue').ComponentInternalInstance;
@@ -259,23 +42,15 @@ declare function __VLS_template(): {
             $nextTick: typeof import('vue').nextTick;
             $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
         } & Readonly<{}> & Omit<Readonly<{}> & Readonly<{}>, never> & import('vue').ShallowUnwrapRef<{}> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-            $slots: Readonly<{
-                'prepend-outer'?: (props: object) => any;
-                default?: (props: object) => any;
-                'append-outer'?: (props: object) => any;
-            }> & {
-                'prepend-outer'?: (props: object) => any;
-                default?: (props: object) => any;
-                'append-outer'?: (props: object) => any;
-            };
+            $slots: Readonly<import('../CommonInputOuterContainer/types').CommonInputOuterContainerSlots> & import('../CommonInputOuterContainer/types').CommonInputOuterContainerSlots;
         }) | null;
         innerContainer: ({
             $: import('vue').ComponentInternalInstance;
             $data: {};
             $props: {
-                readonly 'append:icon'?: IconType | undefined;
+                readonly 'append:icon'?: import('../..').IconType | undefined;
                 readonly clearable?: boolean | undefined;
-                readonly 'prepend:icon'?: IconType | undefined;
+                readonly 'prepend:icon'?: import('../..').IconType | undefined;
                 readonly preventFocus?: boolean | undefined;
                 readonly "onClick:clear"?: (() => any) | undefined;
             } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
@@ -295,7 +70,7 @@ declare function __VLS_template(): {
             $host: Element | null;
             $emit: (event: "click:clear") => void;
             $el: HTMLSpanElement;
-            $options: import('vue').ComponentOptionsBase<Readonly<import('../CommonInputInnerContainer.vue').CommonInputInnerContainerProps> & Readonly<{
+            $options: import('vue').ComponentOptionsBase<Readonly<import('../..').CommonInputInnerContainerProps> & Readonly<{
                 "onClick:clear"?: (() => any) | undefined;
             }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
                 "click:clear": () => any;
@@ -319,22 +94,10 @@ declare function __VLS_template(): {
             $forceUpdate: () => void;
             $nextTick: typeof import('vue').nextTick;
             $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
-        } & Readonly<{}> & Omit<Readonly<import('../CommonInputInnerContainer.vue').CommonInputInnerContainerProps> & Readonly<{
+        } & Readonly<{}> & Omit<Readonly<import('../..').CommonInputInnerContainerProps> & Readonly<{
             "onClick:clear"?: (() => any) | undefined;
         }>, never> & import('vue').ShallowUnwrapRef<{}> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-            $slots: Readonly<{
-                prepend?: (props: object) => any;
-                prefix?: (props: object) => any;
-                default?: (props: object) => any;
-                append?: (props: object) => any;
-                suffix?: (props: object) => any;
-            }> & {
-                prepend?: (props: object) => any;
-                prefix?: (props: object) => any;
-                default?: (props: object) => any;
-                append?: (props: object) => any;
-                suffix?: (props: object) => any;
-            };
+            $slots: Readonly<import('../CommonInputInnerContainer/types').CommonInputInnerContainerSlots> & import('../CommonInputInnerContainer/types').CommonInputInnerContainerSlots;
         }) | null;
         calendar: HTMLDivElement;
         baseDatePicker: ({
@@ -404,42 +167,22 @@ declare function __VLS_template(): {
         }>, "firstDayOfWeek" | "resetStatus"> & import('vue').ShallowUnwrapRef<{
             resetStatus: () => void;
         }> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-            $slots: Readonly<{
-                [key: string]: (props: {
-                    first: boolean;
-                    highlighted: boolean;
-                    item: any;
-                    label: string;
-                    last: boolean;
-                    middle: boolean;
-                    selected: boolean;
-                }) => any;
-            }> & {
-                [key: string]: (props: {
-                    first: boolean;
-                    highlighted: boolean;
-                    item: any;
-                    label: string;
-                    last: boolean;
-                    middle: boolean;
-                    selected: boolean;
-                }) => any;
-            };
+            $slots: Readonly<import('../BaseDatePicker/types').BaseDatePickerSlots> & import('../BaseDatePicker/types').BaseDatePickerSlots;
         }) | null;
     };
     rootEl: HTMLSpanElement;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<BaseDatePickerInputProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    focus: (event: FocusEvent) => any;
     "update:modelValue": (value: string | string[] | null) => any;
     error: (error: DatePickerInputError) => any;
-    focus: (event: FocusEvent) => any;
     inactive: () => any;
     active: () => any;
 }, string, import('vue').PublicProps, Readonly<BaseDatePickerInputProps> & Readonly<{
+    onFocus?: ((event: FocusEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string | string[] | null) => any) | undefined;
     onError?: ((error: DatePickerInputError) => any) | undefined;
-    onFocus?: ((event: FocusEvent) => any) | undefined;
     onInactive?: (() => any) | undefined;
     onActive?: (() => any) | undefined;
 }>, {
@@ -485,23 +228,15 @@ declare const __VLS_component: import('vue').DefineComponent<BaseDatePickerInput
         $nextTick: typeof import('vue').nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
     } & Readonly<{}> & Omit<Readonly<{}> & Readonly<{}>, never> & import('vue').ShallowUnwrapRef<{}> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-        $slots: Readonly<{
-            'prepend-outer'?: (props: object) => any;
-            default?: (props: object) => any;
-            'append-outer'?: (props: object) => any;
-        }> & {
-            'prepend-outer'?: (props: object) => any;
-            default?: (props: object) => any;
-            'append-outer'?: (props: object) => any;
-        };
+        $slots: Readonly<import('../CommonInputOuterContainer/types').CommonInputOuterContainerSlots> & import('../CommonInputOuterContainer/types').CommonInputOuterContainerSlots;
     }) | null;
     innerContainer: ({
         $: import('vue').ComponentInternalInstance;
         $data: {};
         $props: {
-            readonly 'append:icon'?: IconType | undefined;
+            readonly 'append:icon'?: import('../..').IconType | undefined;
             readonly clearable?: boolean | undefined;
-            readonly 'prepend:icon'?: IconType | undefined;
+            readonly 'prepend:icon'?: import('../..').IconType | undefined;
             readonly preventFocus?: boolean | undefined;
             readonly "onClick:clear"?: (() => any) | undefined;
         } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
@@ -521,7 +256,7 @@ declare const __VLS_component: import('vue').DefineComponent<BaseDatePickerInput
         $host: Element | null;
         $emit: (event: "click:clear") => void;
         $el: HTMLSpanElement;
-        $options: import('vue').ComponentOptionsBase<Readonly<import('../CommonInputInnerContainer.vue').CommonInputInnerContainerProps> & Readonly<{
+        $options: import('vue').ComponentOptionsBase<Readonly<import('../..').CommonInputInnerContainerProps> & Readonly<{
             "onClick:clear"?: (() => any) | undefined;
         }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
             "click:clear": () => any;
@@ -545,22 +280,10 @@ declare const __VLS_component: import('vue').DefineComponent<BaseDatePickerInput
         $forceUpdate: () => void;
         $nextTick: typeof import('vue').nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
-    } & Readonly<{}> & Omit<Readonly<import('../CommonInputInnerContainer.vue').CommonInputInnerContainerProps> & Readonly<{
+    } & Readonly<{}> & Omit<Readonly<import('../..').CommonInputInnerContainerProps> & Readonly<{
         "onClick:clear"?: (() => any) | undefined;
     }>, never> & import('vue').ShallowUnwrapRef<{}> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-        $slots: Readonly<{
-            prepend?: (props: object) => any;
-            prefix?: (props: object) => any;
-            default?: (props: object) => any;
-            append?: (props: object) => any;
-            suffix?: (props: object) => any;
-        }> & {
-            prepend?: (props: object) => any;
-            prefix?: (props: object) => any;
-            default?: (props: object) => any;
-            append?: (props: object) => any;
-            suffix?: (props: object) => any;
-        };
+        $slots: Readonly<import('../CommonInputInnerContainer/types').CommonInputInnerContainerSlots> & import('../CommonInputInnerContainer/types').CommonInputInnerContainerSlots;
     }) | null;
     calendar: HTMLDivElement;
     baseDatePicker: ({
@@ -630,27 +353,7 @@ declare const __VLS_component: import('vue').DefineComponent<BaseDatePickerInput
     }>, "firstDayOfWeek" | "resetStatus"> & import('vue').ShallowUnwrapRef<{
         resetStatus: () => void;
     }> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-        $slots: Readonly<{
-            [key: string]: (props: {
-                first: boolean;
-                highlighted: boolean;
-                item: any;
-                label: string;
-                last: boolean;
-                middle: boolean;
-                selected: boolean;
-            }) => any;
-        }> & {
-            [key: string]: (props: {
-                first: boolean;
-                highlighted: boolean;
-                item: any;
-                label: string;
-                last: boolean;
-                middle: boolean;
-                selected: boolean;
-            }) => any;
-        };
+        $slots: Readonly<import('../BaseDatePicker/types').BaseDatePickerSlots> & import('../BaseDatePicker/types').BaseDatePickerSlots;
     }) | null;
 }, HTMLSpanElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;