@real-router/solid 0.11.0 → 0.12.0

package/dist/esm/ssr.mjs

@@ -0,0 +1,254 @@
+import { createComponent } from 'solid-js/web';
+import { createSignal, onMount, Show, createContext, useContext, createResource, Suspense } from 'solid-js';
+
+/**
+ * Returns a boolean accessor that is `false` during initial render (SSR
+ * and the first client paint) and flips to `true` once the component
+ * has mounted in the browser.
+ *
+ * Solid guarantees that `onMount` does NOT fire during `renderToString` /
+ * `renderToStream`, so the accessor stays `false` server-side — this is
+ * the building block for SSR boundary components (`<ClientOnly>` /
+ * `<ServerOnly>`).
+ *
+ * Consolidates the identical `createSignal(false) + onMount(setMounted)`
+ * pattern across the two boundary components (§8a Q15).
+ */
+function createMountedSignal() {
+  const [mounted, setMounted] = createSignal(false);
+  onMount(() => {
+    setMounted(true);
+  });
+  return mounted;
+}
+
+function ClientOnly(props) {
+  const mounted = createMountedSignal();
+  return createComponent(Show, {
+    get when() {
+      return mounted();
+    },
+    get fallback() {
+      return props.fallback;
+    },
+    get children() {
+      return props.children;
+    }
+  });
+}
+
+function ServerOnly(props) {
+  const mounted = createMountedSignal();
+  return createComponent(Show, {
+    get when() {
+      return mounted();
+    },
+    get fallback() {
+      return props.children;
+    },
+    get children() {
+      return props.fallback;
+    }
+  });
+}
+
+createContext(null);
+const RouteContext = createContext(null);
+
+const useRoute = () => {
+  const routeSignal = useContext(RouteContext);
+  if (!routeSignal) {
+    throw new Error("useRoute must be used within a RouterProvider");
+  }
+  if (!routeSignal().route) {
+    throw new Error("useRoute called with no active route. Did you forget to await router.start() before rendering, or is the router stopped/disposed?");
+  }
+  return routeSignal;
+};
+
+const NEVER_PROMISE = new Promise(() => {
+  // Intentionally never resolves — surfaces a forever-pending Suspense boundary
+  // when a key is requested that the loader never declared.
+});
+
+/**
+ * Read a deferred promise published by `defer({ deferred: { <key>: Promise } })`
+ * inside an SSR data loader.
+ *
+ * Returns a Solid `Accessor<Promise<T>>` so the value tracks the active route
+ * — re-reading on navigation picks up the new state's deferred map. Wrap with
+ * `<Await name="key">{(value) => …}</Await>` (this package), which builds on
+ * `createResource` + `<Suspense>` for native Solid streaming.
+ *
+ * Returns a forever-pending promise when the key is missing — surfaces
+ * loader/consumer key drift as a visible Suspense fallback rather than a
+ * silent runtime error.
+ */
+function useDeferred(key) {
+  const routeAccessor = useRoute();
+  return () => {
+    const context = routeAccessor().route.context;
+    const deferred = context.ssrDataDeferred;
+    return deferred?.[key] ?? NEVER_PROMISE;
+  };
+}
+
+/**
+ * Reads `useDeferred(name)` and hands the resolved value to the render-prop.
+ * Wraps the deferred promise in `createResource` so Solid's reactivity tracks
+ * resolution and `<Suspense>` gets the standard suspend signal.
+ *
+ * ```tsx
+ * <Streamed fallback={<Spinner />}>
+ *   <Await<Review[]> name="reviews">
+ *     {(reviews) => <ReviewList items={reviews} />}
+ *   </Await>
+ * </Streamed>
+ * ```
+ *
+ * Implementation: returns a Solid accessor (function child) that reads
+ * `resource()` — this both (a) triggers `<Suspense>` suspension while pending
+ * and (b) re-throws on `errored` for the nearest `<ErrorBoundary>` to catch.
+ * The render-prop is gated on `resource.state === "ready"` rather than on
+ * truthiness so falsy resolved values (`0`, `false`, `null`, `""`) still
+ * reach `props.children`.
+ */
+function Await(props) {
+  const promiseAccessor = useDeferred(props.name);
+  const [resource] = createResource(promiseAccessor, promise => promise);
+
+  // The double cast `as unknown as JSX.Element` (audit-2026-05-17 §8a) is
+  // load-bearing: this returns a Solid accessor *function*, not an element
+  // node. `JSX.Element` in Solid is a union that includes function-as-child
+  // for reactive bindings, but the type machinery can't narrow the bare
+  // arrow's signature to that union — going through `unknown` is the
+  // standard escape hatch used elsewhere in solid-router-style adapters.
+  // Removing either cast yields a "Type '() => unknown' is not assignable
+  // to type 'JSX.Element'" error.
+  return () => {
+    const value = resource();
+    if (resource.state !== "ready") {
+      return;
+    }
+    return props.children(value);
+  };
+}
+
+/**
+ * Cross-adapter alias for Solid's `<Suspense fallback={…}>`. Symmetric naming
+ * with the React/Preact/Svelte/Vue/Angular `<Streamed>` components — pick
+ * `<Streamed>` for cross-framework consistency, or use Solid's native
+ * `<Suspense>` directly when team conventions prefer that.
+ *
+ * Solid's `<Suspense>` is a built-in primitive; out-of-order resolution +
+ * splice scripts during `renderToStream` are part of the runtime. See
+ * Solid's SSR docs for the wire-format details.
+ */
+function Streamed(props) {
+  return createComponent(Suspense, {
+    get fallback() {
+      return props.fallback;
+    },
+    get children() {
+      return props.children;
+    }
+  });
+}
+
+const HttpStatusContext = createContext(null);
+function HttpStatusProvider(props) {
+  return createComponent(HttpStatusContext.Provider, {
+    get value() {
+      return props.sink;
+    },
+    get children() {
+      return props.children;
+    }
+  });
+}
+
+/**
+ * Render-time HTTP status declaration. Mount inside a route component (typical
+ * use case: a glob `*` route's NotFound page) when the status is decided by
+ * the rendered tree rather than a loader.
+ *
+ * Writes `code` to the nearest `<HttpStatusProvider>`'s sink during render and
+ * returns `null`. With no provider mounted (the standard client-side case)
+ * the component is a silent no-op — same component tree hydrates without
+ * touching the DOM or warning about mismatches.
+ *
+ * Loader-driven errors (`LoaderNotFound` → 404, `LoaderRedirect` → 30x) keep
+ * working as before; this component covers render-time decisions only.
+ *
+ * Last write wins when several `<HttpStatusCode />` instances mount in the
+ * same render pass — sink reflects the last component that ran.
+ *
+ * ```tsx
+ * // entry-server.tsx
+ * import { renderToString } from "solid-js/web";
+ * import { createHttpStatusSink, HttpStatusProvider } from "@real-router/solid/ssr";
+ *
+ * const sink = createHttpStatusSink();
+ * const html = renderToString(() => (
+ *   <HttpStatusProvider sink={sink}>
+ *     <RouterProvider router={router}>
+ *       <App />
+ *     </RouterProvider>
+ *   </HttpStatusProvider>
+ * ));
+ * response.status(sink.code ?? 200).send(html);
+ * ```
+ *
+ * **Streaming SSR (`renderToStream`):** the response status MUST be sent
+ * before the first body byte flushes. If `<HttpStatusCode />` is mounted
+ * inside a late-resolving `<Suspense>` boundary, the sink write may happen
+ * AFTER the headers are already on the wire — the override is then lost.
+ * Mount the component in the shell (above every `<Suspense>` that could
+ * delay it), or use `renderToStringAsync` (single-shot, awaits all Suspense
+ * before returning HTML).
+ *
+ * **Valid `code` range:** Node's `res.end()` throws `Invalid status code` on
+ * `NaN`, `0`, negative values, or values `> 999` — this surfaces as a 5xx /
+ * dropped connection, not silent corruption. Pass a real HTTP status integer
+ * (commonly 4xx/5xx; 100-999 is what Node accepts).
+ */
+function HttpStatusCode(props) {
+  const sink = useContext(HttpStatusContext);
+  if (sink) {
+    sink.code = props.code;
+  }
+  return null;
+}
+
+/**
+ * Render-scoped HTTP status sink. Created per request on the server, passed to
+ * `<HttpStatusProvider sink={...}>`, and read after `renderToString` /
+ * `renderToStream` to apply the value to the HTTP response.
+ *
+ * Last write wins: if the rendered tree mounts more than one
+ * `<HttpStatusCode />`, the value reflects the last component that ran during
+ * the render pass.
+ *
+ * No-op on the client — `<HttpStatusCode />` reads the optional context and
+ * skips the write when no provider is mounted, so the same component tree can
+ * be hydrated without changing behaviour.
+ *
+ * Constraints:
+ * - **Per-request only.** Don't share a sink across requests; the rendered
+ *   tree mutates `code` in place. Module-level singletons leak status
+ *   between concurrent requests.
+ * - **Don't `Object.freeze` the sink.** The component writes to `.code`;
+ *   freezing makes the assignment throw under ESM strict mode.
+ * - **Hydration symmetry:** mount `<HttpStatusProvider>` on both server and
+ *   client (with a throwaway client sink). Solid emits `data-hk` markers
+ *   per component boundary; an extra provider on one side desyncs the
+ *   counter and breaks the hydration walker.
+ */
+
+function createHttpStatusSink() {
+  return {
+    code: undefined
+  };
+}
+
+export { Await, ClientOnly, HttpStatusCode, HttpStatusProvider, ServerOnly, Streamed, createHttpStatusSink, useDeferred };

