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

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

@@ -2335,6 +2335,54 @@ Nothing here fails to compile — these change what existing code does.
       stay open across picks (a settings panel of several radios): set
       `:close-on-select="false"`; `true` closes after every change, a
       multiple pick included.
+113.  **`useQueryObject` takes Inertia's visit options in one place** (after
+      3.0.0-beta.64, the Inertia helper, after `npx bitboss-ui helpers
+update`). Move `only`, `preserveState`, `preserveScroll` and `replace`
+      into `visitOptions: { only: ['invoices'] }`. `shouldNavigate: () => !x`
+      becomes `paused: () => x` (inverted); resuming now sends the object's
+      current state once, so a page that reassigned the object to catch up
+      after its own visit can drop that. `resetPage: true, resetKeys: [k]`
+      becomes `resetKeys: ['page', k]`: the default is `['page']` and a
+      passed list replaces it. `transform` is gone (pass a getter that builds
+      the keys) and so is `arrayFormat` (`QUERY_ARRAY_FORMAT` in
+      `useQuery.ts`, one value for every helper). `server: false` writes the
+      URL with no request.
+114.  **The URL helpers read and write the URL as the server does** (after
+      3.0.0-beta.64, `useQuery` / `useRouteQuery`, after a helpers update).
+      `useQuery` decodes once: `?q=R%26D` reads `R&D`, and an encoded `%2C`
+      separates a comma array as PHP and Spatie read it (with the comma
+      format a comma typed into free text reads back as a separator, as on
+      the server). Writes made before the server answers build on each other
+      (sort and direction in one click both land), and a write changes only
+      its own key. `useRouteQuery`: move `preserveScroll` / `preserveState`
+      into `visitOptions`; `null` / `undefined` now remove the key (it used
+      to write the string `'null'`); a repeated key reads its last value.
+115.  **The pager pushes history, and the visit helpers settle** (after
+      3.0.0-beta.64, after a helpers update). A `page` write is a history
+      entry (Back goes to the previous page; `visitOptions: { replace: true }`
+      keeps the old behaviour); a new `perPage` returns to page 1 in the same
+      visit; a page past the last goes to the last. `items` is a copy that a
+      visit asking for the prop resets, while other prop swaps keep its edits
+      (this replaces item 102's rule). New options `pageQueryKey` /
+      `perPageQueryKey` for a custom Laravel `pageName`. `usePromiseForm`
+      resolves `false` when a guard cancels and rejects an Inertia error page;
+      `useConfirmOnRouteLeave`'s `whitelist` now only lets submits through, so
+      a Cancel link to the list asks.
+116.  **The leave guard asks the browser too, and dirty checks stop crying
+      wolf** (after 3.0.0-beta.64, after a helpers update).
+      `useConfirmOnRouteLeave` now also gets the browser's "Leave site?"
+      prompt on a tab close, reload, typed URL or plain `<a>` (not for a
+      whitelisted save that leaves through `Inertia::location()`), takes
+      `stack`, and takes its words from the new `messages.ts` in the library's
+      `locale` (add your locale there instead of passing labels per page). `useHasChanged` no longer reads an untouched form with Dates,
+      Files or `undefined` as changed. `items` in the paginated helpers is a
+      deep copy, so editing a row leaves the page prop alone. `useScreenSizes`
+      follows the plugin's `mobileMaxWidth`; import `useMobile` from
+      `bitboss-ui` where you used `SCREEN_BREAKPOINT_MD`.
+117.  **Inertia 2 or 3** (3.0.0-beta.65). The optional `@inertiajs/vue3` peer
+      now starts at 2.0.0. The Inertia helpers run and type-check on both
+      majors; on Inertia 2, `useLazyProp` cannot keep the page's validation
+      errors across its reload.
 
 ## 7. Class overrides → variants
 

package/dist/ai/guides/passthrough.md

@@ -351,8 +351,10 @@ part accepts a function** on the instance, beside a plain value:
 - **The row's facts ride beside them.** Today that is `variant`, a typed
   string, where the rows have one: a dropdown entry's own (`default` when it
   has none), a toast's, or the component's (`BbTabs`). On `BbSelect` /
