@praxisjs/ssg 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# @praxisjs/ssg
+
+## 0.1.0
+
+### Minor Changes
+
+- dab1c4f: Add `@praxisjs/ssg` — static site generation for PraxisJS.
+
+  `ssgPlugin({ root, routerOptions?, hydrate? })` plugs into `vite.config.ts` alongside `praxisjs()`. `root` exports the app's root component (default export) and route table (named `routes`). A dynamic route like `/blog/:slug` expands into concrete paths via its own `getStaticPaths: (fullPath) => Promise<string[]>` declared directly on the route object — colocated, no path matching needed, and the route's own full path is passed in for helpers like `@praxisjs/content`'s `collectionStaticPaths()` — with a top-level `getStaticPaths` named export on `root` available as a fallback for routes that don't declare their own. After `vite build`, it prerenders every route into its own `index.html`, waiting for `resource()`/`@Collection` data — and any `Lazy(...)`-wrapped route/layout component — to settle before serializing. The lower-level `prerender()` function does the same work without the Vite integration, for custom build pipelines.
+
+  By default the output is marked for client-side hydration (`@praxisjs/runtime`'s `render()` reconciles the real DOM instead of discarding it); pass `hydrate: false` to fall back to a plain client remount instead.
+
+### Patch Changes
+
+- Updated dependencies [1ec5b2f]
+- Updated dependencies [ef46e56]
+- Updated dependencies [9ceee18]
+- Updated dependencies [728c90e]
+  - @praxisjs/core@2.1.0
+  - @praxisjs/head@0.3.0
+  - @praxisjs/router@2.2.0
+  - @praxisjs/runtime@0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/loader-hook.test.d.ts

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

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

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

package/dist/__tests__/loader-hook.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect, vi } from "vitest";
+import { resolve } from "../loader-hook";
+const CONTEXT = {};
+function notFound() {
+    const err = new Error("not found");
+    err.code = "ERR_MODULE_NOT_FOUND";
+    throw err;
+}
+function ok(url) {
+    return { url, shortCircuit: true };
+}
+describe("loader-hook resolve()", () => {
+    it("returns nextResolve's result directly when it succeeds", async () => {
+        const nextResolve = vi.fn(async () => ok("file:///real.js"));
+        const result = await resolve("./real", CONTEXT, nextResolve);
+        expect(result).toEqual(ok("file:///real.js"));
+        expect(nextResolve).toHaveBeenCalledOnce();
+    });
+    it("rethrows without retrying for a bare (non-relative) specifier", async () => {
+        const nextResolve = vi.fn(async () => notFound());
+        await expect(resolve("some-package", CONTEXT, nextResolve)).rejects.toThrow("not found");
+        expect(nextResolve).toHaveBeenCalledOnce();
+    });
+    it("rethrows without retrying when the error has no code", async () => {
+        const nextResolve = vi.fn(async () => {
+            throw new Error("weird failure");
+        });
+        await expect(resolve("./router", CONTEXT, nextResolve)).rejects.toThrow("weird failure");
+        expect(nextResolve).toHaveBeenCalledOnce();
+    });
+    it("rethrows without retrying for a non-retryable error code", async () => {
+        const nextResolve = vi.fn(async () => {
+            const err = new Error("permission denied");
+            err.code = "EACCES";
+            throw err;
+        });
+        await expect(resolve("./router", CONTEXT, nextResolve)).rejects.toThrow("permission denied");
+        expect(nextResolve).toHaveBeenCalledOnce();
+    });
+    it("retries with a .js suffix and returns it when that succeeds", async () => {
+        const nextResolve = vi.fn(async (specifier) => {
+            if (specifier === "./router.js")
+                return ok("file:///router.js");
+            return notFound();
+        });
+        const result = await resolve("./router", CONTEXT, nextResolve);
+        expect(result).toEqual(ok("file:///router.js"));
+        expect(nextResolve).toHaveBeenCalledTimes(2);
+    });
+    it("falls back to /index.js when the .js candidate also fails", async () => {
+        const nextResolve = vi.fn(async (specifier) => {
+            if (specifier === "./router/index.js")
+                return ok("file:///router/index.js");
+            return notFound();
+        });
+        const result = await resolve("./router", CONTEXT, nextResolve);
+        expect(result).toEqual(ok("file:///router/index.js"));
+        expect(nextResolve).toHaveBeenCalledTimes(3);
+    });
+    it("rethrows the original error when both retry candidates fail", async () => {
+        const nextResolve = vi.fn(async () => notFound());
+        await expect(resolve("../router", CONTEXT, nextResolve)).rejects.toThrow("not found");
+        expect(nextResolve).toHaveBeenCalledTimes(3);
+    });
+});
+//# sourceMappingURL=loader-hook.test.js.map