package/dist/types/RouterProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouterProvider.d.ts","sourceRoot":"","sources":["../../src/RouterProvider.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAKT;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,CAAC,kBAAkB,CAAC,GACrC,GAAG,CAAC,OAAO,CAuDb"}
+{"version":3,"file":"RouterProvider.d.ts","sourceRoot":"","sources":["../../src/RouterProvider.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAKT;AAwBD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,CAAC,kBAAkB,CAAC,GACrC,GAAG,CAAC,OAAO,CAuCb"}

package/dist/types/components/Await.d.ts

@@ -0,0 +1,30 @@
+import type { JSX } from "solid-js";
+export interface AwaitProps<T> {
+    /** Deferred key declared in the loader's `defer({ deferred: { <name>: ... } })`. */
+    readonly name: string;
+    /** Render the resolved value. Surrounding `<Suspense>` shows fallback while
+     * pending; rejection bubbles through Solid's `<ErrorBoundary>`. */
+    readonly children: (value: T) => JSX.Element;
+}
+/**
+ * Reads `useDeferred(name)` and hands the resolved value to the render-prop.
+ * Wraps the deferred promise in `createResource` so Solid's reactivity tracks
+ * resolution and `<Suspense>` gets the standard suspend signal.
+ *
+ * ```tsx
+ * <Streamed fallback={<Spinner />}>
+ *   <Await<Review[]> name="reviews">
+ *     {(reviews) => <ReviewList items={reviews} />}
+ *   </Await>
+ * </Streamed>
+ * ```
+ *
+ * Implementation: returns a Solid accessor (function child) that reads
+ * `resource()` — this both (a) triggers `<Suspense>` suspension while pending
+ * and (b) re-throws on `errored` for the nearest `<ErrorBoundary>` to catch.
+ * The render-prop is gated on `resource.state === "ready"` rather than on
+ * truthiness so falsy resolved values (`0`, `false`, `null`, `""`) still
+ * reach `props.children`.
+ */
+export declare function Await<T = unknown>(props: AwaitProps<T>): JSX.Element;
+//# sourceMappingURL=Await.d.ts.map

package/dist/types/components/Await.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Await.d.ts","sourceRoot":"","sources":["../../../src/components/Await.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;uEACmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CAqBpE"}

package/dist/types/components/ClientOnly.d.ts

@@ -0,0 +1,7 @@
+import type { JSX } from "solid-js";
+export interface ClientOnlyProps {
+    readonly children: JSX.Element;
+    readonly fallback?: JSX.Element;
+}
+export declare function ClientOnly(props: ClientOnlyProps): JSX.Element;
+//# sourceMappingURL=ClientOnly.d.ts.map

package/dist/types/components/ClientOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientOnly.d.ts","sourceRoot":"","sources":["../../../src/components/ClientOnly.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAQ9D"}

package/dist/types/components/HttpStatusCode.d.ts

@@ -0,0 +1,52 @@
+import type { JSX } from "solid-js";
+export interface HttpStatusCodeProps {
+    /** HTTP status to apply to the response. Common values: 404, 410, 451, 503. */
+    readonly code: number;
+}
+/**
+ * Render-time HTTP status declaration. Mount inside a route component (typical
+ * use case: a glob `*` route's NotFound page) when the status is decided by
+ * the rendered tree rather than a loader.
+ *
+ * Writes `code` to the nearest `<HttpStatusProvider>`'s sink during render and
+ * returns `null`. With no provider mounted (the standard client-side case)
+ * the component is a silent no-op — same component tree hydrates without
+ * touching the DOM or warning about mismatches.
+ *
+ * Loader-driven errors (`LoaderNotFound` → 404, `LoaderRedirect` → 30x) keep
+ * working as before; this component covers render-time decisions only.
+ *
+ * Last write wins when several `<HttpStatusCode />` instances mount in the
+ * same render pass — sink reflects the last component that ran.
+ *
+ * ```tsx
+ * // entry-server.tsx
+ * import { renderToString } from "solid-js/web";
+ * import { createHttpStatusSink, HttpStatusProvider } from "@real-router/solid/ssr";
+ *
+ * const sink = createHttpStatusSink();
+ * const html = renderToString(() => (
+ *   <HttpStatusProvider sink={sink}>
+ *     <RouterProvider router={router}>
+ *       <App />
+ *     </RouterProvider>
+ *   </HttpStatusProvider>
+ * ));
+ * response.status(sink.code ?? 200).send(html);
+ * ```
+ *
+ * **Streaming SSR (`renderToStream`):** the response status MUST be sent
+ * before the first body byte flushes. If `<HttpStatusCode />` is mounted
+ * inside a late-resolving `<Suspense>` boundary, the sink write may happen
+ * AFTER the headers are already on the wire — the override is then lost.
+ * Mount the component in the shell (above every `<Suspense>` that could
+ * delay it), or use `renderToStringAsync` (single-shot, awaits all Suspense
+ * before returning HTML).
+ *
+ * **Valid `code` range:** Node's `res.end()` throws `Invalid status code` on
+ * `NaN`, `0`, negative values, or values `> 999` — this surfaces as a 5xx /
+ * dropped connection, not silent corruption. Pass a real HTTP status integer
+ * (commonly 4xx/5xx; 100-999 is what Node accepts).
+ */
+export declare function HttpStatusCode(props: HttpStatusCodeProps): JSX.Element;
+//# sourceMappingURL=HttpStatusCode.d.ts.map

package/dist/types/components/HttpStatusCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpStatusCode.d.ts","sourceRoot":"","sources":["../../../src/components/HttpStatusCode.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CAQtE"}

package/dist/types/components/HttpStatusProvider.d.ts

@@ -0,0 +1,9 @@
+import type { HttpStatusSink } from "../utils/createHttpStatusSink";
+import type { JSX } from "solid-js";
+export declare const HttpStatusContext: import("solid-js", { with: { "resolution-mode": "import" } }).Context<HttpStatusSink | null>;
+export interface HttpStatusProviderProps {
+    readonly sink: HttpStatusSink;
+    readonly children: JSX.Element;
+}
+export declare function HttpStatusProvider(props: HttpStatusProviderProps): JSX.Element;
+//# sourceMappingURL=HttpStatusProvider.d.ts.map

package/dist/types/components/HttpStatusProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpStatusProvider.d.ts","sourceRoot":"","sources":["../../../src/components/HttpStatusProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,eAAO,MAAM,iBAAiB,8FAA6C,CAAC;AAE5E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CAChC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,GAAG,CAAC,OAAO,CAMb"}

package/dist/types/components/Link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../src/components/Link.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC5C,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAC5B,GAAG,CAAC,OAAO,CAkHb"}
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../src/components/Link.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC5C,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAC5B,GAAG,CAAC,OAAO,CAwHb"}

package/dist/types/components/RouteView/RouteView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouteView.d.ts","sourceRoot":"","sources":["../../../../src/components/RouteView/RouteView.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAKrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,iBAAS,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,OAAO,CAgCnE;kBAhCQ,aAAa;;;AAoCtB,eAAO,MAAM,SAAS;;;;CAIpB,CAAC;AAEH,YAAY,EACV,cAAc,EACd,UAAU,IAAI,mBAAmB,EACjC,SAAS,IAAI,kBAAkB,EAC/B,aAAa,IAAI,sBAAsB,GACxC,MAAM,SAAS,CAAC"}
+{"version":3,"file":"RouteView.d.ts","sourceRoot":"","sources":["../../../../src/components/RouteView/RouteView.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAKrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,iBAAS,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,OAAO,CAiCnE;kBAjCQ,aAAa;;;AAqCtB,eAAO,MAAM,SAAS;;;;CAIpB,CAAC;AAEH,YAAY,EACV,cAAc,EACd,UAAU,IAAI,mBAAmB,EACjC,SAAS,IAAI,kBAAkB,EAC/B,aAAa,IAAI,sBAAsB,GACxC,MAAM,SAAS,CAAC"}

package/dist/types/components/RouteView/components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../../src/components/RouteView/components.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAIpC,eAAO,MAAM,YAAY,eAA4B,CAAC;AAEtD,eAAO,MAAM,WAAW,eAA2B,CAAC;AAEpD,eAAO,MAAM,gBAAgB,eAA+B,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,YAAY,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,gBAAgB,CAAC;IAChC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;AAExE,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,OAAO,CAepD;yBAfe,KAAK;;;AAmBrB,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CAWlD;yBAXe,IAAI;;;AAepB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,OAAO,CAU1D;yBAVe,QAAQ"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../../src/components/RouteView/components.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAIpC,eAAO,MAAM,YAAY,eAA4B,CAAC;AAEtD,eAAO,MAAM,WAAW,eAA2B,CAAC;AAEpD,eAAO,MAAM,gBAAgB,eAA+B,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,YAAY,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,gBAAgB,CAAC;IAChC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;AAgCxE,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,OAAO,CAMpD;yBANe,KAAK;;;AAUrB,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CAIlD;yBAJe,IAAI;;;AAQpB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,OAAO,CAE1D;yBAFe,QAAQ"}

package/dist/types/components/RouteView/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/RouteView/helpers.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,GACb,OAAO,CAMT;AA6BD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,eAAe,EAAE,GACxB,IAAI,CAoBN;AAqCD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,GAAG,CAAC,OAAO,EAAE,CAsCf"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/RouteView/helpers.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,GACb,OAAO,CAMT;AA8BD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,eAAe,EAAE,GACxB,IAAI,CAoBN;AA8HD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,GAAG,CAAC,OAAO,EAAE,CAmEf"}

