@vmz/core 0.1.26 → 0.1.27

package/dist/localize-body-links.d.ts

@@ -3,6 +3,12 @@
  * Href authority is RouteId × LocaleId realization rows — not path parsing on existing href.
  */
 export declare const LOCALE_LINK_PLAN_SCHEMA = "vmz.static.locale_link_plan.v0";
+export type LinkRouteAlias = {
+    /** Author Link `to` / `data-vmz-route` (class RouteId, e.g. IndexPage). */
+    linkRouteId: string;
+    /** Locale realization `routeId` (often chunk path, e.g. pages/index). */
+    realizationRouteId: string;
+};
 export type LocaleHrefArtifact = {
     locales?: Array<{
         id: string;
@@ -18,6 +24,11 @@ export type LocaleHrefArtifact = {
         localeId: string;
         path: string;
     }>;
+    /**
+     * Bridge author Link RouteId ↔ realization routeId.
+     * Realization artifacts historically key by chunk path; Links emit class names.
+     */
+    linkRouteAliases?: LinkRouteAlias[];
 };
 export type LocaleLinkPlanRow = {
     routeId: string;
@@ -28,6 +39,12 @@ export type LocaleLinkPlan = {
     schema: typeof LOCALE_LINK_PLAN_SCHEMA;
     rows: LocaleLinkPlanRow[];
 };
+/** Build Link RouteId aliases from deployment page units (`routeId` + `chunkId`). */
+export declare function linkRouteAliasesFromUnits(units: Array<{
+    kind?: string;
+    routeId?: string;
+    chunkId?: string;
+}> | null | undefined): LinkRouteAlias[];
 /** Build RouteId × LocaleId → href rows from locale route realization artifact. */
 export declare function buildLocaleLinkPlan(artifact: LocaleHrefArtifact | null | undefined): LocaleLinkPlan;
 /** Apply plan rows to `<a data-vmz-route="RouteId">` markers for one LocaleId. */

package/dist/localize-body-links.js

@@ -3,13 +3,41 @@
  * Href authority is RouteId × LocaleId realization rows — not path parsing on existing href.
  */
 export const LOCALE_LINK_PLAN_SCHEMA = 'vmz.static.locale_link_plan.v0';
+/** Build Link RouteId aliases from deployment page units (`routeId` + `chunkId`). */
+export function linkRouteAliasesFromUnits(units) {
+    const out = [];
+    const seen = new Set();
+    for (const unit of units || []) {
+        if (unit?.kind && unit.kind !== 'page')
+            continue;
+        const linkRouteId = typeof unit?.routeId === 'string' ? unit.routeId.trim() : '';
+        const realizationRouteId = typeof unit?.chunkId === 'string' ? unit.chunkId.replace(/\\/g, '/').trim() : '';
+        if (!linkRouteId || !realizationRouteId || linkRouteId === realizationRouteId)
+            continue;
+        const key = `${linkRouteId}\0${realizationRouteId}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push({ linkRouteId, realizationRouteId });
+    }
+    return out;
+}
 /** Build RouteId × LocaleId → href rows from locale route realization artifact. */
 export function buildLocaleLinkPlan(artifact) {
     const rows = [];
+    const aliases = artifact?.linkRouteAliases || [];
     for (const r of artifact?.realizations || []) {
         if (!r?.routeId || !r?.localeId || !r?.path)
             continue;
-        rows.push({ routeId: String(r.routeId), localeId: String(r.localeId), href: String(r.path) });
+        const realizationRouteId = String(r.routeId);
+        const localeId = String(r.localeId);
+        const href = String(r.path);
+        rows.push({ routeId: realizationRouteId, localeId, href });
+        for (const alias of aliases) {
+            if (alias.realizationRouteId === realizationRouteId && alias.linkRouteId) {
+                rows.push({ routeId: String(alias.linkRouteId), localeId, href });
+            }
+        }
     }
     rows.sort((a, b) => (a.routeId === b.routeId ? a.localeId.localeCompare(b.localeId) : a.routeId.localeCompare(b.routeId)));
     return { schema: LOCALE_LINK_PLAN_SCHEMA, rows };
@@ -32,6 +60,10 @@ export function applyLocaleLinkPlan(html, localeId, plan, escapeAttr = (s) => St
         const href = byRoute.get(rm[1]);
         if (!href)
             return full;
+        // Realization rows for dynamic routes keep unresolved patterns (`[id]` / `:id`).
+        // Do not clobber compile-time realized hrefs like `/products/sku-1`.
+        if (/\[[^\]]+\]/.test(href) || /\/:[^/]+/.test(href))
+            return full;
         const hm = attrs.match(/\bhref\s*=\s*"([^"]*)"/i);
         if (hm && hm[1] === href)
             return full;

package/dist/serve-host.mjs

@@ -22,10 +22,10 @@ import http from 'node:http';
 import { createRequire, registerHooks } from 'node:module';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { localizeBodyLinks } from './localize-body-links.js';
-import { createRenderHost } from './render-host.js';
 import { listClientComponents } from './list-client-components.js';
+import { linkRouteAliasesFromUnits, localizeBodyLinks } from './localize-body-links.js';
 import { loadNativeAddon } from './native-addon.js';
+import { createRenderHost } from './render-host.js';
 import { resolveRouteLayoutChain } from './route-layout-chain.js';
 import { handleNodeRequest, setRoutes, setServerModuleResolver } from './vmz-runtime.js';
 const require = createRequire(import.meta.url);
@@ -756,6 +756,26 @@ process.on('SIGTERM', () => {
 process.on('SIGINT', () => {
     void gracefulShutdown('SIGINT');
 });
+/**
+ * Attach author Link RouteId aliases so localizeBodyLinks can match `data-vmz-route="IndexPage"`
+ * against realization rows keyed by chunk path (`pages/index`).
+ * @param {any} artifact
+ * @param {string} dir
+ */
+function attachLinkRouteAliases(artifact, dir) {
+    if (!artifact || typeof artifact !== 'object')
+        return artifact;
+    try {
+        const dep = JSON.parse(readFileSync(path.join(dir, 'vmz-deployment.json'), 'utf8'));
+        const aliases = linkRouteAliasesFromUnits(Array.isArray(dep.units) ? dep.units : []);
+        if (!aliases.length)
+            return artifact;
+        return { ...artifact, linkRouteAliases: aliases };
+    }
+    catch {
+        return artifact;
+    }
+}
 /**
  * Re-import routes / pages / components with a new cache-bust token.
  * Keeps the HTTP server process alive (no Node restart).
@@ -791,6 +811,7 @@ async function softReload(opts = {}) {
         }
         try {
             localeArtifact = JSON.parse(await readFile(path.join(distDir, '_vmz', 'locale-route-realization.json'), 'utf8'));
+            localeArtifact = attachLinkRouteAliases(localeArtifact, distDir);
         }
         catch {
             localeArtifact = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/core",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "type": "module",
   "description": "VMZ production runtime core — DOM / SSR / HTTP / WriteBarrier (no compiler)",
   "exports": {
@@ -66,12 +66,12 @@
     "linkedom": "^0.18.13"
   },
   "optionalDependencies": {
-    "@vmz/vmz-win32-x64": "0.1.26",
-    "@vmz/vmz-win32-arm64": "0.1.26",
-    "@vmz/vmz-darwin-x64": "0.1.26",
-    "@vmz/vmz-darwin-arm64": "0.1.26",
-    "@vmz/vmz-linux-x64": "0.1.26",
-    "@vmz/vmz-linux-arm64": "0.1.26"
+    "@vmz/vmz-win32-x64": "0.1.27",
+    "@vmz/vmz-win32-arm64": "0.1.27",
+    "@vmz/vmz-darwin-x64": "0.1.27",
+    "@vmz/vmz-darwin-arm64": "0.1.27",
+    "@vmz/vmz-linux-x64": "0.1.27",
+    "@vmz/vmz-linux-arm64": "0.1.27"
   },
   "publishConfig": {
     "access": "public"