@lark.js/mvc 0.0.8 → 0.0.10

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                                                                    |
 | --------- | -------------------------------------------------------------------------- |
@@ -927,28 +927,6 @@ The `lark-visual` sub-project in this repository is the paired visual DevTools t
 19. MF view paths use the remote project name as prefix: `v-lark="remote-app/views/home"` triggers async loading via `FrameworkConfig.require` when unregistered; `@lark.js/mvc` must be `singleton: true`.
 20. `splitChunks.chunks` must be `"async"` in MF projects: `"all"` breaks shared scope initialization.
 
-## Recent API Changes
-
-- Store rewrite (zustand-style):
-  - `defineStore(name, (store) => body)` replaced by `create(name, (set, get) => body)`. `defineStore` retained as deprecated alias.
-  - `store.key = value` (Proxy write) replaced by `set({ key: value })`.
-  - `store.key` reads in actions replaced by `get().key`.
-  - `useStore(view)` + `store.observe(view, keys?)` replaced by `bindStore(view, store, selector?)`.
-  - `useStore()` (read-only access) replaced by `store.getState()`.
-  - `store.observe(undefined, keys, cb)` (internal reaction) replaced by `store.subscribe((state, prev) => ...)`.
-  - Removed: `multi()`, `cell()`, `observeCell()`, `cloneStore()`, `getStore()`, `delStore()`, `getUseStore()`, `isStoreActive()`, `createState()`, `shallowSet()`, `lazySet()`, `cloneData()`, `isState()`, `storeMark`, `storeUnmark`, `getPlatform`, `Platform`, `StoreConfig`, `ObservePayload`, `StoreMethods`, `LarkUseStore`, `ReactUseStore`, `NodeUseStore`.
-- Router history mode support:
-  - Added `FrameworkConfig.routeMode` (`"history"` default, `"hash"` optional).
-  - In history mode, path comes from `window.location.pathname`, params from search query string.
-  - Added `useUrlState(view, initialState?)` for URL parameter state sync.
-- `ChangeEvent.keys` changed to `ReadonlySet<string>` (was `Record<string, 1>`). Use `keys.has("foo")` instead of `keys.foo`.
-- `StateInterface.diff()` returns `ReadonlySet<string>`.
-- `Updater.set/digest`, `State.set/digest`, `setData` `excludes?` changed to `ReadonlySet<string>` (was `Set<string>`).
-- `Frame.root(id)` `@deprecated`. Read via `Frame.getRoot()`, create singleton via `Frame.createRoot(id)`, independent mount via `new Frame(id)`.
-- `Updater.parse` no longer evals; only supports safe paths and literals.
-- `mark.ts` no longer writes magic keys to host objects; uses module-level `WeakMap`, works on `Object.freeze`d objects.
-- `Cache.del` immediately removes from `entries` array and `lookup` Map (previously left tombstones until next eviction).
-
 ## Comparison with Vue 3 / React 19
 
 ### vs Vue 3

package/dist/{chunk-3HSA7OHB.js → chunk-SIQF4YLC.js}

