@real-router/solid 0.14.2 → 0.14.4

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;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"}
+{"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;AAyBD,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/scroll-spy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-spy.d.ts","sourceRoot":"","sources":["../../../src/dom-utils/scroll-spy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAuaD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,SAAS,CAiMX"}
+{"version":3,"file":"scroll-spy.d.ts","sourceRoot":"","sources":["../../../src/dom-utils/scroll-spy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAwaD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,SAAS,CAiMX"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/solid",
-  "version": "0.14.2",
+  "version": "0.14.4",
   "type": "commonjs",
   "description": "Solid.js integration for Real-Router",
   "main": "./dist/cjs/index.js",
@@ -34,8 +34,7 @@
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "homepage": "https://github.com/greydragon888/real-router",
   "repository": {
@@ -67,9 +66,9 @@
   "license": "MIT",
   "sideEffects": false,
   "dependencies": {
-    "@real-router/core": "^0.56.0",
-    "@real-router/sources": "^0.8.5",
-    "@real-router/route-utils": "^0.2.3"
+    "@real-router/core": "^0.58.0",
+    "@real-router/route-utils": "^0.2.3",
+    "@real-router/sources": "^0.8.7"
   },
   "devDependencies": {
     "@babel/core": "7.29.7",
@@ -82,12 +81,12 @@
     "@testing-library/user-event": "14.6.1",
     "babel-preset-solid": "1.9.12",
     "rimraf": "6.1.3",
-    "rollup": "4.61.1",
+    "rollup": "4.62.0",
     "rollup-plugin-dts": "6.4.1",
     "solid-js": "1.9.13",
     "vite-plugin-solid": "2.11.12",
     "vitest": "4.1.8",
-    "@real-router/browser-plugin": "^0.17.6"
+    "@real-router/browser-plugin": "^0.17.8"
   },
   "peerDependencies": {
     "solid-js": ">=1.7.0"

package/src/RouterProvider.tsx

@@ -1,112 +0,0 @@
-import { getNavigator } from "@real-router/core";
-import { createRouteSource } from "@real-router/sources";
-import { createSelector, onCleanup, onMount } from "solid-js";
-
-import { RouterContext, RouteContext } from "./context";
-import { createSignalFromSource } from "./createSignalFromSource";
-import {
-  createRouteAnnouncer,
-  createScrollRestoration,
-  createScrollSpy,
-  createViewTransitions,
-} from "./dom-utils";
-
-import type { ScrollRestorationOptions, ScrollSpyOptions } from "./dom-utils";
-import type { Router } from "@real-router/core";
-import type { ParentProps, JSX } from "solid-js";
-
-export interface RouteProviderProps {
-  router: Router;
-  announceNavigation?: boolean;
-  scrollRestoration?: ScrollRestorationOptions;
-  scrollSpy?: ScrollSpyOptions;
-  viewTransitions?: boolean;
-}
-
-export function isRouteActive(
-  linkRouteName: string,
-  currentRouteName: string,
-): boolean {
-  return (
-    currentRouteName === linkRouteName ||
-    currentRouteName.startsWith(`${linkRouteName}.`)
-  );
-}
-
-// §8.1 audit fix (LOW) — collapse three identical onMount lifecycle blocks
-// into a single helper. Each opt-in feature has the same shape:
-//   `if (!enabled) return; const handle = create(...); onCleanup(handle.destroy)`.
-// Routing setup through this helper keeps the props.<feature> check + mount
-// side-effect + cleanup wiring in one place.
-function mountFeature(
-  enabled: unknown,
-  factory: () => { destroy: () => void },
-): void {
-  onMount(() => {
-    if (!enabled) {
-      return;
-    }
-
-    const handle = factory();
-
-    onCleanup(() => {
-      handle.destroy();
-    });
-  });
-}
-
-export function RouterProvider(
-  props: ParentProps<RouteProviderProps>,
-): JSX.Element {
-  // Setup vars FIRST (§8.1 audit fix LOW #2 — semantic ordering): the router
-  // subscription wiring is the core of the provider, the opt-in features
-  // below ride on top of it.
-  const navigator = getNavigator(props.router);
-  const routeSource = createRouteSource(props.router);
-  const routeSignal = createSignalFromSource(routeSource);
-
-  const routeSelector = createSelector(
-    // The empty-string sentinel guarantees no Link is "active" while the
-    // router has no route (unstarted / stopped) — `isRouteActive` short-
-    // circuits because no real route name equals or starts with `""` +
-    // dot boundary. Without the sentinel, `routeSignal().route?.name`
-    // would be `undefined` and the selector would compare against
-    // `undefined`, defeating Solid's identity-based change detection.
-    () => routeSignal().route?.name ?? "",
-    isRouteActive,
-  );
-
-  // Opt-in features wired through the shared mountFeature helper.
-  mountFeature(props.announceNavigation, () =>
-    createRouteAnnouncer(props.router),
-  );
-  mountFeature(props.scrollRestoration, () =>
-    createScrollRestoration(props.router, props.scrollRestoration),
-  );
-  onMount(() => {
-    const spyOpts = props.scrollSpy;
-
-    if (spyOpts === undefined || spyOpts.selector === "") {
-      return;
-    }
-
-    const spy = createScrollSpy(props.router, spyOpts);
-
-    onCleanup(() => {
-      spy.destroy();
-    });
-  });
-  mountFeature(props.viewTransitions, () =>
-    createViewTransitions(props.router),
-  );
-
-  return (
-    <RouterContext.Provider
-      value={{ router: props.router, navigator, routeSelector }}
-    >
-      <RouteContext.Provider value={routeSignal}>
-        {props.children}
-      </RouteContext.Provider>
-    </RouterContext.Provider>
-  );
-}

package/src/components/Await.tsx

@@ -1,56 +0,0 @@
-import { createResource } from "solid-js";
-
-import { useDeferred } from "../hooks/useDeferred";
-
-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 function Await<T = unknown>(props: AwaitProps<T>): JSX.Element {
-  const promiseAccessor = useDeferred<T>(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 as T);
-  }) as unknown as JSX.Element;
-}

package/src/components/ClientOnly.tsx

@@ -1,20 +0,0 @@
-import { Show } from "solid-js";
-
-import { createMountedSignal } from "../utils/createMountedSignal";
-
-import type { JSX } from "solid-js";
-
-export interface ClientOnlyProps {
-  readonly children: JSX.Element;
-  readonly fallback?: JSX.Element;
-}
-
-export function ClientOnly(props: ClientOnlyProps): JSX.Element {
-  const mounted = createMountedSignal();
-
-  return (
-    <Show when={mounted()} fallback={props.fallback}>
-      {props.children}
-    </Show>
-  );
-}

package/src/components/HttpStatusCode.tsx

@@ -1,65 +0,0 @@
-import { useContext } from "solid-js";
-
-import { HttpStatusContext } from "./HttpStatusProvider";
-
-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 function HttpStatusCode(props: HttpStatusCodeProps): JSX.Element {
-  const sink = useContext(HttpStatusContext);
-
-  if (sink) {
-    sink.code = props.code;
-  }
-
-  return null;
-}

package/src/components/HttpStatusProvider.tsx

@@ -1,21 +0,0 @@
-import { createContext } from "solid-js";
-
-import type { HttpStatusSink } from "../utils/createHttpStatusSink";
-import type { JSX } from "solid-js";
-
-export const HttpStatusContext = createContext<HttpStatusSink | null>(null);
-
-export interface HttpStatusProviderProps {
-  readonly sink: HttpStatusSink;
-  readonly children: JSX.Element;
-}
-
-export function HttpStatusProvider(
-  props: HttpStatusProviderProps,
-): JSX.Element {
-  return (
-    <HttpStatusContext.Provider value={props.sink}>
-      {props.children}
-    </HttpStatusContext.Provider>
-  );
-}

package/src/components/Link.tsx

@@ -1,140 +0,0 @@
-import { createActiveRouteSource } from "@real-router/sources";
-import { createMemo, mergeProps, splitProps } from "solid-js";
-
-import { EMPTY_PARAMS, EMPTY_OPTIONS } from "../constants";
-import { useRequiredRouterContext } from "../context";
-import { createSignalFromSource } from "../createSignalFromSource";
-import {
-  shouldNavigate,
-  buildHref,
-  buildActiveClassName,
-  navigateWithHash,
-} from "../dom-utils";
-
-import type { LinkProps } from "../types";
-import type { Params } from "@real-router/core";
-import type { JSX } from "solid-js";
-
-export function Link<P extends Params = Params>(
-  props: Readonly<LinkProps<P>>,
-): JSX.Element {
-  const merged = mergeProps(
-    {
-      routeParams: EMPTY_PARAMS as P,
-      routeOptions: EMPTY_OPTIONS,
-      activeClassName: "active",
-      activeStrict: false,
-      ignoreQueryParams: true,
-    },
-    props,
-  );
-
-  const [local, rest] = splitProps(merged, [
-    "routeName",
-    "routeParams",
-    "routeOptions",
-    "activeClassName",
-    "activeStrict",
-    "ignoreQueryParams",
-    "hash",
-    "onClick",
-    "target",
-    "class",
-    "children",
-  ]);
-
-  const ctx = useRequiredRouterContext("Link");
-  const router = ctx.router;
-
-  // Hash-aware active state (#532). `routeSelector` (the O(1) shared selector)
-  // doesn't know about hash — when `hash` prop is set, fall back to the slow
-  // path so the source's hash comparison kicks in. Tab-style UI is opt-in via
-  // the prop, so the fast path stays open for the typical Link case.
-  //
-  // §8.1 audit fix: read `props.routeParams === undefined` directly instead of
-  // `local.routeParams === EMPTY_PARAMS`. The latter went through `mergeProps`
-  // proxy and relied on a hidden contract (mergeProps preserves the default
-  // sentinel identity when consumer omits the field). The new check is
-  // explicit: "fast path kicks in when consumer did not supply routeParams".
-  const useFastPath =
-    local.hash === undefined &&
-    !local.activeStrict &&
-    local.ignoreQueryParams &&
-    props.routeParams === undefined;
-
-  const buildActiveOptions = () => {
-    const base = {
-      strict: local.activeStrict,
-      ignoreQueryParams: local.ignoreQueryParams,
-    };
-
-    if (local.hash === undefined) {
-      return base;
-    }
-
-    return { ...base, hash: local.hash };
-  };
-
-  const isActive = useFastPath
-    ? () => ctx.routeSelector(local.routeName)
-    : createSignalFromSource(
-        createActiveRouteSource(
-          router,
-          local.routeName,
-          local.routeParams,
-          buildActiveOptions(),
-        ),
-      );
-
-  // Separate memo for the hash-options object so the `{ hash }` literal
-  // is allocated only when `local.hash` actually changes (instead of on
-  // every `href` memo evaluation). For static `<Link hash="foo">` this
-  // produces ONE allocation total; for dynamic hash through `<Show keyed>`
-  // workaround the allocation cost scales with hash changes, not with
-  // routeName/routeParams changes (§8c A4 audit fix).
-  const hashOpts = createMemo(() =>
-    local.hash === undefined ? undefined : { hash: local.hash },
-  );
-
-  const href = createMemo(() =>
-    buildHref(router, local.routeName, local.routeParams, hashOpts()),
-  );
-
-  const handleClick = (evt: MouseEvent) => {
-    if (local.onClick) {
-      local.onClick(evt);
-
-      if (evt.defaultPrevented) {
-        return;
-      }
-    }
-
-    if (!shouldNavigate(evt) || local.target === "_blank") {
-      return;
-    }
-
-    evt.preventDefault();
-    navigateWithHash(
-      router,
-      local.routeName,
-      local.routeParams,
-      local.hash,
-      local.routeOptions,
-    ).catch(() => {});
-  };
-
-  const finalClassName = createMemo(() =>
-    buildActiveClassName(isActive(), local.activeClassName, local.class),
-  );
-
-  return (
-    <a
-      {...(rest as JSX.HTMLAttributes<HTMLAnchorElement>)}
-      href={href()}
-      class={finalClassName()}
-      onClick={handleClick}
-    >
-      {local.children}
-    </a>
-  );
-}

package/src/components/RouteView/RouteView.tsx

@@ -1,59 +0,0 @@
-import { children as resolveChildren, createMemo, For, Show } from "solid-js";
-
-import { Match, NotFound, Self } from "./components";
-import { buildRenderList, collectElements } from "./helpers";
-import { useRouteNode } from "../../hooks/useRouteNode";
-
-import type { RouteViewMarker } from "./components";
-import type { RouteViewProps } from "./types";
-import type { JSX } from "solid-js";
-
-function RouteViewRoot(props: Readonly<RouteViewProps>): JSX.Element {
-  const routeState = useRouteNode(props.nodeName);
-
-  const resolved = resolveChildren(() => props.children);
-
-  const elements = createMemo(() => {
-    const arr: RouteViewMarker[] = [];
-
-    collectElements(resolved(), arr);
-
-    return arr;
-  });
-
-  // Idiomatic Solid: `<Show>` gates on the route presence, `<For>` iterates
-  // the build-render-list output. `<Show when={...} keyed>` re-runs the
-  // child callback only when route identity changes; `<For>` adds/removes
-  // exactly the changed elements without re-running the rest.
-  // (§8a Q4 audit fix — replaced an IIFE-in-JSX with idiomatic primitives.)
-  const renderList = createMemo<JSX.Element[]>(() => {
-    const state = routeState();
-
-    if (!state.route) {
-      return [];
-    }
-
-    return buildRenderList(elements(), state.route.name, props.nodeName);
-  });
-
-  return (
-    <Show when={renderList().length > 0}>
-      <For each={renderList()}>{(node) => node}</For>
-    </Show>
-  );
-}
-
-RouteViewRoot.displayName = "RouteView";
-
-export const RouteView = Object.assign(RouteViewRoot, {
-  Match,
-  Self,
-  NotFound,
-});
-
-export type {
-  RouteViewProps,
-  MatchProps as RouteViewMatchProps,
-  SelfProps as RouteViewSelfProps,
-  NotFoundProps as RouteViewNotFoundProps,
-} from "./types";

package/src/components/RouteView/components.tsx

@@ -1,85 +0,0 @@
-import type { MatchProps, NotFoundProps, SelfProps } from "./types";
-import type { JSX } from "solid-js";
-
-// Local (non-global) Symbols — Symbol.for() would expose markers to spoofing
-// via the global Symbol registry. See Gotchas section "RouteView Marker Objects".
-export const MATCH_MARKER = Symbol("RouteView.Match");
-
-export const SELF_MARKER = Symbol("RouteView.Self");
-
-export const NOT_FOUND_MARKER = Symbol("RouteView.NotFound");
-
-export interface MatchMarker {
-  $$type: typeof MATCH_MARKER;
-  segment: string;
-  exact: boolean;
-  fallback?: JSX.Element;
-  children: JSX.Element;
-}
-
-export interface SelfMarker {
-  $$type: typeof SELF_MARKER;
-  fallback?: JSX.Element;
-  children: JSX.Element;
-}
-
-export interface NotFoundMarker {
-  $$type: typeof NOT_FOUND_MARKER;
-  children: JSX.Element;
-}
-
-export type RouteViewMarker = MatchMarker | SelfMarker | NotFoundMarker;
-
-// §8.1 audit fix (LOW #8) — three marker factories share the
-// `$$type + children getter` skeleton plus a small per-marker payload.
-// `createMarker` keeps the shared shape in one place; each public factory
-// (Match/Self/NotFound) only provides what differs.
-//
-// The `children` getter (not a plain field) is intentional: it lets the
-// marker capture Solid's reactive `props.children` lazily, so swapping the
-// marker content in a parent component re-evaluates at render time without
-// pulling stale references.
-//
-// Marker objects are identified by `$$type` Symbol in RouteView/helpers.tsx,
-// not rendered as JSX. The `as unknown as JSX.Element` cast is required at
-// the call site because `JSX.Element` does not include arbitrary marker
-// shapes.
-function createMarker<M extends RouteViewMarker>(
-  type: M["$$type"],
-  getChildren: () => JSX.Element,
-  extras?: Omit<M, "$$type" | "children">,
-): JSX.Element {
-  const result = {
-    $$type: type,
-    ...extras,
-    get children(): JSX.Element {
-      return getChildren();
-    },
-  };
-
-  return result as unknown as JSX.Element;
-}
-
-export function Match(props: MatchProps): JSX.Element {
-  return createMarker<MatchMarker>(MATCH_MARKER, () => props.children, {
-    segment: props.segment,
-    exact: props.exact ?? false,
-    fallback: props.fallback,
-  });
-}
-
-Match.displayName = "RouteView.Match";
-
-export function Self(props: SelfProps): JSX.Element {
-  return createMarker<SelfMarker>(SELF_MARKER, () => props.children, {
-    fallback: props.fallback,
-  });
-}
-
-Self.displayName = "RouteView.Self";
-
-export function NotFound(props: NotFoundProps): JSX.Element {
-  return createMarker<NotFoundMarker>(NOT_FOUND_MARKER, () => props.children);
-}
-
-NotFound.displayName = "RouteView.NotFound";

package/src/components/RouteView/index.ts

@@ -1,8 +0,0 @@
-export { RouteView } from "./RouteView";
-
-export type {
-  RouteViewProps,
-  RouteViewMatchProps,
-  RouteViewSelfProps,
-  RouteViewNotFoundProps,
-} from "./RouteView";

package/src/components/RouteView/types.ts

@@ -1,24 +0,0 @@
-import type { JSX } from "solid-js";
-
-export interface RouteViewProps {
-  readonly nodeName: string;
-  readonly children: JSX.Element;
-}
-
-export interface MatchProps {
-  readonly segment: string;
-  readonly exact?: boolean;
-  readonly fallback?: JSX.Element;
-  readonly children: JSX.Element;
-}
-
-export interface SelfProps {
-  /** Fallback content while children are suspended. */
-  readonly fallback?: JSX.Element;
-  /** Content to render when the active route name equals the parent RouteView's nodeName. */
-  readonly children: JSX.Element;
-}
-
-export interface NotFoundProps {
-  readonly children: JSX.Element;
-}