package/dist/__tests__/loader-hook.test.js.map

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

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

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

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

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

package/dist/__tests__/plugin.test.js

@@ -0,0 +1,128 @@
+import { mkdtemp, readFile, rm, writeFile, mkdir } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { prerender } from "../prerender";
+import { ssgPlugin } from "../index";
+vi.mock("../prerender", () => ({
+    prerender: vi.fn(),
+    // Pass-through stand-in — the real DOM-global install/restore mechanics
+    // are covered in prerender.test.ts; here we only need loadEntry() to call
+    // through to whatever function it wraps.
+    withDomGlobals: vi.fn((_html, _url, fn) => fn()),
+}));
+const ssrLoadModule = vi.fn();
+const close = vi.fn();
+const createServer = vi.fn(async (_options) => ({ ssrLoadModule, close }));
+vi.mock("vite", () => ({
+    createServer: (options) => createServer(options),
+}));
+// registerLoaderHook()'s fallback path (module.register with a file URL)
+// assumes a built dist/ layout — loader-hook.js physically next to index.js
+// — which doesn't exist under vitest's on-the-fly source transform. The
+// mechanism itself is covered separately by running the actual built dist/
+// output through Node directly (see the plan's manual verification step);
+// here we only need to confirm ssgPlugin() triggers registration.
+const { registerHooks, register } = vi.hoisted(() => ({
+    registerHooks: vi.fn(),
+    register: vi.fn(),
+}));
+vi.mock("node:module", async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, registerHooks, register };
+});
+const RootComponent = class {
+};
+const routes = [{ path: "/", component: RootComponent }];
+function fakeResolvedConfig(root, outDir = "dist") {
+    return {
+        root,
+        build: { outDir },
+        configFile: `${root}/vite.config.ts`,
+    };
+}
+describe("ssgPlugin()", () => {
+    let dir;
+    afterEach(async () => {
+        vi.clearAllMocks();
+        if (dir)
+            await rm(dir, { recursive: true, force: true });
+    });
+    it("loads the root component and routes from a single SSR module load, prerenders, and writes files", async () => {
+        dir = await mkdtemp(join(tmpdir(), "praxisjs-ssg-"));
+        await mkdir(join(dir, "dist"), { recursive: true });
+        await writeFile(join(dir, "dist", "index.html"), "<html><body><div id=\"app\"></div></body></html>");
+        ssrLoadModule.mockResolvedValue({ default: RootComponent, routes });
+        vi.mocked(prerender).mockResolvedValue([
+            { path: "/", file: "index.html", html: "<html>home</html>" },
+            { path: "/about", file: "about/index.html", html: "<html>about</html>" },
+        ]);
+        const plugin = ssgPlugin({ root: "./src/app.tsx" });
+        // ssgPlugin() must register the extensionless-import retry hook
+        // synchronously, before closeBundle ever dynamically imports
+        // ./prerender (which is what actually needs it) — see index.ts.
+        expect(registerHooks.mock.calls.length + register.mock.calls.length).toBeGreaterThan(0);
+        const configResolved = plugin.configResolved;
+        await configResolved(fakeResolvedConfig(dir));
+        const closeBundle = plugin.closeBundle;
+        await closeBundle();
+        expect(createServer).toHaveBeenCalledWith(expect.objectContaining({
+            root: dir,
+            configFile: `${dir}/vite.config.ts`,
+            server: { middlewareMode: true, watch: null },
+            appType: "custom",
+            ssr: { external: true },
+            optimizeDeps: { noDiscovery: true, include: [] },
+        }));
+        // A single ssrLoadModule call reads both the default export and the
+        // named `routes` export — vite.config.ts never imports app source itself.
+        expect(ssrLoadModule).toHaveBeenCalledOnce();
+        expect(ssrLoadModule).toHaveBeenCalledWith("./src/app.tsx");
+        expect(close).toHaveBeenCalledOnce();
+        expect(prerender).toHaveBeenCalledWith(expect.objectContaining({
+            root: RootComponent,
+            routes,
+            template: "<html><body><div id=\"app\"></div></body></html>",
+        }));
+        expect(await readFile(join(dir, "dist", "index.html"), "utf-8")).toBe("<html>home</html>");
+        expect(await readFile(join(dir, "dist", "about", "index.html"), "utf-8")).toBe("<html>about</html>");
+    });
+    it("throws a clear error when the root module has no default export", async () => {
+        dir = await mkdtemp(join(tmpdir(), "praxisjs-ssg-"));
+        await mkdir(join(dir, "dist"), { recursive: true });
+        await writeFile(join(dir, "dist", "index.html"), "<html><body><div id=\"app\"></div></body></html>");
+        ssrLoadModule.mockResolvedValue({ routes });
+        const plugin = ssgPlugin({ root: "./src/app.tsx" });
+        const configResolved = plugin.configResolved;
+        await configResolved(fakeResolvedConfig(dir));
+        const closeBundle = plugin.closeBundle;
+        await expect(closeBundle()).rejects.toThrow(/no default export/);
+        expect(close).toHaveBeenCalledOnce(); // server is closed even on failure
+    });
+    it("throws a clear error when the root module has no named routes export", async () => {
+        dir = await mkdtemp(join(tmpdir(), "praxisjs-ssg-"));
+        await mkdir(join(dir, "dist"), { recursive: true });
+        await writeFile(join(dir, "dist", "index.html"), "<html><body><div id=\"app\"></div></body></html>");
+        ssrLoadModule.mockResolvedValue({ default: RootComponent });
+        const plugin = ssgPlugin({ root: "./src/app.tsx" });
+        const configResolved = plugin.configResolved;
+        await configResolved(fakeResolvedConfig(dir));
+        const closeBundle = plugin.closeBundle;
+        await expect(closeBundle()).rejects.toThrow(/no named "routes" export/);
+        expect(close).toHaveBeenCalledOnce();
+    });
+    it("passes hydrate: false through to prerender()", async () => {
+        dir = await mkdtemp(join(tmpdir(), "praxisjs-ssg-"));
+        await mkdir(join(dir, "dist"), { recursive: true });
+        await writeFile(join(dir, "dist", "index.html"), "<html><body><div id=\"app\"></div></body></html>");
+        ssrLoadModule.mockResolvedValue({ default: RootComponent, routes });
+        vi.mocked(prerender).mockResolvedValue([{ path: "/", file: "index.html", html: "<html></html>" }]);
+        const plugin = ssgPlugin({ root: "./src/app.tsx", hydrate: false });
+        const configResolved = plugin.configResolved;
+        await configResolved(fakeResolvedConfig(dir));
+        const closeBundle = plugin.closeBundle;
+        await closeBundle();
+        expect(prerender).toHaveBeenCalledWith(expect.objectContaining({ hydrate: false }));
+    });
+});
+//# sourceMappingURL=plugin.test.js.map

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

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

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

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

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

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

