@vmz/vmz 0.1.20 → 0.1.22

package/dist/server-artifact.js

@@ -1,109 +1,30 @@
 /**
- * P4 ServerArtifact — compiled route decision tree + public ServerRoute contracts
- * + internal capability units + selected runtime adapter. Web Standards Fetch entry.
+ * P4 ServerArtifact — thin host write of Rust/N-API normalized Plan.
+ * Assembly / digests / adapters live in vmz-artifacts via N-API.
  */
-import crypto from 'node:crypto';
 import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
-import { SERVER_RUNTIMES } from './delivery-profile.js';
+import { requireNativeAddon } from './native-addon.js';
 import { writePrettyJsonFile } from './pretty-json.js';
 export const SERVER_ARTIFACT_SCHEMA = 'vmz.server.artifact.v0';
 export const HTTP_CONTRACT_SCHEMA = 'vmz.http.contract.v0';
 export const SERVER_RUNTIME_ADAPTER_SCHEMA = 'vmz.server.runtime_adapter.v0';
-const DEFAULT_RPC_PATH = '/__vmz/rpc';
 export function emitServerArtifact(outDir, opts = {}) {
-    const deployment = readJson(path.join(outDir, 'vmz-deployment.json')) || { schema: null, units: [] };
-    const routes = readJson(path.join(outDir, 'vmz-routes.json'));
-    const routeRows = Array.isArray(routes) ? routes : [];
-    const selectedRuntime = normalizeRuntime(opts.serverRuntime);
-    const units = Array.isArray(deployment.units) ? deployment.units : [];
-    const publicRoutes = routeRows.map((r) => ({
-        verb: String(r.verb || 'GET').toUpperCase(),
-        path: String(r.path || ''),
-        moduleId: String(r.moduleId || ''),
-        method: String(r.method || ''),
-        className: r.className != null ? String(r.className) : null,
-        visibility: 'public',
-        kind: 'server-route',
-    }));
-    const publicKeys = new Set(publicRoutes.map((r) => `${r.moduleId}::${r.method}`));
-    /** @type {Array<Record<string, unknown>>} */
-    const internalCapabilities = [];
-    for (const u of units) {
-        const moduleId = u.serverModuleId != null ? String(u.serverModuleId) : '';
-        if (!moduleId)
-            continue;
-        const caps = Array.isArray(u.capabilities) ? u.capabilities.map(String) : [];
-        for (const method of caps) {
-            const key = `${moduleId}::${method}`;
-            if (publicKeys.has(key))
-                continue;
-            internalCapabilities.push({
-                chunkId: String(u.chunkId || ''),
-                moduleId,
-                method,
-                visibility: 'internal',
-                kind: 'capability',
-            });
-        }
-    }
-    const routeDecisionTree = [
-        {
-            id: 'rpc',
-            match: { method: 'POST', path: DEFAULT_RPC_PATH },
-            action: 'invoke-rpc',
-            visibility: 'internal-transport',
-        },
-        ...publicRoutes.map((r, i) => ({
-            id: `public-route-${i}`,
-            match: { method: r.verb, path: r.path },
-            action: 'invoke-server-route',
-            target: { moduleId: r.moduleId, method: r.method },
-            visibility: 'public',
-        })),
-    ];
-    const httpContractBody = {
-        schema: HTTP_CONTRACT_SCHEMA,
-        rpcPath: DEFAULT_RPC_PATH,
-        publicRoutes: publicRoutes.map((r) => ({
-            verb: r.verb,
-            path: r.path,
-            moduleId: r.moduleId,
-            method: r.method,
-        })),
-        internalCapabilityCount: internalCapabilities.length,
-        entry: 'fetch',
-    };
-    const httpContractDigest = sha256Hex(canonicalJson(httpContractBody));
-    const artifact = {
-        schema: SERVER_ARTIFACT_SCHEMA,
-        profileId: opts.profileId || null,
-        assembly: opts.assembly || null,
-        selectedRuntime,
-        entry: {
-            kind: 'fetch',
-            standards: ['Request', 'Response', 'Streams', 'AbortSignal'],
-            rpcPath: DEFAULT_RPC_PATH,
-        },
-        httpContract: {
-            schema: HTTP_CONTRACT_SCHEMA,
-            digest: httpContractDigest,
-        },
-        publicRoutes,
-        internalCapabilities,
-        middlewareUnits: [],
-        routeDecisionTree,
-        deploymentSchema: deployment.schema || null,
-        packDigest: opts.packDigest || null,
-        adapters: {
-            node: { kind: 'node-http', status: 'runtime', entry: 'handleNodeRequest' },
-            worker: { kind: 'fetch', status: 'runtime', entry: 'handleFetchRequest' },
-            deno: { kind: 'fetch', status: 'projected', entry: 'handleFetchRequest' },
-            bun: { kind: 'fetch', status: 'projected', entry: 'handleFetchRequest' },
-            'rust-host': { kind: 'contract-projection', status: 'projected', entry: 'fetch' },
-        },
-    };
-    artifact.artifactDigest = sha256Hex(canonicalJson({ ...artifact, artifactDigest: undefined }));
+    const deploymentPath = path.join(outDir, 'vmz-deployment.json');
+    const routesPath = path.join(outDir, 'vmz-routes.json');
+    const deploymentJson = existsSync(deploymentPath) ? readFileSync(deploymentPath, 'utf8') : '{}';
+    const routesJson = existsSync(routesPath) ? readFileSync(routesPath, 'utf8') : '[]';
+    const native = requireNativeAddon();
+    if (typeof native.normalizeServerArtifactJson !== 'function') {
+        throw new Error('vmz native addon missing normalizeServerArtifactJson — rebuild with `pnpm napi:build`');
+    }
+    const artifactJson = native.normalizeServerArtifactJson(deploymentJson, routesJson, {
+        profileId: opts.profileId ?? null,
+        assembly: opts.assembly ?? null,
+        serverRuntime: opts.serverRuntime ?? null,
+        packDigest: opts.packDigest ?? null,
+    });
+    const artifact = JSON.parse(artifactJson);
     const vmzDir = path.join(outDir, '_vmz');
     mkdirSync(vmzDir, { recursive: true });
     const file = path.join(vmzDir, 'server-artifact.json');
@@ -116,79 +37,19 @@ export function emitServerArtifact(outDir, opts = {}) {
         mkdirSync(dir, { recursive: true });
         writePrettyJsonFile(path.join(dir, 'adapter.json'), projection);
     }
-    return { artifact, path: file, httpContractDigest };
+    return {
+        artifact,
+        path: file,
+        httpContractDigest: artifact.httpContract?.digest || null,
+    };
 }
 /**
- * @param {Record<string, any>} artifact
- * @param {string} adapterId
+ * Project a runtime adapter document from a normalized artifact (N-API).
  */
 export function projectServerRuntimeAdapter(artifact, adapterId) {
-    const id = String(adapterId || '').trim();
-    if (!SERVER_RUNTIMES.includes(id) && id !== 'worker') {
-        throw new Error(`projectServerRuntimeAdapter: unknown adapter ${id}`);
-    }
-    const base = {
-        schema: SERVER_RUNTIME_ADAPTER_SCHEMA,
-        adapterId: id,
-        artifactDigest: artifact.artifactDigest,
-        httpContractDigest: artifact.httpContract?.digest || null,
-        spaFallback: false,
-        entry: artifact.entry,
-        publicRouteCount: Array.isArray(artifact.publicRoutes) ? artifact.publicRoutes.length : 0,
-        internalCapabilityCount: Array.isArray(artifact.internalCapabilities) ? artifact.internalCapabilities.length : 0,
-    };
-    if (id === 'node') {
-        return { ...base, host: 'node:http', invoke: 'handleNodeRequest', status: 'runtime' };
-    }
-    if (id === 'worker' || id === 'deno' || id === 'bun') {
-        return {
-            ...base,
-            host: 'fetch',
-            invoke: 'handleFetchRequest',
-            status: id === 'worker' ? 'runtime' : 'projected',
-            note: id === 'worker'
-                ? 'Fetch entry; live thin gated via worker-shaped subprocess host'
-                : 'Fetch contract projection; live runtime not gated',
-        };
+    const native = requireNativeAddon();
+    if (typeof native.projectServerRuntimeAdapterJson !== 'function') {
+        throw new Error('vmz native addon missing projectServerRuntimeAdapterJson — rebuild with `pnpm napi:build`');
     }
-    // rust-host
-    return {
-        ...base,
-        host: 'rust-fetch-consumer',
-        invoke: 'fetch',
-        status: 'projected',
-        note: 'contract projection only — live Rust host binary parity not gated',
-        consumes: ['server-artifact.json', 'vmz-routes.json', 'vmz-deployment.json'],
-    };
-}
-function normalizeRuntime(raw) {
-    const v = String(raw || 'node').trim();
-    return SERVER_RUNTIMES.includes(v) ? v : 'node';
-}
-function readJson(file) {
-    if (!existsSync(file))
-        return null;
-    try {
-        return JSON.parse(readFileSync(file, 'utf8'));
-    }
-    catch {
-        return null;
-    }
-}
-function canonicalJson(value) {
-    return JSON.stringify(sortKeys(value));
-}
-function sortKeys(value) {
-    if (Array.isArray(value))
-        return value.map(sortKeys);
-    if (value && typeof value === 'object') {
-        const out = {};
-        for (const k of Object.keys(value).sort())
-            out[k] = sortKeys(value[k]);
-        return out;
-    }
-    return value;
-}
-function sha256Hex(text) {
-    return crypto.createHash('sha256').update(text, 'utf8').digest('hex');
+    return JSON.parse(native.projectServerRuntimeAdapterJson(JSON.stringify(artifact), String(adapterId || '').trim()));
 }

package/dist/static-emit.js

@@ -15,7 +15,7 @@ import { absoluteUrl, buildLocalePageMeta, localizeBodyLinks } from './locale-ro
 import { requireNativeAddon } from './native-addon.js';
 import { writePrettyJsonFile } from './pretty-json.js';
 import { emitPublicStaticAssets } from './public-static-assets.js';
-import { filePathPatternFromChunk, isRouteBoundaryStem, listPublicPageUnits, parsePathPattern, unitBrowserPathPattern } from './route-path.js';
+import { listPublicPageUnits, parsePathPattern, unitBrowserPathPattern } from './route-path.js';
 import { emitSiteFavicon, readSiteFaviconHeadHtml } from './site-favicon.js';
 export const STATIC_DELIVERY_MANIFEST_SCHEMA = 'vmz.static.delivery_manifest.v0';
 export async function emitWebStatic(distDir, opts = {}) {
@@ -265,53 +265,25 @@ function sortKeys(value) {
  */
 function listPageClientFiles(distDir) {
     const fromDep = listPagesFromDeployment(distDir);
-    if (fromDep.length)
-        return fromDep;
-    const root = path.join(distDir, 'pages');
-    /** @type {Array<{ chunkId: string, segs: ReturnType<typeof parsePathPattern>, pathPattern: string }>} */
-    const out = [];
-    function walk(abs, relParts) {
-        let ents;
-        try {
-            ents = fs.readdirSync(abs, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const e of ents) {
-            if (e.isDirectory())
-                walk(path.join(abs, e.name), [...relParts, e.name]);
-            else if (e.isFile() && e.name.endsWith('.client.js')) {
-                const stem = e.name.replace(/\.client\.js$/, '');
-                if (isRouteBoundaryStem(stem))
-                    continue;
-                const chunkId = ['pages', ...relParts, stem].join('/');
-                const pathPattern = filePathPatternFromChunk(chunkId);
-                out.push({ chunkId, pathPattern, segs: parsePathPattern(pathPattern) });
-            }
-        }
+    if (!fromDep.length) {
+        throw new Error(`emitWebStatic: no page units with pathPattern in ${path.join(distDir, 'vmz-deployment.json')} (plan-only host)`);
     }
-    walk(root, []);
-    return out;
+    return fromDep;
 }
 /**
  * @param {string} distDir
  */
 function listPagesFromDeployment(distDir) {
     const deploymentPath = path.join(distDir, 'vmz-deployment.json');
-    if (!fs.existsSync(deploymentPath))
-        return [];
-    try {
-        const deployment = JSON.parse(fs.readFileSync(deploymentPath, 'utf8'));
-        return listPublicPageUnits(deployment).map((u) => {
-            const chunkId = String(u.chunkId || '').replace(/\\/g, '/');
-            const pathPattern = unitBrowserPathPattern(u);
-            return { chunkId, pathPattern, segs: parsePathPattern(pathPattern) };
-        });
-    }
-    catch {
-        return [];
+    if (!fs.existsSync(deploymentPath)) {
+        throw new Error(`emitWebStatic: missing ${deploymentPath} (plan-only host)`);
     }
+    const deployment = JSON.parse(fs.readFileSync(deploymentPath, 'utf8'));
+    return listPublicPageUnits(deployment).map((u) => {
+        const chunkId = String(u.chunkId || '').replace(/\\/g, '/');
+        const pathPattern = unitBrowserPathPattern(u);
+        return { chunkId, pathPattern, segs: parsePathPattern(pathPattern) };
+    });
 }
 /**
  * @param {ReturnType<typeof parsePathPattern>} segs

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}"
+}