@vmz/core 0.1.8 → 0.1.9

package/dist/list-client-components.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Discover compiled client component modules from dist (deployment graph or components/).
+ * Shared by serve-host SSR and static emit assemble.
+ */
+/**
+ * @param {string} dir
+ * @returns {Promise<Array<{ name: string, entry: string }>>}
+ */
+export declare function listClientComponents(dir: any): Promise<any[]>;
+/**
+ * Sync variant for callers that already use fs sync (legacy static-emit helpers).
+ * @param {string} dir
+ * @returns {Array<{ name: string, entry: string }>}
+ */
+export declare function listClientComponentsSync(dir: any): any[];
+/**
+ * Import all (or filtered) client components and register for SSR / static emit.
+ * @param {string} distDir
+ * @param {(map: Record<string, unknown>) => void} registerComponents
+ * @param {{
+ *   cacheBust?: string | number,
+ *   include?: (entry: { name: string, entry: string }) => boolean,
+ * }} [opts]
+ */
+export declare function preloadComponentRegistry(distDir: any, registerComponents: any, opts?: {}): Promise<{}>;

package/dist/list-client-components.js

@@ -0,0 +1,120 @@
+// @ts-nocheck
+/**
+ * Discover compiled client component modules from dist (deployment graph or components/).
+ * Shared by serve-host SSR and static emit assemble.
+ */
+import fs from 'node:fs';
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/**
+ * @param {string} dir
+ * @returns {Promise<Array<{ name: string, entry: string }>>}
+ */
+export async function listClientComponents(dir) {
+    /** @type {Map<string, { name: string, entry: string }>} */
+    const byName = new Map();
+    try {
+        const raw = await readFile(path.join(dir, 'vmz-deployment.json'), 'utf8');
+        const dep = JSON.parse(raw);
+        for (const unit of dep.units || []) {
+            if (unit?.kind !== 'component')
+                continue;
+            const chunkId = String(unit.chunkId || '');
+            const name = chunkId.split('/').pop();
+            if (!name)
+                continue;
+            const entry = String(unit.clientEntry || `${chunkId}.client.js`).replace(/\\/g, '/');
+            byName.set(name, { name, entry });
+        }
+    }
+    catch {
+        /* fall through to directory scan */
+    }
+    if (byName.size === 0) {
+        const folder = path.join(dir, 'components');
+        let files = [];
+        try {
+            files = await readdir(folder);
+        }
+        catch {
+            return [];
+        }
+        for (const f of files.filter((name) => name.endsWith('.client.js'))) {
+            const name = f.replace(/\.client\.js$/, '');
+            byName.set(name, { name, entry: `components/${name}.client.js` });
+        }
+    }
+    return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Sync variant for callers that already use fs sync (legacy static-emit helpers).
+ * @param {string} dir
+ * @returns {Array<{ name: string, entry: string }>}
+ */
+export function listClientComponentsSync(dir) {
+    /** @type {Map<string, { name: string, entry: string }>} */
+    const byName = new Map();
+    const deploymentPath = path.join(dir, 'vmz-deployment.json');
+    if (fs.existsSync(deploymentPath)) {
+        try {
+            const dep = JSON.parse(fs.readFileSync(deploymentPath, 'utf8'));
+            for (const unit of dep.units || []) {
+                if (unit?.kind !== 'component')
+                    continue;
+                const chunkId = String(unit.chunkId || '');
+                const name = chunkId.split('/').pop();
+                if (!name)
+                    continue;
+                const entry = String(unit.clientEntry || `${chunkId}.client.js`).replace(/\\/g, '/');
+                byName.set(name, { name, entry });
+            }
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    if (byName.size === 0) {
+        const folder = path.join(dir, 'components');
+        let files = [];
+        try {
+            files = fs.readdirSync(folder);
+        }
+        catch {
+            return [];
+        }
+        for (const f of files.filter((name) => name.endsWith('.client.js'))) {
+            const name = f.replace(/\.client\.js$/, '');
+            byName.set(name, { name, entry: `components/${name}.client.js` });
+        }
+    }
+    return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Import all (or filtered) client components and register for SSR / static emit.
+ * @param {string} distDir
+ * @param {(map: Record<string, unknown>) => void} registerComponents
+ * @param {{
+ *   cacheBust?: string | number,
+ *   include?: (entry: { name: string, entry: string }) => boolean,
+ * }} [opts]
+ */
+export async function preloadComponentRegistry(distDir, registerComponents, opts = {}) {
+    const entries = await listClientComponents(distDir);
+    /** @type {Record<string, unknown>} */
+    const map = {};
+    for (const entry of entries) {
+        if (opts.include && !opts.include(entry))
+            continue;
+        const abs = path.join(distDir, entry.entry);
+        let href = pathToFileURL(abs).href;
+        if (opts.cacheBust != null && opts.cacheBust !== '') {
+            href = `${href}?t=${encodeURIComponent(String(opts.cacheBust))}`;
+        }
+        const mod = await import(href);
+        map[entry.name] = mod.default;
+    }
+    if (Object.keys(map).length)
+        registerComponents(map);
+    return map;
+}

package/dist/serve-host.mjs

@@ -23,6 +23,7 @@ import { createRequire, registerHooks } from 'node:module';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { registerComponents, renderToStream, renderToString } from './vmz-dom.js';
+import { listClientComponents } from './list-client-components.js';
 import { handleNodeRequest, setRoutes, setServerModuleResolver } from './vmz-runtime.js';
 const require = createRequire(import.meta.url);
 const distDir = process.env.VMZ_DIST ? path.resolve(process.env.VMZ_DIST) : path.dirname(fileURLToPath(import.meta.url));
@@ -479,9 +480,7 @@ async function* emitPageHtml(Page, chunkId, eventOnlyShell, props = {}, opts = {
             `d.innerHTML="<div style='max-width:56rem;margin:0 auto'><p style='color:#f87171;font-weight:700'>Dev Error</p><pre style='white-space:pre-wrap'>"+String(e.message||e).replace(/[<>&]/g,function(c){return {"<":"&lt;",">":"&gt;","&":"&amp;"}[c]})+"</pre></div>";` +
             `document.documentElement.appendChild(d);})();</script>`
         : '';
-    const buildIdBoot = isDev && lastDevBuildId
-        ? `\n  <script>window.__VMZ_DEV_BUILD_ID__=${JSON.stringify(lastDevBuildId)};</script>`
-        : '';
+    const buildIdBoot = isDev && lastDevBuildId ? `\n  <script>window.__VMZ_DEV_BUILD_ID__=${JSON.stringify(lastDevBuildId)};</script>` : '';
     if (signal?.aborted)
         return;
     const themeId = resolveThemeId(opts.searchParams, opts.cookieHeader);
@@ -1075,46 +1074,6 @@ async function loadPageCtor(chunkId) {
     pageCtors.set(chunkId, mod.default);
     return mod.default;
 }
-/**
- * @param {string} dir
- * @returns {Promise<Array<{ name: string, entry: string }>>}
- */
-async function listClientComponents(dir) {
-    /** @type {Map<string, { name: string, entry: string }>} */
-    const byName = new Map();
-    try {
-        const raw = await readFile(path.join(dir, 'vmz-deployment.json'), 'utf8');
-        const dep = JSON.parse(raw);
-        for (const unit of dep.units || []) {
-            if (unit?.kind !== 'component')
-                continue;
-            const chunkId = String(unit.chunkId || '');
-            const name = chunkId.split('/').pop();
-            if (!name)
-                continue;
-            const entry = String(unit.clientEntry || `${chunkId}.client.js`).replace(/\\/g, '/');
-            byName.set(name, { name, entry });
-        }
-    }
-    catch {
-        /* fall through to directory scan */
-    }
-    if (byName.size === 0) {
-        const folder = path.join(dir, 'components');
-        let files = [];
-        try {
-            files = await readdir(folder);
-        }
-        catch {
-            return [];
-        }
-        for (const f of files.filter((name) => name.endsWith('.client.js'))) {
-            const name = f.replace(/\.client\.js$/, '');
-            byName.set(name, { name, entry: `components/${name}.client.js` });
-        }
-    }
-    return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
-}
 /**
  * Discover compiled page modules. Prefer Route Graph `pathPattern` from
  * `vmz-deployment.json`; fall back to walking `pages/**` (file-route only).

package/dist/server.js

@@ -226,7 +226,7 @@ export async function handleNodeRequest(req, res, opts = {}) {
             return await writeFetchResponse(res, response);
         }
         // Static first for assets + DocumentMount (`/d/…`) so docs aren't swallowed by SSR 404 shells.
-        // web-static route HTML (`index.html`, `about/index.html`, …) is a CDN/deploy projection only —
+        // static route HTML (`index.html`, `about/index.html`, …) is a CDN/deploy projection only —
         // when Server Host SSR is active, those files must not shadow live render (local/dev ≡ SSR truth).
         if (verb === 'GET' && opts.distDir) {
             const nodePath = await import('node:path');
@@ -404,7 +404,7 @@ function safeDistFile(distDir, pathname, nodePath) {
     return full;
 }
 /**
- * web-static emits per-route HTML beside client assets. That HTML is for CDN / local-static
+ * static profile emits per-route HTML beside client assets. That HTML is for CDN / local-static
  * delivery hosts — not for Server Host when SSR is available. DocumentMount stays static.
  * @param {string} file
  * @param {string} pathname

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/core",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "type": "module",
   "description": "VMZ production runtime core — DOM / SSR / HTTP / WriteBarrier (no compiler)",
   "exports": {
@@ -27,6 +27,10 @@
     "./client-nav": {
       "types": "./dist/client-nav.d.ts",
       "default": "./dist/client-nav.js"
+    },
+    "./component-registry": {
+      "types": "./dist/list-client-components.d.ts",
+      "default": "./dist/list-client-components.js"
     }
   },
   "files": [