package/dist/types/components/ServerOnly.d.ts

@@ -0,0 +1,7 @@
+import type { JSX } from "solid-js";
+export interface ServerOnlyProps {
+    readonly children: JSX.Element;
+    readonly fallback?: JSX.Element;
+}
+export declare function ServerOnly(props: ServerOnlyProps): JSX.Element;
+//# sourceMappingURL=ServerOnly.d.ts.map

package/dist/types/components/ServerOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerOnly.d.ts","sourceRoot":"","sources":["../../../src/components/ServerOnly.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAQ9D"}

package/dist/types/components/Streamed.d.ts

@@ -0,0 +1,18 @@
+import type { JSX } from "solid-js";
+export interface StreamedProps {
+    /** Shown while any descendant `<Await>` / `createResource` suspends. */
+    readonly fallback: JSX.Element;
+    readonly children: JSX.Element;
+}
+/**
+ * Cross-adapter alias for Solid's `<Suspense fallback={…}>`. Symmetric naming
+ * with the React/Preact/Svelte/Vue/Angular `<Streamed>` components — pick
+ * `<Streamed>` for cross-framework consistency, or use Solid's native
+ * `<Suspense>` directly when team conventions prefer that.
+ *
+ * Solid's `<Suspense>` is a built-in primitive; out-of-order resolution +
+ * splice scripts during `renderToStream` are part of the runtime. See
+ * Solid's SSR docs for the wire-format details.
+ */
+export declare function Streamed(props: StreamedProps): JSX.Element;
+//# sourceMappingURL=Streamed.d.ts.map

