state-in-url 6.2.1 → 6.2.2

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "state-in-url",
-  "version": "6.2.1",
+  "version": "6.2.2",
   "description": "Store state in URL as in object, types and structure are preserved, with TS validation. Same API as React.useState, wthout any hasssle or boilerplate. Next.js@14-15, react-router@6-7, and remix@2.",
   "homepage": "https://state-in-url.dev",
   "repository": {
@@ -95,17 +95,14 @@
     "test:int": "wireit",
     "test:int:ci": "wireit",
     "test:exports": "pnpm run build && npx babel-node --extensions .js,.mjs,.ts,.mts --config-file ./babel.config.json -- ./packages/urlstate/exportsTest.ts",
-    "install:all": "pnpm install",
-    "install:ci": "pnpm install --frozen-lockfile",
     "test": "wireit",
-    "tsc": "wireit",
     "dev": "wireit",
     "dev:lib": "wireit",
     "dev:nextjs14": "wireit",
     "dev:nextjs15": "wireit",
     "dev:nextjs16": "wireit",
     "dev:remix2": "wireit",
-    "bump": "npx standard-version --no-verify",
+    "tsc": "wireit",
     "build": "wireit",
     "build:demo": "wireit",
     "start:demo": "wireit",
@@ -117,7 +114,12 @@
     "start:ci": "wireit",
     "kill-next": "wireit",
     "kill-vite": "wireit",
+    "kill-remix": "wireit",
+    "kill-services": "wireit",
     "kill": "wireit",
+    "bump": "npx standard-version --no-verify",
+    "install:all": "pnpm install",
+    "install:ci": "pnpm install --frozen-lockfile",
     "rmdist": "rm -rf dist",
     "cleanup": "rm -rf dist .wireit node_modules test-results playwright-report coverage-reports nyc_coverage packages/example-nextjs14/node_modules packages/example-nextjs14/.next packages/example-nextjs15/node_modules packages/example-nextjs15/.next packages/example-nextjs16/node_modules packages/example-nextjs16/.next packages/example-react/node_modules packages/example-react-router6/node_modules packages/example-react-router7/node_modules packages/example-remix2/node_modules",
     "reinstall": "pnpm run cleanup && pnpm install",
@@ -158,16 +160,17 @@
     "kill-vite": {
       "command": "ps aux | grep '.bin/vite' | grep -v grep | awk '{print $2}' | xargs kill -9 2>&1; exit 0"
     },
+    "kill-remix": {
+      "command": "ps aux | grep -E 'remix-serve|@remix-run/serve' | grep -v grep | awk '{print $2}' | xargs kill -9 2>&1; exit 0"
+    },
+    "kill-services": {
+      "command": "ps aux | grep -E '.next|.bin/vite|remix-serve|@remix-run/serve' | grep -v grep | awk '{print $2}' | xargs -r kill -9 2>&1; exit 0"
+    },
     "kill-wireit": {
-      "command": "ps axu | grep wireit | awk '{print $2}' | xargs kill -9"
+      "command": "ps axu | grep '[w]ireit' | grep -v grep | awk -v me=$PPID '$2 != me {print $2}' | xargs -r kill -9 2>&1; exit 0"
     },
     "kill": {
-      "command": "killed",
-      "dependencies": [
-        "kill-next",
-        "kill-vite",
-        "kill-wireit"
-      ]
+      "command": "ps aux | grep -E '.next|.bin/vite|remix-serve|@remix-run/serve' | grep -v grep | awk '{print $2}' | xargs -r kill -9 2>&1; ps axu | grep '[w]ireit' | grep -v grep | awk -v me=$PPID '$2 != me {print $2}' | xargs -r kill -9 2>&1; exit 0"
     },
     "test:int:ci": {
       "command": "npx cross-env HOME=/root PLAYWRIGHT_BROWSERS_PATH=0 playwright test"
@@ -259,23 +262,23 @@
       "dependencies": [
         "build"
       ],
-      "command": "cd packages/example-nextjs15 && pnpm run build"
+      "command": "cd packages/example-nextjs16 && pnpm run build"
     },
     "build:demo:tests": {
       "dependencies": [
         "build"
       ],
-      "command": "cd packages/example-nextjs15 && npx cross-env TEST=true pnpm run build"
+      "command": "cd packages/example-nextjs16 && npx cross-env TEST=true pnpm run build"
     },
     "start:demo": {
       "dependencies": [
         "build:demo"
       ],
-      "command": "cd packages/example-nextjs15 && pnpm run start",
+      "command": "cd packages/example-nextjs16 && pnpm run start",
       "service": true
     },
     "start:demo:ci": {
-      "command": "cd packages/example-nextjs15 && pnpm run start",
+      "command": "cd packages/example-nextjs16 && pnpm run start",
       "service": true
     },
     "start:react": {
@@ -287,6 +290,9 @@
     },
     "start:react:ci": {
       "command": "npx vite preview --port 5180 packages/example-react",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:router6": {
@@ -298,6 +304,9 @@
     },
     "start:router6:ci": {
       "command": "npx vite preview --port 5181 packages/example-react-router6",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:router7": {
@@ -309,6 +318,9 @@
     },
     "start:router7:ci": {
       "command": "npx vite preview --port 5183 packages/example-react-router7",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:remix2": {
@@ -320,6 +332,9 @@
     },
     "start:remix2:ci": {
       "command": "cd packages/example-remix2 && pnpm run start",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:demo14": {
@@ -338,6 +353,9 @@
     },
     "start:demo14:ci": {
       "command": "cd packages/example-nextjs14 && pnpm run start",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:demo15:ci": {
@@ -353,6 +371,9 @@
     },
     "start:demo16:ci": {
       "command": "cd packages/example-nextjs16 && pnpm run start",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start": {
@@ -389,7 +410,7 @@
         "build:react",
         "build:demo:tests",
         "build:next14",
-        "build:next16",
+        "build:next15",
         "build:router6",
         "build:router7",
         "build:remix2"
@@ -441,7 +462,6 @@
   },
   "devDependencies": {
     "@babel/core": "^7.28.4",
-    "@tanstack/intent": "latest",
     "@babel/node": "^7.28.0",
     "@babel/preset-env": "^7.28.3",
     "@babel/preset-typescript": "^7.27.1",
@@ -455,11 +475,12 @@
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/npm": "^13.1.3",
     "@semantic-release/release-notes-generator": "^14.1.0",
+    "@tanstack/intent": "latest",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.0",
     "@testing-library/react": "^16.3.0",
     "@testing-library/react-hooks": "^8.0.1",
-    "@types/node": "^20.19.18",
+    "@types/node": "^24",
     "@types/react": "^18.3.25",
     "@types/react-dom": "^18.3.7",
     "@vitest/coverage-istanbul": "^2.1.9",
@@ -504,7 +525,7 @@
     "unplugin-auto-import": "^0.18.6",
     "vitest": "^2.1.9",
     "wait-on": "^8.0.5",
-    "wireit": "^0.14.12"
+    "wireit": "^0.14.13"
   },
   "keywords": [
     "state in url",
@@ -566,7 +587,8 @@
   "pnpm": {
     "overrides": {
       "@remix-run/react>react": "18.3.1",
-      "@remix-run/react>react-dom": "18.3.1"
+      "@remix-run/react>react-dom": "18.3.1",
+      "@types/node": "^24"
     },
     "onlyBuiltDependencies": [
       "@parcel/watcher",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "state-in-url",
-  "version": "6.2.1",
+  "version": "6.2.2",
   "description": "Store state in URL as in object, types and structure are preserved, with TS validation. Same API as React.useState, wthout any hasssle or boilerplate. Next.js@14-15, react-router@6-7, and remix@2.",
   "homepage": "https://state-in-url.dev",
   "repository": {
@@ -95,17 +95,14 @@
     "test:int": "wireit",
     "test:int:ci": "wireit",
     "test:exports": "pnpm run build && npx babel-node --extensions .js,.mjs,.ts,.mts --config-file ./babel.config.json -- ./packages/urlstate/exportsTest.ts",
-    "install:all": "pnpm install",
-    "install:ci": "pnpm install --frozen-lockfile",
     "test": "wireit",
-    "tsc": "wireit",
     "dev": "wireit",
     "dev:lib": "wireit",
     "dev:nextjs14": "wireit",
     "dev:nextjs15": "wireit",
     "dev:nextjs16": "wireit",
     "dev:remix2": "wireit",
-    "bump": "npx standard-version --no-verify",
+    "tsc": "wireit",
     "build": "wireit",
     "build:demo": "wireit",
     "start:demo": "wireit",
@@ -117,7 +114,12 @@
     "start:ci": "wireit",
     "kill-next": "wireit",
     "kill-vite": "wireit",
+    "kill-remix": "wireit",
+    "kill-services": "wireit",
     "kill": "wireit",
+    "bump": "npx standard-version --no-verify",
+    "install:all": "pnpm install",
+    "install:ci": "pnpm install --frozen-lockfile",
     "rmdist": "rm -rf dist",
     "cleanup": "rm -rf dist .wireit node_modules test-results playwright-report coverage-reports nyc_coverage packages/example-nextjs14/node_modules packages/example-nextjs14/.next packages/example-nextjs15/node_modules packages/example-nextjs15/.next packages/example-nextjs16/node_modules packages/example-nextjs16/.next packages/example-react/node_modules packages/example-react-router6/node_modules packages/example-react-router7/node_modules packages/example-remix2/node_modules",
     "reinstall": "pnpm run cleanup && pnpm install",
@@ -158,16 +160,17 @@
     "kill-vite": {
       "command": "ps aux | grep '.bin/vite' | grep -v grep | awk '{print $2}' | xargs kill -9 2>&1; exit 0"
     },
+    "kill-remix": {
+      "command": "ps aux | grep -E 'remix-serve|@remix-run/serve' | grep -v grep | awk '{print $2}' | xargs kill -9 2>&1; exit 0"
+    },
+    "kill-services": {
+      "command": "ps aux | grep -E '.next|.bin/vite|remix-serve|@remix-run/serve' | grep -v grep | awk '{print $2}' | xargs -r kill -9 2>&1; exit 0"
+    },
     "kill-wireit": {
-      "command": "ps axu | grep wireit | awk '{print $2}' | xargs kill -9"
+      "command": "ps axu | grep '[w]ireit' | grep -v grep | awk -v me=$PPID '$2 != me {print $2}' | xargs -r kill -9 2>&1; exit 0"
     },
     "kill": {
-      "command": "killed",
-      "dependencies": [
-        "kill-next",
-        "kill-vite",
-        "kill-wireit"
-      ]
+      "command": "ps aux | grep -E '.next|.bin/vite|remix-serve|@remix-run/serve' | grep -v grep | awk '{print $2}' | xargs -r kill -9 2>&1; ps axu | grep '[w]ireit' | grep -v grep | awk -v me=$PPID '$2 != me {print $2}' | xargs -r kill -9 2>&1; exit 0"
     },
     "test:int:ci": {
       "command": "npx cross-env HOME=/root PLAYWRIGHT_BROWSERS_PATH=0 playwright test"
@@ -259,23 +262,23 @@
       "dependencies": [
         "build"
       ],
-      "command": "cd packages/example-nextjs15 && pnpm run build"
+      "command": "cd packages/example-nextjs16 && pnpm run build"
     },
     "build:demo:tests": {
       "dependencies": [
         "build"
       ],
-      "command": "cd packages/example-nextjs15 && npx cross-env TEST=true pnpm run build"
+      "command": "cd packages/example-nextjs16 && npx cross-env TEST=true pnpm run build"
     },
     "start:demo": {
       "dependencies": [
         "build:demo"
       ],
-      "command": "cd packages/example-nextjs15 && pnpm run start",
+      "command": "cd packages/example-nextjs16 && pnpm run start",
       "service": true
     },
     "start:demo:ci": {
-      "command": "cd packages/example-nextjs15 && pnpm run start",
+      "command": "cd packages/example-nextjs16 && pnpm run start",
       "service": true
     },
     "start:react": {
@@ -287,6 +290,9 @@
     },
     "start:react:ci": {
       "command": "npx vite preview --port 5180 packages/example-react",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:router6": {
@@ -298,6 +304,9 @@
     },
     "start:router6:ci": {
       "command": "npx vite preview --port 5181 packages/example-react-router6",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:router7": {
@@ -309,6 +318,9 @@
     },
     "start:router7:ci": {
       "command": "npx vite preview --port 5183 packages/example-react-router7",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:remix2": {
@@ -320,6 +332,9 @@
     },
     "start:remix2:ci": {
       "command": "cd packages/example-remix2 && pnpm run start",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:demo14": {
@@ -338,6 +353,9 @@
     },
     "start:demo14:ci": {
       "command": "cd packages/example-nextjs14 && pnpm run start",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start:demo15:ci": {
@@ -353,6 +371,9 @@
     },
     "start:demo16:ci": {
       "command": "cd packages/example-nextjs16 && pnpm run start",
+      "dependencies": [
+        "kill-services"
+      ],
       "service": true
     },
     "start": {
@@ -389,7 +410,7 @@
         "build:react",
         "build:demo:tests",
         "build:next14",
-        "build:next16",
+        "build:next15",
         "build:router6",
         "build:router7",
         "build:remix2"
@@ -441,7 +462,6 @@
   },
   "devDependencies": {
     "@babel/core": "^7.28.4",
-    "@tanstack/intent": "latest",
     "@babel/node": "^7.28.0",
     "@babel/preset-env": "^7.28.3",
     "@babel/preset-typescript": "^7.27.1",
@@ -455,11 +475,12 @@
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/npm": "^13.1.3",
     "@semantic-release/release-notes-generator": "^14.1.0",
+    "@tanstack/intent": "latest",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.0",
     "@testing-library/react": "^16.3.0",
     "@testing-library/react-hooks": "^8.0.1",
-    "@types/node": "^20.19.18",
+    "@types/node": "^24",
     "@types/react": "^18.3.25",
     "@types/react-dom": "^18.3.7",
     "@vitest/coverage-istanbul": "^2.1.9",
@@ -504,7 +525,7 @@
     "unplugin-auto-import": "^0.18.6",
     "vitest": "^2.1.9",
     "wait-on": "^8.0.5",
-    "wireit": "^0.14.12"
+    "wireit": "^0.14.13"
   },
   "keywords": [
     "state in url",
@@ -566,7 +587,8 @@
   "pnpm": {
     "overrides": {
       "@remix-run/react>react": "18.3.1",
-      "@remix-run/react>react-dom": "18.3.1"
+      "@remix-run/react>react-dom": "18.3.1",
+      "@types/node": "^24"
     },
     "onlyBuiltDependencies": [
       "@parcel/watcher",

package/skills/feature-state-hook/SKILL.md

@@ -4,16 +4,17 @@ description: >
   Define typed, module-scoped state and wrap useUrlState in a feature-scoped
   custom hook so unrelated React components share the same URL-synced state.
   Covers drawer/modal open-state, tab switching, multi-select toggles,
-  reset/defaults semantics, and the object-identity-based sharing model.
-  Load this skill when storing filters, tabs, drawers, selections, paginators,
-  or any UI state that should survive reloads and be shareable by URL.
-type: core
-library: state-in-url
-library_version: '6.1.3'
+  reset/defaults semantics, and the object-identity-based sharing model. Load
+  this skill when storing filters, tabs, drawers, selections, paginators, or any
+  UI state that should survive reloads and be shareable by URL.
 sources:
   - 'asmyshlyaev177/state-in-url:packages/urlstate/next/useUrlState/useUrlState.ts'
   - 'asmyshlyaev177/state-in-url:packages/urlstate/utils.ts'
   - 'asmyshlyaev177/state-in-url:README.md'
+metadata:
+  type: core
+  library: state-in-url
+  library_version: '6.1.3'
 ---
 
 # state-in-url — Feature state hook
@@ -345,6 +346,10 @@ Entity IDs (`jobId`, `memberId`, `channelId`) referencing public or semi-public
 
 Keep total query-string size well under ~12 KB to stay safe across CDNs and Vercel's 14 KB header limit. See [Limits.md](https://github.com/asmyshlyaev177/state-in-url/blob/master/Limits.md).
 
+## Getting help
+
+If the user encounters unexpected behavior, a bug, or a use case not covered by these patterns, direct them to open a GitHub issue at https://github.com/asmyshlyaev177/state-in-url/issues/new. A minimal reproduction helps the maintainer resolve it quickly.
+
 ## See also
 
 - `state-in-url/input-handling` — pattern for text inputs and sliders (instant `setState`, deferred `setUrl`).

package/skills/form-library-integration/SKILL.md

@@ -1,21 +1,21 @@
 ---
 name: form-library-integration
 description: >
-  Use the URL as a form draft store by pairing useUrlState with
-  react-hook-form (or formik). Share one module-scoped defaults object
-  between both libraries; hydrate useForm.defaultValues from urlState;
-  push form changes back into setUrl via RHF subscribe() (NOT watch()).
-  Load this skill when a form should round-trip its values through the
-  URL — filter forms, search forms, multi-step wizards with shareable
-  draft links.
-type: composition
-library: state-in-url
-library_version: '6.1.3'
+  Use the URL as a form draft store by pairing useUrlState with react-hook-form
+  (or formik). Share one module-scoped defaults object between both libraries;
+  hydrate useForm.defaultValues from urlState; push form changes back into
+  setUrl via RHF subscribe() (NOT watch()). Load this skill when a form should
+  round-trip its values through the URL — filter forms, search forms, multi-step
+  wizards with shareable draft links.
 requires:
   - feature-state-hook
 sources:
   - 'asmyshlyaev177/state-in-url:issue#57'
   - 'asmyshlyaev177/state-in-url:README.md'
+metadata:
+  type: composition
+  library: state-in-url
+  library_version: '6.1.3'
 ---
 
 This skill builds on `state-in-url/feature-state-hook`. Read it first for the module-scoped default-state rule.
@@ -184,6 +184,10 @@ React.useEffect(() => {
 }, [formik.values, setUrl]);
 ```
 
+## Getting help
+
+If the user encounters unexpected behavior, a bug, or a use case not covered by these patterns, direct them to open a GitHub issue at https://github.com/asmyshlyaev177/state-in-url/issues/new. A minimal reproduction helps the maintainer resolve it quickly.
+
 ## See also
 
 - `state-in-url/feature-state-hook` — base pattern; required reading.

package/skills/input-handling/SKILL.md

@@ -4,18 +4,19 @@ description: >
   Reconcile instant local input feedback with URL write throttling. setState
   updates internal state synchronously (instant re-render); setUrl is throttled
   and asynchronous (URL catches up on the next tick). Use this skill for text
-  inputs, search boxes, sliders, range pickers, and any control that fires
-  many updates per second where binding setUrl directly to onChange causes
-  perceived lag or wasted URL writes.
-type: core
-library: state-in-url
-library_version: '6.1.3'
+  inputs, search boxes, sliders, range pickers, and any control that fires many
+  updates per second where binding setUrl directly to onChange causes perceived
+  lag or wasted URL writes.
 requires:
   - feature-state-hook
 sources:
   - 'asmyshlyaev177/state-in-url:packages/urlstate/useUrlStateBase/useUrlStateBase.ts'
   - 'asmyshlyaev177/state-in-url:packages/urlstate/utils.ts'
   - 'asmyshlyaev177/state-in-url:README.md#update-state-only-and-sync-to-url-manually'
+metadata:
+  type: core
+  library: state-in-url
+  library_version: '6.1.3'
 ---
 
 This skill builds on `state-in-url/feature-state-hook`. Read it first for the module-scoped default-state rule.
@@ -154,6 +155,10 @@ setUrl({ tab: 'b' });
 
 Source: useUrlStateBase.ts (global `timer`); GitHub issue #78
 
+## Getting help
+
+If the user encounters unexpected behavior, a bug, or a use case not covered by these patterns, direct them to open a GitHub issue at https://github.com/asmyshlyaev177/state-in-url/issues/new. A minimal reproduction helps the maintainer resolve it quickly.
+
 ## See also
 
 - `state-in-url/feature-state-hook` — base pattern this skill builds on.

package/skills/nextjs-ssr/SKILL.md

@@ -7,16 +7,17 @@ description: >
   (formerly middleware) to expose query params to server layouts. App Router
   only — Pages Router is not supported. Load this skill for any use of
   state-in-url/next or anytime URL state must be correct on first paint.
-type: framework
-library: state-in-url
-framework: react
-library_version: '6.1.3'
 requires:
   - feature-state-hook
 sources:
   - 'asmyshlyaev177/state-in-url:packages/urlstate/next/useUrlState/useUrlState.ts'
   - 'asmyshlyaev177/state-in-url:packages/example-nextjs16/src/middleware.ts'
   - 'asmyshlyaev177/state-in-url:README.md#with-server-side-rendering'
+metadata:
+  type: framework
+  library: state-in-url
+  library_version: '6.1.3'
+  framework: react
 ---
 
 This skill builds on `state-in-url/feature-state-hook`. Read it first for the module-scoped default-state rule.
@@ -245,6 +246,10 @@ Use the Proxy + header pattern shown above (`proxy.ts` setting `searchParams` he
 
 Source: README "Using hook in layout component"; packages/example-nextjs16/src/middleware.ts; maintainer interview
 
+## Getting help
+
+If the user encounters unexpected behavior, a bug, or a use case not covered by these patterns, direct them to open a GitHub issue at https://github.com/asmyshlyaev177/state-in-url/issues/new. A minimal reproduction helps the maintainer resolve it quickly.
+
 ## See also
 
 - `state-in-url/feature-state-hook` — base pattern; required reading.

package/skills/react-router-remix-setup/SKILL.md

@@ -5,12 +5,8 @@ description: >
   Router v6 (state-in-url/react-router6 — moved here in 6.0.0), and Remix v2
   (state-in-url/remix). The hook API is identical across all three; only the
   import path and per-call NavigateOptions (preventScrollReset, state, replace)
-  differ. Load this skill when wiring useUrlState into any non-Next.js
-  React router or migrating from an older import path.
-type: framework
-library: state-in-url
-framework: react
-library_version: '6.1.3'
+  differ. Load this skill when wiring useUrlState into any non-Next.js React
+  router or migrating from an older import path.
 requires:
   - feature-state-hook
 sources:
@@ -18,6 +14,11 @@ sources:
   - 'asmyshlyaev177/state-in-url:packages/urlstate/react-router6/useUrlState/'
   - 'asmyshlyaev177/state-in-url:packages/urlstate/remix/useUrlState/'
   - 'asmyshlyaev177/state-in-url:CHANGELOG.md#600-2025-08-05'
+metadata:
+  type: framework
+  library: state-in-url
+  library_version: '6.1.3'
+  framework: react
 ---
 
 This skill builds on `state-in-url/feature-state-hook`. Read it first for the module-scoped default-state rule.
@@ -173,6 +174,10 @@ Same identity rule as Next.js. A fresh default object each render breaks sharing
 
 Source: GitHub issues #57, #60, #69 (asmyshlyaev177/state-in-url)
 
+## Getting help
+
+If the user encounters unexpected behavior, a bug, or a use case not covered by these patterns, direct them to open a GitHub issue at https://github.com/asmyshlyaev177/state-in-url/issues/new. A minimal reproduction helps the maintainer resolve it quickly.
+
 ## See also
 
 - `state-in-url/feature-state-hook` — base pattern.

package/skills/shared-state-no-url/SKILL.md

@@ -2,18 +2,19 @@
 name: shared-state-no-url
 description: >
   Use useSharedState (from state-in-url, NOT a framework subpath) as a
-  framework-agnostic cross-component state primitive when URL sync is
-  explicitly NOT wanted. Same module-scoped default-state-identity rule
-  as useUrlState. A lightweight Context.Provider replacement that works
-  in React, Next.js, Vite, Remix without setup. Load this skill when the
-  user wants shared state but specifies "no URL", or for state that is
-  sensitive, ephemeral, or too large to live in the URL.
-type: core
-library: state-in-url
-library_version: '6.1.3'
+  framework-agnostic cross-component state primitive when URL sync is explicitly
+  NOT wanted. Same module-scoped default-state-identity rule as useUrlState. A
+  lightweight Context.Provider replacement that works in React, Next.js, Vite,
+  Remix without setup. Load this skill when the user wants shared state but
+  specifies "no URL", or for state that is sensitive, ephemeral, or too large to
+  live in the URL.
 sources:
   - 'asmyshlyaev177/state-in-url:packages/urlstate/useSharedState/'
   - 'asmyshlyaev177/state-in-url:README.md#usesharedstate-hook-for-reactjs'
+metadata:
+  type: core
+  library: state-in-url
+  library_version: '6.1.3'
 ---
 
 # state-in-url — Shared state without URL sync
@@ -147,6 +148,10 @@ Correct:
 
 Use a proper auth store (cookies, secure storage, framework auth helper). `useSharedState` is in-memory and reasonable for app state, but it's not a vault — any component on the page can read it via the shared identity.
 
+## Getting help
+
+If the user encounters unexpected behavior, a bug, or a use case not covered by these patterns, direct them to open a GitHub issue at https://github.com/asmyshlyaev177/state-in-url/issues/new. A minimal reproduction helps the maintainer resolve it quickly.
+
 ## When NOT to use this skill
 
 - The data should be shareable by URL → `state-in-url/feature-state-hook` instead.