@vmz/vmz 0.0.2 → 0.0.3

package/README.md

@@ -28,21 +28,25 @@ toolchains.
 
 ## One tool, several views of the same program
 
-| Workflow | The question it should answer |
-|---|---|
-| Development | What changed, and which application regions are affected? |
-| Checking | Which state, route, server, or lifetime boundary cannot be proven? |
-| Building | What belongs in browser, SSR, resume, and server output? |
-| Testing | Did the application behave correctly and avoid unrelated work? |
-| Documents | Are project documents connected, localized, and deployable? |
+| Workflow    | The question it should answer                                      |
+|-------------|--------------------------------------------------------------------|
+| Development | What changed, and which application regions are affected?          |
+| Checking    | Which state, route, server, or lifetime boundary cannot be proven? |
+| Building    | What belongs in browser, SSR, resume, and server output?           |
+| Testing     | Did the application behave correctly and avoid unrelated work?     |
+| Documents   | Are project documents connected, localized, and deployable?        |
 
 ### Designed for the npm world
 
-VMZ does not ask users to abandon JavaScript packaging. Node remains the npm, plugin, development-server, and orchestration host. A long-lived N-API bridge connects that ecosystem to Rust and oxc without reducing semantic analysis to a sequence of tiny file transforms.
+VMZ does not ask users to abandon JavaScript packaging. Node remains the npm, plugin, development-server, and
+orchestration host. A long-lived N-API bridge connects that ecosystem to Rust and oxc without reducing semantic analysis
+to a sequence of tiny file transforms.
 
 ### More than pass or fail
 
-The interesting future of the CLI is explanation. A useful compiler should expose the source span, graph edge, owner, deployment boundary, and fallback reason behind a decision. That is a better developer experience than adding more colored output to an opaque build. 🧭
+The interesting future of the CLI is explanation. A useful compiler should expose the source span, graph edge, owner,
+deployment boundary, and fallback reason behind a decision. That is a better developer experience than adding more
+colored output to an opaque build. 🧭
 
 ## License
 

package/dist/application-cmd.d.ts

