@praxisjs/ssg 0.1.0

package/dist/__tests__/resolve-sync.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-sync.test.js","sourceRoot":"","sources":["../../src/__tests__/resolve-sync.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/routes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routes.test.d.ts.map

package/dist/__tests__/routes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/routes.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/routes.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect } from "vitest";
+import { flattenRoutes, isStaticPath, pathToOutputFile, resolvePaths } from "../routes";
+const Noop = class {
+};
+describe("flattenRoutes", () => {
+    it("flattens a flat route list unchanged", () => {
+        const routes = [
+            { path: "/", component: Noop },
+            { path: "/about", component: Noop },
+        ];
+        expect(flattenRoutes(routes).map((r) => r.fullPath)).toEqual(["/", "/about"]);
+    });
+    it("prefixes nested children with the parent path", () => {
+        const routes = [
+            {
+                path: "/blog",
+                component: Noop,
+                children: [
+                    { path: "/", component: Noop },
+                    { path: "/:slug", component: Noop },
+                ],
+            },
+        ];
+        expect(flattenRoutes(routes).map((r) => r.fullPath)).toEqual(["/blog", "/blog/", "/blog/:slug"]);
+    });
+    it("treats a root parent's prefix as empty, matching RouterInstance.addRoute", () => {
+        const routes = [
+            {
+                path: "/",
+                component: Noop,
+                children: [{ path: "/dashboard", component: Noop }],
+            },
+        ];
+        expect(flattenRoutes(routes).map((r) => r.fullPath)).toEqual(["/", "/dashboard"]);
+    });
+});
+describe("isStaticPath", () => {
+    it("treats plain paths as static", () => {
+        expect(isStaticPath("/about")).toBe(true);
+        expect(isStaticPath("/")).toBe(true);
+    });
+    it("treats :param segments as dynamic", () => {
+        expect(isStaticPath("/blog/:slug")).toBe(false);
+    });
+    it("treats optional :param? segments as dynamic", () => {
+        expect(isStaticPath("/users/:id?")).toBe(false);
+    });
+    it("treats ** catch-alls as dynamic", () => {
+        expect(isStaticPath("/docs/**")).toBe(false);
+    });
+});
+describe("resolvePaths", () => {
+    it("returns static paths as-is", async () => {
+        const routes = [
+            { path: "/", component: Noop },
+            { path: "/about", component: Noop },
+        ];
+        expect(await resolvePaths({ routes })).toEqual(["/", "/about"]);
+    });
+    it("expands a dynamic route via getStaticPaths", async () => {
+        const routes = [{ path: "/blog/:slug", component: Noop }];
+        const paths = await resolvePaths({
+            routes,
+            getStaticPaths: async () => ["/blog/hello", "/blog/world"],
+        });
+        expect(paths).toEqual(["/blog/hello", "/blog/world"]);
+    });
+    it("skips dynamic routes with no getStaticPaths", async () => {
+        const routes = [
+            { path: "/", component: Noop },
+            { path: "/blog/:slug", component: Noop },
+        ];
+        expect(await resolvePaths({ routes })).toEqual(["/"]);
+    });
+    it("passes the route and its full path pattern to getStaticPaths", async () => {
+        const target = { path: "/blog/:slug", component: Noop };
+        const routes = [target];
+        let seen;
+        await resolvePaths({
+            routes,
+            getStaticPaths: async (route, fullPath) => {
+                seen = [route, fullPath];
+                return [];
+            },
+        });
+        expect(seen).toEqual([target, "/blog/:slug"]);
+    });
+    it("de-duplicates paths across routes", async () => {
+        const routes = [
+            { path: "/blog/:slug", component: Noop },
+            { path: "/other/:slug", component: Noop },
+        ];
+        const paths = await resolvePaths({
+            routes,
+            getStaticPaths: async () => ["/shared"],
+        });
+        expect(paths).toEqual(["/shared"]);
+    });
+    it("expands a dynamic route via its own colocated getStaticPaths, with no global fallback needed", async () => {
+        const routes = [
+            { path: "/blog/:slug", component: Noop, getStaticPaths: async () => ["/blog/hello", "/blog/world"] },
+        ];
+        expect(await resolvePaths({ routes })).toEqual(["/blog/hello", "/blog/world"]);
+    });
+    it("passes the route's own full path to its colocated getStaticPaths", async () => {
+        let seen;
+        const routes = [
+            {
+                path: "/blog/:slug",
+                component: Noop,
+                getStaticPaths: async (fullPath) => {
+                    seen = fullPath;
+                    return [];
+                },
+            },
+        ];
+        await resolvePaths({ routes });
+        expect(seen).toBe("/blog/:slug");
+    });
+    it("prefers a route's own getStaticPaths over the global fallback", async () => {
+        const routes = [
+            { path: "/blog/:slug", component: Noop, getStaticPaths: async () => ["/blog/own"] },
+        ];
+        const paths = await resolvePaths({
+            routes,
+            getStaticPaths: async () => ["/blog/global"],
+        });
+        expect(paths).toEqual(["/blog/own"]);
+    });
+    it("falls back to the global getStaticPaths for routes with no colocated one, alongside routes that have their own", async () => {
+        const routes = [
+            { path: "/blog/:slug", component: Noop, getStaticPaths: async () => ["/blog/own"] },
+            { path: "/other/:slug", component: Noop },
+        ];
+        const paths = await resolvePaths({
+            routes,
+            getStaticPaths: async (_route, fullPath) => (fullPath === "/other/:slug" ? ["/other/global"] : []),
+        });
+        expect(paths).toEqual(["/blog/own", "/other/global"]);
+    });
+});
+describe("pathToOutputFile", () => {
+    it("maps the root path to index.html", () => {
+        expect(pathToOutputFile("/")).toBe("index.html");
+    });
+    it("maps a nested path to <path>/index.html", () => {
+        expect(pathToOutputFile("/about")).toBe("about/index.html");
+        expect(pathToOutputFile("/blog/hello-world")).toBe("blog/hello-world/index.html");
+    });
+    it("normalizes surrounding slashes", () => {
+        expect(pathToOutputFile("/about/")).toBe("about/index.html");
+    });
+});
+//# sourceMappingURL=routes.test.js.map

