@vmz/vmz 0.1.17 → 0.1.18

package/dist/resolve.d.ts

@@ -1,24 +1,20 @@
 /**
  * Shared project path resolution for the Node CLI host .
  */
-/**
- * @param {string} startDir
- * @returns {string | null}
- */
-export declare function findPackageJson(startDir: any): string;
-/**
- * Resolve project root + out dir from CLI args / cwd.
- * Prefers an explicit path; otherwise walks up for package.json with `src/`.
- *
- * @param {{ cwd?: string, path?: string, outDir?: string }} opts
- */
-export declare function resolveWorkspaceDirs(opts?: {}): {
+export interface ResolveWorkspaceDirsOpts {
+    cwd?: string;
+    path?: string;
+    outDir?: string;
+}
+export interface PackageMeta {
+    name?: string;
+    private?: boolean;
+}
+export declare function findPackageJson(startDir: string): string | null;
+/** Resolve project root + out dir from CLI args / cwd. Prefers an explicit path; otherwise walks up for package.json with `src/`. */
+export declare function resolveWorkspaceDirs(opts?: ResolveWorkspaceDirsOpts): {
     project: string;
-    outDir: any;
-    cwd: any;
+    outDir: string;
+    cwd: string;
 };
-/**
- * @param {string} projectRoot
- * @returns {{ name?: string, private?: boolean } | null}
- */
-export declare function readPackageMeta(projectRoot: any): any;
+export declare function readPackageMeta(projectRoot: string): PackageMeta | null;

package/dist/resolve.js

@@ -1,13 +1,8 @@
-// @ts-nocheck
 /**
  * Shared project path resolution for the Node CLI host .
  */
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
-/**
- * @param {string} startDir
- * @returns {string | null}
- */
 export function findPackageJson(startDir) {
     let dir = path.resolve(startDir);
     for (;;) {
@@ -20,12 +15,7 @@ export function findPackageJson(startDir) {
         dir = parent;
     }
 }
-/**
- * Resolve project root + out dir from CLI args / cwd.
- * Prefers an explicit path; otherwise walks up for package.json with `src/`.
- *
- * @param {{ cwd?: string, path?: string, outDir?: string }} opts
- */
+/** Resolve project root + out dir from CLI args / cwd. Prefers an explicit path; otherwise walks up for package.json with `src/`. */
 export function resolveWorkspaceDirs(opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
     const input = path.resolve(cwd, opts.path ?? '.');
@@ -38,10 +28,6 @@ export function resolveWorkspaceDirs(opts = {}) {
     const outDir = opts.outDir ? (path.isAbsolute(opts.outDir) ? opts.outDir : path.join(project, opts.outDir)) : path.join(project, 'dist');
     return { project, outDir, cwd };
 }
-/**
- * @param {string} projectRoot
- * @returns {{ name?: string, private?: boolean } | null}
- */
 export function readPackageMeta(projectRoot) {
     const pkgPath = path.join(projectRoot, 'package.json');
     if (!existsSync(pkgPath))

package/dist/server-artifact.d.ts

@@ -14,83 +14,37 @@ export declare const SERVER_RUNTIME_ADAPTER_SCHEMA = "vmz.server.runtime_adapter
  *   packDigest?: string | null,
  * }} [opts]
  */
-export declare function emitServerArtifact(outDir: any, opts?: {}): {
-    artifact: {
+interface ServerArtifactOpts {
+    profileId?: string | null;
+    assembly?: string | null;
+    serverRuntime?: string | null;
+    packDigest?: string | null;
+}
+interface ServerArtifactBody {
+    schema: string;
+    profileId: string | null;
+    assembly: string | null;
+    selectedRuntime: string;
+    entry: {
+        kind: string;
+        standards: string[];
+        rpcPath: string;
+    };
+    httpContract: {
         schema: string;
-        profileId: any;
-        assembly: any;
-        selectedRuntime: string;
-        entry: {
-            kind: string;
-            standards: string[];
-            rpcPath: string;
-        };
-        httpContract: {
-            schema: string;
-            digest: string;
-        };
-        publicRoutes: {
-            verb: string;
-            path: string;
-            moduleId: string;
-            method: string;
-            className: string;
-            visibility: string;
-            kind: string;
-        }[];
-        internalCapabilities: any[];
-        middlewareUnits: any[];
-        routeDecisionTree: ({
-            id: string;
-            match: {
-                method: string;
-                path: string;
-            };
-            action: string;
-            target: {
-                moduleId: string;
-                method: string;
-            };
-            visibility: string;
-        } | {
-            id: string;
-            match: {
-                method: string;
-                path: string;
-            };
-            action: string;
-            visibility: string;
-        })[];
-        deploymentSchema: any;
-        packDigest: any;
-        adapters: {
-            node: {
-                kind: string;
-                status: string;
-                entry: string;
-            };
-            worker: {
-                kind: string;
-                status: string;
-                entry: string;
-            };
-            deno: {
-                kind: string;
-                status: string;
-                entry: string;
-            };
-            bun: {
-                kind: string;
-                status: string;
-                entry: string;
-            };
-            'rust-host': {
-                kind: string;
-                status: string;
-                entry: string;
-            };
-        };
+        digest: string;
     };
+    publicRoutes: Array<Record<string, unknown>>;
+    internalCapabilities: Array<Record<string, unknown>>;
+    middlewareUnits: unknown[];
+    routeDecisionTree: unknown[];
+    deploymentSchema: unknown;
+    packDigest: string | null;
+    adapters: Record<string, unknown>;
+    artifactDigest?: string;
+}
+export declare function emitServerArtifact(outDir: string, opts?: ServerArtifactOpts): {
+    artifact: ServerArtifactBody;
     path: string;
     httpContractDigest: string;
 };
@@ -138,3 +92,4 @@ export declare function projectServerRuntimeAdapter(artifact: any, adapterId: an
     publicRouteCount: any;
     internalCapabilityCount: any;
 };
+export {};

package/dist/server-artifact.js

@@ -2,7 +2,6 @@
  * P4 ServerArtifact — compiled route decision tree + public ServerRoute contracts
  * + internal capability units + selected runtime adapter. Web Standards Fetch entry.
  */
-// @ts-nocheck
 import crypto from 'node:crypto';
 import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
@@ -12,15 +11,6 @@ export const SERVER_ARTIFACT_SCHEMA = 'vmz.server.artifact.v0';
 export const HTTP_CONTRACT_SCHEMA = 'vmz.http.contract.v0';
 export const SERVER_RUNTIME_ADAPTER_SCHEMA = 'vmz.server.runtime_adapter.v0';
 const DEFAULT_RPC_PATH = '/__vmz/rpc';
-/**
- * @param {string} outDir
- * @param {{
- *   profileId?: string | null,
- *   assembly?: string | null,
- *   serverRuntime?: string | null,
- *   packDigest?: string | null,
- * }} [opts]
- */
 export function emitServerArtifact(outDir, opts = {}) {
     const deployment = readJson(path.join(outDir, 'vmz-deployment.json')) || { schema: null, units: [] };
     const routes = readJson(path.join(outDir, 'vmz-routes.json'));

package/dist/server-language-backend.d.ts

@@ -2,88 +2,31 @@
  * Server Language DSL backends (lang on `<script server>`).
  * Author surface is a VMZ DSL flavor — not full target-language source.
  */
-/** @typedef {'ts' | 'rust' | 'python' | 'java'} ServerLangId */
-export declare const SERVER_LANG_IDS: readonly string[];
-/** @type {Record<string, ServerLangId>} */
-export declare const SERVER_LANG_ALIASES: Readonly<{
-    ts: "ts";
-    typescript: "ts";
-    rust: "rust";
-    python: "python";
-    java: "java";
-}>;
-/**
- * @typedef {{
- *   langId: ServerLangId,
- *   aliases: string[],
- *   compatibleRuntimes: string[],
- *   implemented: boolean,
- *   artifactRoot: string,
- * }} ServerLanguageBackendMeta
- */
-/** @type {Record<ServerLangId, ServerLanguageBackendMeta>} */
-export declare const SERVER_LANGUAGE_BACKENDS: Readonly<{
-    ts: {
-        langId: string;
-        aliases: string[];
-        compatibleRuntimes: string[];
-        implemented: boolean;
-        artifactRoot: string;
-    };
-    rust: {
-        langId: string;
-        aliases: string[];
-        compatibleRuntimes: string[];
-        implemented: boolean;
-        artifactRoot: string;
-    };
-    python: {
-        langId: string;
-        aliases: string[];
-        compatibleRuntimes: string[];
-        implemented: boolean;
-        artifactRoot: string;
-    };
-    java: {
-        langId: string;
-        aliases: string[];
-        compatibleRuntimes: string[];
-        implemented: boolean;
-        artifactRoot: string;
-    };
-}>;
-/**
- * Resolve author `lang` attr (or null/undefined for default TS).
- * @param {string | null | undefined} raw
- * @returns {{
- *   ok: true, langId: ServerLangId, backend: ServerLanguageBackendMeta
- * } | {
- *   ok: false, code: string, message: string
- * }}
- */
-export declare function resolveServerLanguage(raw: any): {
-    ok: boolean;
+export type ServerLangId = 'ts' | 'rust' | 'python' | 'java';
+export declare const SERVER_LANG_IDS: readonly ["ts", "rust", "python", "java"];
+export declare const SERVER_LANG_ALIASES: Record<string, ServerLangId>;
+export interface ServerLanguageBackendMeta {
+    langId: ServerLangId;
+    aliases: string[];
+    compatibleRuntimes: string[];
+    implemented: boolean;
+    artifactRoot: string;
+}
+export declare const SERVER_LANGUAGE_BACKENDS: Record<ServerLangId, ServerLanguageBackendMeta>;
+export type ResolveServerLanguageResult = {
+    ok: true;
+    langId: ServerLangId;
+    backend: ServerLanguageBackendMeta;
+} | {
+    ok: false;
     code: string;
     message: string;
-    langId?: undefined;
-    backend?: undefined;
-} | {
-    ok: boolean;
-    langId: any;
-    backend: any;
-    code?: undefined;
-    message?: undefined;
 };
-/**
- * @param {ServerLangId} langId
- * @param {string | null | undefined} serverRuntime
- */
-export declare function assertLangRuntimePair(langId: any, serverRuntime: any): {
-    ok: boolean;
+export declare function resolveServerLanguage(raw: string | null | undefined): ResolveServerLanguageResult;
+export declare function assertLangRuntimePair(langId: ServerLangId, serverRuntime: string | null | undefined): {
+    ok: true;
+} | {
+    ok: false;
     code: string;
     message: string;
-} | {
-    ok: boolean;
-    code?: undefined;
-    message?: undefined;
 };

package/dist/server-language-backend.js

@@ -2,10 +2,7 @@
  * Server Language DSL backends (lang on `<script server>`).
  * Author surface is a VMZ DSL flavor — not full target-language source.
  */
-// @ts-nocheck
-/** @typedef {'ts' | 'rust' | 'python' | 'java'} ServerLangId */
 export const SERVER_LANG_IDS = Object.freeze(['ts', 'rust', 'python', 'java']);
-/** @type {Record<string, ServerLangId>} */
 export const SERVER_LANG_ALIASES = Object.freeze({
     ts: 'ts',
     typescript: 'ts',
@@ -13,16 +10,6 @@ export const SERVER_LANG_ALIASES = Object.freeze({
     python: 'python',
     java: 'java',
 });
-/**
- * @typedef {{
- *   langId: ServerLangId,
- *   aliases: string[],
- *   compatibleRuntimes: string[],
- *   implemented: boolean,
- *   artifactRoot: string,
- * }} ServerLanguageBackendMeta
- */
-/** @type {Record<ServerLangId, ServerLanguageBackendMeta>} */
 export const SERVER_LANGUAGE_BACKENDS = Object.freeze({
     ts: {
         langId: 'ts',
@@ -53,15 +40,6 @@ export const SERVER_LANGUAGE_BACKENDS = Object.freeze({
         artifactRoot: 'target/vmz/server-java',
     },
 });
-/**
- * Resolve author `lang` attr (or null/undefined for default TS).
- * @param {string | null | undefined} raw
- * @returns {{
- *   ok: true, langId: ServerLangId, backend: ServerLanguageBackendMeta
- * } | {
- *   ok: false, code: string, message: string
- * }}
- */
 export function resolveServerLanguage(raw) {
     const trimmed = raw == null ? '' : String(raw).trim();
     if (!trimmed) {
@@ -85,10 +63,6 @@ export function resolveServerLanguage(raw) {
     }
     return { ok: true, langId, backend };
 }
-/**
- * @param {ServerLangId} langId
- * @param {string | null | undefined} serverRuntime
- */
 export function assertLangRuntimePair(langId, serverRuntime) {
     const backend = SERVER_LANGUAGE_BACKENDS[langId];
     if (!backend) {

package/dist/site-delivery.d.ts

@@ -12,35 +12,19 @@ export declare const SITE_DELIVERY_RESOLUTION_SCHEMA = "vmz.site.delivery_resolu
 export declare function defineSite(delivery: any): any;
 /**
  * Normalize authoring delivery → frozen SiteDeliveryContract.
- * @param {unknown} raw
- * @param {{ siteId?: string, projectRoot?: string }} [opts]
- * @returns {{ ok: true, contract: Record<string, any> } | { ok: false, diagnostics: Array<{ code: string, message: string }> }}
  */
-export declare function normalizeSiteDelivery(raw: any, opts?: {}): {
-    ok: boolean;
-    diagnostics: any[];
-    contract?: undefined;
+export declare function normalizeSiteDelivery(raw: unknown, opts?: {
+    siteId?: string;
+    projectRoot?: string;
+}): {
+    ok: true;
+    contract: Record<string, any>;
 } | {
-    ok: boolean;
-    contract: {
-        schema: string;
-        schemaVersion: string;
-        siteId: any;
-        artifact: string;
-        expectedCompatibility: any;
-        sources: any[];
-        resolutionPolicy: {
-            mode: string;
-            fallback: any;
-            fileLevelMix: boolean;
-        };
-        failurePolicy: any;
-        updatePolicy: any;
-        rollbackPolicy: any;
-        securityPolicy: any;
-        activation: string;
-    };
-    diagnostics?: undefined;
+    ok: false;
+    diagnostics: Array<{
+        code: string;
+        message: string;
+    }>;
 };
 /**
  * Probe one physical source for release-level readiness (not per-URL).
@@ -54,31 +38,44 @@ export declare function normalizeSiteDelivery(raw: any, opts?: {}): {
  *   error?: string | null,
  * }} [probe]
  */
-export declare function normalizeSourceProbe(probe?: {}): {
+export declare function normalizeSourceProbe(probe?: {
+    available?: boolean;
+    artifactDigest?: string | null;
+    integrityOk?: boolean;
+    signatureOk?: boolean;
+    objectClosureOk?: boolean;
+    mixedDigestObjects?: boolean;
+    error?: string | null;
+}): {
     available: boolean;
-    artifactDigest: any;
+    artifactDigest: string;
     integrityOk: boolean;
     signatureOk: boolean;
     objectClosureOk: boolean;
     mixedDigestObjects: boolean;
-    error: any;
+    error: string;
 };
 /**
  * Resolve one complete release per SiteDeliveryContract (no file-level mix).
  * @param {Record<string, any>} contract
  * @param {Record<string, ReturnType<typeof normalizeSourceProbe>>} probes by sourceId
  */
-export declare function resolveSiteRelease(contract: any, probes?: {}): {
+export declare function resolveSiteRelease(contract: Record<string, any>, probes?: Record<string, ReturnType<typeof normalizeSourceProbe>>): {
     schema: string;
     status: string;
-    selectedSourceId: any;
-    selectedKind: any;
-    selectedDigest: any;
-    fallbackReason: string;
-    attempted: any[];
+    selectedSourceId: string;
+    selectedKind: unknown;
+    selectedDigest: string | null;
+    fallbackReason: string | null;
+    attempted: {
+        sourceId: string;
+        result: string;
+        reason: string | null;
+    }[];
     fileLevelMix: boolean;
     activation: string;
-    contractDigest: any;
+    contractDigest: unknown;
+    resolutionDigest?: string;
 } | {
     schema: string;
     status: string;
@@ -86,7 +83,11 @@ export declare function resolveSiteRelease(contract: any, probes?: {}): {
     selectedKind: any;
     selectedDigest: any;
     fallbackReason: string;
-    attempted: any[];
+    attempted: {
+        sourceId: string;
+        result: string;
+        reason: string | null;
+    }[];
     fileLevelMix: boolean;
     activation: string;
     contractDigest: any;
@@ -98,12 +99,12 @@ export declare function resolveSiteRelease(contract: any, probes?: {}): {
  */
 export declare function probeReleaseDirectory(releaseDir: any): {
     available: boolean;
-    artifactDigest: any;
+    artifactDigest: string;
     integrityOk: boolean;
     signatureOk: boolean;
     objectClosureOk: boolean;
     mixedDigestObjects: boolean;
-    error: any;
+    error: string;
 };
 /**
  * Emit normalized contract (+ optional resolution) under dist/_vmz.
@@ -111,24 +112,10 @@ export declare function probeReleaseDirectory(releaseDir: any): {
  * @param {unknown} deliveryRaw
  * @param {{ siteId?: string, probes?: Record<string, any> }} [opts]
  */
-export declare function emitSiteDelivery(outDir: any, deliveryRaw: any, opts?: {}): {
-    contract: {
-        schema: string;
-        schemaVersion: string;
-        siteId: any;
-        artifact: string;
-        expectedCompatibility: any;
-        sources: any[];
-        resolutionPolicy: {
-            mode: string;
-            fallback: any;
-            fileLevelMix: boolean;
-        };
-        failurePolicy: any;
-        updatePolicy: any;
-        rollbackPolicy: any;
-        securityPolicy: any;
-        activation: string;
-    };
+export declare function emitSiteDelivery(outDir: string, deliveryRaw: unknown, opts?: {
+    siteId?: string;
+    probes?: Record<string, ReturnType<typeof normalizeSourceProbe>>;
+}): {
+    contract: Record<string, any>;
     resolution: any;
 };

package/dist/site-delivery.js

@@ -2,7 +2,6 @@
  * A3-site: SiteDeliveryContract — embedded | filesystem | remote selection + release fallback.
  * Authoring via defineConfig({ delivery }) / defineSite(...); pure data only.
  */
-// @ts-nocheck
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -19,12 +18,8 @@ export function defineSite(delivery) {
 }
 /**
  * Normalize authoring delivery → frozen SiteDeliveryContract.
- * @param {unknown} raw
- * @param {{ siteId?: string, projectRoot?: string }} [opts]
- * @returns {{ ok: true, contract: Record<string, any> } | { ok: false, diagnostics: Array<{ code: string, message: string }> }}
  */
 export function normalizeSiteDelivery(raw, opts = {}) {
-    /** @type {Array<{ code: string, message: string }>} */
     const diagnostics = [];
     if (raw == null || typeof raw !== 'object' || Array.isArray(raw)) {
         return {
@@ -32,7 +27,7 @@ export function normalizeSiteDelivery(raw, opts = {}) {
             diagnostics: [{ code: 'site.delivery.invalid', message: 'delivery must be a plain object' }],
         };
     }
-    const d = /** @type {Record<string, any>} */ (raw);
+    const d = raw;
     if (typeof d.artifact !== 'string' || !d.artifact.trim()) {
         diagnostics.push({ code: 'site.delivery.artifact', message: 'delivery.artifact is required' });
     }
@@ -110,7 +105,7 @@ export function normalizeSiteDelivery(raw, opts = {}) {
             message: `resolution.mode must be 'release' (got ${mode})`,
         });
     }
-    let fallback = Array.isArray(resolution.fallback) ? resolution.fallback.map(String) : sources.map((s) => s.sourceId);
+    const fallback = Array.isArray(resolution.fallback) ? resolution.fallback.map(String) : sources.map((s) => s.sourceId);
     for (const id of fallback) {
         if (!seen.has(id)) {
             diagnostics.push({
@@ -314,7 +309,7 @@ export function probeReleaseDirectory(releaseDir) {
  */
 export function emitSiteDelivery(outDir, deliveryRaw, opts = {}) {
     const norm = normalizeSiteDelivery(deliveryRaw, { siteId: opts.siteId });
-    if (!norm.ok) {
+    if (norm.ok === false) {
         throw new Error(`emitSiteDelivery: ${norm.diagnostics.map((d) => d.message).join('; ')}`);
     }
     const vmzDir = path.join(outDir, '_vmz');

package/dist/site-favicon.d.ts

@@ -7,7 +7,11 @@ export declare const SITE_FAVICON_SCHEMA = "vmz.site_favicon.v0";
  * @param {string} distDir
  * @param {{ projectRoot?: string, skipNative?: boolean }} [opts]
  */
-export declare function emitSiteFavicon(distDir: any, opts?: {}): {
+interface SiteFaviconOpts {
+    projectRoot?: string;
+    skipNative?: boolean;
+}
+export declare function emitSiteFavicon(distDir: string, opts?: SiteFaviconOpts): {
     schema: string;
     status: string;
     source: string;
@@ -29,3 +33,4 @@ export declare function readSiteFaviconHeadHtml(distDir: any): any;
  * @param {Array<{ png: Buffer, size: number }>} images
  */
 export declare function packPngsIntoIco(images: any): Buffer<ArrayBuffer>;
+export {};

package/dist/site-favicon.js

@@ -2,17 +2,12 @@
  * Site favicon: author SVG → PNG + ICO + `_vmz/site-favicon.json` head links.
  * Convention: `assets/favicon.svg` (or `favicon.svg`) under project / already in dist.
  */
-// @ts-nocheck
 import fs from 'node:fs';
 import path from 'node:path';
 import { requireNativeAddon } from './native-addon.js';
 import { writePrettyJsonFile } from './pretty-json.js';
 export const SITE_FAVICON_SCHEMA = 'vmz.site_favicon.v0';
 const ICO_SIZES = [16, 32, 48];
-/**
- * @param {string} distDir
- * @param {{ projectRoot?: string, skipNative?: boolean }} [opts]
- */
 export function emitSiteFavicon(distDir, opts = {}) {
     const absDist = path.resolve(distDir);
     const projectRoot = opts.projectRoot ? path.resolve(opts.projectRoot) : null;