bitboss-ui 2.1.113 → 2.1.115

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

@@ -0,0 +1,351 @@
+import { HTMLAttributes, InputHTMLAttributes } from 'vue';
+import { CommonProps } from '../../types/CommonProps';
+export type BbSelectPopoverProps<Item> = {
+    /**
+     * External activator element or component ref.
+     * When provided, the activator slot is not rendered and event listeners
+     * are attached programmatically to the referenced element.
+     */
+    activator?: HTMLElement | Record<string, any> | null;
+    /**
+     * Controls whether the search input is shown inside the popover panel.
+     * Use `'not-mobile'` to hide the search input on mobile.
+     *
+     * @defaultValue `false`
+     */
+    allowWriting?: boolean | 'not-mobile';
+    /**
+     * Browser autocomplete hint for the popover search input.
+     *
+     * @defaultValue `'off'`
+     */
+    autocomplete?: InputHTMLAttributes['autocomplete'];
+    /**
+     * Apply the compact density variant.
+     */
+    compact?: boolean;
+    /**
+     * Space the arrow keeps from popover edges. Useful with rounded corners.
+     *
+     * @defaultValue `10`
+     */
+    arrowPadding?: CommonProps['arrowPadding'];
+    /**
+     * Constrains the popover to a specific boundary element.
+     */
+    boundary?: HTMLElement | Record<string, any> | string | null;
+    /**
+     * Additional dependencies that trigger item reloading when changed.
+     *
+     * @defaultValue `[]`
+     */
+    dependencies?: any[];
+    /**
+     * Debounce delay (ms) for dependency-triggered reloads.
+     *
+     * @defaultValue `0`
+     */
+    depsDebounceTime?: number;
+    /**
+     * Disables the component.
+     */
+    disabled?: boolean;
+    /**
+     * Marks the component as being in error state.
+     */
+    hasErrors?: boolean;
+    /**
+     * Explicit invalid state for accessibility semantics.
+     * Falls back to `hasErrors` when not provided.
+     */
+    ariaInvalid?: boolean;
+    /**
+     * Space-separated IDREF(s) that describe this field for assistive technologies.
+     * Accepts either a string or array of ids.
+     */
+    ariaDescribedby?: string | string[];
+    /**
+     * Enable or disable floating flip behavior.
+     *
+     * @defaultValue `true`
+     */
+    flip?: boolean;
+    /**
+     * Whether the floating arrow is hidden.
+     *
+     * @defaultValue `true`
+     */
+    hideArrow?: boolean;
+    /**
+     * Reset modelValue to `null` or empty array if it no longer matches available items.
+     */
+    enforceCoherence?: boolean;
+    /**
+     * Controls how options are filtered during search.
+     *
+     * @defaultValue `() => []`
+     */
+    filterBy?: string | string[] | false | 'not_stashed' | ((value: any, item: any, query: string | null) => boolean) | null;
+    /** Path to item property for grouping options. */
+    groupBy?: string | ((item: Item) => string | number | symbol);
+    /**
+     * Height of group headers in the listbox (px). Defaults to 24px (compact) or 32px.
+     * Only applies when `groupBy` is set.
+     */
+    headerHeight?: number;
+    /**
+     * Explicit id for the component. Used to generate ids for listbox and options.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Array of items or function to load them asynchronously.
+     * Functions receive `(query, prefill, modelValue)` and can return a promise.
+     *
+     * @defaultValue `[]`
+     */
+    items: Item[] | ((query: string, prefill: boolean, modelValue: any[]) => Promise<Item[]>) | ((query: string, prefill: boolean, modelValue: any[]) => Item[]);
+    /**
+     * Height of the options in the listbox (px).
+     *
+     * @defaultValue `40`
+     */
+    itemHeight?: number;
+    /**
+     * Path to item property for display text or function to extract it.
+     */
+    itemText?: string | ((item: Item) => string) | undefined;
+    /**
+     * Path to item property for value or function to extract it.
+     */
+    itemValue?: string | ((item: Item) => string) | undefined;
+    /**
+     * Display the loading state styles.
+     */
+    loading?: boolean;
+    /**
+     * Message shown while items are being loaded.
+     */
+    loadingText?: string;
+    /**
+     * Maximum number of selectable items (limits selection when `multiple` is true).
+     *
+     * @defaultValue `Infinity`
+     */
+    max?: number;
+    /**
+     * v-model value. Single value for single select, array for multiple select.
+     */
+    modelValue: any;
+    /**
+     * Debounce delay (ms) for modelValue change handling.
+     *
+     * @defaultValue `0`
+     */
+    modelValueDebounceTime?: number;
+    /**
+     * Enable multiple item selection. When true, modelValue must be an array.
+     */
+    multiple?: boolean;
+    /**
+     * Message displayed when no items are available.
+     */
+    noDataText?: string;
+    /**
+     * Distance (px) between the activator and the popover.
+     *
+     * @defaultValue `4`
+     */
+    offset?: number;
+    /**
+     * Minimum page padding used by floating shift middleware.
+     *
+     * @defaultValue `0`
+     */
+    padding?: CommonProps['padding'];
+    /**
+     * Floating placement of the popover.
+     *
+     * @defaultValue `'bottom'`
+     */
+    placement?: CommonProps['placement'];
+    /**
+     * Controls when items are pre-loaded.
+     * `'interaction'` loads on first user interaction, `true` loads immediately,
+     * `false` loads only on explicit search/open flows.
+     *
+     * @defaultValue `'interaction'`
+     */
+    prefill?: boolean | 'interaction';
+    /**
+     * Debounce delay (ms) before triggering search queries after user input stops.
+     *
+     * @defaultValue `500`
+     */
+    queryDebounceTime?: number;
+    /**
+     * Prevents opening the popover while keeping the activator accessible.
+     */
+    readonly?: boolean;
+    /**
+     * Accessible label used by the search input rendered inside the popover.
+     *
+     * @defaultValue `'Search options'`
+     */
+    searchInputAriaLabel?: string;
+    /**
+     * Accumulate selected items across searches instead of replacing them.
+     */
+    stash?: boolean;
+    /**
+     * Transition duration (ms) for popover show/hide animations.
+     *
+     * @defaultValue `300`
+     */
+    transitionDuration?: number;
+    /**
+     * Width of the popover in pixels, percentage, or `'auto'`.
+     */
+    width?: number | string;
+};
+export type BbSelectPopoverEvents = {
+    /**
+     * Emitted when the activator loses focus.
+     */
+    (e: 'blur', event: FocusEvent): void;
+    /**
+     * Emitted when the value changes via native change event.
+     */
+    (e: 'change', event: Event): void;
+    /**
+     * Emitted when the activator is clicked.
+     */
+    (e: 'click', event: MouseEvent): void;
+    /**
+     * Emitted when the activator receives focus.
+     */
+    (e: 'focus', event: FocusEvent): void;
+    /**
+     * Emitted when focus moves outside the entire component after it was active.
+     */
+    (e: 'inactive'): void;
+    /**
+     * Emitted on native input events from the search input.
+     */
+    (e: 'input', event: Event): void;
+    /**
+     * Emitted with the next selection value whenever selection changes.
+     */
+    (e: 'update:modelValue', value: any): void;
+    /**
+     * Emitted when the user types a new value and confirms it (Enter key) when `allowWriting` is enabled.
+     */
+    (e: 'option:add', text: string): void;
+};
+/** Props exposed by the `activator` slot. */
+export type BbSelectPopoverActivatorSlotProps = {
+    /** Bind onto the activator element with `v-bind="props"` to wire up the popover reference. */
+    props: {
+        ref: (reference: unknown) => void;
+    };
+    /** Whether the popover is currently open. */
+    shown: boolean;
+    /** Whether the select is disabled. */
+    disabled: boolean | undefined;
+    /** Whether the select is read-only. */
+    readonly: boolean | undefined;
+    /** Whether options are currently being fetched. */
+    loading: boolean;
+    /** The current search query string. */
+    query: string;
+    /** Clears the current selection and query. */
+    clear: () => void;
+    /** Opens the popover. */
+    open: () => Promise<void>;
+    /** Closes the popover. */
+    close: () => Promise<void>;
+    /** Toggles the popover open/closed. */
+    toggle: () => Promise<void>;
+};
+/** Props exposed by the `option` slot. */
+export type BbSelectPopoverOptionSlotProps<Item> = {
+    /** Whether this option is disabled. */
+    disabled: boolean;
+    /** Whether this option currently has keyboard focus. */
+    focused: boolean;
+    /** Zero-based index of this option in the list. */
+    index: number;
+    /** The raw item from the `items` prop. */
+    item: Item;
+    /** Whether items are still being fetched. */
+    loading: boolean;
+    /** Whether this option is currently selected. */
+    selected: boolean;
+    /** The resolved display text for this option. */
+    text: string;
+    /** The resolved value for this option. */
+    value: any;
+};
+/** Props exposed by the `group` slot. */
+export type BbSelectPopoverGroupSlotProps<Item> = {
+    /** The display text for this group. */
+    text: string;
+    /** The raw group item. */
+    item: Item;
+    /** Zero-based index of the first option in this group. */
+    index: number;
+    /** Number of options in this group. */
+    length: number;
+    /** Whether all options in this group are disabled. */
+    disabled: boolean;
+};
+export type BbSelectPopoverSlots<Item> = {
+    /**
+     * Replaces the default trigger element that opens the select popover.
+     */
+    activator?: (props: BbSelectPopoverActivatorSlotProps) => any;
+    /**
+     * Content shown inside the options dropdown while items are loading.
+     */
+    loading?: (props: {
+        query: string;
+    }) => any;
+    /**
+     * Content shown when no options match the query or the list is empty.
+     */
+    'no-data'?: (props: {
+        query: string;
+        focus: () => void;
+    }) => any;
+    /**
+     * Replaces the default rendering of each option row in the dropdown.
+     */
+    option?: (props: BbSelectPopoverOptionSlotProps<Item>) => any;
+    /**
+     * Replaces the default group header rendered above grouped options.
+     */
+    group?: (props: BbSelectPopoverGroupSlotProps<Item>) => any;
+    /**
+     * Content appended inside the options list, after the last option.
+     */
+    'options:append'?: (props: {
+        focus: () => void;
+    }) => any;
+    /**
+     * Content appended outside the options list container.
+     */
+    'options:append:outer'?: (props: {
+        focus: () => void;
+    }) => any;
+    /**
+     * Content prepended inside the options list, before the first option.
+     */
+    'options:prepend'?: (props: {
+        focus: () => void;
+    }) => any;
+    /**
+     * Content prepended outside the options list container.
+     */
+    'options:prepend:outer'?: (props: {
+        focus: () => void;
+    }) => any;
+};

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

