bitboss-ui 2.1.113 → 2.1.115

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

@@ -0,0 +1,97 @@
+import { Classes } from '../../types/Classes';
+import { CommonProps, Size } from '../../types/CommonProps';
+export type Sizes = {
+    sm: number;
+    md: number;
+    lg: number;
+};
+export type BbOffCanvasProps = Pick<CommonProps, 'closeLabel' | 'compact' | 'disabled' | 'eager' | 'persistent' | 'showClose' | 'title' | 'transitionDuration'> & Size<Sizes> & {
+    /**
+     * Description of the content of the modal. Extremely useful for accessibility reasons.
+     */
+    description?: string;
+    /**
+     * Element that obtains focus immediately after opening the dialog.
+     * By default it's the first tabbable item.
+     */
+    focusTarget?: string;
+    /**
+     * Displays the modal as fullscreen with no margin to the page.
+     */
+    fullscreen?: boolean | 'mobile';
+    /**
+     * Classes to apply to the panel of the dialog.
+     *
+     * @deprecated Pass a common `class` attribute to the component instead.
+     */
+    panelClasses?: Classes;
+    /**
+     * Classes to apply to the overlay of the dialog.
+     *
+     * @deprecated Pass a common `class` attribute to the component instead.
+     */
+    overlayClasses?: Classes;
+    /**
+     * Defines the direction the offcanvas should appear from.
+     *
+     * @defaultValue `'left'`
+     */
+    direction?: 'left' | 'top' | 'right' | 'bottom';
+};
+export type BbOffCanvasEvents = {
+    /** Emitted as soon as the user triggers the open action (model becomes true). */
+    (e: 'show'): void;
+    /** Emitted as soon as the user triggers the close action (model becomes false). */
+    (e: 'hide'): void;
+    /** Emitted after the offcanvas is fully opened using `showModal()`. */
+    (e: 'shown'): void;
+    /** Emitted after the close transition completes and the offcanvas is fully dismissed. */
+    (e: 'hidden'): void;
+};
+/** Props exposed by the `header` slot. */
+export type BbOffCanvasHeaderSlotProps = {
+    /** The `id` assigned to the title element, wired to `aria-labelledby`. */
+    titleId: string;
+    /** Programmatically closes the off-canvas panel. */
+    close: () => void;
+    /** The `title` prop value. */
+    title: BbOffCanvasProps['title'];
+};
+/** Props exposed by the `title` slot. */
+export type BbOffCanvasTitleSlotProps = {
+    /** The `title` prop value. */
+    text: BbOffCanvasProps['title'];
+};
+/** Props exposed by the `description` slot. */
+export type BbOffCanvasDescriptionSlotProps = {
+    /** The `id` to assign to your custom description element for `aria-describedby` wiring. */
+    descriptionId: string;
+    /** The `description` prop value. */
+    text: BbOffCanvasProps['description'];
+};
+export type BbOffCanvasSlots = {
+    /**
+     * Replaces the entire off-canvas header section (title + close button). Maintains accessibility wiring via the provided props.
+     */
+    header?: (props: BbOffCanvasHeaderSlotProps) => any;
+    /**
+     * Replaces the default title text inside the header. Remains linked to the panel through `aria-labelledby`.
+     */
+    title?: (props: BbOffCanvasTitleSlotProps) => any;
+    /**
+     * Replaces the default close icon rendered inside the header's close button.
+     */
+    close?: (props: object) => any;
+    /**
+     * Replaces the default accessible description block. The provided content is linked to the panel via `aria-describedby`.
+     */
+    description?: (props: BbOffCanvasDescriptionSlotProps) => any;
+    /**
+     * Primary body content of the off-canvas panel, rendered in the scrollable body area.
+     */
+    default?: (props: object) => any;
+    /**
+     * Content rendered in the panel footer, below the body area. Typically used for action buttons.
+     */
+    footer?: (props: object) => any;
+};

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

