@effectweb/tanstack-router 0.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EffectWeb contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @effectweb/tanstack-router
+
+EffectWeb adapter for TanStack Router Core.
+
+- `createRouter` keeps TanStack's route-tree inference and navigation types.
+- `RootRoute` and `Route` expose TanStack's route constructors: matching, params, validated search, redirects, loaders and errors remain in the core.
+- `mountRouter(router)` owns the history subscription in an Effect scope and returns an EffectWeb `Source` of router state.
+- The store adapter batches publications and copies plain state before EffectWeb freezes it. It never freezes TanStack's internal match records.
+- The host program subscribes to that Source and renders its own matching views. Scope cleanup releases the Source, subscriptions and owned history.
+
+Currently there is no JSX Link/Outlet API, route-level view/error boundary system, SSR adapter or file-route generator. Those can build on this binding without introducing a second route matcher.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { Effect, type Scope } from 'effect';
+import { type Source } from 'effectweb';
+import { type AnyRouter, type CreateRouterFn, type RouterState } from '@tanstack/router-core';
+export { BaseRoute as Route, BaseRootRoute as RootRoute, redirect, notFound, } from '@tanstack/router-core';
+export { createBrowserHistory, createMemoryHistory } from '@tanstack/history';
+/** TanStack supplies matching, loaders, search validation and typed navigation; EffectWeb owns publications. */
+export declare const createRouter: CreateRouterFn;
+/** Mount once per router in an Effect scope. The returned Source can drive an EffectWeb program or view. */
+export declare const mountRouter: <Router extends AnyRouter>(router: Router) => Effect.Effect<Source<RouterState<Router["routeTree"]>>, Error, Scope.Scope>;

package/dist/index.js

@@ -0,0 +1,105 @@
+import { Effect } from 'effect';
+import { projectionSource } from 'effectweb';
+import { RouterCore, createNonReactiveMutableStore, createNonReactiveReadonlyStore, } from '@tanstack/router-core';
+export { BaseRoute as Route, BaseRootRoute as RootRoute, redirect, notFound, } from '@tanstack/router-core';
+export { createBrowserHistory, createMemoryHistory } from '@tanstack/history';
+// EffectWeb freezes published plain data. Copy it so TanStack can keep managing its mutable match resources.
+const snapshotCopy = (value, seen = new WeakMap()) => {
+    if (value === null || typeof value !== 'object')
+        return value;
+    const prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null)
+        return value;
+    if (seen.has(value))
+        return seen.get(value);
+    const copy = Array.isArray(value) ? [] : {};
+    seen.set(value, copy);
+    for (const key of Reflect.ownKeys(value)) {
+        if (key === 'length' && Array.isArray(value))
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if ('value' in descriptor)
+            Object.defineProperty(copy, key, {
+                value: snapshotCopy(descriptor.value, seen),
+                writable: true,
+                enumerable: descriptor.enumerable ?? false,
+                configurable: true,
+            });
+    }
+    return copy;
+};
+const publications = new WeakMap();
+/** TanStack supplies matching, loaders, search validation and typed navigation; EffectWeb owns publications. */
+export const createRouter = (options) => {
+    const listeners = new Set();
+    let batchDepth = 0;
+    let dirty = false;
+    const publish = () => {
+        dirty = true;
+        if (batchDepth)
+            return;
+        dirty = false;
+        for (const listener of listeners)
+            listener();
+    };
+    const instance = new RouterCore(options, () => ({
+        createMutableStore: (initial) => {
+            const store = createNonReactiveMutableStore(initial);
+            return {
+                get: store.get,
+                set: (next) => {
+                    store.set((previous) => typeof next === 'function' ? next(previous) : next);
+                    publish();
+                },
+            };
+        },
+        createReadonlyStore: createNonReactiveReadonlyStore,
+        batch: (run) => {
+            batchDepth++;
+            try {
+                run();
+            }
+            finally {
+                batchDepth--;
+                if (!batchDepth && dirty)
+                    publish();
+            }
+        },
+    }));
+    publications.set(instance, listeners);
+    return instance;
+};
+/** Mount once per router in an Effect scope. The returned Source can drive an EffectWeb program or view. */
+export const mountRouter = (router) => Effect.gen(function* () {
+    const source = yield* Effect.acquireRelease(Effect.sync(() => {
+        const listeners = publications.get(router);
+        const history = router.history;
+        if (!listeners)
+            throw new Error('Use @effectweb/tanstack-router.createRouter before mountRouter');
+        const source = projectionSource({
+            project: () => snapshotCopy(router.state),
+        });
+        listeners.add(source.changed);
+        source.start();
+        const unsubscribe = history.subscribe(() => {
+            void router
+                .load()
+                .catch((error) => console.error('Router navigation failed', error));
+        });
+        return {
+            source,
+            dispose: () => {
+                unsubscribe();
+                listeners.delete(source.changed);
+                source.dispose();
+                history.flush();
+                history.destroy();
+            },
+        };
+    }), (mounted) => Effect.sync(() => mounted.dispose()));
+    yield* Effect.tryPromise({
+        try: () => router.load(),
+        catch: (cause) => (cause instanceof Error ? cause : new Error(String(cause))),
+    });
+    return source.source;
+});

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@effectweb/tanstack-router",
+  "version": "0.5.1",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tanstack/history": "1.162.4",
+    "@tanstack/router-core": "1.171.33"
+  },
+  "peerDependencies": {
+    "effect": "4.0.0-rc.112",
+    "effectweb": "^0.5.1"
+  }
+}