@vmz/core 0.1.32 → 0.2.0

package/dist/{list-client-components.js → host/list-client-components.js}

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Discover compiled client component modules from Deployment Plan only.
  * Shared by serve-host SSR, static emit, and test hosts (plan-only host).
@@ -8,11 +7,6 @@ import { pathToFileURL } from 'node:url';
 import { componentEntriesFromDeployment, dedupeComponentEntriesByTag, mergeExplicitComponentEntries, readDeploymentDocument, } from './deployment-registry.js';
 export { DEPLOYMENT_SCHEMA, readDeploymentDocument, componentEntriesFromDeployment, collectDependsOnClosure, dedupeComponentEntriesByTag, mergeExplicitComponentEntries, loadComponentEntries, importAndRegisterComponentEntries, bootstrapComponentRegistry, } from './deployment-registry.js';
 export { createRenderHost } from './render-host.js';
-/**
- * @param {string} dir
- * @param {{ strict?: boolean }} [opts]
- * @returns {Promise<Array<{ name: string, entry: string, chunkId?: string }>>}
- */
 export async function listClientComponents(dir, opts = {}) {
     const strict = opts.strict === true;
     const deployment = readDeploymentDocument(dir, { strict });
@@ -33,12 +27,6 @@ export async function listClientComponents(dir, opts = {}) {
     }
     return [];
 }
-/**
- * Sync variant for callers that already use fs sync (legacy static-emit helpers).
- * @param {string} dir
- * @param {{ strict?: boolean }} [opts]
- * @returns {Array<{ name: string, entry: string, chunkId?: string }>}
- */
 export function listClientComponentsSync(dir, opts = {}) {
     const strict = opts.strict === true;
     const deployment = readDeploymentDocument(dir, { strict });
@@ -59,11 +47,6 @@ export function listClientComponentsSync(dir, opts = {}) {
     }
     return [];
 }