package/dist/types/components/Streamed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Streamed.d.ts","sourceRoot":"","sources":["../../../src/components/Streamed.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,OAAO,CAE1D"}

package/dist/types/constants.d.ts

@@ -1,9 +1,27 @@
 /**
- * Stable empty object for default params
+ * Stable empty object for default params.
+ *
+ * `Object.freeze` makes mutation throw under ESM strict mode — this guards
+ * against accidental writes that would corrupt the shared default across
+ * every Link without explicit params.
+ *
+ * §8.1 audit note (LOW #19): consumers cast `EMPTY_PARAMS as P` at usage
+ * sites (e.g. `Link.tsx`, `directives/link.tsx`). The cast is required for
+ * type compatibility with the generic `P extends Params` and DOES technically
+ * widen the `Readonly<{}>` type, but the underlying object stays frozen at
+ * runtime — any attempt to mutate fails at the JS engine level regardless
+ * of TS-level visibility. The frozen sentinel is also used by Link's
+ * fast-path identity check (`props.routeParams === undefined` after the
+ * §8.1 audit fix); changing this object's identity would silently break
+ * that path.
  */
 export declare const EMPTY_PARAMS: Readonly<{}>;
 /**
- * Stable empty options object
+ * Stable empty options object.
+ *
+ * Same freeze/cast guarantees as `EMPTY_PARAMS` — the sentinel is shared
+ * across all default `routeOptions` consumers (`Link`, `use:link`) to
+ * avoid per-render `{}` allocations.
  */
 export declare const EMPTY_OPTIONS: Readonly<{}>;
 //# sourceMappingURL=constants.d.ts.map

