@vmz/vmz 0.3.14 → 0.3.15

package/delivery-runtime-files.json

@@ -12,6 +12,7 @@
         { "src": "browser/unknown-component.js", "out": "unknown-component.js" },
         { "src": "shared/dom-attr-normalize.js", "out": "dom-attr-normalize.js" },
         { "src": "shared/html-digest.js", "out": "html-digest.js" },
+        { "src": "shared/row-key.js", "out": "row-key.js" },
         { "src": "faces/http.js", "out": "vmz-http.js" },
         { "src": "browser/client-nav.js", "out": "vmz-client-nav.js" }
     ],

package/dist/cli/cli.js

@@ -2,11 +2,12 @@
  * Node CLI command implementations .
  */
 import { spawn } from 'node:child_process';
-import { existsSync, statSync } from 'node:fs';
+import { existsSync, readFileSync, statSync } from 'node:fs';
 import path from 'node:path';
 import { createCli } from '@vmz/commander';
 import { registerApplicationCommands } from './application-cmd.js';
 import { assembleDelivery, emitBuildProof } from '../workspace/build-assemble.js';
+import { listenLocalStaticHost } from '../workspace/cdn-policy.js';
 import { resolveCliLocalesRoot } from './cli-localize.js';
 import { normalizeDeliveryAuthoring, resolveProfileArtifactDir, selectBuildProfile } from '../delivery/delivery-profile.js';
 import { createDevSession } from '../dev/dev-session.js';
@@ -401,6 +402,14 @@ async function cmdServe(args) {
         return 1;
     }
     const outDir = resolveProfileArtifactDir(outDirRoot, selected.profile);
+    const host = typeof args.host === 'string' ? args.host : '127.0.0.1';
+    const port = Number(args.port ?? 5173);
+    // `web-static` assemblies are pruned for delivery: the Node runtime face, page
+    // modules and `_vmz/pack-node/` are deliberately absent, so spawning the SSR
+    // host here fails with `ERR_MODULE_NOT_FOUND`. Serve the emitted HTML instead.
+    if (readAssembleAssembly(outDir) === 'web-static') {
+        return await serveWebStaticArtifact(outDir, host, port);
+    }
     const hostJs = path.join(outDir, 'vmz-serve-host.mjs');
     {
         try {
@@ -412,8 +421,6 @@ async function cmdServe(args) {
             return 1;
         }
     }
-    const host = typeof args.host === 'string' ? args.host : '127.0.0.1';
-    const port = Number(args.port ?? 5173);
     log.info(`serve http://${host}:${port}`);
     const node = process.env.VMZ_NODE || process.execPath;
     const child = spawn(node, [hostJs], {
@@ -444,6 +451,45 @@ async function cmdServe(args) {
         });
     });
 }
