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

package/dist/ai/guides/component-picker.md

@@ -243,7 +243,7 @@ compose it or write it yourself.
 | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `BbColumnManager` — show/hide/reorder columns                                                    | Does not exist as a component. Order is `v-model:order` on `BbTable` (an array of keys any panel can write; `reorderable` adds the built-in header drag + keyboard handle); visibility is `hidden: true` on the column definition (the column stays declared and keeps its slot in the order; header slots get a `hideColumn()` that fires `hide:column`). Compose the panel from `BbPopover` + `BbCheckbox`.                                                                          |
 | `BbKanban` / drag-and-drop board                                                                 | Does not exist. There is no reusable DnD primitive in the library (`BbTable`'s header drag and row drag are internal to the table) — compose the board from `BbTable` (a table/list view of the same data) or hand-roll the drag-and-drop interaction yourself.                                                                                                                                                                                                                        |
-| `BbSortableList` / drag rows to reorder                                                          | [BbTable](../BbTable.md) with `reorderable-rows`: a grip per row (mouse, pen, touch, keyboard), and `reorder:rows` reports `{ item, from, to }` — the table never reorders `items`, your handler splices it. A list without columns is a one-column table.                                                                                                                                                                                                                             |
+| `BbSortableList` / drag rows to reorder                                                          | [BbTable](../BbTable.md) with `reorderable-rows`: a drag handle per row (mouse, pen, touch, keyboard), and `reorder:rows` reports `{ item, from, to }` — the table never reorders `items`, your handler splices it. A list without columns is a one-column table.                                                                                                                                                                                                                      |
 | `BbModal`                                                                                        | It is [BbDialog](../BbDialog.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | `BbDrawer` / `BbSheet`                                                                           | It is [BbOffCanvas](../BbOffCanvas.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | `BbCombobox` / `BbAutocomplete`                                                                  | It is [BbSelect](../BbSelect.md) / [BbSelectPopover](../BbSelectPopover.md) — search is built in, see `disable-writing`.                                                                                                                                                                                                                                                                                                                                                               |

package/dist/ai/guides/migration/from-async-validator.md

@@ -594,32 +594,37 @@ function isEmailFree(email: string): Promise<boolean> {
 	return answer;
 }
 
-const team = z
-	.object({
-		company: z.object({
-			name: z
-				.string('Enter the company name')
-				.trim()
-				.min(1, 'Enter the company name'),
-			// Optional: absent or null passes, anything typed must match.
-			vat: z
-				.string()
-				.regex(/^IT\d{11}$/, 'IT and 11 digits')
-				.nullish(),
-		}),
-		email: z
-			.email('Enter a valid email')
-			.refine(isEmailFree, 'This email already has an account'),
-		password: z.string('Choose a password').min(8, 'At least 8 characters'),
-		confirm: z.string('Repeat the password'),
-		plan: z.enum(['starter', 'team'], 'Pick a plan'),
-		members: z.array(z.object({ email: z.email('Enter a valid email') })),
-		terms: z.literal(true, 'Accept the terms'),
-	})
-	.refine((values) => values.password === values.confirm, {
-		message: 'The passwords do not match',
-		path: ['confirm'],
-	});
+const teamFields = z.object({
+	company: z.object({
+		name: z
+			.string('Enter the company name')
+			.trim()
+			.min(1, 'Enter the company name'),
+		// Optional: absent or null passes, anything typed must match.
+		vat: z
+			.string()
+			.regex(/^IT\d{11}$/, 'IT and 11 digits')
+			.nullish(),
+	}),
+	email: z
+		.email('Enter a valid email')
+		.refine(isEmailFree, 'This email already has an account'),
+	password: z.string('Choose a password').min(8, 'At least 8 characters'),
+	confirm: z.string('Repeat the password'),
+	plan: z.enum(['starter', 'team'], 'Pick a plan'),
+	members: z.array(z.object({ email: z.email('Enter a valid email') })),
+	terms: z.literal(true, 'Accept the terms'),
+});
+
+// `when`: the mismatch shows while other fields still fail (zod otherwise
+// skips an object refinement until the whole object parses).
+const team = teamFields.refine((values) => values.password === values.confirm, {
+	message: 'The passwords do not match',
+	path: ['confirm'],
+	when: (payload) =>
+		teamFields.pick({ password: true, confirm: true }).safeParse(payload.value)
+			.success,
+});
 
 const plans = [
 	{ label: 'Starter', value: 'starter' },
@@ -1102,28 +1107,37 @@ function isUsernameFree(username: string): Promise<boolean> {
 
 const text = (message: string) => z.string(message).trim().min(1, message);
 
-const profile = z
-	.object({
-		account: z.object({
-			username: text('Username is required')
-				.min(3, '3 to 20 characters')
-				.max(20, '3 to 20 characters')
-				.refine(isUsernameFree, 'That username is taken'),
-			email: z.email('Email is not a valid email'),
-		}),
-		password: z.string('Password is required').min(8, 'At least 8 characters'),
-		confirm: z.string('Repeat password is required'),
-		addresses: z.array(
-			z.object({
-				street: text('Enter the street'),
-				city: text('Enter the city'),
-			})
-		),
-	})
-	.refine((values) => values.password === values.confirm, {
+const profileFields = z.object({
+	account: z.object({
+		username: text('Username is required')
+			.min(3, '3 to 20 characters')
+			.max(20, '3 to 20 characters')
+			.refine(isUsernameFree, 'That username is taken'),
+		email: z.email('Email is not a valid email'),
+	}),
+	password: z.string('Password is required').min(8, 'At least 8 characters'),
+	confirm: z.string('Repeat password is required'),
+	addresses: z.array(
+		z.object({
+			street: text('Enter the street'),
+			city: text('Enter the city'),
+		})
+	),
+});
+
+// `when`: the mismatch shows while other fields still fail (zod otherwise
+// skips an object refinement until the whole object parses).
+const profile = profileFields.refine(
+	(values) => values.password === values.confirm,
+	{
 		message: 'The passwords do not match',
 		path: ['confirm'],
-	});
+		when: (payload) =>
+			profileFields
+				.pick({ password: true, confirm: true })
+				.safeParse(payload.value).success,
+	}
+);
 
 let nextId = 2;
 const formState = ref<{

package/dist/ai/guides/migration/v2-to-v3.md

@@ -1883,6 +1883,30 @@ Nothing here fails to compile — these change what existing code does.
     component that always forwards `:highlighted="props.highlighted"` now
     binds every inner table (its rows get the pointer cursor even when the
     page binds nothing): add `:highlightable="props.highlighted !== undefined"`.
+59. **A function `item-text` runs on string items** (since
+    3.0.0-beta.53). Over a `string[]` it used to be skipped, so
+    `:item-text="(code) => labels[code]"` showed the raw codes and the advice
+    was to wrap each code in an object. Now it labels them and the codes stay
+    the values, as it already did over a `number[]`. A path (`item-text` /
+    `item-value="name"`) on a primitive keeps the primitive itself, where a
+    number used to show blank and the value was `undefined`. A list you
+    wrapped into `{ value: code, label }` objects only for this can go back
+    to plain codes plus the function.
+60. **`boundary` no longer flips a panel** (since 3.0.0-beta.53). A
+    dropdown, popover, tooltip or picker kept inside a `boundary` used to flip
+    to the other side of its trigger when it would cross the boundary's edge,
+    so a row menu bounded by its table opened above the table's last rows.
+    Now the boundary only keeps the panel inside it alongside the trigger
+    (sideways for a panel above or below); away from the trigger it may pass
+    the edge, and only the viewport flips it.
+61. **A table's row checkbox is named by the row, not every cell** (since
+    3.0.0-beta.53). It read "Select" plus every cell's text; now it reads
+    "Select" plus the row's name: its `rowHeader` cells, else its first
+    column, as the drag handle does. Tests that find the checkbox by the long
+    name, or by the name followed by more text, match the short name now. A
+    table whose first column is not its identity (a receipt thumbnail) marks
+    the identity column `rowHeader: true`. `accessible-label` still sets any
+    name you want.
 
 ## 7. Class overrides → variants
 

package/dist/ai/guides/options-items-playbook.md

@@ -66,17 +66,17 @@ Pass backend/domain items **as-is** to `items` and resolve text/value declarativ
 `{ label, value }` and `{ text, value }` items work as they are; any other shape
 needs `item-text` / `item-value`.
 
-A **string** item is its own text and value: `item-text` / `item-value` do not
-run on it, so `:item-text="(code) => labels[code]"` over `string[]` still shows
-the raw codes. Give such lists objects (`{ code, label }`) and point the
-accessors at their fields.
+A **primitive** item (`string[]`, `number[]`) is its own text and value; a
+path has nothing to read on it and is ignored. To label a list of codes, pass
+a function: `:item-text="(code) => labels[code]"` shows the labels and the
+codes stay the values. No need to wrap the codes in objects.
 
 Never pre-map accessor-mode items into `{ label, value }` arrays: point `item-text` / `item-value` at the fields they already have. Matching is hash-based on the extracted value, so component-native extraction stays robust and the raw item remains available to slots (`#option`, cell slots) untouched.
 
 ### Mapping modes
 
 1. **`{ label, value }` objects** (or `{ text, value }`): omit both props; the text is the own `label` (else `text`), the value the own `value`.
-2. **Primitive items** (`string[]`, `number[]`): omit both props; the value is the primitive itself.
+2. **Primitive items** (`string[]`, `number[]`): omit both props; the value is the primitive itself. Label them with a function `item-text`.
 3. **Dot paths** for nested objects: `item-text="profile.fullName"`, `item-value="profile.id"`.
 4. **Extractor functions** only when a path can't express it:
 

package/dist/ai/guides/validated-forms.md

@@ -334,20 +334,31 @@ call `removeField` on a deleted row: [BbForm § Rows](../BbForm.md#rows-v-for).
 ### A check across fields (confirm a password)
 
 A rule that compares two fields is a refinement of the whole object, with
-`path` naming the field that shows the message:
+`path` naming the field that shows the message, and `when` saying which
+fields it needs:
 
 ```ts
 import { z } from 'zod';
 
-const signup = z
-	.object({
-		password: z.string('At least 8 characters').min(8, 'At least 8 characters'),
-		password_confirmation: z.string('Repeat the password'),
-	})
-	.refine((form) => form.password === form.password_confirmation, {
+const fields = z.object({
+	password: z.string('At least 8 characters').min(8, 'At least 8 characters'),
+	password_confirmation: z.string('Repeat the password'),
+	terms: z.literal(true, 'Accept the terms'),
+});
+
+const signup = fields.refine(
+	(form) => form.password === form.password_confirmation,
+	{
 		message: 'The passwords do not match',
 		path: ['password_confirmation'],
-	});
+		// Without `when`, zod skips an object refinement while ANY field fails:
+		// the mismatch stays hidden until the terms box is ticked.
+		when: (payload) =>
+			fields
+				.pick({ password: true, password_confirmation: true })
+				.safeParse(payload.value).success,
+	}
+);
 ```
 
 The message lands on the field whose `name` is `password_confirmation`, and a

package/dist/ai/helpers/inertia/manifest.json

@@ -1,6 +1,6 @@
 {
 	"schema": 1,
-	"version": "3.0.0-beta.52",
+	"version": "3.0.0-beta.53",
 	"canon": "bb-canon/1",
 	"folder": "inertia-helpers",
 	"helpers": {

package/dist/ai/manifest/components/BbBadge.json

@@ -15,7 +15,7 @@
 		{"name":"prepend:icon","type":"string | undefined","description":"Icon rendered before the label."},
 		{"name":"pt","type":"PtMap<BbBadgePtPart, \"loading\"> | undefined","description":"Passthrough, object form: `{ icon: '…', 'icon:loading': '…' }` — the same\nkeys as the `pt:*` attributes without the prefix. Parts: `root`, `icon`,\n`spinner`, `text`, `clear`. State: `loading`."},
 		{"name":"size","type":"keyof Sizes | undefined","default":"\"md\"","values":["xs","sm","md","lg","xl","2xl"],"description":"Preset size of the badge."},
-		{"name":"variant","type":"BadgeVariantType | undefined","default":"\"primary\"","values":["outline","primary","destructive","secondary","none"],"description":"Visual variant: `primary`, `secondary`, `destructive`, or `outline`.\nRegister more via the vite plugin `badgeVariants` option and style\n`.bb-badge--<variant>` (set `--bg` / `--fg`). `'none'` renders no\nvariant class — an escape hatch for a one-off look set through `--bg` /\n`--fg` on the element."}
+		{"name":"variant","type":"BadgeVariantType | undefined","default":"\"primary\"","values":["outline","primary","destructive","secondary","none"],"description":"Visual variant: `primary`, `secondary`, `destructive`, or `outline`.\nStatus colours are a registration (vite plugin `badgeVariants`, the\n`soft-*` palette in design-language.md) styled as `.bb-badge--<variant>`.\n`'none'` renders no variant class: set `--bg` / `--fg` on the element."}
 	],
 	"events": [
 		{"name":"click:clear","signature":"(event: MouseEvent): void","description":"Emitted when the clear button is pressed (only rendered when `clearable`)."}

package/dist/ai/manifest/components/BbColorPalette.json

@@ -11,7 +11,7 @@
 		{"name":"adaptive","type":"boolean | undefined","default":"`config.adaptive` (`true`)","description":"When `true`, the palette opens as a bottom off-canvas sheet on mobile\nviewports instead of a floating popover; on desktop it stays a popover.\nMirrors the adaptive behaviour of `BbPopover`/`BbDropdown`/`BbDatePicker`.\n\nWhen unset, falls back to the global `config.adaptive`."},
 		{"name":"alpha","type":"boolean | undefined","default":"false","description":"Enable the alpha channel. The picker shows an opacity slider and emits\n`#RRGGBBAA` hex8 values."},
 		{"name":"anchor","type":"ElementOrComponentRef | undefined","description":"Element or component ref the popover positions itself relative to.\nDefaults to the activator element when omitted, allowing the popover to\nbe anchored to a larger container (e.g. the full input row) while a\nsmaller element (e.g. a color dot) remains the click target."},
-		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the popover within a bounding element.\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
+		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the popover within a bounding element: it stays inside it\nalongside its trigger (sideways for a popover above or below); away from\nthe trigger it may pass the edge, and it flips at the viewport only.\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
 		{"name":"disabled","type":"boolean | undefined","default":"false","description":"Disable all interaction (activator and palette)."},
 		{"name":"disableFlip","type":"boolean | undefined","default":"false","description":"Disables the automatic flip to the opposite side when the popover\nwould overflow (flipping is on by default)."},
 		{"name":"eager","type":"boolean | undefined","default":"false","description":"Renders the palette panel at mount instead of on the first open (the\nphone sheet's too)."},

package/dist/ai/manifest/components/BbDatePicker.json

@@ -12,7 +12,7 @@
 		{"name":"adaptive","type":"boolean | undefined","default":"`config.adaptive` (`true`)","description":"On mobile, open in a bottom off-canvas sheet instead of a floating popover.\nWhen unset, falls back to the global `config.adaptive`."},
 		{"name":"ampm","type":"boolean | undefined","default":"false","description":"12-hour display with an AM/PM column (requires `type=\"datetime\"`); emits stay 24h."},
 		{"name":"anchor","type":"ElementOrComponentRef | undefined","description":"Element or component ref the popover positions itself relative to.\nDefaults to the activator when omitted (anchor to a larger row while a\nsmaller element stays the click target)."},
-		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the popover within a bounding element or CSS selector."},
+		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the popover within a bounding element or CSS selector:\nsideways only, alongside the trigger; it flips at the viewport."},
 		{"name":"disabled","type":"boolean | undefined","default":"false","description":"Disables the activator and the calendar."},
 		{"name":"disableFlip","type":"boolean | undefined","default":"false","description":"Disable the automatic flip to the opposite side on overflow."},
 		{"name":"eager","type":"boolean | undefined","default":"false","description":"Render popover content before it is first shown."},

package/dist/ai/manifest/components/BbDropdown.json

@@ -10,7 +10,7 @@
 		{"name":"activator","type":"Record<string, any> | HTMLElement | null | undefined","description":"An external activator element or component ref: the activator slot is not\nrendered, and the listeners and ARIA (`aria-haspopup` / `aria-expanded` /\n`aria-controls`) are attached to it; don't add your own."},
 		{"name":"adaptive","type":"boolean | undefined","default":"`config.adaptive` (`true`)","description":"On mobile (below `config.mobileMaxWidth`), renders the menu as a bottom\nsheet that drills into submenus one level at a time instead of hover\nflyouts; slots and selection are unchanged. Unset: the global\n`config.adaptive`."},
 		{"name":"anchor","type":"Record<string, any> | HTMLElement | null | undefined","default":"the activator element","description":"The element the panel positions against when it should differ from the\nactivator (a wrapper the activator is part of); an HTMLElement or\ncomponent ref. It also drives a percentage `width`. Ignored with\n`placement=\"cursor\"`."},
-		{"name":"boundary","type":"string | Record<string, any> | HTMLElement | null | undefined","description":"Constrains the dropdown within a bounding element.\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
+		{"name":"boundary","type":"string | Record<string, any> | HTMLElement | null | undefined","description":"Keeps the panel inside this element alongside its trigger (sideways for\na menu above or below); away from the trigger it may pass the edge, and\nonly the viewport flips it. An HTMLElement, a component ref or a CSS\nselector: a `useTemplateRef`, never `$refs.x` (not reactive)."},
 		{"name":"compact","type":"boolean | undefined","default":"false","description":"Compact density, the `BbSelect` ladder: flyout rows 28px → 24px, sheet\nrows 44px → 36px (a sheet row stays a touch target). The label size does\nnot change."},
 		{"name":"disabled","type":"boolean | undefined","default":"false","description":"Disables the component"},
 		{"name":"eager","type":"boolean | undefined","default":"false","description":"Renders the menu panel at mount instead of on the first open (the phone\nsheet's too), and keeps its rows after a close. Without it the rows mount\non each open and go once the menu has closed."},

package/dist/ai/manifest/components/BbHoverCard.json

@@ -8,7 +8,7 @@
 	"source": "ai/source/BbHoverCard.md",
 	"props": [
 		{"name":"activator","type":"ElementOrComponentRef | undefined","description":"External activator element or component ref.\nWhen provided, the activator slot is not rendered and the hover / focus\nlisteners are attached programmatically to the referenced element."},
-		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the card within a bounding element.\nWhen provided, the card will not overflow this container's bounds (e.g. a sidebar).\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
+		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the card within a bounding element: it stays inside it\nalongside its trigger (sideways for a card above or below); away from\nthe trigger it may pass the edge, and it flips at the viewport only.\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
 		{"name":"delay","type":"number | undefined","default":"350","description":"Milliseconds the pointer (or keyboard focus) rests on the activator\nbefore the card shows; longer than BbTooltip's, so passing over does not\nopen it. Closing has a fixed grace (guide § Timing and the safe zone)."},
 		{"name":"disabled","type":"boolean | undefined","default":"false","description":"Disables the component. Disabling an open card closes it."},
 		{"name":"eager","type":"boolean | undefined","default":"false","description":"Renders the card's content at mount instead of on the first open."},

package/dist/ai/manifest/components/BbPopover.json

@@ -9,7 +9,7 @@
 	"props": [
 		{"name":"activator","type":"ElementOrComponentRef | undefined","description":"External activator element or component ref.\nWhen provided, the activator slot is not rendered and click events\nare attached programmatically to the referenced element."},
 		{"name":"adaptive","type":"boolean | undefined","default":"`config.adaptive` (`true`)","description":"On mobile (below `config.mobileMaxWidth`), renders as a bottom sheet\ninstead of a floating panel, with the same `header`, `default` and\n`footer` slots. `width` is ignored there: size the sheet with\n`offCanvasProps`. Unset: the global `config.adaptive`."},
-		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the popover within a bounding element.\nWhen provided, the popover will not overflow this container's bounds (e.g. a sidebar).\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
+		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the popover within a bounding element: it stays inside it\nalongside its trigger (sideways for a popover above or below); away from\nthe trigger it may pass the edge, and it flips at the viewport only.\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
 		{"name":"disabled","type":"boolean | undefined","default":"false","description":"Disables the component."},
 		{"name":"eager","type":"boolean | undefined","default":"false","description":"Renders the panel's content at mount instead of on the first open\n(the phone sheet's too)."},
 		{"name":"focusTarget","type":"string | undefined","description":"Selector for the element that receives focus after opening.\nDefaults to the first focusable element inside the popover."},

package/dist/ai/manifest/components/BbSelectPopover.json

@@ -13,7 +13,7 @@
 		{"name":"ariaDescribedby","type":"string | string[] | undefined","description":"Space-separated IDREF(s) that describe this field for assistive technologies.\nAccepts either a string or array of ids."},
 		{"name":"ariaInvalid","type":"boolean | undefined","default":"undefined","description":"Explicit invalid state for accessibility semantics.\nFalls back to `hasErrors` when not provided."},
 		{"name":"autocomplete","type":"string | undefined","default":"\"off\"","description":"Browser autocomplete hint for the popover search input."},
-		{"name":"boundary","type":"string | Record<string, any> | HTMLElement | null | undefined","description":"Constrains the popover to a specific boundary element."},
+		{"name":"boundary","type":"string | Record<string, any> | HTMLElement | null | undefined","description":"Constrains the popover to a specific boundary element: it stays inside\nit alongside its trigger (sideways for a popover above or below); away\nfrom the trigger it may pass the edge, and it flips at the viewport only."},
 		{"name":"clearable","type":"boolean | undefined","default":"false","description":"Shows a clear button in the search field, in the lens' place while there\nis a query or a selection; it resets both. None without a search field.\nLeave it off when the activator already clears (as BbSelect's does)."},
 		{"name":"compact","type":"boolean | undefined","default":"false","description":"Apply the compact density variant."},
 		{"name":"dependencies","type":"unknown[] | undefined","default":"[]","description":"Additional dependencies that trigger item reloading when changed."},

package/dist/ai/manifest/components/BbTable.json

@@ -7,7 +7,7 @@
 	"contract": "ai/BbTable.md",
 	"source": "ai/source/BbTable.md",
 	"props": [
-		{"name":"accessibleLabel","type":"((columns: MappedCell[], item: any) => string) | undefined","description":"Function that accepts the columns and the current item as\narguments and returns a label to be used for accessibility purposes.\nThe cells arrive in RENDER order (they follow `order`, so the\nlabel reads like the row) — look a cell up by `key`, never by position."},
+		{"name":"accessibleLabel","type":"((columns: MappedCell[], item: any) => string) | undefined","description":"The row's selection checkbox label, from `(columns, item)`. Unset: the\nrow's name in the locale's select template (its `rowHeader` cells, else\nits first column: \"Select INV-1041\"). The cells arrive in render order:\nlook one up by `key`, never by position."},
 		{"name":"actionsText","type":"string | undefined","description":"Label used in the header of the actions column."},
 		{"name":"align","type":"\"left\" | \"center\" | \"right\" | undefined","default":"\"left\"","description":"Text alignment of the columns."},
 		{"name":"caption","type":"string | undefined","description":"Caption that describes the content of the table. Used for accessibility purposes."},
@@ -50,7 +50,7 @@
 		{"name":"pt","type":"PtItemMap<BbTablePtPart, \"row\", BbTablePtState, Item> | undefined","description":"Passthrough, object form: the same keys as the `pt:*` attributes\nwithout the prefix. See the `pt:<part>` row."},
 		{"name":"readonly","type":"boolean | undefined","default":"false","description":"Sets the input in a readonly state."},
 		{"name":"reorderable","type":"boolean | undefined","default":"false","description":"Lets the user reorder the data columns: drag a header, or Shift+←/→ on a\nfocused header. Every move writes `v-model:order`; a column panel that\nonly writes `order` does not need it. `select` / `actions` and a custom\n`#thead` never move."},
-		{"name":"reorderableRows","type":"boolean | undefined","default":"false","description":"Adds a grip at the start of each row: the user drags a row, or lifts it\nwith Space / Enter and the arrow keys, and `reorder:rows` reports\n`{ item, from, to }`. The table never reorders `items`: splice it in the\nhandler."},
+		{"name":"reorderableRows","type":"boolean | undefined","default":"false","description":"Adds a drag handle at the start of each row: the user drags a row, or lifts it\nwith Space / Enter and the arrow keys, and `reorder:rows` reports\n`{ item, from, to }`. The table never reorders `items`: splice it in the\nhandler."},
 		{"name":"resizable","type":"boolean | undefined","default":"false","description":"Lets the user resize the data columns (drag a header's trailing edge, or\nAlt+←/→; double-click resets). Each commit fires `resize:column(key,\nwidth)` once: write the width back into the column definition to keep it.\nIgnored when inheriting widths."},
 		{"name":"rowClass","type":"BbTableRowClasses<Item> | undefined","description":"Defines the classes to be passed to each data row. Can also be a\nfunction of the row's item for dynamic values."},
 		{"name":"selectable","type":"boolean | ((item: Item) => boolean) | undefined","description":"Defines whether the table is selectable.\nCan be a global boolean that affects all rows or a function\nthat accepts an item and returns a boolean that only affects that item."},
@@ -129,7 +129,7 @@
 			{"name":"lastRow","description":"The row of `#<key>:last` cells, after the data rows (a totals row: `pt:lastRow=\"font-semibold\"`)."},
 			{"name":"selectIcon","description":"The selection glyph: each row's checkbox (radio with single selection) and the select-all checkbox — resolved per node. Not rendered when the `select` / `select:header` slots replace them."},
 			{"name":"dragIcon","description":"The move glyph on the chip that follows a column drag (`reorderable`)."},
-			{"name":"dragHandle","description":"Each row's grip button (`reorderable-rows`), resolved with its row's states. A class list or an object; no per-row function."},
+			{"name":"dragHandle","description":"Each row's drag handle button (`reorderable-rows`), resolved with its row's states. A class list or an object; no per-row function."},
 			{"name":"foot","description":"The footer row group (the `tfoot` slot's container)."}
 		],
 		"states": [
@@ -145,7 +145,7 @@
 		]
 	},
 	"types": [
-		{"name":"BbTableColumn","usedAs":["prop columns"],"definition":"type BbTableColumn<Item = any> = BaseColumn<Item> & { align?: 'left' | 'right' | 'center'; skeleton?: SkeletonType; sortable?: boolean; rowHeader?: boolean; reorderable?: boolean; sorted?: 'asc' | 'desc'; rowClass?: ColumnClasses<Item>; tdClass?: ColumnClasses<Item>; thClass?: Classes; hidden?: boolean; fixed?: 'left' | 'right'; width?: number | string; snap?: string | [ start: string, end: string ]; };","fields":["formatOnNull?: boolean","formatter?: ((content: any, key: string, item: Item) => any)","key: ItemKey<Item>","label: string","placeholder?: string","align?: \"center\" | \"left\" | \"right\"","skeleton?: SkeletonType","sortable?: boolean","rowHeader?: boolean","reorderable?: boolean","sorted?: \"asc\" | \"desc\"","rowClass?: ColumnClasses<Item>","tdClass?: ColumnClasses<Item>","thClass?: Classes","hidden?: boolean","fixed?: \"left\" | \"right\"","width?: string | number","snap?: string | [start: string, end: string]"]},
+		{"name":"BbTableColumn","usedAs":["prop columns"],"definition":"type BbTableColumn<Item = any> = BaseColumn<Item> & { align?: 'left' | 'right' | 'center'; skeleton?: SkeletonType; sortable?: boolean; rowHeader?: boolean; reorderable?: boolean; resizable?: boolean; sorted?: 'asc' | 'desc'; rowClass?: ColumnClasses<Item>; tdClass?: ColumnClasses<Item>; thClass?: Classes; hidden?: boolean; fixed?: 'left' | 'right'; width?: number | string; snap?: string | [ start: string, end: string ]; };","fields":["formatOnNull?: boolean","formatter?: ((content: any, key: string, item: Item) => any)","key: ItemKey<Item>","label: string","placeholder?: string","align?: \"center\" | \"left\" | \"right\"","skeleton?: SkeletonType","sortable?: boolean","rowHeader?: boolean","reorderable?: boolean","resizable?: boolean","sorted?: \"asc\" | \"desc\"","rowClass?: ColumnClasses<Item>","tdClass?: ColumnClasses<Item>","thClass?: Classes","hidden?: boolean","fixed?: \"left\" | \"right\"","width?: string | number","snap?: string | [start: string, end: string]"]},
 		{"name":"BbTableItemsContext","usedAs":["prop items"],"definition":"type BbTableItemsContext<M = any> = BbItemsProviderContext<M> & { reason: 'initial' | 'dependencies' | 'pagination'; };"},
 		{"name":"BbTableRowClasses","usedAs":["prop rowClass"],"definition":"type BbTableRowClasses<Item = any> = Classes | ((item: Item) => Classes | undefined);"},
 		{"name":"BbTableSortEntry","usedAs":["prop sort","event update:sort"],"definition":"type BbTableSortEntry = [ key: string, direction: 'asc' | 'desc' ];"},

package/dist/ai/manifest/components/BbTable.tree.json

@@ -30,6 +30,7 @@
 				"--empty",
 				"--fixed",
 				"--fixed-header",
+				"--indent-*",
 				"--inherit-widths",
 				"--loading",
 				"--overflow-left",
@@ -39,6 +40,8 @@
 				"--reorderable",
 				"--resizable",
 				"--row-dragging",
+				"--row-grabbing",
+				"--rows-reorderable",
 				"--selectable",
 				"--virtual",
 				"--virtual-flat",
@@ -178,13 +181,21 @@
 			"--cue-l",
 			"--cue-r",
 			"--cue-w",
+			"--depth",
 			"--drop",
 			"--fade-a-l",
 			"--fade-a-r",
 			"--fade-l",
 			"--fade-r",
 			"--floor",
+			"--ic",
+			"--ig",
+			"--indent",
+			"--is",
 			"--line",
+			"--min-a",
+			"--min-g",
+			"--min-s",
 			"--offset-end",
 			"--offset-external-end",
 			"--offset-external-start",
@@ -213,6 +224,13 @@
 		{"name":"--actions-spacing","value":"8px","selector":".bb-table"},
 		{"name":"--offset-start","value":"0px","selector":".bb-table","description":"Raw structural edge offset measured by the component (the parent's select/actions track width). Default 0 keeps every calc at its base."},
 		{"name":"--offset-end","value":"0px","selector":".bb-table"},
+		{"name":"--ig","value":"0px","selector":".bb-table","description":"Nested indent locals (see `indentAnchor` in BbTable.vue): the step lands on ONE cell's leading padding. Reset on every table so a parent's step never inherits into a child's cells; the modifier picks the anchor."},
+		{"name":"--is","value":"0px","selector":".bb-table"},
+		{"name":"--ic","value":"0px","selector":".bb-table"},
+		{"name":"--depth","value":"0","selector":".bb-table","description":"Nesting depth (0 at the root) and the parent-region floors of the own structural tracks, both set inline by the component on nested tables; declared here so a parent's values never inherit into a child."},
+		{"name":"--min-g","value":"0px","selector":".bb-table"},
+		{"name":"--min-s","value":"0px","selector":".bb-table"},
+		{"name":"--min-a","value":"0px","selector":".bb-table"},
 		{"name":"--offset-internal-start","value":"var(--offset-start)","selector":".bb-table","description":"Routing of that offset. By default it is \"internal\": added to the first/last cell padding and folded into the first/last column width. Swap internal↔external (set internal to 0 and external to the raw offset) to pad the whole table instead of the edge cells."},
 		{"name":"--offset-internal-end","value":"var(--offset-end)","selector":".bb-table"},
 		{"name":"--offset-external-start","value":"0px","selector":".bb-table"},

package/dist/ai/manifest/components/BbTimePicker.json

@@ -12,7 +12,7 @@
 		{"name":"adaptive","type":"boolean | undefined","default":"`config.adaptive` (`true`)","description":"On mobile, open in a bottom off-canvas sheet instead of a floating popover.\nWhen unset, falls back to the global `config.adaptive`."},
 		{"name":"ampm","type":"boolean | undefined","default":"false","description":"12-hour display with an AM/PM column; emitted values stay 24-hour."},
 		{"name":"anchor","type":"ElementOrComponentRef | undefined","description":"Element or component ref the popover positions itself relative to.\nDefaults to the activator when omitted (anchor to a larger row while a\nsmaller element stays the click target)."},
-		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the popover within a bounding element or CSS selector."},
+		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the popover within a bounding element or CSS selector:\nsideways only, alongside the trigger; it flips at the viewport."},
 		{"name":"disabled","type":"boolean | undefined","default":"false","description":"Disables the activator and the columns."},
 		{"name":"disableFlip","type":"boolean | undefined","default":"false","description":"Disable the automatic flip to the opposite side on overflow."},
 		{"name":"eager","type":"boolean | undefined","default":"false","description":"Render popover content before it is first shown."},

package/dist/ai/manifest/components/BbTooltip.json

@@ -9,7 +9,7 @@
 	"props": [
 		{"name":"activator","type":"ElementOrComponentRef | undefined","description":"External activator element or component ref.\nWhen provided, the activator slot is not rendered and event listeners\nare attached programmatically to the referenced element."},
 		{"name":"arrowPadding","type":"number | undefined","default":"10","description":"Space the arrow will maintain to the edge of the tooltip bubble.\nUseful when the floating element has border radius so it won't appear broken"},
-		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the tooltip within a bounding element.\nWhen provided, the tooltip will not overflow this container's bounds (e.g. a sidebar).\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
+		{"name":"boundary","type":"ElementOrComponentRefOrSelector | undefined","description":"Constrains the tooltip within a bounding element: it stays inside it\nalongside its trigger (sideways for a tooltip above or below); away from\nthe trigger it may pass the edge, and it flips at the viewport only.\nAccepts an HTMLElement, a Vue component ref, or a CSS selector string."},
 		{"name":"delay","type":"number | undefined","default":"100","description":"Milliseconds a pointer rests on the activator before the tooltip shows\n(`0`: at once). Keyboard focus shows it at once, and so does a pointer\narriving while another tooltip shows or within 300 ms of one closing."},
 		{"name":"disabled","type":"boolean | undefined","default":"false","description":"Disables the component"},
 		{"name":"eager","type":"boolean | undefined","default":"false","description":"Renders the tooltip's popover and content at mount instead of on the\nfirst open. The description screen readers hear exists from mount either\nway."},

package/dist/ai/manifest/components/CommonPopover.json

@@ -9,7 +9,7 @@
 	"props": [
 		{"name":"anchor","type":"any","description":"The element the popover positions itself relative to.\nAccepts an HTMLElement, a Vue component ref, or a virtual element with a `getBoundingClientRect` method."},
 		{"name":"arrowPadding","type":"number | undefined","description":"Space the arrow will maintain to the edge of the dropdown.\nUseful when the floating element has border radius so it won't appear broken"},
-		{"name":"boundary","type":"string | Record<string, any> | HTMLElement | null | undefined","description":"Constrains the popover's placement (`flip` / `shift` keep it inside); it\nnever clamps the size, so a short boundary never collapses the bubble:\nuse `overflowBoundary` for that. An HTMLElement, a component ref or a CSS\nselector."},
+		{"name":"boundary","type":"string | Record<string, any> | HTMLElement | null | undefined","description":"Keeps the popover inside this element alongside its anchor (sideways\nabove or below, vertically beside it); away from the anchor it may pass\nthe edge, and only the viewport flips it. It never clamps the size\n(that is `overflowBoundary`). An HTMLElement, component ref or selector."},
 		{"name":"bubbleAttrs","type":"Record<string, unknown> | ((space: CommonPopoverAvailableSpace) => Record<string, unknown>) | undefined","description":"Attributes bound on the bubble (`class`, `style`, `inert`, …) after its\nown class, so the owner can make the bubble its layout container. The\nfunction form receives the default slot's free space (for a height cap)."},
 		{"name":"dialog","type":"boolean | undefined","default":"false","description":"Renders the popover as a `<dialog>` element (modal overlay) instead of a `<span>` with the Popover API."},
 		{"name":"disableFlip","type":"boolean | undefined","default":"false","description":"Disables the automatic flip to the opposite side when the popover\nwould overflow (flipping is on by default)."},

package/dist/ai/manifest/index.json

@@ -1,8 +1,8 @@
 {
 	"schemaVersion": 1,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.52",
-	"generatedAt": "2026-10-09T15:22:07.861Z",
+	"version": "3.0.0-beta.53",
+	"generatedAt": "2026-10-12T19:48:45.130Z",
 	"about": "The bitboss-ui API for agents: open components/<Name>.json for one component (every prop, event, slot, v-model, pt part and state, and the public types its API uses; one member per line). components/<Name>.tree.json has its component tree and CSS internals; files.removed the old names. The machine file with everything in one place is ../components.json.",
 	"reading": {
 		"components[]": "one row per component; description = its first sentence; file = its API file; tree: true = components/<Name>.tree.json exists (component tree, css classes, CSS custom properties).",

package/dist/ai/manifest/types.api.json

@@ -24,7 +24,7 @@
 		{"name":"BbSelectItemsContext","usage":"api","component":null,"usedBy":[{"component":"BbSelect","surface":"prop","name":"items"}],"definition":"type BbSelectItemsContext<M = any> = BbItemsProviderContext<M> & { query: string; reason: 'search' | 'initial' | 'dependencies' | 'model' | 'reopen'; };"},
 		{"name":"BbSelectPopoverItemsContext","usage":"api","component":null,"usedBy":[{"component":"BbSelectPopover","surface":"prop","name":"items"}],"definition":"type BbSelectPopoverItemsContext<M = any> = BbSelectItemsContext<M>;"},
 		{"name":"BbTabItem","usage":"api","component":"BbTabs","deprecated":true,"replacedBy":"BbTabsItem","usedBy":[{"component":"BbTabs","surface":"prop","name":"items"},{"component":"BbTabs","surface":"prop","name":"pt"},{"component":"BbTabs","surface":"prop","name":"pt:item"},{"component":"BbTabsList","surface":"prop","name":"pt"},{"component":"BbTabsList","surface":"prop","name":"pt:item"},{"component":"BbTabsRoot","surface":"prop","name":"items"}]},
-		{"name":"BbTableColumn","usage":"api","component":"BbTable","usedBy":[{"component":"BbTable","surface":"prop","name":"columns"}],"definition":"type BbTableColumn<Item = any> = BaseColumn<Item> & { align?: 'left' | 'right' | 'center'; skeleton?: SkeletonType; sortable?: boolean; rowHeader?: boolean; reorderable?: boolean; sorted?: 'asc' | 'desc'; rowClass?: ColumnClasses<Item>; tdClass?: ColumnClasses<Item>; thClass?: Classes; hidden?: boolean; fixed?: 'left' | 'right'; width?: number | string; snap?: string | [ start: string, end: string ]; };","fields":["formatOnNull?: boolean","formatter?: ((content: any, key: string, item: Item) => any)","key: ItemKey<Item>","label: string","placeholder?: string","align?: \"center\" | \"left\" | \"right\"","skeleton?: SkeletonType","sortable?: boolean","rowHeader?: boolean","reorderable?: boolean","sorted?: \"asc\" | \"desc\"","rowClass?: ColumnClasses<Item>","tdClass?: ColumnClasses<Item>","thClass?: Classes","hidden?: boolean","fixed?: \"left\" | \"right\"","width?: string | number","snap?: string | [start: string, end: string]"]},
+		{"name":"BbTableColumn","usage":"api","component":"BbTable","usedBy":[{"component":"BbTable","surface":"prop","name":"columns"}],"definition":"type BbTableColumn<Item = any> = BaseColumn<Item> & { align?: 'left' | 'right' | 'center'; skeleton?: SkeletonType; sortable?: boolean; rowHeader?: boolean; reorderable?: boolean; resizable?: boolean; sorted?: 'asc' | 'desc'; rowClass?: ColumnClasses<Item>; tdClass?: ColumnClasses<Item>; thClass?: Classes; hidden?: boolean; fixed?: 'left' | 'right'; width?: number | string; snap?: string | [ start: string, end: string ]; };","fields":["formatOnNull?: boolean","formatter?: ((content: any, key: string, item: Item) => any)","key: ItemKey<Item>","label: string","placeholder?: string","align?: \"center\" | \"left\" | \"right\"","skeleton?: SkeletonType","sortable?: boolean","rowHeader?: boolean","reorderable?: boolean","resizable?: boolean","sorted?: \"asc\" | \"desc\"","rowClass?: ColumnClasses<Item>","tdClass?: ColumnClasses<Item>","thClass?: Classes","hidden?: boolean","fixed?: \"left\" | \"right\"","width?: string | number","snap?: string | [start: string, end: string]"]},
 		{"name":"BbTableItemsContext","usage":"api","component":null,"usedBy":[{"component":"BbTable","surface":"prop","name":"items"}],"definition":"type BbTableItemsContext<M = any> = BbItemsProviderContext<M> & { reason: 'initial' | 'dependencies' | 'pagination'; };"},
 		{"name":"BbTableRowClasses","usage":"api","component":"BbTable","usedBy":[{"component":"BbTable","surface":"prop","name":"rowClass"}],"definition":"type BbTableRowClasses<Item = any> = Classes | ((item: Item) => Classes | undefined);"},
 		{"name":"BbTableSortEntry","usage":"api","component":"BbTable","usedBy":[{"component":"BbTable","surface":"prop","name":"sort"},{"component":"BbTable","surface":"event","name":"update:sort"}],"definition":"type BbTableSortEntry = [ key: string, direction: 'asc' | 'desc' ];"},

package/dist/ai/recipes/inertia/approvals-inbox.md

@@ -804,7 +804,7 @@ const shortDate = (value: string) =>
 
 const columns = [
 	{ key: 'receipt', label: 'Receipt', width: 48 },
-	{ key: 'merchant', label: 'Merchant' },
+	{ key: 'merchant', label: 'Merchant', rowHeader: true },
 	{ key: 'submitter.name', label: 'Submitter' },
 	{ key: 'category', label: 'Category' },
 	{

package/dist/ai/recipes/nuxt/approvals-inbox.md

@@ -808,7 +808,7 @@ const shortDate = (value: string) =>
 
 const columns = [
 	{ key: 'receipt', label: 'Receipt', width: 48 },
-	{ key: 'merchant', label: 'Merchant' },
+	{ key: 'merchant', label: 'Merchant', rowHeader: true },
 	{ key: 'submitter.name', label: 'Submitter' },
 	{ key: 'category', label: 'Category' },
 	{

package/dist/ai/recipes/vue/approvals-inbox.md

@@ -740,7 +740,7 @@ const shortDate = (value: string) =>
 
 const columns = [
 	{ key: 'receipt', label: 'Receipt', width: 48 },
-	{ key: 'merchant', label: 'Merchant' },
+	{ key: 'merchant', label: 'Merchant', rowHeader: true },
 	{ key: 'submitter.name', label: 'Submitter' },
 	{ key: 'category', label: 'Category' },
 	{

package/dist/ai/source/BbBadge.md

@@ -322,10 +322,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/ai/source/BbBadgeButton.md

@@ -197,10 +197,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/ai/source/BbColorPalette.md

@@ -1260,7 +1260,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;