bitboss-ui 3.0.0-beta.63 → 3.0.0-beta.65

package/dist/ai/changelog.json

@@ -1,7 +1,7 @@
 {
 	"schemaVersion": 3,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.63",
+	"version": "3.0.0-beta.65",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
 	"legend": {
@@ -73,7 +73,9 @@
 		"3.0.0-beta.60",
 		"3.0.0-beta.61",
 		"3.0.0-beta.62",
-		"3.0.0-beta.63"
+		"3.0.0-beta.63",
+		"3.0.0-beta.64",
+		"3.0.0-beta.65"
 	],
 	"unpublished": [
 		"3.0.0-alpha.2",
@@ -95,8 +97,8 @@
 		"3.0.0-beta.55"
 	],
 	"summary": {
-		"renames": 220,
-		"behaviourBreaks": 231,
+		"renames": 222,
+		"behaviourBreaks": 255,
 		"bySurface": {
 			"prop": 15,
 			"option": 1,
@@ -104,10 +106,10 @@
 			"slot": 14,
 			"item": 6,
 			"cssVar": 32,
-			"class": 138
+			"class": 140
 		},
 		"unreleased": 0,
-		"added": 416
+		"added": 443
 	},
 	"added": {
 		"3.0.0-alpha.1": [
@@ -2096,6 +2098,128 @@
 					"BbPtScope"
 				]
 			}
+		],
+		"3.0.0-beta.64": [
+			{
+				"text": "select · known rows tell themselves apart in slots",
+				"components": [
+					"BbSelectPopover"
+				]
+			},
+			{
+				"text": "passthrough · a component's variant is a pt state",
+				"components": [
+					"BbAlert",
+					"BbBadge",
+					"BbButton",
+					"BbColorInput",
+					"BbConfirm",
+					"BbDatePickerInput",
+					"BbDropdown",
+					"BbDropdownButton",
+					"BbIndicator",
+					"BbNumberInput",
+					"BbSelect",
+					"BbTabs",
+					"BbTag",
+					"BbTextInput",
+					"BbTextarea",
+					"BbTimePickerInput",
+					"BbToast",
+					"BbTooltip"
+				]
+			},
+			"offcanvas · a side per breakpoint, frozen at open",
+			{
+				"text": "passthrough · an app's own variants in the attribute form",
+				"components": [
+					"BbAlert",
+					"BbBadge",
+					"BbButton",
+					"BbColorInput",
+					"BbConfirm",
+					"BbDatePickerInput",
+					"BbDropdown",
+					"BbDropdownButton",
+					"BbIndicator",
+					"BbNumberInput",
+					"BbSelect",
+					"BbTabs",
+					"BbTag",
+					"BbTextInput",
+					"BbTextarea",
+					"BbTimePickerInput",
+					"BbToast",
+					"BbTooltip"
+				]
+			},
+			{
+				"text": "check · adoption checklist and check --idioms",
+				"components": [
+					"BbRadioGroup",
+					"BbTabs"
+				]
+			},
+			"table · measured reservations, cell roles and hold levels in the fit",
+			"table · held cells floor their own track at the fit's hold level",
+			"table · a text ruler that measures values in their rendered type",
+			"table · measure held values and headings after mount, guard the plan",
+			"table · a column padded wider than its header reserves the padding",
+			{
+				"text": "select · known in pt per-item functions and through definepreset",
+				"components": [
+					"BbSelectPopover"
+				]
+			},
+			"ai-init · register the mcp server for zed",
+			"dropdown · query in the empty and loading slot scope",
+			"dropdown · escape on a sheet level goes back one level",
+			"dropdown · --fs and --icon-size size the desktop rows",
+			"dropdown · items stop forwarding data and aria keys to the row",
+			"button · icon slots with the button states as scope",
+			{
+				"text": "dropdown-button · the main button's icon slots",
+				"components": [
+					"BbDropdownButton"
+				]
+			},
+			"badge · icon slots, and the link state in the badge button slot",
+			{
+				"text": "choice-groups · own registries, vertical strips, liquid runs",
+				"components": [
+					"BbCheckboxGroup",
+					"BbRadioGroup",
+					"BbSwitchGroup",
+					"BbTabs",
+					"OptionsContainer"
+				]
+			},
+			{
+				"text": "choice-groups · persistent checkbox pills, seamless contacts",
+				"components": [
+					"BbCheckboxGroup",
+					"OptionsContainer"
+				]
+			},
+			"dropdown · groupby sections inside one group (att-15 prototype)",
+			{
+				"text": "dropdown · groupby lists untitled rows first, as select now does",
+				"components": [
+					"BbSelect",
+					"BbSelectPopover"
+				]
+			},
+			"form · emit invalid when server errors land",
+			{
+				"text": "dropdown · close on select by choice kind, not group count",
+				"components": [
+					"BbDropdownButton"
+				]
+			}
+		],
+		"3.0.0-beta.65": [
+			"helpers · the leave guard speaks the app's locale",
+			"helpers · a resource context aborts the request it no longer wants"
 		]
 	},
 	"breaking": [
@@ -5244,6 +5368,34 @@
 			"firstReleasedIn": "3.0.0-beta.41",
 			"guide": "ai/guides/migration/v3-beta-css-classes.md"
 		},
