@mauroandre/velojs 0.0.36 → 0.0.37

package/README.md

@@ -1314,7 +1314,7 @@ VeloJS ships a backend testing toolkit at `@mauroandre/velojs/testing`. Spin up
 
 ```typescript
 import { createTestApp } from "@mauroandre/velojs/testing";
-import { routes } from "../app/routes.js";
+import routes from "../app/routes.js";
 import { stream_progress } from "../app/Deploy.js";
 import { action_startDeploy } from "../app/Deploy.js";
 

package/dist/client.js

@@ -1,81 +1,92 @@
-import { jsx as c } from "preact/jsx-runtime";
-import { hydrate as j } from "preact";
-import { Router as x, Route as p, Switch as $ } from "wouter-preact";
-const l = (t, e, n) => e ? n && e === "/" ? t || "/" : e.startsWith("/") ? t + e : t + "/" + e : t, b = (t) => t === "" ? "*" : `${t}/*?`, w = (t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), S = (t) => {
-  let e = !1;
-  t.endsWith("/*?") && (t = t.slice(0, -3), e = !0);
-  const n = t.split("/").map((o) => o.startsWith(":") ? "[^/]+" : w(o)).join("/");
-  return e ? `${n}(?:/.*)?` : n;
-}, a = (t, e) => {
+import { jsxs as j, jsx as o } from "preact/jsx-runtime";
+import { hydrate as w } from "preact";
+import { Router as x, Route as a, Switch as $, useLocation as S } from "wouter-preact";
+import { useEffect as b } from "preact/hooks";
+import { registerRoutePatterns as L, syncLocation as W } from "./loader-store.js";
+const s = (t, n, e) => n ? e && n === "/" ? t || "/" : n.startsWith("/") ? t + n : t + "/" + n : t, v = (t) => t === "" ? "*" : `${t}/*?`, E = (t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), M = (t) => {
+  let n = !1;
+  t.endsWith("/*?") && (t = t.slice(0, -3), n = !0);
+  const e = t.split("/").map((c) => c.startsWith(":") ? "[^/]+" : E(c)).join("/");
+  return n ? `${e}(?:/.*)?` : e;
+}, p = (t, n) => {
   if (t.path === "*") return [];
   if (!t.module) {
-    const o = l(e, t.path, !1);
-    return (t.children ?? []).flatMap((i) => a(i, o));
+    const c = s(n, t.path, !1);
+    return (t.children ?? []).flatMap((i) => p(i, c));
   }
   if (!t.children)
-    return [l(e, t.path, !0) || "/"];
+    return [s(n, t.path, !0) || "/"];
   if (t.path)
-    return [`${l(e, t.path, !1)}/*?`];
-  const n = l(e, t.path, !1);
-  return (t.children ?? []).flatMap((o) => a(o, n));
-}, W = (t, e) => {
-  const n = a(t, e);
-  return new RegExp(`^(?:${n.map(S).join("|")})$`);
-}, y = (t) => {
-  for (const e of t) {
-    if (e.path === "*" && e.module) return e.module.Component;
-    if (e.children) {
-      const n = y(e.children);
-      if (n) return n;
+    return [`${s(n, t.path, !1)}/*?`];
+  const e = s(n, t.path, !1);
+  return (t.children ?? []).flatMap((c) => p(c, e));
+}, _ = (t, n) => {
+  const e = p(t, n);
+  return new RegExp(`^(?:${e.map(M).join("|")})$`);
+}, R = (t) => {
+  for (const n of t) {
+    if (n.path === "*" && n.module) return n.module.Component;
+    if (n.children) {
+      const e = R(n.children);
+      if (e) return e;
     }
   }
   return null;
-}, R = (t, e) => e ? [...t, /* @__PURE__ */ c(p, { children: /* @__PURE__ */ c(e, {}) }, "__notfound")] : t, h = (t, e, n, o) => {
+}, y = (t, n) => n ? [...t, /* @__PURE__ */ o(a, { children: /* @__PURE__ */ o(n, {}) }, "__notfound")] : t, h = (t, n, e, c) => {
   const i = [];
   for (let u = 0; u < t.length; u++) {
-    const r = t[u], s = `${o}${u}`;
+    const r = t[u], l = `${c}${u}`;
     if (r.path === "*") continue;
     if (!r.module) {
       if (r.children) {
-        const f = l(e, r.path, !1);
-        i.push(...h(r.children, f, n, `${s}-`));
+        const f = s(n, r.path, !1);
+        i.push(...h(r.children, f, e, `${l}-`));
       }
       continue;
     }
     const d = r.module.Component;
     if (!r.children) {
-      const f = l(e, r.path, !0) || "/";
+      const f = s(n, r.path, !0) || "/";
       i.push(
-        /* @__PURE__ */ c(p, { path: f, children: /* @__PURE__ */ c(d, {}) }, s)
+        /* @__PURE__ */ o(a, { path: f, children: /* @__PURE__ */ o(d, {}) }, l)
       );
       continue;
     }
     if (r.isRoot) {
       i.push(
-        /* @__PURE__ */ c($, { children: R(
-          h(r.children, "", n, `${s}-`),
-          n
-        ) }, s)
+        /* @__PURE__ */ o($, { children: y(
+          h(r.children, "", e, `${l}-`),
+          e
+        ) }, l)
       );
       continue;
     }
-    const m = l(e, r.path, !1), C = r.path ? b(m) : W(r, e);
+    const m = s(n, r.path, !1), C = r.path ? v(m) : _(r, n);
     i.push(
-      /* @__PURE__ */ c(p, { path: C, children: /* @__PURE__ */ c(d, { children: /* @__PURE__ */ c($, { children: R(
-        h(r.children, m, n, `${s}-`),
-        n
-      ) }) }) }, s)
+      /* @__PURE__ */ o(a, { path: C, children: /* @__PURE__ */ o(d, { children: /* @__PURE__ */ o($, { children: y(
+        h(r.children, m, e, `${l}-`),
+        e
+      ) }) }) }, l)
     );
   }
   return i;
-}, v = ({ routes: t }) => {
-  const e = y(t), n = h(t, "", e, "");
-  return /* @__PURE__ */ c(x, { children: n });
-}, q = (t) => {
-  const { routes: e } = t, n = document.querySelector("body");
-  n && j(/* @__PURE__ */ c(v, { routes: e }), n);
+}, g = () => {
+  const [t] = S();
+  return b(() => {
+    W(window.location.pathname);
+  }, [t]), null;
+}, k = ({ routes: t }) => {
+  L(t);
+  const n = R(t), e = h(t, "", n, "");
+  return /* @__PURE__ */ j(x, { children: [
+    /* @__PURE__ */ o(g, {}),
+    e
+  ] });
+}, z = (t) => {
+  const { routes: n } = t, e = document.querySelector("body");
+  e && w(/* @__PURE__ */ o(k, { routes: n }), e);
 };
 export {
-  v as ClientRoutes,
-  q as startClient
+  k as ClientRoutes,
+  z as startClient
 };

