@vmz/vmz 0.1.17 → 0.1.18

package/dist/native-addon.d.ts

@@ -1,9 +1,10 @@
-/**
- * Load the N-API addon or throw (production printers must not fall back to TS).
- * @returns {any}
- */
-export declare function requireNativeAddon(): any;
-/**
- * @returns {any | null}
- */
-export declare function tryLoadNativeAddon(): any;
+export interface NativeAddon {
+    generatePrettyJson?: (json: string) => string;
+    authorJson5ToCanonicalJson?: (source: string) => string;
+    loadLocalePlan?: (projectRoot: string) => string;
+    loadDocumentRoutePlan?: (projectRoot: string) => string;
+    [key: string]: unknown;
+}
+/** Load the N-API addon or throw (production printers must not fall back to TS). */
+export declare function requireNativeAddon(): NativeAddon;
+export declare function tryLoadNativeAddon(): NativeAddon | null;

package/dist/native-addon.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Load the N-API `.node` addon without importing `index.js`
  * (avoids cycles with modules re-exported from the package entry).
@@ -8,12 +7,8 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 const require = createRequire(import.meta.url);
-/** @type {any} */
 let cached;
-/**
- * Load the N-API addon or throw (production printers must not fall back to TS).
- * @returns {any}
- */
+/** Load the N-API addon or throw (production printers must not fall back to TS). */
 export function requireNativeAddon() {
     const native = tryLoadNativeAddon();
     if (!native) {
@@ -21,9 +16,6 @@ export function requireNativeAddon() {
     }
     return native;
 }
-/**
- * @returns {any | null}
- */
 export function tryLoadNativeAddon() {
     if (cached !== undefined)
         return cached;
@@ -58,7 +50,6 @@ export function tryLoadNativeAddon() {
                         : triple;
         const pkgRoot = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
         const name = `@vmz/vmz-${short}`;
-        /** @type {string[]} */
         const candidates = [];
         try {
             const resolved = require.resolve(`${name}/package.json`);

package/dist/pack-client-packages.d.ts

@@ -12,7 +12,10 @@
  * @param {{ projectRoot?: string | null }} [opts]
  * @returns {{ rewrittenFiles: number, vendoredModules: string[], bareSpecs: string[] }}
  */
-export declare function packClientBareImports(outDir: any, opts?: {}): {
+interface PackClientBareImportsOpts {
+    projectRoot?: string | null;
+}
+export declare function packClientBareImports(outDir: string, opts?: PackClientBareImportsOpts): {
     rewrittenFiles: number;
     vendoredModules: string[];
     bareSpecs: any[];
@@ -23,3 +26,4 @@ export declare function packClientBareImports(outDir: any, opts?: {}): {
 /** @param {string} js */
 export declare function collectBareSpecs(js: any): unknown[];
 export declare function rewriteRelativeTsSpecs(js: any): any;
+export {};

package/dist/pack-client-packages.js

@@ -7,18 +7,12 @@
  *
  * Not full oxc chunk-split/minify (`oxc-pending` remains for release minify).
  */
-// @ts-nocheck
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { createRequire } from 'node:module';
 import { resolvePackageRoot } from './packages.js';
 const VENDOR_DIR = 'vendor';
 const SKIP_PREFIXES = ['node:', 'nodejs:', 'cloudflare:', 'data:', 'http:', 'https:', 'vmz:', '#'];
-/**
- * @param {string} outDir
- * @param {{ projectRoot?: string | null }} [opts]
- * @returns {{ rewrittenFiles: number, vendoredModules: string[], bareSpecs: string[] }}
- */
 export function packClientBareImports(outDir, opts = {}) {
     const projectRoot = opts.projectRoot ? path.resolve(opts.projectRoot) : path.dirname(path.resolve(outDir));
     /** @type {Map<string, string>} bareSpec → absolute vendored .js path */

package/dist/pack.d.ts

@@ -23,28 +23,29 @@ export declare function ensureRuntimeCompanions(outDir: any, coreDist: any): any
  *   projectRoot?: string | null,
  * }} [opts]
  */
-export declare function packFromDeploymentIr(outDir: any, opts?: {}): {
+interface PackFromDeploymentIrOpts {
+    release?: boolean;
+    profileId?: string;
+    assembly?: string;
+    preferredClientFace?: string;
+    coreDist?: string | null;
+    projectRoot?: string | null;
+}
+export declare function packFromDeploymentIr(outDir: string, opts?: PackFromDeploymentIrOpts): {
     manifest: {
         schema: string;
-        profileId: any;
-        assembly: any;
+        profileId: string | null;
+        assembly: string | null;
         release: boolean;
-        preferredClientFace: any;
-        deploymentSchema: any;
+        preferredClientFace: string;
+        deploymentSchema: unknown;
         unitCount: number;
-        units: any[];
+        units: unknown[];
         minify: string;
         treeShakeBasis: string;
         bundler: string;
-        clientPackageLowering: {
-            status: string;
-            rewrittenFiles: number;
-            bareSpecs: any[];
-            vendoredModules: string[];
-            unresolvedBareSpecs: any[];
-            skippedVmzExports: any[];
-            remainingBareSpecs: any[];
-        };
+        clientPackageLowering: Record<string, unknown>;
+        packDigest?: string;
     };
     path: string;
     clientPackages: {
@@ -56,3 +57,4 @@ export declare function packFromDeploymentIr(outDir: any, opts?: {}): {
         remainingBareSpecs: any[];
     };
 };
+export {};

package/dist/pack.js

@@ -3,7 +3,6 @@
  * and lower browser-unreachable bare package imports to `dist/vendor/**`.
  * Full oxc minify/chunk-split lands progressively (`oxc-pending` on release minify).
  */
-// @ts-nocheck
 import crypto from 'node:crypto';
 import { copyFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
@@ -33,17 +32,6 @@ export function ensureRuntimeCompanions(outDir, coreDist) {
     }
     return copied;
 }
-/**
- * @param {string} outDir
- * @param {{
- *   release?: boolean,
- *   profileId?: string,
- *   assembly?: string,
- *   preferredClientFace?: string,
- *   coreDist?: string | null,
- *   projectRoot?: string | null,
- * }} [opts]
- */
 export function packFromDeploymentIr(outDir, opts = {}) {
     ensureRuntimeCompanions(outDir, opts.coreDist);
     // Browser ESM cannot resolve bare npm specs — materialize reachable packages first

package/dist/packages.d.ts

@@ -1,26 +1,13 @@
 /**
  * npm / pnpm workspace package resolution helpers (session).
  */
-/**
- * @typedef {object} ResolvedPackage
- * @property {string} name
- * @property {string} root
- * @property {boolean} [private]
- * @property {boolean} hasSrc
- * @property {string} [version]
- */
-/**
- * Resolve workspace packages under a project (package.json workspaces or pnpm-workspace.yaml).
- * Does not invent VMZ semantics — only filesystem / npm layout facts for plugins.
- *
- * @param {string} project
- * @returns {ResolvedPackage[]}
- */
-export declare function resolveWorkspacePackages(project: any): any[];
-/**
- * Resolve a package name to an absolute root (workspace first, then node_modules).
- * @param {string} project
- * @param {string} name
- * @returns {string | null}
- */
-export declare function resolvePackageRoot(project: any, name: any): any;
+export interface ResolvedPackage {
+    name: string;
+    root: string;
+    private?: boolean;
+    hasSrc: boolean;
+    version?: string;
+}
+/** Resolve workspace packages under a project (package.json workspaces or pnpm-workspace.yaml). */
+export declare function resolveWorkspacePackages(project: string): ResolvedPackage[];
+export declare function resolvePackageRoot(project: string, name: string): string | null;

package/dist/packages.js

@@ -1,28 +1,12 @@
-// @ts-nocheck
 /**
  * npm / pnpm workspace package resolution helpers (session).
  */
 import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import path from 'node:path';
-/**
- * @typedef {object} ResolvedPackage
- * @property {string} name
- * @property {string} root
- * @property {boolean} [private]
- * @property {boolean} hasSrc
- * @property {string} [version]
- */
-/**
- * Resolve workspace packages under a project (package.json workspaces or pnpm-workspace.yaml).
- * Does not invent VMZ semantics — only filesystem / npm layout facts for plugins.
- *
- * @param {string} project
- * @returns {ResolvedPackage[]}
- */
+/** Resolve workspace packages under a project (package.json workspaces or pnpm-workspace.yaml). */
 export function resolveWorkspacePackages(project) {
     const root = path.resolve(project);
     const patterns = readWorkspacePatterns(root);
-    /** @type {Map<string, ResolvedPackage>} */
     const out = new Map();
     // Always include the project itself when it has package.json.
     const self = readPkg(root);
@@ -37,12 +21,6 @@ export function resolveWorkspacePackages(project) {
     }
     return [...out.values()].sort((a, b) => a.name.localeCompare(b.name));
 }
-/**
- * Resolve a package name to an absolute root (workspace first, then node_modules).
- * @param {string} project
- * @param {string} name
- * @returns {string | null}
- */
 export function resolvePackageRoot(project, name) {
     const hit = resolveWorkspacePackages(project).find((p) => p.name === name);
     if (hit)
@@ -52,10 +30,6 @@ export function resolvePackageRoot(project, name) {
         return nm;
     return null;
 }
-/**
- * @param {string} root
- * @returns {string[]}
- */
 function readWorkspacePatterns(root) {
     const patterns = [];
     const pkgPath = path.join(root, 'package.json');
@@ -88,11 +62,6 @@ function readWorkspacePatterns(root) {
     }
     return [...new Set(patterns)];
 }
-/**
- * Minimal glob: supports `packages/*`, `examples/*`, exact dirs. No `**`.
- * @param {string} root
- * @param {string} pattern
- */
 function expandWorkspacePattern(root, pattern) {
     const cleaned = pattern.replace(/\\/g, '/').replace(/\/$/, '');
     if (!cleaned.includes('*')) {
@@ -107,7 +76,6 @@ function expandWorkspacePattern(root, pattern) {
     const base = path.join(root, prefix);
     if (!existsSync(base))
         return [];
-    /** @type {string[]} */
     const dirs = [];
     for (const name of readdirSync(base, { withFileTypes: true })) {
         if (!name.isDirectory())
@@ -120,10 +88,6 @@ function expandWorkspacePattern(root, pattern) {
     }
     return dirs;
 }
-/**
- * @param {string} dir
- * @returns {ResolvedPackage | null}
- */
 function readPkg(dir) {
     const pkgPath = path.join(dir, 'package.json');
     if (!existsSync(pkgPath))

package/dist/plan-cmd.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `vmz plan` — dump frozen Rust plans via N-API; registered on `@vmz/commander`.
+ */
+import type { Command, ParsedOptions } from '@vmz/commander';
+export declare function registerPlanCommands(parent: Command): void;
+export declare function runPlanKind(kind: 'locale' | 'document-route', options: ParsedOptions): number;

package/dist/plan-cmd.js

@@ -0,0 +1,35 @@
+/**
+ * `vmz plan` — dump frozen Rust plans via N-API; registered on `@vmz/commander`.
+ */
+import path from 'node:path';
+import { loadDocumentRoutePlan, loadLocalePlan, mapPlanDiagnostics } from './author-input.js';
+import { log } from './log.js';
+import { emitPrettyJson } from './pretty-json.js';
+export function registerPlanCommands(parent) {
+    const withJson = (cmd) => cmd.option('--json [file]', 'cli.opt.json');
+    withJson(parent.command('locale', 'cli.cmd.plan.locale')).action((options) => runPlanKind('locale', options));
+    withJson(parent.command('document-route|document_route', 'cli.cmd.plan.document-route')).action((options) => runPlanKind('document-route', options));
+}
+export function runPlanKind(kind, options) {
+    const rootArg = typeof options._[0] === 'string' ? options._[0] : '.';
+    const root = path.resolve(rootArg);
+    let plan;
+    switch (kind) {
+        case 'locale':
+            plan = loadLocalePlan(root);
+            break;
+        case 'document-route':
+            plan = loadDocumentRoutePlan(root);
+            break;
+        default:
+            log.errorId('cli.err.unknown_plan_kind', { kind: String(kind) });
+            return 1;
+    }
+    const diagnostics = mapPlanDiagnostics(plan?.diagnostics || []);
+    const hardErrors = diagnostics.filter((d) => d.severity === 'error');
+    if (diagnostics.length) {
+        log.diagnostics(diagnostics);
+    }
+    emitPrettyJson(typeof options.json === 'string' ? options.json : true, plan);
+    return hardErrors.length ? 1 : 0;
+}

package/dist/plugin-host.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Plugin protocol v1 helpers + typed config loading.
  */

package/dist/port.d.ts

@@ -1,10 +1,2 @@
-/**
- * Probe for a free TCP port starting at `start` (inclusive).
- * Used by `vmz dev` when `--port` is omitted.
- *
- * @param {string} host
- * @param {number} [start=5173]
- * @param {number} [maxTries=50]
- * @returns {Promise<number>}
- */
-export declare function findAvailablePort(host: any, start?: number, maxTries?: number): Promise<unknown>;
+/** Probe for a free TCP port starting at `start` (inclusive). Used by `vmz dev` when `--port` is omitted. */
+export declare function findAvailablePort(host: string, start?: number, maxTries?: number): Promise<number>;

package/dist/port.js

@@ -1,14 +1,5 @@
-// @ts-nocheck
 import net from 'node:net';
-/**
- * Probe for a free TCP port starting at `start` (inclusive).
- * Used by `vmz dev` when `--port` is omitted.
- *
- * @param {string} host
- * @param {number} [start=5173]
- * @param {number} [maxTries=50]
- * @returns {Promise<number>}
- */
+/** Probe for a free TCP port starting at `start` (inclusive). Used by `vmz dev` when `--port` is omitted. */
 export function findAvailablePort(host, start = 5173, maxTries = 50) {
     const first = Number(start);
     if (!Number.isFinite(first) || first <= 0) {
@@ -24,7 +15,7 @@ export function findAvailablePort(host, start = 5173, maxTries = 50) {
             const server = net.createServer();
             server.unref();
             server.once('error', (err) => {
-                if (err && err.code === 'EADDRINUSE') {
+                if (err?.code === 'EADDRINUSE') {
                     port += 1;
                     attempt();
                     return;

package/dist/pretty-json.d.ts

@@ -1,19 +1,9 @@
-/**
- * Pretty-print a value through `vmz-generator` (N-API).
- * @param {unknown} value
- * @returns {string} Pretty JSON without trailing newline.
- */
-export declare function generatePrettyJson(value: any): any;
-/**
- * Write a pretty JSON artifact with a trailing newline.
- * @param {string} filePath
- * @param {unknown} value
- */
-export declare function writePrettyJsonFile(filePath: any, value: any): void;
-/**
- * CLI `--json` helper: write to a path when `target` is a string, else stdout.
- * @param {string | boolean | undefined} target
- * @param {unknown} value
- * @param {{ logWrote?: (path: string) => void }} [opts]
- */
-export declare function emitPrettyJson(target: any, value: any, opts?: {}): void;
+export interface EmitPrettyJsonOpts {
+    logWrote?: (path: string) => void;
+}
+/** Pretty-print a value through `vmz-generator` (N-API). Returns pretty JSON without trailing newline. */
+export declare function generatePrettyJson(value: unknown): string;
+/** Write a pretty JSON artifact with a trailing newline. */
+export declare function writePrettyJsonFile(filePath: string, value: unknown): void;
+/** CLI `--json` helper: write to a path when `target` is a string, else stdout. */
+export declare function emitPrettyJson(target: string | boolean | undefined, value: unknown, opts?: EmitPrettyJsonOpts): void;

package/dist/pretty-json.js

@@ -1,15 +1,10 @@
-// @ts-nocheck
 /**
  * Production JSON artifact printer — always via N-API JsonCodeGenerator.
  * Do not use `JSON.stringify(x, null, 2)` for on-disk artifacts.
  */
 import fs from 'node:fs';
 import { requireNativeAddon } from './native-addon.js';
-/**
- * Pretty-print a value through `vmz-generator` (N-API).
- * @param {unknown} value
- * @returns {string} Pretty JSON without trailing newline.
- */
+/** Pretty-print a value through `vmz-generator` (N-API). Returns pretty JSON without trailing newline. */
 export function generatePrettyJson(value) {
     const native = requireNativeAddon();
     if (typeof native.generatePrettyJson !== 'function') {
@@ -17,20 +12,11 @@ export function generatePrettyJson(value) {
     }
     return native.generatePrettyJson(JSON.stringify(value));
 }
-/**
- * Write a pretty JSON artifact with a trailing newline.
- * @param {string} filePath
- * @param {unknown} value
- */
+/** Write a pretty JSON artifact with a trailing newline. */
 export function writePrettyJsonFile(filePath, value) {
     fs.writeFileSync(filePath, `${generatePrettyJson(value)}\n`, 'utf8');
 }
-/**
- * CLI `--json` helper: write to a path when `target` is a string, else stdout.
- * @param {string | boolean | undefined} target
- * @param {unknown} value
- * @param {{ logWrote?: (path: string) => void }} [opts]
- */
+/** CLI `--json` helper: write to a path when `target` is a string, else stdout. */
 export function emitPrettyJson(target, value, opts = {}) {
     const text = generatePrettyJson(value);
     if (typeof target === 'string') {