package/dist/types/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,YAAY,cAAoB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,aAAa,cAAoB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,cAAoB,CAAC;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,cAAoB,CAAC"}

package/dist/types/context.d.ts

@@ -8,4 +8,13 @@ export interface RouterContextValue {
 }
 export declare const RouterContext: import("solid-js", { with: { "resolution-mode": "import" } }).Context<RouterContextValue | null>;
 export declare const RouteContext: import("solid-js", { with: { "resolution-mode": "import" } }).Context<Accessor<RouteState<import("@real-router/core").Params>> | null>;
+/**
+ * Read the required RouterContext or throw a labelled error. Internal helper
+ * — consolidates 4 copies of the same `useContext + null-check + throw`
+ * block across the public hooks/components/directives. The `consumerName`
+ * parameter keeps each callsite's error message specific (so the consumer
+ * sees "useRouter must be used within a RouterProvider", not a generic
+ * "context missing" message).
+ */
+export declare function useRequiredRouterContext(consumerName: string): RouterContextValue;
 //# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C;AAED,eAAO,MAAM,aAAa,kGAAiD,CAAC;AAE5E,eAAO,MAAM,YAAY,wIAAmD,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C;AAED,eAAO,MAAM,aAAa,kGAAiD,CAAC;AAE5E,eAAO,MAAM,YAAY,wIAAmD,CAAC;AAE7E;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GACnB,kBAAkB,CAQpB"}

