bitboss-ui 2.1.111 → 2.1.112

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

@@ -153,8 +153,14 @@ export type BaseButtonProps = {
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<{
+        /**
+         * Primary content rendered inside the button element. Falls back to the `text` prop when empty.
+         */
         default?: (props: object) => any;
     }> & {
+        /**
+         * Primary content rendered inside the button element. Falls back to the `text` prop when empty.
+         */
         default?: (props: object) => any;
     };
     refs: {};

package/dist/components/BaseButton/RouterComponent.vue.d.ts

@@ -1,7 +1,11 @@
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: {
-        default?(_: {}): any;
+    slots: Readonly<{
+        /** Content rendered inside the resolved link component (router-link, Nuxt link, or Inertia link). */
+        default?: (props: object) => any;
+    }> & {
+        /** Content rendered inside the resolved link component (router-link, Nuxt link, or Inertia link). */
+        default?: (props: object) => any;
     };
     refs: {};
     rootEl: any;

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

@@ -1,124 +1,16 @@
-import { HTMLAttributes, InputHTMLAttributes } from 'vue';
-export type BaseCheckboxProps = {
-    /**
-     * ID of the element that describes this checkbox for assistive technologies.
-     * Forwarded to the input as `aria-describedby`.
-     */
-    ariaDescribedby?: InputHTMLAttributes['aria-describedby'];
-    /**
-     * Automatically focuses the checkbox when the page/component loads.
-     * Use sparingly to avoid usability issues.
-     * @defaultValue `false`
-     */
-    autofocus?: InputHTMLAttributes['autofocus'];
-    /**
-     * Forces the checkbox checked state (controlled prop). Accepts booleanish
-     * values (`true`/`false` or `'true'`/`'false'`). When omitted, the checked
-     * state is derived from `modelValue === trueValue`.
-     * @defaultValue `false`
-     */
-    checked?: boolean | 'true' | 'false';
-    /**
-     * Visual color of the checkbox.
-     * - If a valid CSS color (HEX/RGB/HSL/etc.), it is applied via the `--color`
-     *   CSS variable.
-     * - Otherwise, a BEM modifier class `bb-base-checkbox--{color}` is added for
-     *   theme-based styling.
-     */
-    color?: string;
-    /**
-     * Disables user interaction. Also applied when `readonly` is set, since
-     * native checkboxes do not support `readonly`.
-     * @defaultValue `false`
-     */
-    disabled?: boolean;
-    /**
-     * Value submitted/emitted when the checkbox is unchecked. Accepts any
-     * serializable value. Serialized to a string for form submission.
-     * @defaultValue `false`
-     */
-    falseValue?: any;
-    /**
-     * Puts the component into an error state (adds error styling class `bb-base-checkbox--errors`).
-     * @defaultValue `false`
-     */
-    hasErrors?: boolean;
-    /**
-     * Identifier forwarded to the input.
-     */
-    id?: HTMLAttributes['id'];
-    /**
-     * Renders the checkbox in the indeterminate state (neither checked nor
-     * unchecked). Note: the native `indeterminate` state resets on user click;
-     * this component re-applies it to keep UI and prop aligned.
-     * @defaultValue `false`
-     */
-    indeterminate?: InputHTMLAttributes['indeterminate'];
-    /**
-     * Bound value for `v-model`. When it equals `trueValue` the checkbox is
-     * considered checked, otherwise unchecked.
-     */
-    modelValue?: any;
-    /**
-     * Name attribute of the input, used during form submission.
-     */
-    name?: InputHTMLAttributes['name'];
-    /**
-     * Puts the input in a read-only state. Since checkboxes do not support
-     * native `readonly`, the input is disabled while styled as read-only.
-     * @defaultValue `false`
-     */
-    readonly?: boolean;
-    /**
-     * Marks the input as required for form validation.
-     * @defaultValue `false`
-     */
-    required?: boolean;
-    /**
-     * When unchecked, submits a hidden input with `falseValue` so that a value
-     * is still posted with the form. When checked, the visible input submits
-     * `trueValue` as usual.
-     * @defaultValue `false`
-     */
-    submitWhenFalse?: boolean;
-    /**
-     * Value submitted/emitted when the checkbox is checked. Accepts any
-     * serializable value. Serialized to a string for form submission.
-     * @defaultValue `true`
-     */
-    trueValue?: any;
-};
-export type BaseCheckboxEvents = {
-    (e: 'blur', event: FocusEvent): void;
-    (e: 'change', event: Event): void;
-    (e: 'click', event: MouseEvent): void;
-    (e: 'focus', event: FocusEvent): void;
-    (e: 'input', event: Event): void;
-    (e: 'keydown', event: KeyboardEvent): void;
-    (e: 'mousedown', event: MouseEvent): void;
-    (e: 'mouseup', event: MouseEvent): void;
-    (e: 'update:modelValue', value: any): void;
-};
-export type SlotAttributes = {
-    checked: boolean;
-    disabled: boolean;
-    falseValue: any;
-    focused: boolean;
-    focusVisible: boolean;
-    hasErrors: boolean;
-    id: BaseCheckboxProps['id'];
-    name: BaseCheckboxProps['name'];
-    parsedValue: any;
-    readonly: BaseCheckboxProps['readonly'];
-    trueValue: any;
-    value: any;
-};
+import { BaseCheckboxProps, BaseCheckboxIconSlotProps } from './types';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<{
-        icon?: (props: SlotAttributes) => any;
+        /**
+         * Replaces the default checkmark SVG rendered inside the checkbox box.
+         */
+        icon?: (props: BaseCheckboxIconSlotProps) => any;
     }> & {
-        icon?: (props: SlotAttributes) => any;
+        /**
+         * Replaces the default checkmark SVG rendered inside the checkbox box.
+         */
+        icon?: (props: BaseCheckboxIconSlotProps) => any;
     };
     refs: {
         checkboxInput: HTMLInputElement;

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

@@ -0,0 +1,205 @@
+import { HTMLAttributes, InputHTMLAttributes } from 'vue';
+export type BaseCheckboxProps = {
+    /**
+     * ID of the element that describes this checkbox for assistive technologies.
+     * Forwarded to the input as `aria-describedby`.
+     */
+    ariaDescribedby?: InputHTMLAttributes['aria-describedby'];
+    /**
+     * Automatically focuses the checkbox when the page/component loads.
+     * Use sparingly to avoid usability issues.
+     * @defaultValue `false`
+     */
+    autofocus?: InputHTMLAttributes['autofocus'];
+    /**
+     * Forces the checkbox checked state (controlled prop). Accepts booleanish
+     * values (`true`/`false` or `'true'`/`'false'`). When omitted, the checked
+     * state is derived from `modelValue === trueValue`.
+     * @defaultValue `false`
+     */
+    checked?: boolean | 'true' | 'false';
+    /**
+     * Visual color of the checkbox.
+     * - If a valid CSS color (HEX/RGB/HSL/etc.), it is applied via the `--color`
+     *   CSS variable.
+     * - Otherwise, a BEM modifier class `bb-base-checkbox--{color}` is added for
+     *   theme-based styling.
+     */
+    color?: string;
+    /**
+     * Disables user interaction. Also applied when `readonly` is set, since
+     * native checkboxes do not support `readonly`.
+     * @defaultValue `false`
+     */
+    disabled?: boolean;
+    /**
+     * Value submitted/emitted when the checkbox is unchecked. Accepts any
+     * serializable value. Serialized to a string for form submission.
+     * @defaultValue `false`
+     */
+    falseValue?: any;
+    /**
+     * Puts the component into an error state (adds error styling class `bb-base-checkbox--errors`).
+     * @defaultValue `false`
+     */
+    hasErrors?: boolean;
+    /**
+     * Identifier forwarded to the input.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Renders the checkbox in the indeterminate state (neither checked nor
+     * unchecked). Note: the native `indeterminate` state resets on user click;
+     * this component re-applies it to keep UI and prop aligned.
+     * @defaultValue `false`
+     */
+    indeterminate?: InputHTMLAttributes['indeterminate'];
+    /**
+     * Bound value for `v-model`. When it equals `trueValue` the checkbox is
+     * considered checked, otherwise unchecked.
+     */
+    modelValue?: any;
+    /**
+     * Name attribute of the input, used during form submission.
+     */
+    name?: InputHTMLAttributes['name'];
+    /**
+     * Puts the input in a read-only state. Since checkboxes do not support
+     * native `readonly`, the input is disabled while styled as read-only.
+     * @defaultValue `false`
+     */
+    readonly?: boolean;
+    /**
+     * Marks the input as required for form validation.
+     * @defaultValue `false`
+     */
+    required?: boolean;
+    /**
+     * When unchecked, submits a hidden input with `falseValue` so that a value
+     * is still posted with the form. When checked, the visible input submits
+     * `trueValue` as usual.
+     * @defaultValue `false`
+     */
+    submitWhenFalse?: boolean;
+    /**
+     * Value submitted/emitted when the checkbox is checked. Accepts any
+     * serializable value. Serialized to a string for form submission.
+     * @defaultValue `true`
+     */
+    trueValue?: any;
+};
+export type BaseCheckboxEvents = {
+    /**
+     * Emitted when the native input loses focus.
+     * Forwards the original DOM `FocusEvent`.
+     */
+    (e: 'blur', event: FocusEvent): void;
+    /**
+     * Emitted when the checkbox checked state changes.
+     * Forwards the original DOM `Event` from the input.
+     */
+    (e: 'change', event: Event): void;
+    /**
+     * Emitted when the input receives a click interaction.
+     * Forwards the original DOM `MouseEvent`.
+     */
+    (e: 'click', event: MouseEvent): void;
+    /**
+     * Emitted when the native input gains focus.
+     * Forwards the original DOM `FocusEvent`.
+     */
+    (e: 'focus', event: FocusEvent): void;
+    /**
+     * Emitted on native input events from the checkbox input.
+     * Forwards the original DOM `Event`.
+     */
+    (e: 'input', event: Event): void;
+    /**
+     * Emitted for keyboard interaction on the input.
+     * Forwards the original DOM `KeyboardEvent`.
+     */
+    (e: 'keydown', event: KeyboardEvent): void;
+    /**
+     * Emitted when a pointing device button is pressed over the input.
+     * Forwards the original DOM `MouseEvent`.
+     */
+    (e: 'mousedown', event: MouseEvent): void;
+    /**
+     * Emitted when a pointing device button is released over the input.
+     * Forwards the original DOM `MouseEvent`.
+     */
+    (e: 'mouseup', event: MouseEvent): void;
+    /**
+     * Emitted on checked-state changes with the effective model value:
+     * - `trueValue` when checked
+     * - `falseValue` when unchecked
+     */
+    (e: 'update:modelValue', value: any): void;
+};
+/**
+ * Props exposed by the `icon` slot.
+ *
+ * These values are normalized at runtime so consumers receive stable types
+ * (not optional/undefined booleans).
+ */
+export type BaseCheckboxIconSlotProps = {
+    /**
+     * Whether the checkbox is currently checked.
+     * @defaultValue `false`
+     */
+    checked: boolean;
+    /**
+     * Whether the checkbox is disabled.
+     * Mirrors `props.disabled`.
+     * @defaultValue `false`
+     */
+    disabled: boolean;
+    /**
+     * Value emitted/submitted when unchecked.
+     * Mirrors `props.falseValue`.
+     * @defaultValue `false`
+     */
+    falseValue: any;
+    /**
+     * Whether the native input currently has focus.
+     * @defaultValue `false`
+     */
+    focused: boolean;
+    /**
+     * Whether focus is keyboard-visible (`:focus-visible`).
+     * @defaultValue `false`
+     */
+    focusVisible: boolean;
+    /**
+     * Whether the checkbox is in an error state.
+     * Mirrors `props.hasErrors`.
+     * @defaultValue `false`
+     */
+    hasErrors: boolean;
+    id: BaseCheckboxProps['id'];
+    name: BaseCheckboxProps['name'];
+    /**
+     * Serialized `trueValue` used by native form submission.
+     */
+    parsedValue: string;
+    /**
+     * Whether the checkbox is readonly.
+     * Mirrors `props.readonly`.
+     * @defaultValue `false`
+     */
+    readonly: boolean;
+    /**
+     * Value emitted/submitted when checked.
+     * Mirrors `props.trueValue`.
+     * @defaultValue `true`
+     */
+    trueValue: any;
+    /**
+     * Current effective value (`trueValue` when checked, otherwise `falseValue`).
+     */
+    value: any;
+};
+/**
+ * @deprecated Use `BaseCheckboxIconSlotProps`.
+ */
+export type SlotAttributes = BaseCheckboxIconSlotProps;

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

@@ -1,5 +1,5 @@
 import { HTMLAttributes, InputHTMLAttributes, MaybeRefOrGetter } from 'vue';
-import { SlotAttributes } from '../BaseCheckbox/BaseCheckbox.vue';
+import { BaseCheckboxIconSlotProps } from '../BaseCheckbox/types';
 export type BaseCheckboxGroupProps<T> = {
     /**
      * ID of the element that describes the entire checkbox group for assistive
@@ -140,18 +140,59 @@ export type BaseCheckboxGroupEvents = {
     (e: 'update:modelValue', value: any): void;
 };
 export type BaseCheckboxGroupSlots<T> = {
+    /**
+     * Content rendered after the last option, inside the options container.
+     */
     append?: (props: object) => any;
-    icon?: (props: SlotAttributes & {
+    /**
+     * Replaces the default checkmark icon for each checkbox option. Receives all `BaseCheckbox`
+     * slot attributes plus the source item and its display text.
+     * @param checked - Whether this option is currently checked.
+     * @param disabled - Whether this option is disabled.
+     * @param falseValue - The unchecked value for this option.
+     * @param focused - Whether this option's input currently has focus.
+     * @param focusVisible - Whether focus is keyboard-visible (`:focus-visible`).
+     * @param hasErrors - Whether the group is in an error state.
+     * @param id - The `id` of this option's input.
+     * @param name - The `name` of this option's input.
+     * @param parsedValue - The `trueValue` serialized for form submission.
+     * @param readonly - Whether this option is read-only.
+     * @param trueValue - The checked value for this option.
+     * @param value - The current effective value for this option.
+     * @param item - The raw item from the `items` prop.
+     * @param text - The display text resolved for this option.
+     */
+    icon?: (props: BaseCheckboxIconSlotProps & {
         item: T;
         text: string;
     }) => any;
+    /**
+     * Replaces the default label text for each option.
+     * @param item - The raw item from the `items` prop.
+     * @param text - The resolved display text for this option.
+     * @param checked - Whether this option is currently checked.
+     */
     label?: (props: {
         item: T;
         text: string;
         checked: boolean;
     }) => any;
+    /**
+     * Content shown while options are loading (replaces the default loading text).
+     */
     loading?: (props: object) => any;
+    /**
+     * Content shown when no options are available (replaces the default "no data" text).
+     */
     'no-data'?: (props: object) => any;
+    /**
+     * Content rendered after each option's checkbox and label.
+     * @param checked - Whether this option is currently checked.
+     * @param disabled - Whether this option is disabled.
+     * @param id - The `id` of this option's input, if set.
+     * @param item - The raw item from the `items` prop.
+     * @param text - The display text for this option.
+     */
     'option:append'?: (props: {
         checked: boolean;
         disabled: boolean;
@@ -159,6 +200,14 @@ export type BaseCheckboxGroupSlots<T> = {
         item: T;
         text: string;
     }) => any;
+    /**
+     * Content rendered before each option's checkbox.
+     * @param checked - Whether this option is currently checked.
+     * @param disabled - Whether this option is disabled.
+     * @param id - The `id` of this option's input, if set.
+     * @param item - The raw item from the `items` prop.
+     * @param text - The display text for this option.
+     */
     'option:prepend'?: (props: {
         checked: boolean;
         disabled: boolean;
@@ -166,6 +215,9 @@ export type BaseCheckboxGroupSlots<T> = {
         item: T;
         text: string;
     }) => any;
+    /**
+     * Content rendered before the first option, inside the options container.
+     */
     prepend?: (props: object) => any;
 };
 declare const _default: <T = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{

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

@@ -118,11 +118,31 @@ export type BaseColorInputEvents = {
  * Use `prepend`/`append` for inline adornments; `prepend-outer`/`append-outer` for the outer container areas.
  */
 export type BaseColorInputSlots = {
+    /**
+     * Content rendered after the color picker indicator button, at the end of the inner container.
+     * When provided, replaces the default suffix wrapper (use the `suffix` slot if you only need inline trailing text).
+     */
     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 start of the input field area, before the typed text.
+     */
     prefix?: (props: object) => any;
+    /**
+     * Content rendered before the text input, at the start of the inner container.
+     */
     prepend?: (props: object) => any;
+    /**
+     * Content rendered before the entire input control, outside the input chrome.
+     */
     'prepend-outer'?: (props: object) => any;
+    /**
+     * Inline content rendered at the end of the input field area, after the typed text.
+     * Renders inside the default `append` area's suffix wrapper.
+     */
     suffix?: (props: object) => any;
 };
 declare function __VLS_template(): {
@@ -168,10 +188,14 @@ 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: {
-                'prepend-outer'?(_: {}): any;
-                default?(_: {}): any;
-                'append-outer'?(_: {}): any;
+            $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;
             };
         }) | null;
         innerContainer: ({
@@ -227,12 +251,18 @@ declare function __VLS_template(): {
         } & Readonly<{}> & Omit<Readonly<import('../CommonInputInnerContainer.vue').CommonInputInnerContainerProps> & Readonly<{
             "onClick:clear"?: (() => any) | undefined;
         }>, never> & import('vue').ShallowUnwrapRef<{}> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-            $slots: {
-                prepend?(_: {}): any;
-                prefix?(_: {}): any;
-                default?(_: {}): any;
-                append?(_: {}): any;
-                suffix?(_: {}): any;
+            $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;
             };
         }) | null;
     };
@@ -303,10 +333,14 @@ declare const __VLS_component: import('vue').DefineComponent<BaseColorInputProps
         $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: {
-            'prepend-outer'?(_: {}): any;
-            default?(_: {}): any;
-            'append-outer'?(_: {}): any;
+        $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;
         };
     }) | null;
     innerContainer: ({
@@ -362,12 +396,18 @@ declare const __VLS_component: import('vue').DefineComponent<BaseColorInputProps
     } & Readonly<{}> & Omit<Readonly<import('../CommonInputInnerContainer.vue').CommonInputInnerContainerProps> & Readonly<{
         "onClick:clear"?: (() => any) | undefined;
     }>, never> & import('vue').ShallowUnwrapRef<{}> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-        $slots: {
-            prepend?(_: {}): any;
-            prefix?(_: {}): any;
-            default?(_: {}): any;
-            append?(_: {}): any;
-            suffix?(_: {}): any;
+        $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;
         };
     }) | null;
 }, HTMLSpanElement>;

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

@@ -53,7 +53,27 @@ export type BaseDatePickerProps = {
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: any;
+    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;
+    };
     refs: {};
     rootEl: HTMLDivElement;
 };

package/dist/components/BaseDatePicker/BaseDatePickerInputDaySelector.vue.d.ts

@@ -21,23 +21,27 @@ type Props = {
 type DateValue = string | string[] | null;
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: Partial<Record<"day", (_: {
-        first: boolean;
-        highlighted: boolean;
-        item: dayjs.Dayjs;
-        label: string;
-        last: boolean;
-        middle: boolean;
-        selected: boolean;
-    }) => any>> & Partial<Record<string, (_: {
-        first: boolean;
-        highlighted: boolean;
-        item: dayjs.Dayjs;
-        label: string;
-        last: boolean;
-        middle: boolean;
-        selected: boolean;
-    }) => any>>;
+    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;
+    };
     refs: {
         calendar: HTMLDivElement;
     };