@kasperrt/smolter 0.0.1 → 0.2.0

package/README.md

@@ -1,8 +1,8 @@
 # smolter _
 
 <!-- bundlejs:start -->
-[![react gzip size](https://deno.bundlejs.com/?q=%40kasperrt%2Fsmolter%400.0.1%2Freact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react%2F*%22%5D%7D%7D&badge)](https://bundlejs.com/?q=%40kasperrt%2Fsmolter%400.0.1%2Freact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react%2F*%22%5D%7D%7D&bundle)
-[![preact gzip size](https://deno.bundlejs.com/?q=%40kasperrt%2Fsmolter%400.0.1%2Fpreact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22preact%22%2C%22preact%2F*%22%5D%7D%7D&badge)](https://bundlejs.com/?q=%40kasperrt%2Fsmolter%400.0.1%2Fpreact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22preact%22%2C%22preact%2F*%22%5D%7D%7D&bundle)
+[![react gzip size](https://deno.bundlejs.com/?q=%40kasperrt%2Fsmolter%400.2.0%2Freact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react%2F*%22%5D%7D%7D&badge)](https://bundlejs.com/?q=%40kasperrt%2Fsmolter%400.2.0%2Freact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react%2F*%22%5D%7D%7D&bundle)
+[![preact gzip size](https://deno.bundlejs.com/?q=%40kasperrt%2Fsmolter%400.2.0%2Fpreact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22preact%22%2C%22preact%2F*%22%5D%7D%7D&badge)](https://bundlejs.com/?q=%40kasperrt%2Fsmolter%400.2.0%2Fpreact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22preact%22%2C%22preact%2F*%22%5D%7D%7D&bundle)
 <!-- bundlejs:end -->
 
 A typed data router for React and Preact. **Zero runtime dependencies.**
@@ -14,6 +14,10 @@ loader; `shouldRevalidate` decides when that work is needed.
 Inspired by [wouter](https://github.com/molefrog/wouter)
 and [React Router](https://reactrouter.com/).
 
+[Read the documentation](https://kasperrt.github.io/smolter/react/docs/) for guides and the complete API reference. The site itself uses smolter routes.
+
+Start with [loaders](https://kasperrt.github.io/smolter/react/docs/loaders/), [actions](https://kasperrt.github.io/smolter/react/docs/actions/), [forms and validation](https://kasperrt.github.io/smolter/react/docs/forms/), or [fetcher reads and mutations](https://kasperrt.github.io/smolter/react/docs/fetchers/). Each guide connects the handler to an actual route URL and its consuming view.
+
 ## Contents
 
 - [Install](#install)
@@ -49,10 +53,10 @@ pnpm dev
 
 | App | Open | Data |
 | --- | --- | --- |
-| [React SPA](https://github.com/kasperrt/smolter/tree/main/apps/react) | http://127.0.0.1:5173 | Client loaders/actions, localStorage |
-| [Preact SPA](https://github.com/kasperrt/smolter/tree/main/apps/preact) | http://127.0.0.1:5174 | Client loaders/actions, localStorage |
-| [React SSR](https://github.com/kasperrt/smolter/tree/main/apps/react-ssr) | http://127.0.0.1:5175 | Server loaders/actions, hydration |
-| [Preact SSR](https://github.com/kasperrt/smolter/tree/main/apps/preact-ssr) | http://127.0.0.1:5176 | Server loaders/actions, hydration |
+| [React SPA](./apps/react) | http://127.0.0.1:5173 | Client loaders/actions, localStorage |
+| [Preact SPA](./apps/preact) | http://127.0.0.1:5174 | Client loaders/actions, localStorage |
+| [React SSR](./apps/react-ssr) | http://127.0.0.1:5175 | Server loaders/actions, hydration |
+| [Preact SSR](./apps/preact-ssr) | http://127.0.0.1:5176 | Server loaders/actions, hydration |
 
 Each app has its own entrypoints, routes, and data code. Only UI components are
 shared. Preact examples do not import React. Each includes:
@@ -81,7 +85,7 @@ or filename parser enters the browser bundle.
 ```ts
 // vite.config.ts
 import { defineConfig } from "vite";
-import { fileRouter } from "@kasperrt/smolter/vite";
+import { fileRouter } from "@kasperrt/smolter/react/vite";
 
 export default defineConfig({
   plugins: [fileRouter({ directory: "src/routes" })],
@@ -121,12 +125,12 @@ For the virtual module, add this declaration to your app:
 // env.d.ts
 // Include vite/client in your tsconfig types as usual.
 declare module "virtual:smolter/routes" {
-  const routes: import("@kasperrt/smolter/core").Route[];
+  const routes: import("@kasperrt/smolter/react").Route[];
   export default routes;
 }
 ```
 
-Outside Vite, `flatRoutes(directory)` from `@kasperrt/smolter/files` returns
+Outside Vite, `flatRoutes(directory)` from `@kasperrt/smolter/react/vite` returns
 `{ path, file }[] | Error` for your build tool to turn into imports.
 
 ### Manual routes
@@ -184,7 +188,7 @@ With the optional server integration:
 
 ```ts
 // client-loader.ts
-import type { ClientLoaderArgs } from "@kasperrt/smolter/client";
+import type { ClientLoaderArgs } from "@kasperrt/smolter/react/client";
 import type { loader } from "./loader";
 
 export async function clientLoader({ serverLoader }: ClientLoaderArgs<typeof loader>) {
@@ -194,7 +198,7 @@ export async function clientLoader({ serverLoader }: ClientLoaderArgs<typeof loa
 
 ```ts
 // client-action.ts
-import type { ClientActionArgs } from "@kasperrt/smolter/client";
+import type { ClientActionArgs } from "@kasperrt/smolter/react/client";
 import type { action } from "./action";
 
 export async function clientAction({ serverAction }: ClientActionArgs<typeof action>) {
@@ -234,17 +238,17 @@ in a client bundle. Type-only imports from server handlers are safe. Do not
 import server code directly into client views or client handlers.
 
 The Vite dev plugin mounts `/_smolter?url=...`. Production hosts dispatch that
-endpoint through `handleRequest(routes, request)` from `@kasperrt/smolter/server`, using
+endpoint through `handleRequest(routes, request)` from `@kasperrt/smolter/react/server`, using
 the requested route URL. Both SSR examples include a working host. The host
 owns authentication, session cookies, HTTP policy, and deployment.
 
 Manual server routes use `serverRoute<typeof import("./route")>(path, clientModule)`
-from `@kasperrt/smolter/client` in the browser and `defineRoute` on the server. This keeps
+from `@kasperrt/smolter/react/client` in the browser and `defineRoute` on the server. This keeps
 the type connection without importing server code at runtime. To use manual
 tables with the dev transport:
 
 ```ts
-import { routerPlugin } from "@kasperrt/smolter/vite";
+import { routerPlugin } from "@kasperrt/smolter/react/vite";
 
 routerPlugin({
   clientRoutes: "src/manual-browser-routes.ts",
@@ -366,7 +370,7 @@ remount the fallback during revalidation. Return a `Response` with a `Location`
 ## Server rendering
 
 ```tsx
-import { loadRouter, serialize } from "@kasperrt/smolter/server";
+import { loadRouter, serialize } from "@kasperrt/smolter/react/server";
 
 const router = await loadRouter(routes, incomingRequest);
 const html = renderToString(
@@ -376,13 +380,13 @@ const hydrationJSON = serialize(router.getSnapshot());
 ```
 
 Create a fresh router per request. Embed the serialized snapshot in a JSON
-script, restore it with `deserialize` from `@kasperrt/smolter/client`, and pass it as
+script, restore it with `deserialize` from `@kasperrt/smolter/react/client`, and pass it as
 `hydrationData` to `createRouter`. This preserves loader errors through hydration
 without exposing server stacks or causes. Error boundaries should display the
 error message, not its stack.
 
 ```ts
-import { deserialize } from "@kasperrt/smolter/client";
+import { deserialize } from "@kasperrt/smolter/react/client";
 import { createRouter } from "@kasperrt/smolter/react";
 import routes from "virtual:smolter/routes";
 
@@ -403,15 +407,31 @@ The SSR examples use the same server route definitions for HTML and data request
 ## Package entries
 
 Use `@kasperrt/smolter/react` for React 18+ and `@kasperrt/smolter/preact` for Preact 10.25+.
-The root `@kasperrt/smolter` entry (also available as `@kasperrt/smolter/core`) is framework-independent.
-Server helpers live in `@kasperrt/smolter/server`; optional browser transport in `@kasperrt/smolter/client`;
-flat file routing in `@kasperrt/smolter/vite` and `@kasperrt/smolter/files`.
+Choose one renderer for your application. Both expose the same routing API:
+
+| Purpose | React | Preact |
+| --- | --- | --- |
+| Components, hooks, router, data types | `@kasperrt/smolter/react` | `@kasperrt/smolter/preact` |
+| Optional browser transport | `@kasperrt/smolter/react/client` | `@kasperrt/smolter/preact/client` |
+| SSR and HTTP data dispatch | `@kasperrt/smolter/react/server` | `@kasperrt/smolter/preact/server` |
+| Vite plugin and flat-file discovery | `@kasperrt/smolter/react/vite` | `@kasperrt/smolter/preact/vite` |
+
+`@kasperrt/smolter/utils` contains browser-safe matching and error helpers.
+The main renderer entries never import server or build modules. Named imports
+are tree-shaken; optional transport is included only when you import `/client`.
+Server entries do not import either UI renderer. Vite entries are build-time only.
+
+**Migrating to 0.2.0:** replace `/core` imports for types, `createRouter`, and
+`defineRoute` with your renderer entry. Use `/utils` for `matchRoutes`,
+`internalURL` and `safeWrapAsync`. Move `/client`, `/server`,
+`/files`, and `/vite` imports to the corresponding renderer-prefixed path above.
+The bare package root and old top-level subpaths are no longer exported.
 
 On JSR, install `@kasperrt/smolter` using the
 [JSR package instructions](https://jsr.io/docs/npm-compatibility) and import
 `@kasperrt/smolter/react` or `@kasperrt/smolter/preact`. Its `core`, `client`,
 `server`, and `files` subpaths match npm. The Vite plugin is npm-only:
-use `@kasperrt/smolter/vite` from the npm package when adding file routing.
+use `@kasperrt/smolter/react/vite` from the npm package when adding file routing.
 
 ## Size and checks
 
@@ -426,8 +446,8 @@ example labels. File discovery is build-only.
 | --- | ---: |
 | `@kasperrt/smolter/react` | 2445 |
 | `@kasperrt/smolter/preact` | 2445 |
-| `@kasperrt/smolter/react + @kasperrt/smolter/client` | 2782 |
-| `@kasperrt/smolter/preact + @kasperrt/smolter/client` | 2781 |
+| `@kasperrt/smolter/react + @kasperrt/smolter/react/client` | 2782 |
+| `@kasperrt/smolter/preact + @kasperrt/smolter/preact/client` | 2781 |
 | `wouter@3.13.0` | 3091 |
 | `wouter-preact@3.13.0` | 2450 |
 | `react-router@8.4.0` | 60994 |
@@ -438,11 +458,11 @@ using production ESM bundles, esbuild, Terser, and gzip level 9. React, React DO
 and Preact are external in every bundle. Transitive library dependencies are
 included. React Router provides a broader API; this compares complete entry
 sizes, not equivalent feature sets or the minimum code for one route.
-`@kasperrt/smolter/client` adds browser transport for server loaders/actions; server-only
+`@kasperrt/smolter/react/client` adds browser transport for server loaders/actions; server-only
 rendering code and the Vite plugin are not shipped to the browser.
 
 Exact current measurements are generated in
-[`packages/ui/src/size.json`](https://github.com/kasperrt/smolter/blob/main/packages/ui/src/size.json).
+[`packages/ui/src/size.json`](./packages/ui/src/size.json).
 
 ```sh
 pnpm fix               # Formatting
@@ -469,3 +489,5 @@ To test a local package build in another project:
 pnpm --dir packages/smolter pack --pack-destination ../..
 pnpm add /absolute/path/to/kasperrt-smolter-0.0.1.tgz
 ```
+
+Workspace structure and rendering checks are documented in [CONTRIBUTING.md](./CONTRIBUTING.md).

package/dist/internal/core/index.d.ts

@@ -2,5 +2,6 @@
 export * from "./errors.ts";
 export * from "./match.ts";
 export * from "./router.ts";
+export * from "./serialize.ts";
 export * from "./types.ts";
 export * from "./url.ts";

package/dist/internal/core/index.js

@@ -2,5 +2,6 @@
 export * from "./errors.js";
 export * from "./match.js";
 export * from "./router.js";
+export * from "./serialize.js";
 export * from "./types.js";
 export * from "./url.js";

package/dist/internal/core/serialize.d.ts

@@ -0,0 +1,3 @@
+import type { Snapshot } from "./types.ts";
+/** Safe inside a script element. Data must be JSON serializable; error stacks and causes are omitted. */
+export declare function serialize(snapshot: Snapshot): string;

package/dist/internal/core/serialize.js

@@ -0,0 +1,13 @@
+/** Safe inside a script element. Data must be JSON serializable; error stacks and causes are omitted. */
+export function serialize(snapshot) {
+    return JSON.stringify({
+        ...snapshot,
+        error: snapshot.error && {
+            name: snapshot.error.name,
+            message: snapshot.error.message,
+        },
+    })
+        .replace(/</g, "\\u003c")
+        .replace(/\u2028/g, "\\u2028")
+        .replace(/\u2029/g, "\\u2029");
+}

package/dist/internal/server/index.d.ts

@@ -2,10 +2,9 @@
  * Request-scoped server rendering and HTTP data dispatch.
  * @module
  */
-import { type Route, type Router, type Snapshot } from "../core/index.ts";
+import { type Route, type Router } from "../core/index.ts";
 /** Create one router per server request, await this, then render the provider. */
 export declare function loadRouter(routes: readonly Route[], input: string | Request): Promise<Router>;
-/** Safe inside a script element. Data must be JSON serializable; error stacks and causes are omitted. */
-export declare function serialize(snapshot: Snapshot): string;
+export { serialize } from "../core/index.ts";
 /** Dispatch an HTTP data request to a registered server loader or action. */
 export declare function handleRequest(routes: readonly Route[], request: Request): Promise<Response>;

package/dist/internal/server/index.js

@@ -39,19 +39,7 @@ export async function loadRouter(routes, input) {
     }
     return router;
 }
-/** Safe inside a script element. Data must be JSON serializable; error stacks and causes are omitted. */
-export function serialize(snapshot) {
-    return JSON.stringify({
-        ...snapshot,
-        error: snapshot.error && {
-            name: snapshot.error.name,
-            message: snapshot.error.message,
-        },
-    })
-        .replace(/</g, "\\u003c")
-        .replace(/\u2028/g, "\\u2028")
-        .replace(/\u2029/g, "\\u2029");
-}
+export { serialize } from "../core/index.js";
 /** Dispatch an HTTP data request to a registered server loader or action. */
 export async function handleRequest(routes, request) {
     const match = matchRoutes(routes, new URL(request.url).pathname);

package/dist/internal/vite/index.d.ts

@@ -3,8 +3,9 @@ export interface FileRouterOptions {
     directory?: string;
     clientRoutes?: string;
     serverRoutes?: string;
+    framework?: "react" | "preact";
 }
 /** Build-time flat route discovery and the optional server data transport. */
-export declare function routerPlugin({ directory, clientRoutes, serverRoutes, }?: FileRouterOptions): Plugin;
+export declare function routerPlugin({ directory, clientRoutes, serverRoutes, framework, }?: FileRouterOptions): Plugin;
 /** File routing is the default; this alias keeps configuration explicit. */
 export declare const fileRouter: typeof routerPlugin;

package/dist/internal/vite/index.js

@@ -4,7 +4,7 @@ import { flatRoutes } from "../files/index.js";
 import { transformWithOxc } from "vite";
 import { configureTransport } from "./transport.js";
 /** Build-time flat route discovery and the optional server data transport. */
-export function routerPlugin({ directory = "src/routes", clientRoutes, serverRoutes, } = {}) {
+export function routerPlugin({ directory = "src/routes", clientRoutes, serverRoutes, framework = "react", } = {}) {
     let root;
     let projectRoot;
     const publicId = "virtual:smolter/routes";
@@ -103,7 +103,7 @@ export function routerPlugin({ directory = "src/routes", clientRoutes, serverRou
             }
             if (!options?.ssr &&
                 definitions.some((definition) => definition.startsWith("serverRoute(")))
-                imports.unshift('import { serverRoute } from "@kasperrt/smolter/client";');
+                imports.unshift(`import { serverRoute } from "@kasperrt/smolter/${framework}/client";`);
             return `${imports.join("\n")}\nexport default [${definitions.join(",\n")}];\n`;
         },
         configureServer(server) {
@@ -124,7 +124,7 @@ export function routerPlugin({ directory = "src/routes", clientRoutes, serverRou
                 server.watcher.off("change", refresh);
                 server.watcher.off("unlink", refresh);
             });
-            configureTransport(server, publicId);
+            configureTransport(server, publicId, framework);
         },
     };
 }

package/dist/internal/vite/transport.d.ts

@@ -1,2 +1,2 @@
 import type { ViteDevServer } from "vite";
-export declare function configureTransport(server: ViteDevServer, publicId: string): void;
+export declare function configureTransport(server: ViteDevServer, publicId: string, framework?: "react" | "preact"): void;

package/dist/internal/vite/transport.js

@@ -1,4 +1,4 @@
-export function configureTransport(server, publicId) {
+export function configureTransport(server, publicId, framework = "react") {
     server.middlewares.use((incoming, outgoing, next) => {
         if (!incoming.url?.startsWith("/_smolter?"))
             return next();
@@ -30,7 +30,7 @@ export function configureTransport(server, publicId) {
             });
             const [{ default: routes }, { handleRequest }] = await Promise.all([
                 server.ssrLoadModule(publicId),
-                server.ssrLoadModule("@kasperrt/smolter/server"),
+                server.ssrLoadModule(`@kasperrt/smolter/${framework}/server`),
             ]);
             const response = await handleRequest(routes, request);
             outgoing.statusCode = response.status;

package/dist/preact-client.d.ts

@@ -0,0 +1,2 @@
+/** Optional browser transport for server handlers. @module */
+export * from "./internal/client/index.ts";

package/dist/preact-client.js

@@ -0,0 +1,2 @@
+/** Optional browser transport for server handlers. @module */
+export * from "./internal/client/index.js";

package/dist/preact-server.d.ts

@@ -0,0 +1,2 @@
+/** Preact server rendering and HTTP data dispatch. @module */
+export * from "./internal/server/index.ts";

package/dist/preact-server.js

@@ -0,0 +1,2 @@
+/** Preact server rendering and HTTP data dispatch. @module */
+export * from "./internal/server/index.js";

package/dist/preact-vite.d.ts

@@ -0,0 +1,9 @@
+/** Optional flat-file routing for Preact builds. @module */
+import type { Plugin } from "vite";
+import { type FileRouterOptions } from "./internal/vite/index.ts";
+export * from "./internal/files/index.ts";
+export type { FileRouterOptions } from "./internal/vite/index.ts";
+/** Configure flat routes and server transport for Preact. */
+export declare function routerPlugin(options?: FileRouterOptions): Plugin;
+/** File routing is the default; this alias keeps configuration explicit. */
+export declare const fileRouter: typeof routerPlugin;

package/dist/preact-vite.js

@@ -0,0 +1,9 @@
+/** Optional flat-file routing for Preact builds. @module */
+import { routerPlugin as createPlugin, } from "./internal/vite/index.js";
+export * from "./internal/files/index.js";
+/** Configure flat routes and server transport for Preact. */
+export function routerPlugin(options = {}) {
+    return createPlugin({ ...options, framework: "preact" });
+}
+/** File routing is the default; this alias keeps configuration explicit. */
+export const fileRouter = routerPlugin;

package/dist/react-client.d.ts

@@ -0,0 +1,2 @@
+/** Optional browser transport for server handlers. @module */
+export * from "./internal/client/index.ts";

package/dist/react-client.js

@@ -0,0 +1,2 @@
+/** Optional browser transport for server handlers. @module */
+export * from "./internal/client/index.js";

package/dist/react-server.d.ts

@@ -0,0 +1,2 @@
+/** React server rendering and HTTP data dispatch. @module */
+export * from "./internal/server/index.ts";

package/dist/react-server.js

@@ -0,0 +1,2 @@
+/** React server rendering and HTTP data dispatch. @module */
+export * from "./internal/server/index.js";

package/dist/react-vite.d.ts

@@ -0,0 +1,9 @@
+/** Optional flat-file routing for React builds. @module */
+import type { Plugin } from "vite";
+import { type FileRouterOptions } from "./internal/vite/index.ts";
+export * from "./internal/files/index.ts";
+export type { FileRouterOptions } from "./internal/vite/index.ts";
+/** Configure flat routes and server transport for React. */
+export declare function routerPlugin(options?: FileRouterOptions): Plugin;
+/** File routing is the default; this alias keeps configuration explicit. */
+export declare const fileRouter: typeof routerPlugin;

package/dist/react-vite.js

@@ -0,0 +1,9 @@
+/** Optional flat-file routing for React builds. @module */
+import { routerPlugin as createPlugin, } from "./internal/vite/index.js";
+export * from "./internal/files/index.js";
+/** Configure flat routes and server transport for React. */
+export function routerPlugin(options = {}) {
+    return createPlugin({ ...options, framework: "react" });
+}
+/** File routing is the default; this alias keeps configuration explicit. */
+export const fileRouter = routerPlugin;

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+/** Framework-independent, browser-safe utilities. @module */
+export * from "./internal/core/errors.ts";
+export * from "./internal/core/match.ts";
+export * from "./internal/core/serialize.ts";
+export * from "./internal/core/url.ts";

package/dist/utils.js

@@ -0,0 +1,5 @@
+/** Framework-independent, browser-safe utilities. @module */
+export * from "./internal/core/errors.js";
+export * from "./internal/core/match.js";
+export * from "./internal/core/serialize.js";
+export * from "./internal/core/url.js";

package/jsr.json

@@ -1,14 +1,14 @@
 {
   "name": "@kasperrt/smolter",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "exports": {
-    ".": "./src/core.ts",
+    "./react": "./src/react.ts",
+    "./react/server": "./src/react-server.ts",
     "./preact": "./src/preact.ts",
-    "./core": "./src/core.ts",
-    "./server": "./src/server.ts",
-    "./client": "./src/client.ts",
-    "./files": "./src/files.ts",
-    "./react": "./src/react.ts"
+    "./preact/server": "./src/preact-server.ts",
+    "./react/client": "./src/react-client.ts",
+    "./preact/client": "./src/preact-client.ts",
+    "./utils": "./src/utils.ts"
   },
   "imports": {
     "react": "npm:react@19.3.1",
@@ -16,7 +16,12 @@
   },
   "publish": {
     "include": ["src", "README.md", "LICENSE", "jsr.json"],
-    "exclude": ["src/vite.ts", "src/internal/vite"]
+    "exclude": [
+      "src/vite.ts",
+      "src/react-vite.ts",
+      "src/preact-vite.ts",
+      "src/internal/vite"
+    ]
   },
   "license": "MIT",
   "compatibility": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kasperrt/smolter",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "A tiny typed data router for React and Preact.",
   "type": "module",
   "sideEffects": false,
@@ -11,38 +11,41 @@
     "directory": "packages/smolter"
   },
   "exports": {
-    ".": {
-      "types": "./dist/core.d.ts",
-      "import": "./dist/core.js"
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./react/server": {
+      "types": "./dist/react-server.d.ts",
+      "import": "./dist/react-server.js"
+    },
+    "./react/vite": {
+      "types": "./dist/react-vite.d.ts",
+      "import": "./dist/react-vite.js"
     },
     "./preact": {
       "types": "./dist/preact.d.ts",
       "import": "./dist/preact.js"
     },
-    "./core": {
-      "types": "./dist/core.d.ts",
-      "import": "./dist/core.js"
+    "./preact/server": {
+      "types": "./dist/preact-server.d.ts",
+      "import": "./dist/preact-server.js"
     },
-    "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js"
+    "./preact/vite": {
+      "types": "./dist/preact-vite.d.ts",
+      "import": "./dist/preact-vite.js"
     },
-    "./files": {
-      "types": "./dist/files.d.ts",
-      "import": "./dist/files.js"
+    "./react/client": {
+      "types": "./dist/react-client.d.ts",
+      "import": "./dist/react-client.js"
     },
-    "./vite": {
-      "types": "./dist/vite.d.ts",
-      "import": "./dist/vite.js"
+    "./preact/client": {
+      "types": "./dist/preact-client.d.ts",
+      "import": "./dist/preact-client.js"
     },
-    "./client": {
-      "types": "./dist/client.d.ts",
-      "import": "./dist/client.js"
-    },
-    "./package.json": "./package.json",
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js"
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.js"
     }
   },
   "files": [
@@ -87,8 +90,6 @@
     "ssr",
     "file-routing"
   ],
-  "main": "./dist/core.js",
-  "types": "./dist/core.d.ts",
   "publishConfig": {
     "access": "public",
     "provenance": true

package/src/internal/core/index.ts

@@ -3,5 +3,6 @@
 export * from "./errors.ts";
 export * from "./match.ts";
 export * from "./router.ts";
+export * from "./serialize.ts";
 export * from "./types.ts";
 export * from "./url.ts";

package/src/internal/core/serialize.ts

@@ -0,0 +1,15 @@
+import type { Snapshot } from "./types.ts";
+
+/** Safe inside a script element. Data must be JSON serializable; error stacks and causes are omitted. */
+export function serialize(snapshot: Snapshot): string {
+  return JSON.stringify({
+    ...snapshot,
+    error: snapshot.error && {
+      name: snapshot.error.name,
+      message: snapshot.error.message,
+    },
+  })
+    .replace(/</g, "\\u003c")
+    .replace(/\u2028/g, "\\u2028")
+    .replace(/\u2029/g, "\\u2029");
+}

package/src/internal/server/index.ts

@@ -9,7 +9,6 @@ import {
   matchRoutes,
   type Route,
   type Router,
-  type Snapshot,
   safeWrapAsync,
 } from "../core/index.ts";
 /** Create one router per server request, await this, then render the provider. */
@@ -61,19 +60,7 @@ export async function loadRouter(
 
   return router;
 }
-/** Safe inside a script element. Data must be JSON serializable; error stacks and causes are omitted. */
-export function serialize(snapshot: Snapshot): string {
-  return JSON.stringify({
-    ...snapshot,
-    error: snapshot.error && {
-      name: snapshot.error.name,
-      message: snapshot.error.message,
-    },
-  })
-    .replace(/</g, "\\u003c")
-    .replace(/\u2028/g, "\\u2028")
-    .replace(/\u2029/g, "\\u2029");
-}
+export { serialize } from "../core/index.ts";
 
 /** Dispatch an HTTP data request to a registered server loader or action. */
 export async function handleRequest(

package/src/internal/vite/index.ts

@@ -8,6 +8,7 @@ export interface FileRouterOptions {
   directory?: string;
   clientRoutes?: string;
   serverRoutes?: string;
+  framework?: "react" | "preact";
 }
 
 /** Build-time flat route discovery and the optional server data transport. */
@@ -15,6 +16,7 @@ export function routerPlugin({
   directory = "src/routes",
   clientRoutes,
   serverRoutes,
+  framework = "react",
 }: FileRouterOptions = {}): Plugin {
   let root: string;
   let projectRoot: string;
@@ -173,7 +175,7 @@ export function routerPlugin({
         definitions.some((definition) => definition.startsWith("serverRoute("))
       )
         imports.unshift(
-          'import { serverRoute } from "@kasperrt/smolter/client";',
+          `import { serverRoute } from "@kasperrt/smolter/${framework}/client";`,
         );
 
       return `${imports.join("\n")}\nexport default [${definitions.join(",\n")}];\n`;
@@ -201,7 +203,7 @@ export function routerPlugin({
         server.watcher.off("unlink", refresh);
       });
 
-      configureTransport(server, publicId);
+      configureTransport(server, publicId, framework);
     },
   };
 }

package/src/internal/vite/transport.ts

@@ -3,6 +3,7 @@ import type { ViteDevServer } from "vite";
 export function configureTransport(
   server: ViteDevServer,
   publicId: string,
+  framework: "react" | "preact" = "react",
 ): void {
   server.middlewares.use((incoming, outgoing, next) => {
     if (!incoming.url?.startsWith("/_smolter?")) return next();
@@ -43,7 +44,7 @@ export function configureTransport(
       });
       const [{ default: routes }, { handleRequest }] = await Promise.all([
         server.ssrLoadModule(publicId),
-        server.ssrLoadModule("@kasperrt/smolter/server"),
+        server.ssrLoadModule(`@kasperrt/smolter/${framework}/server`),
       ]);
       const response: Response = await handleRequest(routes, request);
 

package/src/preact-client.ts

@@ -0,0 +1,2 @@
+/** Optional browser transport for server handlers. @module */
+export * from "./internal/client/index.ts";

package/src/preact-server.ts

@@ -0,0 +1,2 @@
+/** Preact server rendering and HTTP data dispatch. @module */
+export * from "./internal/server/index.ts";

package/src/preact-vite.ts

@@ -0,0 +1,18 @@
+/** Optional flat-file routing for Preact builds. @module */
+
+import type { Plugin } from "vite";
+import {
+  routerPlugin as createPlugin,
+  type FileRouterOptions,
+} from "./internal/vite/index.ts";
+
+export * from "./internal/files/index.ts";
+export type { FileRouterOptions } from "./internal/vite/index.ts";
+
+/** Configure flat routes and server transport for Preact. */
+export function routerPlugin(options: FileRouterOptions = {}): Plugin {
+  return createPlugin({ ...options, framework: "preact" });
+}
+
+/** File routing is the default; this alias keeps configuration explicit. */
+export const fileRouter = routerPlugin;

package/src/react-client.ts

@@ -0,0 +1,2 @@
+/** Optional browser transport for server handlers. @module */
+export * from "./internal/client/index.ts";

package/src/react-server.ts

@@ -0,0 +1,2 @@
+/** React server rendering and HTTP data dispatch. @module */
+export * from "./internal/server/index.ts";

package/src/react-vite.ts

@@ -0,0 +1,18 @@
+/** Optional flat-file routing for React builds. @module */
+
+import type { Plugin } from "vite";
+import {
+  routerPlugin as createPlugin,
+  type FileRouterOptions,
+} from "./internal/vite/index.ts";
+
+export * from "./internal/files/index.ts";
+export type { FileRouterOptions } from "./internal/vite/index.ts";
+
+/** Configure flat routes and server transport for React. */
+export function routerPlugin(options: FileRouterOptions = {}): Plugin {
+  return createPlugin({ ...options, framework: "react" });
+}
+
+/** File routing is the default; this alias keeps configuration explicit. */
+export const fileRouter = routerPlugin;

package/src/utils.ts

@@ -0,0 +1,5 @@
+/** Framework-independent, browser-safe utilities. @module */
+export * from "./internal/core/errors.ts";
+export * from "./internal/core/match.ts";
+export * from "./internal/core/serialize.ts";
+export * from "./internal/core/url.ts";