-/**
- * @param {Array<{ name: string, entry: string, chunkId?: string }>} entries
- * @param {Record<string, string> | undefined} explicit
- * @returns {Array<{ name: string, entry: string, chunkId?: string }>}
- */
 export function mergeComponentEntries(entries, explicit) {
     const normalized = entries.map((e) => ({
         chunkId: e.chunkId || `components/${e.name}`,
@@ -76,12 +59,6 @@ export function mergeComponentEntries(entries, explicit) {
         chunkId: e.chunkId,
     }));
 }
-/**
- * @param {string} distDir
- * @param {Record<string, string> | undefined} [explicit]
- * @param {{ strict?: boolean, closureRoots?: string[] }} [opts]
- * @returns {Promise<Array<{ name: string, entry: string, chunkId?: string }>>}
- */
 export async function resolveComponentEntries(distDir, explicit, opts = {}) {
     const { loadComponentEntries } = await import('./deployment-registry.js');
     const entries = await loadComponentEntries(distDir, {
@@ -91,19 +68,6 @@ export async function resolveComponentEntries(distDir, explicit, opts = {}) {
     });
     return entries.map((e) => ({ name: e.name, entry: e.entry, chunkId: e.chunkId }));
 }
-/**
- * Import all (or filtered) client components and register for SSR / static emit / test hosts.
- * @param {string} distDir
- * @param {(map: Record<string, unknown>) => void} registerComponents
- * @param {{
- *   cacheBust?: string | number,
- *   include?: (entry: { name: string, entry: string, chunkId?: string }) => boolean,
- *   explicit?: Record<string, string>,
- *   strict?: boolean,
- *   closureRoots?: string[],
- *   preload?: 'all' | 'closure' | 'none',
- * }} [opts]
- */
 export async function preloadComponentRegistry(distDir, registerComponents, opts = {}) {
     let entries = await resolveComponentEntries(distDir, opts.explicit, {
         strict: opts.strict,
@@ -111,7 +75,6 @@ export async function preloadComponentRegistry(distDir, registerComponents, opts
     });
     if (opts.include)
         entries = entries.filter((e) => opts.include(e));
-    /** @type {Record<string, unknown>} */
     const map = {};
     for (const entry of entries) {
         const abs = path.join(distDir, entry.entry);

package/dist/{localize-body-links.js → host/localize-body-links.js}

@@ -82,7 +82,6 @@ export function localizeBodyLinks(html, localeId, artifact, escapeAttr, frozenPl
 }
 /** Compact RouteId → LocaleId → href table for browser (no path-prefix algebra). */
 export function localeHrefTableFromPlan(plan) {
-    /** @type {Record<string, Record<string, string>>} */
     const out = Object.create(null);
     for (const row of plan?.rows || []) {
         if (!row?.routeId || !row?.localeId || !row?.href)

package/dist/host/native-addon.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Discover and load the vmz N-API addon (same contract as `@vmz/vmz` loadNative).
+ */
+import type { NativeAddon } from '../shared/host.types.js';
+export declare function loadNativeAddon(): NativeAddon;
+export declare function requireNativeFn(fnName: string): (...args: unknown[]) => unknown;

package/dist/{native-addon.js → host/native-addon.js}

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Discover and load the vmz N-API addon (same contract as `@vmz/vmz` loadNative).
  */
@@ -7,11 +6,7 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 const require = createRequire(import.meta.url);
-/** @type {any | null | undefined} */
 let _nativeAddon;
-/**
- * @returns {string}
- */
 function platformTriple() {
     const { platform, arch } = process;
     if (platform === 'win32' && arch === 'x64')
@@ -28,10 +23,6 @@ function platformTriple() {
         return 'linux-arm64-gnu';
     return `${platform}-${arch}`;
 }
-/**
- * @param {string} triple
- * @returns {string}
- */
 function platformShort(triple) {
     if (triple === 'win32-x64-msvc')
         return 'win32-x64';
@@ -43,14 +34,10 @@ function platformShort(triple) {
         return 'linux-arm64';
     return triple;
 }
-/**
- * @returns {string[]}
- */
 function nativeCandidatePaths() {
     const triple = platformTriple();
     const short = platformShort(triple);
     const name = `@vmz/vmz-${short}`;
-    /** @type {string[]} */
     const candidates = [];
     try {
         const resolved = require.resolve(`${name}/package.json`);
@@ -70,9 +57,6 @@ function nativeCandidatePaths() {
     }
     return candidates;
 }
-/**
- * @returns {any}
- */
 export function loadNativeAddon() {
     if (_nativeAddon !== undefined) {
         if (!_nativeAddon) {
@@ -102,10 +86,6 @@ export function loadNativeAddon() {
     }
     return _nativeAddon;
 }
-/**
- * @param {string} fnName
- * @returns {any}
- */
 export function requireNativeFn(fnName) {
     const native = loadNativeAddon();
     const fn = native[fnName];

package/dist/host/render-host.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Unified SSR/DOM render host — explicit deployment bootstrap before renderToString/stream/mount.
+ * Hosts must not call renderToString until ensureComponents() has run for the active closure.
+ */
+export declare function createRenderHost(distDir: string, opts?: Record<string, unknown>): Promise<{
+    distDir: string;
+    deployment: import("../shared/host.types.js").DeploymentDocument;
+    dom: any;
+    loadedChunkIds: Set<string>;
+    ensureComponents: (rootChunkIds: any) => Promise<import("../shared/host.types.js").ComponentRegistryMap>;
+    closureChunkIds: (rootChunkIds: any) => Set<unknown>;
+    renderToString: any;
+    renderToStream: any;
+    mount: any;
+    hydrate: any;
+    resume: any;
+    destroy: any;
+    flushPending: any;
+    registerComponents: any;
+}>;

package/dist/{render-host.js → host/render-host.js}

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Unified SSR/DOM render host — explicit deployment bootstrap before renderToString/stream/mount.
  * Hosts must not call renderToString until ensureComponents() has run for the active closure.
@@ -6,23 +5,11 @@
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { bootstrapComponentRegistry, collectDependsOnClosure, loadComponentEntries, readDeploymentDocument, importAndRegisterComponentEntries, } from './deployment-registry.js';
-/**
- * @param {string} distDir
- * @param {{
- *   strictDeployment?: boolean,
- *   strict?: boolean,
- *   explicit?: Record<string, string>,
- *   cacheBust?: string | number,
- *   preload?: 'all' | 'closure' | 'none',
- *   closureRoots?: string[],
- * }} [opts]
- */
 export async function createRenderHost(distDir, opts = {}) {
     const strict = opts.strictDeployment === true || opts.strict === true;
     const domPath = path.join(distDir, 'vmz-dom.js');
     const dom = await import(pathToFileURL(domPath).href);
     const deployment = readDeploymentDocument(distDir, { strict });
-    /** @type {Set<string>} */
     const loadedChunkIds = new Set();
     const bootstrapOpts = {
         strict,
@@ -37,7 +24,6 @@ export async function createRenderHost(distDir, opts = {}) {
     }
     /**
      * Load component closure for root chunk ids (page + layouts + fixture).
-     * @param {string[]} rootChunkIds
      */
     async function ensureComponents(rootChunkIds) {
         if (!rootChunkIds?.length)
@@ -54,7 +40,6 @@ export async function createRenderHost(distDir, opts = {}) {
     }
     /**
      * Union closure chunk ids (pages + layouts) without importing yet.
-     * @param {string[]} rootChunkIds
      */
     function closureChunkIds(rootChunkIds) {
         if (!deployment || !rootChunkIds?.length)
@@ -75,7 +60,6 @@ export async function createRenderHost(distDir, opts = {}) {
         resume: dom.resume?.bind(dom),
         destroy: dom.destroy?.bind(dom),
         flushPending: dom.flushPending?.bind(dom),
-        /** @deprecated Prefer ensureComponents via createRenderHost; low-level escape hatch. */
         registerComponents: dom.registerComponents.bind(dom),
     };
 }

package/dist/{serve-host.d.ts → host/serve-host.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Generic VMZ Node host — SSR Route Graph pages + dist static + RPC/REST.
+ * Generic VMZ Node host �?SSR Route Graph pages + dist static + RPC/REST.
  *
  * Invoked by `vmz serve` / `vmz dev` (or: node dist/vmz-serve-host.mjs).
  *
@@ -9,8 +9,8 @@
  *
  * `VMZ_DEV=1`: POST `/__vmz/reload` soft-reloads modules (cache-bust import);
  * GET `/__vmz/events` SSE notifies the browser:
- * - island HMR → re-import `entry-client.js` (no full document reload)
- * - otherwise → `location.reload`
+ * - island HMR �?re-import `entry-client.js` (no full document reload)
+ * - otherwise �?`location.reload`
  *
  * Dev resolve hook propagates `?t=` onto nested relative `file:` imports under
  * dist so soft reload does not keep a stale `lib/*.js` ESM cache entry.