{"_id":"@01edu/signal-router","_rev":"8-39b96892b07a7015ed32f4488060a408","name":"@01edu/signal-router","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.4":{"name":"@01edu/signal-router","version":"0.1.4","license":"MIT","_id":"@01edu/signal-router@0.1.4","maintainers":[{"name":"kigiri","email":"le.mikmac@gmail.com"}],"homepage":"https://github.com/01-edu/framework#readme","bugs":{"url":"https://github.com/01-edu/framework/issues"},"dist":{"shasum":"6a5bfaebd3ccd156177f6d85e04665eab782f314","tarball":"https://registry.npmjs.org/@01edu/signal-router/-/signal-router-0.1.4.tgz","fileCount":6,"integrity":"sha512-qaVGoWoYwW6GvsWFdxz/XyXv8BnhoyHDiW36RA79LVuTTnpkAskDSWbj74Z2RK0Y7/D/vX8ixHrK4xglgfSpQQ==","signatures":[{"sig":"MEUCIQD+T1U0d9dRUoRMH54dTEXnbn+XvEb69jbTIwYiFzrPmgIgZF9VTmfCI7jjtJf6pGNpx3mHoNpkPZ7mbd45uNn1YaU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22697},"module":"./esm/mod.js","exports":{".":{"import":"./esm/mod.js"}},"gitHead":"4fcff11f56c96bc6539eed9dd73a962137072d9a","scripts":{"test":"node test_runner.js"},"_npmUser":{"name":"kigiri","email":"le.mikmac@gmail.com"},"repository":{"url":"git+https://github.com/01-edu/framework.git","type":"git"},"_npmVersion":"11.6.2","description":"generated npm version of jsr:@01edu/signal-router","directories":{},"sideEffects":false,"_nodeVersion":"24.9.0","dependencies":{"preact":"^10.27.2","@preact/signals":"^2.5.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"picocolors":"^1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/signal-router_0.1.4_1764277989278_0.6016976175523341","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@01edu/signal-router","version":"0.1.5","license":"MIT","_id":"@01edu/signal-router@0.1.5","maintainers":[{"name":"kigiri","email":"le.mikmac@gmail.com"}],"homepage":"https://github.com/01-edu/framework#readme","bugs":{"url":"https://github.com/01-edu/framework/issues"},"dist":{"shasum":"1f1eb64a25cc056127caeca25f34f252c503820d","tarball":"https://registry.npmjs.org/@01edu/signal-router/-/signal-router-0.1.5.tgz","fileCount":7,"integrity":"sha512-ZtMGuC++lXBhxvTiT12qRqGWn6CmkR3gjLSGKMKXnevP7A6Me8uQYotuj/GGFkQl3SMQmnPSVnv38rK3nmo5Kw==","signatures":[{"sig":"MEQCIG9TGywKjSYdLAX4RTViV5B+ks629EEM4I9ll3Poa/0gAiB/OiARjkY407hT4neLfOE9XdbHcDv7P6SXk7rGetmMyg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@01edu%2fsignal-router@0.1.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":23844},"module":"./esm/mod.js","exports":{".":{"import":"./esm/mod.js"}},"gitHead":"081d8cee3d11e7a627b4346663e90ab83518e6bd","scripts":{"test":"node test_runner.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6fa53fb1-8cb1-4311-b645-61ce0eb2fcef"}},"repository":{"url":"git+https://github.com/01-edu/framework.git","type":"git"},"_npmVersion":"11.6.2","description":"Small SPA router based on preact signals","directories":{},"sideEffects":false,"_nodeVersion":"24.11.1","dependencies":{},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"picocolors":"^1.0.0"},"peerDependencies":{"preact":"^10.27.2","@preact/signals":"^2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/signal-router_0.1.5_1764340389099_0.029919225788615167","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@01edu/signal-router","version":"0.1.6","license":"MIT","_id":"@01edu/signal-router@0.1.6","maintainers":[{"name":"kigiri","email":"le.mikmac@gmail.com"}],"homepage":"https://github.com/01-edu/framework#readme","bugs":{"url":"https://github.com/01-edu/framework/issues"},"dist":{"shasum":"63af4033f7d2a93eb28701936cee443af6fb4785","tarball":"https://registry.npmjs.org/@01edu/signal-router/-/signal-router-0.1.6.tgz","fileCount":7,"integrity":"sha512-u83zANpA/O2O6A2xwRKQZJfOVdxUbfqp77uV7ZZ/XJZT4OnVqYAhs4j0tViUDQMAN7inWWtOzYe2PGNd/adsww==","signatures":[{"sig":"MEUCIQCtTOg89MjVO9jIsod3bWun1gVj+7eHe4XC7zbjR1vP4gIgRMm6pQbVsfJyK5he+8IpRHSUmgDwJlMn8aVRtFuay0Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@01edu%2fsignal-router@0.1.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":23844},"module":"./esm/mod.js","exports":{".":{"import":"./esm/mod.js"}},"gitHead":"b1124e3ea7d1d125f28a9c49f238d637ff9f690f","scripts":{"test":"node test_runner.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6fa53fb1-8cb1-4311-b645-61ce0eb2fcef"}},"repository":{"url":"git+https://github.com/01-edu/framework.git","type":"git"},"_npmVersion":"11.6.2","description":"Small SPA router based on preact signals","directories":{},"sideEffects":false,"_nodeVersion":"24.11.1","dependencies":{},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"picocolors":"^1.0.0"},"peerDependencies":{"preact":"^10.27.2","@preact/signals":"^2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/signal-router_0.1.6_1764346989107_0.5767781663416931","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@01edu/signal-router","version":"0.1.7","license":"MIT","_id":"@01edu/signal-router@0.1.7","maintainers":[{"name":"kigiri","email":"le.mikmac@gmail.com"}],"homepage":"https://github.com/01-edu/framework#readme","bugs":{"url":"https://github.com/01-edu/framework/issues"},"dist":{"shasum":"1f6962799234876f1790851dd8f9608e4ab94b76","tarball":"https://registry.npmjs.org/@01edu/signal-router/-/signal-router-0.1.7.tgz","fileCount":7,"integrity":"sha512-mZEHpyIrLmZodRdh6m2uNyGmp87ki0HSoyxVezIMAT4p1xYaahKpRB+h1VOUrDf0mJWTjSKKsxQFSG/KTrRBpQ==","signatures":[{"sig":"MEUCIDf8bMT30liFmJNjC7iU/c/RN5XraYGJmCUVE2jN15AkAiEAzVZO6zImez4aupmuPsVtYjB5Mlw4weWbAYyiqZzA4wI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@01edu%2fsignal-router@0.1.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":24562},"module":"./esm/mod.js","exports":{".":{"import":"./esm/mod.js"}},"gitHead":"152516d0a2ed7e7684b608082583dbda83306a83","scripts":{"test":"node test_runner.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6fa53fb1-8cb1-4311-b645-61ce0eb2fcef"}},"repository":{"url":"git+https://github.com/01-edu/framework.git","type":"git"},"_npmVersion":"11.6.2","description":"Small SPA router based on preact signals","directories":{},"sideEffects":false,"_nodeVersion":"24.12.0","dependencies":{},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"picocolors":"^1.0.0"},"peerDependencies":{"preact":"^10.27.2","@preact/signals":"^2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/signal-router_0.1.7_1768231527938_0.08713137214732258","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@01edu/signal-router","version":"0.2.1","license":"MIT","_id":"@01edu/signal-router@0.2.1","maintainers":[{"name":"01edu_ai","email":"sysadmin@01edu.ai"},{"name":"kigiri","email":"le.mikmac@gmail.com"}],"homepage":"https://github.com/01-edu/framework#readme","bugs":{"url":"https://github.com/01-edu/framework/issues"},"dist":{"shasum":"07e0c7ab93e39c038c360fe22fce360c38a3a8ec","tarball":"https://registry.npmjs.org/@01edu/signal-router/-/signal-router-0.2.1.tgz","fileCount":7,"integrity":"sha512-xwZlgRt2Vtt19efcNUXXuRQH9HPuTeXC+Fgook94sEMHLu50ArHD0Bwsx5HinmlGbJbLy66ZW21QWkhsIL37lA==","signatures":[{"sig":"MEYCIQDEMUFIyJ2RA3egAmKYPhVEqf3zAHXJdPDYSCN87UxKpAIhAPEgftD3Yp7Jb0CvZo+ZWVVx+zVjL3UgrohWhs0isacv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@01edu%2fsignal-router@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":24562},"module":"./esm/mod.js","exports":{".":{"import":"./esm/mod.js"}},"gitHead":"295f23a0467c73357735628b5569b27e96aa6b14","scripts":{"test":"node test_runner.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6fa53fb1-8cb1-4311-b645-61ce0eb2fcef"}},"repository":{"url":"git+https://github.com/01-edu/framework.git","type":"git"},"_npmVersion":"11.9.0","description":"Small SPA router based on preact signals","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","dependencies":{},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"picocolors":"^1.0.0"},"peerDependencies":{"preact":"^10.29.0","@preact/signals":"^2.9.0"},"_npmOperationalInternal":{"tmp":"tmp/signal-router_0.2.1_1775054816888_0.8639005068512293","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@01edu/signal-router","version":"0.2.2","license":"MIT","_id":"@01edu/signal-router@0.2.2","maintainers":[{"name":"01edu_ai","email":"sysadmin@01edu.ai"},{"name":"kigiri","email":"le.mikmac@gmail.com"}],"homepage":"https://github.com/01-edu/framework#readme","bugs":{"url":"https://github.com/01-edu/framework/issues"},"dist":{"shasum":"d4f42f7bfaa7d29118e297fedde39b92ed6f6866","tarball":"https://registry.npmjs.org/@01edu/signal-router/-/signal-router-0.2.2.tgz","fileCount":7,"integrity":"sha512-synRhAav0HJnf4hJTsWyK0Jrx2j+Nm9MRHLgeEIUgqEFrY+E0+oLsWxYvjeMnRRlWFOL1Cs8f/aPRWiO+27M7w==","signatures":[{"sig":"MEQCIB2ejm7hZkTHA+4jjEEqHAkt94G4zRPjVoq122Ng6brRAiBjv0HciGaT5MB5PfHhcUVzSi/JckbVcfdPvbER+Z7Jng==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@01edu%2fsignal-router@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":24589},"module":"./esm/mod.js","exports":{".":{"import":"./esm/mod.js"}},"gitHead":"254958d2d3d9c137756efb14b785b4a1b917fa49","scripts":{"test":"node test_runner.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6fa53fb1-8cb1-4311-b645-61ce0eb2fcef"}},"repository":{"url":"git+https://github.com/01-edu/framework.git","type":"git"},"_npmVersion":"11.11.0","description":"Small SPA router based on preact signals","directories":{},"sideEffects":false,"_nodeVersion":"24.14.1","dependencies":{},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"picocolors":"^1.0.0"},"peerDependencies":{"preact":"^10.29.0","@preact/signals":"^2.9.0"},"_npmOperationalInternal":{"tmp":"tmp/signal-router_0.2.2_1777975493077_0.795431099381988","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@01edu/signal-router","version":"0.2.3","description":"Small SPA router based on preact signals","repository":{"type":"git","url":"git+https://github.com/01-edu/framework.git"},"license":"MIT","bugs":{"url":"https://github.com/01-edu/framework/issues"},"module":"./esm/mod.js","exports":{".":{"import":"./esm/mod.js"}},"scripts":{"test":"node test_runner.js"},"sideEffects":false,"publishConfig":{"access":"public","provenance":true,"registry":"https://registry.npmjs.org/"},"dependencies":{},"devDependencies":{"picocolors":"^1.0.0"},"peerDependencies":{"@preact/signals":"^2.9.0","preact":"^10.29.1"},"gitHead":"60bdd38c9d04ed8d6936eb68d810aa5d64de1bce","_id":"@01edu/signal-router@0.2.3","homepage":"https://github.com/01-edu/framework#readme","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-Eg2ORuigaA8i3vM+Lr4k0P7+A53vZ3mKb2wsVnbBslkItaebEFwPUDxXiz2zDCJYHd06wLdvd64r/VRQQw6XFw==","shasum":"71b736a64073adc69567d43eac947a397466a1f7","tarball":"https://registry.npmjs.org/@01edu/signal-router/-/signal-router-0.2.3.tgz","fileCount":7,"unpackedSize":24589,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@01edu%2fsignal-router@0.2.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIChkXEdNk3BVIolISzyQPja628jqrnltYCeo30GljE9KAiBfi3PfQv7ezy6CtOcULBoeT8eoJX6vNYJyOCJbtU2iHA=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6fa53fb1-8cb1-4311-b645-61ce0eb2fcef"}},"directories":{},"maintainers":[{"name":"01edu_ai","email":"sysadmin@01edu.ai"},{"name":"kigiri","email":"le.mikmac@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/signal-router_0.2.3_1777990292589_0.7622686258665077"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-27T21:13:09.212Z","modified":"2026-05-05T14:11:33.136Z","0.1.4":"2025-11-27T21:13:09.486Z","0.1.5":"2025-11-28T14:33:09.303Z","0.1.6":"2025-11-28T16:23:09.297Z","0.1.7":"2026-01-12T15:25:28.078Z","0.2.1":"2026-04-01T14:46:57.043Z","0.2.2":"2026-05-05T10:04:53.207Z","0.2.3":"2026-05-05T14:11:32.745Z"},"bugs":{"url":"https://github.com/01-edu/framework/issues"},"license":"MIT","homepage":"https://github.com/01-edu/framework#readme","repository":{"type":"git","url":"git+https://github.com/01-edu/framework.git"},"description":"Small SPA router based on preact signals","maintainers":[{"name":"01edu_ai","email":"sysadmin@01edu.ai"},{"name":"kigiri","email":"le.mikmac@gmail.com"}],"readme":"# @01edu/router-signal\n\nTiny SPA routing helpers built on top of @preact/signals that treat the URL as\nyour application state.\n\n## Why URL as storage\n\nUsing the URL as the single source of truth gives you, for free:\n\n- Shareable and bookmarkable state: copy the URL to reproduce the exact view and\n  filters.\n- Native navigation: back/forward buttons, reload, and deep links just work.\n- Durable state: survives reloads and tab restores.\n- Zero extra state containers: no bespoke stores, reducers, or custom hooks.\n- Observable with minimal invalidation: we expose simple reads backed by\n  computed signals; you don’t author new signals.\n\nThis package embraces that: it exposes just a few primitives that read/write the\nURL and let the browser do the rest.\n\n## What you get\n\n- `A` — a typed anchor that performs client-side navigation for same-origin\n  paths\n- `navigate` — programmatic navigation using `history.pushState`/`replaceState`\n- `replaceParams` — rebuild query strings in a predictable way\n- `url` — reactive, read-only helpers: `path`, `hash`, `params`, `equals`\n\nTrailing slashes are normalized away (`/users/` → `/users`), and query parameter\norder doesn’t matter when comparing URLs.\n\n## Quick start\n\nUse the `A` component instead of anchors. It preserves all native behaviors\n(open in new tab, copy link address, etc.) and does SPA navigation for\nsame-origin, non-`/api/*` URLs.\n\n```tsx\nimport { A } from '@01edu/router-signal'\n\nexport function Nav() {\n  return (\n    <nav>\n      <A href='/'>Home</A>\n      <A href='/users' params={{ page: 2 }}>Users (page 2)</A>\n      <A href='https://example.com'>External (normal link)</A>\n    </nav>\n  )\n}\n```\n\nProgrammatic navigation:\n\n> Always prefer using an `A` over a `navigate`, use of navigate in `onClick` are\n> code smells.\n\n```ts\nimport { navigate } from '@01edu/router-signal'\n\n// Navigate to /users?tab=active\nnavigate({ href: '/users', params: { tab: 'active' } })\n\n// Replace current entry and set a hash\nnavigate({ hash: 'details', replace: true })\n```\n\nRead the current URL reactively (no extra hooks or signals):\n\n```ts\nimport { effect } from '@preact/signals'\nimport { url } from '@01edu/router-signal'\n\n// All properties are signals, so it's reactive.\neffect(() => {\n  if (url.path === '/users') {\n    // ...\n  }\n\n  console.log(url.hash) // e.g. \"#details\"\n  console.log(url.params.page) // \"2\" | null\n})\n\n// Order-insensitive equality by origin, path, and query values\nurl.equals(new URL('/users?page=2', location.origin)) // true or false\n```\n\n## API\n\n### `<A>`\n\nProps:\n\n- `href?: string` — target path or URL\n- `hash?: string` — fragment without leading `#`\n- `params?: Record<string, string | number | boolean | null | undefined>` —\n  query updates\n- `replace?: boolean` — use `history.replaceState` instead of `pushState`\n- All standard Preact anchor attributes (`class`, `target`, `rel`, …)\n\nSemantics for `params` values:\n\n- `true` → include key with empty value (`?key`)\n- `false` or `null`/`undefined` → remove key\n- `string | number | boolean` → set as value (`?key=...`)\n\nExamples:\n\n```tsx\nimport { A, replaceParams } from '@01edu/router-signal';\n\n// Merge params into the URL:\n<A href=\"/users\" params={{ page: 3 }}>Users page 3</A>\n\n// Replace current params entirely:\n<A href=\"/users\" params={replaceParams({ page: 1, filter: true })}>\n  Users page 1 (filter on)\n</A>\n\n// Clear all params:\n<A href=\"/users\" params={replaceParams()}>\n  Users (no query)\n</A>\n\n// External and /api are normal links:\n<A href=\"https://example.com\">External</A>\n<A href=\"/api/report.csv\" download>\n  Download CSV\n</A>\n```\n\nBehavioral details:\n\n- If `params` is omitted and you only change the hash (or keep the same path),\n  current query parameters are preserved.\n- Trailing slashes are removed from `href` automatically.\n\n### `navigate(props)`\n\nProgrammatic client-side navigation.\n\n```ts\ntype ParamValue = string | number | boolean | null | undefined;\n\nnavigate({\n  href?: string,\n  hash?: string,\n  params?: Record<string, ParamValue>,\n  replace?: boolean,\n}): void\n```\n\nExamples:\n\n```ts\nimport { navigate, replaceParams } from '@01edu/router-signal'\n\n// Go to /users?tab=active\nnavigate({ href: '/users', params: { tab: 'active' } })\n\n// Toggle a boolean flag (?filter):\nnavigate({ params: { filter: true } })\nnavigate({ params: { filter: false } })\n\n// Replace current entry instead of pushing:\nnavigate({ hash: 'details', replace: true })\n\n// Replace all params with just ?page=2&filter:\nnavigate({ params: replaceParams({ page: 2, filter: true }) })\n```\n\nNotes:\n\n- If `params` is omitted and only `hash` changes, existing query params are\n  preserved.\n- URLs are normalized to drop trailing `/`.\n\n### `replaceParams(newParams?)`\n\nReplace the current query parameters wholesale. This returns an object suitable\nfor the `params` field in `navigate` or `<A>`.\n\n```ts\nreplaceParams(newParams?: Record<string, string | number | boolean | null | undefined>): Record<string, ParamValue>\n```\n\n- Starts by “deleting” all existing query keys.\n- Then applies `newParams` using the same semantics as `params`:\n  - `true` → `?key`\n  - `false | null | undefined` → remove key\n  - other primitive → `?key=value`\n\n> Internally this use a `computed` signals to only update if new params are\n> added, not if there value changes\n\nExamples:\n\n```ts\nimport { navigate, replaceParams } from '@01edu/router-signal'\n\n// Replace all params with page=2 and a boolean filter:\nnavigate({ params: replaceParams({ page: 2, filter: true }) })\n\n// Clear all params:\nnavigate({ params: replaceParams() })\n```\n\nThis eliminates accidental accumulation of stale keys when navigating across\nviews, important for \"pages changes\".\n\n### `url`\n\nA reactive view of the current URL. Reads are backed by signals internally, but\nyou don’t create or pass around any new signals or hooks yourself.\n\n```ts\ntype Url = {\n  path: string // pathname without trailing slash, e.g. \"/users\"\n  hash: string // includes the leading \"#\", or \"\" if none\n  params: Record<string, string | null> // enumerable, values are string|null\n  equals: (u: URL) => boolean // same-origin, same path, same query values (order-insensitive)\n}\n```\n\nExamples:\n\n```ts\nimport { url } from '@01edu/router-signal'\n\nfunction isUsers() {\n  return url.path === '/users'\n}\n\nconst page = url.params.page // \"2\" | null\nconst hasFilter = url.params.filter !== null\n\nurl.equals(new URL('/users?page=2', location.origin)) // true/false\n```\n\nNotes:\n\n- `params` is a proxy exposing string-or-null values. It’s enumerable, so\n  `Object.keys(url.params)` and `{ ...url.params }` work as expected.\n- Query parameter ordering is ignored in `equals`.\n\n## Patterns (without new state)\n\nBecause the URL is the state, you rarely need custom signals or hooks. A few\ncommon patterns:\n\nActive link:\n\n```tsx\nimport { A, url } from '@01edu/router-signal'\n\n<A\n  href='/users'\n  class={url.path === '/users' ? 'active' : undefined}\n  aria-current={url.path === '/users' ? 'page' : undefined}\n>\n  Users\n</A>\n```\n\nFilter toggle:\n\n```tsx\nimport { A, url } from '@01edu/router-signal'\n\nconst isOn = url.params.filter !== null\n\n<A params={{ filter: isOn ? false : true }}>\n  {isOn ? 'Disable' : 'Enable'} filter\n</A>\n```\n\nPagination:\n\n```tsx\nimport { A, url } from '@01edu/router-signal';\n\nconst current = Number(url.params.page ?? '1');\nconst next = current + 1;\nconst prev = Math.max(1, current - 1);\n\n<A params={{ page: prev }}>Prev</A>\n<A params={{ page: next }}>Next</A>\n```\n\nReplace vs merge:\n\n```tsx\nimport { A, replaceParams } from '@01edu/router-signal';\n\n// Merge: keep existing keys unless you override them\n<A params={{ sort: 'name' }}>Sort by name</A>\n\n// Replace: start fresh (prevents stale filters carrying over)\n<A params={replaceParams({ sort: 'name' })}>Sort by name</A>\n```\n\n## Behavior and constraints\n\n- Same-origin only: SPA navigation is performed for your origin and non-`/api/*`\n  paths. External URLs and `/api/*` fall back to normal anchors.\n- Trailing slashes are removed from paths to keep equality checks stable.\n- Hash includes the leading `#` (e.g. `#details`), or `\"\"` if none.\n- Keyboard and modified-clicks behave like native anchors.\n- Browser environment: this is designed for client-side apps (uses\n  `window.history` and `location`).\n\n## Philosophy\n\nThis library is intentionally small. The browser already gives you a robust\nstate container (the URL) and a navigation API (`history`).\n\nWe aim to provide a thin layer between preact signals and the browser URL, this\nensure your app are simpler to reason about, integrate better with the platform\nand don’t invent new state for things the URL already models perfectly.\n\nWe volontarly have \"bring your own\" approach to things like validation,\ntypesafety, params assertion, and in most case found it wasn't even nescessary.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}