@vmz/vmz 0.1.24 → 0.1.25

package/dist/content-addressed-assets.d.ts

@@ -7,6 +7,7 @@
  * so barrels resolve at dist root.
  */
 export declare const CONTENT_ADDRESSED_ASSETS_SCHEMA = "vmz.content_addressed_assets.v0";
+export declare const ASSET_PLAN_SCHEMA = "vmz.asset.plan.v0";
 interface ContentAddressedAssetObject {
     logicalPath: string;
     assetPath: string;

package/dist/content-addressed-assets.js

@@ -13,6 +13,7 @@ import { requireNativeAddon } from './native-addon.js';
 import { canonicalJson, sha256Hex } from './release-pack.js';
 import { writePrettyJsonFile } from './pretty-json.js';
 export const CONTENT_ADDRESSED_ASSETS_SCHEMA = 'vmz.content_addressed_assets.v0';
+export const ASSET_PLAN_SCHEMA = 'vmz.asset.plan.v0';
 /** Immutable delivery candidates (client-facing bytes). */
 const DEFAULT_CANDIDATES = [
     'entry-client.js',
@@ -92,6 +93,14 @@ export function emitContentAddressedAssets(distDir, opts = {}) {
     const objects = [];
     const rewrites = {};
     const ordered = orderCandidates(candidates);
+    const vmzMetaDir = path.join(abs, '_vmz');
+    fs.mkdirSync(vmzMetaDir, { recursive: true });
+    writePrettyJsonFile(path.join(vmzMetaDir, 'asset-plan.json'), {
+        schema: ASSET_PLAN_SCHEMA,
+        layout: 'assets/<sha256>.<ext>',
+        immutable: true,
+        candidates: ordered,
+    });
     for (const rel of ordered) {
         // Aggregators are replaced in later passes; leaf JS must rewrite ./ → ../ so a
         // hashed barrel under assets/ never 404s on second-hop relative re-exports.

package/dist/locale-router.d.ts

@@ -132,7 +132,7 @@ export declare function parseLocaleFromPath(pathname: string, supportedLocales:
 };
 export type { LocaleHrefArtifact } from '@vmz/core/localize-body-links';
 /** Rewrite a same-app href — single implementation in `@vmz/core/localize-body-links`. */
-export { localizeBodyLinks, localizeSameAppHref } from '@vmz/core/localize-body-links';
+export { localizeBodyLinks, localizeSameAppHref, buildLocaleLinkPlan, applyLocaleLinkPlan } from '@vmz/core/localize-body-links';
 /** Plan redirect / negotiation for an incoming URL (omit-prefix aware). */
 export declare function planLocalePathNavigation(input: {
     pathname: string;

package/dist/locale-router.js

@@ -229,7 +229,7 @@ export function parseLocaleFromPath(pathname, supportedLocales) {
     return { localeId: null, restPath: normalizePath(pathname) };
 }
 /** Rewrite a same-app href — single implementation in `@vmz/core/localize-body-links`. */
-export { localizeBodyLinks, localizeSameAppHref } from '@vmz/core/localize-body-links';
+export { localizeBodyLinks, localizeSameAppHref, buildLocaleLinkPlan, applyLocaleLinkPlan } from '@vmz/core/localize-body-links';
 /** Plan redirect / negotiation for an incoming URL (omit-prefix aware). */
 export function planLocalePathNavigation(input) {
     const routing = {

package/dist/static-emit.d.ts

@@ -3,6 +3,7 @@
  * Reuses the same Direct SSR path as serve-host (no second SSG runtime).
  */
 export declare const STATIC_DELIVERY_MANIFEST_SCHEMA = "vmz.static.delivery_manifest.v0";
+export declare const STATIC_EMIT_PLAN_SCHEMA = "vmz.static.emit_plan.v0";
 export type EmitWebStaticOpts = {
     origin?: string;
     applicationId?: string;

package/dist/static-emit.js

@@ -11,13 +11,14 @@ import { resolveRouteLayoutChain } from '@vmz/core/route-layout-chain';
 import { listClientComponentsSync } from '@vmz/core/component-registry';
 import { emitCdnPolicy } from './cdn-policy.js';
 import { emitContentAddressedAssets, hashedAssetHref } from './content-addressed-assets.js';
-import { absoluteUrl, buildLocalePageMeta, localizeBodyLinks } from './locale-router.js';
+import { absoluteUrl, buildLocalePageMeta, buildLocaleLinkPlan, applyLocaleLinkPlan } from './locale-router.js';
 import { requireNativeAddon } from './native-addon.js';
 import { writePrettyJsonFile } from './pretty-json.js';
 import { emitPublicStaticAssets } from './public-static-assets.js';
 import { listPublicPageUnits, parsePathPattern, unitBrowserPathPattern } from './route-path.js';
 import { emitSiteFavicon, readSiteFaviconHeadHtml } from './site-favicon.js';
 export const STATIC_DELIVERY_MANIFEST_SCHEMA = 'vmz.static.delivery_manifest.v0';
+export const STATIC_EMIT_PLAN_SCHEMA = 'vmz.static.emit_plan.v0';
 export async function emitWebStatic(distDir, opts = {}) {
     const origin = String(opts.origin || process.env.VMZ_SITE_ORIGIN || 'https://example.test').replace(/\/$/, '');
     const applicationId = opts.applicationId || path.basename(path.dirname(distDir));
@@ -40,6 +41,8 @@ export async function emitWebStatic(distDir, opts = {}) {
     const cssLogical = readCssEntry(distDir);
     const cssEntry = hashedAssetHref(assets.rewrites, cssLogical) || hashedAssetHref(assets.rewrites, 'vmz.css');
     const moduleScriptSrc = hashedAssetHref(assets.rewrites, 'entry-client.js') || '/entry-client.js';
+    const localeArt = loadLocaleArtifact(distDir);
+    const localeLinkPlan = buildLocaleLinkPlan(localeArt);
     for (const page of pageCatalog) {
         const pattern = page.pathPattern || patternFromSegs(page.segs);
         const routeId = guessRouteId(distDir, page.chunkId);
@@ -104,8 +107,6 @@ export async function emitWebStatic(distDir, opts = {}) {
                 continue;
             bodyHtml = await renderToString(Layout, {}, { slotHtml: bodyHtml });
         }
-        const localeArt = loadLocaleArtifact(distDir);
-        // Locale artifact routeId is chunkId (`pages/about`), not the page class name.
         const localeWrites = expandLocaleStaticGenerations({
             localeArt,
             routeId: page.chunkId,
@@ -118,7 +119,7 @@ export async function emitWebStatic(distDir, opts = {}) {
             const absHtml = path.join(distDir, gen.htmlPath);
             fs.mkdirSync(path.dirname(absHtml), { recursive: true });
             // Each LocaleId HTML must retain locale on same-app Links (realization authority).
-            const localizedBody = gen.localeId && localeArt ? localizeBodyLinks(bodyHtml, gen.localeId, localeArt) : bodyHtml;
+            const localizedBody = gen.localeId && localeLinkPlan.rows.length ? applyLocaleLinkPlan(bodyHtml, gen.localeId, localeLinkPlan) : bodyHtml;
             const html = wrapDocument({
                 bodyHtml: localizedBody,
                 chunkId: page.chunkId,
@@ -227,6 +228,22 @@ export async function emitWebStatic(distDir, opts = {}) {
     const digest = sha256Hex(canonicalJson(manifest));
     manifest.manifestDigest = digest;
     writePrettyJsonFile(path.join(vmzDir, 'static-delivery-manifest.json'), manifest);
+    writePrettyJsonFile(path.join(vmzDir, 'static-emit-plan.json'), {
+        schema: STATIC_EMIT_PLAN_SCHEMA,
+        applicationId,
+        deliveryProfile: 'static',
+        origin,
+        localeLinks: localeLinkPlan,
+        assetPlanPath: '_vmz/asset-plan.json',
+        routes: generations.map((g) => ({
+            routeId: g.routeId,
+            path: g.path,
+            chunkId: g.chunkId,
+            htmlPath: g.htmlPath,
+            classification: g.classification,
+            localeId: g.localeId || null,
+        })),
+    });
     const cdn = emitCdnPolicy(distDir, manifest);
     return {
         manifest,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/vmz",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "type": "module",
   "description": "VMZ Node toolchain — N-API workspace session + CLI (publish name @vmz/vmz)",
   "license": "MIT",
@@ -48,16 +48,16 @@
     }
   },
   "dependencies": {
-    "@vmz/commander": "0.1.24",
-    "@vmz/core": "0.1.24",
-    "@vmz/diagnostic": "0.1.24",
-    "@vmz/plugin": "0.1.24",
-    "@vmz/protocol": "0.1.24",
+    "@vmz/commander": "0.1.25",
+    "@vmz/core": "0.1.25",
+    "@vmz/diagnostic": "0.1.25",
+    "@vmz/plugin": "0.1.25",
+    "@vmz/protocol": "0.1.25",
     "jiti": "^2.6.1"
   },
   "peerDependencies": {
-    "@vmz/plugin-markdown-it": "0.1.24",
-    "@vmz/test": "0.1.24",
+    "@vmz/plugin-markdown-it": "0.1.25",
+    "@vmz/test": "0.1.25",
     "typescript": "^5.8.3"
   },
   "peerDependenciesMeta": {
@@ -92,12 +92,12 @@
     "cli"
   ],
   "optionalDependencies": {
-    "@vmz/vmz-win32-x64": "0.1.24",
-    "@vmz/vmz-win32-arm64": "0.1.24",
-    "@vmz/vmz-darwin-x64": "0.1.24",
-    "@vmz/vmz-darwin-arm64": "0.1.24",
-    "@vmz/vmz-linux-x64": "0.1.24",
-    "@vmz/vmz-linux-arm64": "0.1.24"
+    "@vmz/vmz-win32-x64": "0.1.25",
+    "@vmz/vmz-win32-arm64": "0.1.25",
+    "@vmz/vmz-darwin-x64": "0.1.25",
+    "@vmz/vmz-darwin-arm64": "0.1.25",
+    "@vmz/vmz-linux-x64": "0.1.25",
+    "@vmz/vmz-linux-arm64": "0.1.25"
   },
   "publishConfig": {
     "access": "public"