@lark.js/mvc 0.0.8 → 0.0.9

package/README.md

@@ -235,7 +235,7 @@ this.updater.set({ count: newCount });
 this.updater.digest();
 ```
 
-Full pipeline: `updater.set(data)` shallow-merges data into the internal data object and collects changed keys. `updater.digest()` calls the compiled template function to generate an HTML string. `vdomGetNode` uses `tmp.innerHTML = wrap + html` to parse it into temporary DOM. `vdomSetChildNodes` compares against the live DOM to produce a keyed diff. DOM operations are applied in batch. `endUpdate()` notifies child Frames to complete mounting.
+Full pipeline: `updater.set(data)` shallow-merges data into the internal data object and collects changed keys. `updater.digest()` calls the compiled template function to generate an HTML string. `domGetNode` uses `tmp.innerHTML = wrap + html` to parse it into temporary DOM. `domSetChildNodes` compares against the live DOM to produce a keyed diff. DOM operations are applied in batch. `endUpdate()` notifies child Frames to complete mounting.
 
 Supports digest re-entry: calling `updater.digest()` during an active digest does not nest; instead it queues to `digestingQueue` and executes after the current digest completes. `null` serves as a digest boundary sentinel in the queue.
 
@@ -713,7 +713,7 @@ The compiler converts JS object literal parameters (`{a:1}`) to URL query string
 
 With query strings, parameters are translated into the first argument of the child view's `init`. When containing SPLITTER reference tokens, `translateData` resolves original JS values from the parent view's refData before passing them to the child.
 
-### VDOM Optimization Hints
+### DOM Optimization Hints
 
 | Attribute | Purpose                                                                    |
 | --------- | -------------------------------------------------------------------------- |

package/dist/index.cjs

@@ -40,16 +40,23 @@ __export(index_exports, {
   Updater: () => Updater,
   VIEW_EVENT_METHOD_REGEXP: () => VIEW_EVENT_METHOD_REGEXP,
   View: () => View,
+  applyDomOps: () => applyDomOps,
   applyIdUpdates: () => applyIdUpdates,
   applyStyle: () => applyStyle,
-  applyVdomOps: () => applyVdomOps,
   assign: () => assign,
   bindStore: () => bindStore,
   computed: () => computed,
   create: () => create,
-  createVdomRef: () => createVdomRef,
+  createDomRef: () => createDomRef,
   defineStore: () => defineStore,
   defineView: () => defineView,
+  domGetCompareKey: () => domGetCompareKey,
+  domGetNode: () => domGetNode,
+  domSetAttributes: () => domSetAttributes,
+  domSetChildNodes: () => domSetChildNodes,
+  domSetNode: () => domSetNode,
+  domSpecialDiff: () => domSpecialDiff,
+  domUnmountFrames: () => domUnmountFrames,
   encodeHTML: () => encodeHTML,
   encodeQ: () => encodeQ,
   encodeSafe: () => encodeSafe,
@@ -87,14 +94,7 @@ __export(index_exports, {
   translateData: () => translateData,
   unmark: () => unmark,
   use: () => use,
-  useUrlState: () => useUrlState,
-  vdomGetCompareKey: () => vdomGetCompareKey,
-  vdomGetNode: () => vdomGetNode,
-  vdomSetAttributes: () => vdomSetAttributes,
-  vdomSetChildNodes: () => vdomSetChildNodes,
-  vdomSetNode: () => vdomSetNode,
-  vdomSpecialDiff: () => vdomSpecialDiff,
-  vdomUnmountFrames: () => vdomUnmountFrames
+  useUrlState: () => useUrlState
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -106,14 +106,6 @@ var RouterEvents = {
   CHANGED: "changed",
   PAGE_UNLOAD: "page_unload"
 };
-var LarkInnerKeys = {
-  /** Attribute name: ldk (static key for skipping VDOM diff) */
-  DIFF_KEY: "ldk",
-  /** Attribute name: lak (static attribute key) */
-  ATTR_KEY: "lak",
-  /** Attribute name: lvk (view key for assign) */
-  VIEW_KEY: "lvk"
-};
 var LARK_VIEW = "v-lark";
 var EVENT_METHOD_REGEXP = new RegExp(
   `(?:([\\w-]+)${SPLITTER})?([^(]+)\\(([\\s\\S]*?)?\\)`
@@ -1473,7 +1465,7 @@ var EventDelegator = {
   }
 };
 
-// src/vdom.ts
+// src/dom.ts
 var wrapMeta = {
   option: [1, "<select multiple>"],
   thead: [1, "<table>"],
@@ -1493,12 +1485,12 @@ var VDoc = document.implementation.createHTMLDocument("");
 var VBase = VDoc.createElement("base");
 VBase.href = document.location.href;
 VDoc.head.appendChild(VBase);
-var VDomSpecials = {
+var DomSpecials = {
   INPUT: ["value", "checked"],
   TEXTAREA: ["value"],
   OPTION: ["selected"]
 };
-function vdomUnmountFrames(frame, node) {
+function domUnmountFrames(frame, node) {
   if (!(node instanceof Element)) return;
   const id = node.getAttribute("id");
   if (!id) return;
@@ -1507,7 +1499,7 @@ function vdomUnmountFrames(frame, node) {
     frame.unmountFrame(id);
   }
 }
-function vdomGetNode(html, refNode) {
+function domGetNode(html, refNode) {
   const tmp = VDoc.createElement("div");
   const ns = refNode.namespaceURI;
   let tag;
@@ -1528,16 +1520,13 @@ function vdomGetNode(html, refNode) {
   }
   return tmp;
 }
-function vdomGetCompareKey(node) {
+function domGetCompareKey(node) {
   if (node.nodeType !== 1) return void 0;
   const el = node;
   if (el.compareKeyCached) {
     return el.cachedCompareKey;
   }
   let key = el.autoId ? "" : el.getAttribute("id") || void 0;
-  if (!key) {
-    key = el.getAttribute(LarkInnerKeys.DIFF_KEY) || void 0;
-  }
   if (!key) {
     const larkView = el.getAttribute(LARK_VIEW);
     if (larkView) {
@@ -1548,8 +1537,8 @@ function vdomGetCompareKey(node) {
   el.cachedCompareKey = key || "";
   return key;
 }
-function vdomSpecialDiff(oldNode, newNode) {
-  const specials = VDomSpecials[oldNode.nodeName];
+function domSpecialDiff(oldNode, newNode) {
+  const specials = DomSpecials[oldNode.nodeName];
   if (!specials) return 0;
   const oldEl = oldNode;
   const newEl = newNode;
@@ -1562,7 +1551,7 @@ function vdomSpecialDiff(oldNode, newNode) {
   }
   return result;
 }
-function vdomSetAttributes(oldNode, newNode, ref, keepId) {
+function domSetAttributes(oldNode, newNode, ref, keepId) {
   const oldEl = oldNode;
   Reflect.deleteProperty(oldEl, "compareKeyCached");
   const oldAttrs = oldNode.attributes;
@@ -1594,7 +1583,7 @@ function vdomSetAttributes(oldNode, newNode, ref, keepId) {
     }
   }
 }
-function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
+function domSetChildNodes(oldParent, newParent, ref, frame, keys_) {
   let oldNode = oldParent.lastChild;
   let newNode = newParent.firstChild;
   let extra = 0;
@@ -1602,7 +1591,7 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
   const newKeyedNodes = /* @__PURE__ */ new Map();
   while (oldNode) {
     extra++;
-    const nodeKey = vdomGetCompareKey(oldNode);
+    const nodeKey = domGetCompareKey(oldNode);
     if (nodeKey) {
       let bucket = keyedNodes.get(nodeKey);
       if (!bucket) {
@@ -1614,7 +1603,7 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
     oldNode = oldNode.previousSibling;
   }
   while (newNode) {
-    const nodeKey = vdomGetCompareKey(newNode);
+    const nodeKey = domGetCompareKey(newNode);
     if (nodeKey) {
       newKeyedNodes.set(nodeKey, (newKeyedNodes.get(nodeKey) ?? 0) + 1);
     }
@@ -1626,7 +1615,7 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
     extra--;
     const tempNew = newNode;
     newNode = newNode.nextSibling;
-    const nodeKey = vdomGetCompareKey(tempNew);
+    const nodeKey = domGetCompareKey(tempNew);
     let foundNode = nodeKey ? keyedNodes.get(nodeKey) : void 0;
     if (foundNode && (foundNode = foundNode.slice()) && foundNode.length) {
       const matched = foundNode.pop();
@@ -1641,17 +1630,17 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
         const c = newKeyedNodes.get(nodeKey);
         if (c) newKeyedNodes.set(nodeKey, c - 1);
       }
-      vdomSetNode(matched, tempNew, oldParent, ref, frame, keys_);
+      domSetNode(matched, tempNew, oldParent, ref, frame, keys_);
     } else if (oldNode) {
       const tempOld2 = oldNode;
-      const oldKey = vdomGetCompareKey(tempOld2);
+      const oldKey = domGetCompareKey(tempOld2);
       if (oldKey && keyedNodes.has(oldKey) && newKeyedNodes.get(oldKey)) {
         extra++;
         ref.hasChanged = 1;
         ref.domOps.push([8, oldParent, tempNew, tempOld2]);
       } else {
         oldNode = oldNode.nextSibling;
-        vdomSetNode(tempOld2, tempNew, oldParent, ref, frame, keys_);
+        domSetNode(tempOld2, tempNew, oldParent, ref, frame, keys_);
       }
     } else {
       ref.hasChanged = 1;
@@ -1661,29 +1650,23 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
   let tempOld = oldParent.lastChild;
   while (extra-- > 0) {
     if (tempOld) {
-      vdomUnmountFrames(frame, tempOld);
+      domUnmountFrames(frame, tempOld);
       ref.domOps.push([2, oldParent, tempOld]);
       tempOld = tempOld.previousSibling;
       ref.hasChanged = 1;
     }
   }
 }
-function vdomSetNode(oldNode, newNode, oldParent, ref, frame, keys_) {
+function domSetNode(oldNode, newNode, oldParent, ref, frame, keys_) {
   const oldAsEl = oldNode instanceof Element ? oldNode : null;
   const newAsEl = newNode instanceof Element ? newNode : null;
-  const hasViewKey = !!oldAsEl?.hasAttribute(LarkInnerKeys.VIEW_KEY);
   const equalAsNodes = oldAsEl !== null && newAsEl !== null && oldAsEl.isEqualNode && oldAsEl.isEqualNode(newAsEl);
-  if (vdomSpecialDiff(oldNode, newNode) || hasViewKey || !equalAsNodes) {
+  if (domSpecialDiff(oldNode, newNode) || !equalAsNodes) {
     if (oldNode.nodeType === newNode.nodeType && oldNode.nodeName === newNode.nodeName) {
       if (oldAsEl !== null && newAsEl !== null) {
         const oldEl = oldAsEl;
         const newEl = newAsEl;
-        const staticKey = newEl.getAttribute(LarkInnerKeys.DIFF_KEY);
-        if (staticKey && staticKey === oldEl.getAttribute(LarkInnerKeys.DIFF_KEY)) {
-          return;
-        }
         const newLarkView = newEl.getAttribute(LARK_VIEW);
-        const updateAttribute = !newEl.getAttribute(LarkInnerKeys.ATTR_KEY) || newEl.getAttribute(LarkInnerKeys.ATTR_KEY) !== oldEl.getAttribute(LarkInnerKeys.ATTR_KEY);
         let updateChildren = true;
         if (newLarkView) {
           const oldFrameId = oldEl.getAttribute("id") || "";
@@ -1694,11 +1677,9 @@ function vdomSetNode(oldNode, newNode, oldParent, ref, frame, keys_) {
             updateChildren = false;
           }
         }
-        if (updateAttribute) {
-          vdomSetAttributes(oldEl, newEl, ref, !!newLarkView);
-        }
+        domSetAttributes(oldEl, newEl, ref, !!newLarkView);
         if (updateChildren) {
-          vdomSetChildNodes(oldEl, newEl, ref, frame, keys_);
+          domSetChildNodes(oldEl, newEl, ref, frame, keys_);
         }
       } else if (oldNode.nodeValue !== newNode.nodeValue) {
         ref.hasChanged = 1;
@@ -1706,12 +1687,12 @@ function vdomSetNode(oldNode, newNode, oldParent, ref, frame, keys_) {
       }
     } else {
       ref.hasChanged = 1;
-      vdomUnmountFrames(frame, oldNode);
+      domUnmountFrames(frame, oldNode);
       ref.domOps.push([4, oldParent, newNode, oldNode]);
     }
   }
 }
-function createVdomRef() {
+function createDomRef() {
   return {
     idUpdates: [],
     views: [],
@@ -1719,7 +1700,7 @@ function createVdomRef() {
     hasChanged: 0
   };
 }
-function applyVdomOps(ops) {
+function applyDomOps(ops) {
   for (const op of ops) {
     switch (op[0]) {
       case 1:
@@ -1858,11 +1839,11 @@ var Updater = class {
     return this;
   }
   /**
-   * Detect changes and trigger VDOM re-render.
+   * Detect changes and trigger DOM re-render.
    *
    * The core rendering pipeline:
    * 1. Set data if provided
-   * 2. If changed, run VDOM diff (template → new DOM → diff against old DOM)
+   * 2. If changed, run DOM diff (template → new DOM → diff against old DOM)
    * 3. Apply DOM operations
    * 4. Apply ID updates
    * 5. Call endUpdate on views that need re-rendering
@@ -1907,11 +1888,11 @@ var Updater = class {
           updaterRef,
           encodeQ
         );
-        const newDom = vdomGetNode(html, node);
-        const ref = createVdomRef();
-        vdomSetChildNodes(node, newDom, ref, frame, keys2);
+        const newDom = domGetNode(html, node);
+        const ref = createDomRef();
+        domSetChildNodes(node, newDom, ref, frame, keys2);
         applyIdUpdates(ref.idUpdates);
-        applyVdomOps(ref.domOps);
+        applyDomOps(ref.domOps);
         for (const v of ref.views) {
           if (v.render) {
             funcWithTry(v.render, [], v, noop);
@@ -4356,16 +4337,23 @@ var defineStore = create;
   Updater,
   VIEW_EVENT_METHOD_REGEXP,
   View,
+  applyDomOps,
   applyIdUpdates,
   applyStyle,
-  applyVdomOps,
   assign,
   bindStore,
   computed,
   create,
-  createVdomRef,
+  createDomRef,
   defineStore,
   defineView,
+  domGetCompareKey,
+  domGetNode,
+  domSetAttributes,
+  domSetChildNodes,
+  domSetNode,
+  domSpecialDiff,
+  domUnmountFrames,
   encodeHTML,
   encodeQ,
   encodeSafe,
@@ -4403,12 +4391,5 @@ var defineStore = create;
   translateData,
   unmark,
   use,
-  useUrlState,
-  vdomGetCompareKey,
-  vdomGetNode,
-  vdomSetAttributes,
-  vdomSetChildNodes,
-  vdomSetNode,
-  vdomSpecialDiff,
-  vdomUnmountFrames
+  useUrlState
 });

package/dist/index.d.cts

@@ -461,7 +461,7 @@ declare class Cache<T = unknown> implements CacheInterface<T> {
  *   (recommended for complex cases)
  * - Service: API request management with caching, queuing, and deduplication
  * - Frame: view frame managing view mount/unmount lifecycle
- * - Updater: view data binding and VDOM diff (in-memory real DOM diff) renderer
+ * - Updater: view data binding and DOM diff (in-memory real DOM diff) renderer
  *
  * Designed for single-page application (SPA) development.
  */
@@ -643,23 +643,23 @@ interface RouteChangeEvent extends ChangeEvent {
  * Carries route diff information. Triggered after route change is confirmed and URL is updated.
  */
 type RouteChangedEvent = LocationDiff & ChangeEvent;
-interface VDomRef {
+interface DomRef {
     /** ID update list: [element, newId][] */
     idUpdates: [Element, string][];
     /** Views that need post-processing */
     views: ViewInterface[];
     /** DOM operation list: [opCode, parent, newChild?, oldChild?][] */
-    domOps: VDomOp[];
+    domOps: DomOp[];
     /** Whether anything changed */
     hasChanged: number;
 }
 /**
- * Encoded VDOM mutation. The op code matches `Node.appendChild` family at the
+ * Encoded DOM mutation. The op code matches `Node.appendChild` family at the
  * DOM level — parents are always Elements (you can't appendChild onto text)
  * but the moving / replaced child can be any ChildNode (Element / Text /
  * Comment), so the child slots are typed as ChildNode.
  */
-type VDomOp = [1, Element, ChildNode] | [2, Element, ChildNode] | [4, Element, ChildNode, ChildNode] | [8, Element, ChildNode, ChildNode];
+type DomOp = [1, Element, ChildNode] | [2, Element, ChildNode] | [4, Element, ChildNode, ChildNode] | [8, Element, ChildNode, ChildNode];
 interface FrameInvokeEntry {
     /** Method name */
     name: string;
@@ -841,7 +841,7 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
      */
     owner: FrameInterface | number;
     /**
-     * Updater instance managing view data binding and VDOM rendering.
+     * Updater instance managing view data binding and DOM rendering.
      */
     updater: UpdaterInterface;
     /**
@@ -892,7 +892,7 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
     endUpdatePendingFlag?: number;
     /**
      * Notify view that HTML update is about to begin for a specific region.
-     * Framework unmounts child Frames in that region to prevent VDOM diff from operating on unmounted nodes.
+     * Framework unmounts child Frames in that region to prevent DOM diff from operating on unmounted nodes.
      * @param id Region node ID to update, defaults to current view
      */
     beginUpdate: (id?: string) => void;
@@ -952,7 +952,7 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
     leaveTip: (message: string, condition: () => boolean) => void;
     /**
      * Assign method for incremental DOM updates.
-     * Framework uses VDOM diff (in-memory real DOM diff) to update only changed portions,
+     * Framework uses DOM diff (in-memory real DOM diff) to update only changed portions,
      * automatically handling child view mounting and unmounting.
      * Returns true if DOM changed, undefined if no change.
      * @param options Incremental update config, used internally by framework
@@ -1083,7 +1083,7 @@ interface FrameInterface extends EventEmitterInterface<FrameInterface> {
  * Minimal Updater interface needed by View.
  * View updater responsible for view data binding and data/page updates.
  * Each View instance has an Updater, triggering data/page updates via set/digest.
- * Internally executes complete pipeline: template rendering → VDOM diff (in-memory real DOM diff) → DOM operations.
+ * Internally executes complete pipeline: template rendering → DOM diff (in-memory real DOM diff) → DOM operations.
  */
 interface UpdaterInterface {
     /**
@@ -1103,7 +1103,7 @@ interface UpdaterInterface {
     /**
      * Trigger page re-render.
      * After set, must explicitly call `digest()` to commit changes to page.
-     * Internally executes complete pipeline: template rendering → VDOM diff (in-memory real DOM diff) → DOM operations.
+     * Internally executes complete pipeline: template rendering → DOM diff (in-memory real DOM diff) → DOM operations.
      * @param data Optional data object, if provided calls `set()` first to set data
      * @param excludes Set of keys to exclude from change tracking
      * @param callback Callback executed after render completes
@@ -1714,6 +1714,8 @@ interface FrameworkConfig {
      * Also accessible via `window.crossConfigs` for build-time injection.
      */
     crossConfigs?: CrossSiteConfig[];
+    /** Default false. */
+    virtualDOM?: boolean;
     /** Dynamic config access, custom config items */
     [key: string]: unknown;
 }
@@ -1740,8 +1742,8 @@ interface CrossSiteConfig {
     /** Optional business code for multi-tenant scenarios */
     bizCode?: string;
 }
-/** Element with VDOM diff cached compare key */
-interface VdomElement extends Element {
+/** Element with DOM diff cached compare key */
+interface DomElement extends Element {
     /** Whether compare key is cached */
     compareKeyCached?: number | undefined;
     /** Cached compare key */
@@ -1993,45 +1995,45 @@ declare const CrossSite: typeof View;
 /**
  * Unmount frames within a DOM node.
  */
-declare function vdomUnmountFrames(frame: FrameInterface, node: ChildNode): void;
+declare function domUnmountFrames(frame: FrameInterface, node: ChildNode): void;
 /**
  * Parse HTML string into a DOM element.
  * Handles special elements (table, SVG, MathML) with wrapper elements.
  */
-declare function vdomGetNode(html: string, refNode: Element): Element;
+declare function domGetNode(html: string, refNode: Element): Element;
 /**
  * Get compare key for a DOM node (for keyed diff).
- * Uses id, ldk (static key), or v-lark path.
+ * Uses id or v-lark path.
  */
-declare function vdomGetCompareKey(node: ChildNode): string | undefined;
+declare function domGetCompareKey(node: ChildNode): string | undefined;
 /**
  * Special diff for form elements (value, checked, selected).
  * Form elements carry state on the DOM node (e.g. `input.value`) that isn't
  * reflected in attributes, so we have to sync those properties separately.
  */
-declare function vdomSpecialDiff(oldNode: ChildNode, newNode: ChildNode): number;
+declare function domSpecialDiff(oldNode: ChildNode, newNode: ChildNode): number;
 /**
  * Set attributes from new element onto old element, tracking changes in ref.
  */
-declare function vdomSetAttributes(oldNode: Element, newNode: Element, ref: VDomRef, keepId?: boolean): void;
+declare function domSetAttributes(oldNode: Element, newNode: Element, ref: DomRef, keepId?: boolean): void;
 /**
  * Set child nodes from new parent onto old parent using keyed diff algorithm.
  */
-declare function vdomSetChildNodes(oldParent: Element, newParent: Element, ref: VDomRef, frame: FrameInterface, keys_?: ReadonlySet<string>): void;
+declare function domSetChildNodes(oldParent: Element, newParent: Element, ref: DomRef, frame: FrameInterface, keys_?: ReadonlySet<string>): void;
 /**
  * Diff two DOM nodes and apply changes.
  */
-declare function vdomSetNode(oldNode: ChildNode, newNode: ChildNode, oldParent: Element, ref: VDomRef, frame: FrameInterface, keys_?: ReadonlySet<string>): void;
+declare function domSetNode(oldNode: ChildNode, newNode: ChildNode, oldParent: Element, ref: DomRef, frame: FrameInterface, keys_?: ReadonlySet<string>): void;
 /**
- * Create an empty VDomRef for tracking diff operations.
+ * Create an empty DomRef for tracking diff operations.
  */
-declare function createVdomRef(): VDomRef;
+declare function createDomRef(): DomRef;
 /**
- * Apply VDOM diff operations to the DOM.
+ * Apply DOM diff operations to the DOM.
  */
-declare function applyVdomOps(ops: VDomOp[]): void;
+declare function applyDomOps(ops: DomOp[]): void;
 /**
- * Apply ID updates from VDOM diff.
+ * Apply ID updates from DOM diff.
  */
 declare function applyIdUpdates(updates: [Element, string][]): void;
 /** Encode value for safe HTML output */
@@ -2045,7 +2047,7 @@ declare function encodeQ(v: unknown): string;
 
 /**
  * Updater class for view data binding.
- * Manages view-local data with change detection and VDOM diff triggering.
+ * Manages view-local data with change detection and DOM diff triggering.
  *
  */
 declare class Updater implements UpdaterInterface {
@@ -2081,11 +2083,11 @@ declare class Updater implements UpdaterInterface {
      */
     set(data: Record<string, unknown>, excludes?: ReadonlySet<string>): this;
     /**
-     * Detect changes and trigger VDOM re-render.
+     * Detect changes and trigger DOM re-render.
      *
      * The core rendering pipeline:
      * 1. Set data if provided
-     * 2. If changed, run VDOM diff (template → new DOM → diff against old DOM)
+     * 2. If changed, run DOM diff (template → new DOM → diff against old DOM)
      * 3. Apply DOM operations
      * 4. Apply ID updates
      * 5. Call endUpdate on views that need re-rendering
@@ -2513,4 +2515,4 @@ declare function serializeFrameTree(): SerializedFrameTree;
  */
 declare function installFrameVisualizerBridge(): void;
 
-export { type AnyFunc, CALL_BREAK_TIME, Cache, type CacheEntry, type CacheInterface, type CacheOptions, type ChangeEvent, type CompileOptions, CrossSite, type CrossSiteConfig, EVENT_METHOD_REGEXP, EventDelegator, EventEmitter, type EventEmitterInterface, type EventListenerEntry, Frame, type FrameBoundElement, type FrameInterface, type FrameInvokeEntry, type FrameStaticEvent, FrameVisualBridge, Framework, type FrameworkConfig, type FrameworkInterface, LARK_VIEW, type Location, type LocationDiff, type MixinEventHandler, type ParamDiff, type ParsedUri, Payload, type PayloadEntry, type PayloadInterface, type PendingCacheEntry, RouterEvents as ROUTER_EVENTS, type RouteChangeEvent, type RouteChangedEvent, type RouteViewConfig, Router, type RouterInterface, SPLITTER, type SerializedFrameNode, type SerializedFrameTree, type SerializedViewInfo, Service, type ServiceCacheInfo, type ServiceEntry, type ServiceEvent, type ServiceInterface, type ServiceMetaEntry, type ServiceOptions, State, type StateInterface, type StoreApi, TAG_NAME_REGEXP, Updater, type UpdaterInterface, type VDomOp, type VDomRef, VIEW_EVENT_METHOD_REGEXP, type VdomElement, View, type ViewEvent, type ViewEventSelectorEntry, type ViewGlobalEventEntry, type ViewInterface, type ViewLocationObserved, type ViewObserveLocation, type ViewResourceEntry, type ViewTemplate, type VoidFunc, applyIdUpdates, applyStyle, applyVdomOps, assign, bindStore, computed, create, createVdomRef, defineStore, defineView, encodeHTML, encodeQ, encodeSafe, encodeURIExtra, ensureElementId, config as frameworkConfig, funcWithTry, generateId, getAttribute, getById, getRouteMode, hasOwnProperty, installFrameVisualizerBridge, invalidateViewClass, isPlainObject, isPrimitive, isPrimitiveOrFunc, keys, mark, markBooted, markRouterBooted, nextCounter, nodeInside, noop, now, parseUri, registerViewClass, resetProjectsMap, safeguard, serializeFrameTree, setData, syncCounter, toMap, toUri, translateData, unmark, use, useUrlState, vdomGetCompareKey, vdomGetNode, vdomSetAttributes, vdomSetChildNodes, vdomSetNode, vdomSpecialDiff, vdomUnmountFrames };
+export { type AnyFunc, CALL_BREAK_TIME, Cache, type CacheEntry, type CacheInterface, type CacheOptions, type ChangeEvent, type CompileOptions, CrossSite, type CrossSiteConfig, type DomElement, type DomOp, type DomRef, EVENT_METHOD_REGEXP, EventDelegator, EventEmitter, type EventEmitterInterface, type EventListenerEntry, Frame, type FrameBoundElement, type FrameInterface, type FrameInvokeEntry, type FrameStaticEvent, FrameVisualBridge, Framework, type FrameworkConfig, type FrameworkInterface, LARK_VIEW, type Location, type LocationDiff, type MixinEventHandler, type ParamDiff, type ParsedUri, Payload, type PayloadEntry, type PayloadInterface, type PendingCacheEntry, RouterEvents as ROUTER_EVENTS, type RouteChangeEvent, type RouteChangedEvent, type RouteViewConfig, Router, type RouterInterface, SPLITTER, type SerializedFrameNode, type SerializedFrameTree, type SerializedViewInfo, Service, type ServiceCacheInfo, type ServiceEntry, type ServiceEvent, type ServiceInterface, type ServiceMetaEntry, type ServiceOptions, State, type StateInterface, type StoreApi, TAG_NAME_REGEXP, Updater, type UpdaterInterface, VIEW_EVENT_METHOD_REGEXP, View, type ViewEvent, type ViewEventSelectorEntry, type ViewGlobalEventEntry, type ViewInterface, type ViewLocationObserved, type ViewObserveLocation, type ViewResourceEntry, type ViewTemplate, type VoidFunc, applyDomOps, applyIdUpdates, applyStyle, assign, bindStore, computed, create, createDomRef, defineStore, defineView, domGetCompareKey, domGetNode, domSetAttributes, domSetChildNodes, domSetNode, domSpecialDiff, domUnmountFrames, encodeHTML, encodeQ, encodeSafe, encodeURIExtra, ensureElementId, config as frameworkConfig, funcWithTry, generateId, getAttribute, getById, getRouteMode, hasOwnProperty, installFrameVisualizerBridge, invalidateViewClass, isPlainObject, isPrimitive, isPrimitiveOrFunc, keys, mark, markBooted, markRouterBooted, nextCounter, nodeInside, noop, now, parseUri, registerViewClass, resetProjectsMap, safeguard, serializeFrameTree, setData, syncCounter, toMap, toUri, translateData, unmark, use, useUrlState };

package/dist/index.d.ts

@@ -461,7 +461,7 @@ declare class Cache<T = unknown> implements CacheInterface<T> {
  *   (recommended for complex cases)
  * - Service: API request management with caching, queuing, and deduplication
  * - Frame: view frame managing view mount/unmount lifecycle
- * - Updater: view data binding and VDOM diff (in-memory real DOM diff) renderer
+ * - Updater: view data binding and DOM diff (in-memory real DOM diff) renderer
  *
  * Designed for single-page application (SPA) development.
  */
@@ -643,23 +643,23 @@ interface RouteChangeEvent extends ChangeEvent {
  * Carries route diff information. Triggered after route change is confirmed and URL is updated.
  */
 type RouteChangedEvent = LocationDiff & ChangeEvent;
-interface VDomRef {
+interface DomRef {
     /** ID update list: [element, newId][] */
     idUpdates: [Element, string][];
     /** Views that need post-processing */
     views: ViewInterface[];
     /** DOM operation list: [opCode, parent, newChild?, oldChild?][] */
-    domOps: VDomOp[];
+    domOps: DomOp[];
     /** Whether anything changed */
     hasChanged: number;
 }
 /**
- * Encoded VDOM mutation. The op code matches `Node.appendChild` family at the
+ * Encoded DOM mutation. The op code matches `Node.appendChild` family at the
  * DOM level — parents are always Elements (you can't appendChild onto text)
  * but the moving / replaced child can be any ChildNode (Element / Text /
  * Comment), so the child slots are typed as ChildNode.
  */
-type VDomOp = [1, Element, ChildNode] | [2, Element, ChildNode] | [4, Element, ChildNode, ChildNode] | [8, Element, ChildNode, ChildNode];
+type DomOp = [1, Element, ChildNode] | [2, Element, ChildNode] | [4, Element, ChildNode, ChildNode] | [8, Element, ChildNode, ChildNode];
 interface FrameInvokeEntry {
     /** Method name */
     name: string;
@@ -841,7 +841,7 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
      */
     owner: FrameInterface | number;
     /**
-     * Updater instance managing view data binding and VDOM rendering.
+     * Updater instance managing view data binding and DOM rendering.
      */
     updater: UpdaterInterface;
     /**
@@ -892,7 +892,7 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
     endUpdatePendingFlag?: number;
     /**
      * Notify view that HTML update is about to begin for a specific region.
-     * Framework unmounts child Frames in that region to prevent VDOM diff from operating on unmounted nodes.
+     * Framework unmounts child Frames in that region to prevent DOM diff from operating on unmounted nodes.
      * @param id Region node ID to update, defaults to current view
      */
     beginUpdate: (id?: string) => void;
@@ -952,7 +952,7 @@ interface ViewInterface extends EventEmitterInterface<ViewInterface> {
     leaveTip: (message: string, condition: () => boolean) => void;
     /**
      * Assign method for incremental DOM updates.
-     * Framework uses VDOM diff (in-memory real DOM diff) to update only changed portions,
+     * Framework uses DOM diff (in-memory real DOM diff) to update only changed portions,
      * automatically handling child view mounting and unmounting.
      * Returns true if DOM changed, undefined if no change.
      * @param options Incremental update config, used internally by framework
@@ -1083,7 +1083,7 @@ interface FrameInterface extends EventEmitterInterface<FrameInterface> {
  * Minimal Updater interface needed by View.
  * View updater responsible for view data binding and data/page updates.
  * Each View instance has an Updater, triggering data/page updates via set/digest.
- * Internally executes complete pipeline: template rendering → VDOM diff (in-memory real DOM diff) → DOM operations.
+ * Internally executes complete pipeline: template rendering → DOM diff (in-memory real DOM diff) → DOM operations.
  */
 interface UpdaterInterface {
     /**
@@ -1103,7 +1103,7 @@ interface UpdaterInterface {
     /**
      * Trigger page re-render.
      * After set, must explicitly call `digest()` to commit changes to page.
-     * Internally executes complete pipeline: template rendering → VDOM diff (in-memory real DOM diff) → DOM operations.
+     * Internally executes complete pipeline: template rendering → DOM diff (in-memory real DOM diff) → DOM operations.
      * @param data Optional data object, if provided calls `set()` first to set data
      * @param excludes Set of keys to exclude from change tracking
      * @param callback Callback executed after render completes
@@ -1714,6 +1714,8 @@ interface FrameworkConfig {
      * Also accessible via `window.crossConfigs` for build-time injection.
      */
     crossConfigs?: CrossSiteConfig[];
+    /** Default false. */
+    virtualDOM?: boolean;
     /** Dynamic config access, custom config items */
     [key: string]: unknown;
 }
@@ -1740,8 +1742,8 @@ interface CrossSiteConfig {
     /** Optional business code for multi-tenant scenarios */
     bizCode?: string;
 }
-/** Element with VDOM diff cached compare key */
-interface VdomElement extends Element {
+/** Element with DOM diff cached compare key */
+interface DomElement extends Element {
     /** Whether compare key is cached */
     compareKeyCached?: number | undefined;
     /** Cached compare key */
@@ -1993,45 +1995,45 @@ declare const CrossSite: typeof View;
 /**
  * Unmount frames within a DOM node.
  */
-declare function vdomUnmountFrames(frame: FrameInterface, node: ChildNode): void;
+declare function domUnmountFrames(frame: FrameInterface, node: ChildNode): void;
 /**
  * Parse HTML string into a DOM element.
  * Handles special elements (table, SVG, MathML) with wrapper elements.
  */
-declare function vdomGetNode(html: string, refNode: Element): Element;
+declare function domGetNode(html: string, refNode: Element): Element;
 /**
  * Get compare key for a DOM node (for keyed diff).
- * Uses id, ldk (static key), or v-lark path.
+ * Uses id or v-lark path.
  */
-declare function vdomGetCompareKey(node: ChildNode): string | undefined;
+declare function domGetCompareKey(node: ChildNode): string | undefined;
 /**
  * Special diff for form elements (value, checked, selected).
  * Form elements carry state on the DOM node (e.g. `input.value`) that isn't
  * reflected in attributes, so we have to sync those properties separately.
  */
-declare function vdomSpecialDiff(oldNode: ChildNode, newNode: ChildNode): number;
+declare function domSpecialDiff(oldNode: ChildNode, newNode: ChildNode): number;
 /**
  * Set attributes from new element onto old element, tracking changes in ref.
  */
-declare function vdomSetAttributes(oldNode: Element, newNode: Element, ref: VDomRef, keepId?: boolean): void;
+declare function domSetAttributes(oldNode: Element, newNode: Element, ref: DomRef, keepId?: boolean): void;
 /**
  * Set child nodes from new parent onto old parent using keyed diff algorithm.
  */
-declare function vdomSetChildNodes(oldParent: Element, newParent: Element, ref: VDomRef, frame: FrameInterface, keys_?: ReadonlySet<string>): void;
+declare function domSetChildNodes(oldParent: Element, newParent: Element, ref: DomRef, frame: FrameInterface, keys_?: ReadonlySet<string>): void;
 /**
  * Diff two DOM nodes and apply changes.
  */
-declare function vdomSetNode(oldNode: ChildNode, newNode: ChildNode, oldParent: Element, ref: VDomRef, frame: FrameInterface, keys_?: ReadonlySet<string>): void;
+declare function domSetNode(oldNode: ChildNode, newNode: ChildNode, oldParent: Element, ref: DomRef, frame: FrameInterface, keys_?: ReadonlySet<string>): void;
 /**
- * Create an empty VDomRef for tracking diff operations.
+ * Create an empty DomRef for tracking diff operations.
  */
-declare function createVdomRef(): VDomRef;
+declare function createDomRef(): DomRef;
 /**
- * Apply VDOM diff operations to the DOM.
+ * Apply DOM diff operations to the DOM.
  */
-declare function applyVdomOps(ops: VDomOp[]): void;
+declare function applyDomOps(ops: DomOp[]): void;
 /**
- * Apply ID updates from VDOM diff.
+ * Apply ID updates from DOM diff.
  */
 declare function applyIdUpdates(updates: [Element, string][]): void;
 /** Encode value for safe HTML output */
@@ -2045,7 +2047,7 @@ declare function encodeQ(v: unknown): string;
 
 /**
  * Updater class for view data binding.
- * Manages view-local data with change detection and VDOM diff triggering.
+ * Manages view-local data with change detection and DOM diff triggering.
  *
  */
 declare class Updater implements UpdaterInterface {
@@ -2081,11 +2083,11 @@ declare class Updater implements UpdaterInterface {
      */
     set(data: Record<string, unknown>, excludes?: ReadonlySet<string>): this;
     /**
-     * Detect changes and trigger VDOM re-render.
+     * Detect changes and trigger DOM re-render.
      *
      * The core rendering pipeline:
      * 1. Set data if provided
-     * 2. If changed, run VDOM diff (template → new DOM → diff against old DOM)
+     * 2. If changed, run DOM diff (template → new DOM → diff against old DOM)
      * 3. Apply DOM operations
      * 4. Apply ID updates
      * 5. Call endUpdate on views that need re-rendering
@@ -2513,4 +2515,4 @@ declare function serializeFrameTree(): SerializedFrameTree;
  */
 declare function installFrameVisualizerBridge(): void;
 
-export { type AnyFunc, CALL_BREAK_TIME, Cache, type CacheEntry, type CacheInterface, type CacheOptions, type ChangeEvent, type CompileOptions, CrossSite, type CrossSiteConfig, EVENT_METHOD_REGEXP, EventDelegator, EventEmitter, type EventEmitterInterface, type EventListenerEntry, Frame, type FrameBoundElement, type FrameInterface, type FrameInvokeEntry, type FrameStaticEvent, FrameVisualBridge, Framework, type FrameworkConfig, type FrameworkInterface, LARK_VIEW, type Location, type LocationDiff, type MixinEventHandler, type ParamDiff, type ParsedUri, Payload, type PayloadEntry, type PayloadInterface, type PendingCacheEntry, RouterEvents as ROUTER_EVENTS, type RouteChangeEvent, type RouteChangedEvent, type RouteViewConfig, Router, type RouterInterface, SPLITTER, type SerializedFrameNode, type SerializedFrameTree, type SerializedViewInfo, Service, type ServiceCacheInfo, type ServiceEntry, type ServiceEvent, type ServiceInterface, type ServiceMetaEntry, type ServiceOptions, State, type StateInterface, type StoreApi, TAG_NAME_REGEXP, Updater, type UpdaterInterface, type VDomOp, type VDomRef, VIEW_EVENT_METHOD_REGEXP, type VdomElement, View, type ViewEvent, type ViewEventSelectorEntry, type ViewGlobalEventEntry, type ViewInterface, type ViewLocationObserved, type ViewObserveLocation, type ViewResourceEntry, type ViewTemplate, type VoidFunc, applyIdUpdates, applyStyle, applyVdomOps, assign, bindStore, computed, create, createVdomRef, defineStore, defineView, encodeHTML, encodeQ, encodeSafe, encodeURIExtra, ensureElementId, config as frameworkConfig, funcWithTry, generateId, getAttribute, getById, getRouteMode, hasOwnProperty, installFrameVisualizerBridge, invalidateViewClass, isPlainObject, isPrimitive, isPrimitiveOrFunc, keys, mark, markBooted, markRouterBooted, nextCounter, nodeInside, noop, now, parseUri, registerViewClass, resetProjectsMap, safeguard, serializeFrameTree, setData, syncCounter, toMap, toUri, translateData, unmark, use, useUrlState, vdomGetCompareKey, vdomGetNode, vdomSetAttributes, vdomSetChildNodes, vdomSetNode, vdomSpecialDiff, vdomUnmountFrames };
+export { type AnyFunc, CALL_BREAK_TIME, Cache, type CacheEntry, type CacheInterface, type CacheOptions, type ChangeEvent, type CompileOptions, CrossSite, type CrossSiteConfig, type DomElement, type DomOp, type DomRef, EVENT_METHOD_REGEXP, EventDelegator, EventEmitter, type EventEmitterInterface, type EventListenerEntry, Frame, type FrameBoundElement, type FrameInterface, type FrameInvokeEntry, type FrameStaticEvent, FrameVisualBridge, Framework, type FrameworkConfig, type FrameworkInterface, LARK_VIEW, type Location, type LocationDiff, type MixinEventHandler, type ParamDiff, type ParsedUri, Payload, type PayloadEntry, type PayloadInterface, type PendingCacheEntry, RouterEvents as ROUTER_EVENTS, type RouteChangeEvent, type RouteChangedEvent, type RouteViewConfig, Router, type RouterInterface, SPLITTER, type SerializedFrameNode, type SerializedFrameTree, type SerializedViewInfo, Service, type ServiceCacheInfo, type ServiceEntry, type ServiceEvent, type ServiceInterface, type ServiceMetaEntry, type ServiceOptions, State, type StateInterface, type StoreApi, TAG_NAME_REGEXP, Updater, type UpdaterInterface, VIEW_EVENT_METHOD_REGEXP, View, type ViewEvent, type ViewEventSelectorEntry, type ViewGlobalEventEntry, type ViewInterface, type ViewLocationObserved, type ViewObserveLocation, type ViewResourceEntry, type ViewTemplate, type VoidFunc, applyDomOps, applyIdUpdates, applyStyle, assign, bindStore, computed, create, createDomRef, defineStore, defineView, domGetCompareKey, domGetNode, domSetAttributes, domSetChildNodes, domSetNode, domSpecialDiff, domUnmountFrames, encodeHTML, encodeQ, encodeSafe, encodeURIExtra, ensureElementId, config as frameworkConfig, funcWithTry, generateId, getAttribute, getById, getRouteMode, hasOwnProperty, installFrameVisualizerBridge, invalidateViewClass, isPlainObject, isPrimitive, isPrimitiveOrFunc, keys, mark, markBooted, markRouterBooted, nextCounter, nodeInside, noop, now, parseUri, registerViewClass, resetProjectsMap, safeguard, serializeFrameTree, setData, syncCounter, toMap, toUri, translateData, unmark, use, useUrlState };

package/dist/index.js

@@ -6,14 +6,6 @@ var RouterEvents = {
   CHANGED: "changed",
   PAGE_UNLOAD: "page_unload"
 };
-var LarkInnerKeys = {
-  /** Attribute name: ldk (static key for skipping VDOM diff) */
-  DIFF_KEY: "ldk",
-  /** Attribute name: lak (static attribute key) */
-  ATTR_KEY: "lak",
-  /** Attribute name: lvk (view key for assign) */
-  VIEW_KEY: "lvk"
-};
 var LARK_VIEW = "v-lark";
 var EVENT_METHOD_REGEXP = new RegExp(
   `(?:([\\w-]+)${SPLITTER})?([^(]+)\\(([\\s\\S]*?)?\\)`
@@ -1373,7 +1365,7 @@ var EventDelegator = {
   }
 };
 
-// src/vdom.ts
+// src/dom.ts
 var wrapMeta = {
   option: [1, "<select multiple>"],
   thead: [1, "<table>"],
@@ -1393,12 +1385,12 @@ var VDoc = document.implementation.createHTMLDocument("");
 var VBase = VDoc.createElement("base");
 VBase.href = document.location.href;
 VDoc.head.appendChild(VBase);
-var VDomSpecials = {
+var DomSpecials = {
   INPUT: ["value", "checked"],
   TEXTAREA: ["value"],
   OPTION: ["selected"]
 };
-function vdomUnmountFrames(frame, node) {
+function domUnmountFrames(frame, node) {
   if (!(node instanceof Element)) return;
   const id = node.getAttribute("id");
   if (!id) return;
@@ -1407,7 +1399,7 @@ function vdomUnmountFrames(frame, node) {
     frame.unmountFrame(id);
   }
 }
-function vdomGetNode(html, refNode) {
+function domGetNode(html, refNode) {
   const tmp = VDoc.createElement("div");
   const ns = refNode.namespaceURI;
   let tag;
@@ -1428,16 +1420,13 @@ function vdomGetNode(html, refNode) {
   }
   return tmp;
 }
-function vdomGetCompareKey(node) {
+function domGetCompareKey(node) {
   if (node.nodeType !== 1) return void 0;
   const el = node;
   if (el.compareKeyCached) {
     return el.cachedCompareKey;
   }
   let key = el.autoId ? "" : el.getAttribute("id") || void 0;
-  if (!key) {
-    key = el.getAttribute(LarkInnerKeys.DIFF_KEY) || void 0;
-  }
   if (!key) {
     const larkView = el.getAttribute(LARK_VIEW);
     if (larkView) {
@@ -1448,8 +1437,8 @@ function vdomGetCompareKey(node) {
   el.cachedCompareKey = key || "";
   return key;
 }
-function vdomSpecialDiff(oldNode, newNode) {
-  const specials = VDomSpecials[oldNode.nodeName];
+function domSpecialDiff(oldNode, newNode) {
+  const specials = DomSpecials[oldNode.nodeName];
   if (!specials) return 0;
   const oldEl = oldNode;
   const newEl = newNode;
@@ -1462,7 +1451,7 @@ function vdomSpecialDiff(oldNode, newNode) {
   }
   return result;
 }
-function vdomSetAttributes(oldNode, newNode, ref, keepId) {
+function domSetAttributes(oldNode, newNode, ref, keepId) {
   const oldEl = oldNode;
   Reflect.deleteProperty(oldEl, "compareKeyCached");
   const oldAttrs = oldNode.attributes;
@@ -1494,7 +1483,7 @@ function vdomSetAttributes(oldNode, newNode, ref, keepId) {
     }
   }
 }
-function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
+function domSetChildNodes(oldParent, newParent, ref, frame, keys_) {
   let oldNode = oldParent.lastChild;
   let newNode = newParent.firstChild;
   let extra = 0;
@@ -1502,7 +1491,7 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
   const newKeyedNodes = /* @__PURE__ */ new Map();
   while (oldNode) {
     extra++;
-    const nodeKey = vdomGetCompareKey(oldNode);
+    const nodeKey = domGetCompareKey(oldNode);
     if (nodeKey) {
       let bucket = keyedNodes.get(nodeKey);
       if (!bucket) {
@@ -1514,7 +1503,7 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
     oldNode = oldNode.previousSibling;
   }
   while (newNode) {
-    const nodeKey = vdomGetCompareKey(newNode);
+    const nodeKey = domGetCompareKey(newNode);
     if (nodeKey) {
       newKeyedNodes.set(nodeKey, (newKeyedNodes.get(nodeKey) ?? 0) + 1);
     }
@@ -1526,7 +1515,7 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
     extra--;
     const tempNew = newNode;
     newNode = newNode.nextSibling;
-    const nodeKey = vdomGetCompareKey(tempNew);
+    const nodeKey = domGetCompareKey(tempNew);
     let foundNode = nodeKey ? keyedNodes.get(nodeKey) : void 0;
     if (foundNode && (foundNode = foundNode.slice()) && foundNode.length) {
       const matched = foundNode.pop();
@@ -1541,17 +1530,17 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
         const c = newKeyedNodes.get(nodeKey);
         if (c) newKeyedNodes.set(nodeKey, c - 1);
       }
-      vdomSetNode(matched, tempNew, oldParent, ref, frame, keys_);
+      domSetNode(matched, tempNew, oldParent, ref, frame, keys_);
     } else if (oldNode) {
       const tempOld2 = oldNode;
-      const oldKey = vdomGetCompareKey(tempOld2);
+      const oldKey = domGetCompareKey(tempOld2);
       if (oldKey && keyedNodes.has(oldKey) && newKeyedNodes.get(oldKey)) {
         extra++;
         ref.hasChanged = 1;
         ref.domOps.push([8, oldParent, tempNew, tempOld2]);
       } else {
         oldNode = oldNode.nextSibling;
-        vdomSetNode(tempOld2, tempNew, oldParent, ref, frame, keys_);
+        domSetNode(tempOld2, tempNew, oldParent, ref, frame, keys_);
       }
     } else {
       ref.hasChanged = 1;
@@ -1561,29 +1550,23 @@ function vdomSetChildNodes(oldParent, newParent, ref, frame, keys_) {
   let tempOld = oldParent.lastChild;
   while (extra-- > 0) {
     if (tempOld) {
-      vdomUnmountFrames(frame, tempOld);
+      domUnmountFrames(frame, tempOld);
       ref.domOps.push([2, oldParent, tempOld]);
       tempOld = tempOld.previousSibling;
       ref.hasChanged = 1;
     }
   }
 }
-function vdomSetNode(oldNode, newNode, oldParent, ref, frame, keys_) {
+function domSetNode(oldNode, newNode, oldParent, ref, frame, keys_) {
   const oldAsEl = oldNode instanceof Element ? oldNode : null;
   const newAsEl = newNode instanceof Element ? newNode : null;
-  const hasViewKey = !!oldAsEl?.hasAttribute(LarkInnerKeys.VIEW_KEY);
   const equalAsNodes = oldAsEl !== null && newAsEl !== null && oldAsEl.isEqualNode && oldAsEl.isEqualNode(newAsEl);
-  if (vdomSpecialDiff(oldNode, newNode) || hasViewKey || !equalAsNodes) {
+  if (domSpecialDiff(oldNode, newNode) || !equalAsNodes) {
     if (oldNode.nodeType === newNode.nodeType && oldNode.nodeName === newNode.nodeName) {
       if (oldAsEl !== null && newAsEl !== null) {
         const oldEl = oldAsEl;
         const newEl = newAsEl;
-        const staticKey = newEl.getAttribute(LarkInnerKeys.DIFF_KEY);
-        if (staticKey && staticKey === oldEl.getAttribute(LarkInnerKeys.DIFF_KEY)) {
-          return;
-        }
         const newLarkView = newEl.getAttribute(LARK_VIEW);
-        const updateAttribute = !newEl.getAttribute(LarkInnerKeys.ATTR_KEY) || newEl.getAttribute(LarkInnerKeys.ATTR_KEY) !== oldEl.getAttribute(LarkInnerKeys.ATTR_KEY);
         let updateChildren = true;
         if (newLarkView) {
           const oldFrameId = oldEl.getAttribute("id") || "";
@@ -1594,11 +1577,9 @@ function vdomSetNode(oldNode, newNode, oldParent, ref, frame, keys_) {
             updateChildren = false;
           }
         }
-        if (updateAttribute) {
-          vdomSetAttributes(oldEl, newEl, ref, !!newLarkView);
-        }
+        domSetAttributes(oldEl, newEl, ref, !!newLarkView);
         if (updateChildren) {
-          vdomSetChildNodes(oldEl, newEl, ref, frame, keys_);
+          domSetChildNodes(oldEl, newEl, ref, frame, keys_);
         }
       } else if (oldNode.nodeValue !== newNode.nodeValue) {
         ref.hasChanged = 1;
@@ -1606,12 +1587,12 @@ function vdomSetNode(oldNode, newNode, oldParent, ref, frame, keys_) {
       }
     } else {
       ref.hasChanged = 1;
-      vdomUnmountFrames(frame, oldNode);
+      domUnmountFrames(frame, oldNode);
       ref.domOps.push([4, oldParent, newNode, oldNode]);
     }
   }
 }
-function createVdomRef() {
+function createDomRef() {
   return {
     idUpdates: [],
     views: [],
@@ -1619,7 +1600,7 @@ function createVdomRef() {
     hasChanged: 0
   };
 }
-function applyVdomOps(ops) {
+function applyDomOps(ops) {
   for (const op of ops) {
     switch (op[0]) {
       case 1:
@@ -1758,11 +1739,11 @@ var Updater = class {
     return this;
   }
   /**
-   * Detect changes and trigger VDOM re-render.
+   * Detect changes and trigger DOM re-render.
    *
    * The core rendering pipeline:
    * 1. Set data if provided
-   * 2. If changed, run VDOM diff (template → new DOM → diff against old DOM)
+   * 2. If changed, run DOM diff (template → new DOM → diff against old DOM)
    * 3. Apply DOM operations
    * 4. Apply ID updates
    * 5. Call endUpdate on views that need re-rendering
@@ -1807,11 +1788,11 @@ var Updater = class {
           updaterRef,
           encodeQ
         );
-        const newDom = vdomGetNode(html, node);
-        const ref = createVdomRef();
-        vdomSetChildNodes(node, newDom, ref, frame, keys2);
+        const newDom = domGetNode(html, node);
+        const ref = createDomRef();
+        domSetChildNodes(node, newDom, ref, frame, keys2);
         applyIdUpdates(ref.idUpdates);
-        applyVdomOps(ref.domOps);
+        applyDomOps(ref.domOps);
         for (const v of ref.views) {
           if (v.render) {
             funcWithTry(v.render, [], v, noop);
@@ -4255,16 +4236,23 @@ export {
   Updater,
   VIEW_EVENT_METHOD_REGEXP,
   View,
+  applyDomOps,
   applyIdUpdates,
   applyStyle,
-  applyVdomOps,
   assign,
   bindStore,
   computed,
   create,
-  createVdomRef,
+  createDomRef,
   defineStore,
   defineView,
+  domGetCompareKey,
+  domGetNode,
+  domSetAttributes,
+  domSetChildNodes,
+  domSetNode,
+  domSpecialDiff,
+  domUnmountFrames,
   encodeHTML,
   encodeQ,
   encodeSafe,
@@ -4302,12 +4290,5 @@ export {
   translateData,
   unmark,
   use,
-  useUrlState,
-  vdomGetCompareKey,
-  vdomGetNode,
-  vdomSetAttributes,
-  vdomSetChildNodes,
-  vdomSetNode,
-  vdomSpecialDiff,
-  vdomUnmountFrames
+  useUrlState
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark.js/mvc",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "@lark.js/mvc - TypeScript MVC framework",
   "keywords": [
     "framework",
@@ -90,14 +90,14 @@
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "^24.13.1",
+    "@types/node": "^24.13.2",
     "@vitest/coverage-v8": "4.1.6",
-    "rollup": "^4.61.1",
+    "rollup": "^4.62.0",
     "rollup-plugin-dts": "^6.4.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vite": "^8.0.16",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.9"
   },
   "peerDependencies": {
     "vite": "^8.0.14"

package/src/client.d.ts

@@ -50,9 +50,9 @@ declare global {
   }
 
   interface Element {
-    /** VDOM diff cached compare key flag */
+    /** DOM diff cached compare key flag */
     compareKeyCached?: number | undefined;
-    /** VDOM diff cached compare key */
+    /** DOM diff cached compare key */
     cachedCompareKey?: string | undefined;
     "v-lark"?: string | undefined;