@pyreon/url-state 0.11.5 → 0.11.6

package/README.md

@@ -11,20 +11,20 @@ bun add @pyreon/url-state
 ## Usage
 
 ```ts
-import { useUrlState } from "@pyreon/url-state"
+import { useUrlState } from '@pyreon/url-state'
 
 // Single param — auto type coercion from default value
-const page = useUrlState("page", 1)       // reads ?page=X, defaults to 1
-page()                                      // 1
-page.set(2)                                 // URL becomes ?page=2
-page.reset()                                // back to default
-page.remove()                               // removes ?page entirely
+const page = useUrlState('page', 1) // reads ?page=X, defaults to 1
+page() // 1
+page.set(2) // URL becomes ?page=2
+page.reset() // back to default
+page.remove() // removes ?page entirely
 
 // Schema mode — multiple params
-const { page, sort, q } = useUrlState({ page: 1, sort: "name", q: "" })
+const { page, sort, q } = useUrlState({ page: 1, sort: 'name', q: '' })
 
 // Debounced (for search inputs)
-const q = useUrlState("q", "", { debounce: 300 })
+const q = useUrlState('q', '', { debounce: 300 })
 ```
 
 ## Features

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/url.ts","../src/serializers.ts","../src/use-url-state.ts"],"sourcesContent":["const _isBrowser = typeof window !== \"undefined\"\n\n/** Read a search param from the current URL. Returns `null` if not present. */\nexport function getParam(key: string): string | null {\n  if (!_isBrowser) return null\n  return new URLSearchParams(window.location.search).get(key)\n}\n\n/**\n * Read all values for a repeated param (e.g. `?tags=a&tags=b`).\n * Returns an empty array if the param is not present.\n */\nexport function getParamAll(key: string): string[] {\n  if (!_isBrowser) return []\n  return new URLSearchParams(window.location.search).getAll(key)\n}\n\n/**\n * Minimal router-like interface — only the `replace` method is needed.\n * This avoids a hard dependency on `@pyreon/router`.\n */\nexport interface UrlRouter {\n  replace(path: string): void | Promise<void>\n}\n\n/** Module-level router reference. Set via `setUrlRouter()`. */\nlet _router: UrlRouter | null = null\n\n/** Register a router to use for URL updates instead of the raw history API. */\nexport function setUrlRouter(router: UrlRouter | null): void {\n  _router = router\n}\n\n/** @internal */\nexport function getUrlRouter(): UrlRouter | null {\n  return _router\n}\n\n/** Write one or more search params to the URL without a full navigation. */\nexport function setParams(entries: Record<string, string | null>, replace: boolean): void {\n  if (!_isBrowser) return\n\n  const params = new URLSearchParams(window.location.search)\n\n  for (const [key, value] of Object.entries(entries)) {\n    if (value === null) {\n      params.delete(key)\n    } else {\n      params.set(key, value)\n    }\n  }\n\n  const search = params.toString()\n  const url = search ? `${window.location.pathname}?${search}` : window.location.pathname\n\n  if (_router) {\n    _router.replace(url)\n    return\n  }\n\n  if (replace) {\n    history.replaceState(null, \"\", url)\n  } else {\n    history.pushState(null, \"\", url)\n  }\n}\n\n/**\n * Write an array param using repeated keys (e.g. `?tags=a&tags=b`).\n * When `values` is null the param is deleted.\n */\nexport function setParamRepeated(key: string, values: string[] | null, replace: boolean): void {\n  if (!_isBrowser) return\n\n  const params = new URLSearchParams(window.location.search)\n  params.delete(key)\n\n  if (values !== null) {\n    for (const v of values) {\n      params.append(key, v)\n    }\n  }\n\n  const search = params.toString()\n  const url = search ? `${window.location.pathname}?${search}` : window.location.pathname\n\n  if (_router) {\n    _router.replace(url)\n    return\n  }\n\n  if (replace) {\n    history.replaceState(null, \"\", url)\n  } else {\n    history.pushState(null, \"\", url)\n  }\n}\n\nexport { _isBrowser }\n","import type { ArrayFormat, Serializer } from \"./types\"\n\n/** Infer a serializer pair from the type of the default value. */\nexport function inferSerializer<T>(\n  defaultValue: T,\n  arrayFormat: ArrayFormat = \"comma\",\n): Serializer<T> {\n  if (Array.isArray(defaultValue)) {\n    if (arrayFormat === \"repeat\") {\n      return {\n        serialize: (v: T) => (v as string[]).join(\"\\0REPEAT\\0\"),\n        deserialize: (raw: string) => (raw === \"\" ? [] : raw.split(\"\\0REPEAT\\0\")) as T,\n      }\n    }\n    // comma (default)\n    return {\n      serialize: (v: T) => (v as string[]).join(\",\"),\n      deserialize: (raw: string) => (raw === \"\" ? [] : raw.split(\",\")) as T,\n    }\n  }\n\n  switch (typeof defaultValue) {\n    case \"number\":\n      return {\n        serialize: (v: T) => String(v),\n        deserialize: (raw: string) => {\n          const n = Number(raw)\n          return (Number.isNaN(n) ? defaultValue : n) as T\n        },\n      }\n    case \"boolean\":\n      return {\n        serialize: (v: T) => String(v),\n        deserialize: (raw: string) => (raw === \"true\") as T,\n      }\n    case \"string\":\n      return {\n        serialize: (v: T) => v as string,\n        deserialize: (raw: string) => raw as T,\n      }\n    case \"object\":\n      return {\n        serialize: (v: T) => JSON.stringify(v),\n        deserialize: (raw: string) => JSON.parse(raw) as T,\n      }\n    default:\n      return {\n        serialize: (v: T) => String(v),\n        deserialize: (raw: string) => raw as T,\n      }\n  }\n}\n","import { effect, onCleanup, signal } from \"@pyreon/reactivity\"\nimport { inferSerializer } from \"./serializers\"\nimport type { Serializer, UrlStateOptions, UrlStateSignal } from \"./types\"\nimport { _isBrowser, getParam, getParamAll, setParamRepeated, setParams } from \"./url\"\n\n// ─── Single-param overload ──────────────────────────────────────────────────\n\n/**\n * Bind a single URL search parameter to a reactive signal.\n *\n * @example\n * ```ts\n * const page = useUrlState(\"page\", 1)\n * page()        // read reactively (number)\n * page.set(2)   // updates signal + URL\n * page.reset()  // back to 1\n * page.remove() // removes ?page entirely\n * ```\n */\nexport function useUrlState<T>(\n  key: string,\n  defaultValue: T,\n  options?: UrlStateOptions<T>,\n): UrlStateSignal<T>\n\n// ─── Schema overload ────────────────────────────────────────────────────────\n\n/**\n * Bind multiple URL search parameters at once via a schema object.\n *\n * @example\n * ```ts\n * const { page, q } = useUrlState({ page: 1, q: \"\" })\n * page()       // number\n * q.set(\"hi\") // updates ?q=hi\n * ```\n */\nexport function useUrlState<T extends Record<string, unknown>>(\n  schema: T,\n  options?: UrlStateOptions,\n): { [K in keyof T]: UrlStateSignal<T[K]> }\n\n// ─── Implementation ─────────────────────────────────────────────────────────\n\nexport function useUrlState<T>(\n  keyOrSchema: string | Record<string, unknown>,\n  defaultOrOptions?: T | UrlStateOptions,\n  maybeOptions?: UrlStateOptions<T>,\n): UrlStateSignal<T> | Record<string, UrlStateSignal<unknown>> {\n  // Schema mode\n  if (typeof keyOrSchema === \"object\") {\n    const schema = keyOrSchema as Record<string, unknown>\n    const opts = defaultOrOptions as UrlStateOptions | undefined\n    const result: Record<string, UrlStateSignal<unknown>> = {}\n\n    for (const key of Object.keys(schema)) {\n      result[key] = createUrlSignal(key, schema[key], opts)\n    }\n\n    return result\n  }\n\n  // Single-param mode\n  const key = keyOrSchema\n  const defaultValue = defaultOrOptions as T\n  const options = maybeOptions\n  return createUrlSignal(key, defaultValue, options)\n}\n\n// ─── Core factory ───────────────────────────────────────────────────────────\n\nfunction createUrlSignal<T>(\n  key: string,\n  defaultValue: T,\n  options?: UrlStateOptions<T>,\n): UrlStateSignal<T> {\n  const replace = options?.replace !== false\n  const debounceMs = options?.debounce ?? 0\n  const arrayFormat = options?.arrayFormat ?? \"comma\"\n  const isArray = Array.isArray(defaultValue)\n  const isRepeat = isArray && arrayFormat === \"repeat\"\n\n  const { serialize, deserialize }: Serializer<T> =\n    options?.serialize && options?.deserialize\n      ? { serialize: options.serialize, deserialize: options.deserialize }\n      : inferSerializer(defaultValue, arrayFormat)\n\n  // Read initial value from URL (falls back to default when missing or in SSR)\n  let initial: T\n  if (isRepeat) {\n    const values = getParamAll(key)\n    initial = values.length > 0 ? (values as T) : defaultValue\n  } else {\n    const raw = getParam(key)\n    initial = raw !== null ? deserialize(raw) : defaultValue\n  }\n\n  const state = signal<T>(initial)\n\n  // Pending debounce timer\n  let timer: ReturnType<typeof setTimeout> | undefined\n\n  // Write URL when signal changes\n  const writeUrl = (value: T) => {\n    if (isRepeat) {\n      const arr = value as string[]\n      const defaultArr = defaultValue as string[]\n      // Remove param when value equals default to keep URLs clean\n      if (arr.length === defaultArr.length && arr.every((v, i) => v === defaultArr[i])) {\n        setParamRepeated(key, null, replace)\n      } else {\n        setParamRepeated(key, arr, replace)\n      }\n      return\n    }\n\n    const serialized = serialize(value)\n    const defaultSerialized = serialize(defaultValue)\n\n    // Remove param when value equals default to keep URLs clean\n    if (serialized === defaultSerialized) {\n      setParams({ [key]: null }, replace)\n    } else {\n      setParams({ [key]: serialized }, replace)\n    }\n  }\n\n  /** Force-remove the param from URL regardless of value. */\n  const removeFromUrl = () => {\n    if (isRepeat) {\n      setParamRepeated(key, null, replace)\n    } else {\n      setParams({ [key]: null }, replace)\n    }\n  }\n\n  const scheduleWrite = (value: T) => {\n    if (debounceMs <= 0) {\n      writeUrl(value)\n      return\n    }\n    if (timer !== undefined) clearTimeout(timer)\n    timer = setTimeout(() => {\n      timer = undefined\n      writeUrl(value)\n    }, debounceMs)\n  }\n\n  // Listen for popstate (back/forward navigation)\n  if (_isBrowser) {\n    const onPopState = () => {\n      let value: T\n      if (isRepeat) {\n        const values = getParamAll(key)\n        value = values.length > 0 ? (values as T) : defaultValue\n      } else {\n        const current = getParam(key)\n        value = current !== null ? deserialize(current) : defaultValue\n      }\n      state.set(value)\n      options?.onChange?.(value)\n    }\n\n    effect(() => {\n      window.addEventListener(\"popstate\", onPopState)\n      onCleanup(() => {\n        window.removeEventListener(\"popstate\", onPopState)\n        if (timer !== undefined) clearTimeout(timer)\n      })\n    })\n  }\n\n  // Build the signal-like accessor\n  const accessor = (() => state()) as UrlStateSignal<T>\n\n  accessor.set = (value: T) => {\n    state.set(value)\n    scheduleWrite(value)\n  }\n\n  accessor.reset = () => {\n    state.set(defaultValue)\n    scheduleWrite(defaultValue)\n  }\n\n  accessor.remove = () => {\n    state.set(defaultValue)\n    if (timer !== undefined) clearTimeout(timer)\n    removeFromUrl()\n  }\n\n  return accessor\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/url.ts","../src/serializers.ts","../src/use-url-state.ts"],"sourcesContent":["const _isBrowser = typeof window !== 'undefined'\n\n/** Read a search param from the current URL. Returns `null` if not present. */\nexport function getParam(key: string): string | null {\n  if (!_isBrowser) return null\n  return new URLSearchParams(window.location.search).get(key)\n}\n\n/**\n * Read all values for a repeated param (e.g. `?tags=a&tags=b`).\n * Returns an empty array if the param is not present.\n */\nexport function getParamAll(key: string): string[] {\n  if (!_isBrowser) return []\n  return new URLSearchParams(window.location.search).getAll(key)\n}\n\n/**\n * Minimal router-like interface — only the `replace` method is needed.\n * This avoids a hard dependency on `@pyreon/router`.\n */\nexport interface UrlRouter {\n  replace(path: string): void | Promise<void>\n}\n\n/** Module-level router reference. Set via `setUrlRouter()`. */\nlet _router: UrlRouter | null = null\n\n/** Register a router to use for URL updates instead of the raw history API. */\nexport function setUrlRouter(router: UrlRouter | null): void {\n  _router = router\n}\n\n/** @internal */\nexport function getUrlRouter(): UrlRouter | null {\n  return _router\n}\n\n/** Write one or more search params to the URL without a full navigation. */\nexport function setParams(entries: Record<string, string | null>, replace: boolean): void {\n  if (!_isBrowser) return\n\n  const params = new URLSearchParams(window.location.search)\n\n  for (const [key, value] of Object.entries(entries)) {\n    if (value === null) {\n      params.delete(key)\n    } else {\n      params.set(key, value)\n    }\n  }\n\n  const search = params.toString()\n  const url = search ? `${window.location.pathname}?${search}` : window.location.pathname\n\n  if (_router) {\n    _router.replace(url)\n    return\n  }\n\n  if (replace) {\n    history.replaceState(null, '', url)\n  } else {\n    history.pushState(null, '', url)\n  }\n}\n\n/**\n * Write an array param using repeated keys (e.g. `?tags=a&tags=b`).\n * When `values` is null the param is deleted.\n */\nexport function setParamRepeated(key: string, values: string[] | null, replace: boolean): void {\n  if (!_isBrowser) return\n\n  const params = new URLSearchParams(window.location.search)\n  params.delete(key)\n\n  if (values !== null) {\n    for (const v of values) {\n      params.append(key, v)\n    }\n  }\n\n  const search = params.toString()\n  const url = search ? `${window.location.pathname}?${search}` : window.location.pathname\n\n  if (_router) {\n    _router.replace(url)\n    return\n  }\n\n  if (replace) {\n    history.replaceState(null, '', url)\n  } else {\n    history.pushState(null, '', url)\n  }\n}\n\nexport { _isBrowser }\n","import type { ArrayFormat, Serializer } from './types'\n\n/** Infer a serializer pair from the type of the default value. */\nexport function inferSerializer<T>(\n  defaultValue: T,\n  arrayFormat: ArrayFormat = 'comma',\n): Serializer<T> {\n  if (Array.isArray(defaultValue)) {\n    if (arrayFormat === 'repeat') {\n      return {\n        serialize: (v: T) => (v as string[]).join('\\0REPEAT\\0'),\n        deserialize: (raw: string) => (raw === '' ? [] : raw.split('\\0REPEAT\\0')) as T,\n      }\n    }\n    // comma (default)\n    return {\n      serialize: (v: T) => (v as string[]).join(','),\n      deserialize: (raw: string) => (raw === '' ? [] : raw.split(',')) as T,\n    }\n  }\n\n  switch (typeof defaultValue) {\n    case 'number':\n      return {\n        serialize: (v: T) => String(v),\n        deserialize: (raw: string) => {\n          const n = Number(raw)\n          return (Number.isNaN(n) ? defaultValue : n) as T\n        },\n      }\n    case 'boolean':\n      return {\n        serialize: (v: T) => String(v),\n        deserialize: (raw: string) => (raw === 'true') as T,\n      }\n    case 'string':\n      return {\n        serialize: (v: T) => v as string,\n        deserialize: (raw: string) => raw as T,\n      }\n    case 'object':\n      return {\n        serialize: (v: T) => JSON.stringify(v),\n        deserialize: (raw: string) => JSON.parse(raw) as T,\n      }\n    default:\n      return {\n        serialize: (v: T) => String(v),\n        deserialize: (raw: string) => raw as T,\n      }\n  }\n}\n","import { effect, onCleanup, signal } from '@pyreon/reactivity'\nimport { inferSerializer } from './serializers'\nimport type { Serializer, UrlStateOptions, UrlStateSignal } from './types'\nimport { _isBrowser, getParam, getParamAll, setParamRepeated, setParams } from './url'\n\n// ─── Single-param overload ──────────────────────────────────────────────────\n\n/**\n * Bind a single URL search parameter to a reactive signal.\n *\n * @example\n * ```ts\n * const page = useUrlState(\"page\", 1)\n * page()        // read reactively (number)\n * page.set(2)   // updates signal + URL\n * page.reset()  // back to 1\n * page.remove() // removes ?page entirely\n * ```\n */\nexport function useUrlState<T>(\n  key: string,\n  defaultValue: T,\n  options?: UrlStateOptions<T>,\n): UrlStateSignal<T>\n\n// ─── Schema overload ────────────────────────────────────────────────────────\n\n/**\n * Bind multiple URL search parameters at once via a schema object.\n *\n * @example\n * ```ts\n * const { page, q } = useUrlState({ page: 1, q: \"\" })\n * page()       // number\n * q.set(\"hi\") // updates ?q=hi\n * ```\n */\nexport function useUrlState<T extends Record<string, unknown>>(\n  schema: T,\n  options?: UrlStateOptions,\n): { [K in keyof T]: UrlStateSignal<T[K]> }\n\n// ─── Implementation ─────────────────────────────────────────────────────────\n\nexport function useUrlState<T>(\n  keyOrSchema: string | Record<string, unknown>,\n  defaultOrOptions?: T | UrlStateOptions,\n  maybeOptions?: UrlStateOptions<T>,\n): UrlStateSignal<T> | Record<string, UrlStateSignal<unknown>> {\n  // Schema mode\n  if (typeof keyOrSchema === 'object') {\n    const schema = keyOrSchema as Record<string, unknown>\n    const opts = defaultOrOptions as UrlStateOptions | undefined\n    const result: Record<string, UrlStateSignal<unknown>> = {}\n\n    for (const key of Object.keys(schema)) {\n      result[key] = createUrlSignal(key, schema[key], opts)\n    }\n\n    return result\n  }\n\n  // Single-param mode\n  const key = keyOrSchema\n  const defaultValue = defaultOrOptions as T\n  const options = maybeOptions\n  return createUrlSignal(key, defaultValue, options)\n}\n\n// ─── Core factory ───────────────────────────────────────────────────────────\n\nfunction createUrlSignal<T>(\n  key: string,\n  defaultValue: T,\n  options?: UrlStateOptions<T>,\n): UrlStateSignal<T> {\n  const replace = options?.replace !== false\n  const debounceMs = options?.debounce ?? 0\n  const arrayFormat = options?.arrayFormat ?? 'comma'\n  const isArray = Array.isArray(defaultValue)\n  const isRepeat = isArray && arrayFormat === 'repeat'\n\n  const { serialize, deserialize }: Serializer<T> =\n    options?.serialize && options?.deserialize\n      ? { serialize: options.serialize, deserialize: options.deserialize }\n      : inferSerializer(defaultValue, arrayFormat)\n\n  // Read initial value from URL (falls back to default when missing or in SSR)\n  let initial: T\n  if (isRepeat) {\n    const values = getParamAll(key)\n    initial = values.length > 0 ? (values as T) : defaultValue\n  } else {\n    const raw = getParam(key)\n    initial = raw !== null ? deserialize(raw) : defaultValue\n  }\n\n  const state = signal<T>(initial)\n\n  // Pending debounce timer\n  let timer: ReturnType<typeof setTimeout> | undefined\n\n  // Write URL when signal changes\n  const writeUrl = (value: T) => {\n    if (isRepeat) {\n      const arr = value as string[]\n      const defaultArr = defaultValue as string[]\n      // Remove param when value equals default to keep URLs clean\n      if (arr.length === defaultArr.length && arr.every((v, i) => v === defaultArr[i])) {\n        setParamRepeated(key, null, replace)\n      } else {\n        setParamRepeated(key, arr, replace)\n      }\n      return\n    }\n\n    const serialized = serialize(value)\n    const defaultSerialized = serialize(defaultValue)\n\n    // Remove param when value equals default to keep URLs clean\n    if (serialized === defaultSerialized) {\n      setParams({ [key]: null }, replace)\n    } else {\n      setParams({ [key]: serialized }, replace)\n    }\n  }\n\n  /** Force-remove the param from URL regardless of value. */\n  const removeFromUrl = () => {\n    if (isRepeat) {\n      setParamRepeated(key, null, replace)\n    } else {\n      setParams({ [key]: null }, replace)\n    }\n  }\n\n  const scheduleWrite = (value: T) => {\n    if (debounceMs <= 0) {\n      writeUrl(value)\n      return\n    }\n    if (timer !== undefined) clearTimeout(timer)\n    timer = setTimeout(() => {\n      timer = undefined\n      writeUrl(value)\n    }, debounceMs)\n  }\n\n  // Listen for popstate (back/forward navigation)\n  if (_isBrowser) {\n    const onPopState = () => {\n      let value: T\n      if (isRepeat) {\n        const values = getParamAll(key)\n        value = values.length > 0 ? (values as T) : defaultValue\n      } else {\n        const current = getParam(key)\n        value = current !== null ? deserialize(current) : defaultValue\n      }\n      state.set(value)\n      options?.onChange?.(value)\n    }\n\n    effect(() => {\n      window.addEventListener('popstate', onPopState)\n      onCleanup(() => {\n        window.removeEventListener('popstate', onPopState)\n        if (timer !== undefined) clearTimeout(timer)\n      })\n    })\n  }\n\n  // Build the signal-like accessor\n  const accessor = (() => state()) as UrlStateSignal<T>\n\n  accessor.set = (value: T) => {\n    state.set(value)\n    scheduleWrite(value)\n  }\n\n  accessor.reset = () => {\n    state.set(defaultValue)\n    scheduleWrite(defaultValue)\n  }\n\n  accessor.remove = () => {\n    state.set(defaultValue)\n    if (timer !== undefined) clearTimeout(timer)\n    removeFromUrl()\n  }\n\n  return accessor\n}\n"],"mappings":"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"}