@@ -1,95 +1,12 @@
-import { CommonProps } from '../../types/CommonProps';
-export type BbPaginationProps = Pick<CommonProps, 'disabled' | 'loading'> & {
-    align?: 'left' | 'right' | 'center';
-    /**
-     * String of text displayed in place of hidden pages
-     */
-    ellipsis?: string;
-    /**
-     * Label of the pagination
-     */
-    label?: string;
-    /**
-     * Maximum number of clickable pages displayed at all times.
-     * This has a tolerance of +/- 1 for odd / even numbering.
-     * It does not include ellipses.
-     */
-    maxSize?: number | string;
-    /**
-     * Synchronizes the current page with the url.
-     */
-    navigation?: boolean;
-    /**
-     * Replaces history rather than pushing it when changing tab.
-     */
-    replace?: boolean;
-    /**
-     * Defines the query key to reference for maintaining navigation
-     */
-    querykey?: string;
-    /**
-     * Total number of pages there is.
-     */
-    totalPages?: number | string;
-};
+import { BbPaginationProps, BbPaginationEvents, BbPaginationSlots } from './types';
+export type { BbPaginationProps, BbPaginationEvents, BbPaginationSlots };
 type __VLS_Props = BbPaginationProps;
-export type BbPaginationEvents = {
-    (e: 'update:modelValue', value: number): void;
-};
 type __VLS_PublicProps = {
     modelValue?: number;
 } & __VLS_Props;
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: Readonly<{
-        /**
-         * Replaces the default "previous page" button content.
-         */
-        previous?: (props: object) => any;
-        /**
-         * Replaces the default "next page" button content.
-         */
-        next?: (props: object) => any;
-        /**
-         * Replaces the default page number button content for each individual page.
-         * @param active - Whether this is the currently active page.
-         * @param disabled - Whether this page button is disabled.
-         * @param item - The page number this button represents.
-         */
-        item?: (props: {
-            active: boolean;
-            disabled: boolean;
-            item: number;
-        }) => any;
-        /**
-         * Replaces the default `…` ellipsis shown when pages overflow the visible range.
-         */
-        ellipsis?: (props: object) => any;
-    }> & {
-        /**
-         * Replaces the default "previous page" button content.
-         */
-        previous?: (props: object) => any;
-        /**
-         * Replaces the default "next page" button content.
-         */
-        next?: (props: object) => any;
-        /**
-         * Replaces the default page number button content for each individual page.
-         * @param active - Whether this is the currently active page.
-         * @param disabled - Whether this page button is disabled.
-         * @param item - The page number this button represents.
-         */
-        item?: (props: {
-            active: boolean;
-            disabled: boolean;
-            item: number;
-        }) => any;
-        /**
-         * Replaces the default `…` ellipsis shown when pages overflow the visible range.
-         */
-        ellipsis?: (props: object) => any;
-    };
+    slots: Readonly<BbPaginationSlots> & BbPaginationSlots;
     refs: {
         outercontainer: HTMLDivElement;
         innercontainer: HTMLUListElement;
@@ -103,9 +20,9 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     "onUpdate:modelValue"?: ((value: number) => any) | undefined;
 }>, {
     label: string;
-    align: "left" | "right" | "center";
     ellipsis: string;
     maxSize: number | string;
+    align: "left" | "right" | "center";
     querykey: string;
     totalPages: number | string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {

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

@@ -0,0 +1,80 @@
+import { CommonProps } from '../../types/CommonProps';
+export type BbPaginationProps = Pick<CommonProps, 'disabled' | 'loading'> & {
+    /**
+     * Alignment of the pagination control.
+     *
+     * @defaultValue `'right'`
+     */
+    align?: 'left' | 'right' | 'center';
+    /**
+     * String of text displayed in place of hidden pages.
+     *
+     * @defaultValue `'...'`
+     */
+    ellipsis?: string;
+    /**
+     * Label of the pagination navigation landmark.
+     *
+     * @defaultValue `'Paginazione'`
+     */
+    label?: string;
+    /**
+     * Maximum number of clickable pages displayed at all times.
+     * This has a tolerance of +/- 1 for odd / even numbering.
+     * It does not include ellipses.
+     *
+     * @defaultValue `6`
+     */
+    maxSize?: number | string;
+    /**
+     * Synchronizes the current page with the URL.
+     */
+    navigation?: boolean;
+    /**
+     * Replaces history rather than pushing it when changing page.
+     */
+    replace?: boolean;
+    /**
+     * Defines the query key to reference for maintaining navigation.
+     *
+     * @defaultValue `'page'`
+     */
+    querykey?: string;
+    /**
+     * Total number of pages.
+     *
+     * @defaultValue `1`
+     */
+    totalPages?: number | string;
+};
+export type BbPaginationEvents = {
+    /** Emitted when the active page changes. Payload is the new page number (1-based). */
+    (e: 'update:modelValue', value: number): void;
+};
+/** Props exposed by the `item` slot. */
+export type BbPaginationItemSlotProps = {
+    /** Whether this is the currently active page. */
+    active: boolean;
+    /** Whether this page button is disabled. */
+    disabled: boolean;
+    /** The page number this button represents. */
+    item: number;
+};
+export type BbPaginationSlots = {
+    /**
+     * Replaces the default "previous page" button content.
+     */
+    previous?: (props: object) => any;
+    /**
+     * Replaces the default "next page" button content.
+     */
+    next?: (props: object) => any;
+    /**
+     * Replaces the default page number button content for each individual page.
+     */
+    item?: (props: BbPaginationItemSlotProps) => any;
+    /**
+     * Replaces the default `…` ellipsis shown when pages overflow the visible range.
+     */
+    ellipsis?: (props: object) => any;
+};

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

@@ -1,131 +1,13 @@
 import { nextTick } from 'vue';
-import { CommonProps } from '../../types/CommonProps';
-export type PopoverTrigger = 'click' | 'contextMenu';
-export type BbPopoverProps = Pick<CommonProps, 'arrowPadding' | 'closeLabel' | 'block' | 'disabled' | 'eager' | 'id' | 'offset' | 'padding' | 'showClose' | 'theme' | 'transitionDuration'> & {
-    /**
-     * Position of the popover relative to the activator.
-     * Use `'cursor'` to anchor at the mouse/touch coordinates (hides arrow).
-     */
-    placement?: CommonProps['placement'] | 'cursor';
-    /**
-     * External activator element or component ref.
-     * When provided, the activator slot is not rendered and click events
-     * are attached programmatically to the referenced element.
-     */
-    activator?: HTMLElement | Record<string, any> | null;
-    /**
-     * Constrains the popover within a bounding element.
-     * When provided, the popover will not overflow this container's bounds (e.g. a sidebar).
-     * Accepts an HTMLElement, a Vue component ref, or a CSS selector string.
-     */
-    boundary?: HTMLElement | Record<string, any> | string | null;
-    /**
-     * Selector for the element that receives focus after opening.
-     * Defaults to the close button, or first focusable element if no close button.
-     */
-    focusTarget?: string;
-    /**
-     * Whether to restore focus to the activator when closed.
-     * @default true
-     */
-    restoreFocus?: boolean;
-    /**
-     * @deprecated Use a CSS class on the component instead.
-     */
-    theme?: string;
-    /**
-     * Interaction(s) that open the popover.
-     * Accepts a single trigger or an array to combine them.
-     * - `'click'` — left-click / tap (default)
-     * - `'contextMenu'` — right-click on desktop, long-press on mobile
-     * @default 'click'
-     */
-    trigger?: PopoverTrigger | PopoverTrigger[];
-    /**
-     * Width of the popover. Accepts pixels or percentage (relative to activator width).
-     */
-    width?: number | string;
-};
+import { BbPopoverProps, BbPopoverEvents, BbPopoverSlots, PopoverTrigger } from './types';
+export type { BbPopoverProps, BbPopoverEvents, BbPopoverSlots, PopoverTrigger };
 type __VLS_Props = BbPopoverProps;
-export type BbPopoverEvents = {
-    (e: 'shown'): void;
-    (e: 'hidden'): void;
-};
-declare const activatorProps: import('vue').ComputedRef<{
-    onContextmenu?: ((event: MouseEvent) => void) | undefined;
-    onPointerdown?: ((event: PointerEvent) => void) | undefined;
-    onPointermove?: ((event: PointerEvent) => void) | undefined;
-    onPointerup?: (() => void) | undefined;
-    onPointercancel?: (() => void) | undefined;
-    onClick?: ((event: MouseEvent) => Promise<void>) | undefined;
-    'aria-expanded': boolean | undefined;
-    'aria-controls': string | undefined;
-    'aria-haspopup': "dialog";
-    id: string;
-    disabled: boolean;
-    ref: (reference: unknown) => void;
-}>;
-declare const close: () => void;
 type __VLS_PublicProps = {
     modelValue?: boolean;
 } & __VLS_Props;
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: Readonly<{
-        /**
-         * The element that triggers the popover to open. Spread `props` onto your trigger element.
-         * @param props - Accessibility and positioning attributes to spread onto the activator element.
-         * @param disabled - Whether the popover is globally disabled.
-         * @param isOpen - Whether the popover is currently open.
-         * @param placement - The current placement of the popover panel.
-         */
-        activator?: (props: {
-            props: typeof activatorProps.value;
-            disabled: boolean;
-            isOpen: boolean;
-            placement: BbPopoverProps["placement"];
-        }) => any;
-        /**
-         * The popover body content rendered inside the floating panel.
-         * @param close - Programmatically closes the popover.
-         * @param disabled - Whether the popover is globally disabled.
-         * @param open - Whether the popover is currently open.
-         * @param placement - The current placement of the popover panel.
-         */
-        default?: (props: {
-            close: typeof close;
-            disabled: boolean;
-            open: boolean;
-            placement: BbPopoverProps["placement"];
-        }) => any;
-    }> & {
-        /**
-         * The element that triggers the popover to open. Spread `props` onto your trigger element.
-         * @param props - Accessibility and positioning attributes to spread onto the activator element.
-         * @param disabled - Whether the popover is globally disabled.
-         * @param isOpen - Whether the popover is currently open.
-         * @param placement - The current placement of the popover panel.
-         */
-        activator?: (props: {
-            props: typeof activatorProps.value;
-            disabled: boolean;
-            isOpen: boolean;
-            placement: BbPopoverProps["placement"];
-        }) => any;
-        /**
-         * The popover body content rendered inside the floating panel.
-         * @param close - Programmatically closes the popover.
-         * @param disabled - Whether the popover is globally disabled.
-         * @param open - Whether the popover is currently open.
-         * @param placement - The current placement of the popover panel.
-         */
-        default?: (props: {
-            close: typeof close;
-            disabled: boolean;
-            open: boolean;
-            placement: BbPopoverProps["placement"];
-        }) => any;
-    };
+    slots: Readonly<BbPopoverSlots> & BbPopoverSlots;
     refs: {
         popoverRef: ({
             $: import('vue').ComponentInternalInstance;
@@ -165,7 +47,7 @@ declare function __VLS_template(): {
             $el: any;
             $options: import('vue').ComponentOptionsBase<Readonly<{
                 modelValue?: boolean;
-            } & Pick<CommonProps, "eager" | "transitionDuration" | "arrowPadding" | "offset" | "padding" | "placement"> & {
+            } & Pick<import('../../types/CommonProps').CommonProps, "eager" | "transitionDuration" | "arrowPadding" | "offset" | "padding" | "placement"> & {
                 anchor?: any;
                 boundary?: HTMLElement | Record<string, any> | string | null;
                 dialog?: boolean;
@@ -208,7 +90,7 @@ declare function __VLS_template(): {
             flip: boolean;
         }> & Omit<Readonly<{
             modelValue?: boolean;
-        } & Pick<CommonProps, "eager" | "transitionDuration" | "arrowPadding" | "offset" | "padding" | "placement"> & {
+        } & Pick<import('../../types/CommonProps').CommonProps, "eager" | "transitionDuration" | "arrowPadding" | "offset" | "padding" | "placement"> & {
             anchor?: any;
             boundary?: HTMLElement | Record<string, any> | string | null;
             dialog?: boolean;
@@ -218,11 +100,7 @@ declare function __VLS_template(): {
         }> & Readonly<{
             "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
         }>, "transitionDuration" | "padding" | "tag" | "flip"> & import('vue').ShallowUnwrapRef<{}> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-            $slots: Readonly<{
-                default?: (props: object) => any;
-            }> & {
-                default?: (props: object) => any;
-            };
+            $slots: Readonly<import('../CommonPopover/types').CommonPopoverSlots> & import('../CommonPopover/types').CommonPopoverSlots;
         }) | null;
     };
     rootEl: any;
@@ -293,7 +171,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
         $el: any;
         $options: import('vue').ComponentOptionsBase<Readonly<{
             modelValue?: boolean;
-        } & Pick<CommonProps, "eager" | "transitionDuration" | "arrowPadding" | "offset" | "padding" | "placement"> & {
+        } & Pick<import('../../types/CommonProps').CommonProps, "eager" | "transitionDuration" | "arrowPadding" | "offset" | "padding" | "placement"> & {
             anchor?: any;
             boundary?: HTMLElement | Record<string, any> | string | null;
             dialog?: boolean;
@@ -336,7 +214,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
         flip: boolean;
     }> & Omit<Readonly<{
         modelValue?: boolean;
-    } & Pick<CommonProps, "eager" | "transitionDuration" | "arrowPadding" | "offset" | "padding" | "placement"> & {
+    } & Pick<import('../../types/CommonProps').CommonProps, "eager" | "transitionDuration" | "arrowPadding" | "offset" | "padding" | "placement"> & {
         anchor?: any;
         boundary?: HTMLElement | Record<string, any> | string | null;
         dialog?: boolean;
@@ -346,11 +224,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     }> & Readonly<{
         "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     }>, "transitionDuration" | "padding" | "tag" | "flip"> & import('vue').ShallowUnwrapRef<{}> & {} & import('@vue/runtime-core').ComponentCustomProperties & {} & {
-        $slots: Readonly<{
-            default?: (props: object) => any;
-        }> & {
-            default?: (props: object) => any;
-        };
+        $slots: Readonly<import('../CommonPopover/types').CommonPopoverSlots> & import('../CommonPopover/types').CommonPopoverSlots;
     }) | null;
 }, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

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

@@ -0,0 +1,99 @@
+import { CommonProps } from '../../types/CommonProps';
+export type PopoverTrigger = 'click' | 'contextMenu';
+export type BbPopoverProps = Pick<CommonProps, 'arrowPadding' | 'closeLabel' | 'block' | 'disabled' | 'eager' | 'id' | 'offset' | 'padding' | 'showClose' | 'theme' | 'transitionDuration'> & {
+    /**
+     * Position of the popover relative to the activator.
+     * Use `'cursor'` to anchor at the mouse/touch coordinates (hides arrow).
+     *
+     * @defaultValue `'bottom'`
+     */
+    placement?: CommonProps['placement'] | 'cursor';
+    /**
+     * External activator element or component ref.
+     * When provided, the activator slot is not rendered and click events
+     * are attached programmatically to the referenced element.
+     */
+    activator?: HTMLElement | Record<string, any> | null;
+    /**
+     * Constrains the popover within a bounding element.
+     * When provided, the popover will not overflow this container's bounds (e.g. a sidebar).
+     * Accepts an HTMLElement, a Vue component ref, or a CSS selector string.
+     */
+    boundary?: HTMLElement | Record<string, any> | string | null;
+    /**
+     * Selector for the element that receives focus after opening.
+     * Defaults to the close button, or first focusable element if no close button.
+     */
+    focusTarget?: string;
+    /**
+     * Whether to restore focus to the activator when closed.
+     *
+     * @defaultValue `true`
+     */
+    restoreFocus?: boolean;
+    /**
+     * Theme class applied to the popover container.
+     *
+     * @deprecated Use a CSS class on the component instead.
+     * @defaultValue `'default'`
+     */
+    theme?: string;
+    /**
+     * Interaction(s) that open the popover.
+     * Accepts a single trigger or an array to combine them.
+     * - `'click'` — left-click / tap (default)
+     * - `'contextMenu'` — right-click on desktop, long-press on mobile
+     *
+     * @defaultValue `'click'`
+     */
+    trigger?: PopoverTrigger | PopoverTrigger[];
+    /**
+     * Width of the popover. Accepts pixels or percentage (relative to activator width).
+     */
+    width?: number | string;
+};
+export type BbPopoverEvents = {
+    /** Emitted after the popover is fully opened and focus has been moved inside. */
+    (e: 'shown'): void;
+    /** Emitted after the popover is closed and focus has been restored to the activator. */
+    (e: 'hidden'): void;
+};
+/** Props exposed by the `activator` slot. */
+export type BbPopoverActivatorSlotProps = {
+    /** Accessibility and positioning attributes to spread onto the activator element. */
+    props: {
+        'aria-expanded'?: boolean;
+        'aria-controls'?: string;
+        'aria-haspopup': 'dialog';
+        id: string;
+        disabled: boolean;
+        ref: (reference: unknown) => void;
+    };
+    /** Whether the popover is globally disabled. */
+    disabled: boolean;
+    /** Whether the popover is currently open. */
+    isOpen: boolean;
+    /** The current placement of the popover panel. */
+    placement: BbPopoverProps['placement'];
+};
+/** Props exposed by the `default` slot. */
+export type BbPopoverDefaultSlotProps = {
+    /** Programmatically closes the popover. */
+    close: () => void;
+    /** Whether the popover is globally disabled. */
+    disabled: boolean;
+    /** Whether the popover is currently open. */
+    open: boolean;
+    /** The current placement of the popover panel. */
+    placement: BbPopoverProps['placement'];
+};
+export type BbPopoverSlots = {
+    /**
+     * The element that triggers the popover to open. Spread `props` onto your trigger element.
+     */
+    activator?: (props: BbPopoverActivatorSlotProps) => any;
+    /**
+     * The popover body content rendered inside the floating panel.
+     */
+    default?: (props: BbPopoverDefaultSlotProps) => any;
+};

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

@@ -1,17 +1,5 @@
-export type BbProgressProps = {
-    /**
-     * Used by v-model. It'a number contained between `min` and `max` that corresponds to the current value.
-     */
-    modelValue: number | null;
-    /**
-     * Minimum value. Lower cap.
-     */
-    min?: number;
-    /**
-     * Maximum value. Upper cap.
-     */
-    max?: number;
-};
+import { BbProgressProps } from './types';
+export type { BbProgressProps };
 declare const _default: import('vue').DefineComponent<BbProgressProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<BbProgressProps> & Readonly<{}>, {
     modelValue: number | null;
     max: number;

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

@@ -0,0 +1,20 @@
+export type BbProgressProps = {
+    /**
+     * Used by v-model. It's a number contained between `min` and `max` that corresponds to the current value.
+     *
+     * @defaultValue `0`
+     */
+    modelValue: number | null;
+    /**
+     * Minimum value. Lower cap.
+     *
+     * @defaultValue `0`
+     */
+    min?: number;
+    /**
+     * Maximum value. Upper cap.
+     *
+     * @defaultValue `100`
+     */
+    max?: number;
+};