@kasperrt/smolter 0.0.1 → 0.3.0

package/dist/vite/index.js

@@ -0,0 +1,104 @@
+import { flatRoutes } from "../files/index.js";
+import { configureTransport } from "./transport.js";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { transformWithOxc } from "vite";
+//#region .generated/vite/index.ts
+/** Build-time flat route discovery and the optional server data transport. */
+function routerPlugin({ directory = "src/routes", clientRoutes, serverRoutes, framework = "react" } = {}) {
+	let root;
+	let projectRoot;
+	const publicId = "virtual:smolter/routes";
+	const virtualId = `\0${publicId}`;
+	const suffix = "?smolter-client";
+	return {
+		name: "smolter-flat-routes",
+		enforce: "pre",
+		configResolved(config) {
+			projectRoot = config.root;
+			root = resolve(config.root, directory);
+		},
+		resolveId(id) {
+			if (id === publicId) return virtualId;
+		},
+		async load(id, options) {
+			if (id.endsWith(suffix)) {
+				const file = id.slice(0, -15);
+				const transformed = await transformWithOxc(await readFile(file, "utf8"), file);
+				const ast = this.parse(transformed.code);
+				const edits = [];
+				for (const statement of ast.body) {
+					if (statement.type === "ExportAllDeclaration") return this.error(`Use explicit named exports in ${file}; export * cannot be safely split between server and browser.`);
+					if (statement.type !== "ExportNamedDeclaration") continue;
+					const server = statement.specifiers.filter((specifier) => {
+						const name = specifier.exported.type === "Identifier" ? specifier.exported.name : specifier.exported.value;
+						return name === "loader" || name === "action";
+					});
+					if (!server.length) {
+						const declaration = statement.declaration;
+						const name = declaration?.type === "FunctionDeclaration" ? declaration.id?.name : void 0;
+						const variables = declaration?.type === "VariableDeclaration" ? declaration.declarations : [];
+						if (name === "loader" || name === "action" || variables.some((item) => item.id.type === "Identifier" && ["loader", "action"].includes(item.id.name))) return this.error(`Re-export loader/action from separate files in ${file}; inline server handlers cannot enter a browser module.`);
+						continue;
+					}
+					if (!statement.source || server.length !== statement.specifiers.length) return this.error(`Use separate export { loader } / export { action } statements in ${file}.`);
+					edits.push([statement.start, statement.end]);
+				}
+				let code = transformed.code;
+				for (const [start, end] of edits.reverse()) code = code.slice(0, start) + code.slice(end);
+				return {
+					code,
+					map: null
+				};
+			}
+			if (id !== virtualId) return;
+			if (clientRoutes || serverRoutes) {
+				if (!clientRoutes || !serverRoutes) return this.error("Specify both clientRoutes and serverRoutes for manual routing.");
+				const entry = resolve(projectRoot, options?.ssr ? serverRoutes : clientRoutes).replaceAll("\\", "/");
+				return `export { routes as default } from ${JSON.stringify(entry)};`;
+			}
+			const routes = await flatRoutes(root);
+			if (routes instanceof Error) return this.error(routes.message);
+			const imports = [];
+			const definitions = [];
+			for (const [index, route] of routes.entries()) {
+				this.addWatchFile(route.file);
+				const file = route.file.replaceAll("\\", "/");
+				const transformed = await transformWithOxc(await readFile(file, "utf8"), file);
+				const ast = this.parse(transformed.code);
+				const handlers = {};
+				for (const statement of ast.body) {
+					if (statement.type !== "ExportNamedDeclaration") continue;
+					for (const specifier of statement.specifiers) {
+						const name = specifier.exported.type === "Identifier" ? specifier.exported.name : specifier.exported.value;
+						if (name === "loader" || name === "action") handlers[name] = true;
+					}
+				}
+				imports.push(`import * as route${index} from ${JSON.stringify(file + (options?.ssr ? "" : suffix))};`);
+				definitions.push(options?.ssr || !Object.keys(handlers).length ? `{ ...route${index}, path: ${JSON.stringify(route.path)} }` : `serverRoute(${JSON.stringify(route.path)}, route${index}, ${JSON.stringify(handlers)})`);
+			}
+			if (!options?.ssr && definitions.some((definition) => definition.startsWith("serverRoute("))) imports.unshift(`import { serverRoute } from "@kasperrt/smolter/${framework}/client";`);
+			return `${imports.join("\n")}\nexport default [${definitions.join(",\n")}];\n`;
+		},
+		configureServer(server) {
+			server.watcher.add(root);
+			const refresh = (file) => {
+				if (!file.startsWith(`${root}/`)) return;
+				const module = server.moduleGraph.getModuleById(virtualId);
+				if (module) server.moduleGraph.invalidateModule(module);
+				server.ws.send({ type: "full-reload" });
+			};
+			server.watcher.on("add", refresh);
+			server.watcher.on("change", refresh);
+			server.watcher.on("unlink", refresh);
+			server.httpServer?.once("close", () => {
+				server.watcher.off("add", refresh);
+				server.watcher.off("change", refresh);
+				server.watcher.off("unlink", refresh);
+			});
+			configureTransport(server, publicId, framework);
+		}
+	};
+}
+//#endregion
+export { routerPlugin };