package/lib/types/index.d.ts

@@ -22,7 +22,7 @@ interface UrlStateSignal<T> {
   remove(): void;
 }
 /** Encoding strategy for array values in the URL. */
-type ArrayFormat = /** Comma-separated: `?tags=a,b` */"comma" /** Repeated keys: `?tags=a&tags=b` */ | "repeat";
+type ArrayFormat = /** Comma-separated: `?tags=a,b` */'comma' /** Repeated keys: `?tags=a&tags=b` */ | 'repeat';
 /** Options for `useUrlState`. */
 interface UrlStateOptions<T = unknown> {
   /** Custom serializer — converts value to a URL-safe string. */

package/package.json

@@ -1,20 +1,17 @@
 {
   "name": "@pyreon/url-state",
-  "version": "0.11.5",
+  "version": "0.11.6",
   "description": "Reactive URL search-param state for Pyreon — signal-backed, type-coerced, SSR-safe",
+  "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/url-state#readme",
+  "bugs": {
+    "url": "https://github.com/pyreon/pyreon/issues"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/pyreon/pyreon.git",
     "directory": "packages/fundamentals/url-state"
   },
-  "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/url-state#readme",
-  "bugs": {
-    "url": "https://github.com/pyreon/pyreon/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "files": [
     "lib",
     "src",
@@ -22,6 +19,7 @@
     "LICENSE"
   ],
   "type": "module",
+  "sideEffects": false,
   "main": "./lib/index.js",
   "module": "./lib/index.js",
   "types": "./lib/types/index.d.ts",
@@ -32,20 +30,22 @@
       "types": "./lib/types/index.d.ts"
     }
   },
