kerfjs 5.0.0-beta.4 → 5.0.0-beta.41

package/dist/remount.js

@@ -1,8 +1,8 @@
-import { mount } from './chunk-SVATPF5R.js';
+import { mount } from './chunk-DLY444MN.js';
 
 
 
-import { effect } from './chunk-U6FK33SG.js';
+import { effect } from './chunk-Y2FOYPBV.js';
 
 
 

package/dist/router.js

@@ -1,6 +1,6 @@
-import { delegate } from './chunk-KPXIOG2C.js';
-import { jsx } from './chunk-ZDCJZCNO.js';
-import { signal, computed } from './chunk-U6FK33SG.js';
+import { delegate } from './chunk-E5R5GNKE.js';
+import { jsx } from './chunk-JRKE6XEK.js';
+import { signal, computed } from './chunk-Y2FOYPBV.js';
 
 
 
@@ -47,7 +47,12 @@ function isWithinBase(path, base) {
   return base.length === 0 || path === base || path.startsWith(base + "/");
 }
 function createRouter(options) {
-  const { routes, mode = "history", base = "", interceptLinks = true } = options;
+  const {
+    routes,
+    mode = "history",
+    base = "",
+    interceptLinks = true
+  } = options;
   const normBase = base === "/" ? "" : base.replace(/\/$/, "");
   let matched = null;
   const readLocation = () => {
@@ -91,7 +96,11 @@ function createRouter(options) {
   };
   const navigate = (path, opts = {}) => {
     const url = mode === "hash" ? "#" + (path.startsWith("/") ? path : "/" + path) : normBase + (path.startsWith("/") ? path : "/" + path);
-    history[opts.replace === true ? "replaceState" : "pushState"](opts.state ?? null, "", url);
+    history[opts.replace === true ? "replaceState" : "pushState"](
+      opts.state ?? null,
+      "",
+      url
+    );
     route.value = resolve(readLocation());
   };
   const match = (pattern) => computed(() => {
@@ -123,8 +132,10 @@ function createRouter(options) {
   if (interceptLinks && typeof document !== "undefined") {
     const onClick = (event, anchor) => {
       const mouseEvent = event;
-      if (mouseEvent.defaultPrevented || mouseEvent.button !== 0 || mouseEvent.metaKey || mouseEvent.ctrlKey || mouseEvent.shiftKey || mouseEvent.altKey) return;
-      if (anchor.hasAttribute("download") || anchor.hasAttribute("data-router-ignore")) return;
+      if (mouseEvent.defaultPrevented || mouseEvent.button !== 0 || mouseEvent.metaKey || mouseEvent.ctrlKey || mouseEvent.shiftKey || mouseEvent.altKey)
+        return;
+      if (anchor.hasAttribute("download") || anchor.hasAttribute("data-router-ignore"))
+        return;
       const target = anchor.getAttribute("target");
       if (target !== null && target !== "" && target !== "_self") return;
       const rel = anchor.getAttribute("rel");
@@ -136,12 +147,15 @@ function createRouter(options) {
         event.preventDefault();
         navigate(url.pathname.slice(normBase.length) + url.search + url.hash);
       } else {
-        if (url.pathname !== location.pathname || !url.hash.startsWith("#/")) return;
+        if (url.pathname !== location.pathname || !url.hash.startsWith("#/"))
+          return;
         event.preventDefault();
         navigate(url.hash.slice(1));
       }
     };
-    removers.push(delegate(document.body, "click", "a[href]", onClick));
+    removers.push(
+      delegate(document.body, "click", "a[href]", onClick)
+    );
   }
   let disposed = false;
   const dispose = () => {
@@ -149,7 +163,16 @@ function createRouter(options) {
     disposed = true;
     for (const remove of removers) remove();
   };
-  return { route, navigate, back: () => history.back(), forward: () => history.forward(), match, activeClass, outlet, dispose };
+  return {
+    route,
+    navigate,
+    back: () => history.back(),
+    forward: () => history.forward(),
+    match,
+    activeClass,
+    outlet,
+    dispose
+  };
 }
 
 export { createRouter };

package/dist/router.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/router.ts"],"names":["base"],"mappings":"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","file":"router.js","sourcesContent":["/**\n * `kerfjs/router` — the \"postcard router\": the smallest client-side router that\n * is still a router. The kerf *core* stays router-free (docs/1 \"Not a router\" is\n * about the runtime); this is an opt-in, tree-shakeable subpath, on the same\n * footing as `kerfjs/list` / `kerfjs/overlay` — it adds nothing to the main\n * barrel until you import it.\n *\n *   import { createRouter } from 'kerfjs/router';\n *\n *   const router = createRouter({\n *     routes: [\n *       { path: '/',          component: () => <Home /> },\n *       { path: '/users/:id', component: ({ id }) => <User id={id} /> },\n *       { path: '*',          component: () => <NotFound /> },  // catch-all\n *     ],\n *   });\n *\n *   mount(app, () => (\n *     <div>\n *       <nav> … in-app links here are auto-intercepted … </nav>\n *       {router.outlet()}   // renders the matched route's component\n *     </div>\n *   ));\n *\n * The whole model is three moving parts kerf already has: a `signal` for the\n * current route, `delegate()` for link interception, and the keyed morph for the\n * outlet (a route change swaps the page wholesale; a param change updates in\n * place). Everything a full framework's router adds — nested layouts, data\n * loaders, lazy routes, guards, SSR matching — is deliberately OUT of scope;\n * compose those with kerf primitives (an `effect` on `router.route`, a `resource`\n * from `kerfjs/async`) when you need them.\n */\nimport { delegate } from './delegate.js';\nimport { jsx } from './jsx-runtime.js';\nimport { type MountResult } from './mount.js';\nimport { computed, type ReadonlySignal, signal } from './reactive.js';\n\n/** The reactive current-route snapshot (`router.route.value`). */\nexport interface RouteState {\n  /** The matched pathname, base stripped (history mode) or the hash body (hash mode). Always starts with `/`. */\n  path: string;\n  /** Path parameters from the matched pattern — `/users/:id` on `/users/7` → `{ id: '7' }`. */\n  params: Record<string, string>;\n  /** The parsed query string (`?a=1` → `URLSearchParams`). Empty when there is none. */\n  query: URLSearchParams;\n  /** The raw location hash including `#` (history mode), or `''`. In hash mode the hash IS the route, so this is `''`. */\n  hash: string;\n}\n\n/** A route's view: receives the matched `params` and the full `route` snapshot, returns kerf content. */\nexport type RouteComponent = (params: Record<string, string>, route: RouteState) => MountResult;\n\n/** One route in the table. `path` is a pattern: `/`, `/users/:id`, `/files/*rest`, or `*` (catch-all). */\nexport interface RouteDef {\n  /** Pattern: static segments, `:param` captures, a trailing `*rest` wildcard, or `*` (matches anything — put last). */\n  path: string;\n  /** The view rendered in the outlet when this route matches. */\n  component: RouteComponent;\n}\n\n/** Options for {@link navigate}. */\nexport interface NavigateOptions {\n  /** Replace the current history entry instead of pushing a new one. Default `false`. */\n  replace?: boolean;\n  /** Arbitrary state stored on the history entry (readable via `history.state`). */\n  state?: unknown;\n}\n\n/** Options for {@link createRouter}. */\nexport interface RouterOptions {\n  /** The route table, tried in order; the first match wins. Include a `path: '*'` entry last for a fallback. */\n  routes: readonly RouteDef[];\n  /**\n   * `'history'` (default) uses the real pathname (`/users/7`) via the History\n   * API; `'hash'` keeps the route after `#` (`#/users/7`) for static hosts with\n   * no server rewrite.\n   */\n  mode?: 'history' | 'hash';\n  /** History mode only: a base path every route sits under (`/app`), matched at a segment boundary, stripped from `route.path`, and prepended on navigation. */\n  base?: string;\n  /**\n   * Auto-intercept clicks on in-app `<a href>` links (same-origin, left-click, no\n   * modifier keys / `target` / `download`) and route them instead of reloading.\n   * Opt a single link out with `data-router-ignore` or `rel=\"external\"`. Default\n   * `true`; set `false` to wire navigation entirely yourself.\n   */\n  interceptLinks?: boolean;\n}\n\n/** The handle {@link createRouter} returns. Holds no module-global state — it's a closure. */\nexport interface RouterHandle {\n  /** The reactive current route. Read `.value` (tracked) in a render / `computed` / `effect`. */\n  route: ReadonlySignal<RouteState>;\n  /** Navigate to `path` (may include `?query` / `#hash`). Pushes history (or replaces, per options). */\n  navigate: (path: string, options?: NavigateOptions) => void;\n  /** History back — `history.back()`. */\n  back: () => void;\n  /** History forward — `history.forward()`. */\n  forward: () => void;\n  /**\n   * A reactive \"is this path active?\" — true when the current path equals\n   * `pattern` or is nested under it (`match('/users')` is true on `/users/7`).\n   * `match('/')` is exact (only true on `/`). Bind it for active-nav styling.\n   */\n  match: (pattern: string) => ReadonlySignal<boolean>;\n  /** Convenience: a bound class signal — `className` while {@link match}`(pattern)` is active, else `''`. */\n  activeClass: (pattern: string, className: string) => ReadonlySignal<string>;\n  /**\n   * The routed view. Call it inside a `mount()` render: it renders the matched\n   * route's component in a keyed wrapper, so a route change swaps the page\n   * wholesale (fresh DOM) while a param change updates it in place.\n   */\n  outlet: () => MountResult;\n  /** Tear down the popstate / link listeners. Idempotent. */\n  dispose: () => void;\n}\n\n/**\n * Match `path` against a route `pattern`. Returns the captured params on a match,\n * or `null` on no match. `*` matches anything; a trailing `*name` captures the\n * remaining segments joined by `/`; `:name` captures one segment.\n */\nfunction matchPattern(pattern: string, path: string): Record<string, string> | null {\n  if (pattern === '*') return {};\n  const patternSegments = pattern.split('/').filter(Boolean);\n  const pathSegments = path.split('/').filter(Boolean);\n  const params: Record<string, string> = {};\n  for (let i = 0; i < patternSegments.length; i++) {\n    const patternSegment = patternSegments[i];\n    if (patternSegment.startsWith('*')) {\n      // Wildcard rest — consumes every remaining segment.\n      const name = patternSegment.slice(1);\n      if (name.length > 0) {\n        const decoded: string[] = [];\n        for (const part of pathSegments.slice(i)) {\n          const value = decodePathSegment(part);\n          if (value === null) return null;\n          decoded.push(value);\n        }\n        params[name] = decoded.join('/');\n      }\n      return params;\n    }\n    if (i >= pathSegments.length) return null;\n    if (patternSegment.startsWith(':')) {\n      const value = decodePathSegment(pathSegments[i]);\n      if (value === null) return null;\n      params[patternSegment.slice(1)] = value;\n      continue;\n    }\n    if (patternSegment !== pathSegments[i]) return null;\n  }\n  // No wildcard matched, so the segment counts must be exactly equal.\n  return pathSegments.length === patternSegments.length ? params : null;\n}\n\n/** Decode a route parameter, treating malformed percent escapes as no match. */\nfunction decodePathSegment(segment: string): string | null {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return null;\n  }\n}\n\n/** Whether `path` is exactly `base` or starts with it at a segment boundary. */\nfunction isWithinBase(path: string, base: string): boolean {\n  return base.length === 0 || path === base || path.startsWith(base + '/');\n}\n\n/**\n * Create a router bound to the browser history. Reads the current location\n * immediately (so `route.value` is correct before first paint), installs a\n * `popstate` listener (+ `hashchange` in hash mode) and, unless disabled, a\n * single delegated link interceptor. See {@link RouterOptions} / {@link RouterHandle}.\n */\nexport function createRouter(options: RouterOptions): RouterHandle {\n  const { routes, mode = 'history', base = '', interceptLinks = true } = options;\n  // Normalize base to '' or '/foo' (no trailing slash), so `base + path` is clean.\n  const normBase = base === '/' ? '' : base.replace(/\\/$/, '');\n\n  // The current matched route def, kept in step with the signal so `outlet()`\n  // doesn't have to re-match — it reads `route.value` only to subscribe.\n  let matched: { def: RouteDef; params: Record<string, string> } | null = null;\n\n  const readLocation = (): RouteState => {\n    let path: string;\n    let query: URLSearchParams;\n    let hash: string;\n    if (mode === 'hash') {\n      // Everything after '#': '#/users/7?a=1' → path '/users/7', query 'a=1'.\n      const raw = location.hash.slice(1) || '/';\n      const qIndex = raw.indexOf('?');\n      path = qIndex === -1 ? raw : raw.slice(0, qIndex);\n      query = new URLSearchParams(qIndex === -1 ? '' : raw.slice(qIndex + 1));\n      hash = '';\n    } else {\n      path = location.pathname;\n      if (normBase.length > 0 && isWithinBase(path, normBase)) {\n        path = path.slice(normBase.length) || '/';\n      }\n      query = new URLSearchParams(location.search);\n      hash = location.hash;\n    }\n    if (!path.startsWith('/')) path = '/' + path;\n    return { path, params: {}, query, hash };\n  };\n\n  const resolve = (state: RouteState): RouteState => {\n    for (const def of routes) {\n      const params = matchPattern(def.path, state.path);\n      if (params !== null) {\n        matched = { def, params };\n        return { ...state, params };\n      }\n    }\n    matched = null;\n    return state;\n  };\n\n  const route = signal<RouteState>(resolve(readLocation()));\n\n  // Re-read location → re-match → publish. Only writes when the path actually\n  // changed, so a doubled popstate/hashchange is a harmless no-op.\n  const sync = (): void => {\n    const next = resolve(readLocation());\n    if (next.path !== route.value.path || next.query.toString() !== route.value.query.toString()\n      || next.hash !== route.value.hash) {\n      route.value = next;\n    }\n  };\n\n  const navigate = (path: string, opts: NavigateOptions = {}): void => {\n    const url = mode === 'hash'\n      ? '#' + (path.startsWith('/') ? path : '/' + path)\n      : normBase + (path.startsWith('/') ? path : '/' + path);\n    // pushState/replaceState do NOT fire popstate, so publish the new route ourselves.\n    history[opts.replace === true ? 'replaceState' : 'pushState'](opts.state ?? null, '', url);\n    route.value = resolve(readLocation());\n  };\n\n  const match = (pattern: string): ReadonlySignal<boolean> =>\n    computed(() => {\n      const p = route.value.path;\n      if (pattern === '/') return p === '/';\n      const base = pattern.replace(/\\/$/, '');\n      return p === base || p.startsWith(base + '/');\n    });\n\n  const activeClass = (pattern: string, className: string): ReadonlySignal<string> => {\n    const active = match(pattern);\n    return computed(() => (active.value ? className : ''));\n  };\n\n  const outlet = (): MountResult => {\n    void route.value; // tracked read — subscribes the enclosing mount to navigation\n    if (matched === null) return null;\n    // Keyed by the route PATTERN: a different pattern → the morph replaces the\n    // wrapper wholesale (fresh DOM for the new page); the same pattern (only the\n    // params changed) → the morph reconciles the children in place.\n    return jsx('div', {\n      'data-router-outlet': '',\n      'data-key': matched.def.path,\n      children: matched.def.component(matched.params, route.value),\n    });\n  };\n\n  // --- Listeners ---------------------------------------------------------\n  const removers: Array<() => void> = [];\n  globalThis.addEventListener('popstate', sync);\n  removers.push(() => globalThis.removeEventListener('popstate', sync));\n  if (mode === 'hash') {\n    globalThis.addEventListener('hashchange', sync);\n    removers.push(() => globalThis.removeEventListener('hashchange', sync));\n  }\n\n  if (interceptLinks && typeof document !== 'undefined') {\n    const onClick = (event: Event, anchor: HTMLAnchorElement): void => {\n      const mouseEvent = event as MouseEvent;\n      // Let the browser handle anything that isn't a plain left-click navigation.\n      if (mouseEvent.defaultPrevented || mouseEvent.button !== 0 || mouseEvent.metaKey\n        || mouseEvent.ctrlKey || mouseEvent.shiftKey || mouseEvent.altKey) return;\n      if (anchor.hasAttribute('download') || anchor.hasAttribute('data-router-ignore')) return;\n      const target = anchor.getAttribute('target');\n      if (target !== null && target !== '' && target !== '_self') return;\n      const rel = anchor.getAttribute('rel');\n      if (rel !== null && /\\bexternal\\b/.test(rel)) return;\n      const url = new URL(anchor.href, location.href);\n      if (url.origin !== location.origin) return;\n      if (mode === 'history') {\n        if (!isWithinBase(url.pathname, normBase)) return; // outside the app's base\n        event.preventDefault();\n        navigate(url.pathname.slice(normBase.length) + url.search + url.hash);\n      } else {\n        // Hash mode: only intercept in-app hash links (`#/...`), leave others alone.\n        if (url.pathname !== location.pathname || !url.hash.startsWith('#/')) return;\n        event.preventDefault();\n        navigate(url.hash.slice(1));\n      }\n    };\n    removers.push(delegate<HTMLAnchorElement>(document.body, 'click', 'a[href]', onClick));\n  }\n\n  let disposed = false;\n  const dispose = (): void => {\n    if (disposed) return;\n    disposed = true;\n    for (const remove of removers) remove();\n  };\n\n  return { route, navigate, back: () => history.back(), forward: () => history.forward(), match, activeClass, outlet, dispose };\n}\n"]}
+{"version":3,"sources":["../src/router.ts"],"names":["base"],"mappings":"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","file":"router.js","sourcesContent":["/**\n * `kerfjs/router` — the \"postcard router\": the smallest client-side router that\n * is still a router. The kerf *core* stays router-free (docs/1 \"Not a router\" is\n * about the runtime); this is an opt-in, tree-shakeable subpath, on the same\n * footing as `kerfjs/list` / `kerfjs/overlay` — it adds nothing to the main\n * barrel until you import it.\n *\n *   import { createRouter } from 'kerfjs/router';\n *\n *   const router = createRouter({\n *     routes: [\n *       { path: '/',          component: () => <Home /> },\n *       { path: '/users/:id', component: ({ id }) => <User id={id} /> },\n *       { path: '*',          component: () => <NotFound /> },  // catch-all\n *     ],\n *   });\n *\n *   mount(app, () => (\n *     <div>\n *       <nav> … in-app links here are auto-intercepted … </nav>\n *       {router.outlet()}   // renders the matched route's component\n *     </div>\n *   ));\n *\n * The whole model is three moving parts kerf already has: a `signal` for the\n * current route, `delegate()` for link interception, and the keyed morph for the\n * outlet (a route change swaps the page wholesale; a param change updates in\n * place). Everything a full framework's router adds — nested layouts, data\n * loaders, lazy routes, guards, SSR matching — is deliberately OUT of scope;\n * compose those with kerf primitives (an `effect` on `router.route`, a `resource`\n * from `kerfjs/async`) when you need them.\n */\nimport { delegate } from './delegate.js';\nimport { jsx } from './jsx-runtime.js';\nimport { type MountResult } from './mount.js';\nimport { computed, type ReadonlySignal, signal } from './reactive.js';\n\n/** The reactive current-route snapshot (`router.route.value`). */\nexport interface RouteState {\n  /** The matched pathname, base stripped (history mode) or the hash body (hash mode). Always starts with `/`. */\n  path: string;\n  /** Path parameters from the matched pattern — `/users/:id` on `/users/7` → `{ id: '7' }`. */\n  params: Record<string, string>;\n  /** The parsed query string (`?a=1` → `URLSearchParams`). Empty when there is none. */\n  query: URLSearchParams;\n  /** The raw location hash including `#` (history mode), or `''`. In hash mode the hash IS the route, so this is `''`. */\n  hash: string;\n}\n\n/** A route's view: receives the matched `params` and the full `route` snapshot, returns kerf content. */\nexport type RouteComponent = (\n  params: Record<string, string>,\n  route: RouteState,\n) => MountResult;\n\n/** One route in the table. `path` is a pattern: `/`, `/users/:id`, `/files/*rest`, or `*` (catch-all). */\nexport interface RouteDef {\n  /** Pattern: static segments, `:param` captures, a trailing `*rest` wildcard, or `*` (matches anything — put last). */\n  path: string;\n  /** The view rendered in the outlet when this route matches. */\n  component: RouteComponent;\n}\n\n/** Options for {@link navigate}. */\nexport interface NavigateOptions {\n  /** Replace the current history entry instead of pushing a new one. Default `false`. */\n  replace?: boolean;\n  /** Arbitrary state stored on the history entry (readable via `history.state`). */\n  state?: unknown;\n}\n\n/** Options for {@link createRouter}. */\nexport interface RouterOptions {\n  /** The route table, tried in order; the first match wins. Include a `path: '*'` entry last for a fallback. */\n  routes: readonly RouteDef[];\n  /**\n   * `'history'` (default) uses the real pathname (`/users/7`) via the History\n   * API; `'hash'` keeps the route after `#` (`#/users/7`) for static hosts with\n   * no server rewrite.\n   */\n  mode?: 'history' | 'hash';\n  /** History mode only: a base path every route sits under (`/app`), matched at a segment boundary, stripped from `route.path`, and prepended on navigation. */\n  base?: string;\n  /**\n   * Auto-intercept clicks on in-app `<a href>` links (same-origin, left-click, no\n   * modifier keys / `target` / `download`) and route them instead of reloading.\n   * Opt a single link out with `data-router-ignore` or `rel=\"external\"`. Default\n   * `true`; set `false` to wire navigation entirely yourself.\n   */\n  interceptLinks?: boolean;\n}\n\n/** The handle {@link createRouter} returns. Holds no module-global state — it's a closure. */\nexport interface RouterHandle {\n  /** The reactive current route. Read `.value` (tracked) in a render / `computed` / `effect`. */\n  route: ReadonlySignal<RouteState>;\n  /** Navigate to `path` (may include `?query` / `#hash`). Pushes history (or replaces, per options). */\n  navigate: (path: string, options?: NavigateOptions) => void;\n  /** History back — `history.back()`. */\n  back: () => void;\n  /** History forward — `history.forward()`. */\n  forward: () => void;\n  /**\n   * A reactive \"is this path active?\" — true when the current path equals\n   * `pattern` or is nested under it (`match('/users')` is true on `/users/7`).\n   * `match('/')` is exact (only true on `/`). Bind it for active-nav styling.\n   */\n  match: (pattern: string) => ReadonlySignal<boolean>;\n  /** Convenience: a bound class signal — `className` while {@link match}`(pattern)` is active, else `''`. */\n  activeClass: (pattern: string, className: string) => ReadonlySignal<string>;\n  /**\n   * The routed view. Call it inside a `mount()` render: it renders the matched\n   * route's component in a keyed wrapper, so a route change swaps the page\n   * wholesale (fresh DOM) while a param change updates it in place.\n   */\n  outlet: () => MountResult;\n  /** Tear down the popstate / link listeners. Idempotent. */\n  dispose: () => void;\n}\n\n/**\n * Match `path` against a route `pattern`. Returns the captured params on a match,\n * or `null` on no match. `*` matches anything; a trailing `*name` captures the\n * remaining segments joined by `/`; `:name` captures one segment.\n */\nfunction matchPattern(\n  pattern: string,\n  path: string,\n): Record<string, string> | null {\n  if (pattern === '*') return {};\n  const patternSegments = pattern.split('/').filter(Boolean);\n  const pathSegments = path.split('/').filter(Boolean);\n  const params: Record<string, string> = {};\n  for (let i = 0; i < patternSegments.length; i++) {\n    const patternSegment = patternSegments[i];\n    if (patternSegment.startsWith('*')) {\n      // Wildcard rest — consumes every remaining segment.\n      const name = patternSegment.slice(1);\n      if (name.length > 0) {\n        const decoded: string[] = [];\n        for (const part of pathSegments.slice(i)) {\n          const value = decodePathSegment(part);\n          if (value === null) return null;\n          decoded.push(value);\n        }\n        params[name] = decoded.join('/');\n      }\n      return params;\n    }\n    if (i >= pathSegments.length) return null;\n    if (patternSegment.startsWith(':')) {\n      const value = decodePathSegment(pathSegments[i]);\n      if (value === null) return null;\n      params[patternSegment.slice(1)] = value;\n      continue;\n    }\n    if (patternSegment !== pathSegments[i]) return null;\n  }\n  // No wildcard matched, so the segment counts must be exactly equal.\n  return pathSegments.length === patternSegments.length ? params : null;\n}\n\n/** Decode a route parameter, treating malformed percent escapes as no match. */\nfunction decodePathSegment(segment: string): string | null {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return null;\n  }\n}\n\n/** Whether `path` is exactly `base` or starts with it at a segment boundary. */\nfunction isWithinBase(path: string, base: string): boolean {\n  return base.length === 0 || path === base || path.startsWith(base + '/');\n}\n\n/**\n * Create a router bound to the browser history. Reads the current location\n * immediately (so `route.value` is correct before first paint), installs a\n * `popstate` listener (+ `hashchange` in hash mode) and, unless disabled, a\n * single delegated link interceptor. See {@link RouterOptions} / {@link RouterHandle}.\n */\nexport function createRouter(options: RouterOptions): RouterHandle {\n  const {\n    routes,\n    mode = 'history',\n    base = '',\n    interceptLinks = true,\n  } = options;\n  // Normalize base to '' or '/foo' (no trailing slash), so `base + path` is clean.\n  const normBase = base === '/' ? '' : base.replace(/\\/$/, '');\n\n  // The current matched route def, kept in step with the signal so `outlet()`\n  // doesn't have to re-match — it reads `route.value` only to subscribe.\n  let matched: { def: RouteDef; params: Record<string, string> } | null = null;\n\n  const readLocation = (): RouteState => {\n    let path: string;\n    let query: URLSearchParams;\n    let hash: string;\n    if (mode === 'hash') {\n      // Everything after '#': '#/users/7?a=1' → path '/users/7', query 'a=1'.\n      const raw = location.hash.slice(1) || '/';\n      const qIndex = raw.indexOf('?');\n      path = qIndex === -1 ? raw : raw.slice(0, qIndex);\n      query = new URLSearchParams(qIndex === -1 ? '' : raw.slice(qIndex + 1));\n      hash = '';\n    } else {\n      path = location.pathname;\n      if (normBase.length > 0 && isWithinBase(path, normBase)) {\n        path = path.slice(normBase.length) || '/';\n      }\n      query = new URLSearchParams(location.search);\n      hash = location.hash;\n    }\n    if (!path.startsWith('/')) path = '/' + path;\n    return { path, params: {}, query, hash };\n  };\n\n  const resolve = (state: RouteState): RouteState => {\n    for (const def of routes) {\n      const params = matchPattern(def.path, state.path);\n      if (params !== null) {\n        matched = { def, params };\n        return { ...state, params };\n      }\n    }\n    matched = null;\n    return state;\n  };\n\n  const route = signal<RouteState>(resolve(readLocation()));\n\n  // Re-read location → re-match → publish. Only writes when the path actually\n  // changed, so a doubled popstate/hashchange is a harmless no-op.\n  const sync = (): void => {\n    const next = resolve(readLocation());\n    if (\n      next.path !== route.value.path ||\n      next.query.toString() !== route.value.query.toString() ||\n      next.hash !== route.value.hash\n    ) {\n      route.value = next;\n    }\n  };\n\n  const navigate = (path: string, opts: NavigateOptions = {}): void => {\n    const url =\n      mode === 'hash'\n        ? '#' + (path.startsWith('/') ? path : '/' + path)\n        : normBase + (path.startsWith('/') ? path : '/' + path);\n    // pushState/replaceState do NOT fire popstate, so publish the new route ourselves.\n    history[opts.replace === true ? 'replaceState' : 'pushState'](\n      opts.state ?? null,\n      '',\n      url,\n    );\n    route.value = resolve(readLocation());\n  };\n\n  const match = (pattern: string): ReadonlySignal<boolean> =>\n    computed(() => {\n      const p = route.value.path;\n      if (pattern === '/') return p === '/';\n      const base = pattern.replace(/\\/$/, '');\n      return p === base || p.startsWith(base + '/');\n    });\n\n  const activeClass = (\n    pattern: string,\n    className: string,\n  ): ReadonlySignal<string> => {\n    const active = match(pattern);\n    return computed(() => (active.value ? className : ''));\n  };\n\n  const outlet = (): MountResult => {\n    void route.value; // tracked read — subscribes the enclosing mount to navigation\n    if (matched === null) return null;\n    // Keyed by the route PATTERN: a different pattern → the morph replaces the\n    // wrapper wholesale (fresh DOM for the new page); the same pattern (only the\n    // params changed) → the morph reconciles the children in place.\n    return jsx('div', {\n      'data-router-outlet': '',\n      'data-key': matched.def.path,\n      children: matched.def.component(matched.params, route.value),\n    });\n  };\n\n  // --- Listeners ---------------------------------------------------------\n  const removers: Array<() => void> = [];\n  globalThis.addEventListener('popstate', sync);\n  removers.push(() => globalThis.removeEventListener('popstate', sync));\n  if (mode === 'hash') {\n    globalThis.addEventListener('hashchange', sync);\n    removers.push(() => globalThis.removeEventListener('hashchange', sync));\n  }\n\n  if (interceptLinks && typeof document !== 'undefined') {\n    const onClick = (event: Event, anchor: HTMLAnchorElement): void => {\n      const mouseEvent = event as MouseEvent;\n      // Let the browser handle anything that isn't a plain left-click navigation.\n      if (\n        mouseEvent.defaultPrevented ||\n        mouseEvent.button !== 0 ||\n        mouseEvent.metaKey ||\n        mouseEvent.ctrlKey ||\n        mouseEvent.shiftKey ||\n        mouseEvent.altKey\n      )\n        return;\n      if (\n        anchor.hasAttribute('download') ||\n        anchor.hasAttribute('data-router-ignore')\n      )\n        return;\n      const target = anchor.getAttribute('target');\n      if (target !== null && target !== '' && target !== '_self') return;\n      const rel = anchor.getAttribute('rel');\n      if (rel !== null && /\\bexternal\\b/.test(rel)) return;\n      const url = new URL(anchor.href, location.href);\n      if (url.origin !== location.origin) return;\n      if (mode === 'history') {\n        if (!isWithinBase(url.pathname, normBase)) return; // outside the app's base\n        event.preventDefault();\n        navigate(url.pathname.slice(normBase.length) + url.search + url.hash);\n      } else {\n        // Hash mode: only intercept in-app hash links (`#/...`), leave others alone.\n        if (url.pathname !== location.pathname || !url.hash.startsWith('#/'))\n          return;\n        event.preventDefault();\n        navigate(url.hash.slice(1));\n      }\n    };\n    removers.push(\n      delegate<HTMLAnchorElement>(document.body, 'click', 'a[href]', onClick),\n    );\n  }\n\n  let disposed = false;\n  const dispose = (): void => {\n    if (disposed) return;\n    disposed = true;\n    for (const remove of removers) remove();\n  };\n\n  return {\n    route,\n    navigate,\n    back: () => history.back(),\n    forward: () => history.forward(),\n    match,\n    activeClass,\n    outlet,\n    dispose,\n  };\n}\n"]}

package/dist/scope.js

@@ -1,9 +1,9 @@
-import { mount } from './chunk-SVATPF5R.js';
-import { delegate } from './chunk-KPXIOG2C.js';
+import { mount } from './chunk-DLY444MN.js';
+import { delegate } from './chunk-E5R5GNKE.js';
 
 
 
-import { effect } from './chunk-U6FK33SG.js';
+import { effect } from './chunk-Y2FOYPBV.js';
 
 
 
@@ -58,7 +58,8 @@ function observeRemovals(root) {
   const observer = new MutationObserver((records) => {
     for (const record of records) {
       for (const node of record.removedNodes) {
-        if (node instanceof Element && !root.contains(node)) disposeSubtree(node);
+        if (node instanceof Element && !root.contains(node))
+          disposeSubtree(node);
       }
     }
   });

package/dist/scope.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/scope.ts"],"names":[],"mappings":";;;;;;;;;;AAyDA,IAAM,MAAA,uBAAa,OAAA,EAA6B;AAOzC,SAAS,aAAa,EAAA,EAAoB;AAC/C,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAC9B,EAAA,IAAI,QAAA,KAAa,MAAA,EAAW,OAAO,QAAA,CAAS,KAAA;AAE5C,EAAA,MAAM,YAA+B,EAAC;AACtC,EAAA,MAAM,KAAA,GAAe;AAAA,IACnB,IAAI,OAAA,EAAS;AACX,MAAA,SAAA,CAAU,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,KAAA,CAAM,QAAQ,MAAA,EAAQ;AACpB,MAAA,MAAM,OAAA,GAAU,KAAA,CAAM,MAAA,EAAQ,MAAM,CAAA;AACpC,MAAA,SAAA,CAAU,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,OAAO,EAAA,EAAI;AACT,MAAA,MAAM,OAAA,GAAU,OAAO,EAAE,CAAA;AACzB,MAAA,SAAA,CAAU,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,QAAA,CAAS,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,SAAS,OAAA,EAAS;AAC/C,MAAA,MAAM,UAAU,QAAA,CAAS,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,SAAS,OAAO,CAAA;AAC/D,MAAA,SAAA,CAAU,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,MAAA,CAAO,OAAO,EAAE,CAAA;AAEhB,MAAA,KAAA,MAAW,CAAA,IAAK,SAAA,CAAU,MAAA,CAAO,CAAC,CAAA,EAAG;AACnC,QAAA,IAAI;AACF,UAAA,CAAA,EAAE;AAAA,QACJ,CAAA,CAAA,MAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF;AAAA,GACF;AACA,EAAA,MAAA,CAAO,GAAA,CAAI,EAAA,EAAI,EAAE,KAAA,EAAO,WAAW,CAAA;AACnC,EAAA,OAAO,KAAA;AACT;AAOO,SAAS,eAAe,IAAA,EAAqB;AAGlD,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAC3B,EAAA,IAAI,GAAA,KAAQ,MAAA,EAAW,GAAA,CAAI,KAAA,CAAM,OAAA,EAAQ;AACzC,EAAA,KAAA,MAAW,EAAA,IAAM,IAAA,CAAK,gBAAA,CAAiB,GAAG,CAAA,EAAG;AAC3C,IAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAC3B,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,KAAA,CAAM,KAAA,CAAM,OAAA,EAAQ;AAAA,EAC/C;AACF;AASO,SAAS,gBAAgB,IAAA,EAA2B;AACzD,EAAA,MAAM,QAAA,GAAW,IAAI,gBAAA,CAAiB,CAAC,OAAA,KAAY;AACjD,IAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,MAAA,KAAA,MAAW,IAAA,IAAQ,OAAO,YAAA,EAAc;AACtC,QAAA,IAAI,IAAA,YAAgB,WAAW,CAAC,IAAA,CAAK,SAAS,IAAI,CAAA,iBAAkB,IAAI,CAAA;AAAA,MAC1E;AAAA,IACF;AAAA,EACF,CAAC,CAAA;AACD,EAAA,QAAA,CAAS,QAAQ,IAAA,EAAM,EAAE,WAAW,IAAA,EAAM,OAAA,EAAS,MAAM,CAAA;AACzD,EAAA,OAAO,MAAM,SAAS,UAAA,EAAW;AACnC","file":"scope.js","sourcesContent":["/**\n * `kerfjs/scope` — tie a set of disposers to a DOM element's lifetime.\n *\n * kerf hands out disposers (`mount()` / `effect()` / `delegate()` all return\n * `() => void`), but nothing scopes them to a subtree's lifetime — so an\n * append-heavy app (a feed, a list of cards) leaks detached-but-subscribed\n * effects, listeners, and observers. Every such app hand-rolls the same\n * `WeakMap<Element, disposers[]>` swept on removal. This subpath blesses it.\n *\n *   import { disposeScope, disposeSubtree, observeRemovals } from 'kerfjs/scope';\n *\n *   const s = disposeScope(card);\n *   s.mount(card, renderCard);              // mounts AND registers its disposer\n *   s.effect(() => syncCard(card));\n *   s.delegate(card, 'click', '.del', del);\n *   s.add(() => observer.disconnect());     // any () => void disposer\n *   // …when the card goes away:\n *   disposeSubtree(feed);                   // runs every scope in feed (incl. feed)\n *   feed.remove();\n *\n * Or install one observer and let removals auto-dispose:\n *   observeRemovals(document.body);\n *\n * No module-level mutable state: scopes live in a `WeakMap` (GC-tied, keyed by\n * element), and `disposeSubtree` finds them by walking the subtree.\n */\nimport { delegate, type DelegateOptions } from './delegate.js';\nimport { mount, type MountResult } from './mount.js';\nimport { effect } from './reactive.js';\n\n/** A per-element teardown scope. Calling `disposeScope(el)` again returns the SAME scope. */\nexport interface Scope {\n  /** Register any `() => void` disposer (a `mount`/`effect`/`delegate` return, a listener remover, …). Returns it. */\n  add(dispose: () => void): () => void;\n  /** `mount()` into `el` and register its disposer in one step. Returns the disposer. */\n  mount(el: HTMLElement, render: () => MountResult): () => void;\n  /** `effect(fn)` and register its disposer in one step. Returns the disposer. */\n  effect(fn: () => void | (() => void)): () => void;\n  /** `delegate(...)` and register its disposer in one step. Returns the disposer. */\n  delegate<T extends Element = Element>(\n    root: HTMLElement,\n    type: string,\n    selector: string,\n    handler: (event: Event, target: T) => void,\n    options?: DelegateOptions,\n  ): () => void;\n  /** Run every registered disposer (best-effort — a throwing one won't strand the rest) and reset. Idempotent. */\n  dispose(): void;\n}\n\ninterface ScopeState {\n  scope: Scope;\n  disposers: Array<() => void>;\n}\n\n// GC-tied cache keyed by element — const + WeakMap, so it is exempt from the\n// \"no module-level mutable state\" rule (like bindings.ts:insertedTextNodes).\nconst scopes = new WeakMap<Element, ScopeState>();\n\n/**\n * Get (or create) the teardown {@link Scope} for `el`. Repeated calls for the\n * same element return the same scope, so disparate code paths can register into\n * one place. After `dispose()`, a later `disposeScope(el)` starts fresh.\n */\nexport function disposeScope(el: Element): Scope {\n  const existing = scopes.get(el);\n  if (existing !== undefined) return existing.scope;\n\n  const disposers: Array<() => void> = [];\n  const scope: Scope = {\n    add(dispose) {\n      disposers.push(dispose);\n      return dispose;\n    },\n    mount(target, render) {\n      const dispose = mount(target, render);\n      disposers.push(dispose);\n      return dispose;\n    },\n    effect(fn) {\n      const dispose = effect(fn);\n      disposers.push(dispose);\n      return dispose;\n    },\n    delegate(root, type, selector, handler, options) {\n      const dispose = delegate(root, type, selector, handler, options);\n      disposers.push(dispose);\n      return dispose;\n    },\n    dispose() {\n      scopes.delete(el);\n      // splice() empties the array AND makes a second dispose() a no-op.\n      for (const d of disposers.splice(0)) {\n        try {\n          d();\n        } catch {\n          /* best-effort: a throwing disposer must not strand the rest */\n        }\n      }\n    },\n  };\n  scopes.set(el, { scope, disposers });\n  return scope;\n}\n\n/**\n * Dispose every scope within `root` (including `root`'s own), then leave the DOM\n * to you. Call it right before removing a subtree. Finds scopes by walking the\n * subtree against the `WeakMap` — no marker attributes are added to your DOM.\n */\nexport function disposeSubtree(root: Element): void {\n  // Static NodeList snapshot — safe to dispose (which deletes WeakMap entries)\n  // while iterating. Root first, then descendants in document order.\n  const own = scopes.get(root);\n  if (own !== undefined) own.scope.dispose();\n  for (const el of root.querySelectorAll('*')) {\n    const state = scopes.get(el);\n    if (state !== undefined) state.scope.dispose();\n  }\n}\n\n/**\n * Install a `MutationObserver` on `root` that auto-disposes a node's scope when\n * that node (or an ancestor) is permanently removed from the subtree. A node\n * moved or reordered within `root` remains live. One observer covers the whole\n * tree. Returns a disconnect function. Note: `MutationObserver` fires\n * asynchronously, so final containment and disposal run after the mutation.\n */\nexport function observeRemovals(root: Element): () => void {\n  const observer = new MutationObserver((records) => {\n    for (const record of records) {\n      for (const node of record.removedNodes) {\n        if (node instanceof Element && !root.contains(node)) disposeSubtree(node);\n      }\n    }\n  });\n  observer.observe(root, { childList: true, subtree: true });\n  return () => observer.disconnect();\n}\n"]}
+{"version":3,"sources":["../src/scope.ts"],"names":[],"mappings":";;;;;;;;;;AAyDA,IAAM,MAAA,uBAAa,OAAA,EAA6B;AAOzC,SAAS,aAAa,EAAA,EAAoB;AAC/C,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAC9B,EAAA,IAAI,QAAA,KAAa,MAAA,EAAW,OAAO,QAAA,CAAS,KAAA;AAE5C,EAAA,MAAM,YAA+B,EAAC;AACtC,EAAA,MAAM,KAAA,GAAe;AAAA,IACnB,IAAI,OAAA,EAAS;AACX,MAAA,SAAA,CAAU,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,KAAA,CAAM,QAAQ,MAAA,EAAQ;AACpB,MAAA,MAAM,OAAA,GAAU,KAAA,CAAM,MAAA,EAAQ,MAAM,CAAA;AACpC,MAAA,SAAA,CAAU,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,OAAO,EAAA,EAAI;AACT,MAAA,MAAM,OAAA,GAAU,OAAO,EAAE,CAAA;AACzB,MAAA,SAAA,CAAU,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,QAAA,CAAS,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,SAAS,OAAA,EAAS;AAC/C,MAAA,MAAM,UAAU,QAAA,CAAS,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,SAAS,OAAO,CAAA;AAC/D,MAAA,SAAA,CAAU,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,MAAA,CAAO,OAAO,EAAE,CAAA;AAEhB,MAAA,KAAA,MAAW,CAAA,IAAK,SAAA,CAAU,MAAA,CAAO,CAAC,CAAA,EAAG;AACnC,QAAA,IAAI;AACF,UAAA,CAAA,EAAE;AAAA,QACJ,CAAA,CAAA,MAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF;AAAA,GACF;AACA,EAAA,MAAA,CAAO,GAAA,CAAI,EAAA,EAAI,EAAE,KAAA,EAAO,WAAW,CAAA;AACnC,EAAA,OAAO,KAAA;AACT;AAOO,SAAS,eAAe,IAAA,EAAqB;AAGlD,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAC3B,EAAA,IAAI,GAAA,KAAQ,MAAA,EAAW,GAAA,CAAI,KAAA,CAAM,OAAA,EAAQ;AACzC,EAAA,KAAA,MAAW,EAAA,IAAM,IAAA,CAAK,gBAAA,CAAiB,GAAG,CAAA,EAAG;AAC3C,IAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAC3B,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,KAAA,CAAM,KAAA,CAAM,OAAA,EAAQ;AAAA,EAC/C;AACF;AASO,SAAS,gBAAgB,IAAA,EAA2B;AACzD,EAAA,MAAM,QAAA,GAAW,IAAI,gBAAA,CAAiB,CAAC,OAAA,KAAY;AACjD,IAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,MAAA,KAAA,MAAW,IAAA,IAAQ,OAAO,YAAA,EAAc;AACtC,QAAA,IAAI,IAAA,YAAgB,OAAA,IAAW,CAAC,IAAA,CAAK,SAAS,IAAI,CAAA;AAChD,UAAA,cAAA,CAAe,IAAI,CAAA;AAAA,MACvB;AAAA,IACF;AAAA,EACF,CAAC,CAAA;AACD,EAAA,QAAA,CAAS,QAAQ,IAAA,EAAM,EAAE,WAAW,IAAA,EAAM,OAAA,EAAS,MAAM,CAAA;AACzD,EAAA,OAAO,MAAM,SAAS,UAAA,EAAW;AACnC","file":"scope.js","sourcesContent":["/**\n * `kerfjs/scope` — tie a set of disposers to a DOM element's lifetime.\n *\n * kerf hands out disposers (`mount()` / `effect()` / `delegate()` all return\n * `() => void`), but nothing scopes them to a subtree's lifetime — so an\n * append-heavy app (a feed, a list of cards) leaks detached-but-subscribed\n * effects, listeners, and observers. Every such app hand-rolls the same\n * `WeakMap<Element, disposers[]>` swept on removal. This subpath blesses it.\n *\n *   import { disposeScope, disposeSubtree, observeRemovals } from 'kerfjs/scope';\n *\n *   const s = disposeScope(card);\n *   s.mount(card, renderCard);              // mounts AND registers its disposer\n *   s.effect(() => syncCard(card));\n *   s.delegate(card, 'click', '.del', del);\n *   s.add(() => observer.disconnect());     // any () => void disposer\n *   // …when the card goes away:\n *   disposeSubtree(feed);                   // runs every scope in feed (incl. feed)\n *   feed.remove();\n *\n * Or install one observer and let removals auto-dispose:\n *   observeRemovals(document.body);\n *\n * No module-level mutable state: scopes live in a `WeakMap` (GC-tied, keyed by\n * element), and `disposeSubtree` finds them by walking the subtree.\n */\nimport { delegate, type DelegateOptions } from './delegate.js';\nimport { mount, type MountResult } from './mount.js';\nimport { effect } from './reactive.js';\n\n/** A per-element teardown scope. Calling `disposeScope(el)` again returns the SAME scope. */\nexport interface Scope {\n  /** Register any `() => void` disposer (a `mount`/`effect`/`delegate` return, a listener remover, …). Returns it. */\n  add(dispose: () => void): () => void;\n  /** `mount()` into `el` and register its disposer in one step. Returns the disposer. */\n  mount(el: HTMLElement, render: () => MountResult): () => void;\n  /** `effect(fn)` and register its disposer in one step. Returns the disposer. */\n  effect(fn: () => void | (() => void)): () => void;\n  /** `delegate(...)` and register its disposer in one step. Returns the disposer. */\n  delegate<T extends Element = Element>(\n    root: HTMLElement,\n    type: string,\n    selector: string,\n    handler: (event: Event, target: T) => void,\n    options?: DelegateOptions,\n  ): () => void;\n  /** Run every registered disposer (best-effort — a throwing one won't strand the rest) and reset. Idempotent. */\n  dispose(): void;\n}\n\ninterface ScopeState {\n  scope: Scope;\n  disposers: Array<() => void>;\n}\n\n// GC-tied cache keyed by element — const + WeakMap, so it is exempt from the\n// \"no module-level mutable state\" rule (like bindings.ts:insertedTextNodes).\nconst scopes = new WeakMap<Element, ScopeState>();\n\n/**\n * Get (or create) the teardown {@link Scope} for `el`. Repeated calls for the\n * same element return the same scope, so disparate code paths can register into\n * one place. After `dispose()`, a later `disposeScope(el)` starts fresh.\n */\nexport function disposeScope(el: Element): Scope {\n  const existing = scopes.get(el);\n  if (existing !== undefined) return existing.scope;\n\n  const disposers: Array<() => void> = [];\n  const scope: Scope = {\n    add(dispose) {\n      disposers.push(dispose);\n      return dispose;\n    },\n    mount(target, render) {\n      const dispose = mount(target, render);\n      disposers.push(dispose);\n      return dispose;\n    },\n    effect(fn) {\n      const dispose = effect(fn);\n      disposers.push(dispose);\n      return dispose;\n    },\n    delegate(root, type, selector, handler, options) {\n      const dispose = delegate(root, type, selector, handler, options);\n      disposers.push(dispose);\n      return dispose;\n    },\n    dispose() {\n      scopes.delete(el);\n      // splice() empties the array AND makes a second dispose() a no-op.\n      for (const d of disposers.splice(0)) {\n        try {\n          d();\n        } catch {\n          /* best-effort: a throwing disposer must not strand the rest */\n        }\n      }\n    },\n  };\n  scopes.set(el, { scope, disposers });\n  return scope;\n}\n\n/**\n * Dispose every scope within `root` (including `root`'s own), then leave the DOM\n * to you. Call it right before removing a subtree. Finds scopes by walking the\n * subtree against the `WeakMap` — no marker attributes are added to your DOM.\n */\nexport function disposeSubtree(root: Element): void {\n  // Static NodeList snapshot — safe to dispose (which deletes WeakMap entries)\n  // while iterating. Root first, then descendants in document order.\n  const own = scopes.get(root);\n  if (own !== undefined) own.scope.dispose();\n  for (const el of root.querySelectorAll('*')) {\n    const state = scopes.get(el);\n    if (state !== undefined) state.scope.dispose();\n  }\n}\n\n/**\n * Install a `MutationObserver` on `root` that auto-disposes a node's scope when\n * that node (or an ancestor) is permanently removed from the subtree. A node\n * moved or reordered within `root` remains live. One observer covers the whole\n * tree. Returns a disconnect function. Note: `MutationObserver` fires\n * asynchronously, so final containment and disposal run after the mutation.\n */\nexport function observeRemovals(root: Element): () => void {\n  const observer = new MutationObserver((records) => {\n    for (const record of records) {\n      for (const node of record.removedNodes) {\n        if (node instanceof Element && !root.contains(node))\n          disposeSubtree(node);\n      }\n    }\n  });\n  observer.observe(root, { childList: true, subtree: true });\n  return () => observer.disconnect();\n}\n"]}

package/dist/testing.js

@@ -1,4 +1,4 @@
-export { clearStoreRegistry } from './chunk-KZJXHFIB.js';
+export { clearStoreRegistry } from './chunk-ZOIERTUW.js';
 
 
 

package/dist/timing.js

@@ -1,4 +1,4 @@
-import { signal, effect } from './chunk-U6FK33SG.js';
+import { signal, effect } from './chunk-Y2FOYPBV.js';
 
 
 // src/timing.ts

package/dist/timing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/timing.ts"],"names":[],"mappings":";;;;AA8CO,SAAS,QAAA,CAA8B,IAA0B,EAAA,EAA0B;AAChG,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,QAAA;AAEJ,EAAA,MAAM,SAAS,MAAY;AACzB,IAAA,KAAA,GAAQ,MAAA;AACR,IAAA,MAAM,IAAA,GAAO,QAAA;AACb,IAAA,QAAA,GAAW,MAAA;AACX,IAAA,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,EACZ,CAAA;AAEA,EAAA,MAAM,SAAA,IAAa,IAAI,IAAA,KAAkB;AACvC,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAC3C,IAAA,KAAA,GAAQ,UAAA,CAAW,QAAQ,EAAE,CAAA;AAAA,EAC/B,CAAA,CAAA;AAEA,EAAA,SAAA,CAAU,SAAS,MAAY;AAC7B,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAC3C,IAAA,KAAA,GAAQ,MAAA;AACR,IAAA,QAAA,GAAW,MAAA;AAAA,EACb,CAAA;AAEA,EAAA,SAAA,CAAU,QAAQ,MAAY;AAC5B,IAAA,IAAI,UAAU,MAAA,EAAW;AACvB,MAAA,YAAA,CAAa,KAAK,CAAA;AAClB,MAAA,MAAA,EAAO;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,SAAA;AACT;AASO,SAAS,QAAA,CAA8B,IAA0B,EAAA,EAA0B;AAChG,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,YAAA;AAEJ,EAAA,MAAM,cAAc,MAAY;AAC9B,IAAA,MAAM,IAAA,GAAO,YAAA;AACb,IAAA,YAAA,GAAe,MAAA;AACf,IAAA,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,EACZ,CAAA;AAEA,EAAA,MAAM,gBAAgB,MAAY;AAChC,IAAA,KAAA,GAAQ,WAAW,MAAM;AACvB,MAAA,KAAA,GAAQ,MAAA;AACR,MAAA,IAAI,iBAAiB,MAAA,EAAW;AAI9B,QAAA,aAAA,EAAc;AACd,QAAA,WAAA,EAAY;AAAA,MACd;AAAA,IACF,GAAG,EAAE,CAAA;AAAA,EACP,CAAA;AAEA,EAAA,MAAM,SAAA,IAAa,IAAI,IAAA,KAAkB;AACvC,IAAA,IAAI,UAAU,MAAA,EAAW;AAGvB,MAAA,aAAA,EAAc;AACd,MAAA,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,IACZ,CAAA,MAAO;AACL,MAAA,YAAA,GAAe,IAAA;AAAA,IACjB;AAAA,EACF,CAAA,CAAA;AAEA,EAAA,SAAA,CAAU,SAAS,MAAY;AAC7B,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAC3C,IAAA,KAAA,GAAQ,MAAA;AACR,IAAA,YAAA,GAAe,MAAA;AAAA,EACjB,CAAA;AAEA,EAAA,SAAA,CAAU,QAAQ,MAAY;AAC5B,IAAA,IAAI,YAAA,KAAiB,QAAW,WAAA,EAAY;AAAA,EAC9C,CAAA;AAEA,EAAA,OAAO,SAAA;AACT;AAWO,SAAS,eAAA,CAAmB,QAA2B,EAAA,EAA+B;AAC3F,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA;AAC/B,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,CAAC,KAAA,KAAa;AACnC,IAAA,GAAA,CAAI,KAAA,GAAQ,KAAA;AAAA,EACd,GAAG,EAAE,CAAA;AACL,EAAA,MAAA,CAAO,MAAM;AACX,IAAA,KAAA,CAAM,OAAO,KAAK,CAAA;AAAA,EACpB,CAAC,CAAA;AACD,EAAA,OAAO,GAAA;AACT","file":"timing.js","sourcesContent":["/**\n * `kerfjs/timing` — the small timing primitives every app hand-rolls.\n *\n * kerf already replaced most imperative bookkeeping — `delegate` for listeners,\n * `mount`/`effect` for render, `defineStore` for state — but debouncing and\n * throttling still get written by hand as `let timer; clearTimeout(timer);\n * timer = setTimeout(fn, ms)`. This subpath blesses that with disposer-shaped\n * ergonomics (`.cancel()` / `.flush()`), plus `debouncedSignal` so a trailing\n * value composes inside the reactive graph instead of beside it.\n *\n *   import { debounce, throttle, debouncedSignal } from 'kerfjs/timing';\n *\n *   const save = debounce(() => persist(state), 300);\n *   input.addEventListener('input', save);   // save.cancel() on teardown\n *\n *   const query = signal('');\n *   const debouncedQuery = debouncedSignal(query, 250); // trails query by 250ms\n *\n * Tree-shakeable and tiny — `debounce`/`throttle` are dependency-free; only\n * `debouncedSignal` pulls in signals (no render core).\n */\nimport { effect, type ReadonlySignal, signal } from './reactive.js';\n\n/** A debounced function: call it like the original, plus `cancel()` / `flush()`. */\nexport interface Debounced<A extends unknown[]> {\n  (...args: A): void;\n  /** Drop any pending trailing call without invoking it. */\n  cancel(): void;\n  /** Invoke the pending trailing call now (if any) and clear the timer. */\n  flush(): void;\n}\n\n/** A throttled function: call it like the original, plus `cancel()` / `flush()`. */\nexport interface Throttled<A extends unknown[]> {\n  (...args: A): void;\n  /** Drop any pending trailing call and reset the rate window, including from inside `fn`. */\n  cancel(): void;\n  /** Invoke the pending trailing call now (if any). */\n  flush(): void;\n}\n\n/**\n * Trailing-edge debounce: `fn` runs `ms` after calls STOP, with the most recent\n * arguments. Every call within the quiet window resets the timer. `cancel()`\n * drops a pending call; `flush()` runs it immediately.\n */\nexport function debounce<A extends unknown[]>(fn: (...args: A) => void, ms: number): Debounced<A> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let lastArgs: A | undefined;\n\n  const invoke = (): void => {\n    timer = undefined;\n    const args = lastArgs as A;\n    lastArgs = undefined;\n    fn(...args);\n  };\n\n  const debounced = ((...args: A): void => {\n    lastArgs = args;\n    if (timer !== undefined) clearTimeout(timer);\n    timer = setTimeout(invoke, ms);\n  }) as Debounced<A>;\n\n  debounced.cancel = (): void => {\n    if (timer !== undefined) clearTimeout(timer);\n    timer = undefined;\n    lastArgs = undefined;\n  };\n\n  debounced.flush = (): void => {\n    if (timer !== undefined) {\n      clearTimeout(timer);\n      invoke();\n    }\n  };\n\n  return debounced;\n}\n\n/**\n * Leading-plus-trailing throttle: `fn` runs immediately on the first call, then\n * at most once per `ms`. Calls during a cooldown collapse to a single trailing\n * call at the window's end (with the latest arguments). `cancel()` drops a\n * pending trailing call and resets the window, even when called by a leading\n * or trailing callback; `flush()` runs a pending trailing call now.\n */\nexport function throttle<A extends unknown[]>(fn: (...args: A) => void, ms: number): Throttled<A> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let trailingArgs: A | undefined;\n\n  const runTrailing = (): void => {\n    const args = trailingArgs as A;\n    trailingArgs = undefined;\n    fn(...args);\n  };\n\n  const startCooldown = (): void => {\n    timer = setTimeout(() => {\n      timer = undefined;\n      if (trailingArgs !== undefined) {\n        // Install the next window before invoking user code. A trailing\n        // callback can therefore cancel that window, and reentrant calls stay\n        // throttled unless the callback explicitly resets it first.\n        startCooldown();\n        runTrailing();\n      }\n    }, ms);\n  };\n\n  const throttled = ((...args: A): void => {\n    if (timer === undefined) {\n      // Make the pending window visible before invoking user code so\n      // `cancel()` from inside a leading callback remains effective.\n      startCooldown();\n      fn(...args); // leading edge\n    } else {\n      trailingArgs = args; // collapse into one trailing call\n    }\n  }) as Throttled<A>;\n\n  throttled.cancel = (): void => {\n    if (timer !== undefined) clearTimeout(timer);\n    timer = undefined;\n    trailingArgs = undefined;\n  };\n\n  throttled.flush = (): void => {\n    if (trailingArgs !== undefined) runTrailing();\n  };\n\n  return throttled;\n}\n\n/**\n * A read-only signal that trails `source` by `ms` (trailing-edge). Writes to\n * `source` reschedule; the derived value updates once writes go quiet, so it\n * composes with `computed()`/`effect()`/`mount()` like any signal.\n *\n * Holds a live subscription to `source` for its lifetime (like a module-scope\n * `effect`) — intended for app-lifetime signals, not throwaway ones. For a\n * disposable variant, drive your own `effect` with {@link debounce}.\n */\nexport function debouncedSignal<T>(source: ReadonlySignal<T>, ms: number): ReadonlySignal<T> {\n  const out = signal(source.value);\n  const write = debounce((value: T) => {\n    out.value = value;\n  }, ms);\n  effect(() => {\n    write(source.value); // tracks source; reschedules on every change\n  });\n  return out;\n}\n"]}
+{"version":3,"sources":["../src/timing.ts"],"names":[],"mappings":";;;;AA8CO,SAAS,QAAA,CACd,IACA,EAAA,EACc;AACd,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,QAAA;AAEJ,EAAA,MAAM,SAAS,MAAY;AACzB,IAAA,KAAA,GAAQ,MAAA;AACR,IAAA,MAAM,IAAA,GAAO,QAAA;AACb,IAAA,QAAA,GAAW,MAAA;AACX,IAAA,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,EACZ,CAAA;AAEA,EAAA,MAAM,SAAA,IAAa,IAAI,IAAA,KAAkB;AACvC,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAC3C,IAAA,KAAA,GAAQ,UAAA,CAAW,QAAQ,EAAE,CAAA;AAAA,EAC/B,CAAA,CAAA;AAEA,EAAA,SAAA,CAAU,SAAS,MAAY;AAC7B,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAC3C,IAAA,KAAA,GAAQ,MAAA;AACR,IAAA,QAAA,GAAW,MAAA;AAAA,EACb,CAAA;AAEA,EAAA,SAAA,CAAU,QAAQ,MAAY;AAC5B,IAAA,IAAI,UAAU,MAAA,EAAW;AACvB,MAAA,YAAA,CAAa,KAAK,CAAA;AAClB,MAAA,MAAA,EAAO;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,SAAA;AACT;AASO,SAAS,QAAA,CACd,IACA,EAAA,EACc;AACd,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,YAAA;AAEJ,EAAA,MAAM,cAAc,MAAY;AAC9B,IAAA,MAAM,IAAA,GAAO,YAAA;AACb,IAAA,YAAA,GAAe,MAAA;AACf,IAAA,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,EACZ,CAAA;AAEA,EAAA,MAAM,gBAAgB,MAAY;AAChC,IAAA,KAAA,GAAQ,WAAW,MAAM;AACvB,MAAA,KAAA,GAAQ,MAAA;AACR,MAAA,IAAI,iBAAiB,MAAA,EAAW;AAI9B,QAAA,aAAA,EAAc;AACd,QAAA,WAAA,EAAY;AAAA,MACd;AAAA,IACF,GAAG,EAAE,CAAA;AAAA,EACP,CAAA;AAEA,EAAA,MAAM,SAAA,IAAa,IAAI,IAAA,KAAkB;AACvC,IAAA,IAAI,UAAU,MAAA,EAAW;AAGvB,MAAA,aAAA,EAAc;AACd,MAAA,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,IACZ,CAAA,MAAO;AACL,MAAA,YAAA,GAAe,IAAA;AAAA,IACjB;AAAA,EACF,CAAA,CAAA;AAEA,EAAA,SAAA,CAAU,SAAS,MAAY;AAC7B,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,YAAA,CAAa,KAAK,CAAA;AAC3C,IAAA,KAAA,GAAQ,MAAA;AACR,IAAA,YAAA,GAAe,MAAA;AAAA,EACjB,CAAA;AAEA,EAAA,SAAA,CAAU,QAAQ,MAAY;AAC5B,IAAA,IAAI,YAAA,KAAiB,QAAW,WAAA,EAAY;AAAA,EAC9C,CAAA;AAEA,EAAA,OAAO,SAAA;AACT;AAWO,SAAS,eAAA,CACd,QACA,EAAA,EACmB;AACnB,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA;AAC/B,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,CAAC,KAAA,KAAa;AACnC,IAAA,GAAA,CAAI,KAAA,GAAQ,KAAA;AAAA,EACd,GAAG,EAAE,CAAA;AACL,EAAA,MAAA,CAAO,MAAM;AACX,IAAA,KAAA,CAAM,OAAO,KAAK,CAAA;AAAA,EACpB,CAAC,CAAA;AACD,EAAA,OAAO,GAAA;AACT","file":"timing.js","sourcesContent":["/**\n * `kerfjs/timing` — the small timing primitives every app hand-rolls.\n *\n * kerf already replaced most imperative bookkeeping — `delegate` for listeners,\n * `mount`/`effect` for render, `defineStore` for state — but debouncing and\n * throttling still get written by hand as `let timer; clearTimeout(timer);\n * timer = setTimeout(fn, ms)`. This subpath blesses that with disposer-shaped\n * ergonomics (`.cancel()` / `.flush()`), plus `debouncedSignal` so a trailing\n * value composes inside the reactive graph instead of beside it.\n *\n *   import { debounce, throttle, debouncedSignal } from 'kerfjs/timing';\n *\n *   const save = debounce(() => persist(state), 300);\n *   input.addEventListener('input', save);   // save.cancel() on teardown\n *\n *   const query = signal('');\n *   const debouncedQuery = debouncedSignal(query, 250); // trails query by 250ms\n *\n * Tree-shakeable and tiny — `debounce`/`throttle` are dependency-free; only\n * `debouncedSignal` pulls in signals (no render core).\n */\nimport { effect, type ReadonlySignal, signal } from './reactive.js';\n\n/** A debounced function: call it like the original, plus `cancel()` / `flush()`. */\nexport interface Debounced<A extends unknown[]> {\n  (...args: A): void;\n  /** Drop any pending trailing call without invoking it. */\n  cancel(): void;\n  /** Invoke the pending trailing call now (if any) and clear the timer. */\n  flush(): void;\n}\n\n/** A throttled function: call it like the original, plus `cancel()` / `flush()`. */\nexport interface Throttled<A extends unknown[]> {\n  (...args: A): void;\n  /** Drop any pending trailing call and reset the rate window, including from inside `fn`. */\n  cancel(): void;\n  /** Invoke the pending trailing call now (if any). */\n  flush(): void;\n}\n\n/**\n * Trailing-edge debounce: `fn` runs `ms` after calls STOP, with the most recent\n * arguments. Every call within the quiet window resets the timer. `cancel()`\n * drops a pending call; `flush()` runs it immediately.\n */\nexport function debounce<A extends unknown[]>(\n  fn: (...args: A) => void,\n  ms: number,\n): Debounced<A> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let lastArgs: A | undefined;\n\n  const invoke = (): void => {\n    timer = undefined;\n    const args = lastArgs as A;\n    lastArgs = undefined;\n    fn(...args);\n  };\n\n  const debounced = ((...args: A): void => {\n    lastArgs = args;\n    if (timer !== undefined) clearTimeout(timer);\n    timer = setTimeout(invoke, ms);\n  }) as Debounced<A>;\n\n  debounced.cancel = (): void => {\n    if (timer !== undefined) clearTimeout(timer);\n    timer = undefined;\n    lastArgs = undefined;\n  };\n\n  debounced.flush = (): void => {\n    if (timer !== undefined) {\n      clearTimeout(timer);\n      invoke();\n    }\n  };\n\n  return debounced;\n}\n\n/**\n * Leading-plus-trailing throttle: `fn` runs immediately on the first call, then\n * at most once per `ms`. Calls during a cooldown collapse to a single trailing\n * call at the window's end (with the latest arguments). `cancel()` drops a\n * pending trailing call and resets the window, even when called by a leading\n * or trailing callback; `flush()` runs a pending trailing call now.\n */\nexport function throttle<A extends unknown[]>(\n  fn: (...args: A) => void,\n  ms: number,\n): Throttled<A> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let trailingArgs: A | undefined;\n\n  const runTrailing = (): void => {\n    const args = trailingArgs as A;\n    trailingArgs = undefined;\n    fn(...args);\n  };\n\n  const startCooldown = (): void => {\n    timer = setTimeout(() => {\n      timer = undefined;\n      if (trailingArgs !== undefined) {\n        // Install the next window before invoking user code. A trailing\n        // callback can therefore cancel that window, and reentrant calls stay\n        // throttled unless the callback explicitly resets it first.\n        startCooldown();\n        runTrailing();\n      }\n    }, ms);\n  };\n\n  const throttled = ((...args: A): void => {\n    if (timer === undefined) {\n      // Make the pending window visible before invoking user code so\n      // `cancel()` from inside a leading callback remains effective.\n      startCooldown();\n      fn(...args); // leading edge\n    } else {\n      trailingArgs = args; // collapse into one trailing call\n    }\n  }) as Throttled<A>;\n\n  throttled.cancel = (): void => {\n    if (timer !== undefined) clearTimeout(timer);\n    timer = undefined;\n    trailingArgs = undefined;\n  };\n\n  throttled.flush = (): void => {\n    if (trailingArgs !== undefined) runTrailing();\n  };\n\n  return throttled;\n}\n\n/**\n * A read-only signal that trails `source` by `ms` (trailing-edge). Writes to\n * `source` reschedule; the derived value updates once writes go quiet, so it\n * composes with `computed()`/`effect()`/`mount()` like any signal.\n *\n * Holds a live subscription to `source` for its lifetime (like a module-scope\n * `effect`) — intended for app-lifetime signals, not throwaway ones. For a\n * disposable variant, drive your own `effect` with {@link debounce}.\n */\nexport function debouncedSignal<T>(\n  source: ReadonlySignal<T>,\n  ms: number,\n): ReadonlySignal<T> {\n  const out = signal(source.value);\n  const write = debounce((value: T) => {\n    out.value = value;\n  }, ms);\n  effect(() => {\n    write(source.value); // tracks source; reschedules on every change\n  });\n  return out;\n}\n"]}

package/llms.txt

@@ -10,13 +10,17 @@ kerf renders JSX to a structured `SafeHtml` (string for static content; tagged "
 
 ## For AI assistants
 
+- One-step project setup: run `npx kerfjs setup` for a safe dry-run, then
+  `npx kerfjs setup --write --yes`; see
+  [AI-first setup](https://github.com/brianwestphal/kerf/blob/main/docs/24-ai-first-setup.md).
+
 - [AI usage guide](https://github.com/brianwestphal/kerf/blob/main/docs/ai/usage-guide.md): when to recommend kerf, the full public API, the four core patterns, hard rules, and a common-errors table.
 - [Code summary](https://github.com/brianwestphal/kerf/blob/main/docs/ai/code-summary.md): directory tree + reverse index of every public export.
 - [Requirements summary](https://github.com/brianwestphal/kerf/blob/main/docs/ai/requirements-summary.md): synthesized view of the numbered design docs.
 - [`kerf.cursorrules`](https://github.com/brianwestphal/kerf/blob/main/kerf.cursorrules): drop-in [Cursor](https://cursor.sh) rules for projects that import `kerfjs`. Copy into your project as `.cursorrules` — or use the bundled mirror at `node_modules/kerfjs/ai/cursorrules` once you've `npm install`ed kerfjs.
 - [`kerf.claude-skill.md`](https://github.com/brianwestphal/kerf/blob/main/kerf.claude-skill.md): drop-in [Claude Code](https://claude.com/claude-code) skill. Copy into `~/.claude/skills/kerf-app/SKILL.md` (or your project's `.claude/skills/kerf-app/SKILL.md`) — or use the bundled mirror at `node_modules/kerfjs/ai/skill.md` once you've `npm install`ed kerfjs.
 - [`eslint-plugin-kerfjs`](https://github.com/brianwestphal/kerf/blob/main/eslint-plugin/README.md): companion ESLint plugin enforcing the hard rules at edit time — eight rules: `no-inline-jsx-event-handlers`, `require-data-key-in-each`, `no-nested-mount`, `prefer-module-jsx-augmentation` (error) plus `require-delegate-disposer`, `prefer-attr-selector`, `no-raw-with-dynamic-arg`, `ai-assistant-configs` (warn). AST-only, no `parserServices` dependency. Install with `npm install --save-dev eslint-plugin-kerfjs` and add `kerfjs.configs.recommended` to your eslint config. Recommended when authoring kerf code with an AI assistant — eslint feedback surfaces in the IDE before `tsc` or runtime warns ever run.
-- [`create-kerf-component`](https://github.com/brianwestphal/kerf/blob/main/create-kerf-component/README.md): companion initializer that scaffolds a publishable kerf component package with the hard packaging rules already wired (kerfjs as a peer dependency + `external` in the build, ESM + `.d.ts`, `jsxImportSource: "kerfjs"`, subpath exports) plus an example component (per-instance state via a factory, a `wire(root)` delegation disposer). Run `npm create kerf-component@latest <dir>`.
+- [`create-kerf-component`](https://github.com/brianwestphal/kerf/blob/main/create-kerf-component/README.md): companion initializer that scaffolds a publishable kerf component package with the hard packaging rules, an example component, and explicit `kerf.components.json` source metadata plus deterministic `component-catalog-v2.json` generation/checking. Run `npm create kerf-component@latest <dir>`.
 - [`@kerfjs/ui` AI guide](https://github.com/brianwestphal/kerf/blob/main/ui/ai/skill.md): component-selection, styling, accessibility, and event-wiring contract for the optional first-party UI package.
 
 ## Reference docs
@@ -34,7 +38,7 @@ kerf renders JSX to a structured `SafeHtml` (string for static content; tagged "
 - [Dev-mode warnings](https://github.com/brianwestphal/kerf/blob/main/docs/11-dev-warnings.md): the opt-in, switch-gated `KERF_DEV_WARN_*` family (environment variables in Node/CI or `enableWarnings()` in browser builds), plus the always-on dev guards and `KERF_DEV_INVARIANTS` structural checks; diagnostics are installed through `kerfjs/dev`, never inferred from the environment.
 - [AI-assistant configs](https://github.com/brianwestphal/kerf/blob/main/docs/12-ai-assistant-configs.md): how the drop-in Claude Code skill + Cursor rules ship inside the `kerfjs` npm package at `ai/skill.md` / `ai/cursorrules` / `ai/manifest.json`, the version + marker contract for customization preservation, and the `kerfjs/ai-assistant-configs` ESLint rule that surfaces drift on every lint pass.
 - [Component packages](https://github.com/brianwestphal/kerf/blob/main/docs/13-component-packages.md): building and publishing reusable kerf components as npm packages — the no-instance component model, per-instance state via factories, event/cleanup patterns, and `kerfjs`-as-peer-dependency packaging modeled on `eslint-plugin-kerfjs`. Scaffold one with `npm create kerf-component@latest <dir>` (the `create-kerf-component` initializer).
-- [Feature coverage](https://github.com/brianwestphal/kerf/blob/main/docs/14-feature-coverage.md): the per-behavior coverage axis orthogonal to line coverage — an index mapping each behavior (especially list-reconciler *state transitions*) to its guarding test, enforced by `npm run check:features`.
+- [Feature coverage](https://github.com/brianwestphal/kerf/blob/main/docs/14-feature-coverage.md): the per-behavior coverage axis orthogonal to line coverage — an index mapping each behavior (especially list-reconciler _state transitions_) to its guarding test, enforced by `npm run check:features`.
 - [No-build example](https://github.com/brianwestphal/kerf/blob/main/docs/15-no-build-example.md): the served-as-source `live-poll` example app — plain JS + importmap + the `html` tagged template, zero tooling — and the vendor-copy contract that ships it.
 - [List identity](https://github.com/brianwestphal/kerf/blob/main/docs/16-list-identity.md): why an `each()` list's call-order identity is not stable, what the source guard fixes and what it doesn't, the five constraints any scheme must survive, and the explicit-key recommendation now shipped as `each(items, render, { key })`.
 - [List virtualization](https://github.com/brianwestphal/kerf/blob/main/docs/17-list-virtualization.md): `bindList`'s virtualization — the `window` (default) height models (fixed `number`, app-declared `(item, index) => number`, and measured `{ estimate }` + `setHeight`) with kerf owning the cumulative-offset math and scroll anchoring while the app owns measurement (the `observeRowHeights` helper), the `minRows` render-all threshold and container/resize ergonomics, and the `content-visibility` mode that keeps every row in the DOM (full find-in-page / a11y) while the browser skips off-screen layout, plus the findability/a11y tradeoff of the default `window` mode.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kerfjs",
-  "version": "5.0.0-beta.4",
+  "version": "5.0.0-beta.41",
   "description": "Tiny reactive UI framework — fine-grained signals + DOM morphing + JSX. Apply the smallest possible cut to update your DOM.",
   "type": "module",
   "sideEffects": [
@@ -35,6 +35,9 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "kerfjs": "./setup/cli.mjs"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -100,11 +103,17 @@
       "types": "./dist/attach.d.ts",
       "import": "./dist/attach.js"
     },
-    "./ai/*": "./ai/*"
+    "./ai/*": "./ai/*",
+    "./setup": {
+      "types": "./setup/index.d.mts",
+      "import": "./setup/index.mjs"
+    },
+    "./setup/state.schema.json": "./setup/state.schema.json"
   },
   "files": [
     "dist",
     "ai",
+    "setup",
     "llms.txt",
     "README.md",
     "CHANGELOG.md",
@@ -120,15 +129,20 @@
     "test:dist": "npm run build && vitest run --config vitest.config.dist.ts",
     "test:dist:full": "npm run build && vitest run --config vitest.config.dist-full.ts",
     "test:dist:jsx-typing": "npm run build && node node_modules/typescript7/bin/tsc -p tests/dist/jsx-typing/tsconfig.json",
+    "test:packed:jsx-typing": "npm run build && node scripts/check-packed-jsx-typing.mjs",
     "test:dist:examples": "npm run build && node node_modules/typescript7/bin/tsc -p site/src/examples/complete/tsconfig.json",
     "test:dist:scaffold-typing": "npm run build && node node_modules/typescript7/bin/tsc -p tests/dist/scaffold-typing/tsconfig.json",
     "test:browser": "npm run build && playwright test",
     "test:ui": "npm --prefix ui test",
     "bench:micro": "vitest bench --run --config vitest.config.bench.ts",
     "bench:serve": "bash bench/site.sh",
-    "lint": "eslint src tests",
+    "format": "prettier --write . --ignore-unknown",
+    "format:check": "prettier --check . --ignore-unknown",
+    "lint:eslint": "eslint src tests",
+    "lint": "npm run lint:eslint && npm run format:check",
     "typecheck": "node node_modules/typescript7/bin/tsc --noEmit",
-    "check": "npm run lint && npm run typecheck && node scripts/check-doc-test-inventory.mjs && node scripts/check-doc-api-coverage.mjs && node scripts/check-doc-site-tickets.mjs && node scripts/check-cdn-versions.mjs && node scripts/check-dev-warn-docs.mjs && node scripts/check-skill-freshness.mjs && node scripts/check-design-rule-5.mjs && node scripts/check-feature-coverage.mjs && node scripts/sync-lockstep-versions.mjs --check && node scripts/check-ai-bundle.mjs && npm test && npm run build && node scripts/check-bundle-size.mjs && node scripts/check-doc-api-signatures.mjs && vitest run --config vitest.config.dist.ts && vitest run --config vitest.config.dist-full.ts && node node_modules/typescript7/bin/tsc -p tests/dist/jsx-typing/tsconfig.json && node node_modules/typescript7/bin/tsc -p site/src/examples/complete/tsconfig.json && node node_modules/typescript7/bin/tsc -p tests/dist/scaffold-typing/tsconfig.json && node scripts/check-docs-examples.mjs",
+    "check": "node scripts/check-guidance-integrity.mjs -- npm run check:core",
+    "check:core": "npm run lint && npm run typecheck && node scripts/check-doc-test-inventory.mjs && node scripts/check-doc-api-coverage.mjs && node scripts/check-doc-site-tickets.mjs && node scripts/check-cdn-versions.mjs && node scripts/check-dev-warn-docs.mjs && node scripts/check-skill-freshness.mjs && node scripts/check-design-rule-5.mjs && node scripts/check-feature-coverage.mjs && node scripts/sync-lockstep-versions.mjs --check && node scripts/sync-scaffold-catalog-schema.mjs --check && node scripts/check-ai-bundle.mjs && npm test && npm run build && node scripts/check-bundle-size.mjs && node scripts/check-doc-api-signatures.mjs && vitest run --config vitest.config.dist.ts && vitest run --config vitest.config.dist-full.ts && node node_modules/typescript7/bin/tsc -p tests/dist/jsx-typing/tsconfig.json && node scripts/check-packed-jsx-typing.mjs && node node_modules/typescript7/bin/tsc -p site/src/examples/complete/tsconfig.json && node node_modules/typescript7/bin/tsc -p tests/dist/scaffold-typing/tsconfig.json && node scripts/check-docs-examples.mjs",
     "check:docs:examples": "node scripts/check-docs-examples.mjs",
     "check:full": "npm run check && npm run --silent check:audit && playwright test",
     "check:ui": "npm --prefix ui run check",
@@ -143,6 +157,8 @@
     "ai-bundle:sync": "node scripts/sync-ai-bundle.mjs",
     "check:lockstep-versions": "node scripts/sync-lockstep-versions.mjs --check",
     "sync:lockstep-versions": "node scripts/sync-lockstep-versions.mjs --write",
+    "check:scaffold-catalog-schema": "node scripts/sync-scaffold-catalog-schema.mjs --check",
+    "sync:scaffold-catalog-schema": "node scripts/sync-scaffold-catalog-schema.mjs --write",
     "clean": "rm -rf dist coverage node_modules/.cache",
     "prepare": "husky",
     "release": "bash scripts/release.sh",
@@ -159,10 +175,13 @@
     "check:skills": "node scripts/check-skill-freshness.mjs",
     "check:design-rule-5": "node scripts/check-design-rule-5.mjs",
     "check:docs:dev-warns": "node scripts/check-dev-warn-docs.mjs",
-    "check:audit": "npm audit --omit=dev --audit-level=high"
+    "check:audit": "npm audit --omit=dev --audit-level=high",
+    "ticket:timing": "node scripts/ticket-timing.mjs"
   },
   "dependencies": {
-    "@preact/signals-core": "^1.14.1"
+    "@preact/signals-core": "^1.14.1",
+    "minimatch": "^9.0.9",
+    "yaml": "^2.9.1"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -172,7 +191,7 @@
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.65.0",
     "@vitest/coverage-v8": "^4.1.11",
-    "domotion-svg": "^0.28.2",
+    "domotion-svg": "^0.30.1",
     "eslint": "^10.8.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "gitgist": "^1.1.0",
@@ -180,11 +199,17 @@
     "http-server": "^14.1.1",
     "husky": "^9.1.7",
     "jsdom": "^29.1.1",
+    "prettier": "^3.9.8",
+    "prettier-plugin-astro": "^1.0.1",
+    "prettier-plugin-sh": "^0.19.0",
     "tsup": "^8.3.0",
     "typescript": "^6.0.3",
     "typescript7": "npm:typescript@^7.0.2",
     "vitest": "^4.1.11"
   },
+  "overrides": {
+    "esbuild": "0.28.2"
+  },
   "gitgist": {
     "exclude": [
       "site/public/demos/*.svg",

package/setup/cli.mjs

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+import console from 'node:console';
+import process from 'node:process';
+
+import { applyKerfSetup, formatSetupPlan, planKerfSetup } from './index.mjs';
+
+const args = process.argv.slice(2);
+const command = args[0] && !args[0].startsWith('-') ? args.shift() : 'setup';
+const take = (name) => {
+  const index = args.indexOf(name);
+  if (index < 0) return undefined;
+  const value = args[index + 1];
+  if (!value || value.startsWith('--'))
+    throw new Error(`${name} requires a value.`);
+  args.splice(index, 2);
+  return value;
+};
+const takeAll = (name) => {
+  const values = [];
+  while (args.includes(name)) values.push(take(name));
+  return values;
+};
+
+try {
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log(`Usage: kerfjs setup [options]
+
+Options:
+  --root <path>       Workspace root (default: current directory)
+  --package <name>    Select a workspace package by name or relative path
+  --core | --ui       Choose a mode when it cannot be detected
+  --resolve <id>=<choice>
+                       Resolve one conflict with keep or kerf (repeatable)
+  --write             Apply the displayed plan (default is dry-run)
+  --yes               Required with --write in non-interactive use
+  --offline           Forbid registry access during dependency installation
+  --no-install        Write configuration without running the package manager`);
+    process.exit(0);
+  }
+  if (command !== 'setup') throw new Error(`Unknown command ${command}.`);
+  const core = args.includes('--core');
+  const ui = args.includes('--ui');
+  if (core && ui) throw new Error('--core and --ui are mutually exclusive.');
+  const write = args.includes('--write');
+  const yes = args.includes('--yes');
+  const offline = args.includes('--offline');
+  const noInstall = args.includes('--no-install');
+  const root = take('--root');
+  const packageSelector = take('--package');
+  const resolutions = {};
+  for (const entry of takeAll('--resolve')) {
+    const index = entry.lastIndexOf('=');
+    if (index < 1) throw new Error('--resolve requires <id>=keep|kerf.');
+    const id = entry.slice(0, index);
+    const choice = entry.slice(index + 1);
+    if (id in resolutions && resolutions[id] !== choice)
+      throw new Error(`Conflicting resolutions for ${id}.`);
+    resolutions[id] = choice;
+  }
+  const known = new Set([
+    '--core',
+    '--ui',
+    '--write',
+    '--yes',
+    '--offline',
+    '--no-install',
+  ]);
+  const unknown = args.filter((arg) => !known.has(arg));
+  if (unknown.length)
+    throw new Error(`Unknown arguments: ${unknown.join(' ')}`);
+  const plan = await planKerfSetup({
+    root,
+    package: packageSelector,
+    mode: ui ? 'ui' : core ? 'core' : undefined,
+    resolutions,
+  });
+  console.log(formatSetupPlan(plan));
+  if (plan.conflicts.length) {
+    process.exitCode = 2;
+  } else if (write) {
+    if (!yes)
+      throw new Error('--write requires --yes after reviewing the plan.');
+    await applyKerfSetup(plan, { install: !noInstall, offline });
+    console.log(`Applied ${plan.actions.length} change(s).`);
+  }
+} catch (error) {
+  console.error(`kerfjs setup: ${error.message}`);
+  process.exitCode = 2;
+}

package/setup/index.d.mts

@@ -0,0 +1,37 @@
+export interface SetupConflict {
+  id: string;
+  message: string;
+}
+export interface SetupAction {
+  path: string;
+  absolutePath: string;
+  before: string | null;
+  after: string;
+  kind: string;
+}
+export interface KerfSetupPlan {
+  schemaVersion: 1;
+  root: string;
+  packageRoot: string;
+  packageName: string;
+  packageManager: 'npm' | 'pnpm' | 'yarn';
+  packageManagerVersion?: string;
+  packageManagerVariant?: 'classic' | 'berry';
+  mode: 'core' | 'ui';
+  setupVersion: string;
+  actions: SetupAction[];
+  conflicts: SetupConflict[];
+  generatedPaths: string[];
+}
+export function planKerfSetup(options?: {
+  root?: string;
+  package?: string;
+  mode?: 'core' | 'ui';
+  version?: string;
+  resolutions?: Record<string, 'keep' | 'kerf'>;
+}): Promise<KerfSetupPlan>;
+export function formatSetupPlan(plan: KerfSetupPlan): string;
+export function applyKerfSetup(
+  plan: KerfSetupPlan,
+  options?: { install?: boolean; offline?: boolean; runner?: Function },
+): Promise<{ changed: string[] }>;