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

package/dist/ai/source/BbDatePicker.md

@@ -731,7 +731,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/ai/source/BbDropdown.md

@@ -1959,7 +1959,7 @@ export type InternalGroup = DropdownEntryBase & {
 		| 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).
 	 *
@@ -2370,8 +2370,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/ai/source/BbDropdownGroup.md

@@ -539,7 +539,7 @@ export type InternalGroup = DropdownEntryBase & {
 		| 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).
 	 *
@@ -950,8 +950,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/ai/source/BbHoverCard.md

@@ -764,8 +764,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/ai/source/BbHoverCardPortal.md

@@ -103,8 +103,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/ai/source/BbPopover.md

@@ -990,8 +990,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/ai/source/BbPopoverPortal.md

@@ -117,8 +117,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/ai/source/BbSelectPopover.md

@@ -2344,7 +2344,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;
 	/**