@@ -14847,7 +14847,7 @@ function convertArtExpression(code, debug, lineNo, blockStack = []) {
       const object = tokens[0];
       if (tokens.length > 1 && tokens[1] !== "as") {
         throw new Error(
-          `[@lark.js/mvc error] bad forIn syntax: {{${code}}}. Expected "as" keyword, got "${tokens[1]}". Usage: {{for-in obj as val [key]}}`
+          `[@lark.js/mvc error] bad forIn syntax: {{${code}}}. Expected "as" keyword, got "${tokens[1]}". Usage: {{forIn obj as val [key]}}`
         );
       }
       const restTokens2 = tokens.slice(2);
@@ -15084,7 +15084,8 @@ function extractGlobalVars(source) {
   } catch {
     return fallbackExtractVariables(source);
   }
-  const globalExists = { ...BUILTIN_GLOBALS };
+  const globalExists = {};
+  for (const name of BUILTIN_GLOBALS) globalExists[name] = 1;
   const globalVars = /* @__PURE__ */ Object.create(null);
   const fnRange = [];
   walkAst(ast, {
@@ -15158,7 +15159,7 @@ function fallbackExtractVariables(source) {
   while ((m = ifRegExp.exec(source)) !== null) {
     vars.add(m[1]);
   }
-  return Array.from(vars).filter((v) => !BUILTIN_GLOBAL_SET.has(v));
+  return Array.from(vars).filter((v) => !BUILTIN_GLOBALS.has(v));
 }
 function walkAst(ast, visitors) {
   function visit(node) {
@@ -15197,7 +15198,7 @@ function walkAst(ast, visitors) {
 function isAstNode(v) {
   return !!v && typeof v === "object" && typeof v.type === "string";
 }
-var BUILTIN_GLOBALS = {
+var BUILTIN_GLOBALS = /* @__PURE__ */ new Set([
   // ─── Template runtime helpers (injected by compileToFunction) ───────
   //
   // These variables appear in the generated template function signature
@@ -15206,147 +15207,146 @@ var BUILTIN_GLOBALS = {
   // SPLITTER character constant (same as \x1e), used as namespace separator
   // for refData keys, event attribute encoding, and internal data structures.
   // Declared as: let $splitter='\x1e'
-  $splitter: 1,
+  "$splitter",
   // Data — the data object passed from Updater to the template function.
   // User variables are destructured from $data at the top of the function:
   //   let {name, age} = $data;
   // This is the first parameter of the generated arrow function.
-  $data: 1,
+  "$data",
   // Null-safe toString: v => '' + (v == null ? '' : v)
   // Converts null/undefined to empty string, otherwise calls toString().
   // Wraps every {{!raw}} output to prevent "null" / "undefined" rendering.
-  $strSafe: 1,
+  "$strSafe",
   // HTML entity encoder: v => $strSafe(v).replace(/[&<>"'`]/g, entityMap)
   // Encodes &, <, >, ", ', ` to HTML entities (&amp; &lt; etc.)
   // Applied to all {{=escaped}} and {{:binding}} outputs.
-  $encHtml: 1,
+  "$encHtml",
   // HTML entity map — internal object used by $encHtml:
   //   {'&':'amp','<':'gt','>':'gt','"':'#34','\'':'#39','`':'#96'}
   // Not a standalone function; referenced inside $encHtml's closure.
-  $entMap: 1,
+  "$entMap",
   // HTML entity RegExp — internal regexp used by $encHtml:
   //   /[&<>"'`]/g
-  $entReg: 1,
+  "$entReg",
   // HTML entity replacer function — internal helper used by $encHtml:
   //   m => '&' + $entMap[m] + ';'
   // Maps matched character to its entity string.
-  $entFn: 1,
+  "$entFn",
   // Output buffer — the string accumulator for rendered HTML.
   // All template output is appended via $out += '...'.
   // Declared as: let $out = ''
-  $out: 1,
+  "$out",
   // Reference lookup: (refData, value) => key
   // Finds or allocates a SPLITTER-prefixed key in refData for a given
   // object reference. Used by {{@ref}} operator for passing object
   // references to child views via v-lark attributes.
-  $refFn: 1,
+  "$refFn",
   // URI encoder: v => encodeURIComponent($strSafe(v)).replace(/[!')(*]/g, extraMap)
   // Extends encodeURIComponent with encoding of ! ' ( ) *.
   // Applied to values in @event URL parameters and {{!uri}} contexts.
-  $encUri: 1,
+  "$encUri",
   // URI encode map — internal object used by $encUri:
   //   {'!':'%21','\'':'%27','(':'%28',')':'%29','*':'%2A'}
-  $uriMap: 1,
+  "$uriMap",
   // URI encode replacer — internal helper used by $encUri:
   //   m => $uriMap[m]
-  $uriFn: 1,
+  "$uriFn",
   // URI encode regexp — internal regexp used by $encUri:
   //   /[!')(*]/g
-  $uriReg: 1,
+  "$uriReg",
   // Quote encoder: v => $strSafe(v).replace(/['"\\]/g, '\\$&')
   // Escapes quotes and backslashes for safe embedding in HTML attribute
   // values (e.g. data-json='...').
-  $encQuote: 1,
+  "$encQuote",
   // Quote encode regexp — internal regexp used by $encQuote:
   //   /['"\\]/g
-  $qReg: 1,
+  "$qReg",
   // View ID — the unique identifier of the owning View instance.
   // Injected into @event attribute values at render time so that
   // EventDelegator can dispatch events to the correct View handler.
   // The \x1f placeholder in compiled output is replaced with '+$viewId+'.
-  $viewId: 1,
+  "$viewId",
   // Debug: current expression text — stores the template expression being
   // evaluated, for error reporting. Only present in debug mode.
   // e.g. $dbgExpr='<%=user.name%>'
-  $dbgExpr: 1,
+  "$dbgExpr",
   // Debug: original art syntax — stores the {{}} template syntax before
   // conversion, for error reporting. Only present in debug mode.
   // e.g. $dbgArt='{{=user.name}}'
-  $dbgArt: 1,
+  "$dbgArt",
   // Debug: source line number — tracks the current line in the template
   // source, for error reporting. Only present in debug mode.
-  $dbgLine: 1,
+  "$dbgLine",
   // RefData alias — fallback reference lookup table.
   // Defaults to $data when no explicit $refAlt is provided.
   // Ensures $refFn() does not crash when @ operator is used without refData.
-  $refAlt: 1,
+  "$refAlt",
   // Temporary variable — used by the compiler for intermediate
   // expression results in generated code (e.g. loop variables,
   // conditional branches). Declared as: let $tmp
-  $tmp: 1,
+  "$tmp",
   // JS literals
-  undefined: 1,
-  null: 1,
-  true: 1,
-  false: 1,
-  NaN: 1,
-  Infinity: 1,
+  "undefined",
+  "null",
+  "true",
+  "false",
+  "NaN",
+  "Infinity",
   // JS built-in globals
-  window: 1,
-  self: 1,
-  globalThis: 1,
-  document: 1,
-  console: 1,
-  JSON: 1,
-  Math: 1,
-  Intl: 1,
-  Promise: 1,
-  Symbol: 1,
-  Number: 1,
-  String: 1,
-  Boolean: 1,
-  Array: 1,
-  Object: 1,
-  Date: 1,
-  RegExp: 1,
-  Error: 1,
-  TypeError: 1,
-  RangeError: 1,
-  SyntaxError: 1,
-  Map: 1,
-  Set: 1,
-  WeakMap: 1,
-  WeakSet: 1,
-  Proxy: 1,
-  Reflect: 1,
-  ArrayBuffer: 1,
-  DataView: 1,
-  Float32Array: 1,
-  Float64Array: 1,
-  Int8Array: 1,
-  Int16Array: 1,
-  Int32Array: 1,
-  Uint8Array: 1,
-  Uint16Array: 1,
-  Uint32Array: 1,
-  Uint8ClampedArray: 1,
+  "window",
+  "self",
+  "globalThis",
+  "document",
+  "console",
+  "JSON",
+  "Math",
+  "Intl",
+  "Promise",
+  "Symbol",
+  "Number",
+  "String",
+  "Boolean",
+  "Array",
+  "Object",
+  "Date",
+  "RegExp",
+  "Error",
+  "TypeError",
+  "RangeError",
+  "SyntaxError",
+  "Map",
+  "Set",
+  "WeakMap",
+  "WeakSet",
+  "Proxy",
+  "Reflect",
+  "ArrayBuffer",
+  "DataView",
+  "Float32Array",
+  "Float64Array",
+  "Int8Array",
+  "Int16Array",
+  "Int32Array",
+  "Uint8Array",
+  "Uint16Array",
+  "Uint32Array",
+  "Uint8ClampedArray",
   // Functions
-  parseInt: 1,
-  parseFloat: 1,
-  isNaN: 1,
-  isFinite: 1,
-  encodeURIComponent: 1,
-  decodeURIComponent: 1,
-  encodeURI: 1,
-  decodeURI: 1,
+  "parseInt",
+  "parseFloat",
+  "isNaN",
+  "isFinite",
+  "encodeURIComponent",
+  "decodeURIComponent",
+  "encodeURI",
+  "decodeURI",
   // Babel helpers
-  arguments: 1,
-  this: 1,
-  require: 1,
+  "arguments",
+  "this",
+  "require",
   // Lark framework
-  Lark: 1
-};
-var BUILTIN_GLOBAL_SET = new Set(Object.keys(BUILTIN_GLOBALS));
+  "Lark"
+]);
 
 export {
   compileTemplate,

package/dist/compiler.cjs

@@ -14859,7 +14859,7 @@ function convertArtExpression(code, debug, lineNo, blockStack = []) {
       const object = tokens[0];
       if (tokens.length > 1 && tokens[1] !== "as") {
         throw new Error(
-          `[@lark.js/mvc error] bad forIn syntax: {{${code}}}. Expected "as" keyword, got "${tokens[1]}". Usage: {{for-in obj as val [key]}}`
+          `[@lark.js/mvc error] bad forIn syntax: {{${code}}}. Expected "as" keyword, got "${tokens[1]}". Usage: {{forIn obj as val [key]}}`
         );
       }
       const restTokens2 = tokens.slice(2);
@@ -15096,7 +15096,8 @@ function extractGlobalVars(source) {
   } catch {
     return fallbackExtractVariables(source);
   }
-  const globalExists = { ...BUILTIN_GLOBALS };
+  const globalExists = {};
+  for (const name of BUILTIN_GLOBALS) globalExists[name] = 1;
   const globalVars = /* @__PURE__ */ Object.create(null);
   const fnRange = [];
   walkAst(ast, {
@@ -15170,7 +15171,7 @@ function fallbackExtractVariables(source) {
   while ((m = ifRegExp.exec(source)) !== null) {
     vars.add(m[1]);
   }
-  return Array.from(vars).filter((v) => !BUILTIN_GLOBAL_SET.has(v));
+  return Array.from(vars).filter((v) => !BUILTIN_GLOBALS.has(v));
 }
 function walkAst(ast, visitors) {
   function visit(node) {
@@ -15209,7 +15210,7 @@ function walkAst(ast, visitors) {
 function isAstNode(v) {
   return !!v && typeof v === "object" && typeof v.type === "string";
 }
-var BUILTIN_GLOBALS = {
+var BUILTIN_GLOBALS = /* @__PURE__ */ new Set([
   // ─── Template runtime helpers (injected by compileToFunction) ───────
   //
   // These variables appear in the generated template function signature
@@ -15218,147 +15219,146 @@ var BUILTIN_GLOBALS = {
   // SPLITTER character constant (same as \x1e), used as namespace separator
   // for refData keys, event attribute encoding, and internal data structures.
   // Declared as: let $splitter='\x1e'
-  $splitter: 1,
+  "$splitter",
   // Data — the data object passed from Updater to the template function.
   // User variables are destructured from $data at the top of the function:
   //   let {name, age} = $data;
   // This is the first parameter of the generated arrow function.
-  $data: 1,
+  "$data",
   // Null-safe toString: v => '' + (v == null ? '' : v)
   // Converts null/undefined to empty string, otherwise calls toString().
   // Wraps every {{!raw}} output to prevent "null" / "undefined" rendering.
-  $strSafe: 1,
+  "$strSafe",
   // HTML entity encoder: v => $strSafe(v).replace(/[&<>"'`]/g, entityMap)
   // Encodes &, <, >, ", ', ` to HTML entities (&amp; &lt; etc.)
   // Applied to all {{=escaped}} and {{:binding}} outputs.
-  $encHtml: 1,
+  "$encHtml",
   // HTML entity map — internal object used by $encHtml:
   //   {'&':'amp','<':'gt','>':'gt','"':'#34','\'':'#39','`':'#96'}
   // Not a standalone function; referenced inside $encHtml's closure.
-  $entMap: 1,
+  "$entMap",
   // HTML entity RegExp — internal regexp used by $encHtml:
   //   /[&<>"'`]/g
-  $entReg: 1,
+  "$entReg",
   // HTML entity replacer function — internal helper used by $encHtml:
   //   m => '&' + $entMap[m] + ';'
   // Maps matched character to its entity string.
-  $entFn: 1,
+  "$entFn",
   // Output buffer — the string accumulator for rendered HTML.
   // All template output is appended via $out += '...'.
   // Declared as: let $out = ''
-  $out: 1,
+  "$out",
   // Reference lookup: (refData, value) => key
   // Finds or allocates a SPLITTER-prefixed key in refData for a given
   // object reference. Used by {{@ref}} operator for passing object
   // references to child views via v-lark attributes.
-  $refFn: 1,
+  "$refFn",
   // URI encoder: v => encodeURIComponent($strSafe(v)).replace(/[!')(*]/g, extraMap)
   // Extends encodeURIComponent with encoding of ! ' ( ) *.
   // Applied to values in @event URL parameters and {{!uri}} contexts.
-  $encUri: 1,
+  "$encUri",
   // URI encode map — internal object used by $encUri:
   //   {'!':'%21','\'':'%27','(':'%28',')':'%29','*':'%2A'}
-  $uriMap: 1,
+  "$uriMap",
   // URI encode replacer — internal helper used by $encUri:
   //   m => $uriMap[m]
-  $uriFn: 1,
+  "$uriFn",
   // URI encode regexp — internal regexp used by $encUri:
   //   /[!')(*]/g
-  $uriReg: 1,
+  "$uriReg",
   // Quote encoder: v => $strSafe(v).replace(/['"\\]/g, '\\$&')
   // Escapes quotes and backslashes for safe embedding in HTML attribute
   // values (e.g. data-json='...').
-  $encQuote: 1,
+  "$encQuote",
   // Quote encode regexp — internal regexp used by $encQuote:
   //   /['"\\]/g
-  $qReg: 1,
+  "$qReg",
   // View ID — the unique identifier of the owning View instance.
   // Injected into @event attribute values at render time so that
   // EventDelegator can dispatch events to the correct View handler.
   // The \x1f placeholder in compiled output is replaced with '+$viewId+'.
-  $viewId: 1,
+  "$viewId",
   // Debug: current expression text — stores the template expression being
   // evaluated, for error reporting. Only present in debug mode.
   // e.g. $dbgExpr='<%=user.name%>'
-  $dbgExpr: 1,
+  "$dbgExpr",
   // Debug: original art syntax — stores the {{}} template syntax before
   // conversion, for error reporting. Only present in debug mode.
   // e.g. $dbgArt='{{=user.name}}'
-  $dbgArt: 1,
+  "$dbgArt",
   // Debug: source line number — tracks the current line in the template
   // source, for error reporting. Only present in debug mode.
-  $dbgLine: 1,
+  "$dbgLine",
   // RefData alias — fallback reference lookup table.
   // Defaults to $data when no explicit $refAlt is provided.
   // Ensures $refFn() does not crash when @ operator is used without refData.
-  $refAlt: 1,
+  "$refAlt",
   // Temporary variable — used by the compiler for intermediate
   // expression results in generated code (e.g. loop variables,
   // conditional branches). Declared as: let $tmp
-  $tmp: 1,
+  "$tmp",
   // JS literals
-  undefined: 1,
-  null: 1,
-  true: 1,
-  false: 1,
-  NaN: 1,
-  Infinity: 1,
+  "undefined",
+  "null",
+  "true",
+  "false",
+  "NaN",
+  "Infinity",
   // JS built-in globals
-  window: 1,
-  self: 1,
-  globalThis: 1,
-  document: 1,
-  console: 1,
-  JSON: 1,
-  Math: 1,
-  Intl: 1,
-  Promise: 1,
-  Symbol: 1,
-  Number: 1,
-  String: 1,
-  Boolean: 1,
-  Array: 1,
-  Object: 1,
-  Date: 1,
-  RegExp: 1,
-  Error: 1,
-  TypeError: 1,
-  RangeError: 1,
-  SyntaxError: 1,
-  Map: 1,
-  Set: 1,
-  WeakMap: 1,
-  WeakSet: 1,
-  Proxy: 1,
-  Reflect: 1,
-  ArrayBuffer: 1,
-  DataView: 1,
-  Float32Array: 1,
-  Float64Array: 1,
-  Int8Array: 1,
-  Int16Array: 1,
-  Int32Array: 1,
-  Uint8Array: 1,
-  Uint16Array: 1,
-  Uint32Array: 1,
-  Uint8ClampedArray: 1,
+  "window",
+  "self",
+  "globalThis",
+  "document",
+  "console",
+  "JSON",
+  "Math",
+  "Intl",
+  "Promise",
+  "Symbol",
+  "Number",
+  "String",
+  "Boolean",
+  "Array",
+  "Object",
+  "Date",
+  "RegExp",
+  "Error",
+  "TypeError",
+  "RangeError",
+  "SyntaxError",
+  "Map",
+  "Set",
+  "WeakMap",
+  "WeakSet",
+  "Proxy",
+  "Reflect",
+  "ArrayBuffer",
+  "DataView",
+  "Float32Array",
+  "Float64Array",
+  "Int8Array",
+  "Int16Array",
+  "Int32Array",
+  "Uint8Array",
+  "Uint16Array",
+  "Uint32Array",
+  "Uint8ClampedArray",
   // Functions
-  parseInt: 1,
-  parseFloat: 1,
-  isNaN: 1,
-  isFinite: 1,
-  encodeURIComponent: 1,
-  decodeURIComponent: 1,
-  encodeURI: 1,
-  decodeURI: 1,
+  "parseInt",
+  "parseFloat",
+  "isNaN",
+  "isFinite",
+  "encodeURIComponent",
+  "decodeURIComponent",
+  "encodeURI",
+  "decodeURI",
   // Babel helpers
-  arguments: 1,
-  this: 1,
-  require: 1,
+  "arguments",
+  "this",
+  "require",
   // Lark framework
-  Lark: 1
-};
-var BUILTIN_GLOBAL_SET = new Set(Object.keys(BUILTIN_GLOBALS));
+  "Lark"
+]);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   compileTemplate,