package/dist/vite/preact.d.ts

@@ -0,0 +1,11 @@
+/** Optional flat-file routing for Preact builds. @module */
+import type { Plugin } from "vite";
+import { type FileRouterOptions } from "./index.ts";
+export * from "../files/index.ts";
+export type { FileRouterOptions } from "./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;
+export type { ApplicationOptions } from "./application/vite.ts";
+export { applicationPlugins, preactConfig, } from "./application/vite.ts";

package/dist/vite/preact.js

@@ -0,0 +1,15 @@
+import { flatRoutes } from "../files/index.js";
+import { routerPlugin as routerPlugin$1 } from "./index.js";
+import { applicationPlugins, preactConfig } from "./application/vite.js";
+//#region .generated/vite/preact.ts
+/** Configure flat routes and server transport for Preact. */
+function routerPlugin(options = {}) {
+	return routerPlugin$1({
+		...options,
+		framework: "preact"
+	});
+}
+/** File routing is the default; this alias keeps configuration explicit. */
+var fileRouter = routerPlugin;
+//#endregion
+export { applicationPlugins, fileRouter, flatRoutes, preactConfig, routerPlugin };

package/dist/vite/react.d.ts

@@ -0,0 +1,9 @@
+/** Optional flat-file routing for React builds. @module */
+import type { Plugin } from "vite";
+import { type FileRouterOptions } from "./index.ts";
+export * from "../files/index.ts";
+export type { FileRouterOptions } from "./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/vite/react.js

@@ -0,0 +1,14 @@
+import { flatRoutes } from "../files/index.js";
+import { routerPlugin as routerPlugin$1 } from "./index.js";
+//#region .generated/vite/react.ts
+/** Configure flat routes and server transport for React. */
+function routerPlugin(options = {}) {
+	return routerPlugin$1({
+		...options,
+		framework: "react"
+	});
+}
+/** File routing is the default; this alias keeps configuration explicit. */
+var fileRouter = routerPlugin;
+//#endregion
+export { fileRouter, flatRoutes, routerPlugin };