+		{
+			"id": "css:bb-dialog--stacked",
+			"kind": "rename",
+			"surface": "class",
+			"components": [
+				".bb-dialog"
+			],
+			"from": ".bb-dialog--stacked",
+			"to": ".bb-dialog--above",
+			"since": "",
+			"default": "",
+			"firstReleasedIn": "3.0.0-beta.64",
+			"guide": "ai/guides/migration/v3-beta-css-classes.md"
+		},
+		{
+			"id": "css:bb-offcanvas--stacked",
+			"kind": "rename",
+			"surface": "class",
+			"components": [
+				".bb-offcanvas"
+			],
+			"from": ".bb-offcanvas--stacked",
+			"to": ".bb-offcanvas--above",
+			"since": "",
+			"default": "",
+			"firstReleasedIn": "3.0.0-beta.64",
+			"guide": "ai/guides/migration/v3-beta-css-classes.md"
+		},
 		{
 			"id": "f099",
 			"kind": "behaviour",
@@ -8511,6 +8663,342 @@
 			"ruling": "owner 2026-10-22 (Q75.9)",
 			"guide": "v2-to-v3.md § 6 item 97 + components/use-confirm.md + components/bb-host.md + BbConfirm.md § Several confirms at once + useConfirm.md",
 			"firstReleasedIn": "3.0.0-beta.63"
+		},
+		{
+			"id": "f371",
+			"kind": "behaviour",
+			"summary": "BbDialog: a member over one of its own stack paints no second dim; the covered member's backdrop stays, no handoff",
+			"components": [
+				"BbDialog",
+				"BbConfirm"
+			],
+			"description": "BbDialog: a member opened over an earlier member of its own stack (a drill-in step, a confirm given its dialog's stack) paints NO dim of its own (new class bb-dialog--covering, the pair of --covered): the covered member's backdrop stays the one on screen, so the page is as dark as under one dialog and nothing hands off when the top one closes. It used to add the stacked dim over a hidden box, darkening the page twice. Dialogs over a VISIBLE dialog (another stack name, or none) keep the stacked dim",
+			"ruling": "owner 2026-10-23",
+			"guide": "v2-to-v3.md § 6 item 98 + BbDialog.md § Stacked dialogs + design-tokens.md",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f372",
+			"kind": "behaviour",
+			"summary": "bb-dialog--stacked / bb-offcanvas--stacked are now --above, and --bb-overlay-stacked is --bb-overlay-above",
+			"components": [
+				"BbDialog",
+				"BbOffCanvas"
+			],
+			"description": "Renamed so the word stack only names a replace group: the class a dialog / off-canvas opened above another open one carries, bb-dialog--stacked → bb-dialog--above and bb-offcanvas--stacked → bb-offcanvas--above, and its dim token --bb-overlay-stacked → --bb-overlay-above. Hard rename, no alias: CSS that targets the old class or sets the old token stops applying (bitboss-ui check reports the classes)",
+			"ruling": "owner 2026-10-23",
+			"guide": "v2-to-v3.md § 6 item 98 + v3-beta-css-classes.md + design-tokens.md",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f373",
+			"kind": "behaviour",
+			"summary": "BbSelect/BbSelectPopover known-items: slots, pt item fns, presets get `known`; `item` is `T | BbSelectKnownItem`. `BbSelectProps<T>` alone is bound (`<T, undefined>` opts out)",
+			"components": [
+				"BbSelect",
+				"BbSelectPopover"
+			],
+			"description": "BbSelect / BbSelectPopover: on a select that binds known-items, the option and chip slots (the popover's option) get known, and item is typed T | BbSelectKnownItem (a discriminated union on known): a slot reading an option field off item without checking known is a TYPE ERROR (it rendered blank until the list loaded); a pt per-item function on the option parts gets the same { item, known }, and the type alone (BbSelectProps<T>, BbSelectPopoverProps<T>: a wrapper's props, a pt const) is the bound case (<T, undefined> opts out); with definePreset rev 4 a select preset narrows like the select, and its own default slots always get known. New public type BbSelectSlotRow<T>; a second generic Known inferred from known-items. Selects without known-items keep item: T (plus known: false)",
+			"ruling": "owner 2026-10-23",
+			"guide": "v2-to-v3.md § 6 item 99 + BbSelect.md § known-items + BbSelectPopover.md",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f374",
+			"kind": "behaviour",
+			"summary": "Build plugin: a custom variant named like a passthrough state of a component it styles fails the build; variants are now pt states (pt:<part>:<variant>)",
+			"components": [
+				"BbAlert",
+				"BbBadge",
+				"BbButton",
+				"BbColorInput",
+				"BbConfirm",
+				"BbDatePickerInput",
+				"BbDropdown",
+				"BbDropdownButton",
+				"BbIndicator",
+				"BbNumberInput",
+				"BbSelect",
+				"BbTabs",
+				"BbTag",
+				"BbTextInput",
+				"BbTextarea",
+				"BbTimePickerInput",
+				"BbToast",
+				"BbTooltip"
+			],
+			"description": "Build plugin: a custom variant registered under the name of a passthrough state of a component it styles (buttonVariants: ['loading'], dropdownItemVariants: ['selected'], tabsVariants: ['active']) FAILS THE BUILD (Q76.7: a component's variant is a pt state, pt:<part>:<variant>, so the two names would collide). Rename the variant. The variant states themselves are additive.",
+			"ruling": "owner 2026-10-23",
+			"guide": "v2-to-v3.md § 6 item 100 + passthrough.md",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f375",
+			"kind": "behaviour",
+			"summary": "BbDropdown submenus (APG): Escape closes one level and refocuses its row; Enter/Space/click open a submenu with focus inside; focus returns to the row when a submenu closes; rtl swaps arrows",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"description": "BbDropdown submenus follow the APG menu pattern (desktop flyout): Escape in a submenu closes that level and refocuses its opener (was: the whole menu); Enter / Space / click open a submenu with focus inside (search box first), like ArrowRight; focus returns to the opener when a submenu closes under it; searchable submenu openers say aria-haspopup=\"dialog\", open ones get aria-controls, every submenu is named after its opener; dir=\"rtl\" swaps the inline arrows and opens flyouts to the left. Silent for apps that hand-rolled per-level Escape or focus() into submenus.",
+			"ruling": "owner 2026-10-26 (ATT-07)",
+			"guide": "v2-to-v3.md § 6 item 101 + BbDropdown.md § Keyboard",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f376",
+			"kind": "behaviour",
+			"summary": "Inertia helpers: `usePaginatedResponseContext` `page`/`perPage` read the server answer, not the URL; no write-back after a visit (one visit on a redirect); `items` reset when the prop changes",
+			"components": [
+				"usePaginatedResponseContext",
+				"useTableContext",
+				"useRouteQuery"
+			],
+			"description": "Inertia helpers (usePaginatedResponseContext / useTableContext, after npx bitboss-ui helpers update): page and perPage read the server's answer (a clamped ?page=99, a capped ?per_page=500, a redirect to the bare URL), not the URL, and nothing writes them back after a visit, so a redirect is one visit, not two. ?page leaves the URL at page 1; ?per_page only at the server's default, once an answer to a URL without it has shown it. items resets when the prop changes (also Back / Forward), not on every successful visit. useRouteQuery's default may be a ref or a getter.",
+			"ruling": "owner 2026-10-26 (Q81.1(b), ATT-05)",
+			"guide": "v2-to-v3.md § 6 item 102 + inertia-helpers.md",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f377",
+			"kind": "behaviour",
+			"summary": "BbToast: the card edge is a `border`, not an inset ring in `box-shadow`; `--bb-shadow: none` or a `box-shadow` override keeps the edge",
+			"components": [
+				"BbToast"
+			],
+			"description": "BbToast: the card edge is a real border (--bw = --bb-border-w), no longer an inset ring inside box-shadow. box-shadow is --bb-shadow alone, so --bb-shadow: none or a box-shadow override keeps the edge; a border set on .bb-toast__panel replaces it. Same card size.",
+			"ruling": "owner 2026-10-26 (Q81.2(c), ATT-06)",
+			"guide": "v2-to-v3.md § 6 item 103 + migration/components/bb-toast.md + design-tokens.md",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f378",
+			"kind": "behaviour",
+			"summary": "BbBadge: a set `clearableLabel` is the whole name of the ✕ on any body; a text body no longer appends its text (unset still composes \"Remove <text>\")",
+			"components": [
+				"BbBadge"
+			],
+			"description": "BbBadge: a set clearableLabel is the ✕'s WHOLE accessible name on any body. With a text body the badge used to append its text (aria-labelledby = the ✕ + the body), so clearable-label=\"Remove the filter Deleted\" read \"Remove the filter Deleted Deleted\"; with a BbBadgeButton body it was already whole. Unset keeps the composed \"Remove <text>\" (the bare verb on a BbBadgeButton body). An app that passed only a verb to get the composition: drop the prop, or pass the whole name",
+			"ruling": "owner 2026-10-26 (Q81.1(d), ATT-08)",
+			"guide": "v2-to-v3.md § 6 item 104 + BbBadge.md § clearable",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f382",
+			"kind": "behaviour",
+			"summary": "BbTooltip / v-bb-tooltip: the visible bubble is `aria-hidden`; its text stays the activator's description, so a tooltip inside a `<label>` no longer joins the control's name",
+			"components": [
+				"BbTooltip"
+			],
+			"description": "BbTooltip / v-bb-tooltip: the visible bubble is aria-hidden (no role=tooltip in the accessibility tree); its text stays the activator's description through the hidden describedby node, so a tooltip inside a <label> no longer joins the control's name. Apps that queried the bubble by role in tests query the description instead",
+			"ruling": "owner 2026-10-26 (ATT-11 (a))",
+			"guide": "v2-to-v3.md § 6 item 105 + BbTooltip.md § Accessibility",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f383",
+			"kind": "behaviour",
+			"summary": "BbTooltip `activator` accepts a CSS selector string, looked up once the tooltip mounts (the component only, not v-bb-tooltip)",
+			"components": [
+				"BbTooltip"
+			],
+			"description": "BbTooltip activator also accepts a CSS selector string, looked up once the tooltip mounts and again when the prop changes (the component only; v-bb-tooltip always uses its host). Additive",
+			"ruling": "owner 2026-10-26 (ATT-11 (b))",
+			"guide": "BbTooltip.md § activator",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f384",
+			"kind": "behaviour",
+			"summary": "BbRadioGroup / BbCheckboxGroup / BbSwitchGroup `tiles`: the native input covers the whole tile; links / buttons inside stay clickable; tile text is no longer selectable",
+			"components": [
+				"BbRadioGroup",
+				"BbCheckboxGroup",
+				"BbSwitchGroup"
+			],
+			"description": "BbRadioGroup / BbCheckboxGroup / BbSwitchGroup list-layout=\"tiles\": the native input covers the whole tile (padding included), links / buttons inside a tile stay clickable above it, tile text is not selectable, clicks on inner non-interactive elements reach the input; list rows unchanged (Q65.4)",
+			"ruling": "owner 2026-10-26 (ATT-11 (d))",
+			"guide": "v2-to-v3.md § 6 item 106 + the three group guides § tiles",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f385",
+			"kind": "behaviour",
+			"summary": "BbDropdown mobile sheet: Escape on a drilled-in level goes back one level (focus on its opener row), closing only at the top; the back control also refocuses the opener",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"description": "BbDropdown adaptive sheet: Escape on a drilled-in level goes back one level (focus on its opener row), closing only at the top; the back control and ArrowLeft also refocus the opener row (was: the first row)",
+			"ruling": "owner 2026-10-26 (ATT-07 follow-up)",
+			"guide": "v2-to-v3.md § 6 item 107 + BbDropdown.md § Mobile",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f386",
+			"kind": "behaviour",
+			"summary": "BbDropdown items no longer forward `data-*` / `aria-*` keys to the row; set them through `pt:item` (function form per row)",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"description": "BbDropdown items no longer forward data-* / aria-* keys from the item descriptor to the row; set them through pt:item (function form per row). A row's own label / description fold in an aria-label / aria-labelledby / aria-describedby set that way",
+			"ruling": "owner 2026-10-26 (ATT-07k)",
+			"guide": "v2-to-v3.md § 6 item 108 + BbDropdown.md",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f387",
+			"kind": "behaviour",
+			"summary": "Icon slots `#icon` / `#prepend:icon` / `#append:icon` on BbButton, BbDropdownButton and BbBadge, scoped with the pt states; BbBadgeButton's slot gets `activeLink`",
+			"components": [
+				"BbButton",
+				"BbDropdownButton",
+				"BbBadge",
+				"BbBadgeButton"
+			],
+			"description": "Icon slots #icon / #prepend:icon / #append:icon on BbButton, BbDropdownButton (main button) and BbBadge, scoped with the pt states (activeLink, exactActiveLink, pressed, loading, disabled), rendered inside the icon part (pt:icon, --icon-size, the spinner swap keep working); BbBadgeButton's default slot gets { activeLink, exactActiveLink }. Additive",
+			"ruling": "owner 2026-10-26 (Q81.4)",
+			"guide": "the three component guides",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f388",
+			"kind": "behaviour",
+			"summary": "BbRadioGroup / BbCheckboxGroup `variant=\"pill\" | \"line\"` (registries `radioVariants` / `checkboxVariants`): BbTabs' strip look on a choice group, vertical too. Additive",
+			"components": [
+				"BbRadioGroup",
+				"BbCheckboxGroup"
+			],
+			"description": "BbRadioGroup / BbCheckboxGroup variant (pill, line; registries radioVariants / checkboxVariants, class hooks bb-*-group__list--<name>): the group as a tab strip with its own tokens (BbTabs' values), a sliding indicator; checkbox pill = persistent pills (stretch / shorten / split, touching pills drawn as one shape); vertical with list-layout=\"vertical\"; pt:indicator, pt:<part>:<variant>. Additive",
+			"ruling": "owner 2026-10-26 (Q76.11 (d))",
+			"guide": "both group guides + component-picker",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f389",
+			"kind": "behaviour",
+			"summary": "`v-bb-tooltip` object value: `activator` is no longer accepted (a type error); the directive always used its host element and ignored it",
+			"components": [
+				"BbTooltip"
+			],
+			"description": "v-bb-tooltip object value no longer types activator (the directive always used its host element; an activator was silently ignored). Types only: a TS app that passed one now fails to compile, remove it. BbTooltip's own activator prop is unchanged",
+			"ruling": "owner 2026-10-26 (Q82.8 (b))",
+			"guide": "v2-to-v3.md § 6 item 109 + migration/components/bb-tooltip.md",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f379",
+			"kind": "behaviour",
+			"summary": "BbSelect/BbSelectPopover group-by: ungrouped rows (nullish group, known rows) are listed first, before every header; BbDropdown groups gain groupBy (path or getter, one v-model, one search, same rule)",
+			"components": [
+				"BbSelect",
+				"BbSelectPopover",
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"description": "BbSelect / BbSelectPopover group-by: rows whose group is null / undefined (and known rows) are listed FIRST, before every header (was: at the place of their first row, where they read as part of the group above). Silent order change; a row.team ?? 'Other' fallback kept only to separate them can go. BbDropdown groups gain the same groupBy (path or getter, one v-model, one search, headings skipped by keyboard, additive)",
+			"ruling": "owner 2026-10-26 (ATT-15)",
+			"guide": "v2-to-v3.md § 6 item 110 + BbSelect.md § Group related options + BbDropdown.md § Titled sections",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f380",
+			"kind": "behaviour",
+			"summary": "BbDropdown: a change in any single-choice group closes the menu (submenus, multi-group menus, a clearable untick included); new `closeOnSelect` (true/false) overrides",
+			"components": [
+				"BbDropdown",
+				"BbDropdownButton"
+			],
+			"description": "BbDropdown / BbDropdownButton: a change in any single-choice group closes the menu (in submenus and multi-group menus too, a clearable untick included); a multiple group stays open; new closeOnSelect?: boolean overrides (true = every selection closes, false = none). A pointer pick returns focus to the activator",
+			"ruling": "owner 2026-10-26 (ATT-03)",
+			"guide": "v2-to-v3.md § 6 item 112 + BbDropdown.md § Selectable groups",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f381",
+			"kind": "behaviour",
+			"summary": "BbForm `invalid` also fires for server errors (`setErrors`, a new `field-errors` message) with `source: 'server'`, before focus; payload gains `unmatched` and `source`",
+			"components": [
+				"BbForm"
+			],
+			"description": "BbForm invalid also fires when server errors land (setErrors, a new field-errors value), payload { errors, values, unmatched, source: 'submit' | 'server' }, emitted before BbForm's own focus and even when BbForm doesn't focus; apps listening to @invalid now get server errors too",
+			"ruling": "owner 2026-10-26 (ATT-13)",
+			"guide": "v2-to-v3.md § 6 item 111 + BbForm.md § A failed submit",
+			"firstReleasedIn": "3.0.0-beta.64"
+		},
+		{
+			"id": "f390",
+			"kind": "behaviour",
+			"summary": "useQueryObject: `only`/`preserve*`/`replace` → `visitOptions`; `shouldNavigate` → `paused` (inverted); `resetKeys` default `['page']`; `transform`/`arrayFormat` gone; new `server`",
+			"components": [
+				"useQueryObject",
+				"useQuery"
+			],
+			"description": "Inertia helper useQueryObject options (after npx bitboss-ui helpers update): only / preserveState / preserveScroll / replace → ONE visitOptions (Inertia's VisitOptions, merged over preserveState / preserveScroll / replace: true); shouldNavigate → paused (inverted: true holds the changes, going back to false sends the current state once unless the URL already holds it); resetPage + resetKeys → resetKeys (default ['page']; a passed list REPLACES it); transform and arrayFormat removed (a getter source reshapes; arrays use QUERY_ARRAY_FORMAT of useQuery.ts, comma); new server: false writes the URL with no request. A visit changes only the object's and the reset keys: other parameters keep their order and encoding",
+			"ruling": "owner 2026-10-27 (Q82.11 redesign)",
+			"guide": "v2-to-v3.md § 6 item 113 + inertia-helpers.md § useQueryObject",
+			"firstReleasedIn": "3.0.0-beta.65"
+		},
+		{
+			"id": "f391",
+			"kind": "behaviour",
+			"summary": "useQuery decodes once (`%2C` splits); URL writes build on the one in flight; `useRouteQuery` flags → `visitOptions`, new `server`; `null` removes the key",
+			"components": [
+				"useQuery",
+				"useRouteQuery",
+				"useQueryObject"
+			],
+			"description": "Inertia helpers useQuery / useRouteQuery (helpers update): useQuery decodes once (?q=R%26D reads R&D, not two keys) and an encoded %2C separates a comma array as PHP + Spatie read it; a #fragment or a raw ? inside a value no longer leaks into values or writes. Every URL writer (the two, useQueryObject, the pager) builds on the write in flight: two writes before the answer both land, undoing one is not swallowed, a ref reads back its write; a write changes only its own key. useRouteQuery: preserveScroll / preserveState → visitOptions, new server: false; null / undefined remove the key (was the string 'null'); a repeated key reads its LAST value (PHP)",
+			"ruling": "owner 2026-10-27 (Q82.11 (c)–(e), war room)",
+			"guide": "v2-to-v3.md § 6 item 114 + inertia-helpers.md § useQuery, § useRouteQuery",
+			"firstReleasedIn": "3.0.0-beta.65"
+		},
+		{
+			"id": "f392",
+			"kind": "behaviour",
+			"summary": "Pager: a `page` write pushes history; `pageQueryKey`/`perPageQueryKey`/`visitOptions`; `items` resets on a visit asking for it; guard `whitelist` only lets submits through",
+			"components": [
+				"usePaginatedResponseContext",
+				"useTableContext",
+				"usePromiseForm",
+				"useConfirmOnRouteLeave",
+				"useLazyProp",
+				"useResourceContext"
+			],
+			"description": "Inertia pagination + visit helpers (helpers update): usePaginatedResponseContext / useTableContext take pageQueryKey / perPageQueryKey / visitOptions (additive); a page write PUSHES history (Back = the previous page), a new perPage replaces and returns to page 1 in the same visit; an answer past the last page visits the last page once; a missing prop reads as empty; junk writes (0, NaN, past a known last page) send nothing; items is a copy, reset by a server visit that asks for the prop and kept (rows unchanged) across other prop swaps (appendToProp) — supersedes item 102's reset rule; cursorPaginate() documented unsupported. usePromiseForm resolves false when a before listener cancels, keeps the caller's onSuccess / onError, rejects an Inertia-rendered error page, and a save held by the leave guard answers the user's choice. useConfirmOnRouteLeave whitelist lets only submits (POST / PUT / PATCH / DELETE) through: a link to the same path asks. useLazyProp stops retrying a failed load (sets error) and survives a navigation cancel; useResourceContext drops late responses",
+			"ruling": "owner 2026-10-27 (Q82.11 (a), (b), (f), (h), war room)",
+			"guide": "v2-to-v3.md § 6 item 115 + inertia-helpers.md",
+			"firstReleasedIn": "3.0.0-beta.65"
+		},
+		{
+			"id": "f393",
+			"kind": "behaviour",
+			"summary": "Leave guard adds the browser prompt, `stack` and `messages.ts` words by locale; `useHasChanged` hashes its baseline; paginated `items` is a deep copy; `useScreenSizes` follows `mobileMaxWidth`",
+			"components": [
+				"useConfirmOnRouteLeave",
+				"useHasChanged",
+				"usePaginatedResponseContext",
+				"useScreenSizes"
+			],
+			"description": "Inertia helpers, second pass (helpers update): useConfirmOnRouteLeave adds the browser's own leave prompt (tab close, reload, typed URL, plain <a>) while armed, never for a whitelisted save that leaves through Inertia::location(), takes stack, and speaks the library's locale from a new shared, app-editable messages.ts (English shipped; useBbConfig() gains a read-only locale); useHasChanged baselines by structural hash (Dates, Sets, Maps, undefined, NaN compare as they are; an untouched form no longer reads changed; a File compares by name, size, type and date); usePaginatedResponseContext items is a DEEP copy (row edits stay off the page prop); useScreenSizes isMobile is the library's useMobile() (follows mobileMaxWidth) and SCREEN_BREAKPOINT_MD is gone",
+			"ruling": "owner 2026-10-27 (Q82.14 (1), (2), (4), (6))",
+			"guide": "v2-to-v3.md § 6 item 116 + inertia-helpers.md",
+			"firstReleasedIn": "3.0.0-beta.65"
+		},
+		{
+			"id": "f394",
+			"kind": "behaviour",
+			"summary": "Inertia peer floor `>=2.0.0`; the helpers run and type-check on Inertia 2 and 3",
+			"components": [
+				"usePromiseForm",
+				"useConfirmOnRouteLeave",
+				"useLazyProp"
+			],
+			"description": "Inertia peer floor: @inertiajs/vue3 >=1.0.0 → >=2.0.0 (never tested on 1; the helpers use Inertia 2 APIs). The helpers run and type-check on Inertia 2 and 3 (a new gate types them against 2.3.10): on Inertia 2 usePromiseForm rejects a 419 / 423 / non-Inertia 500 / network error and the leave guard's prompt survives a failed save; useLazyProp keeps validation errors on Inertia 3 only",
+			"ruling": "owner 2026-10-27 (progetto-32 on Inertia 2.3.10)",
+			"guide": "v2-to-v3.md § 6 item 117 + inertia-helpers.md",
+			"firstReleasedIn": "3.0.0-beta.65"
 		}
 	]
 }