bitboss-ui 3.0.0-beta.52 → 3.0.0-beta.53

package/dist/ai/source/CommonPopover.md

@@ -134,7 +134,12 @@ const resolveBoundary = (
 	return extractDomContainer(boundary) ?? undefined;
 };
 
-// Positioning boundary: keeps flip/shift inside these bounds.
+// Positioning boundary: `shift` keeps the bubble inside it alongside the
+// anchor (sideways under a menu, up/down beside a submenu). `flip` never reads
+// it: the bubble is in the top layer, so nothing clips it at a container's
+// edge, and flipping there only moved a table's last-row menu above its row.
+// Away from the anchor the bubble may pass the boundary; `flip` still turns it
+// at the viewport (the clipping ancestors).
 const boundaryElement = computed(() => resolveBoundary(props.boundary));
 // Sizing boundary: measured by `size` for availableHeight/Width. Undefined lets
 // floating-ui fall back to clippingAncestors (the viewport) so a short
@@ -168,9 +173,7 @@ const middleware = computed(() => {
 	const boundary = boundaryElement.value;
 	const overflowBoundary = overflowBoundaryElement.value;
 	return [
-		...(props.disableFlip
-			? []
-			: [flipMiddleware(boundary ? { boundary } : undefined)]),
+		...(props.disableFlip ? [] : [flipMiddleware()]),
 		offset(props.offset),
 		shift({ padding: props.padding, ...(boundary ? { boundary } : {}) }),
 		sizeMiddleware({
@@ -629,10 +632,10 @@ export type CommonPopoverProps = {
 	 */
 	anchor?: any;
 	/**
-	 * Constrains the popover's placement (`flip` / `shift` keep it inside); it
-	 * never clamps the size, so a short boundary never collapses the bubble:
-	 * use `overflowBoundary` for that. An HTMLElement, a component ref or a CSS
-	 * selector.
+	 * Keeps the popover inside this element alongside its anchor (sideways
+	 * above or below, vertically beside it); away from the anchor it may pass
+	 * the edge, and only the viewport flips it. It never clamps the size
+	 * (that is `overflowBoundary`). An HTMLElement, component ref or selector.
 	 */
 	boundary?: HTMLElement | Record<string, any> | string | null;
 	/**

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

@@ -78,10 +78,9 @@ export type BbBadgeProps = {
     size?: keyof Sizes;
     /**
      * Visual variant: `primary`, `secondary`, `destructive`, or `outline`.
-     * Register more via the vite plugin `badgeVariants` option and style
-     * `.bb-badge--<variant>` (set `--bg` / `--fg`). `'none'` renders no
-     * variant class — an escape hatch for a one-off look set through `--bg` /
-     * `--fg` on the element.
+     * Status colours are a registration (vite plugin `badgeVariants`, the
+     * `soft-*` palette in design-language.md) styled as `.bb-badge--<variant>`.
+     * `'none'` renders no variant class: set `--bg` / `--fg` on the element.
      * @defaultValue `'primary'`
      */
     variant?: BadgeVariantType;

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

@@ -78,7 +78,9 @@ export type BbColorPaletteProps = {
      */
     anchor?: ElementOrComponentRef;
     /**
-     * Constrains the popover within a bounding element.
+     * Constrains the popover within a bounding element: it stays inside it
+     * alongside its trigger (sideways for a popover above or below); away from
+     * the trigger it may pass the edge, and it flips at the viewport only.
      * Accepts an HTMLElement, a Vue component ref, or a CSS selector string.
      */
     boundary?: ElementOrComponentRefOrSelector;

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

@@ -183,7 +183,10 @@ export type BbDatePickerProps = {
     offset?: number;
     /** Minimum empty space to keep from the edge of the page. */
     padding?: number;
-    /** Constrains the popover within a bounding element or CSS selector. */
+    /**
+     * Constrains the popover within a bounding element or CSS selector:
+     * sideways only, alongside the trigger; it flips at the viewport.
+     */
     boundary?: ElementOrComponentRefOrSelector;
     /** Disable the automatic flip to the opposite side on overflow. */
     disableFlip?: boolean;

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

@@ -251,7 +251,7 @@ export type InternalGroup = DropdownEntryBase & {
     items: Array<InternalItem | InternalItem[]> | any[] | DropdownGroupItemsGetter;
     /**
      * Pipeline groups only. Path/getter producing each item's display text
-     * (a string item is its own text).
+     * (a primitive item is its own text; a getter still maps it).
      *
      * Unset: own `label`, else `text` (`{ label, value }` needs no accessor).
      *
@@ -586,8 +586,10 @@ export type BbDropdownProps = {
      */
     anchor?: HTMLElement | Record<string, any> | null;
     /**
-     * Constrains the dropdown within a bounding element.
-     * Accepts an HTMLElement, a Vue component ref, or a CSS selector string.
+     * Keeps the panel inside this element alongside its trigger (sideways for
+     * a menu above or below); away from the trigger it may pass the edge, and
+     * only the viewport flips it. An HTMLElement, a component ref or a CSS
+     * selector: a `useTemplateRef`, never `$refs.x` (not reactive).
      */
     boundary?: HTMLElement | Record<string, any> | string | null;
     /**

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

@@ -42,8 +42,9 @@ export type BbHoverCardProps = {
      */
     activator?: ElementOrComponentRef;
     /**
-     * Constrains the card within a bounding element.
-     * When provided, the card will not overflow this container's bounds (e.g. a sidebar).
+     * Constrains the card within a bounding element: it stays inside it
+     * alongside its trigger (sideways for a card above or below); away from
+     * the trigger it may pass the edge, and it flips at the viewport only.
      * Accepts an HTMLElement, a Vue component ref, or a CSS selector string.
      */
     boundary?: ElementOrComponentRefOrSelector;

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

@@ -54,8 +54,9 @@ export type BbPopoverProps = {
      */
     adaptive?: boolean;
     /**
-     * Constrains the popover within a bounding element.
-     * When provided, the popover will not overflow this container's bounds (e.g. a sidebar).
+     * Constrains the popover within a bounding element: it stays inside it
+     * alongside its trigger (sideways for a popover above or below); away from
+     * the trigger it may pass the edge, and it flips at the viewport only.
      * Accepts an HTMLElement, a Vue component ref, or a CSS selector string.
      */
     boundary?: ElementOrComponentRefOrSelector;

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

@@ -143,7 +143,9 @@ export type BbSelectPopoverProps<Item> = {
      */
     autocomplete?: InputHTMLAttributes['autocomplete'];
     /**
-     * Constrains the popover to a specific boundary element.
+     * Constrains the popover to a specific boundary element: it stays inside
+     * it alongside its trigger (sideways for a popover above or below); away
+     * from the trigger it may pass the edge, and it flips at the viewport only.
      */
     boundary?: HTMLElement | Record<string, any> | string | null;
     /**