package/dist/components.js

@@ -1,56 +1,58 @@
-import { jsx as o, jsxs as p, Fragment as h } from "preact/jsx-runtime";
+import { jsx as o, jsxs as d, Fragment as m } from "preact/jsx-runtime";
 import { useRouter as v, Link as L } from "wouter-preact";
-import { __veloUpdatePending as C } from "./hooks.js";
-function k({ basePath: e, favicon: t = "/favicon.ico" } = {}) {
+import "@preact/signals";
+import "preact/hooks";
+import { __veloUpdatePending as C } from "./loader-store.js";
+function j({ basePath: e, favicon: t = "/favicon.ico" } = {}) {
   const n = process.env.NODE_ENV !== "production";
   e = e || process.env.STATIC_BASE_URL || (process.env.VELO_STATIC ? "/client" : "");
   const r = t === !1 ? void 0 : t.endsWith(".svg") ? "image/svg+xml" : t.endsWith(".png") ? "image/png" : "image/x-icon", i = t !== !1 && /* @__PURE__ */ o("link", { rel: "icon", href: `${e}${t}`, type: r });
   if (n)
-    return /* @__PURE__ */ p(h, { children: [
+    return /* @__PURE__ */ d(m, { children: [
       i,
       /* @__PURE__ */ o("script", { type: "module", src: "/@vite/client" }),
       /* @__PURE__ */ o("script", { type: "module", src: "/__velo_client.js" })
     ] });
   const l = globalThis.__veloClientJs || (typeof __VELO_CLIENT_JS__ < "u" ? __VELO_CLIENT_JS__ : "client.js"), c = globalThis.__veloClientCss || (typeof __VELO_CLIENT_CSS__ < "u" ? __VELO_CLIENT_CSS__ : "client.css");
-  return /* @__PURE__ */ p(h, { children: [
+  return /* @__PURE__ */ d(m, { children: [
     i,
     /* @__PURE__ */ o("link", { rel: "stylesheet", href: `${e}/${c}` }),
     /* @__PURE__ */ o("script", { type: "module", src: `${e}/${l}` })
   ] });
 }
-function $(e, t) {
+function h(e, t) {
   let n = e;
   for (const [r, i] of Object.entries(t))
     n = n.replace(`:${r}`, i);
   return n;
 }
-function O({ to: e, params: t, search: n, absolute: r, ...i }) {
-  const l = typeof e != "string", c = v(), f = l ? e.metadata?.fullPath ?? "/" : e, u = t ? $(f, t) : f, a = n ? `?${new URLSearchParams(n).toString()}` : "", g = `${u}${a}`;
+function I({ to: e, params: t, search: n, absolute: r, ...i }) {
+  const l = typeof e != "string", c = v(), f = l ? e.metadata?.fullPath ?? "/" : e, u = t ? h(f, t) : f, a = n ? `?${new URLSearchParams(n).toString()}` : "", $ = `${u}${a}`;
   if (typeof window < "u" && C.value) {
     let _;
     if (l) {
       const s = e.metadata?.fullPath ?? f;
-      _ = `${t ? $(s, t) : s}${a}`;
+      _ = `${t ? h(s, t) : s}${a}`;
     } else {
       const s = u.replace(/^~/, "");
       _ = `${!u.startsWith("~") && c.base ? c.base : ""}${s}${a}`;
     }
-    const { onClick: d, ...m } = i;
+    const { onClick: p, ...g } = i;
     return /* @__PURE__ */ o(
       "a",
       {
         href: _,
         onClick: (s) => {
-          d && d(s), s.defaultPrevented || (s.preventDefault(), window.location.href = _);
+          p && p(s), s.defaultPrevented || (s.preventDefault(), window.location.href = _);
         },
-        ...m
+        ...g
       }
     );
   }
-  return /* @__PURE__ */ o(L, { to: g, ...i });
+  return /* @__PURE__ */ o(L, { to: $, ...i });
 }
 export {
-  O as Link,
-  k as Scripts,
-  $ as substituteParams
+  I as Link,
+  j as Scripts,
+  h as substituteParams
 };

package/dist/hooks.d.ts

@@ -1,7 +1,8 @@
 import { type Signal } from "@preact/signals";
 import type { EventStream } from "./events.js";
 import type { SocketHandler, SocketStub } from "./sockets.js";
-export declare const __veloUpdatePending: Signal<boolean>;
+import { __veloUpdatePending } from "./loader-store.js";
+export { __veloUpdatePending };
 /**
  * Força o signal a notificar mudanças após mutação de propriedades aninhadas
  *
@@ -36,6 +37,7 @@ export declare function touch<T>(sig: Signal<T | null>): void;
 export declare function Loader<T>(moduleId?: string): {
     data: Signal<T | null>;
     loading: Signal<boolean>;
+    refetch: () => void;
 };
 /**
  * Hook para acessar dados do loader dentro de componentes
@@ -204,4 +206,3 @@ export interface UseSocketApi {
 export declare function useSocket(stub: SocketHandler | SocketStub | {
     __path: string;
 }, options?: UseSocketOptions): UseSocketApi;
-export {};

package/dist/hooks.js

@@ -1,176 +1,173 @@
-import { signal as g, useSignal as h } from "@preact/signals";
-import { useEffect as D, useRef as E } from "preact/hooks";
-import { useLocation as L, useParams as A } from "wouter-preact";
-const b = g(!1);
-function O(e) {
-  e.value !== null && typeof e.value == "object" && (e.value = { ...e.value });
+import { signal as w, useSignal as c } from "@preact/signals";
+import { useEffect as E, useRef as S } from "preact/hooks";
+import { useLocation as b, useParams as A } from "wouter-preact";
+import { refetchModule as m, loaderLoading as L, loaderEntry as N } from "./loader-store.js";
+import { __veloUpdatePending as Q } from "./loader-store.js";
+function R(e) {
+  const n = e.value;
+  n === null || typeof n != "object" || (e.value = Array.isArray(n) ? [...n] : { ...n });
 }
-function C(e) {
-  const c = g(!1);
-  if (typeof window > "u")
-    return { data: {
+function U(e) {
+  return typeof window > "u" ? {
+    data: {
       get value() {
         return e ? globalThis.__veloServerData?.getStore?.()?.[e] ?? null : null;
       }
-    }, loading: c };
-  const t = window.__PAGE_DATA__, r = e && t?.[e] ? t[e] : null;
-  return { data: g(r), loading: c };
+    },
+    loading: w(!1),
+    refetch: () => {
+    }
+  } : e ? {
+    data: N(e),
+    loading: L(e),
+    refetch: () => m(e)
+  } : { data: w(null), loading: w(!1), refetch: () => {
+  } };
 }
-function U(e, c) {
+function W(e, n) {
   let t, r;
-  Array.isArray(e) ? r = e : (t = e, r = c);
-  let a = null;
-  if (typeof window > "u" && t) {
-    const _ = globalThis.__veloServerData?.getStore?.();
-    _?.[t] && (a = _[t]);
-  }
-  if (typeof window < "u" && t) {
-    const n = window.__PAGE_DATA__;
-    n?.[t] && (a = n[t], delete n[t]);
-  }
-  const o = h(a), s = h(!1), f = () => {
-    if (typeof window > "u" || !t) return;
-    const n = window.location.pathname;
-    s.value = !0;
-    const p = typeof __VELO_STATIC__ < "u" && __VELO_STATIC__ ? `${n === "/" ? "" : n}/index.json` : (() => {
-      const l = new URLSearchParams(window.location.search);
-      return l.set("_data", "1"), `${n}?${l.toString()}`;
-    })();
-    fetch(p, { cache: "no-cache" }).then((l) => l.json()).then((l) => {
-      typeof __VELO_BUILD_HASH__ < "u" && l.__buildHash && l.__buildHash !== __VELO_BUILD_HASH__ && (b.value = !0), o.value = l[t], s.value = !1;
-    }).catch(() => {
-      s.value = !1;
-    });
-  }, y = E(a !== null);
-  return D(() => {
-    if (y.current) {
-      y.current = !1;
-      return;
+  if (Array.isArray(e) ? r = e : (t = e, r = n), typeof window > "u") {
+    let _ = null;
+    if (t) {
+      const h = globalThis.__veloServerData?.getStore?.();
+      h?.[t] && (_ = h[t]);
     }
-    f();
-  }, r ?? []), { data: o, loading: s, refetch: f };
+    return {
+      data: c(_),
+      loading: c(!1),
+      refetch: () => {
+      }
+    };
+  }
+  if (!t)
+    return { data: c(null), loading: c(!1), refetch: () => {
+    } };
+  const a = N(t), o = L(t), u = () => m(t), d = S(!0);
+  return E(() => {
+    d.current && (d.current = !1, a.value !== null) || u();
+  }, r ?? []), { data: a, loading: o, refetch: u };
 }
-function k() {
-  const [, e] = L();
+function q() {
+  const [, e] = b();
   return e;
 }
-function H() {
+function j() {
   return typeof window > "u" ? globalThis.__veloServerData?.getStore?.()?.__params ?? {} : A();
 }
-function R() {
+function G() {
   if (typeof window > "u")
     return globalThis.__veloServerData?.getStore?.()?.__query ?? {};
   const e = window.__PAGE_DATA__;
   if (e?.__query)
     return e.__query;
-  const c = new URLSearchParams(window.location.search), t = {};
-  return c.forEach((r, a) => {
+  const n = new URLSearchParams(window.location.search), t = {};
+  return n.forEach((r, a) => {
     t[a] = r;
   }), t;
 }
-function G() {
-  return typeof window > "u" ? globalThis.__veloServerData?.getStore?.()?.__pathname ?? "/" : (L(), window.location.pathname);
+function J() {
+  return typeof window > "u" ? globalThis.__veloServerData?.getStore?.()?.__pathname ?? "/" : (b(), window.location.pathname);
 }
-function W(e, c = {}) {
-  const t = h(null), r = h(null), a = h(!1), o = h(null), { channel: s, enabled: f = !0 } = c;
-  return D(() => {
-    if (typeof window > "u" || !f) return;
+function M(e, n = {}) {
+  const t = c(null), r = c(null), a = c(!1), o = c(null), { channel: u, enabled: d = !0 } = n;
+  return E(() => {
+    if (typeof window > "u" || !d) return;
     if (!e.__path) {
       console.warn("[velojs] useEventStream: stream has no __path");
       return;
     }
     t.value = null, r.value = null, a.value = !1, o.value = null;
-    const y = s ? `${e.__path}?channel=${encodeURIComponent(s)}` : e.__path, n = new EventSource(y);
-    return n.addEventListener("snapshot", (_) => {
+    const _ = u ? `${e.__path}?channel=${encodeURIComponent(u)}` : e.__path, s = new EventSource(_);
+    return s.addEventListener("snapshot", (h) => {
       try {
-        r.value = JSON.parse(_.data);
-      } catch (p) {
-        o.value = p;
+        r.value = JSON.parse(h.data);
+      } catch (y) {
+        o.value = y;
       }
-    }), n.addEventListener("message", (_) => {
+    }), s.addEventListener("message", (h) => {
       try {
-        t.value = JSON.parse(_.data);
-      } catch (p) {
-        o.value = p;
+        t.value = JSON.parse(h.data);
+      } catch (y) {
+        o.value = y;
       }
-    }), n.addEventListener("heartbeat", () => {
-    }), n.addEventListener("close", () => {
-      a.value = !0, n.close();
-    }), n.addEventListener("error", () => {
-      n.readyState === EventSource.CLOSED && (a.value = !0);
+    }), s.addEventListener("heartbeat", () => {
+    }), s.addEventListener("close", () => {
+      a.value = !0, s.close();
+    }), s.addEventListener("error", () => {
+      s.readyState === EventSource.CLOSED && (a.value = !0);
     }), () => {
-      n.close();
+      s.close();
     };
-  }, [e, s, f]), { data: t, snapshot: r, closed: a, error: o };
+  }, [e, u, d]), { data: t, snapshot: r, closed: a, error: o };
 }
-function q(e, c = {}) {
-  const t = h("connecting"), r = h(null), a = h(null), o = E(null), s = E([]), { channel: f, onMessage: y, onOpen: n, onClose: _, onError: p, enabled: l = !0 } = c;
-  return D(() => {
-    if (typeof window > "u" || !l) return;
+function x(e, n = {}) {
+  const t = c("connecting"), r = c(null), a = c(null), o = S(null), u = S([]), { channel: d, onMessage: _, onOpen: s, onClose: h, onError: y, enabled: D = !0 } = n;
+  return E(() => {
+    if (typeof window > "u" || !D) return;
     if (!e.__path) {
       console.warn("[velojs] useSocket: stub has no __path");
       return;
     }
     t.value = "connecting", r.value = null, a.value = null;
-    const v = `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}`, i = f ? `${v}${e.__path}?channel=${encodeURIComponent(f)}` : `${v}${e.__path}`, d = new WebSocket(i);
-    return d.binaryType = "arraybuffer", o.current = d, d.addEventListener("open", () => {
+    const v = `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}`, i = d ? `${v}${e.__path}?channel=${encodeURIComponent(d)}` : `${v}${e.__path}`, f = new WebSocket(i);
+    return f.binaryType = "arraybuffer", o.current = f, f.addEventListener("open", () => {
       t.value = "open";
-      const u = s.current;
-      s.current = [];
-      for (const S of u)
+      const l = u.current;
+      u.current = [];
+      for (const g of l)
         try {
-          d.send(S);
+          f.send(g);
         } catch {
         }
-      n?.();
-    }), d.addEventListener("message", (u) => {
-      let S;
-      if (typeof u.data == "string")
-        S = u.data;
-      else if (u.data instanceof ArrayBuffer)
-        S = new Uint8Array(u.data);
+      s?.();
+    }), f.addEventListener("message", (l) => {
+      let g;
+      if (typeof l.data == "string")
+        g = l.data;
+      else if (l.data instanceof ArrayBuffer)
+        g = new Uint8Array(l.data);
       else
         return;
-      r.value = S, y?.(S);
-    }), d.addEventListener("close", (u) => {
-      t.value = "closed", o.current = null, _?.(u);
-    }), d.addEventListener("error", (u) => {
-      a.value = u, p?.(u);
+      r.value = g, _?.(g);
+    }), f.addEventListener("close", (l) => {
+      t.value = "closed", o.current = null, h?.(l);
+    }), f.addEventListener("error", (l) => {
+      a.value = l, y?.(l);
     }), () => {
       o.current = null;
       try {
-        (d.readyState === WebSocket.OPEN || d.readyState === WebSocket.CONNECTING) && d.close();
+        (f.readyState === WebSocket.OPEN || f.readyState === WebSocket.CONNECTING) && f.close();
       } catch {
       }
     };
-  }, [e.__path, f, l]), { send: (w) => {
+  }, [e.__path, d, D]), { send: (p) => {
     let v;
-    typeof w == "string" || w instanceof Uint8Array ? v = w : v = JSON.stringify(w);
+    typeof p == "string" || p instanceof Uint8Array ? v = p : v = JSON.stringify(p);
     const i = o.current;
     if (i && i.readyState === WebSocket.OPEN)
       try {
         i.send(v);
       } catch {
       }
-    else i && i.readyState === WebSocket.CONNECTING && s.current.push(v);
-  }, close: (w, v) => {
+    else i && i.readyState === WebSocket.CONNECTING && u.current.push(v);
+  }, close: (p, v) => {
     const i = o.current;
     if (i)
       try {
-        i.close(w, v);
+        i.close(p, v);
       } catch {
       }
   }, status: t, lastMessage: r, error: a };
 }
 export {
-  C as Loader,
-  b as __veloUpdatePending,
-  O as touch,
-  W as useEventStream,
-  U as useLoader,
-  k as useNavigate,
-  H as useParams,
-  G as usePathname,
-  R as useQuery,
-  q as useSocket
+  U as Loader,
+  Q as __veloUpdatePending,
+  R as touch,
+  M as useEventStream,
+  W as useLoader,
+  q as useNavigate,
+  j as useParams,
+  J as usePathname,
+  G as useQuery,
+  x as useSocket
 };

package/dist/loader-store.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Client-side loader store.
+ *
+ * One signal per moduleId, shared by `Loader()` (import phase — the handle other
+ * modules import) and `useLoader()` (render phase — the driver with deps). A
+ * layout's data and a child's read of it are therefore the same instance, with
+ * no module-scope mirror to keep in sync.
+ *
+ * Invalidation follows the route tree: an entry is stale when the params its own
+ * route declares have changed. That is what the server already does — a loader
+ * re-runs when a request arrives with different params — so the client stops
+ * making the author restate it in `useLoader([params.id])`.
+ *
+ * Deliberately NOT invalidated by:
+ *  - a query-string change: `routes.tsx` declares path params, never `?x=`, so
+ *    there is nothing for the framework to read. Use `useLoader([query.x])`.
+ *  - another module's fetch: a `?_data=1` response carries every matched
+ *    module's data, but writing all of it would clobber entries the client owns
+ *    locally (a filtered list, an optimistic mutation). Only the entries this
+ *    store decided were stale are written.
+ *
+ * Server-side this module is inert: `Loader` reads AsyncLocalStorage directly.
+ */
+import { type Signal } from "@preact/signals";
+import type { AppRoutes } from "./types.js";
+/** Set when the server reports a newer build than the one running. */
+export declare const __veloUpdatePending: Signal<boolean>;
+export declare function loaderEntry<T>(moduleId: string): Signal<T | null>;
+export declare function loaderLoading(moduleId: string): Signal<boolean>;
+/** Walk the route tree once, recording each module's declared route pattern. */
+export declare function registerRoutePatterns(routes: AppRoutes): void;
+/**
+ * Extract the params a pattern declares from a pathname. Layout patterns are
+ * prefixes of the URL (`/x/:id` covers `/x/1/tab`), mirroring how the client
+ * router matches them, so the match is prefix-tolerant.
+ *
+ * Returns null when the pattern does not cover the pathname at all.
+ */
+export declare function extractParams(pattern: string, pathname: string): Record<string, string> | null;
+/**
+ * Called on every client navigation. Refetches exactly the entries whose
+ * declared params changed, in one coalesced request.
+ */
+export declare function syncLocation(pathname: string): void;
+/** Explicit refresh. Never coalesced: a caller asking after a mutation must not
+ *  be handed a response that started before it. */
+export declare function refetchModule(moduleId: string): void;
+/** Test-only. Drops every entry, pattern and in-flight request. */
+export declare function __resetLoaderStore(): void;