@vmz/core 0.3.9 → 0.3.10

package/dist/browser/direct-api.types.d.ts

@@ -99,6 +99,14 @@ export type ComponentCtorLike = (new (props?: object) => DirectInstance) & {
     __vmzProps?: string[];
     __vmzWBInstalled?: boolean;
     __vmzCtorAppliesProps?: boolean;
+    /**
+     * Compile-time embedded BindingId → deps[] map.  When the Rust generator
+     * emits this static map on the component class, `registerBind` resolves
+     * deps by lookup instead of rebuilding O(N×M) indices from the string[]
+     * the artifact passes per call.  Absent (today) — falls back to the call
+     * site argument unchanged.
+     */
+    __vmzDepsMap?: Record<string | number, string[]>;
     name?: string;
 };
 export type DirectEachCtx = {
@@ -135,6 +143,7 @@ export type DirectApi = {
     adoptLeave: () => void;
     projectDefaultSlot: (hostEl: HTMLElement, node: Node) => void;
     setHtml: (el: Element, value: unknown) => void;
+    setShow: (el: HTMLElement, condition: unknown) => void;
     bindHtml: (inst: DirectInstance, bindingId: BindingId, deps: string[], get: PatchFn, el: Element) => void;
     bindComponentProp: (inst: DirectInstance, bindingId: BindingId, deps: string[], get: PatchFn, hostInst: DirectInstance, propName: string) => void;
     component: (Ctor: ComponentCtorLike | string, props?: object) => HTMLElement;

package/dist/browser/dom/direct-api.d.ts

@@ -30,7 +30,7 @@ export declare const directApi: {
     attr(el: any, name: any, value: any): void;
     mergeClass(...parts: any[]): string;
     mergeStyle(...parts: any[]): string;
-    on(el: any, type: any, handler: any): void;
+    on(el: any, type: any, handler: any, options?: any): void;
     /**
      * Bind a named instance method (no arrow / Function#toString).
      * Learns `skipFlush` after a sync invocation that schedules no dirty work
@@ -46,7 +46,25 @@ export declare const directApi: {
      */
     specFieldText(inst: any, bindingId: any, fieldName: any, textNode: any): void;
     setHtml(el: any, value: any): void;
+    /**
+     * Vue `v-text` — sets `textContent`, escaping all HTML (unlike `setHtml`).
+     * Overrides any existing children on the element. Static create-time path;
+     * reactive bindings use {@link bindText}.
+     */
+    setText(el: any, value: any): void;
+    /**
+     * Vue `v-show` — toggles `style.display` between empty string (visible,
+     * original CSS wins) and `'none'`.  Element stays in the DOM tree (unlike
+     * `v-if`).  Used for static-show values; reactive bindings emit inline
+     * patches in {@link trackPatch}.
+     */
+    setShow(el: any, condition: any): void;
     bindHtml(inst: any, bindingId: any, deps: any, get: any, el: any): void;
+    /**
+     * Reactive `v-text` textContent binding — mirrors {@link bindHtml} but
+     * writes `textContent` (HTML-escaped, safe).
+     */
+    bindText(inst: any, bindingId: any, deps: any, get: any, el: any): void;
     /**
      * Nested component (sync Direct child or island schedule).
      */

package/dist/browser/dom/direct-api.js

@@ -169,7 +169,11 @@ export const directApi = {
     mergeStyle(...parts) {
         return mergeStyleParts(...parts);
     },
-    on(el, type, handler) {
+    on(el, type, handler, options) {
+        // options: { capture?: boolean; passive?: boolean; once?: boolean }
+        const listenerOpts = options && (options.capture || options.passive || options.once)
+            ? { capture: !!options.capture, passive: !!options.passive, once: !!options.once }
+            : undefined;
         const inst = directApi._inst;
         if (directApi._eachCtx && typeof handler === 'function') {
             const bag = el.__vmzEvt || (el.__vmzEvt = Object.create(null));
@@ -191,7 +195,7 @@ export const directApi = {
             };
             bag[type] = listener;
             directApi._eachCtx.needDelegate(type);
-            el.addEventListener(type, listener);
+            el.addEventListener(type, listener, listenerOpts);
             return;
         }
         // Infer once at bind time ??never Function#toString on the click hot path.
@@ -208,7 +212,7 @@ export const directApi = {
                         return m.call(inst, ev);
                     return handler.call(inst, ev);
                 });
-            });
+            }, listenerOpts);
             return;
         }
         el.addEventListener(type, (ev) => {
@@ -219,7 +223,7 @@ export const directApi = {
             if (typeof handler === 'function') {
                 runDomEventHandler(inst, methodHint, () => handler.call(inst, ev));
             }
-        });
+        }, listenerOpts);
     },
     /**
      * Bind a named instance method (no arrow / Function#toString).
@@ -227,6 +231,10 @@ export const directApi = {
      * (stride / transpose self-apply DOM).
      */
     onMethod(el, type, methodName, opts) {
+        // opts: { skipFlush?: boolean; capture?: boolean; passive?: boolean; once?: boolean }
+        const listenerOpts = opts && (opts.capture || opts.passive || opts.once)
+            ? { capture: !!opts.capture, passive: !!opts.passive, once: !!opts.once }
+            : undefined;
         // Prefer each-block owner: item create often runs during flush when `_inst` is unset.
         const eachOwner = directApi._eachCtx && directApi._eachCtx.inst;
         const inst = eachOwner || directApi._inst;
@@ -262,10 +270,10 @@ export const directApi = {
             const listener = (ev) => invoke(ev);
             bag[type] = listener;
             directApi._eachCtx.needDelegate(type);
-            el.addEventListener(type, listener);
+            el.addEventListener(type, listener, listenerOpts);
             return;
         }
-        el.addEventListener(type, (ev) => invoke(ev));
+        el.addEventListener(type, (ev) => invoke(ev), listenerOpts);
     },
     /**
      * Specialized single-field attr bind (0.1.29): compile-time field name, no generic get closure in artifact.
@@ -303,6 +311,23 @@ export const directApi = {
     setHtml(el, value) {
         el.innerHTML = value == null ? '' : String(value);
     },
+    /**
+     * Vue `v-text` — sets `textContent`, escaping all HTML (unlike `setHtml`).
+     * Overrides any existing children on the element. Static create-time path;
+     * reactive bindings use {@link bindText}.
+     */
+    setText(el, value) {
+        el.textContent = value == null ? '' : String(value);
+    },
+    /**
+     * Vue `v-show` — toggles `style.display` between empty string (visible,
+     * original CSS wins) and `'none'`.  Element stays in the DOM tree (unlike
+     * `v-if`).  Used for static-show values; reactive bindings emit inline
+     * patches in {@link trackPatch}.
+     */
+    setShow(el, condition) {
+        el.style.display = condition ? '' : 'none';
+    },
     bindHtml(inst, bindingId, deps, get, el) {
         directApi.trackPatch(inst, deps || [], function bindHtmlPatch() {
             let raw;
@@ -315,6 +340,22 @@ export const directApi = {
             el.innerHTML = raw == null ? '' : String(raw);
         }, bindingId);
     },
+    /**
+     * Reactive `v-text` textContent binding — mirrors {@link bindHtml} but
+     * writes `textContent` (HTML-escaped, safe).
+     */
+    bindText(inst, bindingId, deps, get, el) {
+        directApi.trackPatch(inst, deps || [], function bindTextPatch() {
+            let raw;
+            try {
+                raw = get.call(inst);
+            }
+            catch {
+                raw = '';
+            }
+            el.textContent = raw == null ? '' : String(raw);
+        }, bindingId);
+    },
     /**
      * Nested component (sync Direct child or island schedule).
      */

package/dist/browser/reactivity/patch-scheduler.js

@@ -645,6 +645,9 @@ function reindexBindingDeps(inst, bindingId, deps) {
     const entry = inst.__vmzBindings[bindingId];
     if (!entry)
         return;
+    // Fast path: deps 完全相同 → 无需重建 dep→bindings 索引。
+    if (arraysEqual(entry.deps, deps))
+        return;
     for (const dep of entry.deps || []) {
         const list = inst.__vmzDepToBindings[dep];
         if (!list)
@@ -664,10 +667,47 @@ function reindexBindingDeps(inst, bindingId, deps) {
         }
     }
 }
+function arraysEqual(a, b) {
+    if (a === b)
+        return true;
+    const la = a ? a.length : 0;
+    const lb = b ? b.length : 0;
+    if (la !== lb)
+        return false;
+    for (let i = 0; i < la; i++)
+        if (a[i] !== b[i])
+            return false;
+    return true;
+}
+/**
+ * Resolve deps for a binding: prefer the argument from generated artifact,
+ * fall back to a compile-time-embedded static map on the component class.
+ *
+ * The Rust generator will later emit `Ctor.__vmzDepsMap = { [bindingId]: deps[] }`
+ * so runtime can do a single lookup instead of rebuilding O(N×M) dep→binding
+ * indices from the string[] the artifact passes today.
+ */
+function resolveDeps(inst, depsArg, bindingId) {
+    if (depsArg && depsArg.length)
+        return depsArg;
+    if (bindingId == null)
+        return depsArg || [];
+    const ctor = inst && inst.constructor;
+    const map = ctor && ctor.__vmzDepsMap;
+    if (map) {
+        const hit = map[bindingId];
+        if (hit)
+            return hit;
+    }
+    return depsArg || [];
+}
 export function registerBind(inst, deps, fn, bindingId = null) {
+    // 查表优先: generator 侧若已在 Ctor.__vmzDepsMap 嵌入完整 deps map
+    // 则直接取用, 避免每次 registerBind 都用传入 string[] 重建索引.
+    const resolvedDeps = resolveDeps(inst, deps, bindingId);
     if (!inst.__vmzBinders)
         inst.__vmzBinders = Object.create(null);
-    for (const dep of deps || []) {
+    for (const dep of resolvedDeps) {
         if (!inst.__vmzBinders[dep])
             inst.__vmzBinders[dep] = [];
         // Dedup: cf untrack/retrack with identical deps must not grow the binder list.
@@ -685,7 +725,7 @@ export function registerBind(inst, deps, fn, bindingId = null) {
     }
     if (!entry.patches.includes(fn))
         entry.patches.push(fn);
-    reindexBindingDeps(inst, bindingId, deps || []);
+    reindexBindingDeps(inst, bindingId, resolvedDeps);
 }
 export function unregisterBind(inst, deps, fn, bindingId = null) {
     const binders = inst.__vmzBinders;

package/package.json

@@ -68,12 +68,12 @@
   "main": "./dist/faces/server.js",
   "name": "@vmz/core",
   "optionalDependencies": {
-    "@vmz/vmz-darwin-arm64": "0.3.9",
-    "@vmz/vmz-darwin-x64": "0.3.9",
-    "@vmz/vmz-linux-arm64": "0.3.9",
-    "@vmz/vmz-linux-x64": "0.3.9",
-    "@vmz/vmz-win32-arm64": "0.3.9",
-    "@vmz/vmz-win32-x64": "0.3.9"
+    "@vmz/vmz-darwin-arm64": "0.3.10",
+    "@vmz/vmz-darwin-x64": "0.3.10",
+    "@vmz/vmz-linux-arm64": "0.3.10",
+    "@vmz/vmz-linux-x64": "0.3.10",
+    "@vmz/vmz-win32-arm64": "0.3.10",
+    "@vmz/vmz-win32-x64": "0.3.10"
   },
   "publishConfig": {
     "access": "public"
@@ -88,5 +88,5 @@
   },
   "type": "module",
   "types": "./dist/faces/index.d.ts",
-  "version": "0.3.9"
+  "version": "0.3.10"
 }