package/dist/types/createSignalFromSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSignalFromSource.d.ts","sourceRoot":"","sources":["../../src/createSignalFromSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,QAAQ,CAAC,CAAC,CAAC,CAoBb"}
+{"version":3,"file":"createSignalFromSource.d.ts","sourceRoot":"","sources":["../../src/createSignalFromSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,QAAQ,CAAC,CAAC,CAAC,CA+Db"}

package/dist/types/createStoreFromSource.d.ts

@@ -1,3 +1,22 @@
 import type { RouterSource } from "@real-router/sources";
+/**
+ * Bridges a `RouterSource<T>` into a Solid store (`createStore` + `reconcile`).
+ *
+ * Unlike `createSignalFromSource` (whole-value replacement via `===`), this
+ * bridge uses `reconcile` on every emit so **unchanged nested paths retain
+ * their object identity**. Components that read only `state.route.name` will
+ * not re-run when `state.route.params` changes — granular reactivity without
+ * manual memoisation.
+ *
+ * **Ownership**: calls `onCleanup` — must be called inside a reactive owner
+ * (component body or `createRoot`). Same contract as `createSignalFromSource`.
+ *
+ * **Lazy-source re-sync**: after `source.subscribe()`, a cached lazy source
+ * may reconcile its snapshot in `onFirstSubscribe`. The listener is not
+ * notified for that internal update, so we re-read immediately after
+ * subscribing (`setState(reconcile(source.getSnapshot()))`) — mirrors the
+ * same pattern in `createSignalFromSource`. `reconcile` is a no-op when the
+ * snapshot is structurally unchanged, so there is no spurious reactivity cost.
+ */
 export declare function createStoreFromSource<T extends object>(source: RouterSource<T>): T;
 //# sourceMappingURL=createStoreFromSource.d.ts.map

package/dist/types/createStoreFromSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createStoreFromSource.d.ts","sourceRoot":"","sources":["../../src/createStoreFromSource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,CAAC,CAUH"}
+{"version":3,"file":"createStoreFromSource.d.ts","sourceRoot":"","sources":["../../src/createStoreFromSource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,CAAC,CAsCH"}

package/dist/types/directives/link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/directives/link.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC5C,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,oBAAoB,CAAC,CAAC,CAAC,GACtC,IAAI,CA+DN"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/directives/link.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC5C,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,oBAAoB,CAAC,CAAC,CAAC,GACtC,IAAI,CAwFN"}

package/dist/types/dom-utils/__test-helpers/expected-fragment.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Test helper: mirror of `encodeFragmentInline` from `link-utils.ts` used by
+ * property tests in every adapter (`packages/{vue,preact,react,solid}/tests/
+ * property/linkUtils.properties.ts` and `packages/svelte/tests/property/
+ * buildHref.properties.ts`).
+ *
+ * Why a mirror, not an import of the real function: a property test that uses
+ * the production implementation to compute its own expected value is a
+ * tautology — any regression in `encodeFragmentInline` would be invisible.
+ * We hand-roll the same algorithm so the test asserts an independent
+ * derivation. Drift between this mirror and `encodeFragmentInline` is exactly
+ * the signal property tests are supposed to surface.
+ *
+ * This file lives under `__test-helpers/` so the sync-dom-utils script can
+ * exclude it from the Angular copy (it ships no production code), and so
+ * bundlers (tsdown, svelte-package) tree-shake it out — nothing in
+ * `src/index.ts` of any adapter imports from this directory.
+ */
+/**
+ * Compute the expected fragment portion of an href for a given raw hash input.
+ *
+ * Mirrors the contract of `encodeFragmentInline`:
+ *  1. If input contains `%XX`, try `decodeURIComponent` → `encodeURI` (idempotent
+ *     re-encoding so consumers can copy-paste `location.hash` back in without
+ *     `%20` becoming `%2520`).
+ *  2. If `decodeURIComponent` throws (malformed `%XX`), fall through to plain
+ *     `encodeURI` on the original input.
+ *  3. Defensive `#` → `%23` (encodeURI does not encode `#`).
+ */
+export declare function computeExpectedFragment(rawHash: string): string;
+//# sourceMappingURL=expected-fragment.d.ts.map

package/dist/types/dom-utils/__test-helpers/expected-fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expected-fragment.d.ts","sourceRoot":"","sources":["../../../../src/dom-utils/__test-helpers/expected-fragment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa/D"}

package/dist/types/dom-utils/__test-helpers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Test-only barrel. Intentionally NOT re-exported from
+ * `shared/dom-utils/index.ts` so the helpers don't leak into adapters'
+ * public API surface. Property tests import from this path directly:
+ *
+ *   import { computeExpectedFragment } from "../../src/dom-utils/__test-helpers";
+ */
+export { computeExpectedFragment } from "./expected-fragment.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/dom-utils/__test-helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dom-utils/__test-helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/dom-utils/link-utils.d.ts

@@ -18,6 +18,29 @@ export declare function buildHref(router: Router, routeName: string, routeParams
 }): string | undefined;
 export declare function navigateWithHash(router: Router, routeName: string, routeParams: Params, hash: string | undefined, extraOptions?: NavigationOptions): Promise<State>;
 export declare function buildActiveClassName(isActive: boolean, activeClassName: string | undefined, baseClassName: string | undefined): string | undefined;
