@lark.js/mvc 0.0.13 → 0.0.14

package/README.md

@@ -735,7 +735,6 @@ Marking large static subtrees with `ldk` can completely skip rendering work. Thi
 | `Frame.getAll()`                                  | All Frames as `Map<string, Frame>`                                                                                             |
 | `Frame.getRoot()`                                 | Current root Frame; returns `undefined` if not created                                                                         |
 | `Frame.createRoot(id)`                            | Idempotent root creation (`Framework.boot` calls this)                                                                         |
-| `Frame.root(id)`                                  | `@deprecated` alias, forwards to `createRoot`                                                                                  |
 | `new Frame(containerId)`                          | Independent Frame instance for micro-frontend / embedded widget scenarios                                                      |
 | `frame.invoke(name, args?)`                       | Call the owning view's method; if view not mounted, pushes to `invokeList`, flushed by `View.runInvokes(frame)` after mounting |
 | `frame.children()`                                | Child Frame id array (order not guaranteed)                                                                                    |

package/dist/compiler.cjs

@@ -14518,7 +14518,7 @@ var require_lib = __commonJS({
         options = Object.assign({}, options);
         try {
           options.sourceType = "module";
-          const parser = getParser2(options, input);
+          const parser = getParser(options, input);
           const ast = parser.parse();
           if (parser.sawUnambiguousESM) {
             return ast;
@@ -14526,7 +14526,7 @@ var require_lib = __commonJS({
           if (parser.ambiguousScriptDifferentAst) {
             try {
               options.sourceType = "script";
-              return getParser2(options, input).parse();
+              return getParser(options, input).parse();
             } catch (_unused) {
             }
           } else {
@@ -14536,17 +14536,17 @@ var require_lib = __commonJS({
         } catch (moduleError) {
           try {
             options.sourceType = "script";
-            return getParser2(options, input).parse();
+            return getParser(options, input).parse();
           } catch (_unused2) {
           }
           throw moduleError;
         }
       } else {
-        return getParser2(options, input).parse();
+        return getParser(options, input).parse();
       }
     }
     function parseExpression(input, options) {
-      const parser = getParser2(options, input);
+      const parser = getParser(options, input);
       if (parser.options.strictMode) {
         parser.state.strict = true;
       }
@@ -14560,7 +14560,7 @@ var require_lib = __commonJS({
       return tokenTypes2;
     }
     var tokTypes = generateExportedTokenTypes(tt);
-    function getParser2(options, input) {
+    function getParser(options, input) {
       let cls = Parser;
       const pluginsMap = /* @__PURE__ */ new Map();
       if (options != null && options.plugins) {
@@ -14609,8 +14609,7 @@ var require_lib = __commonJS({
 var compiler_exports = {};
 __export(compiler_exports, {
   compileTemplate: () => compileTemplate,
-  extractGlobalVars: () => extractGlobalVars2,
-  extractGlobalVarsSwc: () => extractGlobalVars
+  extractGlobalVars: () => extractGlobalVars
 });
 module.exports = __toCommonJS(compiler_exports);
 
@@ -15147,334 +15146,9 @@ function compileToVDomFunction(source, debug, file) {
   return `($data,$viewId,$refAlt,$n,$refFn,$encUri,$encQuote)=>{${fullSource}}`;
 }
 
-// src/compiler/swc/extract-global-vars.ts
-var parseSyncFn = null;
-var parseSyncLoadAttempted = false;
-async function getParser() {
-  if (!parseSyncLoadAttempted) {
-    parseSyncLoadAttempted = true;
-    try {
-      const swc = await import("@swc/core");
-      parseSyncFn = swc.parseSync;
-    } catch (err) {
-      console.error("failed to load @swc/core", err);
-    }
-  }
-  return parseSyncFn;
-}
-async function extractGlobalVars(source) {
-  const { protectedSource, comments: _comments } = protectComments(source);
-  const viewEventProcessed = processViewEvents(protectedSource);
-  const converted = convertArtSyntax(viewEventProcessed, false);
-  const template = restoreComments(converted, _comments);
-  const templateCmdRegExp = /<%([@=!:])?([\s\S]*?)%>|$/g;
-  const fnParts = [];
-  const htmlStore = {};
-  let htmlIndex = 0;
-  let lastIndex = 0;
-  const htmlKey = String.fromCharCode(5);
-  template.replace(
-    templateCmdRegExp,
-    (match, operate, content, offset) => {
-      const start = operate ? 3 : 2;
-      const htmlText = template.substring(lastIndex, offset + start);
-      const key = htmlKey + htmlIndex++ + htmlKey;
-      htmlStore[key] = htmlText;
-      lastIndex = offset + match.length - 2;
-      if (operate && content.trim()) {
-        fnParts.push(';"' + key + '";', "[" + content + "]");
-      } else {
-        fnParts.push(';"' + key + '";', content || "");
-      }
-      return match;
-    }
-  );
-  let fn = fnParts.join("");
-  fn = `(function(){${fn}})`;
-  const parseSync = await getParser();
-  if (!parseSync) {
-    return fallbackExtractVariables(source);
-  }
-  let ast;
-  try {
-    ast = parseSync(fn, {
-      syntax: "ecmascript",
-      target: "es2022"
-    });
-  } catch {
-    return fallbackExtractVariables(source);
-  }
-  const globalExists = {};
-  for (const name of BUILTIN_GLOBALS) globalExists[name] = 1;
-  const globalVars = /* @__PURE__ */ Object.create(null);
-  const fnNodes = [];
-  walkSwcAst(ast, {
-    VariableDeclarator(node) {
-      if (node.id.type === "Identifier") {
-        const name = node.id.value;
-        globalExists[name] = node.init ? 3 : 2;
-      }
-    },
-    FunctionDeclaration(node) {
-      if (node.identifier) {
-        globalExists[node.identifier.value] = 3;
-      }
-      fnNodes.push(node);
-    },
-    FunctionExpression(node) {
-      fnNodes.push(node);
-    },
-    ArrowFunctionExpression(node) {
-      fnNodes.push(node);
-    },
-    CallExpression(node) {
-      if (node.callee.type === "Identifier") {
-        globalExists[node.callee.value] = 1;
-      }
-    }
-  });
-  const functionParams = /* @__PURE__ */ Object.create(null);
-  for (const fnNode of fnNodes) {
-    const patterns = getParamPatterns(fnNode);
-    for (const pat of patterns) {
-      if (pat.type === "Identifier") {
-        functionParams[pat.value] = 1;
-      } else if (pat.type === "AssignmentPattern" && pat.left.type === "Identifier") {
-        functionParams[pat.left.value] = 1;
-      } else if (pat.type === "RestElement" && pat.argument.type === "Identifier") {
-        functionParams[pat.argument.value] = 1;
-      }
-    }
-  }
-  walkSwcAst(ast, {
-    Identifier(node) {
-      const name = node.value;
-      if (globalExists[name]) return;
-      if (functionParams[name]) return;
-      globalVars[name] = 1;
-    },
-    AssignmentExpression(node) {
-      if (node.left.type === "Identifier") {
-        const name = node.left.value;
-        if (!globalExists[name] || globalExists[name] === 1) {
-          globalExists[name] = (globalExists[name] || 0) + 1;
-        }
-      }
-    }
-  });
-  return Object.keys(globalVars);
-}
-function getParamPatterns(fnNode) {
-  if (fnNode.type === "ArrowFunctionExpression") {
-    return fnNode.params;
-  }
-  return fnNode.params.map((p) => p.pat);
-}
-function fallbackExtractVariables(source) {
-  const vars = /* @__PURE__ */ new Set();
-  const outputRegExp = /\{\{[:=!@]\s*([a-zA-Z_$][\w$]*)[^}]*\}\}/g;
-  let m;
-  while ((m = outputRegExp.exec(source)) !== null) {
-    vars.add(m[1]);
-  }
-  const eachRegExp = /\{\{forOf\s+([a-zA-Z_$][\w$]*)\s+as/g;
-  while ((m = eachRegExp.exec(source)) !== null) {
-    vars.add(m[1]);
-  }
-  const ifRegExp = /\{\{(?:else\s+)?if\s+([a-zA-Z_$][\w$]*)[^}]*\}\}/g;
-  while ((m = ifRegExp.exec(source)) !== null) {
-    vars.add(m[1]);
-  }
-  return Array.from(vars).filter((v) => !BUILTIN_GLOBALS.has(v));
-}
-function walkSwcAst(ast, visitors) {
-  function visit(node) {
-    const type = node.type;
-    if (visitors[type]) {
-      visitors[type](node);
-    }
-    for (const key of Object.keys(node)) {
-      if (key === "type" || key === "span" || key === "ctxt") continue;
-      if (type === "MemberExpression" && key === "property") {
-        const me = node;
-        if (me.property.type !== "Computed") continue;
-      }
-      if (type === "KeyValueProperty" && key === "key") {
-        const kv = node;
-        if (kv.key.type !== "Computed") continue;
-      }
-      if (type === "MethodProperty" && key === "key") {
-        const mp = node;
-        if (mp.key.type !== "Computed") continue;
-      }
-      const child = Reflect.get(node, key);
-      if (Array.isArray(child)) {
-        for (const item of child) {
-          if (isSwcNode(item)) visit(item);
-        }
-      } else if (isSwcNode(child)) {
-        visit(child);
-      }
-    }
-  }
-  visit(ast);
-}
-function isSwcNode(v) {
-  return !!v && typeof v === "object" && typeof v.type === "string";
-}
-var BUILTIN_GLOBALS = /* @__PURE__ */ new Set([
-  // ─── Template runtime helpers (injected by compileToFunction) ───────
-  //
-  // These variables appear in the generated template function signature
-  // or body. They must be excluded from extractGlobalVars() so that
-  // they are not mistaken for user data variables and destructured from $data.
-  // 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",
-  // 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",
-  // 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",
-  // HTML entity encoder: v => $strSafe(v).replace(/[&<>"'`]/g, entityMap)
-  // Encodes &, <, >, ", ', ` to HTML entities (&amp; &lt; etc.)
-  // Applied to all {{=escaped}} and {{:binding}} outputs.
-  "$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",
-  // HTML entity RegExp — internal regexp used by $encHtml:
-  //   /[&<>"'`]/g
-  "$entReg",
-  // HTML entity replacer function — internal helper used by $encHtml:
-  //   m => '&' + $entMap[m] + ';'
-  // Maps matched character to its entity string.
-  "$entFn",
-  // Output buffer — the string accumulator for rendered HTML.
-  // All template output is appended via $out += '...'.
-  // Declared as: let $out = ''
-  "$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",
-  // 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",
-  // URI encode map — internal object used by $encUri:
-  //   {'!':'%21','\'':'%27','(':'%28',')':'%29','*':'%2A'}
-  "$uriMap",
-  // URI encode replacer — internal helper used by $encUri:
-  //   m => $uriMap[m]
-  "$uriFn",
-  // URI encode regexp — internal regexp used by $encUri:
-  //   /[!')(*]/g
-  "$uriReg",
-  // Quote encoder: v => $strSafe(v).replace(/['"\\]/g, '\\$&')
-  // Escapes quotes and backslashes for safe embedding in HTML attribute
-  // values (e.g. data-json='...').
-  "$encQuote",
-  // Quote encode regexp — internal regexp used by $encQuote:
-  //   /['"\\]/g
-  "$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",
-  // Debug: current expression text — stores the template expression being
-  // evaluated, for error reporting. Only present in debug mode.
-  // e.g. $dbgExpr='<%=user.name%>'
-  "$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",
-  // Debug: source line number — tracks the current line in the template
-  // source, for error reporting. Only present in debug mode.
-  "$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",
-  // Temporary variable — used by the compiler for intermediate
-  // expression results in generated code (e.g. loop variables,
-  // conditional branches). Declared as: let $tmp
-  "$tmp",
-  // JS literals
-  "undefined",
-  "null",
-  "true",
-  "false",
-  "NaN",
-  "Infinity",
-  // JS built-in globals
-  "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",
-  "parseFloat",
-  "isNaN",
-  "isFinite",
-  "encodeURIComponent",
-  "decodeURIComponent",
-  "encodeURI",
-  "decodeURI",
-  // SWC helpers
-  "arguments",
-  "this",
-  "require",
-  // Lark framework
-  "Lark"
-]);
-
 // src/compiler/extract-global-vars.ts
 var import_parser = __toESM(require_lib(), 1);
-async function extractGlobalVars2(source) {
+async function extractGlobalVars(source) {
   const { protectedSource, comments: _comments } = protectComments(source);
   const viewEventProcessed = processViewEvents(protectedSource);
   const converted = convertArtSyntax(viewEventProcessed, false);
@@ -15511,10 +15185,10 @@ async function extractGlobalVars2(source) {
       allowAwaitOutsideFunction: true
     });
   } catch {
-    return fallbackExtractVariables2(source);
+    return fallbackExtractVariables(source);
   }
   const globalExists = {};
-  for (const name of BUILTIN_GLOBALS2) globalExists[name] = 1;
+  for (const name of BUILTIN_GLOBALS) globalExists[name] = 1;
   const globalVars = /* @__PURE__ */ Object.create(null);
   const fnRange = [];
   walkAst(ast, {
@@ -15573,22 +15247,22 @@ async function extractGlobalVars2(source) {
   });
   return Object.keys(globalVars);
 }
-function fallbackExtractVariables2(source) {
+function fallbackExtractVariables(source) {
   const vars = /* @__PURE__ */ new Set();
   const outputRegExp = /\{\{[:=!@]\s*([a-zA-Z_$][\w$]*)[^}]*\}\}/g;
   let m;
   while ((m = outputRegExp.exec(source)) !== null) {
     vars.add(m[1]);
   }
-  const eachRegExp = /\{\{forOf\s+([a-zA-Z_$][\w$]*)\s+as/g;
-  while ((m = eachRegExp.exec(source)) !== null) {
+  const forOfRegExp = /\{\{forOf\s+([a-zA-Z_$][\w$]*)\s+as/g;
+  while ((m = forOfRegExp.exec(source)) !== null) {
     vars.add(m[1]);
   }
   const ifRegExp = /\{\{(?:else\s+)?if\s+([a-zA-Z_$][\w$]*)[^}]*\}\}/g;
   while ((m = ifRegExp.exec(source)) !== null) {
     vars.add(m[1]);
   }
-  return Array.from(vars).filter((v) => !BUILTIN_GLOBALS2.has(v));
+  return Array.from(vars).filter((v) => !BUILTIN_GLOBALS.has(v));
 }
 function walkAst(ast, visitors) {
   function visit(node) {
@@ -15626,7 +15300,7 @@ function walkAst(ast, visitors) {
 function isAstNode(v) {
   return !!v && typeof v === "object" && typeof v.type === "string";
 }
-var BUILTIN_GLOBALS2 = /* @__PURE__ */ new Set([
+var BUILTIN_GLOBALS = /* @__PURE__ */ new Set([
   // ─── Template runtime helpers (injected by compileToFunction) ───────
   //
   // These variables appear in the generated template function signature
@@ -15865,8 +15539,8 @@ function compileToFunction(source, debug, file) {
   return `($data,$viewId,$refAlt,$encHtml,$strSafe,$encUri,$refFn,$encQuote)=>{${fullSource}}`;
 }
 async function compileTemplate(source, options = {}) {
-  const { debug = false, file, virtualDom = false, useSwc = false } = options;
-  const globalVars = options.globalVars ?? await (useSwc ? extractGlobalVars(source) : extractGlobalVars2(source));
+  const { debug = false, file, virtualDom = false } = options;
+  const globalVars = options.globalVars ?? await extractGlobalVars(source);
   const { protectedSource, comments } = protectComments(source);
   const converted = convertArtSyntax(protectedSource, debug);
   const viewEventProcessed = processViewEvents(converted);
@@ -15901,6 +15575,5 @@ export default function(data, viewId, refData) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   compileTemplate,
-  extractGlobalVars,
-  extractGlobalVarsSwc
+  extractGlobalVars
 });

package/dist/compiler.d.cts

@@ -8,8 +8,6 @@ interface CompileOptions {
     file?: string;
     /** Generate VDOM output instead of HTML string (default: false) */
     virtualDom?: boolean;
-    /** Use SWC instead of Babel for parsing (default: false) */
-    useSwc?: boolean;
 }
 
 /**
@@ -28,33 +26,6 @@ interface CompileOptions {
  */
 declare function compileTemplate(source: string, options?: CompileOptions): Promise<string>;
 
-/**
- * Extract global variable names from a template source using AST analysis.
- *
- * 1. Convert template commands (<% %> blocks) into a form parseable by an AST parser
- * 2. Walk the AST to find all Identifier nodes
- * 3. Track variable declarations (VariableDeclarator, FunctionDeclaration) as local vars
- * 4. Track function parameters as local vars
- * 5. Remaining identifiers that are not local and not in the exclusion list are "global" —
- *    they must be passed in as part of the data context ($$)
- *
- * This replaces the old regex-based `extractVariables()` with proper scope analysis,
- * eliminating false positives from local template variables and function parameters.
- *
- * @param source - The raw HTML template content (with {{ }} syntax)
- * @returns Array of global variable names found in the template
- */
-declare function extractGlobalVars$1(source: string): Promise<string[]>;
-
-/**
- * Extract global variable names from a template source using SWC AST analysis.
- *
- * 1. Convert template commands ({{ }} blocks) into a form parseable by SWC
- * 2. Walk the AST to find all Identifier nodes
- * 3. Track variable declarations (VariableDeclarator, FunctionDeclaration) as local vars
- * 4. Track function parameters as local vars
- * 5. Remaining identifiers that are not local and not in the exclusion list are "global"
- */
 /**
  * Extract global variable names from a template source using AST analysis.
  *
@@ -73,4 +44,4 @@ declare function extractGlobalVars$1(source: string): Promise<string[]>;
  */
 declare function extractGlobalVars(source: string): Promise<string[]>;
 
-export { compileTemplate, extractGlobalVars$1 as extractGlobalVars, extractGlobalVars as extractGlobalVarsSwc };
+export { compileTemplate, extractGlobalVars };

package/dist/compiler.d.ts

@@ -8,8 +8,6 @@ interface CompileOptions {
     file?: string;
     /** Generate VDOM output instead of HTML string (default: false) */
     virtualDom?: boolean;
-    /** Use SWC instead of Babel for parsing (default: false) */
-    useSwc?: boolean;
 }
 
 /**
@@ -28,33 +26,6 @@ interface CompileOptions {
  */
 declare function compileTemplate(source: string, options?: CompileOptions): Promise<string>;
 
-/**
- * Extract global variable names from a template source using AST analysis.
- *
- * 1. Convert template commands (<% %> blocks) into a form parseable by an AST parser
- * 2. Walk the AST to find all Identifier nodes
- * 3. Track variable declarations (VariableDeclarator, FunctionDeclaration) as local vars
- * 4. Track function parameters as local vars
- * 5. Remaining identifiers that are not local and not in the exclusion list are "global" —
- *    they must be passed in as part of the data context ($$)
- *
- * This replaces the old regex-based `extractVariables()` with proper scope analysis,
- * eliminating false positives from local template variables and function parameters.
- *
- * @param source - The raw HTML template content (with {{ }} syntax)
- * @returns Array of global variable names found in the template
- */
-declare function extractGlobalVars$1(source: string): Promise<string[]>;
-
-/**
- * Extract global variable names from a template source using SWC AST analysis.
- *
- * 1. Convert template commands ({{ }} blocks) into a form parseable by SWC
- * 2. Walk the AST to find all Identifier nodes
- * 3. Track variable declarations (VariableDeclarator, FunctionDeclaration) as local vars
- * 4. Track function parameters as local vars
- * 5. Remaining identifiers that are not local and not in the exclusion list are "global"
- */
 /**
  * Extract global variable names from a template source using AST analysis.
  *
@@ -73,4 +44,4 @@ declare function extractGlobalVars$1(source: string): Promise<string[]>;
  */
 declare function extractGlobalVars(source: string): Promise<string[]>;
 
-export { compileTemplate, extractGlobalVars$1 as extractGlobalVars, extractGlobalVars as extractGlobalVarsSwc };
+export { compileTemplate, extractGlobalVars };