@vmz/vmz 0.1.13 → 0.1.14

package/dist/release-pack.js

@@ -9,6 +9,8 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
+import { writePrettyJsonFile } from './pretty-json.js';
+import { listPublicPageUnits, unitBrowserPathPattern } from './route-path.js';
 export const RELEASE_ENVELOPE_SCHEMA = 'vmz.release.envelope.v0';
 export const APPLICATION_ARTIFACT_SCHEMA = 'vmz.application.artifact.v0';
 export const DELIVERY_ARTIFACT_MANIFEST_SCHEMA = 'vmz.profile.delivery_artifact_manifest.v0';
@@ -88,21 +90,6 @@ function listContentFiles(distDir) {
     out.sort();
     return out;
 }
-/**
- * @param {string} chunkId
- */
-function pathPatternFromChunk(chunkId) {
-    const rel = chunkId.replace(/^pages\//, '');
-    const parts = rel.split('/').filter(Boolean);
-    const segs = [];
-    for (let i = 0; i < parts.length; i++) {
-        const p = parts[i];
-        if (p === 'index' && i === parts.length - 1)
-            continue;
-        segs.push(p);
-    }
-    return segs.length ? `/${segs.join('/')}` : '/';
-}
 /**
  * Pack `dist/` into `_vmz` manifests + release envelope (filesystem Delivery Profile).
  * @param {string} distDir
@@ -124,13 +111,13 @@ export function packRelease(distDir, opts = {}) {
     for (const rel of files) {
         fileDigests[rel] = sha256File(path.join(abs, ...rel.split('/')));
     }
-    const pages = (deployment.units || []).filter((u) => u.kind === 'page');
+    const pages = listPublicPageUnits(deployment);
     const routeRealization = {
         schema: ROUTE_REALIZATION_TABLE_SCHEMA,
         routes: pages.map((u) => ({
             routeId: String(u.chunkId),
             chunkId: String(u.chunkId),
-            pathPattern: pathPatternFromChunk(String(u.chunkId)),
+            pathPattern: unitBrowserPathPattern(u),
             clientEntry: u.clientEntry || null,
             programIr: u.programIr || null,
         })),
@@ -200,7 +187,7 @@ export function packRelease(distDir, opts = {}) {
  * @param {unknown} value
  */
 function writeJson(file, value) {
-    fs.writeFileSync(file, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+    writePrettyJsonFile(file, value);
 }
 /**
  * @param {string} pointerPath

package/dist/route-path.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Browser HTTP path projection from Route Graph / `vmz-deployment.json`.
+ * Mini pack ignores this and lowers RouteId → chunk id → page stem.
+ */
+export declare function isRouteBoundaryStem(stem: string): boolean;
+export declare function isRouteGroupDir(seg: string): boolean;
+/**
+ * File-route fallback (`pages/home` → `/home`, `pages/index` → `/`).
+ * Used only when a deployment unit has no `pathPattern`.
+ */
+export declare function filePathPatternFromChunk(chunkId: string): string;
+export type DeploymentPageUnit = {
+    kind?: string;
+    chunkId?: string;
+    clientEntry?: string;
+    programIr?: string;
+    pathPattern?: string;
+    routeId?: string;
+};
+/** Canonical Browser HTTP pattern for a page unit. Mini must not read this. */
+export declare function unitBrowserPathPattern(unit: DeploymentPageUnit | null | undefined): string;
+export type PathSeg = {
+    kind: 'static';
+    value: string;
+} | {
+    kind: 'param';
+    name: string;
+} | {
+    kind: 'catch';
+    name: string;
+};
+export declare function parsePathPattern(pattern: string): PathSeg[];
+export declare function listPublicPageUnits(deployment: {
+    units?: DeploymentPageUnit[];
+} | null | undefined): DeploymentPageUnit[];

package/dist/route-path.js

@@ -0,0 +1,77 @@
+/**
+ * Browser HTTP path projection from Route Graph / `vmz-deployment.json`.
+ * Mini pack ignores this and lowers RouteId → chunk id → page stem.
+ */
+export function isRouteBoundaryStem(stem) {
+    return stem === 'Layout' || stem === 'Loading' || stem === 'Error' || stem === 'NotFound';
+}
+export function isRouteGroupDir(seg) {
+    return typeof seg === 'string' && seg.startsWith('(') && seg.endsWith(')') && seg.length > 2;
+}
+/**
+ * File-route fallback (`pages/home` → `/home`, `pages/index` → `/`).
+ * Used only when a deployment unit has no `pathPattern`.
+ */
+export function filePathPatternFromChunk(chunkId) {
+    const rel = String(chunkId || '').replace(/^pages\//, '');
+    const parts = rel.split('/').filter(Boolean);
+    const segs = [];
+    for (let i = 0; i < parts.length; i++) {
+        const p = parts[i];
+        if (isRouteGroupDir(p))
+            continue;
+        if (p === 'index' && i === parts.length - 1)
+            continue;
+        if (isRouteBoundaryStem(p))
+            continue;
+        segs.push(p);
+    }
+    return segs.length ? `/${segs.join('/')}` : '/';
+}
+/** Canonical Browser HTTP pattern for a page unit. Mini must not read this. */
+export function unitBrowserPathPattern(unit) {
+    const explicit = String(unit?.pathPattern || '').trim();
+    if (explicit)
+        return explicit.startsWith('/') ? explicit : `/${explicit}`;
+    return filePathPatternFromChunk(String(unit?.chunkId || ''));
+}
+export function parsePathPattern(pattern) {
+    const raw = String(pattern || '').trim();
+    if (!raw || raw === '/')
+        return [];
+    const parts = raw.replace(/^\/+/, '').replace(/\/+$/, '').split('/').filter(Boolean);
+    const segs = [];
+    for (const p of parts) {
+        if (isRouteGroupDir(p))
+            continue;
+        segs.push(parsePathSegment(p));
+    }
+    return segs;
+}
+function parsePathSegment(p) {
+    const catchAll = /^\[\.\.\.([^\]]+)\]$/.exec(p);
+    const star = /^\*([A-Za-z_][\w]*)$/.exec(p);
+    const param = /^\[([^\]]+)\]$/.exec(p);
+    const colon = /^:([A-Za-z_][\w]*)$/.exec(p);
+    if (catchAll)
+        return { kind: 'catch', name: catchAll[1] };
+    if (star)
+        return { kind: 'catch', name: star[1] };
+    if (param)
+        return { kind: 'param', name: param[1] };
+    if (colon)
+        return { kind: 'param', name: colon[1] };
+    return { kind: 'static', value: p.toLowerCase() };
+}
+export function listPublicPageUnits(deployment) {
+    const units = Array.isArray(deployment?.units) ? deployment.units : [];
+    return units.filter((u) => {
+        if (u?.kind !== 'page')
+            return false;
+        const chunkId = String(u.chunkId || '').replace(/\\/g, '/');
+        if (!chunkId.startsWith('pages/'))
+            return false;
+        const stem = chunkId.split('/').pop() || '';
+        return !isRouteBoundaryStem(stem);
+    });
+}

package/dist/server-artifact.js

@@ -4,9 +4,10 @@
  */
 // @ts-nocheck
 import crypto from 'node:crypto';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { SERVER_RUNTIMES } from './delivery-profile.js';
+import { writePrettyJsonFile } from './pretty-json.js';
 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';
@@ -116,14 +117,14 @@ export function emitServerArtifact(outDir, opts = {}) {
     const vmzDir = path.join(outDir, '_vmz');
     mkdirSync(vmzDir, { recursive: true });
     const file = path.join(vmzDir, 'server-artifact.json');
-    writeFileSync(file, `${JSON.stringify(artifact, null, 2)}\n`, 'utf8');
+    writePrettyJsonFile(file, artifact);
     const adapterDir = path.join(vmzDir, 'adapters');
     mkdirSync(adapterDir, { recursive: true });
     for (const adapterId of ['worker', 'rust-host']) {
         const projection = projectServerRuntimeAdapter(artifact, adapterId);
         const dir = path.join(adapterDir, adapterId);
         mkdirSync(dir, { recursive: true });
-        writeFileSync(path.join(dir, 'adapter.json'), `${JSON.stringify(projection, null, 2)}\n`, 'utf8');
+        writePrettyJsonFile(path.join(dir, 'adapter.json'), projection);
     }
     return { artifact, path: file, httpContractDigest };
 }

package/dist/site-delivery.js

@@ -6,6 +6,7 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
+import { writePrettyJsonFile } from './pretty-json.js';
 export const SITE_DELIVERY_CONTRACT_SCHEMA = 'vmz.site.delivery_contract.v0';
 export const SITE_DELIVERY_RESOLUTION_SCHEMA = 'vmz.site.delivery_resolution.v0';
 /**
@@ -135,7 +136,7 @@ export function normalizeSiteDelivery(raw, opts = {}) {
         artifact: String(d.artifact),
         expectedCompatibility: d.expectedCompatibility || {
             runtime: 'vmz',
-            deliveryProfiles: ['web-static', 'filesystem'],
+            deliveryProfiles: ['static', 'filesystem'],
         },
         sources,
         resolutionPolicy: {
@@ -318,11 +319,11 @@ export function emitSiteDelivery(outDir, deliveryRaw, opts = {}) {
     }
     const vmzDir = path.join(outDir, '_vmz');
     fs.mkdirSync(vmzDir, { recursive: true });
-    fs.writeFileSync(path.join(vmzDir, 'site-delivery-contract.json'), `${JSON.stringify(norm.contract, null, 2)}\n`, 'utf8');
+    writePrettyJsonFile(path.join(vmzDir, 'site-delivery-contract.json'), norm.contract);
     let resolution = null;
     if (opts.probes) {
         resolution = resolveSiteRelease(norm.contract, opts.probes);
-        fs.writeFileSync(path.join(vmzDir, 'site-delivery-resolution.json'), `${JSON.stringify(resolution, null, 2)}\n`, 'utf8');
+        writePrettyJsonFile(path.join(vmzDir, 'site-delivery-resolution.json'), resolution);
     }
     return { contract: norm.contract, resolution };
 }

package/dist/site-favicon.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Site favicon: author SVG → PNG + ICO + `_vmz/site-favicon.json` head links.
+ * Convention: `assets/favicon.svg` (or `favicon.svg`) under project / already in dist.
+ */
+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?: {}): {
+    schema: string;
+    status: string;
+    source: string;
+    svg: string;
+    ico: string;
+    png: string[];
+    headHtml: string;
+} | {
+    status: string;
+    reason: string;
+};
+/**
+ * Read ready head HTML for static/SSR shells (empty when missing).
+ * @param {string} distDir
+ */
+export declare function readSiteFaviconHeadHtml(distDir: any): any;
+/**
+ * PNG-in-ICO (Vista+); widely accepted by modern browsers.
+ * @param {Array<{ png: Buffer, size: number }>} images
+ */
+export declare function packPngsIntoIco(images: any): Buffer<ArrayBuffer>;

