@vmz/core 0.1.6 → 0.1.8

package/dist/client-nav.js

@@ -437,10 +437,11 @@ export function installClientNavigation(opts = {}) {
     let localeTransitionGeneration = 0;
     /**
      * Atomic LocaleTransition (browser host slice):
-     * validate → realize path → navigate/fetch → commit locale attrs from SSR HTML.
+     * - prefix: validate → realize path → navigate/fetch → commit locale attrs from SSR HTML
+     * - none: validate → Host persist (localStorage+cookie) → commit attrs → reload (v1; no URL rewrite)
      * Failure keeps the previous locale surface (no half-page commit).
      * @param {string} toLocale
-     * @param {{ replace?: boolean }} [opts]
+     * @param {{ replace?: boolean, reload?: boolean }} [opts]
      */
     async function transitionLocale(toLocale, opts = {}) {
         const fromLocale = doc.documentElement?.getAttribute('data-locale') || null;
@@ -480,6 +481,10 @@ export function installClientNavigation(opts = {}) {
                 win.__vmzLastLocaleTransition = out;
             return out;
         }
+        const strategy = routing.strategy || 'prefix';
+        if (strategy === 'none') {
+            return transitionLocaleNone(toLocale, fromLocale, opts);
+        }
         const gen = ++localeTransitionGeneration;
         const targetHref = realizePathForLocale(loc.pathname + loc.search + loc.hash, toLocale, routing);
         const result = await transitionTo(targetHref, { replace: opts.replace !== false, softFail: true });
@@ -539,6 +544,64 @@ export function installClientNavigation(opts = {}) {
             win.__vmzLastLocaleTransition = out;
         return out;
     }
+    /**
+     * `routing.strategy: 'none'` — LocaleId is Host preference, not URL.
+     * Persist → commit document attrs + hint → full reload so `#locales/*` re-resolve (I2 v1).
+     * @param {string} toLocale
+     * @param {string | null} fromLocale
+     * @param {{ reload?: boolean }} [opts]
+     */
+    function transitionLocaleNone(toLocale, fromLocale, opts = {}) {
+        const STORE_KEY = 'vmz.locale';
+        try {
+            try {
+                localStorage.setItem(STORE_KEY, toLocale);
+            }
+            catch {
+                /* private mode */
+            }
+            try {
+                doc.cookie = `${STORE_KEY}=${encodeURIComponent(toLocale)}; path=/; max-age=31536000; SameSite=Lax`;
+            }
+            catch {
+                /* ignore */
+            }
+            if (doc.documentElement) {
+                doc.documentElement.setAttribute('data-locale', toLocale);
+                doc.documentElement.setAttribute('lang', toLocale);
+            }
+            if (win)
+                win.__vmzLocaleIdHint = toLocale;
+        }
+        catch (err) {
+            const out = {
+                status: 'rolled_back',
+                fromLocale,
+                toLocale,
+                reason: 'persist_failed',
+                detail: err && err.message ? String(err.message) : String(err),
+            };
+            if (win)
+                win.__vmzLastLocaleTransition = out;
+            return out;
+        }
+        const out = {
+            status: 'committed',
+            fromLocale,
+            toLocale,
+            reason: 'ok',
+            strategy: 'none',
+            href: loc.pathname + loc.search,
+            reload: opts.reload !== false,
+        };
+        if (win)
+            win.__vmzLastLocaleTransition = out;
+        // Reload so generated `#locales` modules re-run __vmzLocaleId() with new preference.
+        if (opts.reload !== false && loc && typeof loc.reload === 'function') {
+            loc.reload();
+        }
+        return out;
+    }
     /**
      * @returns {{ strategy?: string, defaultPrefix?: string, defaultLocale?: string, locales?: string[] } | null}
      */

package/dist/dom-ssr.js

@@ -425,8 +425,8 @@ function* streamSerializeChunks(node) {
     }
 }
 /**
- * Document-free rowKernel SSR: fill generator text placeholders (` `) from textSlots + item.
- * Prefer this over linkedom — createItem was omitted because html + slots are enough.
+ * Document-free rowKernel SSR fill (transitional / pre-0.1.7 emit only).
+ * Prefer `serializeItem` (IR schedule). Do not treat this as the long-term contract.
  * @param {{ html: string, textSlots?: Record<string, number>, hostFields?: string[] }} rk
  * @param {any} item
  * @param {any} key
@@ -731,7 +731,12 @@ const serializeApi = {
             if (typeof spec.createItem === 'function') {
                 dom = spec.createItem.call(inst, serializeApi, box);
             }
+            else if (typeof spec.serializeItem === 'function') {
+                // IR-homologous schedule (v0.1.7): same Direct body as fat createItem.
+                dom = spec.serializeItem.call(inst, serializeApi, box);
+            }
             else if (spec.rowKernel && typeof spec.rowKernel.html === 'string') {
+                // Transitional only: pre-0.1.7 emit without serializeItem.
                 dom = serializeRowFromKernel(inst, spec.rowKernel, box, k);
             }
             if (dom) {

package/dist/serve-host.mjs

@@ -16,7 +16,7 @@
  * 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.
  */
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { readdir, readFile, writeFile } from 'node:fs/promises';
 import http from 'node:http';
 import { createRequire, registerHooks } from 'node:module';
@@ -75,6 +75,8 @@ if (isDev) {
 }
 /** @type {number} */
 let reloadToken = Date.now();
+/** @type {string | null} Correlatable build id from vmz dev (Living §12.8). */
+let lastDevBuildId = null;
 /** @type {Array<{ chunkId: string, pageRel: string, segs: ReturnType<typeof parseChunkSegments> }>} */
 let pageCatalog = [];
 /** @type {Map<string, any>} */
@@ -152,7 +154,7 @@ async function renderPageStream(pathname, opts = {}) {
     if (isDev && lastDevError && pageCtors.size === 0) {
         return { status: 500, stream: emitDevErrorHtml(lastDevError) };
     }
-    const localePlan = resolveLocalePath(pathname);
+    const localePlan = resolveLocalePath(pathname, opts.cookieHeader);
     if (localePlan.redirectTo) {
         return { status: 302, redirect: localePlan.redirectTo, headers: { Location: localePlan.redirectTo } };
     }
@@ -477,10 +479,15 @@ 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>`
+        : '';
     if (signal?.aborted)
         return;
     const themeId = resolveThemeId(opts.searchParams, opts.cookieHeader);
     const themeBoot = themeBootstrapScript();
+    const localeBoot = localeBootstrapScript();
+    const faviconHead = siteFaviconHeadHtml();
     const propsJson = JSON.stringify(props ?? {});
     const localeId = localeCtx.localeId || localeArtifact?.defaultLocale || 'en';
     const dir = localeCtx.dir || 'ltr';
@@ -552,9 +559,9 @@ async function* emitPageHtml(Page, chunkId, eventOnlyShell, props = {}, opts = {
         ...(cssHref ? { cssEntry: cssHref } : {}),
         isErrorDocument: false,
         htmlExtraAttrs,
-        headExtraHtml: themeBoot,
+        headExtraHtml: `${themeBoot}${localeBoot}${faviconHead}`,
         moduleScriptSrc: entrySrc,
-        bodyTailHtml: `${live}${bootOverlay}`,
+        bodyTailHtml: `${live}${bootOverlay}${buildIdBoot}`,
     });
 }
 const server = http.createServer((req, res) => {
@@ -670,7 +677,7 @@ process.on('SIGINT', () => {
  * Re-import routes / pages / components with a new cache-bust token.
  * Keeps the HTTP server process alive (no Node restart).
  * Failed reloads keep the previous in-memory modules (Vite-like resilience).
- * @param {{ quiet?: boolean, payload?: { affectedChunks?: string[], seedChunks?: string[], emitted?: string[], full?: boolean, islandHmr?: boolean } }} [opts]
+ * @param {{ quiet?: boolean, payload?: { affectedChunks?: string[], seedChunks?: string[], emitted?: string[], full?: boolean, islandHmr?: boolean, buildId?: string, sourceRevision?: string, bundleRevision?: string, changed?: string[] } }} [opts]
  */
 async function softReload(opts = {}) {
     const prevToken = reloadToken;
@@ -683,6 +690,11 @@ async function softReload(opts = {}) {
     const emitted = opts.payload?.emitted ?? [];
     const full = opts.payload?.full;
     const islandHmr = Boolean(opts.payload?.islandHmr);
+    const buildId = opts.payload?.buildId != null ? String(opts.payload.buildId) : null;
+    const sourceRevision = opts.payload?.sourceRevision != null ? String(opts.payload.sourceRevision) : null;
+    const bundleRevision = opts.payload?.bundleRevision != null ? String(opts.payload.bundleRevision) : null;
+    if (buildId)
+        lastDevBuildId = buildId;
     const reloadAllPages = shouldReloadAllPages({ full, affected, emitted, islandHmr });
     try {
         try {
@@ -772,13 +784,21 @@ async function softReload(opts = {}) {
             affectedChunks: affected,
             seedChunks: seeds,
             token: reloadToken,
+            buildId: buildId || lastDevBuildId,
+            sourceRevision,
+            bundleRevision,
+            serveRevision: String(reloadToken),
             full: Boolean(full),
             eventOnlyShell,
         }));
         if (!opts.quiet) {
             const aff = affected.length > 0 ? ` affected=[${affected.join(', ')}]` : full === false ? ' affected=[]' : '';
             const scope = islandHmr ? 'island' : reloadAllPages ? 'all-pages' : `pages=${nextCtors.size}`;
-            console.log(`vmz serve: soft reload ok (mode=${mode}; ${scope}; catalog=${pageCatalog.length}; t=${reloadToken}${aff})`);
+            const bid = buildId || lastDevBuildId;
+            const rev = bid || sourceRevision || bundleRevision
+                ? ` buildId=${bid || '-'} source=${sourceRevision || '-'} bundle=${bundleRevision || '-'} serve=${reloadToken}`
+                : ` t=${reloadToken}`;
+            console.log(`vmz serve: soft reload ok (mode=${mode}; ${scope}; catalog=${pageCatalog.length};${rev}${aff})`);
         }
         return {
             affectedChunks: affected,
@@ -790,6 +810,11 @@ async function softReload(opts = {}) {
             pageCount: pageCatalog.length,
             reloadedPages: islandHmr ? 0 : nextCtors.size,
             reloadAllPages,
+            buildId: buildId || lastDevBuildId,
+            sourceRevision,
+            bundleRevision,
+            serveRevision: String(reloadToken),
+            token: reloadToken,
         };
     }
     catch (err) {
@@ -899,11 +924,14 @@ function escapeHtml(s) {
     return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
 }
 /**
- * Resolve LocaleId from pathname using `_vmz/locale-route-realization.json`.
- * LocaleId is a realization dimension — matching still uses stable route path.
+ * Resolve LocaleId for this request.
+ * - `prefix`: LocaleId from URL path (existing).
+ * - `none`: Host preference from cookie `vmz.locale` (validated), else defaultLocale.
+ *   URL never carries LocaleId.
  * @param {string} pathname
+ * @param {string | undefined} cookieHeader
  */
-function resolveLocalePath(pathname) {
+function resolveLocalePath(pathname, cookieHeader) {
     const raw = String(pathname || '/');
     const normalized = raw.length > 1 && raw.endsWith('/') ? raw.slice(0, -1) : raw || '/';
     if (!localeArtifact) {
@@ -913,6 +941,17 @@ function resolveLocalePath(pathname) {
     const defaultLocale = localeArtifact.defaultLocale || supported[0] || 'en';
     const directions = Object.fromEntries((localeArtifact.locales || []).map((l) => [l.id, l.direction || 'ltr']));
     const routing = localeArtifact.routing || {};
+    const strategy = routing.strategy || 'prefix';
+    if (strategy === 'none') {
+        const preferred = readCookie(cookieHeader, LOCALE_STORE_KEY);
+        const localeId = preferred && supported.includes(preferred) ? preferred : defaultLocale;
+        return {
+            localeId,
+            dir: directions[localeId] || 'ltr',
+            restPath: normalized,
+            redirectTo: null,
+        };
+    }
     const parts = normalized.split('/').filter(Boolean);
     let localeId = null;
     let restPath = normalized;
@@ -1442,6 +1481,8 @@ function requireNativeGenerator() {
  * Style Theme cookie / localStorage key (host contract, not a second theme API).
  */
 const THEME_STORE_KEY = 'vmz-theme';
+/** Host preference key for `routing.strategy: 'none'` (cookie + localStorage). */
+const LOCALE_STORE_KEY = 'vmz.locale';
 /**
  * @param {string} dir
  * @returns {Promise<{ cssEntry: string|null, styleTheme: typeof styleTheme, styleBundleHash: string|null }>}
@@ -1517,6 +1558,45 @@ function themeBootstrapScript() {
     const key = JSON.stringify(THEME_STORE_KEY);
     return `  <script>(function(){try{var k=${key},attr=${attr},ids=${ids};var id=localStorage.getItem(k);if(!id||ids.indexOf(id)<0)return;document.documentElement.setAttribute(attr,id);}catch(e){}})();</script>\n`;
 }
+/**
+ * LocaleId as client state (routing.strategy = none): apply localStorage before any
+ * page/client module runs so `#locales/*` pick the right variant. Prefix strategy
+ * keeps LocaleId in the URL — no boot rewrite.
+ * Also mirrors into cookie so the next SSR negotiate sees Host preference.
+ */
+function localeBootstrapScript() {
+    if (!localeArtifact)
+        return '';
+    const routing = localeArtifact.routing || {};
+    if ((routing.strategy || 'prefix') !== 'none')
+        return '';
+    const ids = (localeArtifact.locales || []).map((l) => l.id).filter(Boolean);
+    if (!ids.length)
+        return '';
+    const key = JSON.stringify(LOCALE_STORE_KEY);
+    const idList = JSON.stringify(ids);
+    return `  <script>(function(){try{var k=${key},ids=${idList};var id=localStorage.getItem(k);if(!id||ids.indexOf(id)<0)return;document.documentElement.setAttribute("data-locale",id);document.documentElement.setAttribute("lang",id);window.__vmzLocaleIdHint=id;document.cookie=k+"="+encodeURIComponent(id)+"; path=/; max-age=31536000; SameSite=Lax";}catch(e){}})();</script>\n`;
+}
+/**
+ * Site favicon links from build artifact `_vmz/site-favicon.json` (author SVG → PNG/ICO).
+ * Empty when skipped / missing — do not invent broken <link>s.
+ */
+function siteFaviconHeadHtml() {
+    try {
+        const p = path.join(distDir, '_vmz', 'site-favicon.json');
+        if (!existsSync(p))
+            return '';
+        // Sync read: head is per-request; file is tiny and rebuilt with dist.
+        const raw = readFileSync(p, 'utf8');
+        const j = JSON.parse(raw);
+        if (j?.status !== 'ready' || typeof j.headHtml !== 'string')
+            return '';
+        return j.headHtml;
+    }
+    catch {
+        return '';
+    }
+}
 /**
  * @param {string|undefined} header
  * @param {string} name

package/dist/server.js

@@ -690,12 +690,15 @@ function sendHtml(res, status, html) {
  * @param {AbortSignal} [signal]
  */
 async function sendHtmlStream(res, status, source, signal) {
-    res.writeHead(status, {
+    const aborted = () => Boolean(signal?.aborted || res.destroyed || res.writableEnded || !res.writable);
+    const headers = {
         'content-type': 'text/html; charset=utf-8',
         'transfer-encoding': 'chunked',
         'cache-control': 'no-cache',
-    });
-    const aborted = () => Boolean(signal?.aborted || res.destroyed || res.writableEnded || !res.writable);
+    };
+    // Defer writeHead until the first successful chunk so SSR throw → clean 500
+    // (not headersSent + destroy → ERR_EMPTY_RESPONSE).
+    let started = false;
     try {
         for await (const chunk of source) {
             if (aborted())
@@ -703,6 +706,10 @@ async function sendHtmlStream(res, status, source, signal) {
             if (chunk == null || chunk === '')
                 continue;
             const s = typeof chunk === 'string' ? chunk : String(chunk);
+            if (!started) {
+                res.writeHead(status, headers);
+                started = true;
+            }
             const ok = res.write(s);
             if (!ok) {
                 await Promise.race([
@@ -720,12 +727,18 @@ async function sendHtmlStream(res, status, source, signal) {
                     break;
             }
         }
+        if (!started && !aborted()) {
+            res.writeHead(status, headers);
+            started = true;
+        }
     }
     catch (err) {
-        if (!aborted())
-            throw err;
+        if (aborted())
+            return;
+        // Before headers: let outer handler sendJson(500). After headers: rethrow → destroy.
+        throw err;
     }
-    if (!res.writableEnded && !res.destroyed) {
+    if (started && !res.writableEnded && !res.destroyed) {
         res.end();
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/core",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "description": "VMZ production runtime core — DOM / SSR / HTTP / WriteBarrier (no compiler)",
   "exports": {