package/dist/__tests__/routes.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.test.js","sourceRoot":"","sources":["../../src/__tests__/routes.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { type Plugin } from "vite";
+import type { RouterOptions } from "@praxisjs/router";
+export type { GetStaticPaths, RouteEntry, RouteStaticPaths } from "./routes";
+export interface SSGConfig {
+    /**
+     * Module specifier exporting the root component as its default export and
+     * the route table (same one passed to `@Router([...])`) as a named
+     * `routes` export, e.g. `"./src/app.tsx"`. Loaded through Vite's own SSR
+     * module graph — not imported directly by `vite.config.ts` — so the config
+     * file itself never needs to resolve JSX/component source.
+     *
+     * A dynamic route can expand itself into concrete paths by declaring its
+     * own `getStaticPaths` directly on the route object (see `RouteEntry`) —
+     * the recommended default, since it's colocated with the route and needs
+     * no path matching. `root` may *also* export a named `getStaticPaths` as a
+     * fallback for routes that don't declare their own; a route's own always
+     * takes precedence.
+     *
+     * Either way, this can only be reached through `root`, never passed as a
+     * plain config value here: Vite's own config loader bundles
+     * `vite.config.ts` with a minimal bundler that inlines relative imports
+     * (only bare package specifiers get externalized) but never lowers TC39
+     * decorators. A `getStaticPaths` written inline in `vite.config.ts` that
+     * reaches a decorated class through a relative import — e.g. one that
+     * loads a `@Collection`-decorated schema to enumerate content slugs —
+     * would bundle that raw decorator syntax straight into the config bundle,
+     * which Node cannot then execute. Exporting it from the same module as
+     * `root` (or from a route reachable from it) avoids this: it only ever
+     * loads through `ssrLoadModule`, which runs the app's real Vite pipeline
+     * (decorator lowering included).
+     */
+    root: string;
+    routerOptions?: RouterOptions;
+    /** CSS selector for the mount container inside `index.html`. Default: `#app`. */
+    containerSelector?: string;
+    /**
+     * Enables client-side hydration (reconciling the prerendered DOM instead of
+     * discarding it). Default: `true`. Set to `false` to fall back to a plain
+     * client remount over the static HTML — no reconciliation runs at all,
+     * client or server, and `render()` in `@praxisjs/runtime` never sees the
+     * hydration marker.
+     */
+    hydrate?: boolean;
+}
+/**
+ * Installs the retry hook above for the rest of this process. Idempotent.
+ * `ssgPlugin()` calls this itself before dynamically importing
+ * `@praxisjs/ssg/prerender` — only needed directly if you're calling
+ * `prerender()` from your own Node script instead of going through
+ * `ssgPlugin()`, and must run before that import.
+ *
+ * Prefers `module.registerHooks()` (in-thread, sync, Node 22.15+) and falls
+ * back to the older `module.register()` (off-thread, needs its own module
+ * file — see loader-hook.ts, the asynchronous twin of `resolveSync` above)
+ * on earlier Node versions.
+ */
+export declare function registerLoaderHook(): void;
+export declare function ssgPlugin(config: SSGConfig): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,MAAM,EAAuB,MAAM,MAAM,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOtD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7E,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA6CD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CASzC;AAoED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA2CnD"}

