mordoc 0.1.14 → 1.0.0

package/bin/cli.js

@@ -1,81 +1,34 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
-const path = require('path');
-const fs = require('fs');
+// Entry point for the Mordoc CLI. This file is intentionally plain JS (not TS)
+// so it can be executed directly by Node without a build step.
+// The actual logic lives in compiled output under dist/.
 
-// Get the command from arguments
-const args = process.argv.slice(2);
-const command = args[0];
-const commandArgs = args.slice(1); // Arguments after the command
+import { runDevCommand } from '../dist/cli/dev.js';
+import { runBuildCommand } from '../dist/cli/build.js';
 
-// Display help text
-function showHelp() {
-  console.log(`
-Mordoc - Static Site Generator for Documentation
+const command = process.argv[2];
 
-Usage:
-  mordoc <command> [options]
-
-Commands:
-  build      Build the documentation site
-  dev        Start the development server
-  
-Options:
-  --help     Show this help message
-
-Examples:
-  mordoc build
-  mordoc build --verbose --drafts
-  mordoc dev
-  mordoc dev --port 8080
-  `);
-}
-
-// Main CLI logic
-async function main() {
-  // Show help if no command or --help flag
-  if (!command || command === '--help' || command === '-h') {
-    showHelp();
-    process.exit(0);
-  }
-
-  // Check if dist folder exists (TypeScript must be compiled first)
-  const distPath = path.join(__dirname, '../dist/cli');
-  if (!fs.existsSync(distPath)) {
-    console.error('Error: Mordoc is not built. Please run "tsc" first to compile TypeScript.');
+if (command === 'dev') {
+  try {
+    await runDevCommand({ projectRoot: process.cwd() });
+  } catch (err) {
+    console.error('\n✘ Dev server failed to start:\n');
+    console.error(err.message);
     process.exit(1);
   }
-
-  // Route to appropriate command handler
+} else if (command === 'build') {
   try {
-    switch (command) {
-      case 'build': {
-        const buildHandler = require('../dist/cli/build.js');
-        const options = buildHandler.parseBuildArgs(commandArgs);
-        await buildHandler.build(options);
-        break;
-      }
-      
-      case 'dev': {
-        const devHandler = require('../dist/cli/dev.js');
-        const options = devHandler.parseDevArgs(commandArgs);
-        await devHandler.dev(options);
-        break;
-      }
-      
-      default:
-        console.error(`Unknown command: ${command}`);
-        showHelp();
-        process.exit(1);
-    }
-  } catch (error) {
-    console.error('Error:', error.message);
-    if (process.env.DEBUG) {
-      console.error(error.stack);
-    }
+    await runBuildCommand({ projectRoot: process.cwd() });
+  } catch (err) {
+    console.error('\n✘ Build failed:\n');
+    console.error(err.stack ?? err.message);
     process.exit(1);
   }
+} else {
+  console.log('Usage: mordoc <command>');
+  console.log('\nCommands:');
+  console.log('  dev      Start the Mordoc dev server');
+  console.log('  build    Render the project to static HTML in dist/');
+  process.exit(1);
 }
-
-// Run the CLI
-main();

package/dist/cli/asset-rewrite.d.ts

@@ -0,0 +1,40 @@
+import type { MordocData } from '../types/pipeline.js';
+/**
+ * Copies every non-null asset file out of the user's `config/assets/`
+ * to a flat `<clientOutDir>/_assets/` folder, then returns a new
+ * `MordocData` whose `assets` field references the served URLs instead
+ * of the original absolute disk paths.
+ *
+ * Why this exists right now:
+ *   `loadAssets` produces absolute disk paths (e.g.
+ *   `C:\Users\...\config\assets\favicon.ico`). Those paths land inside
+ *   the bundled `virtual:mordoc/assets` module on the client and inside
+ *   the React tree's serialized loader data on SSR. Neither has any
+ *   business in deployed output — disk paths are useless to a browser
+ *   and embedding them in HTML/JS leaks the build machine's filesystem
+ *   layout. The moment a theme component reads `assets.favicon`, that
+ *   leak becomes a visible bug. Rewriting now closes the gap before any
+ *   theme exists; the cost is small and the alternative is a latent
+ *   regression waiting for the first `<link rel="icon" href={...} />`.
+ *
+ * Why build-only:
+ *   Dev rewrites asset paths at virtual-module generation time (plugin.ts
+ *   `rewriteAssetsForDev`) and serves files via a `/_assets/*` middleware
+ *   in dev.ts — no copy step needed there.
+ *
+ * Filename strategy:
+ *   Output filename = basename of the source file. The current loader
+ *   discovers exactly three known assets by convention (favicon, logo,
+ *   logo-dark) so basename collisions are impossible by construction.
+ *   When the asset surface grows beyond conventional discovery, this
+ *   strategy will need a content-hash suffix to disambiguate.
+ *
+ * Note on `logoDark` falling back to `logo`:
+ *   `loadAssets` returns the same source path for both when no separate
+ *   dark logo exists. `fs.copyFile` is idempotent under repeated copies
+ *   to the same destination, so the duplicate copy is harmless and the
+ *   resulting URLs are identical — exactly the fall-through the loader
+ *   intended.
+ */
+export declare function copyAndRewriteAssets(data: MordocData, clientOutDir: string): Promise<MordocData>;
+//# sourceMappingURL=asset-rewrite.d.ts.map

package/dist/cli/asset-rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-rewrite.d.ts","sourceRoot":"","sources":["../../src/cli/asset-rewrite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAcvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,CAAC,CAWrB"}

package/dist/cli/asset-rewrite.js

@@ -0,0 +1,67 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+/**
+ * Public URL prefix used for rewritten asset paths.
+ *
+ * Underscore-prefixed deliberately: Vite's client build emits its own
+ * code chunks into `dist/assets/` (no underscore) and we don't want a
+ * collision with that directory. `_assets` is conventional for "static
+ * resources copied verbatim, not bundler output".
+ */
+const ASSET_URL_PREFIX = '/_assets';
+const ASSET_DIR_NAME = '_assets';
+/**
+ * Copies every non-null asset file out of the user's `config/assets/`
+ * to a flat `<clientOutDir>/_assets/` folder, then returns a new
+ * `MordocData` whose `assets` field references the served URLs instead
+ * of the original absolute disk paths.
+ *
+ * Why this exists right now:
+ *   `loadAssets` produces absolute disk paths (e.g.
+ *   `C:\Users\...\config\assets\favicon.ico`). Those paths land inside
+ *   the bundled `virtual:mordoc/assets` module on the client and inside
+ *   the React tree's serialized loader data on SSR. Neither has any
+ *   business in deployed output — disk paths are useless to a browser
+ *   and embedding them in HTML/JS leaks the build machine's filesystem
+ *   layout. The moment a theme component reads `assets.favicon`, that
+ *   leak becomes a visible bug. Rewriting now closes the gap before any
+ *   theme exists; the cost is small and the alternative is a latent
+ *   regression waiting for the first `<link rel="icon" href={...} />`.
+ *
+ * Why build-only:
+ *   Dev rewrites asset paths at virtual-module generation time (plugin.ts
+ *   `rewriteAssetsForDev`) and serves files via a `/_assets/*` middleware
+ *   in dev.ts — no copy step needed there.
+ *
+ * Filename strategy:
+ *   Output filename = basename of the source file. The current loader
+ *   discovers exactly three known assets by convention (favicon, logo,
+ *   logo-dark) so basename collisions are impossible by construction.
+ *   When the asset surface grows beyond conventional discovery, this
+ *   strategy will need a content-hash suffix to disambiguate.
+ *
+ * Note on `logoDark` falling back to `logo`:
+ *   `loadAssets` returns the same source path for both when no separate
+ *   dark logo exists. `fs.copyFile` is idempotent under repeated copies
+ *   to the same destination, so the duplicate copy is harmless and the
+ *   resulting URLs are identical — exactly the fall-through the loader
+ *   intended.
+ */
+export async function copyAndRewriteAssets(data, clientOutDir) {
+    const targetDir = path.join(clientOutDir, ASSET_DIR_NAME);
+    await fs.mkdir(targetDir, { recursive: true });
+    const rewritten = {
+        favicon: await copyAndRewriteOne(data.assets.favicon, targetDir),
+        logo: await copyAndRewriteOne(data.assets.logo, targetDir),
+        logoDark: await copyAndRewriteOne(data.assets.logoDark, targetDir),
+    };
+    return { ...data, assets: rewritten };
+}
+async function copyAndRewriteOne(sourcePath, targetDir) {
+    if (sourcePath === null)
+        return null;
+    const filename = path.basename(sourcePath);
+    await fs.copyFile(sourcePath, path.join(targetDir, filename));
+    return `${ASSET_URL_PREFIX}/${filename}`;
+}
+//# sourceMappingURL=asset-rewrite.js.map

package/dist/cli/asset-rewrite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-rewrite.js","sourceRoot":"","sources":["../../src/cli/asset-rewrite.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAAG,UAAU,CAAC;AACpC,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAgB,EAChB,YAAoB;IAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAmB;QAChC,OAAO,EAAE,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC;QAChE,IAAI,EAAE,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC;QAC1D,QAAQ,EAAE,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;KACnE,CAAC;IAEF,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,UAAyB,EACzB,SAAiB;IAEjB,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9D,OAAO,GAAG,gBAAgB,IAAI,QAAQ,EAAE,CAAC;AAC3C,CAAC"}

package/dist/cli/build.d.ts

@@ -1,20 +1,50 @@
-/**
- * Build command - Generates static site from content
- * Usage: mordoc build [options]
- */
 export interface BuildCommandOptions {
-    projectRoot?: string;
-    outputDir?: string;
-    verbose?: boolean;
-    drafts?: boolean;
-    clean?: boolean;
+    /** Absolute path to the user's project root. */
+    projectRoot: string;
 }
 /**
- * Execute the build command
- */
-export declare function build(options?: BuildCommandOptions): Promise<void>;
-/**
- * Parse command-line arguments for build command
+ * Runs the full Mordoc production build for a project.
+ *
+ * Architecture mirrors `dev.ts`:
+ *   - Vite's `root` is mordoc's own `src/app/` — the user's project
+ *     contains no TSX/HTML that Vite ever sees as code. All user-side
+ *     data flows through the mordoc plugin's virtual modules.
+ *   - `publicDir` is pointed at `<projectRoot>/public/` for the client
+ *     build so that author assets (referenced from markdown as
+ *     `/images/foo.png` etc.) get copied into `dist/` verbatim. The SSR
+ *     build sets `publicDir: false` to avoid copying the same files into
+ *     the throwaway SSR intermediate.
+ *   - `configFile: false` prevents Vite from picking up any stray
+ *     `vite.config.js` the user might have lying around.
+ *
+ * Pipeline shape:
+ *   1. `runPipeline(projectRoot)` once, up front. The result is injected
+ *      into both Vite plugin instances below so the pipeline doesn't run
+ *      twice. This also gives us a single point to mutate the data later
+ *      (e.g. asset URL rewriting) before either Vite pass starts.
+ *   2. Wipe the previous `dist/` and SSR cache. We do this manually
+ *      rather than relying on Vite's `emptyOutDir` because both output
+ *      directories live outside Vite's `root`, where Vite's auto-empty
+ *      logic is intentionally cautious. Manual wipe keeps the behaviour
+ *      explicit and the same for both passes.
+ *   3. Client build: bundles `main.tsx` + every route's lazy chunk into
+ *      hashed `dist/assets/*.js`. `manifest: true` emits the chunk-graph
+ *      manifest the SSG runner will read to inject per-route preloads.
+ *      Vite also transforms `index.html` (rewriting the `<script>` tag
+ *      from `/main.tsx` to the hashed entry) and writes it to
+ *      `dist/index.html` — that becomes the SSG runner's per-route
+ *      template.
+ *   4. SSR build: bundles `entry-server.tsx` for Node consumption into
+ *      `node_modules/.mordoc/ssr/`. Vite preserves the dynamic
+ *      `import('virtual:mordoc/page/...')` calls as runtime imports,
+ *      code-split into sibling files, so the SSG runner can lazily load
+ *      each route's content as it renders.
+ *   5. SSG runner: loads the SSR bundle, calls `render()` per route,
+ *      writes the resulting HTML files. (Wired in a follow-up step.)
+ *
+ * The dev path is unaffected by any of this — its plugin instance still
+ * runs the pipeline itself, exactly as before. Build is the only caller
+ * that pre-loads `data`.
  */
-export declare function parseBuildArgs(args: string[]): BuildCommandOptions;
+export declare function runBuildCommand(options: BuildCommandOptions): Promise<void>;
 //# sourceMappingURL=build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAyClE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0GjF"}

package/dist/cli/build.js

@@ -1,111 +1,196 @@
-"use strict";
+import { build as viteBuild } from 'vite';
+import react from '@vitejs/plugin-react';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { runPipeline } from '../pipeline.js';
+import { mordocVitePlugin } from '../vite/plugin.js';
+import { getAppRoot } from '../utils/paths.js';
+import { runSsg } from './ssg-runner.js';
+import { copyAndRewriteAssets } from './asset-rewrite.js';
+import { runPagefindIndexer } from './pagefind-indexer.js';
+function getOutDirs(projectRoot) {
+    return {
+        clientOutDir: path.join(projectRoot, 'dist'),
+        ssrOutDir: path.join(projectRoot, 'node_modules', '.mordoc', 'ssr'),
+    };
+}
 /**
- * Build command - Generates static site from content
- * Usage: mordoc build [options]
+ * Runs the full Mordoc production build for a project.
+ *
+ * Architecture mirrors `dev.ts`:
+ *   - Vite's `root` is mordoc's own `src/app/` — the user's project
+ *     contains no TSX/HTML that Vite ever sees as code. All user-side
+ *     data flows through the mordoc plugin's virtual modules.
+ *   - `publicDir` is pointed at `<projectRoot>/public/` for the client
+ *     build so that author assets (referenced from markdown as
+ *     `/images/foo.png` etc.) get copied into `dist/` verbatim. The SSR
+ *     build sets `publicDir: false` to avoid copying the same files into
+ *     the throwaway SSR intermediate.
+ *   - `configFile: false` prevents Vite from picking up any stray
+ *     `vite.config.js` the user might have lying around.
+ *
+ * Pipeline shape:
+ *   1. `runPipeline(projectRoot)` once, up front. The result is injected
+ *      into both Vite plugin instances below so the pipeline doesn't run
+ *      twice. This also gives us a single point to mutate the data later
+ *      (e.g. asset URL rewriting) before either Vite pass starts.
+ *   2. Wipe the previous `dist/` and SSR cache. We do this manually
+ *      rather than relying on Vite's `emptyOutDir` because both output
+ *      directories live outside Vite's `root`, where Vite's auto-empty
+ *      logic is intentionally cautious. Manual wipe keeps the behaviour
+ *      explicit and the same for both passes.
+ *   3. Client build: bundles `main.tsx` + every route's lazy chunk into
+ *      hashed `dist/assets/*.js`. `manifest: true` emits the chunk-graph
+ *      manifest the SSG runner will read to inject per-route preloads.
+ *      Vite also transforms `index.html` (rewriting the `<script>` tag
+ *      from `/main.tsx` to the hashed entry) and writes it to
+ *      `dist/index.html` — that becomes the SSG runner's per-route
+ *      template.
+ *   4. SSR build: bundles `entry-server.tsx` for Node consumption into
+ *      `node_modules/.mordoc/ssr/`. Vite preserves the dynamic
+ *      `import('virtual:mordoc/page/...')` calls as runtime imports,
+ *      code-split into sibling files, so the SSG runner can lazily load
+ *      each route's content as it renders.
+ *   5. SSG runner: loads the SSR bundle, calls `render()` per route,
+ *      writes the resulting HTML files. (Wired in a follow-up step.)
+ *
+ * The dev path is unaffected by any of this — its plugin instance still
+ * runs the pipeline itself, exactly as before. Build is the only caller
+ * that pre-loads `data`.
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.build = build;
-exports.parseBuildArgs = parseBuildArgs;
-const path_1 = __importDefault(require("path"));
-const Builder_1 = require("../build/Builder");
+export async function runBuildCommand(options) {
+    const { projectRoot } = options;
+    const appRoot = getAppRoot();
+    const publicDir = path.join(projectRoot, 'public');
+    const { clientOutDir, ssrOutDir } = getOutDirs(projectRoot);
+    console.log('\n  Mordoc build');
+    console.log(`  Project: ${projectRoot}\n`);
+    console.log('→ running pipeline...');
+    const rawData = await runPipeline(projectRoot);
+    console.log(`  ${rawData.pages.length} page(s) discovered\n`);
+    console.log('→ wiping previous output...');
+    await fs.rm(clientOutDir, { recursive: true, force: true });
+    await fs.rm(ssrOutDir, { recursive: true, force: true });
+    // Asset rewrite has to happen before either Vite pass: both bundles
+    // import `virtual:mordoc/assets` (transitively, via `main.tsx`'s
+    // ShellData assembly), and the SSG runner builds its `shellData`
+    // from the same `MordocData`. One rewrite, three consistent views.
+    // Note: this also creates `dist/_assets/` with the copied files.
+    // Vite's subsequent client build runs with `emptyOutDir: false` so
+    // those copies survive.
+    console.log('→ copying assets...');
+    const data = await copyAndRewriteAssets(rawData, clientOutDir);
+    console.log('→ building client bundle...');
+    await viteBuild({
+        configFile: false,
+        root: appRoot,
+        publicDir,
+        plugins: [
+            react(),
+            mordocVitePlugin({ projectRoot, data }),
+        ],
+        build: {
+            outDir: clientOutDir,
+            // We wiped above; suppress Vite's "outDir is outside root" guard.
+            // Also keeps `dist/_assets/` from being deleted between this
+            // build and the next phase.
+            emptyOutDir: false,
+            manifest: true,
+        },
+    });
+    console.log('→ building SSR bundle...');
+    await viteBuild({
+        configFile: false,
+        root: appRoot,
+        // The SSR pass produces a Node-loadable bundle in a throwaway
+        // intermediate; copying author assets into it is wasted I/O and
+        // would put them under `node_modules/.mordoc/ssr/` rather than
+        // `dist/`. Disable publicDir entirely for this pass.
+        publicDir: false,
+        plugins: [
+            react(),
+            mordocVitePlugin({ projectRoot, data }),
+        ],
+        build: {
+            outDir: ssrOutDir,
+            emptyOutDir: false,
+            ssr: 'entry-server.tsx',
+        },
+    });
+    // Declare the SSR output directory as an ESM scope.
+    //
+    // Vite emits the SSR bundle in ESM syntax (because mordoc's own
+    // package.json has `"type": "module"`, which Vite uses to pick the
+    // SSR output format). Without a package.json here, Node's loader
+    // walks up looking for `"type": "module"` and — because the bundle
+    // lives under the user project's `node_modules/.mordoc/ssr/`, and
+    // `node_modules/` acts as a package-scope boundary — falls back to
+    // CommonJS. The first `import { ... } from "..."` then SyntaxErrors.
+    //
+    // Dropping a one-liner package.json next to the bundle declares the
+    // scope unambiguously and is the standard pattern other SSR-emitting
+    // frameworks (Astro, SvelteKit, Nuxt, Remix) use for the same reason.
+    // The cleanup step at the end of this command wipes ssrOutDir
+    // entirely, so this file vanishes along with the rest.
+    await fs.writeFile(path.join(ssrOutDir, 'package.json'), '{"type":"module"}\n', 'utf-8');
+    console.log('\n→ rendering routes to static HTML...');
+    await runSsg({ data, clientOutDir, ssrOutDir });
+    // The SSR bundle is a build-time intermediate; once the SSG runner has
+    // finished rendering every route there's no consumer left for it.
+    // Wiping it keeps `node_modules/.mordoc/` from accumulating stale
+    // chunks across builds and reinforces the "anything not in dist/ is
+    // not deployable" mental model.
+    console.log('\n→ cleaning up SSR intermediate...');
+    await fs.rm(ssrOutDir, { recursive: true, force: true });
+    console.log('\n→ verifying output...');
+    await verifyBuildOutput(data, clientOutDir);
+    console.log('\n→ building search index...');
+    await runPagefindIndexer(data, clientOutDir);
+    console.log('\n✔ build complete');
+    console.log(`  output → ${clientOutDir}\n`);
+}
 /**
- * Execute the build command
+ * Defensive post-build checks.
+ *
+ * The SSG runner already throws on the obvious failure modes
+ * (`writeFile` errors, missing render export). These checks catch
+ * subtler regressions:
+ *
+ *   1. Every route in the pipeline produced a corresponding HTML file.
+ *      Defense-in-depth — the runner walks `data.pages` to write, and
+ *      this walks `data.pages` to read; a future refactor that skips
+ *      a route silently would surface here.
+ *
+ *   2. The rendered root HTML still contains literal `$$mdtype` markers
+ *      (the Markdoc Tag fingerprint) inside the hydration `<script>`.
+ *      If the value is absent, the substitution mangled it (string form
+ *      of `String.replace` collapsed `$$` → `$`), which would manifest
+ *      on the client as the "Objects are not valid as a React child"
+ *      crash the moment hydration tried to re-render. Cheapest possible
+ *      regression test for that bug; runs in milliseconds.
+ *      Skipped when no page has Markdoc content (empty project).
  */
-async function build(options = {}) {
-    const startTime = Date.now();
-    try {
-        // Get project root (current working directory by default)
-        const projectRoot = options.projectRoot || process.cwd();
-        // Resolve output directory
-        const outputDir = options.outputDir
-            ? path_1.default.resolve(projectRoot, options.outputDir)
-            : path_1.default.join(projectRoot, 'dist');
-        // Create builder instance
-        const builder = new Builder_1.Builder({
-            projectRoot,
-            outputDir,
-            clean: options.clean ?? true,
-            includeDrafts: options.drafts ?? false,
-            verbose: options.verbose ?? false,
-        });
-        // Execute build
-        await builder.build();
-        // Calculate build time
-        const buildTime = ((Date.now() - startTime) / 1000).toFixed(2);
-        console.log(`\n⚡ Build completed in ${buildTime}s`);
-        process.exit(0);
-    }
-    catch (error) {
-        console.error('\n❌ Build failed:');
-        console.error(error.message);
-        if (options.verbose) {
-            console.error('\nStack trace:');
-            console.error(error.stack);
+async function verifyBuildOutput(data, clientOutDir) {
+    for (const page of data.pages) {
+        const routePath = page.entry.routePath;
+        const expectedPath = routePath === '/'
+            ? path.join(clientOutDir, 'index.html')
+            : path.join(clientOutDir, routePath.slice(1), 'index.html');
+        try {
+            await fs.access(expectedPath);
+        }
+        catch {
+            throw new Error(`mordoc build: expected ${expectedPath} for route "${routePath}", but the file is missing.`);
         }
-        process.exit(1);
     }
-}
-/**
- * Parse command-line arguments for build command
- */
-function parseBuildArgs(args) {
-    const options = {};
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        switch (arg) {
-            case '--output':
-            case '-o':
-                options.outputDir = args[++i];
-                break;
-            case '--verbose':
-            case '-v':
-                options.verbose = true;
-                break;
-            case '--drafts':
-            case '-d':
-                options.drafts = true;
-                break;
-            case '--no-clean':
-                options.clean = false;
-                break;
-            case '--help':
-            case '-h':
-                showBuildHelp();
-                process.exit(0);
-                break;
-            default:
-                if (arg.startsWith('-')) {
-                    console.warn(`Warning: Unknown option ${arg}`);
-                }
-                break;
+    const hasRenderableContent = data.pages.length > 0;
+    if (hasRenderableContent) {
+        const rootHtml = await fs.readFile(path.join(clientOutDir, 'index.html'), 'utf-8');
+        if (!rootHtml.includes('$$mdtype')) {
+            throw new Error('mordoc build: rendered dist/index.html does not contain "$$mdtype". ' +
+                'The hydration data may have been mangled by string-form String.replace; ' +
+                'check that all SSR template substitutions use the replacement-function form.');
         }
     }
-    return options;
-}
-/**
- * Show help text for build command
- */
-function showBuildHelp() {
-    console.log(`
-mordoc build - Generate static documentation site
-
-Usage:
-  mordoc build [options]
-
-Options:
-  -o, --output <dir>    Output directory (default: dist)
-  -v, --verbose         Enable verbose logging
-  -d, --drafts          Include draft content in build
-  --no-clean            Don't clean output directory before build
-  -h, --help            Show this help message
-
-Examples:
-  mordoc build
-  mordoc build --output build
-  mordoc build --verbose --drafts
-  `);
 }
 //# sourceMappingURL=build.js.map

package/dist/cli/build.js.map

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