@vmz/vmz 0.1.16 → 0.1.18

package/dist/content-addressed-assets.js

@@ -5,7 +5,6 @@
  * JS under assets/ always rewrites ESM `./` → `../` so barrels (vmz-dom → dom-core)
  * resolve at dist root — never prefer hashed siblings for JS (second-hop 404).
  */
-// @ts-nocheck
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -89,9 +88,7 @@ export function emitContentAddressedAssets(distDir, opts = {}) {
     const assetsDir = path.join(abs, 'assets');
     fs.mkdirSync(assetsDir, { recursive: true });
     const candidates = Array.isArray(opts.candidates) ? opts.candidates : collectCandidates(abs);
-    /** @type {Array<Record<string, any>>} */
     const objects = [];
-    /** @type {Record<string, string>} */
     const rewrites = {};
     const ordered = orderCandidates(candidates);
     for (const rel of ordered) {
@@ -168,7 +165,6 @@ export function emitContentAddressedAssets(distDir, opts = {}) {
  */
 function orderCandidates(candidates) {
     const set = new Set(candidates.map((c) => String(c).replace(/\\/g, '/').replace(/^\//, '')));
-    /** @type {string[]} */
     const out = [];
     for (const name of DEFAULT_CANDIDATES) {
         if (set.has(name) && !CSS_AGGREGATORS.has(name) && !JS_ENTRY_AGGREGATORS.has(name))
@@ -208,9 +204,9 @@ function ingestCandidate(absDist, rel, rewrites, objects, opts) {
     const src = path.join(absDist, ...logical.split('/'));
     if (!fs.existsSync(src) || !fs.statSync(src).isFile())
         return;
-    let buf = fs.readFileSync(src);
+    let buf = Buffer.from(fs.readFileSync(src));
     if (typeof opts.transform === 'function') {
-        buf = opts.transform(buf);
+        buf = Buffer.from(opts.transform(buf));
     }
     const digest = sha256Hex(buf);
     const ext = path.extname(logical) || '';
@@ -280,7 +276,6 @@ export function assertSharedAssetPath(distDir, a, b, ext = '.js') {
     return { ok: true, assetPath: rel, digest: da };
 }
 function collectCandidates(distDir) {
-    /** @type {string[]} */
     const out = [];
     for (const name of DEFAULT_CANDIDATES) {
         if (fs.existsSync(path.join(distDir, name)))

package/dist/delivery-profile.d.ts

@@ -7,6 +7,50 @@ export declare const BUILD_PROFILE_SELECTION_SCHEMA = "vmz.build.profile_selecti
 /** Browser-era assembly kinds (04 B5). `static-cdn` was renamed to `web-static`. */
 export declare const ASSEMBLIES: readonly string[];
 export declare const SERVER_RUNTIMES: readonly string[];
+interface SiteAuthoring {
+    artifact: string;
+    sources: unknown;
+    siteId?: unknown;
+    resolution?: unknown;
+    activation?: unknown;
+    expectedCompatibility?: unknown;
+    failure?: unknown;
+    failurePolicy?: unknown;
+    update?: unknown;
+    updatePolicy?: unknown;
+    rollback?: unknown;
+    rollbackPolicy?: unknown;
+    security?: unknown;
+    securityPolicy?: unknown;
+}
+export interface WechatPackagingData {
+    appId?: string;
+    projectName?: string;
+    title?: string;
+}
+interface DeliveryAuthoringTable {
+    schema: string;
+    default: string;
+    profiles: Record<string, unknown>;
+    sugar: boolean;
+    packaging?: {
+        wechat: WechatPackagingData;
+    };
+    digest?: string;
+}
+interface BuildProfileSelection {
+    schema: string;
+    profileId: string;
+    name: string;
+    nameExplicit: boolean;
+    host: string;
+    assembly: string;
+    serverRuntime: string | null;
+    hasSiteSources: boolean;
+    authoringDigest: string | undefined;
+    fromCli: boolean;
+    digest?: string;
+}
 /** Official built-in aliases when not overridden in config. */
 export declare const BUILTIN_PROFILES: Readonly<{
     'web-client': {
@@ -44,28 +88,21 @@ export declare function normalizeProfileArtifactName(id: any, rawName: any, diag
  * @param {{ name?: string, id?: string } | null | undefined} profile
  */
 export declare function resolveProfileArtifactDir(outDir: any, profile: any): any;
-export declare function pickSiteAuthoring(raw: any): {
-    artifact: string;
-    sources: any;
-};
+export declare function pickSiteAuthoring(raw: any): SiteAuthoring;
 /**
  * `delivery.packaging.wechat` — vendor identity, not WeChat JSON / wx APIs.
  * @param {unknown} raw
  * @param {Array<{ code: string, message: string }>} diagnostics
  */
-export declare function pickDeliveryPackaging(raw: any, diagnostics: any): {
-    wechat?: undefined;
-} | {
-    wechat: {};
-};
+export declare function pickDeliveryPackaging(raw: unknown, diagnostics: Array<{
+    code: string;
+    message: string;
+}>): {
+    wechat: WechatPackagingData;
+} | null;
 export declare function normalizeDeliveryAuthoring(raw: any): {
     ok: boolean;
-    table: {
-        schema: string;
-        default: string;
-        profiles: {};
-        sugar: boolean;
-    };
+    table: DeliveryAuthoringTable;
     diagnostics?: undefined;
 } | {
     ok: boolean;
@@ -82,21 +119,11 @@ export declare function selectBuildProfile(table: any, cliProfile?: string): {
     profile?: undefined;
 } | {
     ok: boolean;
-    selection: {
-        schema: string;
-        profileId: any;
-        name: any;
-        nameExplicit: boolean;
-        host: any;
-        assembly: any;
-        serverRuntime: any;
-        hasSiteSources: boolean;
-        authoringDigest: any;
-        fromCli: boolean;
-    };
+    selection: BuildProfileSelection;
     profile: any;
     diagnostics?: undefined;
 };
 export declare function semanticIdsForAssembly(assembly: any): string[];
 export declare function canonicalJson(value: any): string;
 export declare function sha256Hex(text: any): string;
+export {};

package/dist/delivery-profile.js

@@ -2,7 +2,6 @@
  * B0 — Delivery profile authoring normalize + CLI --profile resolve.
  * Pure data only; expands legacy site-delivery sugar into profiles[default].
  */
-// @ts-nocheck
 import crypto from 'node:crypto';
 import path from 'node:path';
 export const DELIVERY_PROFILE_AUTHORING_SCHEMA = 'vmz.delivery.authoring.v0';
@@ -106,11 +105,12 @@ export function pickSiteAuthoring(raw) {
 export function pickDeliveryPackaging(raw, diagnostics) {
     if (!isPlainObject(raw) || raw.packaging == null)
         return null;
-    if (!isPlainObject(raw.packaging)) {
+    const packagingRaw = raw.packaging;
+    if (!isPlainObject(packagingRaw)) {
         diagnostics.push({ code: 'delivery.packaging', message: 'delivery.packaging must be an object' });
         return null;
     }
-    for (const key of Object.keys(raw.packaging)) {
+    for (const key of Object.keys(packagingRaw)) {
         if (key !== 'wechat') {
             diagnostics.push({
                 code: 'delivery.packaging.vendor',
@@ -118,9 +118,9 @@ export function pickDeliveryPackaging(raw, diagnostics) {
             });
         }
     }
-    const wechat = raw.packaging.wechat;
+    const wechat = packagingRaw.wechat;
     if (wechat == null)
-        return {};
+        return null;
     if (!isPlainObject(wechat)) {
         diagnostics.push({
             code: 'delivery.packaging.wechat',
@@ -128,7 +128,8 @@ export function pickDeliveryPackaging(raw, diagnostics) {
         });
         return null;
     }
-    for (const [k, v] of Object.entries(wechat)) {
+    const wechatObj = wechat;
+    for (const [k, v] of Object.entries(wechatObj)) {
         if (typeof v === 'function') {
             diagnostics.push({
                 code: 'delivery.packaging.executable',
@@ -150,13 +151,13 @@ export function pickDeliveryPackaging(raw, diagnostics) {
         }
     }
     const out = {};
-    if (typeof wechat.appId === 'string' && wechat.appId.trim())
-        out.appId = wechat.appId.trim();
-    if (typeof wechat.projectName === 'string' && wechat.projectName.trim()) {
-        out.projectName = wechat.projectName.trim();
+    if (typeof wechatObj.appId === 'string' && wechatObj.appId.trim())
+        out.appId = wechatObj.appId.trim();
+    if (typeof wechatObj.projectName === 'string' && wechatObj.projectName.trim()) {
+        out.projectName = wechatObj.projectName.trim();
     }
-    if (typeof wechat.title === 'string' && wechat.title.trim())
-        out.title = wechat.title.trim();
+    if (typeof wechatObj.title === 'string' && wechatObj.title.trim())
+        out.title = wechatObj.title.trim();
     return { wechat: out };
 }
 function normalizeProfileEntry(entry, id, diagnostics) {
@@ -344,8 +345,9 @@ export function normalizeDeliveryAuthoring(raw) {
         default: defaultId,
         profiles,
         sugar,
-        ...(packaging ? { packaging } : {}),
     };
+    if (packaging)
+        table.packaging = packaging;
     table.digest = sha256Hex(canonicalJson(table));
     return { ok: true, table };
 }

package/dist/dev-session.d.ts

@@ -9,33 +9,39 @@
  * 2. Soft reload only re-imports affected pages unless shared `lib/` / full rebuild.
  * 3. Soft reload failure → **auto-respawn** serve-host (fresh ESM graph), not "keep broken host".
  */
-/**
- * @typedef {object} DevSessionOptions
- * @property {string} project
- * @property {string} outDir
- * @property {string} [host]
- * @property {number} [port]
- * @property {number} [pollMs]
- * @property {'browser' | 'mini-program-wechat'} [target]
- * @property {AbortSignal} [signal]
- * @property {typeof createWorkspace} [createWorkspaceFn]
- * @property {(opts: { project: string, outDir: string, host: string, port: number }) => import('node:child_process').ChildProcess} [spawnHostFn]
- * @property {(host: string, port: number, payload?: object) => Promise<void>} [softReloadFn]
- */
-/**
- * @param {DevSessionOptions} options
- */
-export declare function createDevSession(options: any): {
+import { createWorkspace } from './index.js';
+interface DevSessionOptions {
+    project: string;
+    outDir: string;
+    host?: string;
+    port?: number;
+    pollMs?: number;
+    target?: 'browser' | 'mini-program-wechat';
+    signal?: AbortSignal;
+    createWorkspaceFn?: typeof createWorkspace;
+    spawnHostFn?: (opts: {
+        project: string;
+        outDir: string;
+        host: string;
+        port: number;
+    }) => import('node:child_process').ChildProcess;
+    softReloadFn?: (host: string, port: number, payload?: object) => Promise<void>;
+}
+export declare function createDevSession(options: DevSessionOptions): {
     ws: any;
-    rebuild: (changes: any) => any;
+    rebuild: (changes?: Array<{
+        path: string;
+        kind: "update" | "delete";
+    }>) => any;
     start: () => Promise<void>;
     stop: () => Promise<void>;
-    project: any;
-    outDir: any;
-    host: any;
-    port: any;
+    project: string;
+    outDir: string;
+    host: string;
+    port: number;
 };
 /** @deprecated use fileFingerprintMap */
 export declare function srcFingerprint(srcDir: any): number;
 /** @deprecated */
-export declare function listWatchedFiles(srcDir: any): any[];
+export declare function listWatchedFiles(srcDir: any): string[];
+export {};

package/dist/dev-session.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Long-lived Node dev session (/session).
  *
@@ -19,22 +18,6 @@ import { emitLocaleRuntimeModules, localeHasErrors } from './locale-check.js';
 import { log } from './log.js';
 import { coalesceRootBurst, collectDevWatchRoots, classifyWatchRoot, isDependencyPath, mergeDirtySets } from './dev-watch-roots.js';
 import { diffFingerprints, fileFingerprintMap } from './watch-diff.js';
-/**
- * @typedef {object} DevSessionOptions
- * @property {string} project
- * @property {string} outDir
- * @property {string} [host]
- * @property {number} [port]
- * @property {number} [pollMs]
- * @property {'browser' | 'mini-program-wechat'} [target]
- * @property {AbortSignal} [signal]
- * @property {typeof createWorkspace} [createWorkspaceFn]
- * @property {(opts: { project: string, outDir: string, host: string, port: number }) => import('node:child_process').ChildProcess} [spawnHostFn]
- * @property {(host: string, port: number, payload?: object) => Promise<void>} [softReloadFn]
- */
-/**
- * @param {DevSessionOptions} options
- */
 export function createDevSession(options) {
     const project = options.project;
     const outDir = options.outDir;
@@ -46,12 +29,8 @@ export function createDevSession(options) {
     const spawnHost = options.spawnHostFn ?? defaultSpawnHost;
     const softReload = options.softReloadFn ?? defaultSoftReload;
     const ws = createWs({ root: project, outDir });
-    /** @type {import('node:child_process').ChildProcess | null} */
     let child = null;
     let stopped = false;
-    /**
-     * @param {Array<{ path: string, kind: 'update' | 'delete' }>} [changes]
-     */
     function rebuild(changes) {
         if (changes?.length)
             ws.updateFiles(changes);

package/dist/dev-watch-roots.d.ts

@@ -2,19 +2,16 @@
  * Dev watch helpers: coalesce multi-file bursts without dropping dirty set,
  * and derive extra watch roots from the compile graph (deployment unit sources).
  */
-/**
- * @typedef {{ changed: string[], deleted: string[] }} DirtySet
- */
-/**
- * Merge dirty sets: later change cancels delete and vice versa.
- * @param {DirtySet} a
- * @param {DirtySet} b
- * @returns {DirtySet}
- */
-export declare function mergeDirtySets(a: any, b: any): {
-    changed: unknown[];
-    deleted: unknown[];
-};
+export interface DirtySet {
+    changed: string[];
+    deleted: string[];
+}
+interface CoalesceRootBurstOpts {
+    sleep?: (ms: number) => Promise<void>;
+    maxRounds?: number;
+    settleMs?: number;
+}
+export declare function mergeDirtySets(a: DirtySet, b: DirtySet): DirtySet;
 /**
  * Wait until `root` stops changing; return the **accumulated** dirty set since `initial`.
  * Updates `fingerprints` for `root` as it polls. Does **not** discard `initial`.
@@ -25,28 +22,28 @@ export declare function mergeDirtySets(a: any, b: any): {
  * @param {{ sleep?: (ms: number) => Promise<void>, maxRounds?: number, settleMs?: number }} [opts]
  * @returns {Promise<DirtySet>}
  */
-export declare function coalesceRootBurst(root: any, fingerprints: any, initial: any, opts?: {}): Promise<{
-    changed: any[];
-    deleted: any[];
+export declare function coalesceRootBurst(root: string, fingerprints: Map<string, Map<string, string>>, initial: DirtySet, opts?: CoalesceRootBurstOpts): Promise<{
+    changed: string[];
+    deleted: string[];
 }>;
 /**
  * Walk up from a file to find a package.json directory.
  * @param {string} file
  * @returns {string | null}
  */
-export declare function findPackageRoot(file: any): string;
+export declare function findPackageRoot(file: string): string | null;
 /**
  * Prefer package/src when present; otherwise the directory containing the source file.
  * @param {string} sourceFile
  * @returns {string | null}
  */
-export declare function watchRootForSourceFile(sourceFile: any): string;
+export declare function watchRootForSourceFile(sourceFile: string): string | null;
 /**
  * Absolute roots for workspace / file / link deps that have a src tree.
  * @param {string} project
  * @returns {string[]}
  */
-export declare function localLinkDependencyRoots(project: any): any[];
+export declare function localLinkDependencyRoots(project: string): string[];
 /**
  * Collect watch roots: project src/locales/documents + compile-graph external sources
  * + local link/workspace package roots. Never adds a bare registry node_modules tree.
@@ -54,10 +51,14 @@ export declare function localLinkDependencyRoots(project: any): any[];
  * @param {{ project: string, outDir: string }} opts
  * @returns {{ roots: string[], dependencyRoots: string[], applicationRoots: string[] }}
  */
-export declare function collectDevWatchRoots(opts: any): {
-    roots: any[];
-    dependencyRoots: unknown[];
-    applicationRoots: any[];
+interface CollectDevWatchRootsOpts {
+    project: string;
+    outDir: string;
+}
+export declare function collectDevWatchRoots(opts: CollectDevWatchRootsOpts): {
+    roots: string[];
+    dependencyRoots: string[];
+    applicationRoots: string[];
 };
 /**
  * Classify which watch bucket a root belongs to.
@@ -71,10 +72,18 @@ export declare function collectDevWatchRoots(opts: any): {
  * }} ctx
  * @returns {'src' | 'locales' | 'docs' | 'designs' | 'dep' | 'other'}
  */
-export declare function classifyWatchRoot(root: any, ctx: any): "src" | "locales" | "docs" | "designs" | "dep" | "other";
+export interface ClassifyWatchRootCtx {
+    src: string;
+    docsRoot: string;
+    localesRoot: string;
+    designsRoot: string;
+    dependencyRoots: string[];
+}
+export declare function classifyWatchRoot(root: string, ctx: ClassifyWatchRootCtx): 'src' | 'locales' | 'docs' | 'designs' | 'dep' | 'other';
 /**
  * Classify whether a changed file lives under a dependency watch root (not app src).
  * @param {string} file
  * @param {string[]} dependencyRoots
  */
-export declare function isDependencyPath(file: any, dependencyRoots: any): any;
+export declare function isDependencyPath(file: string, dependencyRoots: string[]): boolean;
+export {};

package/dist/dev-watch-roots.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Dev watch helpers: coalesce multi-file bursts without dropping dirty set,
  * and derive extra watch roots from the compile graph (deployment unit sources).
@@ -6,15 +5,6 @@
 import { existsSync, readFileSync, realpathSync } from 'node:fs';
 import path from 'node:path';
 import { diffFingerprints, fileFingerprintMap } from './watch-diff.js';
-/**
- * @typedef {{ changed: string[], deleted: string[] }} DirtySet
- */
-/**
- * Merge dirty sets: later change cancels delete and vice versa.
- * @param {DirtySet} a
- * @param {DirtySet} b
- * @returns {DirtySet}
- */
 export function mergeDirtySets(a, b) {
     const changed = new Set(a?.changed || []);
     const deleted = new Set(a?.deleted || []);
@@ -142,13 +132,6 @@ export function localLinkDependencyRoots(project) {
     }
     return roots;
 }
-/**
- * Collect watch roots: project src/locales/documents + compile-graph external sources
- * + local link/workspace package roots. Never adds a bare registry node_modules tree.
- *
- * @param {{ project: string, outDir: string }} opts
- * @returns {{ roots: string[], dependencyRoots: string[], applicationRoots: string[] }}
- */
 export function collectDevWatchRoots(opts) {
     const project = path.resolve(opts.project);
     const outDir = path.resolve(opts.outDir);
@@ -156,7 +139,6 @@ export function collectDevWatchRoots(opts) {
     const docsRoot = path.join(project, 'documents');
     const localesRoot = path.join(project, 'locales');
     const designsRoot = path.join(project, 'designs');
-    /** @type {string[]} */
     const applicationRoots = [];
     if (existsSync(src))
         applicationRoots.push(src);
@@ -166,7 +148,6 @@ export function collectDevWatchRoots(opts) {
         applicationRoots.push(localesRoot);
     if (existsSync(designsRoot))
         applicationRoots.push(designsRoot);
-    /** @type {Set<string>} */
     const depSet = new Set();
     const depJson = path.join(outDir, 'vmz-deployment.json');
     if (existsSync(depJson)) {
@@ -209,18 +190,6 @@ export function collectDevWatchRoots(opts) {
     }
     return { roots, dependencyRoots, applicationRoots };
 }
-/**
- * Classify which watch bucket a root belongs to.
- * @param {string} root
- * @param {{
- *   src: string,
- *   docsRoot: string,
- *   localesRoot: string,
- *   designsRoot: string,
- *   dependencyRoots: string[],
- * }} ctx
- * @returns {'src' | 'locales' | 'docs' | 'designs' | 'dep' | 'other'}
- */
 export function classifyWatchRoot(root, ctx) {
     if (root === ctx.src)
         return 'src';

package/dist/document-build.d.ts

@@ -1,100 +1,25 @@
-/**
- * @param {{ projectRoot: string, outDir?: string, appDistDir?: string, strict?: boolean, engines?: { markdown?: string } }} opts
- */
-export declare function buildDocuments(opts: any): Promise<{
-    ok: boolean;
-    manifest: {
-        schema: string;
-        root: string;
-        defaultLocale: any;
-        locales: any[];
-        localeLabels: any;
-        collections: any[];
-        mounts: any[];
-        pages: {
-            identity: any;
-            sourcePath: any;
-            route: any;
-            anchors: any[];
-        }[];
-        diagnostics: any[];
+import { buildDocumentIslands, buildDocumentSearch } from './document-interactive.js';
+import { type DocumentManifest } from './document-schema.js';
+export interface BuildDocumentsOpts {
+    projectRoot: string;
+    outDir?: string;
+    appDistDir?: string;
+    strict?: boolean;
+    engines?: {
+        markdown?: string;
     };
-    outDir: string;
-    pages: any[];
-    search?: undefined;
-    islands?: undefined;
-} | {
+}
+export interface BuildDocumentsPageResult {
+    route: string;
+    htmlPath: string;
+    viewPath: string;
+}
+export interface BuildDocumentsResult {
     ok: boolean;
-    manifest: {
-        schema: string;
-        evidence: {
-            schema: string;
-            fences: any[];
-            apiRefs: any[];
-            testSelections: any[];
-            status: string;
-        };
-        search: {
-            schema: string;
-            status: string;
-            version: any;
-            records: any[];
-        };
-        islands: {
-            schema: string;
-            hydrate: string;
-            fullPageHydrate: boolean;
-            islands: {
-                name: string;
-                kind: string;
-                resume: string;
-                index: any;
-            }[];
-            status: string;
-        };
-        build: {
-            engine: any;
-            outDir: string;
-            designs: string;
-            designsCss: any;
-            hostShell: string;
-            pages: any[];
-            evidence: string;
-            search: string;
-            islands: string;
-        };
-        root: string;
-        defaultLocale: any;
-        locales: any[];
-        localeLabels: any;
-        collections: any[];
-        mounts: any[];
-        pages: {
-            identity: any;
-            sourcePath: any;
-            route: any;
-            anchors: any[];
-        }[];
-        diagnostics: any[];
-    };
+    manifest: DocumentManifest;
     outDir: string;
-    pages: any[];
-    search: {
-        schema: string;
-        status: string;
-        version: any;
-        records: any[];
-    };
-    islands: {
-        schema: string;
-        hydrate: string;
-        fullPageHydrate: boolean;
-        islands: {
-            name: string;
-            kind: string;
-            resume: string;
-            index: any;
-        }[];
-        status: string;
-    };
-}>;
+    pages: BuildDocumentsPageResult[];
+    search?: ReturnType<typeof buildDocumentSearch>;
+    islands?: ReturnType<typeof buildDocumentIslands>;
+}
+export declare function buildDocuments(opts: BuildDocumentsOpts): Promise<BuildDocumentsResult>;