-  `BbSelectPopover` it is `known`: `true` for a `known-items` stand-in, whose
-  `item` is then `{ value, label }`, as in the `option` slot. Other props are
+  `BbSelectPopover` it is `known`: `true` for a `known-items` stand-in (a row
+  the form already held, named before the real options load; see the
+  [Fetch items playbook](./fetch-items-playbook.md)), whose `item` is then
+  `{ value, label }`, as in the `option` slot. Other props are
   not in it: you wrote the function where you pass them.
 - The result is a normal `PtValue` (a class list or `{ class, style, attrs }`);
   `false` / `null` / `undefined` mean _leave the row as it is_.

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

@@ -1,6 +1,6 @@
 {
 	"schema": 1,
-	"version": "3.0.0-beta.64",
+	"version": "3.0.0-beta.65",
 	"canon": "bb-canon/1",
 	"folder": "inertia-helpers",
 	"helpers": {
@@ -20,6 +20,7 @@
 			"file": "useConfirmOnRouteLeave.ts",
 			"summary": "A dirty-state guard: asks through useConfirm before an Inertia visit leaves the page.",
 			"closure": [
+				"messages.ts",
 				"useConfirmOnRouteLeave.ts"
 			],
 			"packages": [],
@@ -67,7 +68,9 @@
 			"packages": [
 				"object-code"
 			],
-			"typePackages": []
+			"typePackages": [
+				"@inertiajs/core"
+			]
 		},
 		"useLazyPropGetter": {
 			"file": "useLazyPropGetter.ts",
@@ -80,7 +83,9 @@
 			"packages": [
 				"object-code"
 			],
-			"typePackages": []
+			"typePackages": [
+				"@inertiajs/core"
+			]
 		},
 		"useLoading": {
 			"file": "useLoading.ts",
@@ -97,7 +102,7 @@
 			"closure": [
 				"types.ts",
 				"usePaginatedResponseContext.ts",
-				"useRouteQuery.ts",
+				"useQuery.ts",
 				"utils.ts"
 			],
 			"packages": [
@@ -137,21 +142,23 @@
 			"packages": [
 				"query-string"
 			],
-			"typePackages": []
+			"typePackages": [
+				"@inertiajs/core"
+			]
 		},
 		"useQueryObject": {
 			"file": "useQueryObject.ts",
 			"summary": "The filter engine: mirrors a filters object into the query string with an Inertia visit per change.",
 			"closure": [
 				"useQuery.ts",
-				"useQueryObject.ts",
-				"utils.ts"
+				"useQueryObject.ts"
 			],
 			"packages": [
-				"object-code",
 				"query-string"
 			],
-			"typePackages": []
+			"typePackages": [
+				"@inertiajs/core"
+			]
 		},
 		"useResourceContext": {
 			"file": "useResourceContext.ts",
@@ -170,12 +177,15 @@
 			"file": "useRouteQuery.ts",
 			"summary": "One query parameter as a writable ref; a write is a replace visit.",
 			"closure": [
+				"useQuery.ts",
 				"useRouteQuery.ts"
 			],
 			"packages": [
 				"query-string"
 			],
-			"typePackages": []
+			"typePackages": [
+				"@inertiajs/core"
+			]
 		},
 		"useScreenSizes": {
 			"file": "useScreenSizes.ts",
@@ -194,7 +204,7 @@
 			"closure": [
 				"types.ts",
 				"usePaginatedResponseContext.ts",
-				"useRouteQuery.ts",
+				"useQuery.ts",
 				"useTableContext.ts",
 				"useTableSelectionContext.ts",
 				"utils.ts"
@@ -235,6 +245,23 @@
 		}
 	},
 	"files": {
+		"messages.ts": {
+			"sha256": "da39a86e896a4b969b7d15a0a81cfa2739be2bd2a413661e4b5cbdabc1111296",
+			"local": [],
+			"packages": [
+				"bitboss-ui",
+				"vue"
+			],
+			"typePackages": [],
+			"published": {
+				"bytes": [
+					"da39a86e896a4b969b7d15a0a81cfa2739be2bd2a413661e4b5cbdabc1111296"
+				],
+				"babel7": [
+					"4501571c0b8ac3fe222ddda33cef111b0ca58713e565039e0df520f04cd1f45c"
+				]
+			}
+		},
 		"types.ts": {
 			"sha256": "1339fbfcebecb35d445a0fedfc5c1a5a986dd6cbb198fb6f32ae61f47a390593",
 			"local": [],
@@ -272,8 +299,10 @@
 			}
 		},
 		"useConfirmOnRouteLeave.ts": {
-			"sha256": "9b7d6fc224524123c55617528fe5c6a1ec866d168c96622fba1003086db468ed",
-			"local": [],
+			"sha256": "9f67146544d7b1db75997dce3a9483d9c23427b679da6f499886dd13f20f53c5",
+			"local": [
+				"messages.ts"
+			],
 			"packages": [
 				"@inertiajs/vue3",
 				"bitboss-ui",
@@ -286,14 +315,24 @@
 					"65e7cbb31b82e90dbd317a48152144776ae0a41100015b76d2d7567a2f9b1ee7",
 					"5234432d94be0fb0ecd6043d8adb7c4f4945dac68f20d0f7e79c3b85f1f56231",
 					"93ba89d29ff8fc4a9bfdfa707a3af29e47979d93700a320322899b9749aa7512",
-					"9b7d6fc224524123c55617528fe5c6a1ec866d168c96622fba1003086db468ed"
+					"9b7d6fc224524123c55617528fe5c6a1ec866d168c96622fba1003086db468ed",
+					"73620638c22423c81e3bcf891583d1d16fe9ecb9d63c418ffabe72c69113f086",
+					"34b79814dfb5644f25f05b53b3011bd8256b2f857a3d728f907b480cbb0c11e0",
+					"b25662a8675194ca2fe62e272f88a6a20c56377b1c3f4958a0f74bce5f68409a",
+					"6c2cc07e8207c360fb296305f381a081b626f4ff50021de4b99e487452acaf55",
+					"9f67146544d7b1db75997dce3a9483d9c23427b679da6f499886dd13f20f53c5"
 				],
 				"babel7": [
 					"19b6368a85f44e593d9fd3d31c559c13ce5774884e4cfa768afc160509fdf1a5",
 					"49efad212acb247101ff7143278f5a975a960b54e80b43e9cdd806cec6001457",
 					"5f93aa1bb789724576cbf871339fa6dab37eb2f607c320493974c879251e3477",
 					"a6be6e7bd518cb7f161f0a2e675a62d6d4e85bf6b7a0908dbb253faffc07df2a",
-					"a6be6e7bd518cb7f161f0a2e675a62d6d4e85bf6b7a0908dbb253faffc07df2a"
+					"a6be6e7bd518cb7f161f0a2e675a62d6d4e85bf6b7a0908dbb253faffc07df2a",
+					"20499f93df43e0450e5dbe393964e3eb6c597ae267e7b810c7cd6ea3328985ea",
+					"f59b014b3957cc07b99c27993238aab10bab68ec0c403785bc1a29bd29f64886",
+					"ecb2e2d1d42aab26a796c91ca4e48b84e8d7da611d6f4ac2b92551fa5b66724b",
+					"9d9607327e1504cd05a00bcbd4ee5206bbff222d6025231d26950031228cb176",
+					"4388c4791b925ea28e514cec9be2f1d35cad972daae8165393a10dcadfd6bcd8"
 				]
 			}
 		},
@@ -317,20 +356,25 @@
 			}
 		},
 		"useHasChanged.ts": {
-			"sha256": "3de762ee9ba9bc2afe1f78b130b2ccce0143e2d48e97a0bc72587d55e4f795b8",
+			"sha256": "166cb83201b372f3ee700295be475cc2b2529451571dd2c71ae81c81253dc19a",
 			"local": [
 				"utils.ts"
 			],
 			"packages": [
+				"object-code",
 				"vue"
 			],
 			"typePackages": [],
 			"published": {
 				"bytes": [
-					"3de762ee9ba9bc2afe1f78b130b2ccce0143e2d48e97a0bc72587d55e4f795b8"
+					"3de762ee9ba9bc2afe1f78b130b2ccce0143e2d48e97a0bc72587d55e4f795b8",
+					"98b59218f44200ea303363e2b4c9271bd3708facaa7e146bb42f826cc3e4b67c",
+					"166cb83201b372f3ee700295be475cc2b2529451571dd2c71ae81c81253dc19a"
 				],
 				"babel7": [
-					"afe5ef18c99f21b936186df5fc27043bf1b48306108d41e7424a5537e0a48110"
+					"afe5ef18c99f21b936186df5fc27043bf1b48306108d41e7424a5537e0a48110",
+					"6607c26d657ba39444fb80af32259bba7b7674ccb04b7a5d6a4e6c3acaf44bbc",
+					"8806dae9a3b370e74412309e90a91f06f86b7e7752765300fb86ce6814338d43"
 				]
 			}
 		},
