@vmz/vmz 0.1.16 → 0.1.18

package/dist/static-emit.d.ts

@@ -3,64 +3,51 @@
  * Reuses the same Direct SSR path as serve-host (no second SSG runtime).
  */
 export declare const STATIC_DELIVERY_MANIFEST_SCHEMA = "vmz.static.delivery_manifest.v0";
-/**
- * @param {string} distDir
- * @param {{
- *   origin?: string,
- *   applicationId?: string,
- *   staticParams?: Record<string, Array<Record<string, string>>>,
- * }} [opts]
- */
-export declare function emitWebStatic(distDir: any, opts?: {}): Promise<{
-    manifest: {
-        schema: string;
-        applicationId: any;
-        deliveryProfile: string;
-        origin: string;
-        generatedAt: string;
-        spaFallback: boolean;
-        errorDocuments: {
-            status: number;
-            path: string;
-        }[];
-        routes: {
-            routeId: any;
-            path: any;
-            chunkId: any;
-            htmlPath: any;
-            classification: any;
-            localeId: any;
-            seo: {
-                title: any;
-                description: any;
-                canonical: any;
-                robots: any;
-                alternates: any;
-            };
-        }[];
-        skipped: any[];
-        seoArtifacts: {
-            sitemap: string;
-            robots: string;
-        };
-        publicAssets: {
-            schema: string;
-            status: string;
-            fileCount: number;
-            source: any;
-        };
+export type EmitWebStaticOpts = {
+    origin?: string;
+    applicationId?: string;
+    staticParams?: Record<string, Array<Record<string, string>>>;
+    projectRoot?: string;
+};
+type StaticDeliveryManifest = {
+    schema: string;
+    applicationId: unknown;
+    deliveryProfile: string;
+    origin: string;
+    generatedAt: string;
+    spaFallback: boolean;
+    errorDocuments: Array<{
+        status: number;
+        path: string;
+    }>;
+    routes: unknown[];
+    skipped: unknown[];
+    seoArtifacts: {
+        sitemap: string;
+        robots: string;
     };
-    htmlFiles: any[];
-    skipped: any[];
-    digest: any;
-    assets: {
-        schema: string;
-        layout: string;
-        immutable: boolean;
-        objectCount: number;
-        objects: any[];
-        rewrittenHtml: number;
+    publicAssets: {
+        schema: unknown;
+        status: unknown;
+        fileCount: number;
+        source: string | null;
     };
+    manifestDigest?: string;
+    contentAddressedAssets?: Record<string, unknown>;
+    cdnPolicy?: unknown;
+};
+export declare function emitWebStatic(distDir: string, opts?: EmitWebStaticOpts): Promise<{
+    manifest: StaticDeliveryManifest;
+    htmlFiles: string[];
+    skipped: {
+        routeId: string;
+        path: string;
+        chunkId: string;
+        classification: string;
+        reason: string;
+    }[];
+    digest: string;
+    assets: import("./content-addressed-assets.js").ContentAddressedAssetsManifest;
     publicAssets: {
         schema: string;
         status: string;
@@ -76,47 +63,20 @@ export declare function emitWebStatic(distDir: any, opts?: {}): Promise<{
         files: any[];
         skippedConflicts: any[];
     };
-    cdnPolicy: {
-        schema: string;
-        applicationId: any;
-        deliveryProfile: string;
-        origin: string;
-        spaFallback: boolean;
-        staticManifestDigest: any;
-        redirects: any[];
-        headers: ({
-            match: string;
-            headers: {
-                'cache-control': string;
-                'x-robots-tag'?: undefined;
-            };
-        } | {
-            match: string;
-            headers: {
-                'cache-control': string;
-                'x-robots-tag': string;
-            };
-        })[];
-        errorDocuments: any;
-        routes: any[];
-        localeCache: {
-            strategy: string;
-            varyAcceptLanguage: boolean;
-            defaultLocale: any;
-            routeCount: number;
-            locales: any[];
-        };
-    };
+    cdnPolicy: import("./cdn-policy.js").CdnPolicyManifest;
     cdnAdapters: {
         'local-static': {
             schema: string;
             adapterId: string;
-            policyDigest: any;
+            policyDigest: string;
             host: string;
             spaFallback: boolean;
-            redirects: any;
-            headers: any;
-            errorDocuments: any;
+            redirects: import("./cdn-policy.js").CdnRedirect[];
+            headers: {
+                match: string;
+                headers: Record<string, string | undefined>;
+            }[];
+            errorDocuments: unknown[];
             files: {
                 _headers?: undefined;
                 _redirects?: undefined;
@@ -124,12 +84,15 @@ export declare function emitWebStatic(distDir: any, opts?: {}): Promise<{
         } | {
             schema: string;
             adapterId: string;
-            policyDigest: any;
+            policyDigest: string;
             host: string;
             spaFallback: boolean;
-            redirects: any;
-            headers: any;
-            errorDocuments: any;
+            redirects: import("./cdn-policy.js").CdnRedirect[];
+            headers: {
+                match: string;
+                headers: Record<string, string | undefined>;
+            }[];
+            errorDocuments: unknown[];
             files: {
                 _headers: string;
                 _redirects: string;
@@ -138,12 +101,15 @@ export declare function emitWebStatic(distDir: any, opts?: {}): Promise<{
         netlify: {
             schema: string;
             adapterId: string;
-            policyDigest: any;
+            policyDigest: string;
             host: string;
             spaFallback: boolean;
-            redirects: any;
-            headers: any;
-            errorDocuments: any;
+            redirects: import("./cdn-policy.js").CdnRedirect[];
+            headers: {
+                match: string;
+                headers: Record<string, string | undefined>;
+            }[];
+            errorDocuments: unknown[];
             files: {
                 _headers?: undefined;
                 _redirects?: undefined;
@@ -151,12 +117,15 @@ export declare function emitWebStatic(distDir: any, opts?: {}): Promise<{
         } | {
             schema: string;
             adapterId: string;
-            policyDigest: any;
+            policyDigest: string;
             host: string;
             spaFallback: boolean;
-            redirects: any;
-            headers: any;
-            errorDocuments: any;
+            redirects: import("./cdn-policy.js").CdnRedirect[];
+            headers: {
+                match: string;
+                headers: Record<string, string | undefined>;
+            }[];
+            errorDocuments: unknown[];
             files: {
                 _headers: string;
                 _redirects: string;
@@ -164,3 +133,4 @@ export declare function emitWebStatic(distDir: any, opts?: {}): Promise<{
         };
     };
 }>;
+export {};

package/dist/static-emit.js

@@ -2,7 +2,6 @@
  * A3-static: emit per-route HTML + 404 + SEO head + StaticDeliveryManifest.
  * Reuses the same Direct SSR path as serve-host (no second SSG runtime).
  */
-// @ts-nocheck
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -19,14 +18,6 @@ import { emitPublicStaticAssets } from './public-static-assets.js';
 import { filePathPatternFromChunk, isRouteBoundaryStem, 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';
-/**
- * @param {string} distDir
- * @param {{
- *   origin?: string,
- *   applicationId?: string,
- *   staticParams?: Record<string, Array<Record<string, string>>>,
- * }} [opts]
- */
 export async function emitWebStatic(distDir, opts = {}) {
     const origin = String(opts.origin || process.env.VMZ_SITE_ORIGIN || 'https://example.test').replace(/\/$/, '');
     const applicationId = opts.applicationId || path.basename(path.dirname(distDir));
@@ -40,19 +31,7 @@ export async function emitWebStatic(distDir, opts = {}) {
     const host = await createRenderHost(distDir, { strictDeployment: true, preload: 'none' });
     const { renderToString, renderToStream } = host;
     const pageCatalog = listPageClientFiles(distDir);
-    /** @type {Array<{
-     *   routeId: string,
-     *   path: string,
-     *   chunkId: string,
-     *   htmlPath: string,
-     *   classification: string,
-     *   title: string,
-     *   description: string,
-     *   canonical: string,
-     *   robots: string,
-     * }>} */
     const generations = [];
-    /** @type {Array<{ routeId: string, path: string, chunkId: string, classification: string, reason: string }>} */
     const skipped = [];
     for (const page of pageCatalog) {
         const pattern = page.pathPattern || patternFromSegs(page.segs);
@@ -227,7 +206,7 @@ export async function emitWebStatic(distDir, opts = {}) {
             schema: publicAssets.schema,
             status: publicAssets.status,
             fileCount: publicAssets.fileCount ?? 0,
-            source: publicAssets.source || null,
+            source: 'source' in publicAssets && typeof publicAssets.source === 'string' ? publicAssets.source : null,
         },
     };
     const digest = sha256Hex(canonicalJson(manifest));
@@ -384,10 +363,6 @@ function guessRouteId(distDir, chunkId) {
     }
     return chunkId.split('/').pop() || chunkId;
 }
-/**
- * @param {any} Page
- * @param {{ params: Record<string, string>, props: Record<string, unknown>, pathname: string, origin: string }} ctx
- */
 async function resolvePageMeta(Page, ctx) {
     let raw = {};
     if (typeof Page.meta === 'function') {

package/dist/test-cmd.d.ts

@@ -2,8 +2,6 @@
  * `vmz test` command — discovery / build / filter / TestReport orchestration.
  * Semantics live in `@vmz/test` (optional peer — not installed with bare `@vmz/vmz`).
  */
-/**
- * @param {Record<string, string | boolean> & { _: string[] }} args
- * @returns {Promise<number>}
- */
-export declare function cmdTest(args: any): Promise<0 | 1 | 2>;
+import type { Cli, Command, ParsedOptions } from '@vmz/commander';
+export declare function registerTestCommand(cli: Cli | Command): void;
+export declare function cmdTest(args: ParsedOptions): Promise<number>;

package/dist/test-cmd.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * `vmz test` command — discovery / build / filter / TestReport orchestration.
  * Semantics live in `@vmz/test` (optional peer — not installed with bare `@vmz/vmz`).
@@ -7,9 +6,19 @@ import path from 'node:path';
 import { createWorkspace } from './index.js';
 import { log } from './log.js';
 import { generatePrettyJson } from './pretty-json.js';
-/**
- * @returns {Promise<typeof import('@vmz/test')>}
- */
+export function registerTestCommand(cli) {
+    cli.command('test', 'cli.cmd.test')
+        .option('--out-dir, -o <dir>', 'cli.opt.out-dir')
+        .option('--list', 'cli.opt.list')
+        .option('--json [file]', 'cli.opt.json')
+        .option('--mode <modes>', 'cli.opt.mode')
+        .option('--filter <pattern>', 'cli.opt.filter')
+        .option('--application <id>', 'cli.opt.application')
+        .option('--mounted <id>', 'cli.opt.mounted')
+        .option('--affected', 'cli.opt.affected')
+        .option('--target <id>', 'cli.opt.target')
+        .action((options) => cmdTest(options));
+}
 async function loadTestPackage() {
     try {
         return await import('@vmz/test');
@@ -19,10 +28,6 @@ async function loadTestPackage() {
         throw new Error('`vmz test` needs `@vmz/test` (optional peer of `@vmz/vmz`).\n' + '  Install:  pnpm add -D @vmz/test\n' + `  Detail: ${detail}`);
     }
 }
-/**
- * @param {Record<string, string | boolean> & { _: string[] }} args
- * @returns {Promise<number>}
- */
 export async function cmdTest(args) {
     let test;
     try {
@@ -36,7 +41,7 @@ export async function cmdTest(args) {
     const project = path.resolve(String(args._[0] || '.'));
     let modes;
     try {
-        modes = parseModes(/** @type {string|boolean|undefined} */ (args.mode));
+        modes = parseModes(args.mode);
     }
     catch (e) {
         log.error(e instanceof Error ? e.message : String(e));
@@ -88,7 +93,6 @@ export async function cmdTest(args) {
             return file.includes(scopeId) || id.includes(scopeId);
         });
     }
-    /** @type {null | { schema: string, reason: string, testIds: string[], affectedChunkIds: string[], status: string }} */
     let testSelection = null;
     if (wantAffected) {
         const outDir = outDirArg ? path.resolve(outDirArg) : path.join(project, 'dist');
@@ -135,15 +139,6 @@ export async function cmdTest(args) {
     else if (!modes.includes('all')) {
         selected = selected.filter((m) => Array.isArray(m.modes) && m.modes.some((x) => modes.includes(x)));
     }
-    /** @type {Array<{
-     * testId: string,
-     * file: string,
-     * modes: string[],
-     * programId: string|null,
-     * planId: string|null,
-     * status: string,
-     * diagnostics: unknown[],
-     * }>} */
     let tests;
     if (wantList) {
         tests = selected.map((m) => {
@@ -172,11 +167,8 @@ export async function cmdTest(args) {
                     (mm.includes('browser') && modeActive('browser')) ||
                     (mm.includes('deployment') && modeActive('deployment')));
             });
-        /** @type {string|null} */
         let buildOut = null;
-        /** @type {unknown[]} */
         let buildDiags = [];
-        /** @type {string|null} */
         let buildError = null;
         if (needsBuild) {
             const built = buildForCompile(project, outDirArg ? path.resolve(outDirArg) : undefined, {
@@ -201,7 +193,7 @@ export async function cmdTest(args) {
                 programId: program.chunkId ? String(program.chunkId) : null,
                 planId: plan.ref ? String(plan.ref) : plan.schema ? String(plan.schema) : null,
                 status: 'skipped',
-                diagnostics: /** @type {unknown[]} */ ([]),
+                diagnostics: [],
             };
             const doCompile = mModes.includes('compile') && modeActive('compile');
             const doLogic = mModes.includes('logic') && modeActive('logic');
@@ -226,9 +218,7 @@ export async function cmdTest(args) {
                 tests.push(base);
                 continue;
             }
-            /** @type {unknown[]} */
             const diags = [];
-            /** @type {string[]} */
             const statuses = [];
             if (doCompile) {
                 const result = runCompileManifest(m, { outDir: buildOut });

package/dist/test-compile.js

@@ -1,3 +1,2 @@
-// @ts-nocheck
 /** @deprecated Import from `@vmz/test` — transitional re-export. */
 export { buildForCompile, resolveChunkArtifacts, runCompileManifest, } from '@vmz/test';

package/dist/test-discover.js

@@ -1,3 +1,2 @@
-// @ts-nocheck
 /** @deprecated Import from `@vmz/test` — transitional re-export. */
 export * from '@vmz/test/discover';

package/dist/test-logic.js

@@ -1,3 +1,2 @@
-// @ts-nocheck
 /** @deprecated Import from `@vmz/test` — transitional re-export. */
 export { createLogicHost, runLogicManifest, installHeadlessDocument } from '@vmz/test';

package/dist/test-protocol.js

@@ -1,3 +1,2 @@
-// @ts-nocheck
 /** @deprecated Import from `@vmz/test` — transitional re-export. */
 export * from '@vmz/test/protocol';

package/dist/toolchain-dx.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Product wiring for `@vmz/commander` / `@vmz/diagnostic`.
+ *
+ * Locales **loading** is `@vmz/commander` (`createLocalizeFromLocales` / `.locales`).
+ * Product owns only `packages/runtimes/vmz/locales/` content + thin `cli-localize` wrapper.
+ * Help lists are derived from the command tree — do not reintroduce Usage walls.
+ */
+export { createCli } from '@vmz/commander';
+export type { LocalizePlugin } from '@vmz/commander';
+export { VMZ_CLI_CATALOG_EN_US, createVmzCliLocalize, flattenCatalog, loadCliCatalog, loadCliLocalesManifest, resolveCliLocalesRoot, resolveVmzLocale, translateCatalog, vmzCliLocalize, } from './cli-localize.js';
+export { formatDiagnostic, formatDiagnostics, t, } from '@vmz/diagnostic';

package/dist/toolchain-dx.js

@@ -0,0 +1,10 @@
+/**
+ * Product wiring for `@vmz/commander` / `@vmz/diagnostic`.
+ *
+ * Locales **loading** is `@vmz/commander` (`createLocalizeFromLocales` / `.locales`).
+ * Product owns only `packages/runtimes/vmz/locales/` content + thin `cli-localize` wrapper.
+ * Help lists are derived from the command tree — do not reintroduce Usage walls.
+ */
+export { createCli } from '@vmz/commander';
+export { VMZ_CLI_CATALOG_EN_US, createVmzCliLocalize, flattenCatalog, loadCliCatalog, loadCliLocalesManifest, resolveCliLocalesRoot, resolveVmzLocale, translateCatalog, vmzCliLocalize, } from './cli-localize.js';
+export { formatDiagnostic, formatDiagnostics, t, } from '@vmz/diagnostic';

package/dist/watch-diff.d.ts

@@ -1,17 +1,8 @@
 /**
  * Track per-file fingerprints so dev rebuilds only dirty leaves (session).
  */
-/**
- * @param {string} srcDir
- * @returns {Map<string, string>}
- */
-export declare function fileFingerprintMap(srcDir: any): Map<any, any>;
-/**
- * @param {Map<string, string>} prev
- * @param {Map<string, string>} next
- * @returns {{ changed: string[], deleted: string[] }}
- */
-export declare function diffFingerprints(prev: any, next: any): {
-    changed: any[];
-    deleted: any[];
+export declare function fileFingerprintMap(srcDir: string): Map<string, string>;
+export declare function diffFingerprints(prev: Map<string, string>, next: Map<string, string>): {
+    changed: string[];
+    deleted: string[];
 };

package/dist/watch-diff.js

@@ -1,16 +1,10 @@
-// @ts-nocheck
 /**
  * Track per-file fingerprints so dev rebuilds only dirty leaves (session).
  */
 import { existsSync, readdirSync, statSync } from 'node:fs';
 import path from 'node:path';
 const WATCH_EXT = new Set(['.vmz', '.ts', '.tsx', '.js', '.mjs', '.css', '.json']);
-/**
- * @param {string} srcDir
- * @returns {Map<string, string>}
- */
 export function fileFingerprintMap(srcDir) {
-    /** @type {Map<string, string>} */
     const map = new Map();
     walk(srcDir, (file) => {
         const st = statSync(file);
@@ -18,15 +12,8 @@ export function fileFingerprintMap(srcDir) {
     });
     return map;
 }
-/**
- * @param {Map<string, string>} prev
- * @param {Map<string, string>} next
- * @returns {{ changed: string[], deleted: string[] }}
- */
 export function diffFingerprints(prev, next) {
-    /** @type {string[]} */
     const changed = [];
-    /** @type {string[]} */
     const deleted = [];
     for (const [file, fp] of next) {
         if (prev.get(file) !== fp)
@@ -38,10 +25,6 @@ export function diffFingerprints(prev, next) {
     }
     return { changed, deleted };
 }
-/**
- * @param {string} dir
- * @param {(file: string) => void} fn
- */
 function walk(dir, fn) {
     if (!existsSync(dir))
         return;

package/dist/wechat-packaging.d.ts

@@ -8,15 +8,16 @@ export declare const WECHAT_PACKAGING_REL = "dist/_vmz/wechat-packaging.json";
  * @param {unknown} delivery
  * @returns {{ schema: string, appId: string, projectName?: string, title?: string }}
  */
-export declare function wechatPackagingFromDelivery(delivery: any): {
+interface WechatPackagingSpec {
     schema: string;
-    appId: any;
-};
+    appId: string;
+    projectName?: string;
+    title?: string;
+}
+export declare function wechatPackagingFromDelivery(delivery: unknown): WechatPackagingSpec;
 /**
  * Load `vmz.config.*` and write the WeChat packaging contract for the Rust packer.
  * @param {string} project
  */
-export declare function materializeWechatPackaging(project: any): {
-    schema: string;
-    appId: any;
-};
+export declare function materializeWechatPackaging(project: any): WechatPackagingSpec;
+export {};

package/dist/wechat-packaging.js

@@ -2,7 +2,6 @@
  * Materialize `defineConfig({ delivery: { packaging: { wechat } } })` for wechat_pack.
  * Pure data only. Writes `dist/_vmz/wechat-packaging.json` (not a second config entry).
  */
-// @ts-nocheck
 import { existsSync, mkdirSync } from 'node:fs';
 import path from 'node:path';
 import { createJiti } from 'jiti';
@@ -24,15 +23,10 @@ function loadConfigSync(project) {
     }
     return null;
 }
-/**
- * @param {unknown} delivery
- * @returns {{ schema: string, appId: string, projectName?: string, title?: string }}
- */
 export function wechatPackagingFromDelivery(delivery) {
     const diagnostics = [];
     const packaging = pickDeliveryPackaging(delivery && typeof delivery === 'object' ? delivery : {}, diagnostics);
     const wechat = packaging && packaging.wechat ? packaging.wechat : {};
-    /** @type {{ schema: string, appId: string, projectName?: string, title?: string }} */
     const out = {
         schema: WECHAT_PACKAGING_SCHEMA,
         appId: typeof wechat.appId === 'string' && wechat.appId.trim() ? wechat.appId.trim() : 'touristappid',