package/dist/__tests__/prerender.test.js

@@ -0,0 +1,211 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+// @vitest-environment jsdom
+import { describe, it, expect } from "vitest";
+import { StatefulComponent } from "@praxisjs/core";
+import { resource } from "@praxisjs/core/internal";
+import { Head } from "@praxisjs/head";
+import { Location } from "@praxisjs/router";
+import { getCurrentScope, mountComponent, mountElement, render } from "@praxisjs/runtime";
+import { prerender, withDomGlobals } from "../prerender";
+const TEMPLATE = '<!doctype html><html><head><title>App</title></head><body><div id="app"></div></body></html>';
+let Page = (() => {
+    let _classDecorators = [Head((self) => ({ title: `Page: ${self.location().path}` }))];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = StatefulComponent;
+    let _location_decorators;
+    let _location_initializers = [];
+    let _location_extraInitializers = [];
+    var Page = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _location_decorators = [Location()];
+            __esDecorate(null, null, _location_decorators, { kind: "field", name: "location", static: false, private: false, access: { has: obj => "location" in obj, get: obj => obj.location, set: (obj, value) => { obj.location = value; } }, metadata: _metadata }, _location_initializers, _location_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            Page = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static __isComponent = true;
+        static __isStateless = false;
+        location = __runInitializers(this, _location_initializers, void 0);
+        render() {
+            return mountElement("main", {
+                id: "root",
+                children: [
+                    mountElement("h1", { children: `Path: ${this.location().path}` }, getCurrentScope()),
+                    mountElement("button", { id: "btn", onClick: () => { }, children: "Click" }, getCurrentScope()),
+                ],
+            }, getCurrentScope());
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _location_extraInitializers);
+        }
+        static {
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return Page = _classThis;
+})();
+class AsyncPage extends StatefulComponent {
+    static __isComponent = true;
+    static __isStateless = false;
+    data = resource(() => Promise.resolve("loaded content"));
+    render() {
+        return mountElement("p", { id: "data", children: () => this.data.data() ?? "pending" }, getCurrentScope());
+    }
+}
+describe("prerender()", () => {
+    it("renders each static route to its own page with the hydration marker", async () => {
+        const routes = [
+            { path: "/", component: Page },
+            { path: "/about", component: Page },
+        ];
+        const pages = await prerender({ root: Page, routes, template: TEMPLATE });
+        expect(pages.map((p) => p.path).sort()).toEqual(["/", "/about"]);
+        const home = pages.find((p) => p.path === "/");
+        expect(home.file).toBe("index.html");
+        expect(home.html).toContain("Path: /");
+        expect(home.html).toContain('data-praxis-ssg="1"');
+        const about = pages.find((p) => p.path === "/about");
+        expect(about.file).toBe("about/index.html");
+        expect(about.html).toContain("Path: /about");
+    });
+    it("omits the hydration marker when hydrate: false", async () => {
+        const routes = [{ path: "/", component: Page }];
+        const pages = await prerender({ root: Page, routes, template: TEMPLATE, hydrate: false });
+        expect(pages[0].html).not.toContain("data-praxis-ssg");
+    });
+    it("expands a dynamic route via getStaticPaths", async () => {
+        const routes = [{ path: "/blog/:slug", component: Page }];
+        const pages = await prerender({
+            root: Page,
+            routes,
+            template: TEMPLATE,
+            getStaticPaths: async () => ["/blog/hello", "/blog/world"],
+        });
+        expect(pages.map((p) => p.file).sort()).toEqual(["blog/hello/index.html", "blog/world/index.html"]);
+    });
+    it("waits for resource() data to settle before serializing", async () => {
+        const routes = [{ path: "/", component: AsyncPage }];
+        const pages = await prerender({ root: AsyncPage, routes, template: TEMPLATE });
+        expect(pages[0].html).toContain("loaded content");
+        expect(pages[0].html).not.toContain("pending");
+    });
+    it("sets per-route <title> via @Head and does not leak it across routes", async () => {
+        const routes = [
+            { path: "/", component: Page },
+            { path: "/about", component: Page },
+        ];
+        const pages = await prerender({ root: Page, routes, template: TEMPLATE });
+        const home = pages.find((p) => p.path === "/");
+        const about = pages.find((p) => p.path === "/about");
+        expect(home.html).toContain("<title>Page: /</title>");
+        expect(about.html).toContain("<title>Page: /about</title>");
+    });
+    it("does not leak globalThis.document/window back to the caller's environment", async () => {
+        const outer = document;
+        const routes = [{ path: "/", component: Page }];
+        await prerender({ root: Page, routes, template: TEMPLATE });
+        expect(globalThis.document).toBe(outer);
+    });
+    it("throws a clear error when the container selector is not found in the template", async () => {
+        const routes = [{ path: "/", component: Page }];
+        await expect(prerender({ root: Page, routes, template: "<html><body></body></html>" })).rejects.toThrow(/No element matching/);
+    });
+});
+describe("withDomGlobals", () => {
+    it("deletes a patched global on restore when it had no prior descriptor, and restores others that did", async () => {
+        const priorDescriptor = Object.getOwnPropertyDescriptor(globalThis, "Comment");
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete -- simulating a Node environment where this global never existed
+        delete globalThis.Comment;
+        try {
+            let sawCommentDuring;
+            await withDomGlobals("<!doctype html><html><body></body></html>", "http://localhost/", async () => {
+                sawCommentDuring = globalThis.Comment;
+                // document existed before this call (vitest's jsdom environment) — restoreGlobals
+                // must put its original descriptor back, not delete it.
+                expect(globalThis.document).toBeDefined();
+            });
+            expect(sawCommentDuring).toBeDefined();
+            expect(Object.getOwnPropertyDescriptor(globalThis, "Comment")).toBeUndefined();
+            expect(globalThis.document).toBeDefined();
+        }
+        finally {
+            if (priorDescriptor)
+                Object.defineProperty(globalThis, "Comment", priorDescriptor);
+        }
+    });
+});
+describe("prerender() -> render() round trip", () => {
+    it("produces HTML the client can hydrate without recreating the adopted nodes", async () => {
+        const routes = [{ path: "/", component: Page }];
+        const pages = await prerender({ root: Page, routes, template: TEMPLATE });
+        const html = pages[0].html;
+        const parsed = new DOMParser().parseFromString(html, "text/html");
+        const appHTML = parsed.querySelector("#app")?.innerHTML ?? "";
+        const container = document.createElement("div");
+        container.innerHTML = appHTML;
+        container.setAttribute("data-praxis-ssg", "1");
+        document.body.appendChild(container);
+        const h1Before = container.querySelector("h1");
+        const btnBefore = container.querySelector("#btn");
+        expect(h1Before?.textContent).toBe("Path: /");
+        let clicks = 0;
+        class ClientPage extends StatefulComponent {
+            static __isComponent = true;
+            static __isStateless = false;
+            render() {
+                return mountElement("main", {
+                    id: "root",
+                    children: [
+                        mountElement("h1", { children: "Path: /" }, getCurrentScope()),
+                        mountElement("button", { id: "btn", onClick: () => { clicks++; }, children: "Click" }, getCurrentScope()),
+                    ],
+                }, getCurrentScope());
+            }
+        }
+        render(() => mountComponent(ClientPage, {}, getCurrentScope()), container);
+        expect(container.querySelector("h1")).toBe(h1Before);
+        expect(container.querySelector("#btn")).toBe(btnBefore);
+        container.querySelector("#btn")?.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+        expect(clicks).toBe(1);
+        document.body.removeChild(container);
+    });
+});
+//# sourceMappingURL=prerender.test.js.map

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

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

package/dist/__tests__/register-fallback.test.d.ts

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

package/dist/__tests__/register-fallback.test.d.ts.map

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

package/dist/__tests__/register-fallback.test.js

@@ -0,0 +1,20 @@
+import { describe, it, expect, vi } from "vitest";
+// Simulates Node < 22.15, which has no module.registerHooks — registerLoaderHook()
+// must fall back to the older, off-thread module.register() API instead.
+const { register } = vi.hoisted(() => ({
+    register: vi.fn(),
+}));
+vi.mock("node:module", async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, registerHooks: undefined, register };
+});
+describe("registerLoaderHook() fallback (no module.registerHooks)", () => {
+    it("registers the standalone loader-hook module via module.register()", async () => {
+        const { registerLoaderHook } = await import("../index");
+        registerLoaderHook();
+        expect(register).toHaveBeenCalledOnce();
+        const [specifier] = register.mock.calls[0];
+        expect(specifier.href).toContain("loader-hook.js");
+    });
+});
+//# sourceMappingURL=register-fallback.test.js.map

