bitboss-ui 2.1.135 → 3.0.0-alpha.1

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

@@ -1,5 +1,8 @@
-import { CommonProps } from '../../types/CommonProps';
-export type BbPaginationProps = Pick<CommonProps, 'disabled' | 'loading'> & {
+export type BbPaginationProps = {
+    /**
+     * Disables the component
+     */
+    disabled?: boolean;
     /**
      * Alignment of the pagination control.
      *
@@ -13,9 +16,8 @@ export type BbPaginationProps = Pick<CommonProps, 'disabled' | 'loading'> & {
      */
     ellipsis?: string;
     /**
-     * Label of the pagination navigation landmark.
-     *
-     * @defaultValue `'Paginazione'`
+     * Label of the pagination navigation landmark. When unset, falls back to the
+     * localized `pagination.label` (`'Pagination'` / `'Paginazione'`).
      */
     label?: string;
     /**
@@ -28,10 +30,25 @@ export type BbPaginationProps = Pick<CommonProps, 'disabled' | 'loading'> & {
     maxSize?: number | string;
     /**
      * Synchronizes the current page with the URL.
+     *
+     * Pair it with `replace` — see that prop.
      */
     navigation?: boolean;
+    /**
+     * Number of items per page. Together with `totalItems` it derives the page
+     * count (`ceil(totalItems / perPage)`); when unset, one page holds
+     * everything. With a `tableId` it is also published to the shared table
+     * context, exactly like the table's own `per-page` prop.
+     */
+    perPage?: number | string;
     /**
      * Replaces history rather than pushing it when changing page.
+     *
+     * Recommended default whenever `navigation` is on: the URL keeps the
+     * current page (deep-linkable, survives reload) while Back returns to the
+     * page the user came from, instead of stepping back through every page they
+     * clicked through. Without it, a user who paged to 12 needs eleven Backs to
+     * leave the list.
      */
     replace?: boolean;
     /**
@@ -39,18 +56,36 @@ export type BbPaginationProps = Pick<CommonProps, 'disabled' | 'loading'> & {
      *
      * @defaultValue `'page'`
      */
-    querykey?: string;
+    queryKey?: string;
     /**
-     * Total number of pages.
-     *
-     * @defaultValue `1`
+     * Id of a `BbTable` to pair with through the shared table context (see
+     * `useBbTableContext`). The current page is kept two-way synced with the
+     * table's context state, and the context's page count drives the control,
+     * overriding the local props. Any of `totalItems`, `perPage`, and
+     * `totalPages` set here are published to the context, so the server's
+     * pagination fields can be passed to whichever component is convenient —
+     * the table's equivalent props do the same. The table must be given the
+     * same `id`.
+     */
+    tableId?: string;
+    /**
+     * Total number of items across all pages. When set, the page count is
+     * derived as `ceil(totalItems / perPage)` and wins over `totalPages`. With
+     * a `tableId` it is also published to the shared table context, exactly
+     * like the table's own `total-items` prop.
+     */
+    totalItems?: number | string;
+    /**
+     * Total number of pages. A shortcut for when the server reports a page
+     * count rather than a row count — a page count derived from `totalItems`
+     * (locally or through the shared table context) always wins over it. Falls
+     * back to `1` when nothing provides a count.
      */
     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;
-};
+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. */
@@ -64,11 +99,11 @@ export type BbPaginationSlots = {
     /**
      * Replaces the default "previous page" button content.
      */
-    previous?: (props: object) => any;
+    previous?: (props: Record<string, never>) => any;
     /**
      * Replaces the default "next page" button content.
      */
-    next?: (props: object) => any;
+    next?: (props: Record<string, never>) => any;
     /**
      * Replaces the default page number button content for each individual page.
      */
@@ -76,5 +111,5 @@ export type BbPaginationSlots = {
     /**
      * Replaces the default `…` ellipsis shown when pages overflow the visible range.
      */
-    ellipsis?: (props: object) => any;
+    ellipsis?: (props: Record<string, never>) => any;
 };

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

@@ -1,37 +1,32 @@
-import { BbPopoverProps, BbPopoverSlots, PopoverTrigger } from './types';
+import { BbPopoverProps, BbPopoverEvents, BbPopoverSlots, PopoverTrigger } from './types';
+export type { BbPopoverProps, BbPopoverEvents, BbPopoverSlots, PopoverTrigger };
 type __VLS_Props = BbPopoverProps;
 type __VLS_Slots = BbPopoverSlots;
 type __VLS_ModelProps = {
     modelValue?: boolean;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_base: import('vue').DefineComponent<__VLS_PublicProps, {
-    /** Opens the popover programmatically */
-    show: () => Promise<void>;
-    /** Closes the popover programmatically */
-    close: () => void;
-    /** Whether the popover is currently open */
-    isOpen: import('vue').ComputedRef<boolean>;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare const __VLS_base: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => any;
 } & {
+    show: () => any;
+    hide: () => any;
     shown: () => any;
     hidden: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onShow?: (() => any) | undefined;
+    onHide?: (() => any) | undefined;
     onShown?: (() => any) | undefined;
     onHidden?: (() => any) | undefined;
 }>, {
-    arrowPadding: number;
+    placement: import('../..').Placement | "cursor";
     offset: number;
     padding: number;
-    placement: "left" | "right" | "top" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "cursor";
     transitionDuration: number;
-    showClose: boolean;
-    theme: string;
-    scrollable: boolean;
+    adaptive: boolean;
     trigger: PopoverTrigger | PopoverTrigger[];
-    restoreFocus: boolean;
+    scrollable: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/BbPopover/BbPopover.vue.js

@@ -0,0 +1,6 @@
+import e from "./BbPopover.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                  */
+//#region src/components/BbPopover/BbPopover.vue
+var t = e;
+//#endregion
+export { t as default };

package/dist/components/BbPopover/BbPopover.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,310 @@
+import { useId as e } from "../../composables/useId.js";
+import { useUntil as t } from "../../composables/useUntil.js";
+import { removedPropsFor as n } from "../../deprecation/removedProps.js";
+import { warnRemovedAttrs as r } from "../../utilities/functions/warnRemovedAttrs.js";
+import { extractDomContainer as i } from "../../utilities/functions/extractDomContainer.js";
+import { transitions as a } from "../../utilities/misc/transitions.js";
+import ee from "../CommonPopover/CommonPopover.vue.js";
+import { parseWidthString as o } from "../../utilities/functions/parseWidthString.js";
+import { useMobile as te } from "../../composables/useMobile.js";
+import ne from "../BbOffCanvas/BbOffCanvas.vue.js";
+import { isTopEscapeEntry as re, pushEscapeEntry as ie, removeEscapeEntry as ae } from "./escapeStack.js";
+import { config as oe } from "virtual:bitboss-ui/config";
+import { Fragment as se, computed as s, createBlock as c, createCommentVNode as l, createElementBlock as u, createElementVNode as d, createSlots as ce, defineComponent as le, mergeModels as f, mergeProps as p, nextTick as ue, normalizeClass as de, normalizeProps as fe, normalizeStyle as pe, onBeforeUnmount as me, onMounted as he, openBlock as m, ref as h, renderSlot as g, unref as _, useModel as ge, useTemplateRef as _e, watch as v, withCtx as y } from "vue";
+import { useElementSize as ve, useIntersectionObserver as ye } from "@vueuse/core";
+//#region src/components/BbPopover/BbPopover.vue?vue&type=script&setup=true&lang.ts
+var be = ["inert"], xe = {
+	key: 0,
+	class: "bb-popover__header"
+}, Se = { class: "bb-popover__content scrollbar-border" }, Ce = {
+	key: 1,
+	class: "bb-popover__footer"
+}, we = 500, Te = 10, b = /*@__PURE__*/ le({
+	inheritAttrs: !1,
+	__name: "BbPopover",
+	props: /*@__PURE__*/ f({
+		activator: {},
+		adaptive: {
+			type: Boolean,
+			default: void 0
+		},
+		boundary: {},
+		disabled: { type: Boolean },
+		eager: { type: Boolean },
+		focusTarget: {},
+		id: {},
+		offset: { default: 3 },
+		offCanvasProps: {},
+		padding: { default: 10 },
+		placement: { default: "bottom" },
+		scrollable: {
+			type: Boolean,
+			default: !1
+		},
+		transitionDuration: { default: a.medium },
+		trigger: { default: "click" },
+		width: {}
+	}, {
+		modelValue: {
+			type: Boolean,
+			default: !1
+		},
+		modelModifiers: {}
+	}),
+	emits: /*@__PURE__*/ f([
+		"show",
+		"hide",
+		"shown",
+		"hidden"
+	], ["update:modelValue"]),
+	setup(a, { emit: le }) {
+		let f = ge(a, "modelValue"), b = a, x = le;
+		process.env.NODE_ENV !== "production" && r("BbPopover", n("BbPopover"));
+		let { id: Ee } = e(), S = b.id ?? Ee.value, C = `bbp_${S}`, w = h(), T = _e("popoverRef"), E = s(() => i(T.value)), D = t(f), O = s(() => b.activator != null), { isMobile: k } = te(), A = () => (b.adaptive ?? oe.adaptive) && k.value ? "canvas" : "popover", j = h(A()), M = s(() => j.value === "canvas");
+		v([
+			() => b.adaptive,
+			k,
+			f
+		], () => {
+			f.value || (j.value = A());
+		});
+		let De = s(() => ({
+			side: "bottom",
+			size: "auto",
+			draggable: !0,
+			eager: b.eager,
+			disabled: b.disabled,
+			focusTarget: b.focusTarget,
+			transitionDuration: b.transitionDuration,
+			...b.offCanvasProps
+		})), Oe = () => {
+			w.value?.focus(), x("hidden");
+		}, N = s(() => {
+			let e = b.trigger;
+			return new Set(Array.isArray(e) ? e : [e]);
+		}), P = (e, t) => ({ getBoundingClientRect: () => ({
+			x: e,
+			y: t,
+			width: 0,
+			height: 0,
+			top: t,
+			left: e,
+			right: e,
+			bottom: t,
+			toJSON() {
+				return this;
+			}
+		}) }), F = h(null), ke = s(() => b.placement === "cursor" && F.value ? F.value : w.value), I, L = null, R = !1, z = () => {
+			clearTimeout(I), L = null;
+		}, B = (e) => {
+			w.value = i(e) ?? void 0;
+		}, Ae = s(() => {
+			let e = N.value;
+			return {
+				"aria-expanded": D.value ? f.value : void 0,
+				"aria-controls": D.value ? C : void 0,
+				"aria-haspopup": "dialog",
+				id: S,
+				disabled: !!b.disabled,
+				ref: B,
+				...e.has("click") ? { onClick: J } : {},
+				...e.has("contextMenu") ? {
+					onContextmenu: Y,
+					onPointerdown: X,
+					onPointermove: Z,
+					onPointerup: Q,
+					onPointercancel: Q
+				} : {}
+			};
+		});
+		v(() => b.activator, (e) => {
+			e && B(e);
+		}, { immediate: !0 }), v([w, N], ([e, t], n, r) => {
+			if (!e || !O.value) return;
+			let i = [];
+			t.has("click") && (e.addEventListener("click", J), i.push(() => e.removeEventListener("click", J))), t.has("contextMenu") && (e.addEventListener("contextmenu", Y), e.addEventListener("pointerdown", X), e.addEventListener("pointermove", Z), e.addEventListener("pointerup", Q), e.addEventListener("pointercancel", Q), i.push(() => {
+				e.removeEventListener("contextmenu", Y), e.removeEventListener("pointerdown", X), e.removeEventListener("pointermove", Z), e.removeEventListener("pointerup", Q), e.removeEventListener("pointercancel", Q), z();
+			})), e.setAttribute("aria-haspopup", "dialog"), r(() => {
+				i.forEach((e) => e()), e.removeAttribute("aria-expanded"), e.removeAttribute("aria-controls"), e.removeAttribute("aria-haspopup");
+			});
+		}, { immediate: !0 }), v([
+			w,
+			f,
+			D
+		], ([e, t, n]) => {
+			!e || !O.value || !n || (e.setAttribute("id", S), e.setAttribute("aria-expanded", String(t)), e.setAttribute("aria-controls", C));
+		}, { immediate: !0 }), ye(w, ([{ intersectionRatio: e }]) => {
+			e !== 1 && f.value && !M.value && $();
+		}, { threshold: [0, 1] });
+		let V = (e) => {
+			let t = e.target;
+			if (!(t instanceof Node)) return;
+			let n = E.value?.contains(t), r = w.value?.contains(t);
+			!n && !r && $();
+		}, H = Symbol("bb-popover"), je = (e) => {
+			e.key === "Escape" && re(H) && (e.preventDefault(), e.stopImmediatePropagation(), $());
+		}, Me = () => {
+			ie(H), document.addEventListener("click", V, { passive: !0 }), document.addEventListener("contextmenu", V, { passive: !0 }), document.addEventListener("keydown", je, { capture: !0 });
+		}, Ne = () => {
+			ae(H), document.removeEventListener("click", V), document.removeEventListener("contextmenu", V), document.removeEventListener("keydown", je, { capture: !0 });
+		}, U = !1, W = async () => {
+			if (M.value) return;
+			U = !0, x("show"), Me(), await ue();
+			let e = b.focusTarget ?? "[tabindex]:not([tabindex=\"-1\"]), button, a, input, select, textarea", t = E.value?.querySelector(e);
+			t instanceof HTMLElement && t.focus(), x("shown");
+		}, Pe = () => {
+			U && (U = !1, x("hide"), Ne(), w.value && w.value.focus(), x("hidden"));
+		}, G = h(!f.value), K;
+		v(f, (e) => {
+			clearTimeout(K), e ? (j.value = A(), G.value = !1, W()) : (K = setTimeout(() => {
+				G.value = !0;
+			}, b.transitionDuration), Pe());
+		}), he(() => {
+			f.value && W();
+		}), me(() => {
+			clearTimeout(K), z(), Ne();
+		});
+		let q = () => {
+			b.disabled || (f.value = !0);
+		}, J = (e) => {
+			if (f.value) {
+				$();
+				return;
+			}
+			if (R) {
+				R = !1, e.preventDefault(), e.stopPropagation();
+				return;
+			}
+			e.stopImmediatePropagation(), b.placement === "cursor" && (F.value = P(e.clientX, e.clientY)), q();
+		}, Y = (e) => {
+			b.disabled || (e.preventDefault(), e.stopPropagation(), !(b.placement === "cursor" && (F.value = P(e.clientX, e.clientY), f.value)) && (f.value ? $() : q()));
+		}, X = (e) => {
+			b.disabled || e.pointerType === "mouse" || (R = !1, L = {
+				x: e.clientX,
+				y: e.clientY
+			}, I = setTimeout(() => {
+				R = !0, b.placement === "cursor" && L && (F.value = P(L.x, L.y)), L = null, q();
+			}, we));
+		}, Z = (e) => {
+			if (!L) return;
+			let t = e.clientX - L.x, n = e.clientY - L.y;
+			Math.sqrt(t * t + n * n) > Te && z();
+		}, Q = () => {
+			z();
+		}, $ = () => {
+			f.value = !1;
+		}, Fe = s(() => {
+			if (!b.width) return !1;
+			let { unit: e } = o(b.width);
+			return e === "%";
+		}), { width: Ie } = ve(s(() => Fe.value ? w.value : void 0), {
+			width: 0,
+			height: 0
+		}, { box: "border-box" }), Le = s(() => {
+			if (!b.width) return;
+			let { value: e, unit: t } = o(b.width);
+			return t === "%" && w.value ? `${Ie.value * (e / 100)}px` : `${e}px`;
+		});
+		return (e, t) => (m(), u(se, null, [O.value ? l("", !0) : g(e.$slots, "activator", fe(p({ key: 0 }, {
+			props: Ae.value,
+			disabled: !!e.disabled,
+			isOpen: f.value,
+			placement: e.placement
+		}))), M.value ? (m(), c(ne, p({
+			key: 1,
+			id: C,
+			modelValue: f.value,
+			"onUpdate:modelValue": t[0] ||= (e) => f.value = e,
+			class: "bb-popover-offcanvas"
+		}, De.value, {
+			onHidden: Oe,
+			onHide: t[1] ||= (e) => x("hide"),
+			onShow: t[2] ||= (e) => x("show"),
+			onShown: t[3] ||= (e) => x("shown")
+		}), ce({
+			default: y(() => [g(e.$slots, "default", {
+				close: $,
+				disabled: !!e.disabled,
+				open: f.value,
+				placement: e.placement
+			})]),
+			_: 2
+		}, [e.$slots.header ? {
+			name: "header",
+			fn: y(() => [g(e.$slots, "header", {
+				close: $,
+				disabled: !!e.disabled,
+				open: f.value,
+				placement: e.placement
+			})]),
+			key: "0"
+		} : void 0, e.$slots.footer ? {
+			name: "footer",
+			fn: y(() => [g(e.$slots, "footer", {
+				close: $,
+				disabled: !!e.disabled,
+				open: f.value,
+				placement: e.placement
+			})]),
+			key: "1"
+		} : void 0]), 1040, ["modelValue"])) : (m(), c(ee, p({
+			key: 2,
+			id: C,
+			ref_key: "popoverRef",
+			ref: T,
+			modelValue: f.value,
+			"onUpdate:modelValue": t[4] ||= (e) => f.value = e,
+			anchor: ke.value,
+			"aria-labelledby": _(D) ? _(S) : void 0,
+			boundary: e.boundary,
+			class: "bb-popover",
+			dialog: "",
+			eager: e.eager,
+			"hide-arrow": "",
+			offset: e.offset,
+			padding: e.padding,
+			placement: e.placement === "cursor" ? "bottom-start" : e.placement,
+			style: { width: Le.value },
+			"transition-duration": e.transitionDuration
+		}, e.$attrs), {
+			default: y(({ availableHeight: t }) => [d("span", {
+				class: de(["bb-popover__panel", { "bb-popover__panel--scrollable": e.scrollable }]),
+				inert: G.value,
+				style: pe({ "--max-h": e.scrollable && t != null ? `${t}px` : void 0 })
+			}, [
+				e.$slots.header ? (m(), u("span", xe, [g(e.$slots, "header", {
+					close: $,
+					disabled: !!e.disabled,
+					open: f.value,
+					placement: e.placement
+				})])) : l("", !0),
+				d("span", Se, [g(e.$slots, "default", {
+					close: $,
+					disabled: !!e.disabled,
+					open: f.value,
+					placement: e.placement
+				})]),
+				e.$slots.footer ? (m(), u("span", Ce, [g(e.$slots, "footer", {
+					close: $,
+					disabled: !!e.disabled,
+					open: f.value,
+					placement: e.placement
+				})])) : l("", !0)
+			], 14, be)]),
+			_: 3
+		}, 16, [
+			"modelValue",
+			"anchor",
+			"aria-labelledby",
+			"boundary",
+			"eager",
+			"offset",
+			"padding",
+			"placement",
+			"style",
+			"transition-duration"
+		]))], 64));
+	}
+});
+//#endregion
+export { b as default };

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

@@ -0,0 +1,6 @@
+/** Register (or move to top) an open popover. */
+export declare const pushEscapeEntry: (key: symbol) => void;
+/** Remove a popover from the stack (on close / unmount). Safe if absent. */
+export declare const removeEscapeEntry: (key: symbol) => void;
+/** True when `key` is the top-most (innermost) open popover. */
+export declare const isTopEscapeEntry: (key: symbol) => boolean;

package/dist/components/BbPopover/escapeStack.js

@@ -0,0 +1,10 @@
+//#region src/components/BbPopover/escapeStack.ts
+var e = [], t = (t) => {
+	let n = e.indexOf(t);
+	n !== -1 && e.splice(n, 1), e.push(t);
+}, n = (t) => {
+	let n = e.indexOf(t);
+	n !== -1 && e.splice(n, 1);
+}, r = (t) => e[e.length - 1] === t;
+//#endregion
+export { r as isTopEscapeEntry, t as pushEscapeEntry, n as removeEscapeEntry };

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

@@ -1,43 +1,84 @@
-import { CommonProps } from '../../types/CommonProps';
+import { HTMLAttributes } from 'vue';
+import { ElementOrComponentRef, ElementOrComponentRefOrSelector } from '../../types/CommonProps';
+import { Placement } from '../../types/Placement';
+import { BbOffCanvasProps } from '../BbOffCanvas/types';
 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';
+export type BbPopoverProps = {
     /**
      * 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;
+    activator?: ElementOrComponentRef;
+    /**
+     * On mobile viewports (below `config.mobileMaxWidth`), render the popover as a
+     * bottom-anchored, auto-sized off-canvas sheet instead of a floating panel.
+     * The `header`, `default` and `footer` slots are forwarded to the sheet.
+     *
+     * The `width` prop is intentionally ignored in this mode (it means a different
+     * thing for a sheet); pass `offCanvasProps` to size or otherwise customise the
+     * sheet.
+     *
+     * When unset, falls back to the global `config.adaptive`.
+     * @defaultValue `config.adaptive` (`true`)
+     */
+    adaptive?: boolean;
     /**
      * 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;
+    boundary?: ElementOrComponentRefOrSelector;
+    /**
+     * Disables the component.
+     */
+    disabled?: boolean;
+    /**
+     * Prevents rendering content before it's made visible.
+     */
+    eager?: boolean;
     /**
      * Selector for the element that receives focus after opening.
-     * Defaults to the close button, or first focusable element if no close button.
+     * Defaults to the first focusable element inside the popover.
      */
     focusTarget?: string;
     /**
-     * Whether to restore focus to the activator when closed.
+     * The identifier of the component.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Space the floating container will maintain from the activator.
+     */
+    offset?: number;
+    /**
+     * Overrides forwarded to the underlying `BbOffCanvas` when `adaptive` renders
+     * the sheet on mobile. Merged over the adaptive defaults
+     * (`direction: 'bottom'`, `size: 'auto'`, `draggable: true`). Ignored when
+     * `adaptive` is `false`.
+     */
+    offCanvasProps?: Partial<BbOffCanvasProps>;
+    /**
+     * Minimum empty space to keep from the edge of the page.
+     */
+    padding?: number;
+    /**
+     * Position of the popover relative to the activator.
+     * Use `'cursor'` to anchor at the mouse/touch coordinates (hides arrow).
      *
-     * @defaultValue `true`
+     * @defaultValue `'bottom'`
      */
-    restoreFocus?: boolean;
+    placement?: Placement | 'cursor';
     /**
-     * Theme class applied to the popover container.
+     * Caps the popover height to the available viewport space and enables internal scrolling.
+     * Useful for tall content like filter panels. Not recommended for atomic popovers (calendars, color pickers).
      *
-     * @deprecated Use a CSS class on the component instead.
-     * @defaultValue `'default'`
+     * @defaultValue `false`
+     */
+    scrollable?: boolean;
+    /**
+     * How long the transition has to last in milliseconds.
      */
-    theme?: string;
+    transitionDuration?: number;
     /**
      * Interaction(s) that open the popover.
      * Accepts a single trigger or an array to combine them.
@@ -47,18 +88,16 @@ export type BbPopoverProps = Pick<CommonProps, 'arrowPadding' | 'closeLabel' | '
      * @defaultValue `'click'`
      */
     trigger?: PopoverTrigger | PopoverTrigger[];
-    /**
-     * Caps the popover height to the available viewport space and enables internal scrolling.
-     *
-     * @defaultValue `false`
-     */
-    scrollable?: boolean;
     /**
      * Width of the popover. Accepts pixels or percentage (relative to activator width).
      */
     width?: number | string;
 };
 export type BbPopoverEvents = {
+    /** Emitted as soon as the popover starts to open (model becomes true). */
+    (e: 'show'): void;
+    /** Emitted as soon as the popover starts to close (model becomes false). */
+    (e: 'hide'): void;
     /** 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. */
@@ -66,6 +105,12 @@ export type BbPopoverEvents = {
 };
 /** Props exposed by the `activator` slot. */
 export type BbPopoverActivatorSlotProps = {
+    /** 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'];
     /** Accessibility and positioning attributes to spread onto the activator element. */
     props: {
         'aria-expanded'?: boolean;
@@ -75,12 +120,6 @@ export type BbPopoverActivatorSlotProps = {
         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 = {
@@ -98,8 +137,22 @@ export type BbPopoverSlots = {
      * The element that triggers the popover to open. Spread `props` onto your trigger element.
      */
     activator?: (props: BbPopoverActivatorSlotProps) => any;
+    /**
+     * Content pinned to the top of the panel, outside the scroll region.
+     * Stays visible while the body scrolls (when `scrollable`) and carries its
+     * own padding and bottom divider, so a title or search field needs no
+     * negative-margin or `sticky` workarounds.
+     */
+    header?: (props: BbPopoverDefaultSlotProps) => any;
     /**
      * The popover body content rendered inside the floating panel.
      */
     default?: (props: BbPopoverDefaultSlotProps) => any;
+    /**
+     * Content pinned to the bottom of the panel, outside the scroll region.
+     * Stays visible while the body scrolls (when `scrollable`) and carries its
+     * own padding and top divider, so footer actions need no negative-margin or
+     * `sticky` workarounds.
+     */
+    footer?: (props: BbPopoverDefaultSlotProps) => any;
 };

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

@@ -1,4 +1,5 @@
 import { BbProgressProps } from './types';
+export type { BbProgressProps };
 declare const __VLS_export: import('vue').DefineComponent<BbProgressProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<BbProgressProps> & Readonly<{}>, {
     modelValue: number | null;
     max: number;