@vmz/vmz 0.3.13 → 0.3.15

package/bin/vmz.js

@@ -9,4 +9,8 @@ if (major < 24 || (major === 24 && minor < 12)) {
 }
 const { runCli } = await import('../dist/cli/cli.js');
 const code = await runCli(process.argv.slice(2));
+// POSIX pipes flush asynchronously, so `process.exit` can drop queued
+// diagnostics before CI captures them. Drain both streams first.
+await new Promise((resolve) => process.stderr.write('', resolve));
+await new Promise((resolve) => process.stdout.write('', resolve));
 process.exit(code ?? 0);

package/delivery-runtime-files.json

@@ -11,6 +11,8 @@
         { "src": "browser/direct-host-box.js", "out": "direct-host-box.js" },
         { "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/dev/dev-incremental.d.ts

@@ -36,14 +36,12 @@ export interface DevReloadPayload {
     islandHmr?: boolean;
     rerunLoaders?: string[];
     staticRevision?: string;
-    skipEntryRewrite?: boolean;
     outputRevision?: string;
 }
 export declare function parseHmrPlan(raw: string | object | null | undefined): HmrPlanWire | null;
 export declare function hmrRerunLoaders(plan: HmrPlanWire | null | undefined): string[];
 export declare function buildReloadPayload(report: BuildReportWire, hmrPlan: HmrPlanWire | null, opts?: {
     staticRevision?: string;
-    skipEntryRewrite?: boolean;
 }): DevReloadPayload;
 export declare function shouldSoftReload(report: BuildReportWire, lastOutputRevision: string | null, opts?: {
     force?: boolean;

package/dist/dev/dev-incremental.js

@@ -38,7 +38,6 @@ export function buildReloadPayload(report, hmrPlan, opts = {}) {
         islandHmr: islandHmr && !full,
         rerunLoaders,
         staticRevision: opts.staticRevision,
-        skipEntryRewrite: opts.skipEntryRewrite,
         outputRevision: report.outputRevision ?? report.output_revision,
     };
 }

package/dist/dev/dev-session.d.ts

@@ -11,6 +11,7 @@
  */
 import { createWorkspace } from '../workspace/public-api.js';
 import { type ConfigCycle } from './config-cycle.js';
+import { packFromDeploymentIr } from '../workspace/pack.js';
 interface DevSessionOptions {
     project: string;
     outDir: string;
@@ -28,7 +29,9 @@ interface DevSessionOptions {
         host: string;
         port: number;
     }) => import('node:child_process').ChildProcess;
-    softReloadFn?: (host: string, port: number, payload?: object) => Promise<void>;
+    softReloadFn?: (body: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    /** Test seam for the browser pack stage (defaults to `packFromDeploymentIr`). */
+    packFn?: typeof packFromDeploymentIr;
     /** Override the detached config build process (tests). */
     configCycleFn?: (opts: {
         project: string;
@@ -38,6 +41,55 @@ interface DevSessionOptions {
     /** Built config cycle worker path (defaults to `dist/dev/config-cycle-worker.js`). */
     configCycleWorkerPath?: string;
 }
+export interface PackManifestView {
+    chunks?: Array<{
+        fileName?: string;
+        sourceMap?: string;
+        modules?: unknown[];
+    }>;
+    styles?: Array<{
+        fileName?: string;
+        sourcePaths?: unknown[];
+    }>;
+    assets?: Array<{
+        fileName?: string;
+    }>;
+    entryFiles?: Array<{
+        file?: string;
+    }>;
+    dynamicFiles?: Array<{
+        from?: string;
+        to?: string;
+    }>;
+    unitChunks?: Array<{
+        fileName?: string | null;
+    }>;
+}
+export interface PackInputSnapshot {
+    files: Array<{
+        path: string;
+        digest: string;
+    }>;
+    listings: Array<{
+        dir: string;
+        names: string[];
+    }>;
+    deploymentOrigins: string;
+    lockfile: {
+        path: string;
+        digest: string;
+    };
+    manifest: {
+        path: string;
+        digest: string;
+    };
+}
+/** 记下决定 pack 产物的全部输入；任何一项取不到就放弃快照（等同于永远重打包）。 */
+export declare function capturePackInputSnapshot(manifest: PackManifestView, outDir: string, project: string): PackInputSnapshot | null;
+/** 返回 null 表示全部输入字节全等；否则返回第一个变化原因。 */
+export declare function packInputsChangedReason(snapshot: PackInputSnapshot, outDir: string): string | null;
+/** 复用上次 manifest 前确认 entry/chunk/island 查表指向的文件仍在盘上；缺任何一个就退回真实 pack。 */
+export declare function missingPackOutput(manifest: PackManifestView, outDir: string): string | null;
 export declare function createDevSession(options: DevSessionOptions): {
     ws: any;
     rebuild: (changes?: Array<{