+/** `assembly` recorded by the last build at this artifact dir, or `''` when absent. */
+function readAssembleAssembly(outDir) {
+    try {
+        const raw = JSON.parse(readFileSync(path.join(outDir, '_vmz', 'assemble-manifest.json'), 'utf8'));
+        return typeof raw?.assembly === 'string' ? raw.assembly : '';
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Preview a pruned `web-static` artifact through the CDN policy of the build:
+ * per-route HTML, real 404 document, cache headers. No SSR host is involved.
+ */
+async function serveWebStaticArtifact(outDir, host, port) {
+    if (!existsSync(path.join(outDir, 'index.html'))) {
+        log.error(`missing ${path.join(outDir, 'index.html')} — run \`vmz build --profile static\` first`);
+        return 1;
+    }
+    let policy = {};
+    const policyPath = path.join(outDir, '_vmz', 'cdn-policy-manifest.json');
+    if (existsSync(policyPath)) {
+        try {
+            policy = JSON.parse(readFileSync(policyPath, 'utf8'));
+        }
+        catch {
+            policy = {};
+        }
+    }
+    const server = await listenLocalStaticHost(outDir, policy, { host, port });
+    log.info(`serve static ${server.baseUrl} (web-static artifact, no SSR host)`);
+    return await new Promise((resolve) => {
+        const shutdown = () => {
+            server.close().then(() => resolve(0), () => resolve(1));
+        };
+        process.once('SIGINT', shutdown);
+        process.once('SIGTERM', shutdown);
+    });
+}
 async function cmdDev(args) {
     const pathArg = args._[0] ?? '.';
     const { project, outDir: outDirRoot } = resolveWorkspaceDirs({

package/dist/workspace/cdn-policy.d.ts

@@ -42,6 +42,12 @@ interface LocalStaticHostOpts {
     host?: string;
     port?: number;
 }
+export interface LocalStaticHost {
+    host: string;
+    port: number;
+    baseUrl: string;
+    close: () => Promise<void>;
+}
 export declare function buildCdnPolicyManifest(staticManifest: Record<string, unknown>, opts?: BuildCdnPolicyOpts): CdnPolicyManifest;
 /**
  * Write CDN policy + adapter projections under dist/_vmz.
@@ -165,7 +171,7 @@ export declare function projectCdnAdapter(policy: CdnPolicyManifest, adapterId:
  * @param {{ host?: string, port?: number }} [opts]
  * @returns {Promise<{ host: string, port: number, baseUrl: string, close: () => Promise<void> }>}
  */
-export declare function listenLocalStaticHost(distDir: string, policy: Record<string, unknown>, opts?: LocalStaticHostOpts): Promise<unknown>;
+export declare function listenLocalStaticHost(distDir: string, policy: Record<string, unknown>, opts?: LocalStaticHostOpts): Promise<LocalStaticHost>;
 /**
  * @param {string} distDir
  * @param {Record<string, any>} policy

package/dist/workspace/delivery-runtime-imports.js

@@ -22,6 +22,7 @@ function rewriteFlatDeliveryImports(text) {
         ['../browser/unknown-component.js', './unknown-component.js'],
         ['../shared/dom-attr-normalize.js', './dom-attr-normalize.js'],
         ['../shared/html-digest.js', './html-digest.js'],
+        ['../shared/row-key.js', './row-key.js'],
         ['../browser/client-nav.js', './vmz-client-nav.js'],
         ['../ssr/dom-ssr.js', './dom-ssr.js'],
         ['../faces/server.js', './vmz-runtime.js'],
@@ -39,6 +40,7 @@ function rewriteNestedSsrDelivery(text) {
     // reach the root copy one level up.
     out = replaceImportPath(out, '../shared/dom-attr-normalize.js', '../dom-attr-normalize.js');
     out = replaceImportPath(out, '../shared/html-digest.js', '../html-digest.js');
+    out = replaceImportPath(out, '../shared/row-key.js', '../row-key.js');
     for (const [from, to] of [
         ['../browser/dom-core.js', '../dom-core.js'],
         ['../browser/direct-host-box.js', '../direct-host-box.js'],
@@ -51,6 +53,7 @@ function rewriteNestedSsrDelivery(text) {
 function rewriteNestedBrowserDelivery(text) {
     let out = replaceImportPath(text, '../../shared/dom-attr-normalize.js', '../../dom-attr-normalize.js');
     out = replaceImportPath(out, '../../shared/html-digest.js', '../../html-digest.js');
+    out = replaceImportPath(out, '../../shared/row-key.js', '../../row-key.js');
     // `dom-ssr.js` 只交付在根（flat barrel），nested `ssr/` 下没有它：
     // island resume 的动态边必须指向根级产物。
     out = replaceImportPath(out, '../../ssr/dom-ssr.js', '../../dom-ssr.js');

package/locales/en-US/diag.json

@@ -10,6 +10,7 @@
     "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::v_model_invalid_target": "`v-model` target must be an assignable identifier or member expression: `{expr}`",
     "vmz::template::v_model_on_file_input": "`v-model` cannot bind an `<input type=\"file\">`",
     "vmz::template::each_missing_key": "`v-for` on `<{tag}>` should declare a `:key`",

package/locales/zh-CN/diag.json

@@ -6,6 +6,7 @@
     "vmz::template::illegal_directive": "`<template>` 中存在非法或不支持的指令：{detail}",
     "vmz::template::parse_failed": "解析 `<template>` 失败：{detail}",
     "vmz::template::invalid_expr": "模板表达式无效：{detail}",
+
     "vmz::template::v_model_invalid_target": "`v-model` 的目标必须是可赋值的标识符或成员表达式：`{expr}`",
     "vmz::template::v_model_on_file_input": "`v-model` 不能绑定到 `<input type=\"file\">`",
     "vmz::template::each_missing_key": "`<{tag}>` 上的 `v-for` 应声明 `:key`",

package/package.json

@@ -3,23 +3,23 @@
     "vmz": "./bin/vmz.js"
   },
   "dependencies": {
-    "@vmz/commander": "0.3.14",
-    "@vmz/core": "0.3.14",
-    "@vmz/diagnostic": "0.3.14",
-    "@vmz/plugin": "0.3.14",
-    "@vmz/protocol": "0.3.14"
+    "@vmz/commander": "0.3.15",
+    "@vmz/core": "0.3.15",
+    "@vmz/diagnostic": "0.3.15",
+    "@vmz/plugin": "0.3.15",
+    "@vmz/protocol": "0.3.15"
   },
   "description": "VMZ Node toolchain — N-API workspace session + CLI (publish name @vmz/vmz)",
   "devDependencies": {
     "@types/node": "^22.15.0",
-    "@vmz/plugin": "0.3.14",
-    "@vmz/plugin-katex": "0.3.14",
-    "@vmz/plugin-markdown-it": "0.3.14",
-    "@vmz/plugin-shiki": "0.3.14",
-    "@vmz/test": "0.3.14",
+    "@vmz/plugin": "0.3.15",
+    "@vmz/plugin-katex": "0.3.15",
+    "@vmz/plugin-markdown-it": "0.3.15",
+    "@vmz/plugin-shiki": "0.3.15",
+    "@vmz/test": "0.3.15",
     "linkedom": "^0.18.13",
     "typescript": "^5.8.3",
-    "vmz-plugin-conformance": "0.3.14"
+    "vmz-plugin-conformance": "0.3.15"
   },
   "engines": {
     "node": ">=24.12.0"
@@ -80,16 +80,16 @@
   "main": "./dist/index.js",
   "name": "@vmz/vmz",
   "optionalDependencies": {
-    "@vmz/vmz-darwin-arm64": "0.3.14",
-    "@vmz/vmz-darwin-x64": "0.3.14",
-    "@vmz/vmz-linux-arm64": "0.3.14",
-    "@vmz/vmz-linux-x64": "0.3.14",
-    "@vmz/vmz-win32-arm64": "0.3.14",
-    "@vmz/vmz-win32-x64": "0.3.14"
+    "@vmz/vmz-darwin-arm64": "0.3.15",
+    "@vmz/vmz-darwin-x64": "0.3.15",
+    "@vmz/vmz-linux-arm64": "0.3.15",
+    "@vmz/vmz-linux-x64": "0.3.15",
+    "@vmz/vmz-win32-arm64": "0.3.15",
+    "@vmz/vmz-win32-x64": "0.3.15"
   },
   "peerDependencies": {
-    "@vmz/plugin-markdown-it": "0.3.14",
-    "@vmz/test": "0.3.14",
+    "@vmz/plugin-markdown-it": "0.3.15",
+    "@vmz/test": "0.3.15",
     "typescript": "^5.8.3"
   },
   "peerDependenciesMeta": {
@@ -122,5 +122,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.3.14"
+  "version": "0.3.15"
 }