package/dist/site-favicon.js

@@ -0,0 +1,140 @@
+/**
+ * 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;
+    const src = discoverFaviconSvg(absDist, projectRoot);
+    if (!src) {
+        return { status: 'skipped', reason: 'no assets/favicon.svg' };
+    }
+    const svgText = fs.readFileSync(src.path, 'utf8');
+    const assetsDir = path.join(absDist, 'assets');
+    fs.mkdirSync(assetsDir, { recursive: true });
+    const svgDest = path.join(assetsDir, 'favicon.svg');
+    if (path.resolve(src.path) !== path.resolve(svgDest)) {
+        fs.copyFileSync(src.path, svgDest);
+    }
+    /** @type {Buffer[]} */
+    const pngs = [];
+    if (!opts.skipNative) {
+        const native = requireNativeAddon();
+        if (typeof native.rasterizeSvgPng !== 'function') {
+            throw new Error('vmz native addon missing rasterizeSvgPng — rebuild with `pnpm napi:build`');
+        }
+        for (const px of ICO_SIZES) {
+            const buf = Buffer.from(native.rasterizeSvgPng(svgText, px));
+            pngs.push(buf);
+            fs.writeFileSync(path.join(assetsDir, `favicon-${px}.png`), buf);
+        }
+    }
+    let icoPath = null;
+    if (pngs.length) {
+        const ico = packPngsIntoIco(pngs.map((png, i) => ({ png, size: ICO_SIZES[i] })));
+        icoPath = path.join(absDist, 'favicon.ico');
+        fs.writeFileSync(icoPath, ico);
+    }
+    const headParts = [];
+    if (icoPath) {
+        headParts.push('<link rel="icon" href="/favicon.ico" sizes="any">');
+    }
+    headParts.push('<link rel="icon" href="/assets/favicon.svg" type="image/svg+xml">');
+    for (const px of ICO_SIZES) {
+        if (fs.existsSync(path.join(assetsDir, `favicon-${px}.png`))) {
+            headParts.push(`<link rel="icon" type="image/png" sizes="${px}x${px}" href="/assets/favicon-${px}.png">`);
+        }
+    }
+    const headHtml = `${headParts.join('\n')}\n`;
+    const artifact = {
+        schema: SITE_FAVICON_SCHEMA,
+        status: 'ready',
+        source: src.rel,
+        svg: 'assets/favicon.svg',
+        ico: icoPath ? 'favicon.ico' : null,
+        png: ICO_SIZES.filter((px) => fs.existsSync(path.join(assetsDir, `favicon-${px}.png`))).map((px) => `assets/favicon-${px}.png`),
+        headHtml,
+    };
+    const vmzDir = path.join(absDist, '_vmz');
+    fs.mkdirSync(vmzDir, { recursive: true });
+    writePrettyJsonFile(path.join(vmzDir, 'site-favicon.json'), artifact);
+    return artifact;
+}
+/**
+ * Read ready head HTML for static/SSR shells (empty when missing).
+ * @param {string} distDir
+ */
+export function readSiteFaviconHeadHtml(distDir) {
+    try {
+        const p = path.join(distDir, '_vmz', 'site-favicon.json');
+        if (!fs.existsSync(p))
+            return '';
+        const j = JSON.parse(fs.readFileSync(p, 'utf8'));
+        if (j?.status !== 'ready' || typeof j.headHtml !== 'string')
+            return '';
+        return j.headHtml;
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * @param {string} distDir
+ * @param {string|null} projectRoot
+ */
+function discoverFaviconSvg(distDir, projectRoot) {
+    const candidates = [path.join(distDir, 'assets', 'favicon.svg'), path.join(distDir, 'favicon.svg')];
+    if (projectRoot) {
+        candidates.push(path.join(projectRoot, 'assets', 'favicon.svg'), path.join(projectRoot, 'favicon.svg'), path.join(projectRoot, 'public', 'assets', 'favicon.svg'), path.join(projectRoot, 'public', 'favicon.svg'));
+    }
+    for (const abs of candidates) {
+        if (fs.existsSync(abs) && fs.statSync(abs).isFile()) {
+            return {
+                path: abs,
+                rel: path.relative(projectRoot || distDir, abs).replace(/\\/g, '/') || 'assets/favicon.svg',
+            };
+        }
+    }
+    return null;
+}
+/**
+ * PNG-in-ICO (Vista+); widely accepted by modern browsers.
+ * @param {Array<{ png: Buffer, size: number }>} images
+ */
+export function packPngsIntoIco(images) {
+    const count = images.length;
+    const header = Buffer.alloc(6);
+    header.writeUInt16LE(0, 0);
+    header.writeUInt16LE(1, 2);
+    header.writeUInt16LE(count, 4);
+    const entries = Buffer.alloc(16 * count);
+    /** @type {Buffer[]} */
+    const blobs = [];
+    let offset = 6 + 16 * count;
+    for (let i = 0; i < count; i += 1) {
+        const { png, size } = images[i];
+        const o = i * 16;
+        entries.writeUInt8(size >= 256 ? 0 : size, o);
+        entries.writeUInt8(size >= 256 ? 0 : size, o + 1);
+        entries.writeUInt8(0, o + 2);
+        entries.writeUInt8(0, o + 3);
+        entries.writeUInt16LE(1, o + 4);
+        entries.writeUInt16LE(32, o + 6);
+        entries.writeUInt32LE(png.length, o + 8);
+        entries.writeUInt32LE(offset, o + 12);
+        blobs.push(png);
+        offset += png.length;
+    }
+    return Buffer.concat([header, entries, ...blobs]);
+}

package/dist/static-emit.d.ts

@@ -43,6 +43,12 @@ export declare function emitWebStatic(distDir: any, opts?: {}): Promise<{
             sitemap: string;
             robots: string;
         };
+        publicAssets: {
+            schema: string;
+            status: string;
+            fileCount: number;
+            source: any;
+        };
     };
     htmlFiles: any[];
     skipped: any[];
@@ -55,6 +61,21 @@ export declare function emitWebStatic(distDir: any, opts?: {}): Promise<{
         objects: any[];
         rewrittenHtml: number;
     };
+    publicAssets: {
+        schema: string;
+        status: string;
+        reason: string;
+        fileCount: number;
+        files: any[];
+        skippedConflicts: any[];
+    } | {
+        schema: string;
+        status: string;
+        source: string;
+        fileCount: number;
+        files: any[];
+        skippedConflicts: any[];
+    };
     cdnPolicy: {
         schema: string;
         applicationId: any;