package/dist/index.js

@@ -0,0 +1,156 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import * as nodeModule from "node:module";
+import { dirname, join } from "node:path";
+import { createServer } from "vite";
+// ── extensionless-relative-import retry hook ────────────────────────────────
+//
+// Every other @praxisjs/* package is built with tsc, which emits relative
+// specifiers exactly as written in source ("./router", not "./router.js") —
+// harmless for every consumer so far, since they're all resolved through a
+// bundler (Vite/esbuild/rollup), which resolves extensionless specifiers
+// fine. Node's own ESM resolver does not: it's spec-strict and requires an
+// explicit extension on relative specifiers, and @praxisjs/ssg is the first
+// package here that needs to load that dependency chain (router, core, head,
+// runtime) directly through Node, when `closeBundle` below dynamically
+// imports ./prerender.
+//
+// This lives inline in the package's main entry, with zero relative imports
+// of its own, rather than in a separate module: `registerLoaderHook()` must
+// run *before* anything reachable from this file needs the workaround it
+// installs, and a relative import here would hit the exact problem it's
+// meant to fix before it ever gets the chance to run.
+const RETRYABLE_CODES = new Set(["ERR_MODULE_NOT_FOUND", "ERR_UNSUPPORTED_DIR_IMPORT"]);
+function resolveSync(specifier, context, nextResolve) {
+    try {
+        return nextResolve(specifier, context);
+    }
+    catch (err) {
+        const code = err.code;
+        if ((specifier.startsWith("./") || specifier.startsWith("../")) && code !== undefined && RETRYABLE_CODES.has(code)) {
+            for (const candidate of [`${specifier}.js`, `${specifier}/index.js`]) {
+                try {
+                    return nextResolve(candidate, context);
+                }
+                catch {
+                    // try the next candidate
+                }
+            }
+        }
+        throw err;
+    }
+}
+let hookRegistered = false;
+/**
+ * Installs the retry hook above for the rest of this process. Idempotent.
+ * `ssgPlugin()` calls this itself before dynamically importing
+ * `@praxisjs/ssg/prerender` — only needed directly if you're calling
+ * `prerender()` from your own Node script instead of going through
+ * `ssgPlugin()`, and must run before that import.
+ *
+ * Prefers `module.registerHooks()` (in-thread, sync, Node 22.15+) and falls
+ * back to the older `module.register()` (off-thread, needs its own module
+ * file — see loader-hook.ts, the asynchronous twin of `resolveSync` above)
+ * on earlier Node versions.
+ */
+export function registerLoaderHook() {
+    if (hookRegistered)
+        return;
+    hookRegistered = true;
+    if (typeof nodeModule.registerHooks === "function") {
+        nodeModule.registerHooks({ resolve: resolveSync });
+    }
+    else {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- intentional fallback for Node < 22.15, which has no registerHooks
+        nodeModule.register(new URL("./loader-hook.js", import.meta.url));
+    }
+}
+async function loadEntry(resolvedConfig, root, withDomGlobals) {
+    const server = await createServer({
+        configFile: resolvedConfig.configFile,
+        root: resolvedConfig.root,
+        server: { middlewareMode: true, watch: null },
+        appType: "custom",
+        // Every @praxisjs/* package (and anything else in node_modules) must
+        // resolve through plain Node `import()` here — the same path `prerender()`
+        // itself uses to load @praxisjs/core/runtime/router/head — instead of
+        // being re-processed through Vite's SSR transform. Two different copies
+        // of @praxisjs/core would mean two separate component-instance registries:
+        // mountComponent() (from the plain-Node copy prerender.ts imports) would
+        // construct instances that @Router([...])'s decorator (baked into the
+        // Vite-SSR-transformed copy the root module was loaded with) doesn't
+        // recognize as valid components.
+        ssr: { external: true },
+        // No client ever connects to this server and nothing here benefits from
+        // pre-bundling npm deps for browser delivery — and a background
+        // (re-)optimization pass restarting mid-request looked like a plausible
+        // cause of "transport was disconnected" errors on lazy-loaded routes.
+        optimizeDeps: { noDiscovery: true, include: [] },
+    });
+    try {
+        // @Router([...])'s class decorator calls createRouter() at
+        // module-evaluation time — ssrLoadModule() below runs that as a side
+        // effect of importing the root module, so it needs *a* window in place
+        // already, even though nothing is actually being rendered yet (the real,
+        // per-route window gets installed later, in prerender()).
+        const mod = await withDomGlobals("<!doctype html><html><head></head><body></body></html>", "http://localhost/", async () => {
+            return (await server.ssrLoadModule(root));
+        });
+        if (!mod.default) {
+            throw new Error(`[@praxisjs/ssg] "${root}" has no default export — expected the root component.`);
+        }
+        if (!mod.routes) {
+            throw new Error(`[@praxisjs/ssg] "${root}" has no named "routes" export — expected the same route table passed to @Router([...]).`);
+        }
+        // Left open, closed by the caller after prerender() finishes: routes
+        // wrapped in Lazy(() => import(...)) keep their loader closures bound to
+        // *this* server's module runner for as long as they might still be
+        // invoked — closing it here would break lazy routes on every page after
+        // the first that needs them.
+        return { root: mod.default, routes: mod.routes, getStaticPaths: mod.getStaticPaths, close: () => server.close() };
+    }
+    catch (err) {
+        await server.close();
+        throw err;
+    }
+}
+export function ssgPlugin(config) {
+    let resolvedConfig;
+    // Before anything below ever dynamically imports ./prerender — see the
+    // retry-hook section above for why this needs to happen here.
+    registerLoaderHook();
+    return {
+        name: "praxisjs:ssg",
+        apply: "build",
+        configResolved(c) {
+            resolvedConfig = c;
+        },
+        async closeBundle() {
+            const { prerender, withDomGlobals } = (await import("./prerender"));
+            const outDir = resolvedConfig.build.outDir;
+            const templatePath = join(resolvedConfig.root, outDir, "index.html");
+            const template = await readFile(templatePath, "utf-8");
+            const { root, routes, getStaticPaths, close } = await loadEntry(resolvedConfig, config.root, withDomGlobals);
+            let pages;
+            try {
+                pages = await prerender({
+                    root,
+                    routes,
+                    routerOptions: config.routerOptions,
+                    getStaticPaths,
+                    template,
+                    containerSelector: config.containerSelector,
+                    hydrate: config.hydrate,
+                });
+            }
+            finally {
+                await close();
+            }
+            for (const page of pages) {
+                const outFile = join(resolvedConfig.root, outDir, page.file);
+                await mkdir(dirname(outFile), { recursive: true });
+                await writeFile(outFile, page.html, "utf-8");
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/loader-hook.d.ts

@@ -0,0 +1,5 @@
+import type { ResolveFnOutput, ResolveHookContext } from "node:module";
+type NextResolve = (specifier: string, context?: Partial<ResolveHookContext>) => ResolveFnOutput | Promise<ResolveFnOutput>;
+export declare function resolve(specifier: string, context: ResolveHookContext, nextResolve: NextResolve): Promise<ResolveFnOutput>;
+export {};
+//# sourceMappingURL=loader-hook.d.ts.map

package/dist/loader-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-hook.d.ts","sourceRoot":"","sources":["../src/loader-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAiBvE,KAAK,WAAW,GAAG,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAClC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEhD,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,eAAe,CAAC,CAgB1B"}

package/dist/loader-hook.js

@@ -0,0 +1,34 @@
+// Loaded as a standalone hook module via module.register() (see register.ts)
+// — only used as a fallback on Node versions without the newer, in-thread
+// module.registerHooks() API, so it must have zero relative imports of its
+// own: this file needs to work *before* the extensionless-import problem it
+// exists to fix has been worked around. See register.ts for the full story.
+//
+// Every other @praxisjs/* package is built with tsc, which emits relative
+// specifiers exactly as written in source ("./router", not "./router.js") —
+// harmless for every consumer so far, since they're all resolved through a
+// bundler (Vite/esbuild/rollup), which resolves extensionless specifiers
+// fine. Node's own ESM resolver does not: it's spec-strict and requires an
+// explicit extension on relative specifiers. This hook retries with ".js" /
+// "/index.js" on the two failure modes that produces.
+const RETRYABLE_CODES = new Set(["ERR_MODULE_NOT_FOUND", "ERR_UNSUPPORTED_DIR_IMPORT"]);
+export async function resolve(specifier, context, nextResolve) {
+    try {
+        return await nextResolve(specifier, context);
+    }
+    catch (err) {
+        const code = err.code;
+        if ((specifier.startsWith("./") || specifier.startsWith("../")) && code !== undefined && RETRYABLE_CODES.has(code)) {
+            for (const candidate of [`${specifier}.js`, `${specifier}/index.js`]) {
+                try {
+                    return await nextResolve(candidate, context);
+                }
+                catch {
+                    // try the next candidate
+                }
+            }
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=loader-hook.js.map

package/dist/loader-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-hook.js","sourceRoot":"","sources":["../src/loader-hook.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,4EAA4E;AAC5E,sDAAsD;AACtD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,sBAAsB,EAAE,4BAA4B,CAAC,CAAC,CAAC;AAOxF,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,OAA2B,EAC3B,WAAwB;IAExB,IAAI,CAAC;QACH,OAAO,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,SAAS,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnH,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,SAAS,KAAK,EAAE,GAAG,SAAS,WAAW,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC;oBACH,OAAO,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBAC/C,CAAC;gBAAC,MAAM,CAAC;oBACP,yBAAyB;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/prerender.d.ts

@@ -0,0 +1,38 @@
+import { JSDOM } from "jsdom";
+import type { RouterOptions } from "@praxisjs/router";
+import type { ComponentConstructor } from "@praxisjs/shared/internal";
+import { type GetStaticPaths, type RouteEntry } from "./routes";
+export { flattenRoutes, isStaticPath, normalizeRoutes, pathToOutputFile, resolvePaths, type FlattenedRoute, type ResolvePathsConfig } from "./routes";
+export interface PrerenderConfig {
+    /** Root component class — same one passed to `@Router([...])`/mounted by `main.tsx`. */
+    root: ComponentConstructor;
+    /** Same route table passed to `@Router([...])` — a mix of RouteDefinitions and bare @Route-decorated classes is fine, same as the decorator itself accepts. */
+    routes: RouteEntry[];
+    routerOptions?: RouterOptions;
+    /** Global fallback for expanding a dynamic route (`:slug`, `**`) into concrete paths — a route with its own `getStaticPaths` uses that instead. Dynamic routes with neither are skipped. */
+    getStaticPaths?: GetStaticPaths;
+    /** The built `index.html` content — reused as the template for every page. */
+    template: string;
+    /** CSS selector for the mount container inside `template`. Default: `#app`. */
+    containerSelector?: string;
+    /** Whether to mark output HTML for client-side hydration. Default: `true`. When `false`, the client falls back to a full remount instead of reconciling. */
+    hydrate?: boolean;
+}
+export interface PrerenderedPage {
+    path: string;
+    /** Output file path relative to the SSG out dir, e.g. `about/index.html`. */
+    file: string;
+    html: string;
+}
+export declare function prerender(config: PrerenderConfig): Promise<PrerenderedPage[]>;
+/**
+ * Runs `fn` with a fresh JSDOM's `window`/`document`/etc installed as globals
+ * for its duration, then restores whatever was there before. Exported so
+ * `index.ts`'s `loadEntry()` can use it too: `ssrLoadModule()`-ing the app's
+ * root module runs `@Router([...])`'s class decorator, which calls
+ * `createRouter()` immediately (at module-evaluation time) — that needs a
+ * `window` in place just as much as the real per-route render below does,
+ * even though it's not rendering anything itself yet.
+ */
+export declare function withDomGlobals<T>(html: string, url: string, fn: (dom: JSDOM) => Promise<T>): Promise<T>;
+//# sourceMappingURL=prerender.d.ts.map

package/dist/prerender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerender.d.ts","sourceRoot":"","sources":["../src/prerender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAQ9B,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAmD,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAMjH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAItJ,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+JAA+J;IAC/J,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,4LAA4L;IAC5L,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4JAA4J;IAC5J,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAgBnF;AAoDD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ7G"}

package/dist/prerender.js

@@ -0,0 +1,116 @@
+import { JSDOM } from "jsdom";
+import { flushPendingResources, isServerRenderPass, setServerRenderPass, } from "@praxisjs/core/internal";
+import { resetHeadState } from "@praxisjs/head/internal";
+import { createRouter } from "@praxisjs/router/internal";
+import { getCurrentScope, mountComponent, render } from "@praxisjs/runtime";
+import { normalizeRoutes, pathToOutputFile, resolvePaths } from "./routes";
+// Re-exported here (this whole file, plus these, only resolves once the
+// loader hook is registered — see register.ts) rather than from the main
+// package entry, so importing `ssgPlugin` alone never needs router/core/head
+// resolved statically. See index.ts.
+export { flattenRoutes, isStaticPath, normalizeRoutes, pathToOutputFile, resolvePaths } from "./routes";
+const SSG_MARKER = "data-praxis-ssg";
+export async function prerender(config) {
+    const { getStaticPaths } = config;
+    const routes = normalizeRoutes(config.routes);
+    const paths = await resolvePaths({ routes, getStaticPaths });
+    const wasServerPass = isServerRenderPass();
+    setServerRenderPass(true);
+    try {
+        const pages = [];
+        for (const path of paths) {
+            pages.push(await renderPage(path, { ...config, routes }));
+        }
+        return pages;
+    }
+    finally {
+        setServerRenderPass(wasServerPass);
+    }
+}
+const PATCHED_GLOBALS = ["window", "document", "navigator", "history", "location", "Node", "Comment", "Text", "Element", "HTMLElement"];
+// Modern Node already defines some of these itself (globalThis.navigator is a
+// getter-only built-in since Node 21) — plain assignment throws on those, so
+// every property is installed *and* restored via defineProperty, capturing
+// the original descriptor (not just its value) to put back exactly what was
+// there, getter and all, rather than flattening it into a plain value.
+function installDomGlobals(dom) {
+    const g = globalThis;
+    const snapshot = {};
+    for (const key of PATCHED_GLOBALS) {
+        const descriptor = Object.getOwnPropertyDescriptor(globalThis, key);
+        if (descriptor)
+            snapshot[key] = descriptor;
+    }
+    const { window } = dom;
+    const values = {
+        window,
+        document: window.document,
+        navigator: window.navigator,
+        history: window.history,
+        location: window.location,
+        Node: window.Node,
+        Comment: window.Comment,
+        Text: window.Text,
+        Element: window.Element,
+        HTMLElement: window.HTMLElement,
+    };
+    for (const key of PATCHED_GLOBALS) {
+        Object.defineProperty(g, key, { value: values[key], writable: true, configurable: true, enumerable: true });
+    }
+    return snapshot;
+}
+function restoreGlobals(snapshot) {
+    const g = globalThis;
+    for (const key of PATCHED_GLOBALS) {
+        const descriptor = snapshot[key];
+        if (descriptor) {
+            Object.defineProperty(g, key, descriptor);
+        }
+        else {
+            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete -- removing a global that genuinely didn't exist before installDomGlobals() added it
+            delete g[key];
+        }
+    }
+}
+/**
+ * Runs `fn` with a fresh JSDOM's `window`/`document`/etc installed as globals
+ * for its duration, then restores whatever was there before. Exported so
+ * `index.ts`'s `loadEntry()` can use it too: `ssrLoadModule()`-ing the app's
+ * root module runs `@Router([...])`'s class decorator, which calls
+ * `createRouter()` immediately (at module-evaluation time) — that needs a
+ * `window` in place just as much as the real per-route render below does,
+ * even though it's not rendering anything itself yet.
+ */
+export async function withDomGlobals(html, url, fn) {
+    const dom = new JSDOM(html, { url });
+    const snapshot = installDomGlobals(dom);
+    try {
+        return await fn(dom);
+    }
+    finally {
+        restoreGlobals(snapshot);
+    }
+}
+async function renderPage(path, config) {
+    const { root, routes, routerOptions, template, hydrate = true } = config;
+    const containerSelector = config.containerSelector ?? "#app";
+    return withDomGlobals(template, `http://localhost${path}`, async (dom) => {
+        resetHeadState();
+        const container = dom.window.document.querySelector(containerSelector);
+        if (!container) {
+            throw new Error(`[@praxisjs/ssg] No element matching "${containerSelector}" found in the HTML template.`);
+        }
+        createRouter(routes, routerOptions);
+        const dispose = render(() => mountComponent(root, {}, getCurrentScope()), container);
+        await flushPendingResources();
+        await Promise.resolve();
+        // Marked *after* rendering — the server always mounts fresh (create-mode);
+        // the marker only tells the client to hydrate instead of remounting.
+        if (hydrate)
+            container.setAttribute(SSG_MARKER, "1");
+        const html = dom.serialize();
+        dispose();
+        return { path, file: pathToOutputFile(path), html };
+    });
+}
+//# sourceMappingURL=prerender.js.map

package/dist/prerender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerender.js","sourceRoot":"","sources":["../src/prerender.ts"],"names":[],"mappings":"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"}