vue-router-query-sync 2.0.0-alpha.3 → 2.0.0-alpha.4

package/README.md

@@ -64,22 +64,33 @@ tab.value = 'favorite'
 
 When the same schema is used more than once on a page (e.g. one paginated component per
 tab), pass a `prefix` so each instance owns its own URL keys and they don't collide. Field
-names in `filters` stay unprefixed; only the URL key becomes `${prefix}.${key}`.
+names in `filters` stay unprefixed; only the URL key becomes `${prefix}-${key}`.
 
 ```ts
 const users  = useQueryFilters({ page: param.number({ default: 1 }) }, { prefix: 'users' })
 const orders = useQueryFilters({ page: param.number({ default: 1 }) }, { prefix: 'orders' })
 
-users.filters.page = 3   // URL: ?users.page=3
-orders.filters.page = 5  // URL: ?users.page=3&orders.page=5
+users.filters.page = 3   // URL: ?users-page=3
+orders.filters.page = 5  // URL: ?users-page=3&orders-page=5
 
-users.filters.page       // reads users.page only — independent from orders
+users.filters.page       // reads users-page only — independent from orders
 ```
 
-Each instance keeps its own state in the URL, so switching between tabs and back restores
-their pagination; a direct link reproduces everything. If you'd rather keep the URL minimal,
-render inactive tabs with `v-if` and call `reset()` in `onUnmounted` to drop the leaving
-tab's keys.
+With a unique prefix per instance, keys never collide. Each instance keeps its own state in
+the URL, so switching between tabs and back restores their pagination; a direct link
+reproduces everything.
+
+The prefix applies to the whole schema. To namespace only some keys, split by scope: keep
+shared keys in a plain (unprefixed) call and private keys in a prefixed one.
+
+```ts
+const { filters: shared } = useQueryFilters({ sort: param.enum(SortType) })            // ?sort=…
+const { filters }         = useQueryFilters({ page: param.number({ default: 1 }) },
+                                            { prefix: 'users' })                        // ?users-page=…
+```
+
+If you'd rather keep the URL minimal, render inactive tabs with `v-if` and call `reset()` in
+`onUnmounted` to drop the leaving tab's keys.
 
 ## `param`
 

package/dist/index.mjs

@@ -101,7 +101,7 @@ function k(e, r, t, u) {
   });
 }
 function $(e, r = {}) {
-  const t = S(), u = P(), l = Object.keys(e), { prefix: n } = r, c = (s) => n ? `${n}.${s}` : s, a = {};
+  const t = S(), u = P(), l = Object.keys(e), { prefix: n } = r, c = (s) => n ? `${n}-${s}` : s, a = {};
   for (const s of l)
     a[s] = k(t, u, c(s), e[s]);
   return { filters: m(a), patch: (s) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vue-router-query-sync",
-  "version": "2.0.0-alpha.3",
+  "version": "2.0.0-alpha.4",
   "description": "Reactive, typed view of Vue Router query params with codecs and defaults",
   "type": "module",
   "module": "./dist/index.mjs",