@@ -351,7 +395,7 @@
 			}
 		},
 		"useLazyProp.ts": {
-			"sha256": "6c1365a1ced0bcea086cbbef080b8d11a19e69f43ac39542fe993cc948305bab",
+			"sha256": "f92cb58c56ce79dbd458b0c0976568bf6135c50233909196963d4ab67e20655b",
 			"local": [
 				"utils.ts"
 			],
@@ -359,20 +403,26 @@
 				"@inertiajs/vue3",
 				"vue"
 			],
-			"typePackages": [],
+			"typePackages": [
+				"@inertiajs/core"
+			],
 			"published": {
 				"bytes": [
 					"2cc15342591f3a6e6ede169236a67b5f1416e306f56097f7592b2f9c5a4c9f1a",
-					"6c1365a1ced0bcea086cbbef080b8d11a19e69f43ac39542fe993cc948305bab"
+					"6c1365a1ced0bcea086cbbef080b8d11a19e69f43ac39542fe993cc948305bab",
+					"6bc7b752c71c48dbac444e38d98aa64a8f11dc0bff1a4c1d952d6899e2d026dd",
+					"f92cb58c56ce79dbd458b0c0976568bf6135c50233909196963d4ab67e20655b"
 				],
 				"babel7": [
 					"40422db6fb69ec8857c00c33e0c91fdc3164aff5b31d2a58d81c97acf1385fe4",
-					"81352cc8ab909136175106eb4c6781498230ddc4f728bb2bd49c28a77e1aa843"
+					"81352cc8ab909136175106eb4c6781498230ddc4f728bb2bd49c28a77e1aa843",
+					"513cda52068426369b1eae003ea3553811f93c49bd294c133ae996280aec453b",
+					"0ced3ed753775463f5b185e3acda699ee7d809bcab6128487c9507f92e5a095f"
 				]
 			}
 		},
 		"useLazyPropGetter.ts": {
-			"sha256": "fe60121eee2ae6a9e742eb12513d5409f758fea9744bca5cb329ad878bde08e4",
+			"sha256": "9a31e21ebe707f23ff2b55a78ced1af2deeb1b3669ffeb120049a2010e766d66",
 			"local": [
 				"useLazyProp.ts",
 				"utils.ts"
@@ -383,10 +433,12 @@
 			],
 			"published": {
 				"bytes": [
-					"fe60121eee2ae6a9e742eb12513d5409f758fea9744bca5cb329ad878bde08e4"
+					"fe60121eee2ae6a9e742eb12513d5409f758fea9744bca5cb329ad878bde08e4",
+					"9a31e21ebe707f23ff2b55a78ced1af2deeb1b3669ffeb120049a2010e766d66"
 				],
 				"babel7": [
-					"dffeaba6cc75bffdf2fb7dd0218569aef732f0761f15f89eea7724a072cbcbf5"
+					"dffeaba6cc75bffdf2fb7dd0218569aef732f0761f15f89eea7724a072cbcbf5",
+					"4188638a7653efac9166a6cf7cd92ddcfba9e2072d6160f078e5627aca0cf381"
 				]
 			}
 		},