+/**
+ * One-level structural equality using `Object.is` per key.
+ *
+ * **String-keyed properties only (Mini-sprint E.3 — audit-5 §4.2 #3).**
+ * Implementation walks `Object.keys()` which by spec returns only
+ * enumerable own STRING keys. Symbol-keyed properties — created via
+ * `obj[Symbol("brand")] = value` or `{ [Symbol(...)]: value }` — are
+ * NOT compared. Two records that differ only in a Symbol-keyed value
+ * will compare as equal.
+ *
+ * This is intentional: route params and Link options are documented as
+ * string-keyed primitives (string | number | boolean) — Symbol-keyed
+ * metadata (e.g. brand markers, private state) doesn't belong in a
+ * cache-key comparison. Switching to `Reflect.ownKeys()` would extend
+ * the contract to symbols at the cost of one extra allocation per call
+ * (Reflect.ownKeys composes string-keys + symbol-keys arrays). If a
+ * consumer relies on symbol-keyed metadata for navigation
+ * disambiguation, they should encode it into a string key instead.
+ *
+ * Mirrors React's `shallowEqual` (packages/shared/shallowEqual.js) in
+ * both the string-keys-only semantics and the `hasOwnProperty` guard
+ * below.
+ */
 export declare function shallowEqual(prev: object | undefined, next: object | undefined): boolean;
 export declare function applyLinkA11y(element: HTMLElement | null | undefined): void;
 //# sourceMappingURL=link-utils.d.ts.map

