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

package/dist/ai/changelog.json

@@ -1,7 +1,7 @@
 {
 	"schemaVersion": 3,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.64",
+	"version": "3.0.0-beta.65",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
 	"legend": {
@@ -74,7 +74,8 @@
 		"3.0.0-beta.61",
 		"3.0.0-beta.62",
 		"3.0.0-beta.63",
-		"3.0.0-beta.64"
+		"3.0.0-beta.64",
+		"3.0.0-beta.65"
 	],
 	"unpublished": [
 		"3.0.0-alpha.2",
@@ -97,7 +98,7 @@
 	],
 	"summary": {
 		"renames": 222,
-		"behaviourBreaks": 250,
+		"behaviourBreaks": 255,
 		"bySurface": {
 			"prop": 15,
 			"option": 1,
@@ -108,7 +109,7 @@
 			"class": 140
 		},
 		"unreleased": 0,
-		"added": 441
+		"added": 443
 	},
 	"added": {
 		"3.0.0-alpha.1": [
@@ -2215,6 +2216,10 @@
 					"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": [
@@ -8921,6 +8926,79 @@
 			"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"
 		}
 	]
 }

package/dist/ai/components.json

@@ -1,8 +1,8 @@
 {
 	"schemaVersion": 1,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.64",
-	"generatedAt": "2026-10-26T22:25:55.188Z",
+	"version": "3.0.0-beta.65",
+	"generatedAt": "2026-10-27T14:11:46.011Z",
 	"legend": {
 		"referenceOnly": "true = internal building block, documented so trees and sources can be read. Never write it in a template; most are not exported.",
 		"types[].usage": "api = the type of a prop, event or slot value you pass; wrapper = a component Props/Events/Slots type (its component entry lists every field); advanced = everything else. An api type named <component>Props (BbOffCanvasProps) is that component's props: read its component entry.",

package/dist/ai/composables/useBbConfig.md

@@ -16,13 +16,14 @@ plugin (`bitbossUi({ ... })`) and cannot be changed at runtime.
 
 Use it for exactly one job: switching the locale of locale-aware components
 (built-in labels, close buttons, table/pagination strings) while the app runs.
+`locale` reads the current setting back, read-only.
 
 ## Import
 
 ```ts
 import { useBbConfig } from 'bitboss-ui';
 
-const { setConfig } = useBbConfig();
+const { setConfig, locale } = useBbConfig();
 ```
 
 ## API
@@ -37,6 +38,12 @@ declare function setConfig(patch: Partial<DynamicConfig>): void;
 Merges the patch into **this app's** config. The change is immediate and
 reactive — every mounted component in that app which reads the key updates.
 
+### `locale`
+
+A read-only `ComputedRef` of this app's locale exactly as it was set (`'it'`,
+`'it-IT'`), following every `setConfig`. Read it to pick your own words in the
+same language as the library's (the Inertia helpers' `messages.ts` does).
+
 ### Per-request locale under SSR
 
 The config is held **per Vue app**, and SSR gives every request its own app,