@vmz/vmz 0.1.18 → 0.1.20

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/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

@@ -2,8 +2,11 @@
  * `vmz test` command — discovery / build / filter / TestReport orchestration.
  * Semantics live in `@vmz/test` (optional peer — not installed with bare `@vmz/vmz`).
  */
+import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 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) {
@@ -37,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, } = test;
+    const { discoverTestManifests, buildTestReport, parseModes, runCompileManifest, runLogicManifest, runSsrManifest, runResumeManifest, runBrowserManifest, runDeploymentManifest, resolveDeliveryServeRoot, } = test;
     const project = path.resolve(String(args._[0] || '.'));
     let modes;
     try {
@@ -170,16 +173,30 @@ export async function cmdTest(args) {
         let buildOut = null;
         let buildDiags = [];
         let buildError = null;
+        let deliveryName = null;
         if (needsBuild) {
-            const built = buildForCompile(project, outDirArg ? path.resolve(outDirArg) : undefined, {
-                createWorkspace,
-            });
-            buildOut = built.outDir;
+            // 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-'));
+            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) {
@@ -256,7 +273,10 @@ export async function cmdTest(args) {
                 base.planId = result.planId ?? base.planId;
             }
             if (doBrowser) {
-                const result = await runBrowserManifest(m, { outDir: buildOut });
+                const result = await runBrowserManifest(m, {
+                    outDir: buildOut,
+                    deliveryName,
+                });
                 statuses.push(result.status);
                 diags.push(...result.diagnostics);
                 base.programId = result.programId ?? base.programId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/vmz",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "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.18",
-    "@vmz/core": "0.1.18",
-    "@vmz/diagnostic": "0.1.18",
-    "@vmz/plugin": "0.1.18",
-    "@vmz/protocol": "0.1.18",
+    "@vmz/commander": "0.1.20",
+    "@vmz/core": "0.1.20",
+    "@vmz/diagnostic": "0.1.20",
+    "@vmz/plugin": "0.1.20",
+    "@vmz/protocol": "0.1.20",
     "jiti": "^2.6.1"
   },
   "peerDependencies": {
-    "@vmz/plugin-markdown-it": "0.1.18",
-    "@vmz/test": "0.1.18",
+    "@vmz/plugin-markdown-it": "0.1.20",
+    "@vmz/test": "0.1.20",
     "typescript": "^5.8.3"
   },
   "peerDependenciesMeta": {
@@ -92,12 +92,12 @@
     "cli"
   ],
   "optionalDependencies": {
-    "@vmz/vmz-win32-x64": "0.1.18",
-    "@vmz/vmz-win32-arm64": "0.1.18",
-    "@vmz/vmz-darwin-x64": "0.1.18",
-    "@vmz/vmz-darwin-arm64": "0.1.18",
-    "@vmz/vmz-linux-x64": "0.1.18",
-    "@vmz/vmz-linux-arm64": "0.1.18"
+    "@vmz/vmz-win32-x64": "0.1.20",
+    "@vmz/vmz-win32-arm64": "0.1.20",
+    "@vmz/vmz-darwin-x64": "0.1.20",
+    "@vmz/vmz-darwin-arm64": "0.1.20",
+    "@vmz/vmz-linux-x64": "0.1.20",
+    "@vmz/vmz-linux-arm64": "0.1.20"
   },
   "publishConfig": {
     "access": "public"