package/dist/__tests__/register-fallback.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-fallback.test.js","sourceRoot":"","sources":["../../src/__tests__/register-fallback.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,mFAAmF;AACnF,yEAAyE;AACzE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACrC,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IAC9C,MAAM,MAAM,GAAG,MAAM,cAAc,EAAgC,CAAC;IACpE,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACvE,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACxD,kBAAkB,EAAE,CAAC;QAErB,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAU,CAAC;QACpD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/resolve-sync.test.d.ts

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

package/dist/__tests__/resolve-sync.test.d.ts.map

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

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

@@ -0,0 +1,67 @@
+import { describe, it, expect, vi } from "vitest";
+import { registerLoaderHook } from "../index";
+const { registerHooks } = vi.hoisted(() => ({
+    registerHooks: vi.fn(),
+}));
+vi.mock("node:module", async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, registerHooks, register: vi.fn() };
+});
+const CONTEXT = {};
+function notFound() {
+    const err = new Error("not found");
+    err.code = "ERR_MODULE_NOT_FOUND";
+    throw err;
+}
+function ok(url) {
+    return { url, shortCircuit: true };
+}
+describe("resolveSync (registered via module.registerHooks())", () => {
+    registerLoaderHook();
+    const resolveSync = registerHooks.mock.calls[0][0].resolve;
+    it("registers exactly once via module.registerHooks()", () => {
+        expect(registerHooks).toHaveBeenCalledOnce();
+    });
+    it("returns nextResolve's result directly when it succeeds", () => {
+        const nextResolve = vi.fn(() => ok("file:///real.js"));
+        expect(resolveSync("./real", CONTEXT, nextResolve)).toEqual(ok("file:///real.js"));
+        expect(nextResolve).toHaveBeenCalledOnce();
+    });
+    it("rethrows without retrying for a bare (non-relative) specifier", () => {
+        const nextResolve = vi.fn(() => notFound());
+        expect(() => resolveSync("some-package", CONTEXT, nextResolve)).toThrow("not found");
+        expect(nextResolve).toHaveBeenCalledOnce();
+    });
+    it("rethrows without retrying when the error has no code", () => {
+        const nextResolve = vi.fn(() => {
+            throw new Error("weird failure");
+        });
+        expect(() => resolveSync("./router", CONTEXT, nextResolve)).toThrow("weird failure");
+        expect(nextResolve).toHaveBeenCalledOnce();
+    });
+    it("rethrows without retrying for a non-retryable error code", () => {
+        const nextResolve = vi.fn(() => {
+            const err = new Error("permission denied");
+            err.code = "EACCES";
+            throw err;
+        });
+        expect(() => resolveSync("./router", CONTEXT, nextResolve)).toThrow("permission denied");
+        expect(nextResolve).toHaveBeenCalledOnce();
+    });
+    it("retries with a .js suffix and returns it when that succeeds", () => {
+        const nextResolve = vi.fn((specifier) => specifier === "./router.js" ? ok("file:///router.js") : notFound());
+        expect(resolveSync("./router", CONTEXT, nextResolve)).toEqual(ok("file:///router.js"));
+        expect(nextResolve).toHaveBeenCalledTimes(2);
+    });
+    it("falls back to /index.js when the .js candidate also fails", () => {
+        const nextResolve = vi.fn((specifier) => specifier === "./router/index.js" ? ok("file:///router/index.js") : notFound());
+        expect(resolveSync("./router", CONTEXT, nextResolve)).toEqual(ok("file:///router/index.js"));
+        expect(nextResolve).toHaveBeenCalledTimes(3);
+    });
+    it("rethrows the original error when both retry candidates fail", () => {
+        const nextResolve = vi.fn(() => notFound());
+        expect(() => resolveSync("../router", CONTEXT, nextResolve)).toThrow("not found");
+        expect(nextResolve).toHaveBeenCalledTimes(3);
+    });
+});
+//# sourceMappingURL=resolve-sync.test.js.map