@vmz/vmz 0.1.19 → 0.1.21

package/dist/dev-session.js

@@ -10,7 +10,7 @@
  * 3. Soft reload failure → **auto-respawn** serve-host (fresh ESM graph), not "keep broken host".
  */
 import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { buildIntegratedDocuments, projectHasDocuments } from './document-integrate.js';
 import { createWorkspace, resolveNativePath } from './index.js';
@@ -18,6 +18,8 @@ import { emitLocaleRuntimeModules, localeHasErrors } from './locale-check.js';
 import { log } from './log.js';
 import { coalesceRootBurst, collectDevWatchRoots, classifyWatchRoot, isDependencyPath, mergeDirtySets } from './dev-watch-roots.js';
 import { diffFingerprints, fileFingerprintMap } from './watch-diff.js';
+/** Track serve-host so a failed/killed launcher cannot leave an orphan port. */
+const DEV_HOST_PID = '.vmz-dev-host.pid';
 export function createDevSession(options) {
     const project = options.project;
     const outDir = options.outDir;
@@ -141,11 +143,29 @@ export function createDevSession(options) {
         if (!existsSync(src)) {
             throw new Error(`vmz dev: missing src/ under ${project}`);
         }
+        // Same as `vmz build`: materialize plugin sources (e.g. `<Shiki>`) before compile.
+        // Soft rebuilds reuse the workspace; config/plugin changes still need a process restart
+        // until `vmz.config.*` is watched.
+        {
+            const { loadVmzConfig, applyPlugins } = await import('./plugin-host.js');
+            const { plugins, engines } = await loadVmzConfig(project);
+            if (plugins.length) {
+                await applyPlugins(ws, plugins, { project, outDir, engines });
+            }
+        }
         log.info('initial build (N-API workspace, full)…');
         const initial = rebuild();
         if (!printReport(initial, 'build')) {
             throw new Error('vmz dev: initial build failed');
         }
+        // `vmz build` assemble copies `public/**` → outDir; soft `ws.build()` does not.
+        // Without this, marketing images and other opaque assets 404 under `vmz dev`.
+        {
+            const { emitPublicStaticAssets } = await import('./public-static-assets.js');
+            emitPublicStaticAssets(outDir, { projectRoot: project });
+        }
+        // Reclaim orphan serve-host from a previous crashed launcher (same outDir).
+        reclaimStaleDevHost(outDir);
         if (projectHasDocuments(project)) {
             const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
             if (!docs.ok) {
@@ -495,6 +515,7 @@ export function createDevSession(options) {
         stopped = true;
         killChild(child);
         child = null;
+        clearDevHostPid(outDir, null);
         try {
             ws.dispose();
         }
@@ -523,7 +544,7 @@ export function listWatchedFiles(srcDir) {
 function defaultSpawnHost(opts) {
     const hostJs = path.join(opts.outDir, 'vmz-serve-host.mjs');
     const node = process.env.VMZ_NODE || process.execPath;
-    return spawn(node, [hostJs], {
+    const child = spawn(node, [hostJs], {
         cwd: opts.project,
         env: {
             ...process.env,
@@ -535,7 +556,13 @@ function defaultSpawnHost(opts) {
             VMZ_NATIVE_NODE: resolveNativePath(),
         },
         stdio: ['ignore', 'inherit', 'inherit'],
+        // Keep child in the same process group so launcher exit can reclaim it.
+        detached: false,
+        windowsHide: true,
     });
+    writeDevHostPid(opts.outDir, child.pid);
+    child.once('exit', () => clearDevHostPid(opts.outDir, child.pid));
+    return child;
 }
 /**
  * @param {string} host
@@ -559,12 +586,103 @@ async function defaultSoftReload(host, port, payload = {}) {
 function killChild(child) {
     if (!child || child.killed)
         return;
+    const pid = child.pid;
+    try {
+        if (process.platform === 'win32' && pid) {
+            // Tree-kill so orphaned grandchildren (if any) do not keep the port.
+            spawn('taskkill', ['/pid', String(pid), '/T', '/F'], {
+                stdio: 'ignore',
+                windowsHide: true,
+            });
+        }
+        else {
+            child.kill('SIGTERM');
+        }
+    }
+    catch {
+        try {
+            child.kill();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+function devHostPidPath(outDir) {
+    return path.join(outDir, DEV_HOST_PID);
+}
+function writeDevHostPid(outDir, pid) {
+    if (!outDir || !pid)
+        return;
+    try {
+        writeFileSync(devHostPidPath(outDir), `${pid}\n`, 'utf8');
+    }
+    catch {
+        /* ignore */
+    }
+}
+function clearDevHostPid(outDir, pid) {
+    if (!outDir)
+        return;
+    try {
+        const p = devHostPidPath(outDir);
+        if (!existsSync(p))
+            return;
+        if (pid != null) {
+            const cur = Number(readFileSync(p, 'utf8').trim());
+            if (Number.isFinite(cur) && cur !== pid)
+                return;
+        }
+        unlinkSync(p);
+    }
+    catch {
+        /* ignore */
+    }
+}
+/** Kill leftover serve-host recorded for this outDir (previous crashed `vmz dev`). */
+function reclaimStaleDevHost(outDir) {
+    const p = devHostPidPath(outDir);
+    if (!existsSync(p))
+        return;
+    let pid = 0;
     try {
-        child.kill();
+        pid = Number(readFileSync(p, 'utf8').trim());
+    }
+    catch {
+        clearDevHostPid(outDir, null);
+        return;
+    }
+    if (!Number.isFinite(pid) || pid <= 0) {
+        clearDevHostPid(outDir, null);
+        return;
+    }
+    if (pid === process.pid) {
+        clearDevHostPid(outDir, null);
+        return;
+    }
+    try {
+        process.kill(pid, 0);
+    }
+    catch {
+        clearDevHostPid(outDir, null);
+        return;
+    }
+    log.warn(`reclaiming stale serve-host pid=${pid} (prior vmz dev left an orphan)`);
+    try {
+        if (process.platform === 'win32') {
+            spawn('taskkill', ['/pid', String(pid), '/T', '/F'], {
+                stdio: 'ignore',
+                windowsHide: true,
+            });
+        }
+        else {
+            process.kill(pid, 'SIGTERM');
+        }
     }
     catch {
         /* ignore */
     }
+    clearDevHostPid(outDir, null);
 }
 function sleep(ms) {
     return new Promise((r) => setTimeout(r, ms));

package/dist/document-integrate.js

@@ -8,6 +8,7 @@ import { buildDocuments } from './document-build.js';
 import { resolveDocumentsRoot } from './document-check.js';
 import { pageHtmlRel } from './document-enrich.js';
 import { loadLocalesRouting } from './document-routing-config.js';
+import { ensureLocaleImportsRewritten } from './locale-check.js';
 import { log } from './log.js';
 import { requireNativeAddon } from './native-addon.js';
 export function projectHasDocuments(projectRoot) {
@@ -22,6 +23,13 @@ export async function buildIntegratedDocuments(opts) {
         return { ok: true, skipped: true };
     }
     try {
+        // Node dynamic import of compiled chrome forbids bare `#locales/*`
+        // (no package.json imports). Rewrite must be complete before mount.
+        const locales = ensureLocaleImportsRewritten(outDir);
+        if (!locales.ok) {
+            log.error(locales.error || 'locale import rewrite incomplete');
+            return { ok: false, error: locales.error || 'locale rewrite', pages: 0 };
+        }
         const result = await buildDocuments({
             projectRoot,
             outDir,

package/dist/index.d.ts

@@ -105,6 +105,7 @@ export { DELIVERY_PROFILE_AUTHORING_SCHEMA, BUILD_PROFILE_SELECTION_SCHEMA, ASSE
 export { PACK_MANIFEST_SCHEMA, packFromDeploymentIr, ensureRuntimeCompanions } from './pack.js';
 export { SERVER_ARTIFACT_SCHEMA, HTTP_CONTRACT_SCHEMA, SERVER_RUNTIME_ADAPTER_SCHEMA, emitServerArtifact, projectServerRuntimeAdapter, } from './server-artifact.js';
 export { BUILD_PROOF_SCHEMA, ASSEMBLE_MANIFEST_SCHEMA, assembleDelivery, emitBuildProof, } from './build-assemble.js';
+export { buildProjectToOutDirRoot, type BuildProjectOptions, type BuildProjectResult, } from './project-build.js';
 export { PRODUCTION_SCENARIO_PACK_SCHEMA, PRODUCTION_CI_PROFILE_SCHEMA, PRODUCTION_TEST_REPORT_SCHEMA, browserProductionScenarioPack, browserProductionCiProfile, normalizeScenarioPack, normalizeCiProfile, scenarioPackDigest, ciProfileDigest, buildProductionTestReport, productionTestReportDigest, emitProductionTestArtifacts, assertNoForbiddenRunners, } from './production-test-pack.js';
 export { PRODUCTION_OBSERVABILITY_SCHEMA, PRODUCTION_TRACE_SCHEMA, REQUIRED_TRACE_FACETS, browserProductionObservability, normalizeObservability, redactSensitive, validateProductionTrace, buildCoveringProductionTrace, checkProductionBudgets, checkCapabilityClosure, applySecurityHeadersToCdnPolicy, measureDistBudgets, emitProductionObservability, observabilityDigest, } from './production-observability.js';
 export { buildApplicationContext, buildFormatterContext, checkLocaleRuntime, checkSsrClientParity, createLocaleSession, formatMessageTemplate, formatterContextDigest, negotiateLocale, resolveMessageVariant, validateFormatterContext, } from './locale-runtime.js';

package/dist/index.js

@@ -345,6 +345,7 @@ export { DELIVERY_PROFILE_AUTHORING_SCHEMA, BUILD_PROFILE_SELECTION_SCHEMA, ASSE
 export { PACK_MANIFEST_SCHEMA, packFromDeploymentIr, ensureRuntimeCompanions } from './pack.js';
 export { SERVER_ARTIFACT_SCHEMA, HTTP_CONTRACT_SCHEMA, SERVER_RUNTIME_ADAPTER_SCHEMA, emitServerArtifact, projectServerRuntimeAdapter, } from './server-artifact.js';
 export { BUILD_PROOF_SCHEMA, ASSEMBLE_MANIFEST_SCHEMA, assembleDelivery, emitBuildProof, } from './build-assemble.js';
+export { buildProjectToOutDirRoot, } from './project-build.js';
 export { PRODUCTION_SCENARIO_PACK_SCHEMA, PRODUCTION_CI_PROFILE_SCHEMA, PRODUCTION_TEST_REPORT_SCHEMA, browserProductionScenarioPack, browserProductionCiProfile, normalizeScenarioPack, normalizeCiProfile, scenarioPackDigest, ciProfileDigest, buildProductionTestReport, productionTestReportDigest, emitProductionTestArtifacts, assertNoForbiddenRunners, } from './production-test-pack.js';
 export { PRODUCTION_OBSERVABILITY_SCHEMA, PRODUCTION_TRACE_SCHEMA, REQUIRED_TRACE_FACETS, browserProductionObservability, normalizeObservability, redactSensitive, validateProductionTrace, buildCoveringProductionTrace, checkProductionBudgets, checkCapabilityClosure, applySecurityHeadersToCdnPolicy, measureDistBudgets, emitProductionObservability, observabilityDigest, } from './production-observability.js';
 export { buildApplicationContext, buildFormatterContext, checkLocaleRuntime, checkSsrClientParity, createLocaleSession, formatMessageTemplate, formatterContextDigest, negotiateLocale, resolveMessageVariant, validateFormatterContext, } from './locale-runtime.js';

package/dist/locale-check.d.ts

@@ -80,12 +80,25 @@ export declare function emitLocaleTypedModules(report: ReturnType<typeof checkLo
  *
  * Variant pick reads `html[data-locale]` (else defaultLocale). Thin bridge until
  * host LocaleTransition reloads locale-scoped chunks (I2/I4).
+ *
+ * Contract: after this returns `ok`, `distDir` must not contain bare `#locales/`
+ * import specifiers (document SSR / Node import would otherwise require a fake
+ * `package.json#imports` map).
  */
 export declare function emitLocaleRuntimeModules(projectRoot: string, distDir: string): {
     ok: boolean;
     written: string[];
     diagnostics: LocaleDiagnostic[];
 };
+/**
+ * Rewrite `#locales/*` → relative `locales/*.js` and assert none remain.
+ * Call before document SSR (`createRenderHost`) or any Node import of app dist.
+ */
+export declare function ensureLocaleImportsRewritten(distDir: string): {
+    ok: boolean;
+    rewritten: number;
+    error?: string;
+};
 /** MessageId rename plan — WorkspaceEdit-shaped, no parallel rename IR. */
 export declare function planLocaleRename(report: ReturnType<typeof checkLocales>, fromId: string, toId: string): {
     schema: string;

package/dist/locale-check.js

@@ -589,6 +589,10 @@ export function emitLocaleTypedModules(report, outDir) {
  *
  * Variant pick reads `html[data-locale]` (else defaultLocale). Thin bridge until
  * host LocaleTransition reloads locale-scoped chunks (I2/I4).
+ *
+ * Contract: after this returns `ok`, `distDir` must not contain bare `#locales/`
+ * import specifiers (document SSR / Node import would otherwise require a fake
+ * `package.json#imports` map).
  */
 export function emitLocaleRuntimeModules(projectRoot, distDir) {
     const report = checkLocales({ projectRoot, checkUnused: false });
@@ -597,6 +601,21 @@ export function emitLocaleRuntimeModules(projectRoot, distDir) {
     }
     // Missing locales.json5 is warning-only for now — surface diagnostics, skip emit.
     if (!report.manifest) {
+        const leftover = findBareLocaleImports(distDir);
+        if (leftover.length) {
+            return {
+                ok: false,
+                written: [],
+                diagnostics: [
+                    ...(report.diagnostics || []),
+                    {
+                        severity: 'error',
+                        code: 'locale::dist_bare_import',
+                        message: `dist still has #locales/* imports but locales manifest is missing: ${leftover.slice(0, 4).join(', ')}`,
+                    },
+                ],
+            };
+        }
         return { ok: true, written: [], diagnostics: report.diagnostics || [] };
     }
     const defaultLocale = report.manifest.defaultLocale || 'zh-hans';
@@ -630,12 +649,55 @@ export function emitLocaleRuntimeModules(projectRoot, distDir) {
         fs.writeFileSync(file, code, 'utf8');
         written.push(file);
     }
-    rewriteLocaleImportsInDist(distDir);
+    const ensured = ensureLocaleImportsRewritten(distDir);
+    if (!ensured.ok) {
+        return {
+            ok: false,
+            written,
+            diagnostics: [
+                ...(report.diagnostics || []),
+                {
+                    severity: 'error',
+                    code: 'locale::dist_bare_import',
+                    message: ensured.error || 'bare #locales/* imports remain in dist',
+                },
+            ],
+        };
+    }
     return { ok: true, written, diagnostics: report.diagnostics || [] };
 }
+/**
+ * Rewrite `#locales/*` → relative `locales/*.js` and assert none remain.
+ * Call before document SSR (`createRenderHost`) or any Node import of app dist.
+ */
+export function ensureLocaleImportsRewritten(distDir) {
+    const rewritten = rewriteLocaleImportsInDist(distDir);
+    const leftover = findBareLocaleImports(distDir);
+    if (leftover.length) {
+        return {
+            ok: false,
+            rewritten,
+            error: `bare #locales/* remain after rewrite: ${leftover.slice(0, 6).join(', ')}`,
+        };
+    }
+    return { ok: true, rewritten };
+}
+/** True import / dynamic-import of `#locales/…` (not comments mentioning the prefix). */
+const BARE_LOCALE_IMPORT_RE = /(?:from\s*|import\s*\()\s*['"`]#locales\//;
+function findBareLocaleImports(distDir) {
+    const hits = [];
+    walkDistJs(distDir, (file) => {
+        const text = fs.readFileSync(file, 'utf8');
+        if (!BARE_LOCALE_IMPORT_RE.test(text))
+            return;
+        hits.push(path.relative(distDir, file).replace(/\\/g, '/'));
+    });
+    return hits;
+}
 function rewriteLocaleImportsInDist(distDir) {
     const files = [];
     walkDistJs(distDir, (file) => files.push(file));
+    let rewritten = 0;
     for (const file of files) {
         const text = fs.readFileSync(file, 'utf8');
         if (!text.includes('#locales/'))
@@ -649,9 +711,12 @@ function rewriteLocaleImportsInDist(distDir) {
                 rel = `./${rel}`;
             return `from ${quote}${rel}${quote}`;
         });
-        if (next !== text)
+        if (next !== text) {
             fs.writeFileSync(file, next, 'utf8');
+            rewritten += 1;
+        }
     }
+    return rewritten;
 }
 function walkDistJs(dir, fn) {
     if (!fs.existsSync(dir))
@@ -659,7 +724,8 @@ function walkDistJs(dir, fn) {
     for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
         const full = path.join(dir, ent.name);
         if (ent.isDirectory()) {
-            if (ent.name === 'node_modules')
+            // Skip package trees and pack vendor — only app emit must clear `#locales/*`.
+            if (ent.name === 'node_modules' || ent.name === 'vendor')
                 continue;
             walkDistJs(full, fn);
         }

package/dist/log.js

@@ -22,14 +22,16 @@ export const log = {
     },
     diagnostic(d) {
         const severity = d.severity === 'warning' || d.severity === 'advice' || d.severity === 'error' ? d.severity : 'error';
-        const code = d.code && String(d.code).length ? String(d.code) : 'diag.message';
+        // Only invent transitional `diag.message` when wire has no code; never remap a real code.
+        const hasCode = Boolean(d.code && String(d.code).length);
+        const code = hasCode ? String(d.code) : 'diag.message';
         const locale = resolveVmzLocale();
         const catalog = loadCliCatalog(locale);
         const line = formatDiagnostic({
             path: d.path || '',
             severity,
             code,
-            args: d.args || (d.message ? { message: String(d.message) } : undefined),
+            args: d.args ?? (!hasCode && d.message ? { message: String(d.message) } : undefined),
             message: d.message,
             span: d.span,
         }, {

package/dist/pack.js

@@ -20,7 +20,7 @@ export const PACK_MANIFEST_SCHEMA = 'vmz.pack.manifest.v0';
 export function ensureRuntimeCompanions(outDir, coreDist) {
     if (!coreDist)
         return [];
-    const names = ['dom-core.js', 'dom-ssr.js', 'dom.client.js'];
+    const names = ['dom-core.js', 'dom-ssr.js', 'dom.client.js', 'direct-host-box.js', 'unknown-component.js'];
     const copied = [];
     for (const name of names) {
         const src = path.join(coreDist, name);

package/dist/plugin-host.js

@@ -274,13 +274,13 @@ function sourceItem(id, path, content) {
  * @param {string[]} engines
  */
 function buildMathFacade(defaultEngine, engines) {
-    const defaultLit = JSON.stringify(defaultEngine);
+    const defaultLit = jsSingleQuoted(defaultEngine);
     const branches = engines
         .map((eng, i) => {
         const tag = engineToTag(eng);
-        const kw = i === 0 ? 'if' : 'else-if';
-        const engLit = JSON.stringify(eng);
-        return `  <${tag} ${kw}={(engine || ${defaultLit}) === ${engLit}} tex={tex} display={display} />`;
+        const kw = i === 0 ? 'v-if' : 'v-else-if';
+        const engLit = jsSingleQuoted(eng);
+        return `  <${tag} ${kw}="(engine || ${defaultLit}) === ${engLit}" :tex="tex" :display="display" />`;
     })
         .join('\n');
     return `<template>
@@ -301,13 +301,13 @@ export default class Math {
  * @param {string[]} engines
  */
 function buildCodeFacade(defaultEngine, engines) {
-    const defaultLit = JSON.stringify(defaultEngine);
+    const defaultLit = jsSingleQuoted(defaultEngine);
     const branches = engines
         .map((eng, i) => {
         const tag = engineToTag(eng);
-        const kw = i === 0 ? 'if' : 'else-if';
-        const engLit = JSON.stringify(eng);
-        return `  <${tag} ${kw}={(engine || ${defaultLit}) === ${engLit}} code={code} lang={lang} theme={theme} />`;
+        const kw = i === 0 ? 'v-if' : 'v-else-if';
+        const engLit = jsSingleQuoted(eng);
+        return `  <${tag} ${kw}="(engine || ${defaultLit}) === ${engLit}" :code="code" :lang="lang" :theme="theme" />`;
     })
         .join('\n');
     return `<template>
@@ -329,13 +329,13 @@ export default class Code {
  * @param {string[]} engines
  */
 function buildMarkdownFacade(defaultEngine, engines) {
-    const defaultLit = JSON.stringify(defaultEngine);
+    const defaultLit = jsSingleQuoted(defaultEngine);
     const branches = engines
         .map((eng, i) => {
         const tag = engineToTag(eng);
-        const kw = i === 0 ? 'if' : 'else-if';
-        const engLit = JSON.stringify(eng);
-        return `  <${tag} ${kw}={(engine || ${defaultLit}) === ${engLit}} source={source} />`;
+        const kw = i === 0 ? 'v-if' : 'v-else-if';
+        const engLit = jsSingleQuoted(eng);
+        return `  <${tag} ${kw}="(engine || ${defaultLit}) === ${engLit}" :source="source" />`;
     })
         .join('\n');
     return `<template>
@@ -350,6 +350,10 @@ export default class Markdown {
 </script>
 `;
 }
+/** Embed a JS string literal inside a double-quoted Vue attribute. */
+function jsSingleQuoted(value) {
+    return `'${String(value).replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+}
 /** @param {string} engine */
 function engineToTag(engine) {
     const map = {

package/dist/project-build.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared project delivery build (N-API + pack + assemble).
+ * Used by `vmz build` and `vmz test` so Browser Host sees the same
+ * `<out-dir>/<profiles.*.name>/` tree (including static HTML).
+ */
+export type BuildProjectOptions = {
+    /** `--profile` id; empty → delivery default. */
+    profile?: string;
+    release?: boolean;
+    origin?: string;
+    /** Skip locale / documents / proof when only need pack+static for tests. */
+    quiet?: boolean;
+};
+export type BuildProjectOk = {
+    ok: true;
+    outDirRoot: string;
+    artifactDir: string;
+    deliveryName: string;
+    profileId: string;
+    assembly: string;
+    diagnostics: unknown[];
+};
+export type BuildProjectErr = {
+    ok: false;
+    outDirRoot: string;
+    artifactDir: string | null;
+    deliveryName: string | null;
+    diagnostics: unknown[];
+    error: string;
+};
+export type BuildProjectResult = BuildProjectOk | BuildProjectErr;
+/**
+ * Build into `--out-dir` **root** the same way as `vmz build . --out-dir <root>`:
+ * nest once via `resolveProfileArtifactDir`, then N-API build + pack + assemble
+ * (static HTML for `web-static`). Callers resolve the serve root **after** this.
+ */
+export declare function buildProjectToOutDirRoot(project: string, outDirRoot: string, opts?: BuildProjectOptions): Promise<BuildProjectResult>;

package/dist/project-build.js

@@ -0,0 +1,210 @@
+/**
+ * Shared project delivery build (N-API + pack + assemble).
+ * Used by `vmz build` and `vmz test` so Browser Host sees the same
+ * `<out-dir>/<profiles.*.name>/` tree (including static HTML).
+ */
+import path from 'node:path';
+import { assembleDelivery, emitBuildProof } from './build-assemble.js';
+import { normalizeDeliveryAuthoring, resolveProfileArtifactDir, selectBuildProfile } from './delivery-profile.js';
+import { buildIntegratedDocuments, projectHasDocuments } from './document-integrate.js';
+import { emitLocaleRuntimeModules, localeHasErrors } from './locale-check.js';
+import { emitLocaleRouteRealization } from './locale-route-emit.js';
+import { packFromDeploymentIr } from './pack.js';
+import { loadVmzConfig } from './plugin-host.js';
+function dedupeDiagnostics(list) {
+    const seen = new Set();
+    const out = [];
+    for (const d of list || []) {
+        const key = `${d.code || ''}\0${d.path || ''}\0${d.message || ''}\0${d.severity || ''}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(d);
+    }
+    return out;
+}
+async function runWithPlugins(ws, project, outDir, fn) {
+    const { applyPlugins } = await import('./plugin-host.js');
+    const { plugins, engines } = await loadVmzConfig(project);
+    if (plugins.length) {
+        await applyPlugins(ws, plugins, { project, outDir, engines });
+    }
+    return await fn();
+}
+/**
+ * Build into `--out-dir` **root** the same way as `vmz build . --out-dir <root>`:
+ * nest once via `resolveProfileArtifactDir`, then N-API build + pack + assemble
+ * (static HTML for `web-static`). Callers resolve the serve root **after** this.
+ */
+export async function buildProjectToOutDirRoot(project, outDirRoot, opts = {}) {
+    const root = path.resolve(outDirRoot);
+    const diagnostics = [];
+    let cfg;
+    try {
+        cfg = await loadVmzConfig(project);
+    }
+    catch (e) {
+        return {
+            ok: false,
+            outDirRoot: root,
+            artifactDir: null,
+            deliveryName: null,
+            diagnostics,
+            error: `loadVmzConfig failed: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+    const norm = normalizeDeliveryAuthoring(cfg.delivery ?? null);
+    if (!norm.ok) {
+        return {
+            ok: false,
+            outDirRoot: root,
+            artifactDir: null,
+            deliveryName: null,
+            diagnostics: norm.diagnostics ?? [],
+            error: 'delivery authoring invalid',
+        };
+    }
+    const selected = selectBuildProfile(norm.table, opts.profile || '');
+    if (!selected.ok) {
+        return {
+            ok: false,
+            outDirRoot: root,
+            artifactDir: null,
+            deliveryName: null,
+            diagnostics: selected.diagnostics ?? [],
+            error: `unknown build --profile ${opts.profile || norm.table.default}`,
+        };
+    }
+    const deliveryName = String(selected.profile.name || selected.selection.profileId || '');
+    const artifactDir = resolveProfileArtifactDir(root, selected.profile);
+    const assembly = String(selected.selection.assembly || '');
+    const profileId = String(selected.selection.profileId || '');
+    // Dynamic import avoids init cycle with `./index.js` re-exports.
+    const { createWorkspace, resolveCoreRuntimeDist } = await import('./index.js');
+    const ws = createWorkspace({ root: project, outDir: artifactDir });
+    try {
+        const code = await runWithPlugins(ws, project, artifactDir, () => {
+            const report = ws.build(Boolean(opts.release));
+            const diags = report.diagnostics ?? [];
+            diagnostics.push(...diags);
+            const errors = diags.filter((d) => d && (d.severity === 'error' || d.level === 'error'));
+            return errors.length ? 1 : 0;
+        });
+        if (code !== 0) {
+            return {
+                ok: false,
+                outDirRoot: root,
+                artifactDir,
+                deliveryName,
+                diagnostics,
+                error: 'workspace build reported errors',
+            };
+        }
+        const localeEmit = emitLocaleRuntimeModules(project, artifactDir);
+        const localeRoutes = emitLocaleRouteRealization(project, artifactDir, {
+            origin: opts.origin,
+        });
+        const localeDiags = dedupeDiagnostics([
+            ...(localeEmit.diagnostics ?? []),
+            ...(localeRoutes.diagnostics ?? []),
+        ]);
+        diagnostics.push(...localeDiags);
+        if (!localeEmit.ok || localeHasErrors({ diagnostics: localeEmit.diagnostics })) {
+            return {
+                ok: false,
+                outDirRoot: root,
+                artifactDir,
+                deliveryName,
+                diagnostics,
+                error: 'locale runtime emit failed',
+            };
+        }
+        if (!localeRoutes.ok) {
+            return {
+                ok: false,
+                outDirRoot: root,
+                artifactDir,
+                deliveryName,
+                diagnostics,
+                error: 'locale route realization emit failed',
+            };
+        }
+        if (projectHasDocuments(project)) {
+            const docs = await buildIntegratedDocuments({ projectRoot: project, outDir: artifactDir });
+            if (!docs.ok) {
+                return {
+                    ok: false,
+                    outDirRoot: root,
+                    artifactDir,
+                    deliveryName,
+                    diagnostics,
+                    error: 'integrated documents build failed',
+                };
+            }
+        }
+        let pack;
+        try {
+            pack = packFromDeploymentIr(artifactDir, {
+                release: Boolean(opts.release),
+                profileId,
+                assembly,
+                coreDist: resolveCoreRuntimeDist(),
+                projectRoot: project,
+            });
+        }
+        catch (err) {
+            return {
+                ok: false,
+                outDirRoot: root,
+                artifactDir,
+                deliveryName,
+                diagnostics,
+                error: `pack failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        try {
+            const assemble = await assembleDelivery(artifactDir, {
+                selection: selected.selection,
+                profile: {
+                    ...selected.profile,
+                    sources: selected.profile.sources ||
+                        (norm.table.sugar ? norm.table.profiles[norm.table.default]?.sources : null),
+                },
+                siteId: cfg.application?.id || undefined,
+                origin: opts.origin,
+                pack: pack.manifest,
+                projectRoot: project,
+            });
+            if (!opts.quiet) {
+                emitBuildProof(artifactDir, {
+                    selection: selected.selection,
+                    pack: pack.manifest,
+                    assemble: assemble.manifest,
+                    release: Boolean(opts.release),
+                });
+            }
+        }
+        catch (err) {
+            return {
+                ok: false,
+                outDirRoot: root,
+                artifactDir,
+                deliveryName,
+                diagnostics,
+                error: `assemble failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        return {
+            ok: true,
+            outDirRoot: root,
+            artifactDir,
+            deliveryName,
+            profileId,
+            assembly,
+            diagnostics,
+        };
+    }
+    finally {
+        ws.dispose();
+    }
+}

package/dist/test-cmd.js

@@ -5,7 +5,8 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { createWorkspace, loadVmzConfig, normalizeDeliveryAuthoring, resolveProfileArtifactDir, selectBuildProfile } from './index.js';
+import { createWorkspace } from './index.js';
+import { buildProjectToOutDirRoot } from './project-build.js';
 import { log } from './log.js';
 import { generatePrettyJson } from './pretty-json.js';
 export function registerTestCommand(cli) {
@@ -39,7 +40,7 @@ export async function cmdTest(args) {
         log.error(e instanceof Error ? e.message : String(e));
         return 1;
     }
-    const { discoverTestManifests, buildTestReport, parseModes, buildForCompile, runCompileManifest, runLogicManifest, runSsrManifest, runResumeManifest, runBrowserManifest, runDeploymentManifest, resolveDeliveryServeRoot, } = test;
+    const { discoverTestManifests, buildTestReport, parseModes, runCompileManifest, runLogicManifest, runSsrManifest, runResumeManifest, runBrowserManifest, runDeploymentManifest, resolveDeliveryServeRoot, } = test;
     const project = path.resolve(String(args._[0] || '.'));
     let modes;
     try {
@@ -174,35 +175,28 @@ export async function cmdTest(args) {
         let buildError = null;
         let deliveryName = null;
         if (needsBuild) {
-            // Align with `vmz build` / `vmz serve`: artifacts live under
-            // `<out-dir>/<profiles.*.name>` (default name = profile id).
+            // Same contract as `vmz build . --out-dir <root>`: build into the
+            // out-dir **root** (nest + pack + static assemble inside). Do **not**
+            // pre-pass `resolveProfileArtifactDir` as createWorkspace outDir —
+            // that path skipped assemble and left Browser Host without HTML.
             const outDirRoot = outDirArg ? path.resolve(outDirArg) : fs.mkdtempSync(path.join(os.tmpdir(), 'vmz-test-'));
-            let buildTarget = outDirRoot;
-            try {
-                const cfg = await loadVmzConfig(project);
-                const norm = normalizeDeliveryAuthoring(cfg.delivery ?? null);
-                if (norm.ok) {
-                    const selected = selectBuildProfile(norm.table, '');
-                    if (selected.ok) {
-                        deliveryName = String(selected.profile.name || selected.selection.profileId || '');
-                        buildTarget = resolveProfileArtifactDir(outDirRoot, selected.profile);
-                    }
-                }
-            }
-            catch (e) {
-                log.warn(`delivery profile resolve skipped: ${e instanceof Error ? e.message : String(e)}`);
-            }
-            fs.mkdirSync(buildTarget, { recursive: true });
-            const built = buildForCompile(project, buildTarget, {
-                createWorkspace,
-                deliveryName,
-            });
-            buildOut = resolveDeliveryServeRoot(built.outDir, deliveryName);
+            fs.mkdirSync(outDirRoot, { recursive: true });
+            const built = await buildProjectToOutDirRoot(project, outDirRoot);
             buildDiags = built.diagnostics || [];
-            if (!built.ok) {
+            if (built.ok === false) {
+                deliveryName = built.deliveryName;
                 buildError = built.error || 'build failed';
+                buildOut = outDirRoot;
                 log.error(buildError);
             }
+            else {
+                deliveryName = built.deliveryName;
+                buildOut = resolveDeliveryServeRoot(built.outDirRoot, built.deliveryName);
+                if (!fs.existsSync(path.join(buildOut, 'index.html')) && built.assembly === 'web-static') {
+                    buildError = `web-static assemble missing index.html under ${buildOut}`;
+                    log.error(buildError);
+                }
+            }
         }
         tests = [];
         for (const m of selected) {

package/locales/en-US/cli.json

@@ -100,6 +100,5 @@
     "cli.err.global_needs_project": "this `vmz` is a global install (mode=global); project commands need a project install.",
     "cli.err.global_install_hint": "Install in the app:  pnpm add -D @vmz/vmz",
     "cli.err.global_run_hint": "Then run:            pnpm exec vmz <command>",
-    "cli.err.global_developer_hint": "(developer mode: run from vmz-framework packages/runtimes/vmz source — full CLI)",
-    "diag.message": "{message}"
+    "cli.err.global_developer_hint": "(developer mode: run from vmz-framework packages/runtimes/vmz source — full CLI)"
 }

package/locales/en-US/diag.json

@@ -0,0 +1,154 @@
+{
+    "diag.message": "{message}",
+    "diag.detail": "{detail}",
+
+    "vmz::template::jsx_rejected": "JSX / single-brace expressions are rejected in `<template>`: {detail}",
+    "vmz::template::illegal_directive": "Illegal or unsupported directive in `<template>`: {detail}",
+    "vmz::template::parse_failed": "Failed to parse `<template>`: {detail}",
+    "vmz::template::invalid_expr": "Invalid template expression: {detail}",
+    "vmz::template::each_missing_key": "`v-for` on `<{tag}>` should declare a `:key`",
+    "vmz::template::each_static_key": "`v-for` on `<{tag}>` must not use a static key `{key}`",
+    "vmz::template::each_literal_key": "`v-for` on `<{tag}>` must not use a literal key `{key}`",
+    "vmz::template::each_object_key": "`v-for` on `<{tag}>` object form should bind `:key` to `{as}`",
+
+    "vmz::style::unknown_design_token": "Unknown design token `{name}`: {detail}",
+    "vmz::style::unused_design_token": "Unused design token `{name}` (`{var}`): {detail}",
+    "vmz::style::unreferenced_global_style": "Unreferenced global style `{path}`: {detail}",
+    "vmz::style::token_json_invalid": "Invalid design token JSON: {detail}",
+    "vmz::style::theme_id_collision": "Style theme id collision: `{id}`",
+    "vmz::style::theme_json_unreadable": "Style theme JSON is unreadable",
+    "vmz::style::theme_json_invalid": "Style theme JSON is invalid",
+    "vmz::style::prefers_scheme_empty": "Empty prefers-color-scheme mapping for `{scheme}`",
+
+    "vmz::locale::manifest_missing": "Locale manifest missing: {detail}",
+    "vmz::locale::id_invalid": "{detail}",
+    "vmz::locale::id_collision": "{detail}",
+    "vmz::locale::default_missing": "{detail}",
+    "vmz::locale::fallback_cycle": "{detail}",
+    "vmz::locale::fallback_unknown": "{detail}",
+    "vmz::locale::dir_orphan": "{detail}",
+    "vmz::locale::dir_missing": "{detail}",
+    "vmz::locale::layout_illegal": "{detail}",
+    "vmz::locale::message_missing_default": "{detail}",
+    "vmz::locale::message_missing_variant": "{detail}",
+    "vmz::locale::message_parameter_mismatch": "{detail}",
+    "vmz::locale::message_syntax_invalid": "{detail}",
+    "vmz::locale::message_array_forbidden": "{detail}",
+    "vmz::locale::message_unused": "{detail}",
+    "vmz::locale::message_html_forbidden": "{detail}",
+    "vmz::locale::catalog_parse": "{detail}",
+    "vmz::locale::catalog_conflict": "{detail}",
+    "vmz::locale::formatter_context_incomplete": "{detail}",
+    "vmz::locale::formatter_version_mismatch": "{detail}",
+    "vmz::locale::digest_mismatch": "{detail}",
+    "vmz::locale::transition_partial": "{detail}",
+    "vmz::locale::transition_unsupported": "{detail}",
+    "vmz::locale::transition_load_failed": "{detail}",
+    "vmz::locale::machine_default_forbidden": "{detail}",
+    "vmz::locale::message_mixed_locale": "{detail}",
+    "vmz::locale::stale_generation": "{detail}",
+    "vmz::locale::route_collision": "{detail}",
+    "vmz::locale::canonical_missing": "{detail}",
+    "vmz::locale::hreflang_incomplete": "{detail}",
+    "vmz::locale::meta_locale_mismatch": "{detail}",
+    "vmz::locale::link_hardcoded_path": "{detail}",
+    "vmz::locale::cache_key_steals_content": "{detail}",
+    "vmz::locale::prefix_omit_without_redirect": "{detail}",
+    "vmz::locale::delivery_full_bundle": "{detail}",
+    "vmz::locale::chunk_hash_mismatch": "{detail}",
+    "vmz::locale::native_pack_unsigned": "{detail}",
+    "vmz::locale::native_pack_has_js": "{detail}",
+    "vmz::locale::native_pack_app_mismatch": "{detail}",
+    "vmz::locale::mini_cross_package_unproven": "{detail}",
+    "vmz::locale::server_translated_error": "{detail}",
+    "vmz::locale::server_format_without_context": "{detail}",
+    "vmz::locale::host_message_divergence": "{detail}",
+    "vmz::locale::message_dynamic_id_unbounded": "{detail}",
+    "vmz::locale::hardcoded_text": "{detail}",
+    "vmz::locale::pseudo_production_forbidden": "{detail}",
+    "vmz::locale::conformance_divergence": "{detail}",
+    "vmz::locale::explain_unknown": "{detail}",
+
+    "vmz::format::would_reformat": "File would be reformatted",
+    "vmz::format::failed": "Format failed: {detail}",
+
+    "vmz::convention::layout_suffix": "Named layout `{stem}` should end with `Layout`",
+    "vmz::convention::pascal_case_file": "Prefer PascalCase file name `{hint}` (got `{name}`)",
+    "vmz::convention::prefer_application_shell": "Prefer `Application.vmz` as the application shell",
+    "vmz::convention::prefer_pascal_index": "Prefer `Index.vmz` over `index.vmz` for pages",
+
+    "vmz::io::read_failed": "Failed to read file: {error}",
+    "vmz::sfc::parse_failed": "Failed to parse `.vmz` SFC: {detail}",
+
+    "vmz::script::client_parse_failed": "Failed to parse client script: {detail}",
+    "vmz::script::client_export_required": "Client script must `export default class`",
+    "vmz::script::forbidden_factory": "Forbidden factory `{name}` (use class + public props)",
+    "vmz::script::server_parse_failed": "Failed to parse server script: {detail}",
+    "vmz::script::server_export_required": "Server script must export a default class or function",
+    "vmz::script::server_struct_required": "Rust server script must declare a public struct",
+
+    "vmz::router::link_invalid": "Invalid route link: {detail}",
+    "vmz::router::route_table_invalid": "Invalid route table: {detail}",
+    "vmz::router::path_deviation": "Route path `{explicit}` differs from file `{file}`",
+
+    "vmz::runtime::missing": "Missing runtime `{name}` under `{root}`",
+    "vmz::emit::server_tree_failed": "Failed to emit server tree: {error}",
+    "vmz::emit::client_module_failed": "Failed to emit client module: {error}",
+    "vmz::emit::client_js_print_failed": "Failed to print client JS: {error}",
+    "vmz::emit::client_failed": "Failed to emit client: {error}",
+    "vmz::emit::server_failed": "Failed to emit server: {error}",
+
+    "vmz::program::unknown_widen": "Unknown widen via `{via}` for field `{field}`: {reason}",
+
+    "vmz::server::server_slice_not_browser_safe": "Server slice is not browser-safe: {detail}",
+    "vmz::server::client_mock_provider_forbidden": "{detail}",
+    "vmz::server::secret_client_leak": "{detail}",
+    "vmz::server::secret_binding_missing": "{detail}",
+
+    "vmz::tw::theme_load_failed": "Failed to load Tailwind theme: {detail}",
+    "vmz::tw::dynamic_style_tw": "Dynamic `style:tw` expression `{expr}` cannot be collected statically",
+    "vmz::tw::unbalanced_at_tailwind": "Unbalanced `@tailwind` block: {detail}",
+
+    "vmz::scss::compile_failed": "SCSS compile failed: {detail}",
+
+    "vmz::plugin::analyzer": "Plugin `{plugin}` analyzer `{id}`: {detail}",
+
+    "vmz::dx::class_name_mismatch": "{detail}",
+
+    "vmz::application::duplicate_id": "{detail}",
+    "vmz::application::unknown_reference": "{detail}",
+    "vmz::application::mount_collision": "{detail}",
+    "vmz::application::invalid_schema": "{detail}",
+    "vmz::application::invalid_config": "{detail}",
+    "vmz::application::invalid_descriptor": "{detail}",
+    "vmz::application::invalid_route_base": "{detail}",
+    "vmz::application::duplicate_mount": "{detail}",
+    "vmz::application::non_relocatable_url": "{detail}",
+    "vmz::application::invalid_base": "{detail}",
+    "vmz::application::artifact_integrity": "{detail}",
+    "vmz::application::cross_runtime_reference": "{detail}",
+    "vmz::application::isolation_unproven": "{detail}",
+    "vmz::application::failure_containment": "{detail}",
+    "vmz::application::route_not_public": "{detail}",
+    "vmz::application::mount_unreachable": "{detail}",
+    "vmz::application::session_shared": "{detail}",
+    "vmz::application::proxy_misroute": "{detail}",
+    "vmz::application::affected_leak": "{detail}",
+
+    "document::config::missing": "{detail}",
+    "document::config::invalid": "{detail}",
+    "document::config::default_locale": "{detail}",
+    "document::fallback::silent_forbidden": "{detail}",
+
+    "vmz::target::dom_leak_in_plan": "{detail}",
+    "vmz::target::unknown_view_op": "{detail}",
+    "vmz::target::platform_unsupported": "{detail}",
+    "vmz::target::profile_invalid": "{detail}",
+    "vmz::target::artifact_invalid": "{detail}",
+    "vmz::target::mini_missing_adapter": "{detail}",
+    "vmz::target::mini_adapter_semantic_core": "{detail}",
+    "vmz::target::mini_platform_private_schema": "{detail}",
+    "vmz::target::mini_shared_fork": "{detail}",
+    "vmz::target::mini_static_slice_catalog_only": "{detail}",
+    "vmz::target::mini_route_server_style_catalog_only": "{detail}"
+}

package/locales/locales.json

@@ -1,4 +1,7 @@
 {
     "defaultLocale": "en-US",
-    "locales": [{ "id": "en-US", "label": "English", "direction": "ltr" }]
+    "locales": [{ "id": "en-US", "label": "English", "direction": "ltr" }, { "id": "zh-CN", "label": "简体中文", "direction": "ltr" }],
+    "fallback": {
+        "zh-CN": ["en-US"]
+    }
 }

package/locales/zh-CN/diag.json

@@ -0,0 +1,154 @@
+{
+    "diag.message": "{message}",
+    "diag.detail": "{detail}",
+
+    "vmz::template::jsx_rejected": "`<template>` 拒绝 JSX / 单花括号表达式：{detail}",
+    "vmz::template::illegal_directive": "`<template>` 中存在非法或不支持的指令：{detail}",
+    "vmz::template::parse_failed": "解析 `<template>` 失败：{detail}",
+    "vmz::template::invalid_expr": "模板表达式无效：{detail}",
+    "vmz::template::each_missing_key": "`<{tag}>` 上的 `v-for` 应声明 `:key`",
+    "vmz::template::each_static_key": "`<{tag}>` 上的 `v-for` 不得使用静态 key `{key}`",
+    "vmz::template::each_literal_key": "`<{tag}>` 上的 `v-for` 不得使用字面量 key `{key}`",
+    "vmz::template::each_object_key": "`<{tag}>` 上的 `v-for` 对象形式应将 `:key` 绑定到 `{as}`",
+
+    "vmz::style::unknown_design_token": "未知设计令牌 `{name}`：{detail}",
+    "vmz::style::unused_design_token": "未使用的设计令牌 `{name}`（`{var}`）：{detail}",
+    "vmz::style::unreferenced_global_style": "未被引用的全局样式 `{path}`：{detail}",
+    "vmz::style::token_json_invalid": "设计令牌 JSON 无效：{detail}",
+    "vmz::style::theme_id_collision": "样式主题 id 冲突：`{id}`",
+    "vmz::style::theme_json_unreadable": "无法读取样式主题 JSON",
+    "vmz::style::theme_json_invalid": "样式主题 JSON 无效",
+    "vmz::style::prefers_scheme_empty": "`{scheme}` 的 prefers-color-scheme 映射为空",
+
+    "vmz::locale::manifest_missing": "缺少 locale 清单：{detail}",
+    "vmz::locale::id_invalid": "{detail}",
+    "vmz::locale::id_collision": "{detail}",
+    "vmz::locale::default_missing": "{detail}",
+    "vmz::locale::fallback_cycle": "{detail}",
+    "vmz::locale::fallback_unknown": "{detail}",
+    "vmz::locale::dir_orphan": "{detail}",
+    "vmz::locale::dir_missing": "{detail}",
+    "vmz::locale::layout_illegal": "{detail}",
+    "vmz::locale::message_missing_default": "{detail}",
+    "vmz::locale::message_missing_variant": "{detail}",
+    "vmz::locale::message_parameter_mismatch": "{detail}",
+    "vmz::locale::message_syntax_invalid": "{detail}",
+    "vmz::locale::message_array_forbidden": "{detail}",
+    "vmz::locale::message_unused": "{detail}",
+    "vmz::locale::message_html_forbidden": "{detail}",
+    "vmz::locale::catalog_parse": "{detail}",
+    "vmz::locale::catalog_conflict": "{detail}",
+    "vmz::locale::formatter_context_incomplete": "{detail}",
+    "vmz::locale::formatter_version_mismatch": "{detail}",
+    "vmz::locale::digest_mismatch": "{detail}",
+    "vmz::locale::transition_partial": "{detail}",
+    "vmz::locale::transition_unsupported": "{detail}",
+    "vmz::locale::transition_load_failed": "{detail}",
+    "vmz::locale::machine_default_forbidden": "{detail}",
+    "vmz::locale::message_mixed_locale": "{detail}",
+    "vmz::locale::stale_generation": "{detail}",
+    "vmz::locale::route_collision": "{detail}",
+    "vmz::locale::canonical_missing": "{detail}",
+    "vmz::locale::hreflang_incomplete": "{detail}",
+    "vmz::locale::meta_locale_mismatch": "{detail}",
+    "vmz::locale::link_hardcoded_path": "{detail}",
+    "vmz::locale::cache_key_steals_content": "{detail}",
+    "vmz::locale::prefix_omit_without_redirect": "{detail}",
+    "vmz::locale::delivery_full_bundle": "{detail}",
+    "vmz::locale::chunk_hash_mismatch": "{detail}",
+    "vmz::locale::native_pack_unsigned": "{detail}",
+    "vmz::locale::native_pack_has_js": "{detail}",
+    "vmz::locale::native_pack_app_mismatch": "{detail}",
+    "vmz::locale::mini_cross_package_unproven": "{detail}",
+    "vmz::locale::server_translated_error": "{detail}",
+    "vmz::locale::server_format_without_context": "{detail}",
+    "vmz::locale::host_message_divergence": "{detail}",
+    "vmz::locale::message_dynamic_id_unbounded": "{detail}",
+    "vmz::locale::hardcoded_text": "{detail}",
+    "vmz::locale::pseudo_production_forbidden": "{detail}",
+    "vmz::locale::conformance_divergence": "{detail}",
+    "vmz::locale::explain_unknown": "{detail}",
+
+    "vmz::format::would_reformat": "文件将被重新格式化",
+    "vmz::format::failed": "格式化失败：{detail}",
+
+    "vmz::convention::layout_suffix": "命名布局 `{stem}` 应以 `Layout` 结尾",
+    "vmz::convention::pascal_case_file": "文件名建议使用 PascalCase `{hint}`（当前为 `{name}`）",
+    "vmz::convention::prefer_application_shell": "应用壳优先使用 `Application.vmz`",
+    "vmz::convention::prefer_pascal_index": "页面优先使用 `Index.vmz` 而非 `index.vmz`",
+
+    "vmz::io::read_failed": "读取文件失败：{error}",
+    "vmz::sfc::parse_failed": "解析 `.vmz` SFC 失败：{detail}",
+
+    "vmz::script::client_parse_failed": "解析 client script 失败：{detail}",
+    "vmz::script::client_export_required": "client script 必须 `export default class`",
+    "vmz::script::forbidden_factory": "禁止使用工厂函数 `{name}`（请用 class + public props）",
+    "vmz::script::server_parse_failed": "解析 server script 失败：{detail}",
+    "vmz::script::server_export_required": "server script 必须导出默认 class 或函数",
+    "vmz::script::server_struct_required": "Rust server script 必须声明 public struct",
+
+    "vmz::router::link_invalid": "路由链接无效：{detail}",
+    "vmz::router::route_table_invalid": "路由表无效：{detail}",
+    "vmz::router::path_deviation": "路由路径 `{explicit}` 与文件 `{file}` 不一致",
+
+    "vmz::runtime::missing": "在 `{root}` 下缺少运行时 `{name}`",
+    "vmz::emit::server_tree_failed": "生成 server tree 失败：{error}",
+    "vmz::emit::client_module_failed": "生成 client module 失败：{error}",
+    "vmz::emit::client_js_print_failed": "打印 client JS 失败：{error}",
+    "vmz::emit::client_failed": "生成 client 失败：{error}",
+    "vmz::emit::server_failed": "生成 server 失败：{error}",
+
+    "vmz::program::unknown_widen": "字段 `{field}` 经 `{via}` 未知 widen：{reason}",
+
+    "vmz::server::server_slice_not_browser_safe": "server slice 对浏览器不安全：{detail}",
+    "vmz::server::client_mock_provider_forbidden": "{detail}",
+    "vmz::server::secret_client_leak": "{detail}",
+    "vmz::server::secret_binding_missing": "{detail}",
+
+    "vmz::tw::theme_load_failed": "加载 Tailwind 主题失败：{detail}",
+    "vmz::tw::dynamic_style_tw": "动态 `style:tw` 表达式 `{expr}` 无法静态收集",
+    "vmz::tw::unbalanced_at_tailwind": "`@tailwind` 块括号不匹配：{detail}",
+
+    "vmz::scss::compile_failed": "SCSS 编译失败：{detail}",
+
+    "vmz::plugin::analyzer": "插件 `{plugin}` 分析器 `{id}`：{detail}",
+
+    "vmz::dx::class_name_mismatch": "{detail}",
+
+    "vmz::application::duplicate_id": "{detail}",
+    "vmz::application::unknown_reference": "{detail}",
+    "vmz::application::mount_collision": "{detail}",
+    "vmz::application::invalid_schema": "{detail}",
+    "vmz::application::invalid_config": "{detail}",
+    "vmz::application::invalid_descriptor": "{detail}",
+    "vmz::application::invalid_route_base": "{detail}",
+    "vmz::application::duplicate_mount": "{detail}",
+    "vmz::application::non_relocatable_url": "{detail}",
+    "vmz::application::invalid_base": "{detail}",
+    "vmz::application::artifact_integrity": "{detail}",
+    "vmz::application::cross_runtime_reference": "{detail}",
+    "vmz::application::isolation_unproven": "{detail}",
+    "vmz::application::failure_containment": "{detail}",
+    "vmz::application::route_not_public": "{detail}",
+    "vmz::application::mount_unreachable": "{detail}",
+    "vmz::application::session_shared": "{detail}",
+    "vmz::application::proxy_misroute": "{detail}",
+    "vmz::application::affected_leak": "{detail}",
+
+    "document::config::missing": "{detail}",
+    "document::config::invalid": "{detail}",
+    "document::config::default_locale": "{detail}",
+    "document::fallback::silent_forbidden": "{detail}",
+
+    "vmz::target::dom_leak_in_plan": "{detail}",
+    "vmz::target::unknown_view_op": "{detail}",
+    "vmz::target::platform_unsupported": "{detail}",
+    "vmz::target::profile_invalid": "{detail}",
+    "vmz::target::artifact_invalid": "{detail}",
+    "vmz::target::mini_missing_adapter": "{detail}",
+    "vmz::target::mini_adapter_semantic_core": "{detail}",
+    "vmz::target::mini_platform_private_schema": "{detail}",
+    "vmz::target::mini_shared_fork": "{detail}",
+    "vmz::target::mini_static_slice_catalog_only": "{detail}",
+    "vmz::target::mini_route_server_style_catalog_only": "{detail}"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/vmz",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "type": "module",
   "description": "VMZ Node toolchain — N-API workspace session + CLI (publish name @vmz/vmz)",
   "license": "MIT",
@@ -48,16 +48,16 @@
     }
   },
   "dependencies": {
-    "@vmz/commander": "0.1.19",
-    "@vmz/core": "0.1.19",
-    "@vmz/diagnostic": "0.1.19",
-    "@vmz/plugin": "0.1.19",
-    "@vmz/protocol": "0.1.19",
+    "@vmz/commander": "0.1.21",
+    "@vmz/core": "0.1.21",
+    "@vmz/diagnostic": "0.1.21",
+    "@vmz/plugin": "0.1.21",
+    "@vmz/protocol": "0.1.21",
     "jiti": "^2.6.1"
   },
   "peerDependencies": {
-    "@vmz/plugin-markdown-it": "0.1.19",
-    "@vmz/test": "0.1.19",
+    "@vmz/plugin-markdown-it": "0.1.21",
+    "@vmz/test": "0.1.21",
     "typescript": "^5.8.3"
   },
   "peerDependenciesMeta": {
@@ -92,12 +92,12 @@
     "cli"
   ],
   "optionalDependencies": {
-    "@vmz/vmz-win32-x64": "0.1.19",
-    "@vmz/vmz-win32-arm64": "0.1.19",
-    "@vmz/vmz-darwin-x64": "0.1.19",
-    "@vmz/vmz-darwin-arm64": "0.1.19",
-    "@vmz/vmz-linux-x64": "0.1.19",
-    "@vmz/vmz-linux-arm64": "0.1.19"
+    "@vmz/vmz-win32-x64": "0.1.21",
+    "@vmz/vmz-win32-arm64": "0.1.21",
+    "@vmz/vmz-darwin-x64": "0.1.21",
+    "@vmz/vmz-darwin-arm64": "0.1.21",
+    "@vmz/vmz-linux-x64": "0.1.21",
+    "@vmz/vmz-linux-arm64": "0.1.21"
   },
   "publishConfig": {
     "access": "public"