package/dist/{internal/vite → 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/vite/transport.js

@@ -0,0 +1,35 @@
+//#region .generated/vite/transport.ts
+function configureTransport(server, publicId, framework = "react") {
+	server.middlewares.use((incoming, outgoing, next) => {
+		if (!incoming.url?.startsWith("/_smolter?")) return next();
+		const dispatch = async () => {
+			const origin = `http://${incoming.headers.host}`;
+			const target = new URL(incoming.url, origin).searchParams.get("url");
+			if (!target?.startsWith("/") || target.startsWith("//")) {
+				outgoing.statusCode = 400;
+				outgoing.end("Invalid route URL");
+				return;
+			}
+			const headers = new Headers();
+			for (const [name, value] of Object.entries(incoming.headers)) if (value) headers.set(name, Array.isArray(value) ? value.join(", ") : value);
+			const chunks = [];
+			for await (const chunk of incoming) chunks.push(chunk);
+			const controller = new AbortController();
+			outgoing.once("close", () => controller.abort());
+			const request = new Request(new URL(target, origin), {
+				signal: controller.signal,
+				method: incoming.method,
+				headers,
+				...incoming.method !== "GET" && { body: new Uint8Array(Buffer.concat(chunks)) }
+			});
+			const [{ default: routes }, { handleRequest }] = await Promise.all([server.ssrLoadModule(publicId), server.ssrLoadModule(`@kasperrt/smolter/${framework}/server`)]);
+			const response = await handleRequest(routes, request);
+			outgoing.statusCode = response.status;
+			response.headers.forEach((value, name) => outgoing.setHeader(name, value));
+			outgoing.end(new Uint8Array(await response.arrayBuffer()));
+		};
+		dispatch().catch(next);
+	});
+}
+//#endregion
+export { configureTransport };

package/jsr.json

@@ -1,22 +1,39 @@
 {
   "name": "@kasperrt/smolter",
-  "version": "0.0.1",
+  "version": "0.3.0",
   "exports": {
-    ".": "./src/core.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"
+    "./react": "./.generated/react/index.ts",
+    "./preact": "./.generated/preact/index.ts",
+    "./react/server": "./.generated/server/index.ts",
+    "./preact/server": "./.generated/server/preact.ts",
+    "./react/client": "./.generated/client/index.ts",
+    "./preact/client": "./.generated/preact/client.tsx",
+    "./utils": "./.generated/core/utils.ts",
+    "./utils/http": "./.generated/server/node.ts",
+    "./utils/assets": "./.generated/server/assets.ts",
+    "./utils/responses": "./.generated/core/responses.ts",
+    "./react/data": "./.generated/react/data.ts",
+    "./preact/lazy-route": "./.generated/preact/lazy-route.ts",
+    "./preact/document": "./.generated/preact/document.tsx"
   },
   "imports": {
     "react": "npm:react@19.3.1",
-    "preact/compat": "npm:preact@11.0.1/compat"
+    "preact/compat": "npm:preact@11.0.1/compat",
+    "preact": "npm:preact@11.0.1",
+    "preact/hooks": "npm:preact@11.0.1/hooks",
+    "preact/jsx-runtime": "npm:preact@11.0.1/jsx-runtime",
+    "preact-render-to-string": "npm:preact-render-to-string@6.8.1",
+    "react/jsx-runtime": "npm:react@19.3.1/jsx-runtime"
   },
   "publish": {
-    "include": ["src", "README.md", "LICENSE", "jsr.json"],
-    "exclude": ["src/vite.ts", "src/internal/vite"]
+    "include": [
+      ".generated",
+      "README.md",
+      "LICENSE",
+      "jsr.json",
+      "CHANGELOG.md"
+    ],
+    "exclude": [".generated/vite"]
   },
   "license": "MIT",
   "compatibility": {

package/package.json

@@ -1,64 +1,144 @@
 {
   "name": "@kasperrt/smolter",
-  "version": "0.0.1",
-  "description": "A tiny typed data router for React and Preact.",
+  "packageManager": "pnpm@11.8.0",
   "type": "module",
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "dev": "pnpm build && pnpm --parallel --filter \"@smolter/example-*\" dev",
+    "fix": "biome check --write .",
+    "lint": "biome check .",
+    "typecheck": "pnpm build && tsc --noEmit",
+    "test": "pnpm build && vitest run --project unit",
+    "coverage": "pnpm build && vitest run --coverage",
+    "smoke": "playwright test",
+    "size": "pnpm build && node scripts/size.mjs",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm size",
+    "version:patch": "node scripts/version.mjs patch",
+    "version:minor": "node scripts/version.mjs minor",
+    "version:release": "node scripts/version.mjs release",
+    "pack:smoke": "node scripts/pack-smoke.mjs",
+    "build:examples": "pnpm --filter \"@smolter/example-*\" build",
+    "smoke:production": "node scripts/production-smoke.mjs",
+    "jsr:check": "node scripts/jsr.mjs",
+    "build:site": "vite build --config apps/site/vite.config.ts && pnpm --filter @smolter/example-react build --mode hosted && pnpm --filter @smolter/example-preact build --mode hosted",
+    "smoke:site": "node scripts/site-smoke.mjs",
+    "docs:badges": "node scripts/readme-badges.mjs",
+    "docs:reference": "pnpm build && node scripts/docs-reference.mjs",
+    "docs:check": "pnpm build && node scripts/docs-reference.mjs --check"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.15",
+    "@playwright/test": "1.64.1",
+    "@smolter/client": "workspace:*",
+    "@smolter/core": "workspace:*",
+    "@smolter/files": "workspace:*",
+    "@smolter/preact": "workspace:*",
+    "@smolter/react": "workspace:*",
+    "@smolter/server": "workspace:*",
+    "@smolter/vite": "workspace:*",
+    "@types/node": "24.10.1",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "@vitejs/plugin-react": "6.1.2",
+    "@vitest/browser-playwright": "5.0.5",
+    "@vitest/coverage-v8": "5.0.5",
+    "esbuild": "0.28.2",
+    "oxc-transform-react": "0.152.0",
+    "preact": "11.0.1",
+    "preact-render-to-string": "6.8.1",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "react-router": "8.4.0",
+    "terser": "5.44.1",
+    "typescript": "6.0.3",
+    "vite": "8.3.4",
+    "vitest": "5.0.5",
+    "wouter": "3.13.0",
+    "wouter-preact": "3.13.0"
+  },
+  "version": "0.3.0",
+  "description": "A tiny typed data router for React and Preact.",
   "sideEffects": false,
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/kasperrt/smolter.git",
-    "directory": "packages/smolter"
+    "url": "git+https://github.com/kasperrt/smolter.git"
   },
   "exports": {
-    ".": {
-      "types": "./dist/core.d.ts",
-      "import": "./dist/core.js"
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
     },
     "./preact": {
-      "types": "./dist/preact.d.ts",
-      "import": "./dist/preact.js"
+      "types": "./dist/preact/index.d.ts",
+      "import": "./dist/preact/index.js"
     },
-    "./core": {
-      "types": "./dist/core.d.ts",
-      "import": "./dist/core.js"
+    "./react/server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
     },
-    "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js"
+    "./preact/server": {
+      "types": "./dist/server/preact.d.ts",
+      "import": "./dist/server/preact.js"
     },
-    "./files": {
-      "types": "./dist/files.d.ts",
-      "import": "./dist/files.js"
+    "./react/client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.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"
+    "./react/vite": {
+      "types": "./dist/vite/react.d.ts",
+      "import": "./dist/vite/react.js"
     },
-    "./package.json": "./package.json",
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js"
+    "./preact/vite": {
+      "types": "./dist/vite/preact.d.ts",
+      "import": "./dist/vite/preact.js"
+    },
+    "./utils": {
+      "types": "./dist/core/utils.d.ts",
+      "import": "./dist/core/utils.js"
+    },
+    "./utils/http": {
+      "types": "./dist/server/node.d.ts",
+      "import": "./dist/server/node.js"
+    },
+    "./utils/assets": {
+      "types": "./dist/server/assets.d.ts",
+      "import": "./dist/server/assets.js"
+    },
+    "./utils/responses": {
+      "types": "./dist/core/responses.d.ts",
+      "import": "./dist/core/responses.js"
+    },
+    "./react/data": {
+      "types": "./dist/react/data.d.ts",
+      "import": "./dist/react/data.js"
+    },
+    "./preact/lazy-route": {
+      "types": "./dist/preact/lazy-route.d.ts",
+      "import": "./dist/preact/lazy-route.js"
+    },
+    "./preact/document": {
+      "types": "./dist/preact/document.d.ts",
+      "import": "./dist/preact/document.js"
     }
   },
   "files": [
     "dist",
-    "src",
+    ".generated",
     "README.md",
     "LICENSE",
-    "jsr.json"
+    "jsr.json",
+    "CHANGELOG.md"
   ],
-  "scripts": {
-    "build": "node ../../scripts/build.mjs"
-  },
   "peerDependencies": {
     "react": ">=18",
-    "preact": ">=10.25.0",
-    "vite": ">=8"
+    "preact": ">=11.0.1",
+    "vite": ">=8",
+    "preact-render-to-string": ">=6"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -69,9 +149,12 @@
     },
     "vite": {
       "optional": true
+    },
+    "preact-render-to-string": {
+      "optional": true
     }
   },
-  "author": "Kasper Rynning-Tønnesen <kasperrt@users.noreply.github.com> (https://github.com/kasperrt)",
+  "author": "Kasper Rynning-T\u00f8nnesen <kasperrt@users.noreply.github.com> (https://github.com/kasperrt)",
   "homepage": "https://kasperrt.github.io/smolter/",
   "bugs": {
     "url": "https://github.com/kasperrt/smolter/issues"
@@ -87,8 +170,6 @@
     "ssr",
     "file-routing"
   ],
-  "main": "./dist/core.js",
-  "types": "./dist/core.d.ts",
   "publishConfig": {
     "access": "public",
     "provenance": true

package/dist/client.d.ts

@@ -1,2 +0,0 @@
-/** Client entry point. @module */
-export * from "./internal/client/index.ts";

package/dist/client.js

@@ -1,2 +0,0 @@
-/** Client entry point. @module */
-export * from "./internal/client/index.js";

package/dist/core.d.ts

@@ -1,2 +0,0 @@
-/** Core entry point. @module */
-export * from "./internal/core/index.ts";

package/dist/core.js

@@ -1,2 +0,0 @@
-/** Core entry point. @module */
-export * from "./internal/core/index.js";

package/dist/files.d.ts

@@ -1,2 +0,0 @@
-/** Files entry point. @module */
-export * from "./internal/files/index.ts";

package/dist/files.js

@@ -1,2 +0,0 @@
-/** Files entry point. @module */
-export * from "./internal/files/index.js";

package/dist/internal/client/deserialize.js

@@ -1,11 +0,0 @@
-/** Restore a trusted snapshot produced by @kasperrt/smolter/server serialize, including its route error. */
-export function deserialize(json) {
-    const snapshot = JSON.parse(json);
-    const error = snapshot.error;
-    if (error) {
-        snapshot.error = Object.assign(new Error(error.message), {
-            name: error.name,
-        });
-    }
-    return snapshot;
-}

package/dist/internal/client/index.js

@@ -1,44 +0,0 @@
-/**
- * Optional browser transport for server loaders and actions.
- * @module
- */
-export { deserialize } from "./deserialize.js";
-/** Browser transport for server routes. File-router builds generate this call. */
-export function serverRoute(path, module, handlers = { loader: true, action: true }) {
-    const remote = async ({ request, signal }) => {
-        const url = new URL(request.url);
-        const response = await fetch(`/_smolter?url=${encodeURIComponent(url.pathname + url.search)}`, {
-            method: request.method,
-            signal,
-            ...(request.method !== "GET" && { body: await request.formData() }),
-        });
-        const location = response.headers.get("X-Smolter-Redirect");
-        if (location)
-            return new Response(null, {
-                status: 303,
-                headers: { Location: location },
-            });
-        const data = await response.json();
-        if (!response.ok)
-            return new Error(data.error ?? "Route request failed");
-        return data;
-    };
-    return {
-        ...module,
-        path,
-        ...(handlers.loader && { loader: remote }),
-        ...(handlers.action && { action: remote }),
-        ...(module.clientLoader && {
-            clientLoader: (args) => module.clientLoader({ ...args, serverLoader: () => remote(args) }),
-        }),
-        ...(module.clientAction && {
-            clientAction: (args) => {
-                const request = args.request.clone();
-                return module.clientAction({
-                    ...args,
-                    serverAction: () => remote({ ...args, request: request.clone() }),
-                });
-            },
-        }),
-    };
-}

package/dist/internal/core/errors.js

@@ -1,6 +0,0 @@
-/** Resolve returned or rejected errors into Error values without losing their cause. */
-export function safeWrapAsync(work) {
-    return Promise.resolve()
-        .then(work)
-        .then((data) => (data instanceof Error ? { error: data } : { data }), (cause) => ({ error: new Error(String(cause), { cause }) }));
-}

package/dist/internal/core/index.js

@@ -1,6 +0,0 @@
-/** Framework-independent data routing. @module */
-export * from "./errors.js";
-export * from "./match.js";
-export * from "./router.js";
-export * from "./types.js";
-export * from "./url.js";

package/dist/internal/core/match.js

@@ -1,27 +0,0 @@
-/** Associate a URL pattern with a module while retaining its inferred handler types. */
-export function defineRoute(path, module) {
-    return { ...module, path };
-}
-/** Static segments, :params and a terminal * wildcard; first match wins. */
-export function matchRoutes(routes, pathname) {
-    const segments = pathname.replace(/\/$/, "").split("/");
-    for (const route of routes) {
-        const parts = route.path.replace(/\/$/, "").split("/");
-        const params = {};
-        const matched = (parts.length === segments.length || parts.at(-1) === "*") &&
-            parts.every((part, index) => {
-                const value = segments[index];
-                if (part === "*") {
-                    params["*"] = segments.slice(index).join("/");
-                    return true;
-                }
-                if (part[0] === ":" && value) {
-                    params[part.slice(1)] = new URLSearchParams(`=${value.replace(/[+&]/g, encodeURIComponent)}`).get("");
-                    return true;
-                }
-                return part === value;
-            });
-        if (matched)
-            return { route, params };
-    }
-}