@kasperrt/smolter 0.2.0 → 0.3.1

package/dist/internal/react/hooks.js

@@ -1,35 +0,0 @@
-/**
- * React components and typed data hooks. Import from @kasperrt/smolter/react.
- * @module
- */
-import { useRouter, useSnapshot } from "./context.js";
-function useData(key, route) {
-    const path = route?.path;
-    return useSnapshot((snapshot) => {
-        if (path !== undefined && path !== snapshot.path)
-            return undefined;
-        return snapshot[key];
-    });
-}
-/** Pass a route for inference, or use useLoaderData<typeof loader>() in its module. */
-export function useLoaderData(route) {
-    return useData("data", route);
-}
-/** Read the last page action result, optionally inferring its type from a route. */
-export function useActionData(route) {
-    return useData("actionData", route);
-}
-/** Read path parameters for the active route. */
-export function useParams() {
-    return useSnapshot((snapshot) => snapshot.params);
-}
-/** Read the current path, search, and hash together with the navigate function. */
-export function useLocation() {
-    const router = useRouter();
-    const url = useSnapshot((snapshot) => snapshot.url);
-    return [url.replace(/^\w+:\/\/[^/]+/, ""), router.navigate];
-}
-/** Get the function that revalidates the current loader subject to shouldRevalidate. */
-export function useRevalidator() {
-    return useRouter().revalidate;
-}

package/dist/internal/react/index.js

@@ -1,7 +0,0 @@
-export { createRouter, defineRoute } from "../core/index.js";
-export { RouterProvider, useRouter, } from "./context.js";
-export * from "./fetcher.js";
-export * from "./form.js";
-export * from "./hooks.js";
-export * from "./link.js";
-export * from "./routes.js";

package/dist/internal/react/link.js

@@ -1,28 +0,0 @@
-/**
- * React components and typed data hooks. Import from @kasperrt/smolter/react.
- * @module
- */
-import { internalURL } from "../core/index.js";
-import { useRouter } from "./context.js";
-import { createElement } from "./runtime.js";
-/** Render an anchor that handles internal navigation and preserves native modified clicks. */
-export function Link({ href, replace, onClick, ...props }) {
-    const router = useRouter();
-    const click = (event) => {
-        onClick?.(event);
-        if (event.defaultPrevented ||
-            event.button ||
-            event.metaKey ||
-            event.ctrlKey ||
-            event.altKey ||
-            event.shiftKey ||
-            props.download !== undefined ||
-            (props.target && props.target !== "_self"))
-            return;
-        if (!internalURL(router.getSnapshot().url, href))
-            return;
-        event.preventDefault();
-        void router.navigate(href, { replace });
-    };
-    return createElement("a", { ...props, href, onClick: click });
-}

package/dist/internal/react/routes.js

@@ -1,22 +0,0 @@
-/**
- * React components and typed data hooks. Import from @kasperrt/smolter/react.
- * @module
- */
-import { useRouter, useSnapshot } from "./context.js";
-import { createElement, useMemo } from "./runtime.js";
-/** Renders the first matching registered module. */
-export function Routes({ fallback = null }) {
-    const router = useRouter();
-    const state = useSnapshot((snapshot) => snapshot);
-    const module = router.routes.find((route) => route.path === state.path);
-    const component = state.error
-        ? module?.ErrorBoundary
-        : state.state === "loading" && !state.loaded
-            ? module?.HydrateFallback
-            : module?.default;
-    const element = useMemo(() => component &&
-        createElement(component, {
-            error: state.error,
-        }), [component, state.error]);
-    return element ?? state.error?.message ?? fallback;
-}

package/dist/internal/react/runtime.js

@@ -1,2 +0,0 @@
-// @deno-types="npm:@types/react@19.3.0"
-export { createContext, createElement, useContext, useEffect, useMemo, useSyncExternalStore, } from "react";

package/dist/internal/server/index.js