-  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "vl_rolldown_build",
     "dev": "vl_rolldown_build-watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "lint": "biome check ."
-  },
-  "peerDependencies": {
-    "@pyreon/reactivity": "^0.11.5"
+    "lint": "oxlint ."
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.8.3",
-    "@pyreon/reactivity": "^0.11.5",
+    "@pyreon/reactivity": "^0.11.6",
     "@vitus-labs/tools-lint": "^1.11.0"
+  },
+  "peerDependencies": {
+    "@pyreon/reactivity": "^0.11.6"
   }
 }

package/src/index.ts

@@ -29,10 +29,10 @@
  * ```
  */
 
-export { setUrlRouter } from "./url"
-export { useUrlState } from "./use-url-state"
+export { setUrlRouter } from './url'
+export { useUrlState } from './use-url-state'
 
 // ─── Types ───────────────────────────────────────────────────────────────────
 
-export type { ArrayFormat, Serializer, UrlStateOptions, UrlStateSignal } from "./types"
-export type { UrlRouter } from "./url"
+export type { ArrayFormat, Serializer, UrlStateOptions, UrlStateSignal } from './types'
+export type { UrlRouter } from './url'

package/src/serializers.ts

@@ -1,26 +1,26 @@
-import type { ArrayFormat, Serializer } from "./types"
+import type { ArrayFormat, Serializer } from './types'
 
 /** Infer a serializer pair from the type of the default value. */
 export function inferSerializer<T>(
   defaultValue: T,
-  arrayFormat: ArrayFormat = "comma",
+  arrayFormat: ArrayFormat = 'comma',
 ): Serializer<T> {
   if (Array.isArray(defaultValue)) {
-    if (arrayFormat === "repeat") {
+    if (arrayFormat === 'repeat') {
       return {
-        serialize: (v: T) => (v as string[]).join("\0REPEAT\0"),
-        deserialize: (raw: string) => (raw === "" ? [] : raw.split("\0REPEAT\0")) as T,
+        serialize: (v: T) => (v as string[]).join('\0REPEAT\0'),
+        deserialize: (raw: string) => (raw === '' ? [] : raw.split('\0REPEAT\0')) as T,
       }
     }
     // comma (default)
     return {
-      serialize: (v: T) => (v as string[]).join(","),
-      deserialize: (raw: string) => (raw === "" ? [] : raw.split(",")) as T,
+      serialize: (v: T) => (v as string[]).join(','),
+      deserialize: (raw: string) => (raw === '' ? [] : raw.split(',')) as T,
     }
   }
 
   switch (typeof defaultValue) {
-    case "number":
+    case 'number':
       return {
         serialize: (v: T) => String(v),
         deserialize: (raw: string) => {
@@ -28,17 +28,17 @@ export function inferSerializer<T>(
           return (Number.isNaN(n) ? defaultValue : n) as T
         },
       }
-    case "boolean":
+    case 'boolean':
       return {
         serialize: (v: T) => String(v),
-        deserialize: (raw: string) => (raw === "true") as T,
+        deserialize: (raw: string) => (raw === 'true') as T,
       }
-    case "string":
+    case 'string':
       return {
         serialize: (v: T) => v as string,
         deserialize: (raw: string) => raw as T,
       }
-    case "object":
+    case 'object':
       return {
         serialize: (v: T) => JSON.stringify(v),
         deserialize: (raw: string) => JSON.parse(raw) as T,

package/src/tests/url-state.test.ts

@@ -1,6 +1,6 @@
-import { effect } from "@pyreon/reactivity"
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
-import { setUrlRouter, useUrlState } from "../index"
+import { effect } from '@pyreon/reactivity'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { setUrlRouter, useUrlState } from '../index'
 
 /**
  * Helper: set window.location.search to a given query string.
@@ -9,179 +9,179 @@ import { setUrlRouter, useUrlState } from "../index"
 function setSearch(search: string) {
   const url = new URL(window.location.href)
   url.search = search
-  history.replaceState(null, "", url.toString())
+  history.replaceState(null, '', url.toString())
 }
 
-describe("useUrlState", () => {
+describe('useUrlState', () => {
   beforeEach(() => {
-    setSearch("")
+    setSearch('')
     setUrlRouter(null)
   })
 
   afterEach(() => {
-    setSearch("")
+    setSearch('')
     setUrlRouter(null)
   })
 
   // ── Single param ────────────────────────────────────────────────────────
 
-  describe("single param mode", () => {
-    it("returns default value when param is not in URL", () => {
-      const page = useUrlState("page", 1)
+  describe('single param mode', () => {
+    it('returns default value when param is not in URL', () => {
+      const page = useUrlState('page', 1)
       expect(page()).toBe(1)
     })
 
-    it("reads initial value from URL", () => {
-      setSearch("?page=5")
-      const page = useUrlState("page", 1)
+    it('reads initial value from URL', () => {
+      setSearch('?page=5')
+      const page = useUrlState('page', 1)
       expect(page()).toBe(5)
     })
 
-    it(".set() updates signal and URL", () => {
-      const page = useUrlState("page", 1)
+    it('.set() updates signal and URL', () => {
+      const page = useUrlState('page', 1)
       page.set(3)
       expect(page()).toBe(3)
-      expect(new URLSearchParams(window.location.search).get("page")).toBe("3")
+      expect(new URLSearchParams(window.location.search).get('page')).toBe('3')
     })
 
-    it(".reset() returns to default and cleans URL", () => {
-      setSearch("?page=5")
-      const page = useUrlState("page", 1)
+    it('.reset() returns to default and cleans URL', () => {
+      setSearch('?page=5')
+      const page = useUrlState('page', 1)
       expect(page()).toBe(5)
 
       page.reset()
       expect(page()).toBe(1)
       // Default value removes the param from URL
-      expect(new URLSearchParams(window.location.search).has("page")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('page')).toBe(false)
     })
 
-    it("removes param from URL when value equals default", () => {
-      const page = useUrlState("page", 1)
+    it('removes param from URL when value equals default', () => {
+      const page = useUrlState('page', 1)
       page.set(5)
-      expect(new URLSearchParams(window.location.search).get("page")).toBe("5")
+      expect(new URLSearchParams(window.location.search).get('page')).toBe('5')
       page.set(1) // back to default
-      expect(new URLSearchParams(window.location.search).has("page")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('page')).toBe(false)
     })
   })
 
   // ── Schema mode ─────────────────────────────────────────────────────────
 
-  describe("schema mode", () => {
-    it("returns object of signals matching schema keys", () => {
-      setSearch("?page=3&q=hello")
-      const state = useUrlState({ page: 1, q: "" })
+  describe('schema mode', () => {
+    it('returns object of signals matching schema keys', () => {
+      setSearch('?page=3&q=hello')
+      const state = useUrlState({ page: 1, q: '' })
 
       expect(state.page()).toBe(3)
-      expect(state.q()).toBe("hello")
+      expect(state.q()).toBe('hello')
     })
 
-    it("defaults when params are missing", () => {
-      const state = useUrlState({ page: 1, q: "" })
+    it('defaults when params are missing', () => {
+      const state = useUrlState({ page: 1, q: '' })
       expect(state.page()).toBe(1)
-      expect(state.q()).toBe("")
+      expect(state.q()).toBe('')
     })
 
-    it("set updates individual params", () => {
-      const state = useUrlState({ page: 1, q: "" })
-      state.q.set("search term")
-      expect(state.q()).toBe("search term")
-      expect(new URLSearchParams(window.location.search).get("q")).toBe("search term")
+    it('set updates individual params', () => {
+      const state = useUrlState({ page: 1, q: '' })
+      state.q.set('search term')
+      expect(state.q()).toBe('search term')
+      expect(new URLSearchParams(window.location.search).get('q')).toBe('search term')
     })
 
-    it("reset individual param", () => {
-      setSearch("?page=5&q=hello")
-      const state = useUrlState({ page: 1, q: "" })
+    it('reset individual param', () => {
+      setSearch('?page=5&q=hello')
+      const state = useUrlState({ page: 1, q: '' })
       state.page.reset()
       expect(state.page()).toBe(1)
       // q should remain
-      expect(new URLSearchParams(window.location.search).get("q")).toBe("hello")
+      expect(new URLSearchParams(window.location.search).get('q')).toBe('hello')
     })
   })
 
   // ── Type coercion ─────────────────────────────────────────────────────
 
-  describe("type coercion", () => {
-    it("coerces number from URL string", () => {
-      setSearch("?count=42")
-      const count = useUrlState("count", 0)
+  describe('type coercion', () => {
+    it('coerces number from URL string', () => {
+      setSearch('?count=42')
+      const count = useUrlState('count', 0)
       expect(count()).toBe(42)
-      expect(typeof count()).toBe("number")
+      expect(typeof count()).toBe('number')
     })
 
-    it("coerces boolean from URL string", () => {
-      setSearch("?active=true")
-      const active = useUrlState("active", false)
+    it('coerces boolean from URL string', () => {
+      setSearch('?active=true')
+      const active = useUrlState('active', false)
       expect(active()).toBe(true)
-      expect(typeof active()).toBe("boolean")
+      expect(typeof active()).toBe('boolean')
     })
 
-    it("coerces boolean false from URL string", () => {
-      setSearch("?active=false")
-      const active = useUrlState("active", true)
+    it('coerces boolean false from URL string', () => {
+      setSearch('?active=false')
+      const active = useUrlState('active', true)
       expect(active()).toBe(false)
     })
 
-    it("handles string identity", () => {
-      setSearch("?name=alice")
-      const name = useUrlState("name", "")
-      expect(name()).toBe("alice")
+    it('handles string identity', () => {
+      setSearch('?name=alice')
+      const name = useUrlState('name', '')
+      expect(name()).toBe('alice')
     })
 
-    it("handles string[] via comma-separated", () => {
-      setSearch("?tags=a,b,c")
-      const tags = useUrlState("tags", [] as string[])
-      expect(tags()).toEqual(["a", "b", "c"])
+    it('handles string[] via comma-separated', () => {
+      setSearch('?tags=a,b,c')
+      const tags = useUrlState('tags', [] as string[])
+      expect(tags()).toEqual(['a', 'b', 'c'])
     })
 
-    it("handles empty string[] from URL", () => {
-      setSearch("?tags=")
-      const tags = useUrlState("tags", [] as string[])
+    it('handles empty string[] from URL', () => {
+      setSearch('?tags=')
+      const tags = useUrlState('tags', [] as string[])
       expect(tags()).toEqual([])
     })
 
-    it("serializes string[] with commas", () => {
-      const tags = useUrlState("tags", [] as string[])
-      tags.set(["x", "y"])
-      expect(new URLSearchParams(window.location.search).get("tags")).toBe("x,y")
+    it('serializes string[] with commas', () => {
+      const tags = useUrlState('tags', [] as string[])
+      tags.set(['x', 'y'])
+      expect(new URLSearchParams(window.location.search).get('tags')).toBe('x,y')
     })
 
-    it("handles object via JSON", () => {
+    it('handles object via JSON', () => {
       setSearch(`?filter=${encodeURIComponent(JSON.stringify({ min: 1, max: 10 }))}`)
-      const filter = useUrlState("filter", { min: 0, max: 100 })
+      const filter = useUrlState('filter', { min: 0, max: 100 })
       expect(filter()).toEqual({ min: 1, max: 10 })
     })
   })
 
   // ── Custom serializer ──────────────────────────────────────────────────
 
-  describe("custom serializer", () => {
-    it("uses custom serialize/deserialize", () => {
-      setSearch("?date=2024-01-15")
-      const date = useUrlState("date", new Date(0), {
+  describe('custom serializer', () => {
+    it('uses custom serialize/deserialize', () => {
+      setSearch('?date=2024-01-15')
+      const date = useUrlState('date', new Date(0), {
         serialize: (d) => d.toISOString().slice(0, 10),
         deserialize: (s) => new Date(s),
       })
       expect(date().getFullYear()).toBe(2024)
 
-      date.set(new Date("2025-06-01"))
-      expect(new URLSearchParams(window.location.search).get("date")).toBe("2025-06-01")
+      date.set(new Date('2025-06-01'))
+      expect(new URLSearchParams(window.location.search).get('date')).toBe('2025-06-01')
     })
   })
 
   // ── replace vs push ────────────────────────────────────────────────────
 
-  describe("history mode", () => {
-    it("uses replaceState by default", () => {
-      const spy = vi.spyOn(history, "replaceState")
-      const page = useUrlState("page", 1)
+  describe('history mode', () => {
+    it('uses replaceState by default', () => {
+      const spy = vi.spyOn(history, 'replaceState')
+      const page = useUrlState('page', 1)
       page.set(2)
       expect(spy).toHaveBeenCalled()
       spy.mockRestore()
     })
 
-    it("uses pushState when replace: false", () => {
-      const spy = vi.spyOn(history, "pushState")
-      const page = useUrlState("page", 1, { replace: false })
+    it('uses pushState when replace: false', () => {
+      const spy = vi.spyOn(history, 'pushState')
+      const page = useUrlState('page', 1, { replace: false })
       page.set(2)
       expect(spy).toHaveBeenCalled()
       spy.mockRestore()
@@ -190,35 +190,35 @@ describe("useUrlState", () => {
 
   // ── Popstate sync ─────────────────────────────────────────────────────
 
-  describe("popstate sync", () => {
-    it("updates signal on popstate event", () => {
-      const page = useUrlState("page", 1)
+  describe('popstate sync', () => {
+    it('updates signal on popstate event', () => {
+      const page = useUrlState('page', 1)
       page.set(5)
       expect(page()).toBe(5)
 
       // Simulate browser back: change URL then fire popstate
-      setSearch("?page=3")
-      window.dispatchEvent(new Event("popstate"))
+      setSearch('?page=3')
+      window.dispatchEvent(new Event('popstate'))
       expect(page()).toBe(3)
     })
 
-    it("resets to default on popstate when param removed", () => {
-      setSearch("?page=5")
-      const page = useUrlState("page", 1)
+    it('resets to default on popstate when param removed', () => {
+      setSearch('?page=5')
+      const page = useUrlState('page', 1)
       expect(page()).toBe(5)
 
-      setSearch("")
-      window.dispatchEvent(new Event("popstate"))
+      setSearch('')
+      window.dispatchEvent(new Event('popstate'))
       expect(page()).toBe(1)
     })
   })
 
   // ── Debounce ──────────────────────────────────────────────────────────
 
-  describe("debounce", () => {
-    it("batches rapid writes", async () => {
+  describe('debounce', () => {
+    it('batches rapid writes', async () => {
       vi.useFakeTimers()
-      const page = useUrlState("page", 1, { debounce: 50 })
+      const page = useUrlState('page', 1, { debounce: 50 })
 
       page.set(2)
       page.set(3)
@@ -227,12 +227,12 @@ describe("useUrlState", () => {
       // Signal updates immediately
       expect(page()).toBe(4)
       // URL not yet updated (debounced)
-      expect(new URLSearchParams(window.location.search).has("page")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('page')).toBe(false)
 
       vi.advanceTimersByTime(50)
 
       // Now URL is updated with final value
-      expect(new URLSearchParams(window.location.search).get("page")).toBe("4")
+      expect(new URLSearchParams(window.location.search).get('page')).toBe('4')
 
       vi.useRealTimers()
     })
@@ -240,9 +240,9 @@ describe("useUrlState", () => {
 
   // ── Reactivity ────────────────────────────────────────────────────────
 
-  describe("reactivity", () => {
-    it("signal is reactive in effects", () => {
-      const page = useUrlState("page", 1)
+  describe('reactivity', () => {
+    it('signal is reactive in effects', () => {
+      const page = useUrlState('page', 1)
       const values: number[] = []
 
       const fx = effect(() => {
@@ -259,32 +259,32 @@ describe("useUrlState", () => {
 
   // ── remove() ──────────────────────────────────────────────────────────
 
-  describe("remove()", () => {
-    it("removes param from URL and resets signal to default", () => {
-      const page = useUrlState("page", 1)
+  describe('remove()', () => {
+    it('removes param from URL and resets signal to default', () => {
+      const page = useUrlState('page', 1)
       page.set(5)
       expect(page()).toBe(5)
-      expect(new URLSearchParams(window.location.search).get("page")).toBe("5")
+      expect(new URLSearchParams(window.location.search).get('page')).toBe('5')
 
       page.remove()
       expect(page()).toBe(1)
-      expect(new URLSearchParams(window.location.search).has("page")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('page')).toBe(false)
     })
 
-    it("removes param even when value equals default", () => {
+    it('removes param even when value equals default', () => {
       // Set URL with a non-default value, then reset, then set again to default
-      setSearch("?page=1")
-      const page = useUrlState("page", 1)
+      setSearch('?page=1')
+      const page = useUrlState('page', 1)
       // Value is 1 (default), but param is in URL
       // remove() should guarantee it's gone
       page.remove()
       expect(page()).toBe(1)
-      expect(new URLSearchParams(window.location.search).has("page")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('page')).toBe(false)
     })
 
-    it("cancels pending debounced write", () => {
+    it('cancels pending debounced write', () => {
       vi.useFakeTimers()
-      const page = useUrlState("page", 1, { debounce: 100 })
+      const page = useUrlState('page', 1, { debounce: 100 })
 
       page.set(5) // starts debounce timer
       page.remove() // should cancel the debounce and remove immediately
@@ -292,112 +292,112 @@ describe("useUrlState", () => {
       // Signal is default
       expect(page()).toBe(1)
       // URL should not have the param (remove is immediate, not debounced)
-      expect(new URLSearchParams(window.location.search).has("page")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('page')).toBe(false)
 
       vi.advanceTimersByTime(100)
       // Still removed — the debounced write should not have fired
-      expect(new URLSearchParams(window.location.search).has("page")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('page')).toBe(false)
 
       vi.useRealTimers()
     })
 
-    it("works with array values (comma format)", () => {
-      const tags = useUrlState("tags", [] as string[])
-      tags.set(["a", "b"])
-      expect(new URLSearchParams(window.location.search).get("tags")).toBe("a,b")
+    it('works with array values (comma format)', () => {
+      const tags = useUrlState('tags', [] as string[])
+      tags.set(['a', 'b'])
+      expect(new URLSearchParams(window.location.search).get('tags')).toBe('a,b')
 
       tags.remove()
       expect(tags()).toEqual([])
-      expect(new URLSearchParams(window.location.search).has("tags")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('tags')).toBe(false)
     })
 
-    it("works with array values (repeat format)", () => {
-      const tags = useUrlState("tags", [] as string[], { arrayFormat: "repeat" })
-      tags.set(["x", "y"])
-      expect(new URLSearchParams(window.location.search).getAll("tags")).toEqual(["x", "y"])
+    it('works with array values (repeat format)', () => {
+      const tags = useUrlState('tags', [] as string[], { arrayFormat: 'repeat' })
+      tags.set(['x', 'y'])
+      expect(new URLSearchParams(window.location.search).getAll('tags')).toEqual(['x', 'y'])
 
       tags.remove()
       expect(tags()).toEqual([])
-      expect(new URLSearchParams(window.location.search).has("tags")).toBe(false)
+      expect(new URLSearchParams(window.location.search).has('tags')).toBe(false)
     })
 
-    it("preserves other params when removing", () => {
-      setSearch("?page=3&q=hello")
-      const page = useUrlState("page", 1)
+    it('preserves other params when removing', () => {
+      setSearch('?page=3&q=hello')
+      const page = useUrlState('page', 1)
       page.remove()
-      expect(new URLSearchParams(window.location.search).has("page")).toBe(false)
-      expect(new URLSearchParams(window.location.search).get("q")).toBe("hello")
+      expect(new URLSearchParams(window.location.search).has('page')).toBe(false)
+      expect(new URLSearchParams(window.location.search).get('q')).toBe('hello')
     })
   })
 
   // ── Array format ──────────────────────────────────────────────────────
 
-  describe("arrayFormat", () => {
-    describe("comma (default)", () => {
-      it("reads comma-separated values from URL", () => {
-        setSearch("?tags=a,b,c")
-        const tags = useUrlState("tags", [] as string[])
-        expect(tags()).toEqual(["a", "b", "c"])
+  describe('arrayFormat', () => {
+    describe('comma (default)', () => {
+      it('reads comma-separated values from URL', () => {
+        setSearch('?tags=a,b,c')
+        const tags = useUrlState('tags', [] as string[])
+        expect(tags()).toEqual(['a', 'b', 'c'])
       })
 
-      it("writes comma-separated values to URL", () => {
-        const tags = useUrlState("tags", [] as string[])
-        tags.set(["x", "y", "z"])
-        expect(new URLSearchParams(window.location.search).get("tags")).toBe("x,y,z")
+      it('writes comma-separated values to URL', () => {
+        const tags = useUrlState('tags', [] as string[])
+        tags.set(['x', 'y', 'z'])
+        expect(new URLSearchParams(window.location.search).get('tags')).toBe('x,y,z')
       })
 
-      it("explicit comma format matches default behavior", () => {
-        setSearch("?tags=a,b")
-        const tags = useUrlState("tags", [] as string[], { arrayFormat: "comma" })
-        expect(tags()).toEqual(["a", "b"])
+      it('explicit comma format matches default behavior', () => {
+        setSearch('?tags=a,b')
+        const tags = useUrlState('tags', [] as string[], { arrayFormat: 'comma' })
+        expect(tags()).toEqual(['a', 'b'])
       })
     })
 
-    describe("repeat", () => {
-      it("reads repeated keys from URL", () => {
-        setSearch("?tags=a&tags=b&tags=c")
-        const tags = useUrlState("tags", [] as string[], { arrayFormat: "repeat" })
-        expect(tags()).toEqual(["a", "b", "c"])
+    describe('repeat', () => {
+      it('reads repeated keys from URL', () => {
+        setSearch('?tags=a&tags=b&tags=c')
+        const tags = useUrlState('tags', [] as string[], { arrayFormat: 'repeat' })
+        expect(tags()).toEqual(['a', 'b', 'c'])
       })
 
-      it("writes repeated keys to URL", () => {
-        const tags = useUrlState("tags", [] as string[], { arrayFormat: "repeat" })
-        tags.set(["x", "y"])
+      it('writes repeated keys to URL', () => {
+        const tags = useUrlState('tags', [] as string[], { arrayFormat: 'repeat' })
+        tags.set(['x', 'y'])
         const params = new URLSearchParams(window.location.search)
-        expect(params.getAll("tags")).toEqual(["x", "y"])
+        expect(params.getAll('tags')).toEqual(['x', 'y'])
       })
 
-      it("falls back to default when no repeated keys in URL", () => {
-        const tags = useUrlState("tags", ["default"] as string[], { arrayFormat: "repeat" })
-        expect(tags()).toEqual(["default"])
+      it('falls back to default when no repeated keys in URL', () => {
+        const tags = useUrlState('tags', ['default'] as string[], { arrayFormat: 'repeat' })
+        expect(tags()).toEqual(['default'])
       })
 
-      it("removes repeated keys when value equals default (empty array)", () => {
-        const tags = useUrlState("tags", [] as string[], { arrayFormat: "repeat" })
-        tags.set(["a", "b"])
-        expect(new URLSearchParams(window.location.search).getAll("tags")).toEqual(["a", "b"])
+      it('removes repeated keys when value equals default (empty array)', () => {
+        const tags = useUrlState('tags', [] as string[], { arrayFormat: 'repeat' })
+        tags.set(['a', 'b'])
+        expect(new URLSearchParams(window.location.search).getAll('tags')).toEqual(['a', 'b'])
 
         tags.set([]) // back to default
-        expect(new URLSearchParams(window.location.search).has("tags")).toBe(false)
+        expect(new URLSearchParams(window.location.search).has('tags')).toBe(false)
       })
 
-      it("popstate syncs repeated keys", () => {
-        const tags = useUrlState("tags", [] as string[], { arrayFormat: "repeat" })
-        tags.set(["a", "b"])
-        expect(tags()).toEqual(["a", "b"])
+      it('popstate syncs repeated keys', () => {
+        const tags = useUrlState('tags', [] as string[], { arrayFormat: 'repeat' })
+        tags.set(['a', 'b'])
+        expect(tags()).toEqual(['a', 'b'])
 
-        setSearch("?tags=x&tags=y&tags=z")
-        window.dispatchEvent(new Event("popstate"))
-        expect(tags()).toEqual(["x", "y", "z"])
+        setSearch('?tags=x&tags=y&tags=z')
+        window.dispatchEvent(new Event('popstate'))
+        expect(tags()).toEqual(['x', 'y', 'z'])
       })
 
-      it("popstate resets to default when repeated keys removed", () => {
-        setSearch("?tags=a&tags=b")
-        const tags = useUrlState("tags", [] as string[], { arrayFormat: "repeat" })
-        expect(tags()).toEqual(["a", "b"])
+      it('popstate resets to default when repeated keys removed', () => {
+        setSearch('?tags=a&tags=b')
+        const tags = useUrlState('tags', [] as string[], { arrayFormat: 'repeat' })
+        expect(tags()).toEqual(['a', 'b'])
 
-        setSearch("")
-        window.dispatchEvent(new Event("popstate"))
+        setSearch('')
+        window.dispatchEvent(new Event('popstate'))
         expect(tags()).toEqual([])
       })
     })
@@ -405,10 +405,10 @@ describe("useUrlState", () => {
 
   // ── onChange callback ────────────────────────────────────────────────
 
-  describe("onChange", () => {
-    it("does not fire on .set() (only external changes)", () => {
+  describe('onChange', () => {
+    it('does not fire on .set() (only external changes)', () => {
       const changes: number[] = []
-      const page = useUrlState("page", 1, {
+      const page = useUrlState('page', 1, {
         onChange: (v) => changes.push(v),
       })
 
@@ -418,32 +418,32 @@ describe("useUrlState", () => {
       expect(changes).toEqual([])
     })
 
-    it("fires on popstate (external change)", () => {
+    it('fires on popstate (external change)', () => {
       const changes: number[] = []
-      useUrlState("page", 1, {
+      useUrlState('page', 1, {
         onChange: (v) => changes.push(v),
       })
 
-      setSearch("?page=7")
-      window.dispatchEvent(new Event("popstate"))
+      setSearch('?page=7')
+      window.dispatchEvent(new Event('popstate'))
       expect(changes).toEqual([7])
     })
 
-    it("fires with default value on popstate when param removed", () => {
-      setSearch("?page=5")
+    it('fires with default value on popstate when param removed', () => {
+      setSearch('?page=5')
       const changes: number[] = []
-      useUrlState("page", 1, {
+      useUrlState('page', 1, {
         onChange: (v) => changes.push(v),
       })
 
-      setSearch("")
-      window.dispatchEvent(new Event("popstate"))
+      setSearch('')
+      window.dispatchEvent(new Event('popstate'))
       expect(changes).toEqual([1])
     })
 
-    it("does not fire on .reset()", () => {
+    it('does not fire on .reset()', () => {
       const changes: number[] = []
-      const page = useUrlState("page", 1, {
+      const page = useUrlState('page', 1, {
         onChange: (v) => changes.push(v),
       })
       page.set(5)
@@ -452,9 +452,9 @@ describe("useUrlState", () => {
       expect(changes).toEqual([])
     })
 
-    it("does not fire on .remove()", () => {
+    it('does not fire on .remove()', () => {
       const changes: number[] = []
-      const page = useUrlState("page", 1, {
+      const page = useUrlState('page', 1, {
         onChange: (v) => changes.push(v),
       })
       page.set(5)
@@ -463,41 +463,41 @@ describe("useUrlState", () => {
       expect(changes).toEqual([])
     })
 
-    it("works with array values and popstate", () => {
+    it('works with array values and popstate', () => {
       const changes: string[][] = []
-      useUrlState("tags", [] as string[], {
-        arrayFormat: "repeat",
+      useUrlState('tags', [] as string[], {
+        arrayFormat: 'repeat',
         onChange: (v) => changes.push(v as string[]),
       })
 
-      setSearch("?tags=a&tags=b")
-      window.dispatchEvent(new Event("popstate"))
-      expect(changes).toEqual([["a", "b"]])
+      setSearch('?tags=a&tags=b')
+      window.dispatchEvent(new Event('popstate'))
+      expect(changes).toEqual([['a', 'b']])
     })
   })
 
   // ── Router integration ────────────────────────────────────────────────
 
-  describe("router integration", () => {
-    it("uses router.replace() when router is set", () => {
+  describe('router integration', () => {
+    it('uses router.replace() when router is set', () => {
       const replaceCalls: string[] = []
       setUrlRouter({
         replace: (path: string) => {
           replaceCalls.push(path)
           // Simulate what a real router does — update the URL
-          history.replaceState(null, "", path)
+          history.replaceState(null, '', path)
         },
       })
 
-      const page = useUrlState("page", 1)
+      const page = useUrlState('page', 1)
       page.set(3)
 
       expect(replaceCalls.length).toBe(1)
-      expect(replaceCalls[0]).toContain("page=3")
+      expect(replaceCalls[0]).toContain('page=3')
     })
 
-    it("does not call history.replaceState directly when router is set", () => {
-      const spy = vi.spyOn(history, "replaceState")
+    it('does not call history.replaceState directly when router is set', () => {
+      const spy = vi.spyOn(history, 'replaceState')
 
       setUrlRouter({
         replace: (_path: string) => {
@@ -505,7 +505,7 @@ describe("useUrlState", () => {
         },
       })
 
-      const page = useUrlState("page", 1)
+      const page = useUrlState('page', 1)
       page.set(3)
 
       // replaceState should NOT have been called by setParams (only by setSearch in beforeEach)
@@ -517,70 +517,70 @@ describe("useUrlState", () => {
       spy.mockRestore()
     })
 
-    it("falls back to history API when no router is set", () => {
-      const spy = vi.spyOn(history, "replaceState")
+    it('falls back to history API when no router is set', () => {
+      const spy = vi.spyOn(history, 'replaceState')
       setUrlRouter(null)
 
-      const page = useUrlState("page", 1)
+      const page = useUrlState('page', 1)
       page.set(2)
 
       expect(spy).toHaveBeenCalled()
       spy.mockRestore()
     })
 
-    it("router.replace() receives correct URL for repeat arrays", () => {
+    it('router.replace() receives correct URL for repeat arrays', () => {
       const replaceCalls: string[] = []
       setUrlRouter({
         replace: (path: string) => {
           replaceCalls.push(path)
-          history.replaceState(null, "", path)
+          history.replaceState(null, '', path)
         },
       })
 
-      const tags = useUrlState("tags", [] as string[], { arrayFormat: "repeat" })
-      tags.set(["a", "b"])
+      const tags = useUrlState('tags', [] as string[], { arrayFormat: 'repeat' })
+      tags.set(['a', 'b'])
 
       expect(replaceCalls.length).toBe(1)
-      expect(replaceCalls[0]).toContain("tags=a&tags=b")
+      expect(replaceCalls[0]).toContain('tags=a&tags=b')
     })
 
-    it("router.replace() used for remove()", () => {
+    it('router.replace() used for remove()', () => {
       const replaceCalls: string[] = []
       setUrlRouter({
         replace: (path: string) => {
           replaceCalls.push(path)
-          history.replaceState(null, "", path)
+          history.replaceState(null, '', path)
         },
       })
 
-      const page = useUrlState("page", 1)
+      const page = useUrlState('page', 1)
       page.set(5)
       replaceCalls.length = 0
 
       page.remove()
       expect(replaceCalls.length).toBe(1)
       // The param should not be in the URL
-      expect(replaceCalls[0]).not.toContain("page=")
+      expect(replaceCalls[0]).not.toContain('page=')
     })
   })
 
-  describe("NaN safety (regression)", () => {
-    it("falls back to default when URL contains non-numeric value for number param", () => {
-      setSearch("?count=abc")
-      const count = useUrlState("count", 0)
+  describe('NaN safety (regression)', () => {
+    it('falls back to default when URL contains non-numeric value for number param', () => {
+      setSearch('?count=abc')
+      const count = useUrlState('count', 0)
       expect(count()).toBe(0) // not NaN
     })
 
-    it("empty string coerces to 0 for number param", () => {
-      setSearch("?count=")
-      const count = useUrlState("count", 42)
+    it('empty string coerces to 0 for number param', () => {
+      setSearch('?count=')
+      const count = useUrlState('count', 42)
       // Number("") is 0, not NaN — this is valid coercion
       expect(count()).toBe(0)
     })
 
-    it("parses valid numbers normally", () => {
-      setSearch("?count=7")
-      const count = useUrlState("count", 0)
+    it('parses valid numbers normally', () => {
+      setSearch('?count=7')
+      const count = useUrlState('count', 0)
       expect(count()).toBe(7)
     })
   })

package/src/types.ts

@@ -13,9 +13,9 @@ export interface UrlStateSignal<T> {
 /** Encoding strategy for array values in the URL. */
 export type ArrayFormat =
   /** Comma-separated: `?tags=a,b` */
-  | "comma"
+  | 'comma'
   /** Repeated keys: `?tags=a&tags=b` */
-  | "repeat"
+  | 'repeat'
 
 /** Options for `useUrlState`. */
 export interface UrlStateOptions<T = unknown> {

package/src/url.ts

@@ -1,4 +1,4 @@
-const _isBrowser = typeof window !== "undefined"
+const _isBrowser = typeof window !== 'undefined'
 
 /** Read a search param from the current URL. Returns `null` if not present. */
 export function getParam(key: string): string | null {
@@ -59,9 +59,9 @@ export function setParams(entries: Record<string, string | null>, replace: boole
   }
 
   if (replace) {
-    history.replaceState(null, "", url)
+    history.replaceState(null, '', url)
   } else {
-    history.pushState(null, "", url)
+    history.pushState(null, '', url)
   }
 }
 
@@ -90,9 +90,9 @@ export function setParamRepeated(key: string, values: string[] | null, replace:
   }
 
   if (replace) {
-    history.replaceState(null, "", url)
+    history.replaceState(null, '', url)
   } else {
-    history.pushState(null, "", url)
+    history.pushState(null, '', url)
   }
 }
 

package/src/use-url-state.ts

@@ -1,7 +1,7 @@
-import { effect, onCleanup, signal } from "@pyreon/reactivity"
-import { inferSerializer } from "./serializers"
-import type { Serializer, UrlStateOptions, UrlStateSignal } from "./types"
-import { _isBrowser, getParam, getParamAll, setParamRepeated, setParams } from "./url"
+import { effect, onCleanup, signal } from '@pyreon/reactivity'
+import { inferSerializer } from './serializers'
+import type { Serializer, UrlStateOptions, UrlStateSignal } from './types'
+import { _isBrowser, getParam, getParamAll, setParamRepeated, setParams } from './url'
 
 // ─── Single-param overload ──────────────────────────────────────────────────
 
@@ -48,7 +48,7 @@ export function useUrlState<T>(
   maybeOptions?: UrlStateOptions<T>,
 ): UrlStateSignal<T> | Record<string, UrlStateSignal<unknown>> {
   // Schema mode
-  if (typeof keyOrSchema === "object") {
+  if (typeof keyOrSchema === 'object') {
     const schema = keyOrSchema as Record<string, unknown>
     const opts = defaultOrOptions as UrlStateOptions | undefined
     const result: Record<string, UrlStateSignal<unknown>> = {}
@@ -76,9 +76,9 @@ function createUrlSignal<T>(
 ): UrlStateSignal<T> {
   const replace = options?.replace !== false
   const debounceMs = options?.debounce ?? 0
-  const arrayFormat = options?.arrayFormat ?? "comma"
+  const arrayFormat = options?.arrayFormat ?? 'comma'
   const isArray = Array.isArray(defaultValue)
-  const isRepeat = isArray && arrayFormat === "repeat"
+  const isRepeat = isArray && arrayFormat === 'repeat'
 
   const { serialize, deserialize }: Serializer<T> =
     options?.serialize && options?.deserialize
@@ -162,9 +162,9 @@ function createUrlSignal<T>(
     }
 
     effect(() => {
-      window.addEventListener("popstate", onPopState)
+      window.addEventListener('popstate', onPopState)
       onCleanup(() => {
-        window.removeEventListener("popstate", onPopState)
+        window.removeEventListener('popstate', onPopState)
         if (timer !== undefined) clearTimeout(timer)
       })
     })