@vmz/core 0.1.25 → 0.1.27

package/dist/dom-core.d.ts

@@ -161,6 +161,14 @@ export declare const directApi: {
      * @param {string | null} client
      */
     component(hostInst: any, name: any, props: any, client: any): any;
+    /**
+     * Subscribe to a child component event (`@submit` → event name `submit`).
+     * Orthogonal to function props (`:on-submit` → prop `onSubmit`).
+     * @param {HTMLElement} hostEl
+     * @param {string} eventName
+     * @param {(ev?: any, ...rest: any[]) => any} handler
+     */
+    onComponentEvent(hostEl: any, eventName: any, handler: any): void;
     /**
      * Keep nested Direct child props live with parent field writes.
      * @param {object} hostInst
@@ -198,12 +206,20 @@ export declare const directApi: {
     eachBlock(inst: any, bindingId: any, deps: any, spec: any, regionId?: any): DocumentFragment;
 };
 /**
- * Vue-familiar `@click` / legacy `onClick` → canonical `onXxx` prop name.
- * Function props that are not events are treated as getters (`v.call(host)`).
+ * Function prop wire: only `onXxx` camelCase is a handler prop.
+ * Component `@event` must never normalize here — that channel is `onComponentEvent`.
  * @param {unknown} name
  * @returns {string | null}
  */
 export declare function eventPropHandlerName(name: any): string;
+/**
+ * Dispatch a component event to parent subscribers registered via `onComponentEvent`.
+ * Installed on every Direct instance as `inst.emit`.
+ * @param {object} inst
+ * @param {string} eventName
+ * @param {...any} payload
+ */
+export declare function emitComponentEvent(inst: any, eventName: any, ...payload: any[]): void;
 export declare function isEventPropName(name: any): boolean;
 /** HTML boolean attributes: presence means true; `false`/`null` must remove the attr. */
 export declare const BOOLEAN_HTML_ATTRS: Set<string>;

package/dist/dom-core.js

@@ -505,6 +505,8 @@ export const directApi = {
         /** @type {Record<string, any>} */
         const resolved = {};
         for (const [k, v] of Object.entries(props || {})) {
+            // Function props that already look like `onXxx` stay as handlers.
+            // Component `@event` never arrives here (emit uses onComponentEvent).
             const onKey = typeof v === 'function' ? eventPropHandlerName(k) : null;
             if (onKey)
                 resolved[onKey] = v;
@@ -574,6 +576,23 @@ export const directApi = {
         }
         return host;
     },
+    /**
+     * Subscribe to a child component event (`@submit` → event name `submit`).
+     * Orthogonal to function props (`:on-submit` → prop `onSubmit`).
+     * @param {HTMLElement} hostEl
+     * @param {string} eventName
+     * @param {(ev?: any, ...rest: any[]) => any} handler
+     */
+    onComponentEvent(hostEl, eventName, handler) {
+        const child = hostEl && hostEl.__vmzInst;
+        if (!child || typeof eventName !== 'string' || !eventName)
+            return;
+        if (typeof handler !== 'function')
+            return;
+        const bag = child.__vmzComponentListeners || (child.__vmzComponentListeners = Object.create(null));
+        const list = bag[eventName] || (bag[eventName] = []);
+        list.push(handler);
+    },
     /**
      * Keep nested Direct child props live with parent field writes.
      * @param {object} hostInst
@@ -2736,8 +2755,8 @@ function wireDirectBind(inst, bindingId, deps, get, write, cf) {
     trackDirectBind(inst, liveDeps, apply, bindingId);
 }
 /**
- * Vue-familiar `@click` / legacy `onClick` → canonical `onXxx` prop name.
- * Function props that are not events are treated as getters (`v.call(host)`).
+ * Function prop wire: only `onXxx` camelCase is a handler prop.
+ * Component `@event` must never normalize here — that channel is `onComponentEvent`.
  * @param {unknown} name
  * @returns {string | null}
  */
@@ -2746,15 +2765,27 @@ export function eventPropHandlerName(name) {
         return null;
     if (/^on[A-Z]/.test(name))
         return name;
-    // `@input` → `onInput`; reject `@update:modelValue` until that surface exists.
-    if (name.charAt(0) === '@' && name.length > 1 && !name.includes(':')) {
-        const ev = name.slice(1);
-        if (!ev || !/^[A-Za-z]/.test(ev))
-            return null;
-        return `on${ev.charAt(0).toUpperCase()}${ev.slice(1)}`;
-    }
     return null;
 }
+/**
+ * Dispatch a component event to parent subscribers registered via `onComponentEvent`.
+ * Installed on every Direct instance as `inst.emit`.
+ * @param {object} inst
+ * @param {string} eventName
+ * @param {...any} payload
+ */
+export function emitComponentEvent(inst, eventName, ...payload) {
+    if (!inst || typeof eventName !== 'string' || !eventName)
+        return;
+    const bag = inst.__vmzComponentListeners;
+    const list = bag && bag[eventName];
+    if (!Array.isArray(list) || list.length === 0)
+        return;
+    for (const fn of list) {
+        if (typeof fn === 'function')
+            fn(...payload);
+    }
+}
 export function isEventPropName(name) {
     return eventPropHandlerName(name) != null;
 }
@@ -3137,6 +3168,11 @@ export function createInstance(Component, props = {}) {
     inst.__vmzBinders = Object.create(null);
     inst.__vmzBindings = Object.create(null);
     inst.__vmzDepToBindings = Object.create(null);
+    inst.__vmzComponentListeners = Object.create(null);
+    // Compiler intrinsic surface: `this.emit('submit', payload)` — not a string bus.
+    inst.emit = function emit(eventName, ...payload) {
+        return emitComponentEvent(inst, eventName, ...payload);
+    };
     makeReactive(inst, Component.__vmzState || []);
     makeReactive(inst, Component.__vmzProps || []);
     // WriteBarrier: install Component helpers once (no import needed in emitted code).

package/dist/dom-ssr.js

@@ -578,6 +578,9 @@ const serializeApi = {
     adoptLeave() {
         /* resume scope only */
     },
+    onComponentEvent() {
+        /* component events attach only on the client */
+    },
     bindText(inst, bindingId, deps, get, textNode) {
         let raw = '';
         try {

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.25",
+  "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.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"
+    "@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"