@vmz/core 0.1.25 → 0.1.26

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/core",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "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.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"
   },
   "publishConfig": {
     "access": "public"