@@ -1,150 +1,31 @@
-import { BaseSliderEvents, BaseSliderSlots } from '../BaseSlider/BaseSlider.vue';
-import { HTMLAttributes, InputHTMLAttributes } from 'vue';
-export type BbSliderProps = {
-    /**
-     * Sets autofocus on page load.
-     */
-    autofocus?: InputHTMLAttributes['autofocus'];
-    /**
-     * Define a color for the component.
-     *
-     * Either a custom color or a coded color in common HEX, RGB, etc... format.
-     */
-    color?: string;
-    /**
-     * Set the component in compact mode.
-     */
-    compact?: boolean;
-    /**
-     * Direction of the layout of the component. Can either be a predefined value or a pattern separated by a space like `xx xxxxx`.
-     */
-    direction?: 'horizontal' | 'vertical' | 'auto' | string;
-    /**
-     * Disables the component
-     */
-    disabled?: boolean;
-    /**
-     * Can be a string or an array of string containing the messages to display.
-     */
-    errors?: string | string[];
-    /**
-     * Define if the component should be in an error state.
-     * It usually attaches a CSS class for styling purposes.
-     */
-    hasErrors?: boolean;
-    /**
-     * Visually hides the label of the input while maintaining accessibility.
-     */
-    hideLabel?: boolean;
-    /**
-     * Text box to be displayed near the input, usually to indicate instructions.
-     */
-    hint?: string;
-    /**
-     * The identifier of the component.
-     */
-    id?: HTMLAttributes['id'];
-    /**
-     * Text content of the label of the element.
-     */
-    label: string;
-    /**
-     * Sets the text alignment of the label.
-     */
-    labelPosition?: 'left' | 'center' | 'right';
-    /**
-     * Maximum value cap.
-     */
-    max?: number;
-    /**
-     * Minimum value cap.
-     */
-    min?: number;
-    /**
-     * Used by v-model.
-     */
-    modelValue: number[] | number | string | null;
-    /**
-     * Defines the name of the input.
-     */
-    name?: InputHTMLAttributes['name'];
-    /**
-     * Keeps the hint displayed.
-     */
-    persistentHint?: boolean;
-    /**
-     * Set the input as range.
-     * modelValue must be an array
-     */
-    range?: boolean;
-    /**
-     * Sets the input in a readonly state.
-     */
-    readonly?: boolean;
-    /**
-     * Sets the input as required.
-     */
-    required?: boolean;
-    /**
-     * Reverses the layout. Applicable in every direction the order of the label and the input is swapped.
-     */
-    reverse?: boolean;
-    /**
-     * The step attribute is a number that specifies the granularity that the value must adhere to.
-     */
-    step?: number;
-    /**
-     * Proportionally translates the thumb so it remains on track. Set it to false when displaying ticks so they align with less effort.
-     */
-    thumbTranslate?: boolean;
-    /**
-     * Displays ticks on step
-     */
-    ticks?: boolean;
-};
-export type BbSliderEvents = BaseSliderEvents;
+import { BbSliderProps, BbSliderEvents, BbSliderSlots } from './types';
+export type { BbSliderProps, BbSliderEvents, BbSliderSlots };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: Readonly<BaseSliderSlots & {
-        /**
-         * Replaces the default label text rendered above the slider.
-         * @param text - The `label` prop value.
-         * @param hasErrors - Whether the slider is in an error state.
-         */
-        label?: (props: {
-            text: string;
-            hasErrors: boolean;
-        }) => any;
-    }> & BaseSliderSlots & {
-        /**
-         * Replaces the default label text rendered above the slider.
-         * @param text - The `label` prop value.
-         * @param hasErrors - Whether the slider is in an error state.
-         */
-        label?: (props: {
-            text: string;
-            hasErrors: boolean;
-        }) => any;
+    slots: Readonly<import('../BaseSlider/types').BaseSliderSlots & {
+        label?: (props: import('./types').BbSliderLabelSlotProps) => any;
+    }> & import('../BaseSlider/types').BaseSliderSlots & {
+        label?: (props: import('./types').BbSliderLabelSlotProps) => any;
     };
     refs: {};
     rootEl: HTMLDivElement;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<BbSliderProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    "update:modelValue": (event: number | number[]) => any;
-    keydown: (event: KeyboardEvent) => any;
     click: (event: MouseEvent) => any;
     focus: (event: FocusEvent) => any;
+    keydown: (event: KeyboardEvent) => any;
+    "update:modelValue": (event: number | number[]) => any;
     pointerdown: (event: PointerEvent) => any;
     pointermove: (event: PointerEvent) => any;
     pointerup: (event: PointerEvent) => any;
     inactive: () => any;
     active: () => any;
 }, string, import('vue').PublicProps, Readonly<BbSliderProps> & Readonly<{
-    "onUpdate:modelValue"?: ((event: number | number[]) => any) | undefined;
-    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onClick?: ((event: MouseEvent) => any) | undefined;
     onFocus?: ((event: FocusEvent) => any) | undefined;
+    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((event: number | number[]) => any) | undefined;
     onPointerdown?: ((event: PointerEvent) => any) | undefined;
     onPointermove?: ((event: PointerEvent) => any) | undefined;
     onPointerup?: ((event: PointerEvent) => any) | undefined;

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

@@ -0,0 +1,123 @@
+import { HTMLAttributes, InputHTMLAttributes } from 'vue';
+import { BaseSliderEvents, BaseSliderSlots } from '../BaseSlider/types';
+export type BbSliderProps = {
+    /**
+     * Sets autofocus on page load.
+     */
+    autofocus?: InputHTMLAttributes['autofocus'];
+    /**
+     * Define a color for the component.
+     *
+     * Either a custom color or a coded color in common HEX, RGB, etc... format.
+     */
+    color?: string;
+    /**
+     * Set the component in compact mode.
+     */
+    compact?: boolean;
+    /**
+     * Direction of the layout of the component. Can either be a predefined value or a
+     * pattern separated by a space like `xx xxxxx`.
+     */
+    direction?: 'horizontal' | 'vertical' | 'auto' | string;
+    /**
+     * Disables the component.
+     */
+    disabled?: boolean;
+    /**
+     * Can be a string or an array of string containing the messages to display.
+     */
+    errors?: string | string[];
+    /**
+     * Define if the component should be in an error state.
+     * It usually attaches a CSS class for styling purposes.
+     */
+    hasErrors?: boolean;
+    /**
+     * Visually hides the label of the input while maintaining accessibility.
+     */
+    hideLabel?: boolean;
+    /**
+     * Text box to be displayed near the input, usually to indicate instructions.
+     */
+    hint?: string;
+    /**
+     * The identifier of the component.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Text content of the label of the element.
+     */
+    label: string;
+    /**
+     * Sets the text alignment of the label.
+     */
+    labelPosition?: 'left' | 'center' | 'right';
+    /**
+     * Maximum value cap.
+     */
+    max?: number;
+    /**
+     * Minimum value cap.
+     */
+    min?: number;
+    /**
+     * Used by v-model.
+     */
+    modelValue: number[] | number | string | null;
+    /**
+     * Defines the name of the input.
+     */
+    name?: InputHTMLAttributes['name'];
+    /**
+     * Keeps the hint displayed.
+     */
+    persistentHint?: boolean;
+    /**
+     * Set the input as range. modelValue must be an array.
+     */
+    range?: boolean;
+    /**
+     * Sets the input in a readonly state.
+     */
+    readonly?: boolean;
+    /**
+     * Sets the input as required.
+     */
+    required?: boolean;
+    /**
+     * Reverses the layout. Applicable in every direction the order of the label and
+     * the input is swapped.
+     */
+    reverse?: boolean;
+    /**
+     * The step attribute specifies the granularity that the value must adhere to.
+     */
+    step?: number;
+    /**
+     * Proportionally translates the thumb so it remains on track. Set it to `false` when
+     * displaying ticks so they align with less effort.
+     *
+     * @defaultValue `true`
+     */
+    thumbTranslate?: boolean;
+    /**
+     * Displays ticks on step.
+     */
+    ticks?: boolean;
+};
+/** Re-export for consumers importing events type from BbSlider. */
+export type BbSliderEvents = BaseSliderEvents;
+/** Props exposed by the `label` slot. */
+export type BbSliderLabelSlotProps = {
+    /** The `label` prop value. */
+    text: string;
+    /** Whether the slider is in an error state. */
+    hasErrors: boolean;
+};
+export type BbSliderSlots = BaseSliderSlots & {
+    /**
+     * Replaces the default label text rendered above the slider.
+     */
+    label?: (props: BbSliderLabelSlotProps) => any;
+};

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

@@ -1,26 +1,5 @@
-import { CommonProps, NonVoidElementTag } from '../../types/CommonProps';
-export type BbSmoothHeightProps = {
-    /**
-     * Options to pass to the MutationObserver
-     */
-    mutationOptions?: MutationObserverInit;
-    /**
-     * Options to pass to the ResizeObserver
-     */
-    resizeOptions?: ResizeObserverOptions;
-    /**
-     * Define which strategy to use. By default is used 'resize' which means the
-     * component will update on resizing.
-     * You can also define 'mutation' to use a MutationObserver
-     */
-    strategy?: 'resize' | 'mutation';
-} & NonVoidElementTag & Pick<CommonProps, 'transitionDuration'>;
-export type BbSmoothHeightSlots = {
-    /**
-     * Content whose height changes are animated with a smooth transition.
-     */
-    default?: (props: object) => any;
-};
+import { BbSmoothHeightProps, BbSmoothHeightSlots } from './types';
+export type { BbSmoothHeightProps, BbSmoothHeightSlots };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<BbSmoothHeightSlots> & BbSmoothHeightSlots;

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

@@ -0,0 +1,24 @@
+import { CommonProps, NonVoidElementTag } from '../../types/CommonProps';
+export type BbSmoothHeightProps = {
+    /**
+     * Options to pass to the MutationObserver.
+     */
+    mutationOptions?: MutationObserverInit;
+    /**
+     * Options to pass to the ResizeObserver.
+     */
+    resizeOptions?: ResizeObserverOptions;
+    /**
+     * Define which strategy to use. By default `'resize'` is used, which means the
+     * component will update on resizing. You can also define `'mutation'` to use a MutationObserver.
+     *
+     * @defaultValue `'resize'`
+     */
+    strategy?: 'resize' | 'mutation';
+} & NonVoidElementTag & Pick<CommonProps, 'transitionDuration'>;
+export type BbSmoothHeightSlots = {
+    /**
+     * Content whose height changes are animated with a smooth transition.
+     */
+    default?: (props: object) => any;
+};

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

@@ -1,10 +1,8 @@
-import { CommonProps, Size as S } from '../../types/CommonProps';
-import { Size as IconSize } from '../BbIcon/BbIcon.vue';
-export type Size = IconSize;
-export type BbSpinnerProps = Pick<CommonProps, 'color'> & S<IconSize>;
+import { BbSpinnerProps } from './types';
+export type { BbSpinnerProps, Size } from './types';
 declare const _default: import('vue').DefineComponent<BbSpinnerProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<BbSpinnerProps> & Readonly<{}>, {
     size: number | ({
         size?: any;
-    } & string) | keyof IconSize;
+    } & string) | keyof import('../..').BbIconSizes;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, SVGSVGElement>;
 export default _default;