@@ -407,10 +459,10 @@
 			}
 		},
 		"usePaginatedResponseContext.ts": {
-			"sha256": "dd9e3fc870715bde5fc91e57068ce43d880a248aabe7eb1e1d18a7d2942851fd",
+			"sha256": "1bd1ceaf4387c103a8c49bfc32ee3b3267d9719e1d46862645b9db234fb74328",
 			"local": [
 				"types.ts",
-				"useRouteQuery.ts",
+				"useQuery.ts",
 				"utils.ts"
 			],
 			"packages": [
@@ -426,18 +478,22 @@
 					"94b8fa287b5e7f78fef60aa09248e19cf02c3086c01875d07a8c682e92fc064d",
 					"f253a9b456fddd938e0a6b47de6d751d9de3a7f594645385a1754c5c4b0b0aa0",
 					"ab85cddc1e2b878f3866466fc0c664f65b05274a9248a29d39c13a292a196369",
-					"dd9e3fc870715bde5fc91e57068ce43d880a248aabe7eb1e1d18a7d2942851fd"
+					"dd9e3fc870715bde5fc91e57068ce43d880a248aabe7eb1e1d18a7d2942851fd",
+					"01024e10347dfe2b9d70f2516e955a582d39fe8b30c917eb0cf7e826482284d1",
+					"1bd1ceaf4387c103a8c49bfc32ee3b3267d9719e1d46862645b9db234fb74328"
 				],
 				"babel7": [
 					"f4497f348d4c9f93a0f8dd99a40d86054786084056f900f4f94a1ab73df0c508",
 					"21e4b939126a2b3eb669fdf373aad7d6fe1aedaf8df39d31c822b61fd05950e6",
 					"f0ef3e517c9070006742d4bde478c94af85dda157a241689f71225d31794ea8c",
-					"37c6ebc63bd70413a02cc7bf2e1923dbd1dab63628ed19605d274d18717f53bf"
+					"37c6ebc63bd70413a02cc7bf2e1923dbd1dab63628ed19605d274d18717f53bf",
+					"ffa9f37128fd32fcf0ed8916540806f8d7484e738ba6154eb153d1deeecdba57",
+					"dd4939ba9da26b8f90074aaedcff7b8dfa7b8795d3d4e057899fe639ebee40c4"
 				]
 			}
 		},
 		"usePromiseForm.ts": {
-			"sha256": "bb13bb773189f65c6b3602ec37e8f552f0ebed245625f1e8eee00c7fd2fce151",
+			"sha256": "28c84f3bc631dc60b6aa206e3b68ce38de87396e80b1c473b76c6334c76c29c2",
 			"local": [
 				"useLoading.ts"
 			],
@@ -448,11 +504,15 @@
 			"published": {
 				"bytes": [
 					"8f71e163532614acb1ce288f6b363dc3d13f83e2915cc6f4fac511c2f9ccd6aa",
-					"bb13bb773189f65c6b3602ec37e8f552f0ebed245625f1e8eee00c7fd2fce151"
+					"bb13bb773189f65c6b3602ec37e8f552f0ebed245625f1e8eee00c7fd2fce151",
+					"c2bb7edd770dffd74779cac7ba53cd69149a19d2976bdf0a2e52a032750bf347",
+					"28c84f3bc631dc60b6aa206e3b68ce38de87396e80b1c473b76c6334c76c29c2"
 				],
 				"babel7": [
 					"d39045a53ce96fff1c1826e2c3afd1f25e6c175225409b51723911bb3548de7d",
-					"ed3ed5dbbecba86b30251c21dca3ee045e34a07cb0a245290314509690088700"
+					"ed3ed5dbbecba86b30251c21dca3ee045e34a07cb0a245290314509690088700",
+					"dcf4bdf6875493f109d1c90be73ddd0528b34df7d4c216ca0c0b730b43059c32",
+					"6c214e4bc5d716f79871956f120a4e830aa072e4742bb1a84e7bb79ec2cd8f00"
 				]
 			}
 		},
