mordoc 0.1.13 → 1.0.0

package/dist/cli/dev.d.ts

@@ -1,20 +1,32 @@
-/**
- * Dev command - Starts development server
- * Serves the pre-built dist/ folder (MVP: no live reload, manual rebuild)
- * Usage: mordoc dev [options]
- */
 export interface DevCommandOptions {
-    projectRoot?: string;
+    /** Absolute path to the user's project root. */
+    projectRoot: string;
+    /** Port to listen on. Defaults to Vite's default (5173). */
     port?: number;
-    host?: string;
-    open?: boolean;
 }
 /**
- * Execute the dev command
- */
-export declare function dev(options?: DevCommandOptions): Promise<void>;
-/**
- * Parse command-line arguments for dev command
+ * Starts the Mordoc dev server.
+ *
+ * Dev mode is pure client-side rendering — no SSR per request. Vite's HMR
+ * runtime handles CSS injection and module hot-reloading natively, and React
+ * mounts into the empty `#app` div via `createRoot`. This avoids the FOUC
+ * that arises from SSR HTML arriving before Vite's client runtime has injected
+ * styles, and sidesteps SSR/hydration mismatch noise during development.
+ *
+ * `document.title` is set by `Content.tsx` via `useEffect` once the route
+ * loader resolves — no server-side title injection needed in dev.
+ *
+ * The production `mordoc build` path still runs full SSR + SSG: `entry-server.tsx`
+ * and the static-HTML output are exercised at build time.
+ *
+ * Per-request flow:
+ *   1. Read the raw `index.html` template from disk (re-read each request so
+ *      edits to the shell are picked up without a restart).
+ *   2. `vite.transformIndexHtml` injects the HMR client and any plugin
+ *      transforms (e.g. React refresh preamble).
+ *   3. Replace `<!--ssr-outlet-->` with empty string — React renders the full
+ *      app client-side via `createRoot`.
+ *   4. Send response.
  */
-export declare function parseDevArgs(args: string[]): DevCommandOptions;
+export declare function runDevCommand(options: DevCommandOptions): Promise<void>;
 //# sourceMappingURL=dev.d.ts.map

package/dist/cli/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyExE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAyC9D"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+F7E"}

package/dist/cli/dev.js