@@ -1,69 +0,0 @@
-/**
- * Request-scoped server rendering and HTTP data dispatch.
- * @module
- */
-import { createRouter, matchRoutes, safeWrapAsync, } from "../core/index.js";
-/** Create one router per server request, await this, then render the provider. */
-export async function loadRouter(routes, input) {
-    const url = typeof input === "string" ? input : input.url;
-    const wrap = (handler) => {
-        if (!handler || typeof input === "string")
-            return handler;
-        return (args) => {
-            const signal = AbortSignal.any([input.signal, args.signal]);
-            const request = new Request(args.request, { signal });
-            input.headers.forEach((value, name) => {
-                if (!request.headers.has(name))
-                    request.headers.set(name, value);
-            });
-            return handler({ ...args, request, signal });
-        };
-    };
-    const serverRoutes = routes.map((route) => ({
-        ...route,
-        clientLoader: undefined,
-        clientAction: undefined,
-        loader: wrap(route.loader),
-        action: wrap(route.action),
-    }));
-    const router = createRouter(serverRoutes, { url });
-    await router.navigate(url);
-    const snapshot = router.getSnapshot();
-    if (!snapshot.error &&
-        snapshot.data === undefined &&
-        routes.some((route) => route.path === snapshot.path && route.clientLoader && !route.loader)) {
-        return createRouter(serverRoutes, {
-            url,
-            hydrationData: { ...snapshot, loaded: false, state: "loading" },
-        });
-    }
-    return router;
-}
-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);
-    const reading = request.method === "GET";
-    if (!match)
-        return Response.json({ error: "No route" }, { status: 404 });
-    if (!reading && !["POST", "PUT", "PATCH", "DELETE"].includes(request.method))
-        return Response.json({ error: "Method not allowed" }, { status: 405 });
-    const handler = reading ? match.route.loader : match.route.action;
-    if (!handler)
-        return Response.json({ error: `No ${reading ? "loader" : "action"}` }, { status: 405 });
-    const result = await safeWrapAsync(() => handler({ request, params: match.params, signal: request.signal }));
-    const error = result.error ?? (result.data instanceof Error && result.data);
-    if (error)
-        return Response.json({ error: error.message }, { status: 500 });
-    if (result.data instanceof Response) {
-        const location = result.data.headers.get("Location");
-        if (location)
-            return new Response(null, {
-                headers: { "X-Smolter-Redirect": location },
-            });
-        return result.data;
-    }
-    return Response.json(result.data ?? null, {
-        headers: { "Cache-Control": "no-store" },
-    });
-}

package/dist/internal/vite/index.js

@@ -1,132 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { resolve } from "node:path";
-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, 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, -suffix.length);
-                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
-                            : undefined;
-                        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);
-        },
-    };
-}
-/** File routing is the default; this alias keeps configuration explicit. */
-export const fileRouter = routerPlugin;

package/dist/internal/vite/transport.js

@@ -1,42 +0,0 @@
-export 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()));
-        };
-        void dispatch().catch(next);
-    });
-}

package/dist/preact-client.d.ts

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

package/dist/preact-client.js

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

package/dist/preact-server.d.ts

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

package/dist/preact-server.js

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

package/dist/preact-vite.js

@@ -1,9 +0,0 @@
-/** 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/preact.d.ts

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

package/dist/preact.js

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

package/dist/react-client.d.ts

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

package/dist/react-client.js

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

package/dist/react-server.d.ts

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

package/dist/react-server.js

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

package/dist/react-vite.js

@@ -1,9 +0,0 @@
-/** 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/react.d.ts

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

package/dist/react.js

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

package/dist/server.d.ts

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

package/dist/server.js

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

package/dist/utils.d.ts

@@ -1,5 +0,0 @@
-/** 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

@@ -1,5 +0,0 @@
-/** 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/dist/vite.d.ts

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

package/dist/vite.js

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

package/src/client.ts

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

package/src/core.ts

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

package/src/files.ts

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

package/src/internal/core/url.ts

@@ -1,6 +0,0 @@
-/** Resolve an internal URL; external links remain the browser's responsibility. */
-export function internalURL(base: string, href = base): URL | undefined {
-  const url = new URL(href, base);
-
-  if (url.origin === new URL(base).origin) return url;
-}

package/src/internal/preact/context.ts

@@ -1,46 +0,0 @@
-/**
- * Preact components and typed data hooks. Import from @kasperrt/smolter/preact.
- * @module
- */
-
-import type { Router, Snapshot } from "../core/index.ts";
-import type { ReactNode } from "./runtime.ts";
-import {
-  createContext,
-  createElement,
-  useContext,
-  useEffect,
-  useSyncExternalStore,
-} from "./runtime.ts";
-
-const RouterContext = createContext<Router | undefined>(undefined);
-
-/** Router instance and children rendered within its context. */
-export interface RouterProviderProps {
-  router: Router;
-  children?: ReactNode;
-}
-
-/** Provide a router to descendant hooks and connect its browser lifecycle. */
-export function RouterProvider({
-  router,
-  children,
-}: RouterProviderProps): ReactNode {
-  useEffect(router.start, [router]);
-
-  return createElement(RouterContext.Provider, { value: router }, children);
-}
-/** Hooks require a RouterProvider. */
-export function useRouter(): Router {
-  return useContext(RouterContext) as Router;
-}
-
-type SnapshotSelector<T> = (snapshot: Snapshot) => T;
-
-export function useSnapshot<T>(select: SnapshotSelector<T>): T {
-  const router = useRouter();
-
-  const getSnapshot = () => select(router.getSnapshot());
-
-  return useSyncExternalStore(router.subscribe, getSnapshot, getSnapshot);
-}

