@vmz/vmz 0.1.11 → 0.1.13

package/dist/dev-session.js

@@ -14,10 +14,9 @@ import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { buildIntegratedDocuments, projectHasDocuments } from './document-integrate.js';
-import { createWorkspace, resolveNativePath } from './index.js';
+import { createWorkspace } from './index.js';
 import { emitLocaleRuntimeModules, localeHasErrors } from './locale-check.js';
 import { log } from './log.js';
-import { coalesceRootBurst, collectDevWatchRoots, isDependencyPath, mergeDirtySets } from './dev-watch-roots.js';
 import { diffFingerprints, fileFingerprintMap } from './watch-diff.js';
 /**
  * @typedef {object} DevSessionOptions
@@ -26,7 +25,6 @@ import { diffFingerprints, fileFingerprintMap } from './watch-diff.js';
  * @property {string} [host]
  * @property {number} [port]
  * @property {number} [pollMs]
- * @property {'browser' | 'mini-program-wechat'} [target]
  * @property {AbortSignal} [signal]
  * @property {typeof createWorkspace} [createWorkspaceFn]
  * @property {(opts: { project: string, outDir: string, host: string, port: number }) => import('node:child_process').ChildProcess} [spawnHostFn]
@@ -41,7 +39,6 @@ export function createDevSession(options) {
     const host = options.host ?? '127.0.0.1';
     const port = options.port ?? 5173;
     const pollMs = Math.max(50, options.pollMs ?? 300);
-    const wechatPreview = options.target === 'mini-program-wechat';
     const createWs = options.createWorkspaceFn ?? createWorkspace;
     const spawnHost = options.spawnHostFn ?? defaultSpawnHost;
     const softReload = options.softReloadFn ?? defaultSoftReload;
@@ -79,33 +76,6 @@ export function createDevSession(options) {
         log.info(`${label} ok (${mode}; chunks=[${chunks}]; ${(report.emitted ?? []).length} emitted)`);
         return true;
     }
-    /**
-     * Rewrite `dist/wechat` so WeChat DevTools (already open) recompiles WXSS.
-     * Preview is vendor compile, not the browser serve-host.
-     */
-    function packWechatPreview() {
-        if (typeof ws.lowerMiniprogramWechatPackaging !== 'function') {
-            log.error('wechat pack: workspace missing lowerMiniprogramWechatPackaging');
-            return false;
-        }
-        let report;
-        try {
-            const raw = ws.lowerMiniprogramWechatPackaging();
-            report = typeof raw === 'string' ? JSON.parse(raw) : raw;
-        }
-        catch (err) {
-            log.error(`wechat pack failed: ${err}`);
-            return false;
-        }
-        log.diagnostics(report.diagnostics ?? []);
-        if (report.status !== 'ready') {
-            log.error(`wechat pack ${report.status || 'failed'}`);
-            return false;
-        }
-        const packRoot = report.packRoot || 'dist/wechat';
-        log.info(`wechat pack ok → ${path.join(project, packRoot)} (WeChat DevTools compiles WXSS here)`);
-        return true;
-    }
     async function waitHostReady(timeoutMs = 8000) {
         const start = Date.now();
         while (Date.now() - start < timeoutMs) {
@@ -173,37 +143,18 @@ export function createDevSession(options) {
                 throw new Error('vmz dev: integrated document build failed');
             }
         }
-        if (wechatPreview) {
-            if (!packWechatPreview()) {
-                throw new Error('vmz dev: wechat pack failed');
-            }
-        }
-        else {
-            const hostJs = path.join(outDir, 'vmz-serve-host.mjs');
-            if (!existsSync(hostJs)) {
-                throw new Error(`vmz dev: missing ${hostJs}`);
-            }
-            child = spawnHost({ project, outDir, host, port });
-            await waitHostReady().catch((err) => {
-                log.warn(String(err));
-            });
+        const hostJs = path.join(outDir, 'vmz-serve-host.mjs');
+        if (!existsSync(hostJs)) {
+            throw new Error(`vmz dev: missing ${hostJs}`);
         }
+        child = spawnHost({ project, outDir, host, port });
+        await waitHostReady().catch((err) => {
+            log.warn(String(err));
+        });
         const docsRoot = path.join(project, 'documents');
         const localesRoot = path.join(project, 'locales');
-        const watched = collectDevWatchRoots({ project, outDir });
-        /** @type {string[]} */
-        const watchRoots = [...watched.roots];
-        /** @type {string[]} */
-        let dependencyRoots = [...watched.dependencyRoots];
-        if (wechatPreview) {
-            log.info(`dev → WeChat DevTools (watching ${watchRoots.join(', ')}; keep dist/wechat open)`);
-        }
-        else {
-            log.info(`dev → http://${host}:${port} (watching ${watchRoots.join(', ')})`);
-        }
-        if (dependencyRoots.length) {
-            log.info(`dev dependency watch roots (${dependencyRoots.length}): ${dependencyRoots.join(', ')}`);
-        }
+        const watchRoots = [src].concat(existsSync(docsRoot) ? [docsRoot] : []).concat(existsSync(localesRoot) ? [localesRoot] : []);
+        log.info(`dev → http://${host}:${port} (watching ${watchRoots.join(', ')})`);
         /** @type {Map<string, Map<string, string>>} */
         const fingerprints = new Map();
         for (const root of watchRoots) {
@@ -215,48 +166,18 @@ export function createDevSession(options) {
         };
         signal?.addEventListener('abort', onAbort, { once: true });
         /**
-         * Scan all watch roots into a batch. Does not update fingerprints.
+         * Wait until src/ stops changing (multi-file agent edits).
          */
-        function scanBatch() {
-            /** @type {{ srcChanged: string[], srcDeleted: string[], depChanged: string[], depDeleted: string[], docsDirty: boolean, localesDirty: boolean }} */
-            const batch = {
-                srcChanged: [],
-                srcDeleted: [],
-                depChanged: [],
-                depDeleted: [],
-                docsDirty: false,
-                localesDirty: false,
-            };
-            for (const root of watchRoots) {
-                const prev = fingerprints.get(root) || new Map();
-                const next = fileFingerprintMap(root);
+        async function coalesceSrcBurst() {
+            let guard = 0;
+            while (guard++ < 20) {
+                await sleep(220);
+                const prev = fingerprints.get(src) || new Map();
+                const next = fileFingerprintMap(src);
                 const diff = diffFingerprints(prev, next);
                 if (!diff.changed.length && !diff.deleted.length)
-                    continue;
-                if (root === src) {
-                    batch.srcChanged.push(...diff.changed);
-                    batch.srcDeleted.push(...diff.deleted);
-                }
-                else if (root === localesRoot) {
-                    batch.localesDirty = true;
-                }
-                else if (root === docsRoot) {
-                    batch.docsDirty = true;
-                }
-                else if (dependencyRoots.includes(root)) {
-                    batch.depChanged.push(...diff.changed);
-                    batch.depDeleted.push(...diff.deleted);
-                }
-                else {
-                    // designs or other application roots → treat like docs (full reload)
-                    batch.docsDirty = true;
-                }
-            }
-            return batch;
-        }
-        function commitFingerprints() {
-            for (const root of watchRoots) {
-                fingerprints.set(root, fileFingerprintMap(root));
+                    break;
+                fingerprints.set(src, next);
             }
         }
         try {
@@ -264,118 +185,64 @@ export function createDevSession(options) {
                 await sleep(pollMs);
                 if (stopped || signal?.aborted)
                     break;
-                if (!wechatPreview && child && child.exitCode != null) {
+                if (child && child.exitCode != null) {
                     log.warn(`serve-host exited (${child.exitCode}) — respawning…`);
                     child = spawnHost({ project, outDir, host, port });
                     await waitHostReady().catch(() => { });
                     continue;
                 }
-                let batch;
+                /** @type {{ srcChanged: string[], srcDeleted: string[], docsDirty: boolean, localesDirty: boolean }} */
+                let batch = { srcChanged: [], srcDeleted: [], docsDirty: false, localesDirty: false };
                 try {
-                    batch = scanBatch();
+                    for (const root of watchRoots) {
+                        const prev = fingerprints.get(root) || new Map();
+                        const next = fileFingerprintMap(root);
+                        const diff = diffFingerprints(prev, next);
+                        if (root === src) {
+                            batch.srcChanged = diff.changed;
+                            batch.srcDeleted = diff.deleted;
+                        }
+                        else if (root === localesRoot) {
+                            if (diff.changed.length || diff.deleted.length)
+                                batch.localesDirty = true;
+                        }
+                        else if (diff.changed.length || diff.deleted.length) {
+                            batch.docsDirty = true;
+                        }
+                    }
                 }
                 catch (err) {
                     log.warn('watch error:', err);
                     continue;
                 }
-                const srcDirty = batch.srcChanged.length + batch.srcDeleted.length;
-                const depDirty = batch.depChanged.length + batch.depDeleted.length;
-                if (!srcDirty && !depDirty && !batch.docsDirty && !batch.localesDirty)
+                if (!batch.srcChanged.length && !batch.srcDeleted.length && !batch.docsDirty && !batch.localesDirty)
                     continue;
-                // Coalesce multi-file bursts without dropping the initial dirty set.
-                if (srcDirty > 1) {
-                    const coalesced = await coalesceRootBurst(src, fingerprints, {
-                        changed: batch.srcChanged,
-                        deleted: batch.srcDeleted,
-                    });
-                    batch.srcChanged = coalesced.changed;
-                    batch.srcDeleted = coalesced.deleted;
+                if (batch.srcChanged.length + batch.srcDeleted.length > 1) {
+                    await coalesceSrcBurst();
                 }
-                if (depDirty > 1) {
-                    // Coalesce each dirty dependency root independently, then merge.
-                    /** @type {{ changed: string[], deleted: string[] }} */
-                    let acc = { changed: [...batch.depChanged], deleted: [...batch.depDeleted] };
-                    for (const root of dependencyRoots) {
-                        const prev = fingerprints.get(root) || new Map();
-                        const next = fileFingerprintMap(root);
-                        const peek = diffFingerprints(prev, next);
-                        if (peek.changed.length + peek.deleted.length <= 1 && !acc.changed.some((f) => isDependencyPath(f, [root]))) {
-                            continue;
-                        }
-                        const coalesced = await coalesceRootBurst(root, fingerprints, {
-                            changed: acc.changed.filter((f) => isDependencyPath(f, [root])),
-                            deleted: acc.deleted.filter((f) => isDependencyPath(f, [root])),
-                        });
-                        const others = {
-                            changed: acc.changed.filter((f) => !isDependencyPath(f, [root])),
-                            deleted: acc.deleted.filter((f) => !isDependencyPath(f, [root])),
-                        };
-                        acc = mergeDirtySets(others, coalesced);
-                    }
-                    batch.depChanged = acc.changed;
-                    batch.depDeleted = acc.deleted;
-                }
-                else if (srcDirty === 1 || depDirty === 1) {
+                else {
                     await sleep(200);
                 }
-                // Refresh residual dirty after settle (without discarding coalesced sets).
-                const residual = scanBatch();
-                {
-                    const srcMerged = mergeDirtySets({ changed: batch.srcChanged, deleted: batch.srcDeleted }, { changed: residual.srcChanged, deleted: residual.srcDeleted });
-                    batch.srcChanged = srcMerged.changed;
-                    batch.srcDeleted = srcMerged.deleted;
-                    const depMerged = mergeDirtySets({ changed: batch.depChanged, deleted: batch.depDeleted }, { changed: residual.depChanged, deleted: residual.depDeleted });
-                    batch.depChanged = depMerged.changed;
-                    batch.depDeleted = depMerged.deleted;
-                    batch.docsDirty = batch.docsDirty || residual.docsDirty;
-                    batch.localesDirty = batch.localesDirty || residual.localesDirty;
-                }
-                commitFingerprints();
-                if (!batch.srcChanged.length &&
-                    !batch.srcDeleted.length &&
-                    !batch.depChanged.length &&
-                    !batch.depDeleted.length &&
-                    !batch.docsDirty &&
-                    !batch.localesDirty) {
-                    continue;
-                }
-                // Dependency changes: conservative full rebuild + full reload (v0.1.5).
-                if (batch.depChanged.length || batch.depDeleted.length) {
-                    log.info(`dependency change detected (${batch.depChanged.length} update, ${batch.depDeleted.length} delete) — full rebuild…`);
-                    const report = rebuild();
-                    if (!printReport(report, 'rebuild')) {
-                        log.warn('rebuild failed — keeping previous server');
-                        continue;
+                batch = { srcChanged: [], srcDeleted: [], docsDirty: false, localesDirty: false };
+                for (const root of watchRoots) {
+                    const prev = fingerprints.get(root) || new Map();
+                    const next = fileFingerprintMap(root);
+                    const diff = diffFingerprints(prev, next);
+                    fingerprints.set(root, next);
+                    if (root === src) {
+                        batch.srcChanged = diff.changed;
+                        batch.srcDeleted = diff.deleted;
                     }
-                    // Refresh watch roots in case the graph gained new packages.
-                    const refreshed = collectDevWatchRoots({ project, outDir });
-                    for (const r of refreshed.roots) {
-                        if (!watchRoots.includes(r)) {
-                            watchRoots.push(r);
-                            fingerprints.set(r, fileFingerprintMap(r));
-                        }
-                    }
-                    dependencyRoots = [...refreshed.dependencyRoots];
-                    if (batch.docsDirty || projectHasDocuments(project)) {
-                        const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
-                        if (!docs.ok)
-                            log.warn('document mount rebuild failed — keeping previous docs');
+                    else if (root === localesRoot) {
+                        if (diff.changed.length || diff.deleted.length)
+                            batch.localesDirty = true;
                     }
-                    if (wechatPreview) {
-                        if (!packWechatPreview())
-                            log.warn('wechat pack failed — keeping previous dist/wechat');
-                        continue;
+                    else if (diff.changed.length || diff.deleted.length) {
+                        batch.docsDirty = true;
                     }
-                    const kind = await reloadAfterBuild({
-                        affectedChunks: report.affectedChunks ?? [],
-                        seedChunks: report.seedChunks ?? [],
-                        emitted: report.emitted ?? [],
-                        full: true,
-                        islandHmr: false,
-                    });
-                    log.info(kind === 'respawn' ? 'reload ok (respawned; deps)' : 'soft reload ok (full page; deps)');
-                    continue;
                 }
+                if (!batch.srcChanged.length && !batch.srcDeleted.length && !batch.docsDirty && !batch.localesDirty)
+                    continue;
                 let needFullReload = batch.docsDirty;
                 if (batch.srcChanged.length || batch.srcDeleted.length) {
                     log.info(`change detected (${batch.srcChanged.length} update, ${batch.srcDeleted.length} delete) — affected rebuild…`);
@@ -397,12 +264,6 @@ export function createDevSession(options) {
                             needFullReload = true;
                         }
                     }
-                    if (wechatPreview) {
-                        if (!packWechatPreview()) {
-                            log.warn('wechat pack failed — keeping previous dist/wechat');
-                        }
-                        continue;
-                    }
                     const kind = await reloadAfterBuild({
                         affectedChunks: report.affectedChunks ?? [],
                         seedChunks: report.seedChunks ?? [],
@@ -425,19 +286,10 @@ export function createDevSession(options) {
                         log.warn('locale runtime emit failed — keeping previous modules');
                         continue;
                     }
-                    if (wechatPreview) {
-                        if (!packWechatPreview()) {
-                            log.warn('wechat pack failed — keeping previous dist/wechat');
-                        }
-                        if (!batch.docsDirty)
-                            continue;
-                    }
-                    else {
-                        const kind = await reloadAfterBuild({ full: true, islandHmr: false, emitted: [] });
-                        log.info(kind === 'respawn' ? 'reload ok (respawned; locales)' : 'soft reload ok (full page; locales)');
-                        if (!batch.docsDirty)
-                            continue;
-                    }
+                    const kind = await reloadAfterBuild({ full: true, islandHmr: false, emitted: [] });
+                    log.info(kind === 'respawn' ? 'reload ok (respawned; locales)' : 'soft reload ok (full page; locales)');
+                    if (!batch.docsDirty)
+                        continue;
                 }
                 if (batch.docsDirty) {
                     log.info('documents change detected — rebuilding document mount…');
@@ -446,15 +298,8 @@ export function createDevSession(options) {
                         log.warn('document mount rebuild failed — keeping previous docs');
                         continue;
                     }
-                    if (wechatPreview) {
-                        if (!packWechatPreview()) {
-                            log.warn('wechat pack failed — keeping previous dist/wechat');
-                        }
-                    }
-                    else {
-                        const kind = await reloadAfterBuild({ full: true, islandHmr: false, emitted: [] });
-                        log.info(kind === 'respawn' ? 'reload ok (respawned; docs)' : 'soft reload ok (full page; docs)');
-                    }
+                    const kind = await reloadAfterBuild({ full: true, islandHmr: false, emitted: [] });
+                    log.info(kind === 'respawn' ? 'reload ok (respawned; docs)' : 'soft reload ok (full page; docs)');
                 }
             }
         }
@@ -505,7 +350,6 @@ function defaultSpawnHost(opts) {
             VMZ_PORT: String(opts.port),
             VMZ_HOST: opts.host,
             VMZ_DEV: '1',
-            VMZ_NATIVE_NODE: resolveNativePath(),
         },
         stdio: ['ignore', 'inherit', 'inherit'],
     });

package/dist/document-build.js

@@ -8,13 +8,10 @@ import { checkDocuments, manifestHasErrors } from './document-check.js';
 import { resolveDocumentDesignsCss } from './document-designs.js';
 import { enrichDocumentContent, pageHtmlRel } from './document-enrich.js';
 import { enrichDocumentEvidence } from './document-evidence.js';
-import { docsRouteNone, loadLocaleCommonMessages, loadLocalesRouting, localeNonePickerScript, readSiteGithubUrl, renderHostChromeTemplate, } from './document-host-chrome.js';
 import { artifactHrefFromHtml, buildDocumentIslands, buildDocumentSearch, collectFenceBodies, renderIslandShellsHtml, } from './document-interactive.js';
 import { resolveMarkdownEngine } from './document-markdown.js';
 import { DOCUMENT_VIEW_SCHEMA } from './document-schema.js';
 import { createWorkspace } from './index.js';
-import { requireNativeAddon } from './native-addon.js';
-import { writePrettyJsonFile } from './pretty-json.js';
 /**
  * @param {{ projectRoot: string, outDir?: string, strict?: boolean, engines?: { markdown?: string } }} opts
  */
@@ -23,12 +20,10 @@ export async function buildDocuments(opts) {
     const outDir = path.resolve(opts.outDir || path.join(projectRoot, 'dist', 'documents'));
     const strict = Boolean(opts.strict);
     const manifest = checkDocuments({ projectRoot, strict });
-    const routing = loadLocalesRouting(projectRoot) || { strategy: 'prefix' };
     const engine = await resolveMarkdownEngine({ engines: opts.engines, projectRoot });
     const enriched = enrichDocumentContent(manifest, {
         analyzeMarkdown: engine.analyzeMarkdown,
         projectRoot,
-        routing,
     });
     manifest.diagnostics = enriched.diagnostics;
     const evidence = await enrichDocumentEvidence(manifest, {
@@ -63,8 +58,8 @@ export async function buildDocuments(opts) {
     });
     manifest.search = search;
     manifest.islands = islands;
-    const hostChromeRaw = resolveHostSiteChromeRaw(projectRoot);
-    const useHostShell = Boolean(hostChromeRaw) && (manifest.mounts || []).some((m) => m.mode === 'integrated');
+    const hostChrome = resolveHostSiteChrome(projectRoot);
+    const useHostShell = Boolean(hostChrome) && (manifest.mounts || []).some((m) => m.mode === 'integrated');
     fs.mkdirSync(outDir, { recursive: true });
     const designs = resolveDocumentDesignsCss(projectRoot);
     /** @type {string | null} */
@@ -118,7 +113,7 @@ export async function buildDocuments(opts) {
         const viewRel = path.posix.join('views', page.identity.locale, `${page.identity.pageKey === 'index' ? 'index' : page.identity.pageKey}.view.json`);
         const viewAbs = path.join(outDir, viewRel);
         fs.mkdirSync(path.dirname(viewAbs), { recursive: true });
-        writePrettyJsonFile(viewAbs, view);
+        fs.writeFileSync(viewAbs, JSON.stringify(view, null, 2) + '\n', 'utf8');
         const html = renderStaticHtml({
             title: info.title,
             locale: page.identity.locale,
@@ -130,12 +125,7 @@ export async function buildDocuments(opts) {
             htmlRel,
             searchShellHtml: shells.searchHtml,
             playgroundShellHtml: shells.playgroundHtml,
-            hostChrome: useHostShell
-                ? renderHostChromeForLocale(projectRoot, page.identity.locale, routing, enriched.routeBase, hostChromeRaw)
-                : null,
-            routing,
-            routeBase: enriched.routeBase,
-            pageKey: page.identity.pageKey,
+            hostChrome: useHostShell ? hostChrome : null,
         });
         fs.writeFileSync(htmlAbs, html, 'utf8');
         written.push({ route: info.route, htmlPath: htmlRel, viewPath: viewRel });
@@ -157,17 +147,17 @@ export async function buildDocuments(opts) {
             islands: 'document.islands.json',
         },
     };
-    writePrettyJsonFile(path.join(outDir, 'document.manifest.json'), manifestOut);
-    writePrettyJsonFile(path.join(outDir, 'document.evidence.json'), evidence.evidence);
-    writePrettyJsonFile(path.join(outDir, 'document.search.json'), search);
-    writePrettyJsonFile(path.join(outDir, 'document.islands.json'), islands);
+    fs.writeFileSync(path.join(outDir, 'document.manifest.json'), JSON.stringify(manifestOut, null, 2) + '\n', 'utf8');
+    fs.writeFileSync(path.join(outDir, 'document.evidence.json'), JSON.stringify(evidence.evidence, null, 2) + '\n', 'utf8');
+    fs.writeFileSync(path.join(outDir, 'document.search.json'), JSON.stringify(search, null, 2) + '\n', 'utf8');
+    fs.writeFileSync(path.join(outDir, 'document.islands.json'), JSON.stringify(islands, null, 2) + '\n', 'utf8');
     return { ok: true, manifest: manifestOut, outDir, pages: written, search, islands };
 }
 /**
  * No-JS readable static HTML: nav + main landmarks, Island shells without scripts.
  * Integrated mounts reuse host SiteHeader/SiteFooter templates when present.
  */
-function renderStaticHtml({ title, locale, route, nav, bodyHtml, headings, designsHref, htmlRel, searchShellHtml = '', playgroundShellHtml = '', hostChrome = null, routing = { strategy: 'prefix' }, routeBase = '/docs', pageKey = 'index', }) {
+function renderStaticHtml({ title, locale, route, nav, bodyHtml, headings, designsHref, htmlRel, searchShellHtml = '', playgroundShellHtml = '', hostChrome = null, }) {
     const esc = (s) => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
     const depth = htmlRel.split('/').length - 1;
     const prefix = depth > 0 ? '../'.repeat(depth) : './';
@@ -180,9 +170,10 @@ function renderStaticHtml({ title, locale, route, nav, bodyHtml, headings, desig
     }
     if (designsHref)
         cssHrefs.push(hostChrome ? `/${designsHref}` : prefix + designsHref);
+    const cssLink = cssHrefs.map((href) => `  <link rel="stylesheet" href="${esc(href)}" />`).join('\n') + (cssHrefs.length ? '\n' : '');
     const navItems = nav
         .map((n) => {
-        const href = routing.strategy === 'none' || routing.strategy === 'domain' ? n.href : relativeHref(htmlRel, n.href, route);
+        const href = relativeHref(htmlRel, n.href, route);
         const current = n.href === route ? ' aria-current="page"' : '';
         return `      <li><a href="${esc(href)}"${current}>${esc(n.title)}</a></li>`;
     })
@@ -197,11 +188,17 @@ function renderStaticHtml({ title, locale, route, nav, bodyHtml, headings, desig
 ${navItems}
     </ul>
   </nav>`;
-    /** @type {string} */
-    let bodyInner;
     if (hostChrome) {
         const header = hostChrome.header.replace(/(<a\s+href="\/d\/?")([^>]*>文档<\/a>)/, '$1 aria-current="page"$2');
-        bodyInner = `  <div class="site site--docs">
+        return `<!DOCTYPE html>
+<html lang="${esc(locale)}">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${esc(title)}</title>
+${cssLink}</head>
+<body data-vmz-hydrate="island-only">
+  <div class="site site--docs">
   <a class="skip-link" href="#main">Skip to content</a>
 ${header}
   <div class="doc-body">
@@ -218,37 +215,35 @@ ${playgroundShellHtml}
   </div>
 ${hostChrome.footer}
   </div>
-${routing.strategy === 'none' && hostChrome ? localeNonePickerScript() : ''}
+</body>
+</html>
 `;
     }
-    else {
-        bodyInner = `  <a class="skip-link" href="#main">Skip to content</a>
+    return `<!DOCTYPE html>
+<html lang="${esc(locale)}">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${esc(title)}</title>
+${cssLink}</head>
+<body data-vmz-hydrate="island-only">
+  <a class="skip-link" href="#main">Skip to content</a>
 ${docsNav}
 ${searchShellHtml}
   ${toc}<main id="main">
 ${bodyHtml}
 ${playgroundShellHtml}
   </main>
+</body>
+</html>
 `;
-    }
-    const native = requireNativeAddon();
-    if (typeof native.generateHtmlShell !== 'function') {
-        throw new Error('vmz native addon missing generateHtmlShell — rebuild with `pnpm napi:build`');
-    }
-    return native.generateHtmlShell({
-        title,
-        lang: locale,
-        cssHrefs,
-        bodyHtml: bodyInner,
-        bodyAttrs: ['data-vmz-hydrate', 'island-only'],
-    });
 }
 /**
  * Integrated DocumentMount: reuse host SiteHeader / SiteFooter .vmz templates.
  * @param {string} projectRoot
  * @returns {{ header: string, footer: string } | null}
  */
-function resolveHostSiteChromeRaw(projectRoot) {
+function resolveHostSiteChrome(projectRoot) {
     const headerPath = path.join(projectRoot, 'src', 'components', 'SiteHeader.vmz');
     const footerPath = path.join(projectRoot, 'src', 'components', 'SiteFooter.vmz');
     if (!fs.existsSync(headerPath) || !fs.existsSync(footerPath))
@@ -259,28 +254,6 @@ function resolveHostSiteChromeRaw(projectRoot) {
         return null;
     return { header, footer };
 }
-/**
- * @param {string} projectRoot
- * @param {string} localeId
- * @param {{ strategy?: string }} routing
- * @param {string} routeBase
- * @param {{ header: string, footer: string }} raw
- */
-function renderHostChromeForLocale(projectRoot, localeId, routing, routeBase, raw) {
-    const messages = loadLocaleCommonMessages(projectRoot, localeId);
-    const githubUrl = readSiteGithubUrl(projectRoot);
-    const docsRootHref = routing.strategy === 'none' || routing.strategy === 'domain'
-        ? `${routeBase.replace(/\/$/, '')}/`
-        : `${routeBase.replace(/\/$/, '')}/${localeId}/`;
-    const guideHref = routing.strategy === 'none' || routing.strategy === 'domain'
-        ? docsRouteNone(routeBase, 'guide/getting-started')
-        : `${docsRootHref}guide/getting-started`;
-    const opts = { docsRootHref, guideHref, githubUrl, routing };
-    return {
-        header: renderHostChromeTemplate(raw.header, localeId, messages, opts),
-        footer: renderHostChromeTemplate(raw.footer, localeId, messages, opts),
-    };
-}
 /** @param {string} filePath */
 function extractVmzTemplateHtml(filePath) {
     const src = fs.readFileSync(filePath, 'utf8');

package/dist/document-cmd.js

@@ -2,6 +2,7 @@
 /**
  * `vmz document` / `vmz docs` CLI .
  */
+import fs from 'node:fs';
 import path from 'node:path';
 import { buildDocuments } from './document-build.js';
 import { checkDocuments, manifestHasErrors } from './document-check.js';
@@ -11,7 +12,6 @@ import { resolveMarkdownEngine } from './document-markdown.js';
 import { createWorkspace } from './index.js';
 import { log } from './log.js';
 import { parseArgs } from './cli.js';
-import { emitPrettyJson } from './pretty-json.js';
 function printDocumentHelp() {
     console.log(`vmz document — project /documents domain
 
@@ -95,7 +95,14 @@ async function cmdDocumentCheck(args) {
     }
     const jsonOut = args.json;
     if (jsonOut) {
-        emitPrettyJson(jsonOut, manifest, { logWrote: (p) => log.info(`wrote ${p}`) });
+        const text = JSON.stringify(manifest, null, 2);
+        if (typeof jsonOut === 'string') {
+            fs.writeFileSync(jsonOut, text + '\n', 'utf8');
+            log.info(`wrote ${jsonOut}`);
+        }
+        else {
+            console.log(text);
+        }
     }
     else {
         for (const d of manifest.diagnostics) {

package/dist/document-enrich.d.ts

@@ -2,9 +2,8 @@
  * @param {string} routeBase e.g. /docs
  * @param {string} locale
  * @param {string} pageKey
- * @param {{ strategy?: string }} [routing]
  */
-export declare function pageRoute(routeBase: any, locale: any, pageKey: any, routing?: {}): string;
+export declare function pageRoute(routeBase: any, locale: any, pageKey: any): string;
 /**
  * Static file path relative to out dir (posix).
  * @param {string} routeBase