@@ -474,47 +534,54 @@
 			}
 		},
 		"useQuery.ts": {
-			"sha256": "979ff258297d99c2362eacceb0cc3be78d66a96c63028e513758226cd1e801b7",
+			"sha256": "9e50ce2bcbddd5fd0c0da520857bafe6d1ed9670d409681b3dbf447add7c0068",
 			"local": [],
 			"packages": [
 				"@inertiajs/vue3",
-				"query-string"
+				"query-string",
+				"vue"
+			],
+			"typePackages": [
+				"@inertiajs/core"
 			],
-			"typePackages": [],
 			"published": {
 				"bytes": [
-					"979ff258297d99c2362eacceb0cc3be78d66a96c63028e513758226cd1e801b7"
+					"979ff258297d99c2362eacceb0cc3be78d66a96c63028e513758226cd1e801b7",
+					"9e50ce2bcbddd5fd0c0da520857bafe6d1ed9670d409681b3dbf447add7c0068"
 				],
 				"babel7": [
-					"2fce175224709f11ce46d1921e8e71aba77a31c45948274a7f7e53e46e04dd8e"
+					"2fce175224709f11ce46d1921e8e71aba77a31c45948274a7f7e53e46e04dd8e",
+					"cee7a3f54aaa2ca164dad0ca27fad392df6433c641f1ae2d966d89a8b9c86472"
 				]
 			}
 		},
 		"useQueryObject.ts": {
-			"sha256": "3764deac55af86121c77ccd27eb50e2aede1849628487779400759fbc8864afa",
+			"sha256": "60d42b408ea3a788241830a08d646432e5ae22d1049a3d61505419f1294914fe",
 			"local": [
-				"useQuery.ts",
-				"utils.ts"
+				"useQuery.ts"
 			],
 			"packages": [
-				"@inertiajs/vue3",
 				"query-string",
 				"vue"
 			],
-			"typePackages": [],
+			"typePackages": [
+				"@inertiajs/core"
+			],
 			"published": {
 				"bytes": [
 					"671e59446e26643c5e99363aa16293a1e67cfad51bad177ae9e21e8a7927e35d",
-					"3764deac55af86121c77ccd27eb50e2aede1849628487779400759fbc8864afa"
+					"3764deac55af86121c77ccd27eb50e2aede1849628487779400759fbc8864afa",
+					"60d42b408ea3a788241830a08d646432e5ae22d1049a3d61505419f1294914fe"
 				],
 				"babel7": [
 					"98f575ad83ab02f95dbd985a12d3e4b601972e0f54ba6895c5a8c3146a0e552d",
-					"da358fa0137784539b2f34ad7e7b8baa6ed3c769af25fdd6ccfee4661464e5c3"
+					"da358fa0137784539b2f34ad7e7b8baa6ed3c769af25fdd6ccfee4661464e5c3",
+					"59fa47ce3fa22784623d5e0338db0ae81239e3303b59d3194c9755dce6300df9"
 				]
 			}
 		},
 		"useResourceContext.ts": {
-			"sha256": "8ff5b42e89f602000aa5ec7bd48bf1925b305736b4b9ff4adc8d1a562ed60f80",
+			"sha256": "59f4b6956906f21786ff1774ed4c851c8a66cfdd6e4aca23628607bcc7393abb",
 			"local": [
 				"useLoading.ts",
 				"utils.ts"
@@ -526,55 +593,67 @@
 			"published": {
 				"bytes": [
 					"fffe335e44ca95b376587ac61d370c72123c048dfe17b7f1444c31feccdc5679",
-					"8ff5b42e89f602000aa5ec7bd48bf1925b305736b4b9ff4adc8d1a562ed60f80"
+					"8ff5b42e89f602000aa5ec7bd48bf1925b305736b4b9ff4adc8d1a562ed60f80",
+					"c60311f8b0f81276de1749428baac6e50e7c54374377ac4149286d0637054c54",
+					"59f4b6956906f21786ff1774ed4c851c8a66cfdd6e4aca23628607bcc7393abb"
 				],
 				"babel7": [
 					"475e3201b9473ab2e9867c876099c51e518d78ec3eb9e44336236aa6955847f2",
-					"b218669166d3324f3568413fe3d5fb830fc84c61d2e7e96a0ba104761e8f791c"
+					"b218669166d3324f3568413fe3d5fb830fc84c61d2e7e96a0ba104761e8f791c",
+					"b4147dfc277d69cc135b1a50297e9ad02445fe21a8e69c28b7f8140a8acd1c5d",
+					"df0991f7fdf01522b1283243213db92033e404887db064cbef64b5b95a0555f6"
 				]
 			}
 		},
 		"useRouteQuery.ts": {
-			"sha256": "c964b6299dd58d23779e554ba8baf018bfd2f2af8a44871f2a547303446f2c44",
-			"local": [],
+			"sha256": "93138a8e991880ac7d405f556c82c0ca5c865f218225b915b91b53f07625db21",
+			"local": [
+				"useQuery.ts"
+			],
 			"packages": [
-				"@inertiajs/vue3",
 				"query-string",
 				"vue"
 			],
-			"typePackages": [],
+			"typePackages": [
+				"@inertiajs/core"
+			],
 			"published": {
 				"bytes": [
 					"bfb544301a3e3a794af63ecb3dd131f8e08eaabd7fad04b6cd48108faf79b416",
 					"67704ea31bf2b720eae37839d6437c58649c207cb941fad55fe366621a583d61",
-					"c964b6299dd58d23779e554ba8baf018bfd2f2af8a44871f2a547303446f2c44"
+					"c964b6299dd58d23779e554ba8baf018bfd2f2af8a44871f2a547303446f2c44",
+					"93138a8e991880ac7d405f556c82c0ca5c865f218225b915b91b53f07625db21"
 				],
 				"babel7": [
 					"804cf01e5ac73bcef4fd4d24fc70035bc0196b357cdb8151716ac3338c22bcff",
 					"39f5d53ea1cd7d7377f599aea938e7de18b0d2638bd2d89f6f3590a332a00d7f",
-					"303c4f70afc20583f9d632e6225c385be53f9430ca93cd4c3df8490410968990"
+					"303c4f70afc20583f9d632e6225c385be53f9430ca93cd4c3df8490410968990",
+					"ab0ee0032483f43af29e16d6c5e81ae50c9a8e0c83c6b7bcc49d11c138dad1bd"
 				]
 			}
 		},
 		"useScreenSizes.ts": {
-			"sha256": "3ee3f198c37c296f290bcd6f0e21b6dd1f3d1ff69c8ee181c6fb84cfb52aedea",
+			"sha256": "7e9225c105e702b90e57faa2c4b81ca15805070fec2993536d30ec5f9261168c",
 			"local": [],
 			"packages": [
 				"@vueuse/core",
+				"bitboss-ui",
 				"vue"
 			],
 			"typePackages": [],
 			"published": {
 				"bytes": [
-					"3ee3f198c37c296f290bcd6f0e21b6dd1f3d1ff69c8ee181c6fb84cfb52aedea"
+					"3ee3f198c37c296f290bcd6f0e21b6dd1f3d1ff69c8ee181c6fb84cfb52aedea",
+					"7e9225c105e702b90e57faa2c4b81ca15805070fec2993536d30ec5f9261168c"
 				],
 				"babel7": [
-					"758f920e7226fc5715d29c42956fb606014975f1b761d30b02ade61bbf2c82ba"
+					"758f920e7226fc5715d29c42956fb606014975f1b761d30b02ade61bbf2c82ba",
+					"06dc14a11445dad64c4a2442849d120e75102a682393614dfdb8beb2d3be2919"
 				]
 			}
 		},
 		"useTableContext.ts": {
-			"sha256": "f166413350761f4d5637db1414f0b8466b4b860c377b94e97bc328330e991faf",
+			"sha256": "d85753468803e500d8bead3ad27bbb4cf6e90e550bd2f5babd71274f82bb5359",
 			"local": [
 				"usePaginatedResponseContext.ts",
 				"useTableSelectionContext.ts",
@@ -586,10 +665,12 @@
 			"typePackages": [],
 			"published": {
 				"bytes": [
-					"f166413350761f4d5637db1414f0b8466b4b860c377b94e97bc328330e991faf"
+					"f166413350761f4d5637db1414f0b8466b4b860c377b94e97bc328330e991faf",
+					"d85753468803e500d8bead3ad27bbb4cf6e90e550bd2f5babd71274f82bb5359"
 				],
 				"babel7": [
-					"613bf76239ad67fb889892f10b96af3f320146f678851e8e4e8271b6fbc1c655"
+					"613bf76239ad67fb889892f10b96af3f320146f678851e8e4e8271b6fbc1c655",
+					"298a86a12c1501ce3d62cf40869f130faa6a5d0a092c86fb0f7f86569944b4a8"
 				]
 			}
 		},
@@ -631,7 +712,7 @@
 			}
 		},
 		"utils.ts": {
-			"sha256": "061f0964ce81782184b22349d2c82d0e39f312f33dd306aa2f66a9b50a0d060c",
+			"sha256": "f1cb5dd057c1bf36c3ea3583b311f9006405d453897c3e6d4ced4dd3bad1770d",
 			"local": [],
 			"packages": [
 				"object-code"
@@ -639,10 +720,12 @@
 			"typePackages": [],
 			"published": {
 				"bytes": [
-					"061f0964ce81782184b22349d2c82d0e39f312f33dd306aa2f66a9b50a0d060c"
+					"061f0964ce81782184b22349d2c82d0e39f312f33dd306aa2f66a9b50a0d060c",
+					"f1cb5dd057c1bf36c3ea3583b311f9006405d453897c3e6d4ced4dd3bad1770d"
 				],
 				"babel7": [
-					"a617c7d9a582990c0b7bbaa5ae05a47a8459e1d4aae03ddf1516e624bc0e3595"
+					"a617c7d9a582990c0b7bbaa5ae05a47a8459e1d4aae03ddf1516e624bc0e3595",
+					"f4f874e10e0975f930121858ce83ecf18aaacf100c5b01c69530ae5e23ee6544"
 				]
 			}
 		}

package/dist/ai/helpers/inertia/messages.ts

@@ -0,0 +1,33 @@
+// inertia-helpers/messages.ts
+// The words the helpers show, by the library's `locale`. Yours to edit: add
+// your app's locales next to `en` (keyed as you set `locale`: `it`, or `it-IT`
+// to tell regions apart). `helpers update` keeps your copy; if a release
+// adds words here, `npx bitboss-ui helpers diff messages` shows what to merge.
+import { useBbConfig } from 'bitboss-ui';
+import { computed } from 'vue';
+
+export type HelperMessages = {
+	leave: { title: string; text: string; yes: string; no: string };
+};
+
+export const messages: Record<string, HelperMessages> = {
+	en: {
+		leave: {
+			title: 'Unsaved changes',
+			text: 'You have unsaved changes. Leave without saving?',
+			yes: 'Discard changes',
+			no: 'Keep editing',
+		},
+	},
+};
+
+/** The messages for the current locale: `it-IT`, else `it`, else `en`. */
+export const useHelperMessages = () => {
+	const { locale } = useBbConfig();
+	return computed(
+		() =>
+			messages[locale.value] ??
+			messages[locale.value.split('-')[0]!.toLowerCase()] ??
+			messages.en!
+	);
+};