@@ -1,6 +1,5 @@
 /**
- * `vmz application` — Application Collection / Mount (M0–M5).
- * Design: `规划设计/vmz/22`
+ * `vmz application` — Application Collection / Mount .
  */
 /**
  * @param {string[]} argv

package/dist/application-cmd.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * `vmz application` — Application Collection / Mount (M0–M5).
- * Design: `规划设计/vmz/22`
+ * `vmz application` — Application Collection / Mount .
  */
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
@@ -42,18 +41,18 @@ export async function cmdApplication(argv) {
     return 1;
 }
 function printHelp() {
-    console.log(`vmz application — Application Collection / Mount (M0–M5)
+    console.log(`vmz application — Application Collection / Mount
 
 Usage:
   vmz application check [host]              Validate descriptors + applications.config.json5
   vmz application list [host]               List resolved ApplicationIds / collections / mounts
   vmz application schemas                   Print frozen protocol catalog JSON
-  vmz application relocatable [pkg]         M1: ApplicationBase / non_relocatable_url proof
-  vmz application relocate <manifest.json>  M1: apply ApplicationBase to relocation manifest
-  vmz application artifacts [host]          M2: ApplicationArtifact + MountTable boundary
-  vmz application isolation [host]          M3: isolation namespaces + failure containment
-  vmz application composition [host]        M4: catalog consumption + cross-app Link hrefs
-  vmz application dev [host]                M5: sessions / affected / proxy / mounted tests / deploy
+  vmz application relocatable [pkg]          ApplicationBase / non_relocatable_url proof
+  vmz application relocate <manifest.json>  apply ApplicationBase to relocation manifest
+  vmz application artifacts [host]          ApplicationArtifact + MountTable boundary
+  vmz application isolation [host]          isolation namespaces + failure containment
+  vmz application composition [host]        catalog consumption + cross-app Link hrefs
+  vmz application dev [host]                sessions / affected / proxy / mounted tests / deploy
 
 Options:
   --json [file]    Emit report JSON to stdout or file
@@ -125,7 +124,7 @@ function emitJson(args, json, printHuman) {
 }
 function cmdSchemas() {
     const native = loadNative();
-    console.log(native.queryApplicationProtocolCatalog());
+    console.log(native.queryApplicationProtocolCatalog);
     return 0;
 }
 /**

package/dist/bundler-adapter.d.ts

@@ -1,7 +1,6 @@
 /**
- * Bundler adapter (N4) — consumes Deployment IR; does not invent VMZ semantics.
+ * Bundler adapter (session) — consumes Deployment IR; does not invent VMZ semantics.
  *
- * Design: `规划设计/vmz/14` — VPG/Deployment IR → bundler executes pack/minify/assets.
  * Vite/Rolldown may call these helpers; they must not reverse the arrow.
  */
 /**
@@ -54,7 +53,7 @@ export declare function createVitePluginVmzAdapter(options?: {}): {
     configResolved(): void;
 };
 /**
- * Thin Rolldown plugin factory (N4.2) — same contract as Vite adapter: read Deployment IR only.
+ * Thin Rolldown plugin factory (deployment) — same contract as Vite adapter: read Deployment IR only.
  * @param {{ outDir?: string, root?: string }} [options]
  */
 export declare function createRolldownPluginVmzAdapter(options?: {}): {

package/dist/bundler-adapter.js

@@ -1,8 +1,7 @@
 // @ts-nocheck
 /**
- * Bundler adapter (N4) — consumes Deployment IR; does not invent VMZ semantics.
+ * Bundler adapter (session) — consumes Deployment IR; does not invent VMZ semantics.
  *
- * Design: `规划设计/vmz/14` — VPG/Deployment IR → bundler executes pack/minify/assets.
  * Vite/Rolldown may call these helpers; they must not reverse the arrow.
  */
 import { existsSync, readFileSync } from 'node:fs';
@@ -90,7 +89,7 @@ export function createVitePluginVmzAdapter(options = {}) {
     };
 }
 /**
- * Thin Rolldown plugin factory (N4.2) — same contract as Vite adapter: read Deployment IR only.
+ * Thin Rolldown plugin factory (deployment) — same contract as Vite adapter: read Deployment IR only.
  * @param {{ outDir?: string, root?: string }} [options]
  */
 export function createRolldownPluginVmzAdapter(options = {}) {

package/dist/cli.d.ts

@@ -1,5 +1,5 @@
 /**
- * Node CLI command implementations (N2).
+ * Node CLI command implementations .
  */
 /**
  * @param {string[]} argv
@@ -7,9 +7,17 @@
 export declare function parseArgs(argv: any): {
     _: any[];
 };
+export declare function printGlobalHelp(): void;
+export declare function printProjectHelp(): void;
+/** @deprecated use printProjectHelp / printGlobalHelp */
 export declare function printHelp(): void;
 /**
  * @param {string[]} argv
+ * @param {{
+ * cwd?: string,
+ * thisPackageRoot?: string,
+ * reexec?: (bin: string, argv: string[]) => Promise<number>,
+ * }} [opts]
  * @returns {Promise<number>}
  */
-export declare function runCli(argv: any): Promise<any>;
+export declare function runCli(argv: any, opts?: {}): Promise<any>;

package/dist/cli.js

@@ -1,12 +1,13 @@
 // @ts-nocheck
 /**
- * Node CLI command implementations (N2).
+ * Node CLI command implementations .
  */
 import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
+import { copyFileSync, existsSync } from 'node:fs';
 import path from 'node:path';
-import { HOST_PROTOCOL, createWorkspace, getProtocolVersions } from './index.js';
+import { HOST_PROTOCOL, createWorkspace, getProtocolVersions, resolveCoreRuntimeDist } from './index.js';
 import { createDevSession } from './dev-session.js';
+import { gateGlobalProjectCommand, getInvocationContext, isGlobalAllowedCommand } from './invocation.js';
 import { log } from './log.js';
 import { readPackageMeta, resolveWorkspaceDirs } from './resolve.js';
 import { cmdTest } from './test-cmd.js';
@@ -16,6 +17,7 @@ import { cmdLocale } from './locale-cmd.js';
 import { cmdApplication } from './application-cmd.js';
 import { cmdRefactor } from './refactor-cmd.js';
 import { cmdExplain } from './explain-cmd.js';
+import { resolveNativeVmzCli } from './resolve-native-cli.js';
 /**
  * @param {string[]} argv
  */
@@ -61,21 +63,48 @@ export function parseArgs(argv) {
     }
     return out;
 }
-export function printHelp() {
-    console.log(`vmz — Node toolchain host (N-API workspace)
+export function printGlobalHelp() {
+    console.log(`vmz — global mode (scaffold only)
+
+  developer  monorepo source (packages/runtimes/vmz) — full CLI
+  project    app node_modules/@vmz/vmz (or vmz) — full CLI
+  global     npm/pnpm -g — only new/init/help/version
+
+You are in global mode. Pin \`@vmz/vmz\` in the app so check/build/lsp
+use a traceable project install.
 
 Usage:
+  vmz new|init <dir>            Scaffold (native CLI; Node only gates + forwards)
+  vmz version                   Show host + native protocol versions
+  vmz help                      Show this help
+
+Project commands:
+  pnpm add -D @vmz/vmz
+  pnpm exec vmz check
+  # or: vmz new my-app && cd my-app && pnpm install
+
+If a project \`node_modules/@vmz/vmz\` (or \`vmz\`) exists, a global
+\`vmz <cmd>\` re-execs that bin.
+`);
+}
+export function printProjectHelp() {
+    console.log(`vmz — Node toolchain host (project / developer mode)
+
+Usage:
+  vmz new|init <dir>            Scaffold a minimal app (native CLI)
   vmz check [path]              Check project via Workspace
   vmz build [path] [options]    Build project via Workspace
   vmz serve [path] [options]    Serve dist (optional --build)
   vmz dev [path] [options]      Long-lived rebuild session (no CLI spawn)
   vmz format [path] [--check]   Format .vmz via N-API (oxc codegen)
   vmz lint [path] [--deny-warnings]  Lint (= check) via N-API
-  vmz test [path] [options]     Native test discover / report (T0+)
-  vmz document|docs <cmd>       Project /documents domain (D0: check)
-  vmz application <cmd>         Application Collection / Mount (M0–M5)
-  vmz refactor <cmd>            DX rename plans / apply (X1)
+  vmz test [path] [options]     Native test discover / report
+  vmz document|docs <cmd>       Project /documents domain 
+  vmz application <cmd>         Application Collection / Mount 
+  vmz refactor <cmd>            DX rename plans / apply 
   vmz explain [style] <target>  DX causal explain (style Theme chain)
+  vmz lsp [root] [--out-dir]    Language server (stdio; native CLI)
+  vmz mcp [root] [--out-dir]    MCP server (stdio; native CLI)
   vmz version                   Show host + native protocol versions
   vmz help                      Show this help
 
@@ -99,21 +128,51 @@ Options:
   --strict              Strict document locale/PageKey coverage (document check)
 `);
 }
+/** @deprecated use printProjectHelp / printGlobalHelp */
+export function printHelp() {
+    printProjectHelp();
+}
 /**
  * @param {string[]} argv
+ * @param {{
+ * cwd?: string,
+ * thisPackageRoot?: string,
+ * reexec?: (bin: string, argv: string[]) => Promise<number>,
+ * }} [opts]
  * @returns {Promise<number>}
  */
-export async function runCli(argv) {
+export async function runCli(argv, opts = {}) {
     const [cmd, ...rest] = argv;
+    const inv = getInvocationContext({
+        cwd: opts.cwd,
+        thisPackageRoot: opts.thisPackageRoot,
+    });
     if (!cmd || cmd === 'help' || cmd === '-h' || cmd === '--help') {
-        printHelp();
+        if (inv.mode === 'global')
+            printGlobalHelp();
+        else
+            printProjectHelp();
         return 0;
     }
     if (cmd === 'version' || cmd === '-V' || cmd === '--version') {
         return cmdVersion();
     }
+    if (!isGlobalAllowedCommand(cmd)) {
+        const gated = await gateGlobalProjectCommand({
+            argv,
+            cwd: opts.cwd,
+            thisPackageRoot: opts.thisPackageRoot,
+            reexec: opts.reexec,
+            logError: (msg) => log.error(msg),
+        });
+        if (gated.action === 'exit')
+            return gated.code;
+    }
     const args = parseArgs(rest);
     switch (cmd) {
+        case 'new':
+        case 'init':
+            return cmdNativeForward(cmd, rest);
         case 'check':
             return cmdCheck(args);
         case 'build':
@@ -142,12 +201,49 @@ export async function runCli(argv) {
             return cmdRefactor(rest);
         case 'explain':
             return cmdExplain(rest);
+        case 'lsp':
+            return cmdNativeForward('lsp', rest);
+        case 'mcp':
+            return cmdNativeForward('mcp', rest);
         default:
             log.error(`unknown command \`${cmd}\``);
-            printHelp();
+            if (inv.mode === 'global')
+                printGlobalHelp();
+            else
+                printProjectHelp();
             return 1;
     }
 }
+/**
+ * Forward to the single native `vmz` binary (vmz-tools).
+ * Scaffold / stdio servers live in Rust — Node only gates + re-execs.
+ *
+ * @param {'new' | 'init' | 'lsp' | 'mcp'} sub
+ * @param {string[]} argv
+ * @returns {Promise<number>}
+ */
+function cmdNativeForward(sub, argv) {
+    const bin = resolveNativeVmzCli();
+    if (!bin) {
+        log.error('native `vmz` CLI not found (vmz-tools).');
+        log.error('Build: cargo build -p vmz-tools');
+        log.error('Or set VMZ_NATIVE to the absolute path of that binary.');
+        return Promise.resolve(1);
+    }
+    return new Promise((resolve) => {
+        const child = spawn(bin, [sub, ...argv], { stdio: 'inherit' });
+        child.on('error', (err) => {
+            log.error(`failed to spawn ${bin}: ${err.message}`);
+            resolve(1);
+        });
+        child.on('exit', (code, signal) => {
+            if (signal)
+                resolve(1);
+            else
+                resolve(code ?? 1);
+        });
+    });
+}
 function cmdVersion() {
     const native = getProtocolVersions();
     console.log(`vmz host ${HOST_PROTOCOL}`);
@@ -182,7 +278,7 @@ function cmdCheck(args) {
  * @param {import('./index.js').Workspace} ws
  * @param {string} project
  * @param {string} outDir
- * @param {() => Promise<number> | number} fn
+ * @param { => Promise<number> | number} fn
  */
 async function runWithPlugins(ws, project, outDir, fn) {
     const { loadVmzConfig, applyPlugins } = await import('./plugin-host.js');
@@ -244,8 +340,16 @@ async function cmdServe(args) {
     });
     const hostJs = path.join(outDir, 'vmz-serve-host.mjs');
     if (!existsSync(hostJs)) {
-        log.error(`missing ${hostJs} — run \`vmz build\` first (or pass --build)`);
-        return 1;
+        const coreDist = resolveCoreRuntimeDist();
+        const src = coreDist ? path.join(coreDist, 'serve-host.mjs') : null;
+        if (src && existsSync(src)) {
+            copyFileSync(src, hostJs);
+            log.info(`materialized ${hostJs} from @vmz/core (release builds omit it)`);
+        }
+        else {
+            log.error(`missing ${hostJs} — run \`vmz build\` (without --release) or ensure @vmz/core is installed`);
+            return 1;
+        }
     }
     const host = typeof args.host === 'string' ? args.host : '127.0.0.1';
     const port = Number(args.port ?? 5173);

package/dist/dev-session.d.ts

@@ -1,8 +1,8 @@
 /**
- * Long-lived Node dev session (N2/N4).
+ * Long-lived Node dev session (/session).
  *
  * Rebuilds go through the N-API `Workspace` — never spawn `cargo` / `vmz-tools`.
- * N4: only dirty leaves are marked; Workspace emits affected deployment units.
+ * session: only dirty leaves are marked; Workspace emits affected deployment units.
  */
 /**
  * @typedef {object} DevSessionOptions

package/dist/dev-session.js

@@ -1,9 +1,9 @@
 // @ts-nocheck
 /**
- * Long-lived Node dev session (N2/N4).
+ * Long-lived Node dev session (/session).
  *
  * Rebuilds go through the N-API `Workspace` — never spawn `cargo` / `vmz-tools`.
- * N4: only dirty leaves are marked; Workspace emits affected deployment units.
+ * session: only dirty leaves are marked; Workspace emits affected deployment units.
  */
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
@@ -65,7 +65,7 @@ export function createDevSession(options) {
             throw new Error(`vmz dev: missing src/ under ${project}`);
         }
         log.info('initial build (N-API workspace, full)…');
-        // Empty dirty → full project build (N4).
+        // Empty dirty → full project build (session).
         const initial = rebuild();
         if (!printReport(initial, 'build')) {
             throw new Error('vmz dev: initial build failed');

package/dist/document-build.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * Document D1 Static + D3 Interactive artifacts.
- * Design: 规划设计/vmz/19 §5–6 · D1/D3
+ * Document Static + Interactive artifacts.
  */
 import fs from 'node:fs';
 import path from 'node:path';

package/dist/document-check.d.ts

@@ -1,5 +1,5 @@
 /**
- * Build DocumentManifest + run D0 / --strict checks.
+ * Build DocumentManifest + run / --strict checks.
  */
 /**
  * Resolve project documents root.

package/dist/document-check.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 /**
- * Build DocumentManifest + run D0 / --strict checks.
+ * Build DocumentManifest + run / --strict checks.
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -44,7 +44,7 @@ export function loadDocumentsConfig(documentsRoot) {
     return { config: null, diagnostics, configPath: null };
 }
 /**
- * D0: only declaration objects — no arbitrary hooks.
+ *: only declaration objects — no arbitrary hooks.
  * @param {string} raw
  * @param {string} filename
  */
@@ -88,7 +88,7 @@ export function checkDocuments(opts) {
         diagnostics.push({
             code: DIAG.CONFIG_MISSING,
             severity: strict ? 'error' : 'warning',
-            message: 'documents.config.json|ts missing; D0 requires defaultLocale + locales for strict coverage checks',
+            message: 'documents.config.json|ts missing; strict mode requires defaultLocale + locales for strict coverage checks',
             path: documentsRoot,
         });
     }
@@ -175,7 +175,7 @@ export function checkDocuments(opts) {
             });
         }
     }
-    // D0: no silent whole-page fallback by default
+    // no silent whole-page fallback by default
     if (config && config.fallback === true) {
         diagnostics.push({
             code: DIAG.FALLBACK_SILENT,

package/dist/document-cmd.d.ts

@@ -1,6 +1,5 @@
 /**
- * `vmz document` / `vmz docs` CLI (D0 check · D1 build).
- * Design: 规划设计/vmz/19 §1 · §8
+ * `vmz document` / `vmz docs` CLI .
  */
 /**
  * @param {string[]} argv

package/dist/document-cmd.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * `vmz document` / `vmz docs` CLI (D0 check · D1 build).
- * Design: 规划设计/vmz/19 §1 · §8
+ * `vmz document` / `vmz docs` CLI .
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -14,7 +13,7 @@ import { createWorkspace } from './index.js';
 import { log } from './log.js';
 import { parseArgs } from './cli.js';
 function printDocumentHelp() {
-    console.log(`vmz document — project /documents domain (D0–D3)
+    console.log(`vmz document — project /documents domain
 
 Usage:
   vmz document check [project]   Check locale tree + links/anchors + fence/API evidence

package/dist/document-designs.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 /**
- * Document D1 — wire project `/designs` into static document assets.
+ * Document — wire project `/designs` into static document assets.
  * Prefer compiled `vmz-designs.css` / `vmz.css`; else emit a minimal token CSS.
  */
 import fs from 'node:fs';

package/dist/document-enrich.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * Document D1 — enrich manifest with routes, anchors, nav; diagnose links.
- * Design: 规划设计/vmz/19 §5–6
+ * Document — enrich manifest with routes, anchors, nav; diagnose links.
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -115,7 +114,7 @@ export function enrichDocumentContent(manifest, ctx) {
             if (!href || href.startsWith('mailto:') || href.startsWith('http://') || href.startsWith('https://')) {
                 continue;
             }
-            // D2 API refs are resolved by evidence, not as page links.
+            // API refs are resolved by evidence, not as page links.
             if (href.startsWith('vmz-api:') || href.startsWith('api:')) {
                 continue;
             }

package/dist/document-evidence.d.ts

@@ -30,10 +30,10 @@ export declare function resolveApiSymbol(index: any, query: any): {
 /**
  * @param {import('./document-schema.js').DocumentManifest} manifest
  * @param {{
- *   analyzeMarkdown: Function,
- *   projectRoot: string,
- *   createWorkspace?: Function,
- *   ensureProgramGraph?: boolean,
+ * analyzeMarkdown: Function,
+ * projectRoot: string,
+ * createWorkspace?: Function,
+ * ensureProgramGraph?: boolean,
  * }} ctx
  */
 export declare function enrichDocumentEvidence(manifest: any, ctx: any): Promise<{

package/dist/document-evidence.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * Document D2 Evidence — fence check + API refs from Program Graph.
- * Design: 规划设计/vmz/19 §4 · §8 D2
+ * Document Evidence — fence check + API refs from Program Graph.
  *
  * Not a Doc IR: filesystem/manifest projection + Workspace/Program Graph queries.
  */
@@ -117,10 +116,10 @@ export function resolveApiSymbol(index, query) {
 /**
  * @param {import('./document-schema.js').DocumentManifest} manifest
  * @param {{
- *   analyzeMarkdown: Function,
- *   projectRoot: string,
- *   createWorkspace?: Function,
- *   ensureProgramGraph?: boolean,
+ * analyzeMarkdown: Function,
+ * projectRoot: string,
+ * createWorkspace?: Function,
+ * ensureProgramGraph?: boolean,
  * }} ctx
  */
 export async function enrichDocumentEvidence(manifest, ctx) {
@@ -424,22 +423,31 @@ function checkScriptFence({ fence, meta, sourcePath, page }) {
             diagnostics.push({
                 code: DIAG.FENCE_CHECK,
                 severity: 'error',
-                message: `${meta.lang} fence parse produced empty SourceFile`,
+                message: `${meta.lang} fence parse produced no SourceFile`,
                 path: `${sourcePath}:${fence.lineStart}`,
             });
-            return { record: { status: 'failed' }, diagnostics };
+            return { record: { status: 'failed', detail: 'parse' }, diagnostics };
         }
-        return { record: { status: 'ok', detail: 'syntax' }, diagnostics };
+        return { record: { status: 'ok' }, diagnostics };
     }
     catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (/Cannot find module ['\"]typescript['\"]/i.test(msg) || e?.code === 'MODULE_NOT_FOUND') {
+            diagnostics.push({
+                code: DIAG.FENCE_CHECK,
+                severity: 'error',
+                message: 'TS/JS fence check needs `typescript` (optional peer of `@vmz/vmz`). Install: pnpm add -D typescript',
+                path: `${sourcePath}:${fence.lineStart}`,
+            });
+            return { record: { status: 'failed', detail: 'missing-typescript' }, diagnostics };
+        }
         diagnostics.push({
             code: DIAG.FENCE_CHECK,
             severity: 'error',
-            message: `${meta.lang} fence check unavailable: ${e.message || e}`,
+            message: `${meta.lang} fence check failed: ${msg}`,
             path: `${sourcePath}:${fence.lineStart}`,
-            pageKey: page?.identity?.pageKey,
         });
-        return { record: { status: 'failed', detail: 'engine' }, diagnostics };
+        return { record: { status: 'failed', detail: 'exception' }, diagnostics };
     }
 }
 function walkFiles(dir, fn) {

package/dist/document-integrate.d.ts

@@ -1,7 +1,6 @@
 /**
  * Integrated DocumentMount — build /documents into the host app dist so
  * routeBase (e.g. /d) is served as static HTML next to SSR pages.
- * Design: 规划设计/vmz/19 · Integrated DocumentMount (same project, no separate package).
  */
 /**
  * @param {string} projectRoot

package/dist/document-integrate.js

@@ -2,7 +2,6 @@
 /**
  * Integrated DocumentMount — build /documents into the host app dist so
  * routeBase (e.g. /d) is served as static HTML next to SSR pages.
- * Design: 规划设计/vmz/19 · Integrated DocumentMount (same project, no separate package).
  */
 import fs from 'node:fs';
 import path from 'node:path';

package/dist/document-interactive.d.ts

@@ -5,10 +5,10 @@
 export declare function htmlToSearchText(html: any): string;
 /**
  * @param {{
- *   manifest: any,
- *   enriched: { byId: Map<string, any> },
- *   evidence: any,
- *   version?: string | null,
+ * manifest: any,
+ * enriched: { byId: Map<string, any> },
+ * evidence: any,
+ * version?: string | null,
  * }} opts
  */
 export declare function buildDocumentSearch(opts: any): {
@@ -20,9 +20,9 @@ export declare function buildDocumentSearch(opts: any): {
 /**
  * Island-only resume plan for document surfaces.
  * @param {{
- *   evidence: any,
- *   searchHref?: string,
- *   fenceBodies?: Map<string, string>,
+ * evidence: any,
+ * searchHref?: string,
+ * fenceBodies?: Map<string, string>,
  * }} opts
  */
 export declare function buildDocumentIslands(opts: any): {
@@ -57,10 +57,10 @@ export declare function collectFenceBodies(analyzedByPageId: any, pages: any): M
 /**
  * Render SSR island shells (no script — resume later).
  * @param {{
- *   islands: any,
- *   searchIndexHref: string,
- *   pageKey: string,
- *   locale: string,
+ * islands: any,
+ * searchIndexHref: string,
+ * pageKey: string,
+ * locale: string,
  * }} opts
  */
 export declare function renderIslandShellsHtml(opts: any): {