bitboss-ui 2.1.111 → 2.1.113

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,213 @@
+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;
+    /**
+     * The `id` attribute forwarded to the native input.
+     * Mirrors `props.id`.
+     */
+    id: BaseCheckboxProps['id'];
+    /**
+     * The `name` attribute forwarded to the native input.
+     * Mirrors `props.name`.
+     */
+    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,173 +1,4 @@
-import { HTMLAttributes, InputHTMLAttributes, MaybeRefOrGetter } from 'vue';
-import { SlotAttributes } from '../BaseCheckbox/BaseCheckbox.vue';
-export type BaseCheckboxGroupProps<T> = {
-    /**
-     * ID of the element that describes the entire checkbox group for assistive
-     * technologies. Forwarded to each generated input as `aria-describedby`.
-     */
-    ariaDescribedby?: InputHTMLAttributes['aria-describedby'];
-    /**
-     * Automatically focuses the first checkbox on mount when true.
-     * Applied only to the first option.
-     * @defaultValue `false`
-     */
-    autofocus?: InputHTMLAttributes['autofocus'];
-    /**
-     * Visual color of the checkboxes.
-     * - 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;
-    /**
-     * List of reactive values which, when changed, trigger items re-fetching.
-     * Useful to reload options based on external inputs.
-     * @defaultValue `[]`
-     */
-    dependencies?: any[];
-    /**
-     * Debounce delay (ms) applied when reacting to `dependencies` changes.
-     * @defaultValue `0`
-     */
-    depsDebounceTime?: number;
-    /**
-     * Direction of the group layout.
-     * - `horizontal`: options flow in rows
-     * - `vertical`: options stack in a column
-     * @defaultValue `'horizontal'`
-     */
-    direction?: 'horizontal' | 'vertical';
-    /**
-     * Disables interaction for the whole group.
-     * @defaultValue `false`
-     */
-    disabled?: boolean;
-    /**
-     * Enforces that `modelValue` contains only values present in `items`.
-     * Incoherent values are removed and `update:modelValue` is emitted with a
-     * coherent array. Please check out {@link https://ui-components-docs.vercel.app/it/guides/coherence | the docs} for more information.
-     * @defaultValue `false`
-     */
-    enforceCoherence?: boolean;
-    /**
-     * Puts the component into an error state adds the error styling class.
-     * @defaultValue `false`
-     */
-    hasErrors?: boolean;
-    /**
-     * Visually hides the label while keeping it accessible to screen readers.
-     * @defaultValue `false`
-     */
-    hideLabel?: boolean;
-    /**
-     * Identifier of the group. Used to derive per-option IDs
-     * for accessible labeling.
-     */
-    id?: HTMLAttributes['id'];
-    /**
-     * Items provider. Can be:
-     * - An array of items
-     * - A sync/async function `(prefill, modelValue) => items`
-     *
-     * When a function is provided, it is invoked on prefill and when dependencies
-     * change to load options dynamically.
-     * @defaultValue `[]`
-     */
-    items: T[] | ((prefill: boolean, modelValue?: any[]) => Promise<T[]>) | ((prefill: boolean, modelValue?: any[]) => T[]);
-    /**
-     * Defines how to derive the display text from an item. Accepts a nested key path
-     * into the item or a function `(item) => string`.
-     * @example `'address.city.label'`
-     * @example `(item) => item.address.city.label`
-     * @defaultValue `JSON.stringify(item)`
-     */
-    itemText?: T extends object ? string | ((item: T) => string) : (item: T) => string;
-    /**
-     * Defines how to derive the value from an item. Accepts a nested key path into the
-     * item or a function `(item) => any`.
-     * @example `'address.city.value'`
-     * @example `(item) => item.address.city.value`
-     * @defaultValue `JSON.stringify(item)`
-     */
-    itemValue?: T extends object ? string | ((item: T) => string) : (item: T) => any;
-    /**
-     * Text displayed while items are loading.
-     * @defaultValue `'Loading...'`
-     */
-    loadingText?: string;
-    /**
-     * Maximum number of selectable items.
-     * @defaultValue `Infinity`
-     */
-    max?: number;
-    /**
-     * Selected values for the group. Used with `v-model`.
-     * Must be an array.
-     */
-    modelValue: any[];
-    /**
-     * Debounce delay (ms) applied when reacting to `modelValue` changes.
-     * @defaultValue `0`
-     */
-    modelValueDebounceTime?: number;
-    /**
-     * Name attribute applied to each input for form submission.
-     */
-    name?: InputHTMLAttributes['name'];
-    /**
-     * Text displayed when there are no items to show.
-     * @defaultValue `'No data to display'`
-     */
-    noDataText?: MaybeRefOrGetter<string>;
-    /**
-     * Makes all checkboxes read-only. Since checkboxes do not support native
-     * `readonly`, inputs are disabled while styled as read-only.
-     * @defaultValue `false`
-     */
-    readonly?: boolean;
-};
-export type BaseCheckboxGroupEvents = {
-    (e: 'blur', event: FocusEvent): void;
-    (e: 'change', event: Event): void;
-    (e: 'click', event: MouseEvent): void;
-    (e: 'focus', event: FocusEvent): void;
-    (e: 'inactive'): 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 BaseCheckboxGroupSlots<T> = {
-    append?: (props: object) => any;
-    icon?: (props: SlotAttributes & {
-        item: T;
-        text: string;
-    }) => any;
-    label?: (props: {
-        item: T;
-        text: string;
-        checked: boolean;
-    }) => any;
-    loading?: (props: object) => any;
-    'no-data'?: (props: object) => any;
-    'option:append'?: (props: {
-        checked: boolean;
-        disabled: boolean;
-        id?: string;
-        item: T;
-        text: string;
-    }) => any;
-    'option:prepend'?: (props: {
-        checked: boolean;
-        disabled: boolean;
-        id?: string;
-        item: T;
-        text: string;
-    }) => any;
-    prepend?: (props: object) => any;
-};
+import { BaseCheckboxGroupEvents, BaseCheckboxGroupProps, BaseCheckboxGroupSlots } from './types';
 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<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
         readonly onInput?: ((event: Event) => any) | undefined;