@praxisjs/ssg 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @praxisjs/ssg
 
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies [d634a29]
+  - @praxisjs/runtime@0.8.1
+  - @praxisjs/router@2.3.1
+
+## 0.1.3
+
+### Patch Changes
+
+- 75115a9: Tooling cleanup and fixes.
+  - `@praxisjs/ssg`: `prerender()` reuses one JSDOM window for the whole run and resets it before each route (fresh copy of the template, the route's URL, empty storage, no window globals left by the previous route) instead of parsing a new one per route: 300 routes went from about 900 ms to about 170 ms. The window is closed at the end, so timers a page leaves running no longer outlive the build. `localStorage`/`sessionStorage` are now the page's own (they were the host's, so `@Persisted` values leaked between routes). A page is unmounted even when serializing it fails. Pages are written in parallel, and an absolute `build.outDir` is no longer nested under the project root.
+  - `@praxisjs/mcp`: `praxisjs_get_page` accepts the `/docs/…` links `praxisjs_overview` lists (they used to 404), full praxisjs.org URLs, trailing slashes and `.md`/`.mdx`. Docs responses are cached in memory for 10 minutes, concurrent requests share one fetch and requests time out after 15 seconds. `praxisjs_get_install_command` checks package names strictly and drops duplicates. The server reports its real version.
+  - `@praxisjs/storybook`: re-rendering a story (new args, HMR) now disposes the previous render, which used to keep its effects alive. Each canvas tracks its own story, and `renderToCanvas` returns a teardown for Storybook. The preset registers a new `@praxisjs/storybook/preview` entry with `renderToCanvas` and a default `render` (the meta's `component` mounted with the args), so `.storybook/preview.ts` needs no setup. Preset paths work in folders with spaces and on Windows; story source is read asynchronously, and `.story.*` files get the source panel too.
+  - `praxisjs`: `doctor` flags `@praxisjs/*` versions that don't work together (`vite-plugin` 4.1+ or `jsx` 0.8+ with `runtime` older than 0.8, `decorators` 1.8+ with `core` older than 2.3). `upgrade` looks packages up in parallel, honors `npm_config_registry`, never moves a dependency to an older version, detects `bun.lock`, and reports a malformed `package.json` instead of crashing. The AI skills cover `For`/`Index`, `@Selector`, `createTransition()`, compiled templates, the upload composables and the devtools debugging options (`@Debug({ log, break })`, `@Trace({ slow })`, the profiler).
+  - `create-praxisjs`: `npm run lint` failed in every freshly scaffolded project, because the type-aware parser options also applied to `eslint.config.mjs`, which no tsconfig includes. They now apply to `.ts`/`.tsx` files only. The blog template renders its post list with `For`.
+
+- 75115a9: Published packages no longer contain their tests: package builds compile `src` without `src/**/__tests__` (through a `tsconfig.build.json`), and each package's `files` leaves test sources and stale compiled tests out of the tarball. `pnpm typecheck` still type-checks the tests.
+- 75115a9: Smaller startup: `render()` hydrates only after the new `enableHydration()` (called by `ssgPlugin()`), so apps that don't prerender leave the hydration code out. **Breaking:** an app that hydrates server-rendered HTML without `ssgPlugin()` must call `enableHydration()` before `render()`. Also, compiled templates whose tree the HTML parser reads back unchanged are emitted as markup and parsed once (`_$html`); decorated fields, methods and classes call shorter lowering helpers; the list view's internal members are `#private`.
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+- Updated dependencies [75115a9]
+  - @praxisjs/router@2.3.0
+  - @praxisjs/runtime@0.8.0
+  - @praxisjs/core@2.3.0
+  - @praxisjs/head@0.3.2
+  - @praxisjs/shared@0.3.2
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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;AAoFD,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAqDnD"}

package/dist/index.js

@@ -1,6 +1,6 @@
 import { readFile, writeFile, mkdir } from "node:fs/promises";
 import * as nodeModule from "node:module";
-import { dirname, join } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import { createServer } from "vite";
 // ── extensionless-relative-import retry hook ────────────────────────────────
 //
@@ -87,11 +87,8 @@ async function loadEntry(resolvedConfig, root, withDomGlobals) {
         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()).
+        // @Router([...]) calls createRouter() at module-evaluation time, so importing the root module
+        // needs a window even though nothing is rendered yet. prerender() installs its own.
         const mod = await withDomGlobals("<!doctype html><html><head></head><body></body></html>", "http://localhost/", async () => {
             return (await server.ssrLoadModule(root));
         });
@@ -113,6 +110,22 @@ async function loadEntry(resolvedConfig, root, withDomGlobals) {
         throw err;
     }
 }
+// Enough to keep the disk busy on large sites without running into the open-file limit.
+const WRITE_CONCURRENCY = 16;
+async function writePages(outDir, pages) {
+    let next = 0;
+    const worker = async () => {
+        while (next < pages.length) {
+            const page = pages[next++];
+            const outFile = join(outDir, page.file);
+            await mkdir(dirname(outFile), { recursive: true });
+            await writeFile(outFile, page.html, "utf-8");
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(WRITE_CONCURRENCY, pages.length) }, worker));
+}
+/** The script ssgPlugin() puts in front of the app's entry when hydration is on. */
+const HYDRATION_ENTRY = 'import { enableHydration } from "@praxisjs/runtime";\nenableHydration();';
 export function ssgPlugin(config) {
     let resolvedConfig;
     // Before anything below ever dynamically imports ./prerender — see the
@@ -124,11 +137,26 @@ export function ssgPlugin(config) {
         configResolved(c) {
             resolvedConfig = c;
         },
+        // render() hydrates only once enableHydration() has run, which keeps the hydration code out of
+        // apps that never prerender. A module script in the head runs before the app's own entry, and
+        // "pre" lets Vite bundle it with that entry instead of leaving a bare import in the HTML.
+        transformIndexHtml: {
+            order: "pre",
+            handler() {
+                if (config.hydrate === false)
+                    return [];
+                return [{
+                        tag: "script",
+                        attrs: { type: "module" },
+                        children: HYDRATION_ENTRY,
+                        injectTo: "head-prepend",
+                    }];
+            },
+        },
         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 { prerender, withDomGlobals } = await import("./prerender");
+            const outDir = resolve(resolvedConfig.root, resolvedConfig.build.outDir);
+            const template = await readFile(join(outDir, "index.html"), "utf-8");
             const { root, routes, getStaticPaths, close } = await loadEntry(resolvedConfig, config.root, withDomGlobals);
             let pages;
             try {
@@ -145,11 +173,7 @@ export function ssgPlugin(config) {
             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");
-            }
+            await writePages(outDir, pages);
         },
     };
 }

package/dist/index.js.map

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

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

@@ -1 +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"}
+{"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;AAOvE,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

@@ -1,16 +1,6 @@
-// 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.
+// Asynchronous twin of `resolveSync` in index.ts, loaded through module.register() on Node versions
+// without module.registerHooks(). It must have no relative imports of its own: it has to work before
+// the extensionless-import problem it fixes is worked around. See index.ts for the full story.
 const RETRYABLE_CODES = new Set(["ERR_MODULE_NOT_FOUND", "ERR_UNSUPPORTED_DIR_IMPORT"]);
 export async function resolve(specifier, context, nextResolve) {
     try {

package/dist/loader-hook.js.map

@@ -1 +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"}
+{"version":3,"file":"loader-hook.js","sourceRoot":"","sources":["../src/loader-hook.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,qGAAqG;AACrG,+FAA+F;AAC/F,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

@@ -24,15 +24,18 @@ export interface PrerenderedPage {
     file: string;
     html: string;
 }
+/**
+ * Renders every route into a full HTML page. One JSDOM window serves the whole run (parsing a new
+ * one per route cost more than most renders) and is reset before each route: a fresh copy of the
+ * template's document, the route's URL, empty storage and none of the window globals the previous
+ * route added. The window is closed at the end, which also stops any timer a page left running.
+ */
 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.
+ * Runs `fn` with a fresh JSDOM's `window`/`document`/etc installed as globals, then restores what
+ * was there before and closes the window. Also used by index.ts's `loadEntry()`: loading the root
+ * module runs `@Router([...])`, which calls `createRouter()` at module-evaluation time and so needs
+ * a `window` even though nothing is rendered 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

@@ -1 +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"}
+{"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;AAKjH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAKtJ,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;AAUD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA6BnF;AA8ED;;;;;GAKG;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,CAS7G"}

package/dist/prerender.js

@@ -4,58 +4,99 @@ 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.
+// Re-exported here rather than from the main entry so importing `ssgPlugin` alone never needs
+// router/core/head resolved statically: this module only loads once the loader hook in index.ts is
+// registered.
 export { flattenRoutes, isStaticPath, normalizeRoutes, pathToOutputFile, resolvePaths } from "./routes";
 const SSG_MARKER = "data-praxis-ssg";
+const ORIGIN = "http://localhost";
+/**
+ * Renders every route into a full HTML page. One JSDOM window serves the whole run (parsing a new
+ * one per route cost more than most renders) and is reset before each route: a fresh copy of the
+ * template's document, the route's URL, empty storage and none of the window globals the previous
+ * route added. The window is closed at the end, which also stops any timer a page left running.
+ */
 export async function prerender(config) {
-    const { getStaticPaths } = config;
     const routes = normalizeRoutes(config.routes);
-    const paths = await resolvePaths({ routes, getStaticPaths });
+    const paths = await resolvePaths({ routes, getStaticPaths: config.getStaticPaths });
+    const options = {
+        root: config.root,
+        routes,
+        routerOptions: config.routerOptions,
+        containerSelector: config.containerSelector ?? "#app",
+        hydrate: config.hydrate ?? true,
+    };
     const wasServerPass = isServerRenderPass();
     setServerRenderPass(true);
     try {
-        const pages = [];
-        for (const path of paths) {
-            pages.push(await renderPage(path, { ...config, routes }));
-        }
-        return pages;
+        return await withDomGlobals(config.template, `${ORIGIN}/`, async (dom) => {
+            const { window } = dom;
+            const pristine = window.document.documentElement.cloneNode(true);
+            const baseline = new Set(Object.getOwnPropertyNames(window));
+            const pages = [];
+            for (const path of paths) {
+                resetWindow(dom, pristine, baseline, path);
+                pages.push(await renderPage(dom, path, options));
+            }
+            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 resetWindow(dom, pristine, baseline, path) {
+    const { window } = dom;
+    const { document } = window;
+    document.replaceChild(pristine.cloneNode(true), document.documentElement);
+    window.history.replaceState(null, "", `${ORIGIN}${path}`);
+    window.localStorage.clear();
+    window.sessionStorage.clear();
+    const globals = window;
+    for (const key of Object.getOwnPropertyNames(window)) {
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete -- removing globals the previous route's code added
+        if (!baseline.has(key))
+            delete globals[key];
+    }
+}
+async function renderPage(dom, path, options) {
+    const { root, routes, routerOptions, containerSelector, hydrate } = options;
+    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);
+    try {
+        await flushPendingResources();
+        await Promise.resolve();
+        // The server always mounts fresh; the marker only tells the client to hydrate instead of remounting.
+        if (hydrate)
+            container.setAttribute(SSG_MARKER, "1");
+        return { path, file: pathToOutputFile(path), html: dom.serialize() };
+    }
+    finally {
+        dispose();
+    }
+}
+const PATCHED_GLOBALS = [
+    "window", "document", "navigator", "history", "location", "localStorage", "sessionStorage",
+    "Node", "Comment", "Text", "Element", "HTMLElement",
+];
+// Modern Node defines some of these itself (globalThis.navigator is a getter-only built-in since
+// Node 21), where plain assignment throws. Every property is installed and restored through
+// defineProperty, keeping the original descriptor so a getter comes back as a getter.
 function installDomGlobals(dom) {
-    const g = globalThis;
     const snapshot = {};
+    const { window } = dom;
+    const source = window;
     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 });
+        const value = key === "window" ? window : source[key];
+        Object.defineProperty(globalThis, key, { value, writable: true, configurable: true, enumerable: true });
     }
     return snapshot;
 }
@@ -73,13 +114,10 @@ function restoreGlobals(snapshot) {
     }
 }
 /**
- * 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.
+ * Runs `fn` with a fresh JSDOM's `window`/`document`/etc installed as globals, then restores what
+ * was there before and closes the window. Also used by index.ts's `loadEntry()`: loading the root
+ * module runs `@Router([...])`, which calls `createRouter()` at module-evaluation time and so needs
+ * a `window` even though nothing is rendered yet.
  */
 export async function withDomGlobals(html, url, fn) {
     const dom = new JSDOM(html, { url });
@@ -89,28 +127,7 @@ export async function withDomGlobals(html, url, fn) {
     }
     finally {
         restoreGlobals(snapshot);
+        dom.window.close();
     }
 }
-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

@@ -1 +1 @@
-{"version":3,"file":"prerender.js","sourceRoot":"","sources":["../src/prerender.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prerender.js","sourceRoot":"","sources":["../src/prerender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAwC,MAAM,UAAU,CAAC;AAEjH,8FAA8F;AAC9F,mGAAmG;AACnG,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAgD,MAAM,UAAU,CAAC;AAEtJ,MAAM,UAAU,GAAG,iBAAiB,CAAC;AACrC,MAAM,MAAM,GAAG,kBAAkB,CAAC;AAiClC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAuB;IACrD,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IACpF,MAAM,OAAO,GAAkB;QAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM;QACN,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,MAAM;QACrD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;KAChC,CAAC;IAEF,MAAM,aAAa,GAAG,kBAAkB,EAAE,CAAC;IAC3C,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,MAAM,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACvE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;YACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;YAE7D,MAAM,KAAK,GAAsB,EAAE,CAAC;YACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAU,EAAE,QAAc,EAAE,QAAqB,EAAE,IAAY;IAClF,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACvB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC1E,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,MAA4C,CAAC;IAC7D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,oHAAoH;QACpH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAU,EAAE,IAAY,EAAE,OAAsB;IACxE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5E,cAAc,EAAE,CAAC;IAEjB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAc,iBAAiB,CAAC,CAAC;IACpF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wCAAwC,iBAAiB,+BAA+B,CAAC,CAAC;IAC5G,CAAC;IAED,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IACrF,IAAI,CAAC;QACH,MAAM,qBAAqB,EAAE,CAAC;QAC9B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAExB,qGAAqG;QACrG,IAAI,OAAO;YAAE,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAErD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC;IACvE,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,eAAe,GAAG;IACtB,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB;IAC1F,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa;CAC3C,CAAC;AAKX,iGAAiG;AACjG,4FAA4F;AAC5F,sFAAsF;AACtF,SAAS,iBAAiB,CAAC,GAAU;IACnC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACvB,MAAM,MAAM,GAAG,MAAmD,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACpE,IAAI,UAAU;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAC3C,MAAM,KAAK,GAAG,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtD,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,QAAwB;IAC9C,MAAM,CAAC,GAAG,UAAgD,CAAC;IAC3D,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,qJAAqJ;YACrJ,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,IAAY,EAAE,GAAW,EAAE,EAA8B;IAC/F,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/ssg",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,13 +14,20 @@
       "types": "./dist/prerender.d.ts"
     }
   },
+  "files": [
+    "dist",
+    "src",
+    "!dist/**/__tests__",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
   "dependencies": {
     "jsdom": "^29.0.1",
-    "@praxisjs/core": "2.2.0",
-    "@praxisjs/head": "0.3.1",
-    "@praxisjs/router": "2.2.2",
-    "@praxisjs/runtime": "0.7.1",
-    "@praxisjs/shared": "0.3.1"
+    "@praxisjs/core": "2.3.0",
+    "@praxisjs/head": "0.3.2",
+    "@praxisjs/router": "2.3.1",
+    "@praxisjs/runtime": "0.8.1",
+    "@praxisjs/shared": "0.3.2"
   },
   "peerDependencies": {
     "vite": ">=8.0.0"
@@ -32,7 +39,8 @@
     "vite": "^8.1.4"
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit"
   }
 }

package/src/index.ts

@@ -1,6 +1,6 @@
 import { readFile, writeFile, mkdir } from "node:fs/promises";
 import * as nodeModule from "node:module";
-import { dirname, join } from "node:path";
+import { dirname, join, resolve } from "node:path";
 
 import { createServer, type Plugin, type ResolvedConfig } from "vite";
 
@@ -161,11 +161,8 @@ async function loadEntry(
     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()).
+    // @Router([...]) calls createRouter() at module-evaluation time, so importing the root module
+    // needs a window even though nothing is rendered yet. prerender() installs its own.
     const mod = await withDomGlobals("<!doctype html><html><head></head><body></body></html>", "http://localhost/", async () => {
       return (await server.ssrLoadModule(root)) as RootModule;
     });
@@ -187,6 +184,25 @@ async function loadEntry(
   }
 }
 
+// Enough to keep the disk busy on large sites without running into the open-file limit.
+const WRITE_CONCURRENCY = 16;
+
+async function writePages(outDir: string, pages: PrerenderModule.PrerenderedPage[]): Promise<void> {
+  let next = 0;
+  const worker = async (): Promise<void> => {
+    while (next < pages.length) {
+      const page = pages[next++];
+      const outFile = join(outDir, page.file);
+      await mkdir(dirname(outFile), { recursive: true });
+      await writeFile(outFile, page.html, "utf-8");
+    }
+  };
+  await Promise.all(Array.from({ length: Math.min(WRITE_CONCURRENCY, pages.length) }, worker));
+}
+
+/** The script ssgPlugin() puts in front of the app's entry when hydration is on. */
+const HYDRATION_ENTRY = 'import { enableHydration } from "@praxisjs/runtime";\nenableHydration();';
+
 export function ssgPlugin(config: SSGConfig): Plugin {
   let resolvedConfig: ResolvedConfig;
 
@@ -200,15 +216,29 @@ export function ssgPlugin(config: SSGConfig): Plugin {
     configResolved(c) {
       resolvedConfig = c;
     },
+    // render() hydrates only once enableHydration() has run, which keeps the hydration code out of
+    // apps that never prerender. A module script in the head runs before the app's own entry, and
+    // "pre" lets Vite bundle it with that entry instead of leaving a bare import in the HTML.
+    transformIndexHtml: {
+      order: "pre",
+      handler() {
+        if (config.hydrate === false) return [];
+        return [{
+          tag: "script",
+          attrs: { type: "module" },
+          children: HYDRATION_ENTRY,
+          injectTo: "head-prepend",
+        }];
+      },
+    },
     async closeBundle() {
-      const { prerender, withDomGlobals } = (await import("./prerender"));
+      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 outDir = resolve(resolvedConfig.root, resolvedConfig.build.outDir);
+      const template = await readFile(join(outDir, "index.html"), "utf-8");
       const { root, routes, getStaticPaths, close } = await loadEntry(resolvedConfig, config.root, withDomGlobals);
 
-      let pages;
+      let pages: PrerenderModule.PrerenderedPage[];
       try {
         pages = await prerender({
           root,
@@ -223,11 +253,7 @@ export function ssgPlugin(config: SSGConfig): Plugin {
         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");
-      }
+      await writePages(outDir, pages);
     },
   };
 }

package/src/loader-hook.ts

@@ -1,18 +1,8 @@
 import type { ResolveFnOutput, ResolveHookContext } from "node:module";
 
-// 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.
+// Asynchronous twin of `resolveSync` in index.ts, loaded through module.register() on Node versions
+// without module.registerHooks(). It must have no relative imports of its own: it has to work before
+// the extensionless-import problem it fixes is worked around. See index.ts for the full story.
 const RETRYABLE_CODES = new Set(["ERR_MODULE_NOT_FOUND", "ERR_UNSUPPORTED_DIR_IMPORT"]);
 
 type NextResolve = (