@@ -1,169 +1,126 @@
-"use strict";
+import { createServer } from 'vite';
+import react from '@vitejs/plugin-react';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { mordocVitePlugin } from '../vite/plugin.js';
+import { getAppRoot, getPackageRoot } from '../utils/paths.js';
+/** Markers in `index.html` replaced at request time. */
+const SSR_LANG_MARKER = '<!--ssr-lang-->';
+const SSR_HEAD_MARKER = '<!--ssr-head-->';
+const SSR_OUTLET_MARKER = '<!--ssr-outlet-->';
 /**
- * Dev command - Starts development server
- * Serves the pre-built dist/ folder (MVP: no live reload, manual rebuild)
- * Usage: mordoc dev [options]
+ * Starts the Mordoc dev server.
+ *
+ * Dev mode is pure client-side rendering — no SSR per request. Vite's HMR
+ * runtime handles CSS injection and module hot-reloading natively, and React
+ * mounts into the empty `#app` div via `createRoot`. This avoids the FOUC
+ * that arises from SSR HTML arriving before Vite's client runtime has injected
+ * styles, and sidesteps SSR/hydration mismatch noise during development.
+ *
+ * `document.title` is set by `Content.tsx` via `useEffect` once the route
+ * loader resolves — no server-side title injection needed in dev.
+ *
+ * The production `mordoc build` path still runs full SSR + SSG: `entry-server.tsx`
+ * and the static-HTML output are exercised at build time.
+ *
+ * Per-request flow:
+ *   1. Read the raw `index.html` template from disk (re-read each request so
+ *      edits to the shell are picked up without a restart).
+ *   2. `vite.transformIndexHtml` injects the HMR client and any plugin
+ *      transforms (e.g. React refresh preamble).
+ *   3. Replace `<!--ssr-outlet-->` with empty string — React renders the full
+ *      app client-side via `createRoot`.
+ *   4. Send response.
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dev = dev;
-exports.parseDevArgs = parseDevArgs;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const http_1 = __importDefault(require("http"));
-const sirv_1 = __importDefault(require("sirv"));
-/**
- * Execute the dev command
- */
-async function dev(options = {}) {
-    try {
-        // Get project root
-        const projectRoot = options.projectRoot || process.cwd();
-        const distDir = path_1.default.join(projectRoot, 'dist');
-        // Check if dist/ exists
-        if (!fs_1.default.existsSync(distDir)) {
-            console.error('❌ Error: dist/ directory not found');
-            console.error('Please run "mordoc build" first to generate the static site.');
-            process.exit(1);
+export async function runDevCommand(options) {
+    const { projectRoot, port } = options;
+    const appRoot = getAppRoot();
+    const templatePath = path.join(appRoot, 'index.html');
+    const server = await createServer({
+        configFile: false,
+        root: appRoot,
+        publicDir: path.join(projectRoot, 'public'),
+        appType: 'custom',
+        plugins: [
+            react(),
+            mordocVitePlugin({ projectRoot }),
+        ],
+        server: {
+            port,
+            fs: {
+                allow: [getPackageRoot()],
+            },
+        },
+    });
+    // Serve config/assets/* at /_assets/* — same URL shape as build output.
+    server.middlewares.use(async (req, res, next) => {
+        const url = (req.url ?? '').split('?')[0];
+        if (!url.startsWith('/_assets/'))
+            return next();
+        const filename = url.slice('/_assets/'.length);
+        if (!filename || filename.includes('/') || filename.includes('..'))
+            return next();
+        const filePath = path.join(projectRoot, 'config', 'assets', filename);
+        try {
+            const content = await fs.readFile(filePath);
+            const ext = path.extname(filename).slice(1).toLowerCase();
+            const mime = {
+                svg: 'image/svg+xml',
+                png: 'image/png',
+                jpg: 'image/jpeg',
+                jpeg: 'image/jpeg',
+                ico: 'image/x-icon',
+                gif: 'image/gif',
+                webp: 'image/webp',
+            };
+            res.setHeader('Content-Type', mime[ext] ?? 'application/octet-stream');
+            res.statusCode = 200;
+            res.end(content);
         }
-        // Server configuration
-        const port = options.port || 3000;
-        const host = options.host || 'localhost';
-        // Create static file server using sirv
-        const serve = (0, sirv_1.default)(distDir, {
-            dev: true, // Development mode (no caching)
-            single: true, // SPA mode: serve index.html for 404s
-            etag: true,
-        });
-        // Create HTTP server
-        const server = http_1.default.createServer((req, res) => {
-            serve(req, res, () => {
-                // Fallback for 404s
-                res.statusCode = 404;
-                res.end('Not found');
-            });
-        });
-        // Start server
-        server.listen(port, host, () => {
-            console.log('\n🚀 Mordoc dev server started\n');
-            console.log(`  Local:   http://${host}:${port}`);
-            console.log(`  Network: http://${getLocalIpAddress()}:${port}`);
-            console.log('\n📝 Note: This is serving the pre-built dist/ folder.');
-            console.log('   Run "mordoc build" to rebuild after making changes.\n');
-            console.log('Press Ctrl+C to stop the server');
-        });
-        // Handle server errors
-        server.on('error', (error) => {
-            if (error.code === 'EADDRINUSE') {
-                console.error(`❌ Error: Port ${port} is already in use`);
-                console.error(`Try a different port: mordoc dev --port ${port + 1}`);
+        catch {
+            next();
+        }
+    });
+    server.middlewares.use(async (req, res, next) => {
+        try {
+            const url = req.url ?? '/';
+            // Let Vite handle asset/module requests (anything with a file extension).
+            const lastSegment = url.split('?')[0]?.split('/').pop() ?? '';
+            if (lastSegment.includes('.')) {
+                return next();
             }
-            else {
-                console.error('❌ Server error:', error.message);
+            const rawTemplate = await fs.readFile(templatePath, 'utf-8');
+            const transformed = await server.transformIndexHtml(url, rawTemplate);
+            const faviconPath = path.join(projectRoot, 'config', 'assets', 'favicon.ico');
+            let headHtml = '';
+            try {
+                await fs.access(faviconPath);
+                headHtml = '<link rel="icon" href="/_assets/favicon.ico">';
             }
-            process.exit(1);
-        });
-        // Graceful shutdown
-        process.on('SIGINT', () => {
-            console.log('\n\n👋 Shutting down dev server...');
-            server.close(() => {
-                console.log('✓ Server stopped');
-                process.exit(0);
-            });
-        });
-        process.on('SIGTERM', () => {
-            server.close(() => {
-                process.exit(0);
-            });
-        });
-    }
-    catch (error) {
-        console.error('\n❌ Failed to start dev server:');
-        console.error(error.message);
-        process.exit(1);
-    }
-}
-/**
- * Parse command-line arguments for dev command
- */
-function parseDevArgs(args) {
-    const options = {};
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        switch (arg) {
-            case '--port':
-            case '-p':
-                const portValue = parseInt(args[++i], 10);
-                if (isNaN(portValue)) {
-                    console.error('Error: Invalid port number');
-                    process.exit(1);
-                }
-                options.port = portValue;
-                break;
-            case '--host':
-            case '-h':
-                options.host = args[++i];
-                break;
-            case '--open':
-            case '-o':
-                options.open = true;
-                break;
-            case '--help':
-                showDevHelp();
-                process.exit(0);
-                break;
-            default:
-                if (arg.startsWith('-')) {
-                    console.warn(`Warning: Unknown option ${arg}`);
-                }
-                break;
+            catch {
+                // no favicon configured
+            }
+            // In dev, App.tsx's useEffect corrects document.documentElement.lang after hydration.
+            // We still replace the marker so the attribute value is valid (empty = unknown language).
+            const finalHtml = transformed
+                .replace(SSR_LANG_MARKER, '')
+                .replace(SSR_HEAD_MARKER, headHtml)
+                .replace(SSR_OUTLET_MARKER, '');
+            res.statusCode = 200;
+            res.setHeader('Content-Type', 'text/html');
+            res.end(finalHtml);
         }
-    }
-    return options;
-}
-/**
- * Show help text for dev command
- */
-function showDevHelp() {
-    console.log(`
-mordoc dev - Start development server
-
-Usage:
-  mordoc dev [options]
-
-Options:
-  -p, --port <number>   Port number (default: 3000)
-  -h, --host <host>     Host address (default: localhost)
-  -o, --open            Open browser automatically
-  --help                Show this help message
-
-Note:
-  The dev server serves the pre-built dist/ folder.
-  Run "mordoc build" first to generate the site.
-  Rebuild manually after making changes.
-
-Examples:
-  mordoc dev
-  mordoc dev --port 8080
-  mordoc dev --host 0.0.0.0
-  `);
-}
-/**
- * Get local IP address for network access
- */
-function getLocalIpAddress() {
-    const { networkInterfaces } = require('os');
-    const nets = networkInterfaces();
-    for (const name of Object.keys(nets)) {
-        for (const net of nets[name]) {
-            // Skip internal and non-IPv4 addresses
-            if (net.family === 'IPv4' && !net.internal) {
-                return net.address;
+        catch (err) {
+            if (err instanceof Error) {
+                server.ssrFixStacktrace(err);
             }
+            next(err);
         }
-    }
-    return 'localhost';
+    });
+    await server.listen();
+    const resolvedPort = server.config.server.port ?? 5173;
+    console.log(`\n  Mordoc dev server running`);
+    console.log(`  → http://localhost:${resolvedPort}/`);
+    console.log(`  Project: ${projectRoot}\n`);
 }
 //# sourceMappingURL=dev.js.map

package/dist/cli/dev.js.map

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

package/dist/cli/pagefind-indexer.d.ts

@@ -0,0 +1,15 @@
+import type { MordocData } from '../types/pipeline.js';
+/**
+ * Builds Pagefind search indexes after SSG completes.
+ *
+ * Single-language sites produce one index at `dist/pagefind/`.
+ *
+ * Multi-language sites produce a separate index per language at
+ * `dist/pagefind-{lang}/` so the browser loads only the index for the
+ * currently-active language. Non-default languages live under `/{lang}/` in
+ * the dist tree, which makes glob scoping straightforward. The default
+ * language lives at the root, so its index is built by including root HTML
+ * files plus every content subdirectory that is NOT claimed by another lang.
+ */
+export declare function runPagefindIndexer(data: MordocData, distDir: string): Promise<void>;
+//# sourceMappingURL=pagefind-indexer.d.ts.map

package/dist/cli/pagefind-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagefind-indexer.d.ts","sourceRoot":"","sources":["../../src/cli/pagefind-indexer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAsCvD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BzF"}

package/dist/cli/pagefind-indexer.js

@@ -0,0 +1,68 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { createIndex } from 'pagefind';
+/**
+ * Builds a Pagefind search index from a set of glob patterns within distDir.
+ * Each glob is added as a separate addDirectory call so callers can mix
+ * root-level and subdirectory globs without negation patterns (which Pagefind
+ * does not support).
+ */
+async function buildIndex(distDir, globs, outputPath) {
+    const { index, errors } = await createIndex({});
+    if (!index)
+        throw new Error(`pagefind createIndex failed: ${errors.join(', ')}`);
+    for (const glob of globs) {
+        await index.addDirectory({ path: distDir, glob });
+    }
+    await index.writeFiles({ outputPath });
+}
+/**
+ * Returns top-level subdirectory names of distDir, excluding the given names
+ * and any Pagefind output dirs or Vite asset dirs that begin with `_`.
+ */
+async function getContentDirs(distDir, exclude) {
+    const entries = await fs.readdir(distDir, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isDirectory() &&
+        !exclude.includes(e.name) &&
+        !e.name.startsWith('pagefind') &&
+        !e.name.startsWith('_'))
+        .map((e) => e.name);
+}
+/**
+ * Builds Pagefind search indexes after SSG completes.
+ *
+ * Single-language sites produce one index at `dist/pagefind/`.
+ *
+ * Multi-language sites produce a separate index per language at
+ * `dist/pagefind-{lang}/` so the browser loads only the index for the
+ * currently-active language. Non-default languages live under `/{lang}/` in
+ * the dist tree, which makes glob scoping straightforward. The default
+ * language lives at the root, so its index is built by including root HTML
+ * files plus every content subdirectory that is NOT claimed by another lang.
+ */
+export async function runPagefindIndexer(data, distDir) {
+    const { language, site } = data;
+    if (!language || language.languages.length <= 1) {
+        await buildIndex(distDir, ['**/*.html'], path.join(distDir, 'pagefind'));
+        console.log('  pagefind index → dist/pagefind/');
+        return;
+    }
+    const defaultLang = site.defaultLanguage;
+    const nonDefaultLangs = language.languages.filter((l) => l !== defaultLang);
+    for (const lang of language.languages) {
+        const outputPath = path.join(distDir, `pagefind-${lang}`);
+        if (lang !== defaultLang) {
+            // Non-default language: pages are entirely under /{lang}/
+            await buildIndex(distDir, [`${lang}/**/*.html`], outputPath);
+        }
+        else {
+            // Default language: root HTML + any content subdir not owned by another lang
+            const contentDirs = await getContentDirs(distDir, nonDefaultLangs);
+            const globs = ['*.html', ...contentDirs.map((d) => `${d}/**/*.html`)];
+            await buildIndex(distDir, globs, outputPath);
+        }
+        console.log(`  pagefind index → dist/pagefind-${lang}/`);
+    }
+}
+//# sourceMappingURL=pagefind-indexer.js.map

package/dist/cli/pagefind-indexer.js.map

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

package/dist/cli/paths.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Resolves the absolute path to mordoc's own package root.
+ *
+ * Files under `src/cli/` compile to `dist/cli/<name>.js`, which sits two
+ * directories below the package root. Using `import.meta.url` means the
+ * resolution works regardless of where mordoc is installed — in its own
+ * repo during development, or under `node_modules/mordoc/` in a user's
+ * project.
+ *
+ * Shared between `dev.ts` and `build.ts` because both Vite invocations
+ * (dev server, production build) point Vite's `root` at mordoc's own
+ * client source folder, not at anything inside the user's project.
+ */
+export declare function getPackageRoot(): string;
+/**
+ * Resolves the absolute path to the client source root that Vite uses
+ * as its `root` for both dev serving and production builds.
+ *
+ * This is where `index.html`, `main.tsx`, and `entry-server.tsx` live
+ * inside the mordoc package — all client-bound TSX/HTML that Vite
+ * compiles in the user's environment. The user's project never points
+ * Vite at any of its own files; everything user-side flows through the
+ * mordoc plugin's virtual modules.
+ */
+export declare function getClientRoot(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/cli/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/cli/paths.js

@@ -0,0 +1,32 @@
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+/**
+ * Resolves the absolute path to mordoc's own package root.
+ *
+ * Files under `src/cli/` compile to `dist/cli/<name>.js`, which sits two
+ * directories below the package root. Using `import.meta.url` means the
+ * resolution works regardless of where mordoc is installed — in its own
+ * repo during development, or under `node_modules/mordoc/` in a user's
+ * project.
+ *
+ * Shared between `dev.ts` and `build.ts` because both Vite invocations
+ * (dev server, production build) point Vite's `root` at mordoc's own
+ * client source folder, not at anything inside the user's project.
+ */
+export function getPackageRoot() {
+    return path.resolve(fileURLToPath(import.meta.url), '../../..');
+}
+/**
+ * Resolves the absolute path to the client source root that Vite uses
+ * as its `root` for both dev serving and production builds.
+ *
+ * This is where `index.html`, `main.tsx`, and `entry-server.tsx` live
+ * inside the mordoc package — all client-bound TSX/HTML that Vite
+ * compiles in the user's environment. The user's project never points
+ * Vite at any of its own files; everything user-side flows through the
+ * mordoc plugin's virtual modules.
+ */
+export function getClientRoot() {
+    return path.join(getPackageRoot(), 'src', 'client');
+}
+//# sourceMappingURL=paths.js.map

package/dist/cli/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC"}

package/dist/cli/ssg-runner.d.ts

@@ -0,0 +1,58 @@
+import type { MordocData } from '../types/pipeline.js';
+export interface SsgRunnerOptions {
+    /**
+     * Pipeline output for the project. Same instance the Vite plugin used,
+     * so per-page metadata and the route list are guaranteed to match the
+     * code-split chunks the client build just emitted.
+     */
+    data: MordocData;
+    /**
+     * Where Vite wrote the client bundle and the transformed `index.html`.
+     * The runner reads `index.html` from here (it already has the hashed
+     * entry script tag), substitutes per-route, and writes the rendered
+     * pages back into this same directory tree.
+     */
+    clientOutDir: string;
+    /**
+     * Where Vite wrote the SSR bundle. The runner does a single dynamic
+     * `import()` of `entry-server.js` from here to obtain the `render()`
+     * function. Once this command finishes, this directory is deleted.
+     */
+    ssrOutDir: string;
+}
+/**
+ * Renders every route to a static HTML file in `clientOutDir`.
+ *
+ * Flow per route:
+ *   1. Build a synthetic `Request` from the routePath. The SSR `render`
+ *      function only consults the URL's pathname for routing, so the
+ *      `http://localhost` origin is filler — it just has to parse as a
+ *      valid URL.
+ *   2. Call `render(request, shellData)` from the SSR bundle. This
+ *      runs `createStaticHandler.query()`, which resolves the route's
+ *      loader, which dynamically imports the lazy page module from the
+ *      same SSR bundle. React Router's `<StaticRouterProvider>` then
+ *      renders the matched tree to a string AND emits a `<script>` tag
+ *      carrying the loader data, both inside the returned `html`.
+ *   3. Substitute `<!--ssr-head-->` and `<!--ssr-outlet-->` in the
+ *      transformed-by-Vite `index.html` template using the
+ *      replacement-FUNCTION form. The string form of `String.replace`
+ *      honours `$` patterns (`$$` → `$`), and the hydration `<script>`
+ *      from step 2 contains Markdoc's `$$mdtype` markers — the string
+ *      form would mangle them, breaking `Tag.isTag()` on the client and
+ *      surfacing as "Objects are not valid as a React child" the moment
+ *      hydration tries to re-render. Function form bypasses pattern
+ *      processing entirely.
+ *   4. Write to the route's `index.html`, creating parent directories
+ *      as needed (e.g. `/flight-manual/safety` requires
+ *      `dist/flight-manual/safety/`).
+ *
+ * The template is read once. Vite's client build has already produced
+ * `dist/index.html` with the hashed entry `<script>` tag in place, so
+ * every per-route file inherits the correct script reference for free.
+ *
+ * The SSR bundle import uses `pathToFileURL` because Node's ESM loader
+ * rejects raw absolute Windows paths in `import()` ("ERR_UNSUPPORTED_ESM_URL_SCHEME").
+ */
+export declare function runSsg(options: SsgRunnerOptions): Promise<void>;
+//# sourceMappingURL=ssg-runner.d.ts.map

package/dist/cli/ssg-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssg-runner.d.ts","sourceRoot":"","sources":["../../src/cli/ssg-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,sBAAsB,CAAC;AAalE,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,EAAE,UAAU,CAAC;IACjB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAgED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCrE"}