package/src/internal/preact/form.ts

@@ -1,79 +0,0 @@
-/**
- * Preact components and typed data hooks. Import from @kasperrt/smolter/preact.
- * @module
- */
-
-import type { Fetcher, SubmitOptions } from "../core/index.ts";
-import { internalURL } from "../core/index.ts";
-import { useRouter } from "./context.ts";
-import type { FormHTMLAttributes, ReactNode } from "./runtime.ts";
-import { createElement } from "./runtime.ts";
-
-/** Form attributes with GET loader requests or POST, PUT, PATCH, and DELETE actions. */
-export interface FormProps
-  extends Omit<FormHTMLAttributes<HTMLFormElement>, "action" | "method"> {
-  action?: string;
-  method?: "get" | "post" | "put" | "patch" | "delete";
-}
-
-type FormSubmitEvent = Parameters<NonNullable<FormProps["onSubmit"]>>[0];
-
-interface InternalFormProps extends FormProps {
-  fetcher?: Fetcher;
-}
-
-/** Submit form data to a registered route without a document reload. */
-export function Form({
-  action,
-  method = "post",
-  fetcher,
-  onSubmit,
-  ...props
-}: InternalFormProps): ReactNode {
-  const router = useRouter();
-  const submit = (event: FormSubmitEvent) => {
-    onSubmit?.(event);
-
-    if (event.defaultPrevented) return;
-
-    const submitter = (event as SubmitEvent).submitter;
-    const target = internalURL(
-      router.getSnapshot().url,
-      submitter?.getAttribute("formaction") ?? action,
-    );
-
-    if (!target) return;
-    event.preventDefault();
-
-    const data = new FormData(event.currentTarget, submitter);
-    const verb = (
-      submitter?.getAttribute("formmethod") ?? method
-    ).toUpperCase();
-
-    if (verb === "GET") {
-      const search = new URLSearchParams();
-
-      for (const [key, value] of data)
-        search.append(key, typeof value === "string" ? value : value.name);
-
-      target.search = String(search);
-
-      void (fetcher ? fetcher.load : router.navigate)(target.href);
-
-      return;
-    }
-
-    const options: SubmitOptions = {
-      method: verb as SubmitOptions["method"],
-    };
-
-    void (fetcher ?? router).submit(target.href, data, options);
-  };
-
-  return createElement("form", {
-    ...props,
-    action,
-    method: method === "get" ? "get" : "post",
-    onSubmit: submit,
-  });
-}

package/src/internal/preact/link.ts

@@ -1,46 +0,0 @@
-/**
- * Preact components and typed data hooks. Import from @kasperrt/smolter/preact.
- * @module
- */
-
-import { internalURL } from "../core/index.ts";
-import { useRouter } from "./context.ts";
-import type { AnchorHTMLAttributes, MouseEvent, ReactNode } from "./runtime.ts";
-import { createElement } from "./runtime.ts";
-
-/** Anchor attributes with internal navigation and optional history replacement. */
-export interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
-  href: string;
-  replace?: boolean;
-}
-
-/** Render an anchor that handles internal navigation and preserves native modified clicks. */
-export function Link({
-  href,
-  replace,
-  onClick,
-  ...props
-}: LinkProps): ReactNode {
-  const router = useRouter();
-  const click = (event: MouseEvent<HTMLAnchorElement>) => {
-    onClick?.(event);
-
-    if (
-      event.defaultPrevented ||
-      event.button ||
-      event.metaKey ||
-      event.ctrlKey ||
-      event.altKey ||
-      event.shiftKey ||
-      props.download !== undefined ||
-      (props.target && props.target !== "_self")
-    )
-      return;
-
-    if (!internalURL(router.getSnapshot().url, href)) return;
-    event.preventDefault();
-    void router.navigate(href, { replace });
-  };
-
-  return createElement("a", { ...props, href, onClick: click });
-}