package/dist/types/dom-utils/link-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link-utils.d.ts","sourceRoot":"","sources":["../../../src/dom-utils/link-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,KAAK,EACN,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAQvD;AAmBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,MAAM,GAAG,SAAS,CAiCpB;AA4BD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,CAAC,EAAE,iBAAiB,GAC/B,OAAO,CAAC,KAAK,CAAC,CAyBhB;AAMD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EACjB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,MAAM,GAAG,SAAS,CAyBpB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAwBT;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAgB3E"}
+{"version":3,"file":"link-utils.d.ts","sourceRoot":"","sources":["../../../src/dom-utils/link-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,KAAK,EACN,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAQvD;AA8CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,MAAM,GAAG,SAAS,CAsDpB;AA4BD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,CAAC,EAAE,iBAAiB,GAC/B,OAAO,CAAC,KAAK,CAAC,CAyBhB;AA0BD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EACjB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CA8BT;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CA+B3E"}

package/dist/types/dom-utils/route-announcer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-announcer.d.ts","sourceRoot":"","sources":["../../../src/dom-utils/route-announcer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AASvD,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;CAChD;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAsFzB"}
+{"version":3,"file":"route-announcer.d.ts","sourceRoot":"","sources":["../../../src/dom-utils/route-announcer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AASvD,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;CAChD;AAQD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAmGzB"}