Template parser

utils/template/codegen.dart

+// Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+class CGBlock {
+  int _blockType;             // Code type of this block
+  int _indent;                // Number of spaces to prefix for each statement
+  bool _inEach;               // This block or any currently active blocks is a
+                              // #each.  If so then any element marked with a
+                              // var attribute is repeated therefore the var
+                              // is a List type instead of an Element type.
+  List<CGStatement> _stmts;
+  int localIndex;             // Local variable index (e.g., e0, e1, etc.)
+
+  // Block Types:
+  static final int CONSTRUCTOR = 0;
+  static final int EACH = 1;
+  static final int WITH = 2;
+
+  CGBlock([this._indent = 4,
+           this._blockType = CGBlock.CONSTRUCTOR,
+           this._inEach = false]) :
+      _stmts = new List<CGStatement>(), localIndex = 0 {
+    assert(_blockType >= CGBlock.CONSTRUCTOR && _blockType <= CGBlock.WITH);
+  }
+
+  bool get isConstructor() => _blockType == CGBlock.CONSTRUCTOR;
+  bool get isEach() => _blockType == CGBlock.EACH;
+  bool get isWith() => _blockType == CGBlock.WITH;
+
+  CGStatement push(var elem, var parentName, [bool exact = false]) {
+    var varName;
+    if (elem is TemplateElement && elem.hasVar) {
+      varName = elem.varName;
+    } else {
+      varName = localIndex++;
+    }
+
+    CGStatement stmt = new CGStatement(elem, _indent, parentName, varName,
+        exact, _inEach);
+    _stmts.add(stmt);
+
+    return stmt;
+  }
+
+  void pop() {
+    _stmts.removeLast();
+  }
+
+  void add(String value) {
+    if (_stmts.last() != null) {
+      _stmts.last().add(value);
+    }
+  }
+
+  CGStatement get last() => _stmts.last();
+
+  /**
+   * Returns mixed list of elements marked with the var attribute.  If the 
+   * element is inside of a #each the name exposed is:
+   *
+   *      List varName;
+   *
+   * otherwise it's:
+   *
+   *      var varName;
+   *
+   * TODO(terry): For scalars var varName should be Element tag type e.g.,
+   *
+   *                   DivElement varName;
+   */
+  String get globalDeclarations() {
+    StringBuffer buff = new StringBuffer();
+    for (final CGStatement stmt in _stmts) {
+      buff.add(stmt.globalDeclaration());
+    }
+
+    return buff.toString();
+  }
+
+  /**
+   * List of statement constructors for each var inside a #each.
+   *
+   *    ${#each products}
+   *      <div var=myVar>...</div>
+   *    ${/each}
+   *
+   * returns:
+   *
+   *    myVar = [];
+   */
+  String get globalInitializers() {
+    StringBuffer buff = new StringBuffer();
+    for (final CGStatement stmt in _stmts) {
+      buff.add(stmt.globalInitializers());
+    }
+
+    return buff.toString();
+  }
+
+  String get codeBody() {
+    StringBuffer buff = new StringBuffer();
+
+    for (final CGStatement stmt in _stmts) {
+      buff.add(stmt.emitDartStatement());
+    }
+
+    return buff.toString();
+  }
+}
+
+class CGStatement {
+  bool _exact;                  // If True not HTML construct instead exact stmt
+  bool _repeating;              // Stmt in a #each this block or nested block.
+  StringBuffer _buff;
+  TemplateElement _elem;
+  int _indent;
+  var parentName;
+  String varName;
+  bool _globalVariable;
+  bool _closed;
+
+  CGStatement(this._elem, this._indent, this.parentName, var varNameOrIndex,
+      [this._exact = false, this._repeating = false]) :
+        _buff = new StringBuffer(), _closed = false {
+
+    if (varNameOrIndex is String) {
+      // We have the global variable name
+      varName = varNameOrIndex;
+      _globalVariable = true;
+    } else {
+      // local index generate local variable name.
+      varName = "e${varNameOrIndex}";
+      _globalVariable = false;
+    }
+  }
+
+  bool get hasGlobalVariable() => _globalVariable;
+  String get variableName() => varName;
+
+  String globalDeclaration() {
+    if (hasGlobalVariable) {
+      String spaces = Codegen.spaces(_indent);
+      return (_repeating) ?
+        "  List ${varName};    // Repeated elements.\r" : "  var ${varName};\r";
+    }
+
+    return "";
+  }
+
+  String globalInitializers() {
+    if (hasGlobalVariable && _repeating) {
+      return "    ${varName} = [];\r";
+    }
+
+    return "";
+  }
+
+  void add(String value) {
+    _buff.add(value);
+  }
+
+  bool get isClosed() => _closed;
+
+  void close() {
+    if (_elem is TemplateElement) {
+      add("</${_elem.tagName}>");
+    }
+    _closed = true;
+  }
+
+  String emitDartStatement() {
+    StringBuffer statement = new StringBuffer();
+
+    String spaces = Codegen.spaces(_indent);
+
+    if (_exact) {
+      statement.add("${spaces}${_buff.toString()};\r");
+    } else {
+      String localVar = "";
+      String tmpRepeat;
+      if (hasGlobalVariable) {
+        if (_repeating) {
+          tmpRepeat = "tmp_${varName}";
+          localVar = "var ";
+        }
+      } else {
+        localVar = "var ";
+      }
+
+      /* Emiting the following code fragment where varName is the attribute
+         value for var=
+
+            varName = new Element.html('HTML GOES HERE');
+            parent.elements.add(varName);
+
+         for repeating elements in a #each:
+
+            var tmp_nnn = new Element.html('HTML GOES HERE');
+            varName.add(tmp_nnn);
+            parent.elements.add(tmp_nnn);
+
+         for elements w/o var attribute set:
+
+            var eNNN = new Element.html('HTML GOES HERE');
+            parent.elements.add(eNNN);
+       */
+      if (tmpRepeat == null) {
+        statement.add("${spaces}${localVar}${varName} = new Element.html('");
+      } else {
+        statement.add("${spaces}${localVar}${tmpRepeat} = new Element.html('");
+      }
+      statement.add(_buff.toString());
+
+      if (tmpRepeat == null) {
+        statement.add(
+          "');\r${spaces}${parentName}.elements.add(${varName});\r");
+      } else {
+        statement.add(
+          "');\r${spaces}${parentName}.elements.add(${tmpRepeat});\r");
+        statement.add("${spaces}${varName}.add(${tmpRepeat});\r");
+      }
+    }
+
+    return statement.toString();
+  }
+}
+
+class Codegen {
+  static final String SPACES = "                                              ";
+  static String spaces(int numSpaces) {
+    return SPACES.substring(0, numSpaces);
+  }
+
+  // TODO(terry): Before generating Dart class need a validate phase that
+  //              checks mangles all class names to be prefix with the
+  //              template name to avoid any class name collisions.  Also,
+  //              investigate possible runtime check mode to insure that only
+  //              valid CSS class names are used (in case someone uses strings
+  //              and not the generated getters to the CSS class selector.  This
+  //              mode would be slower would require that every class name set
+  //              (maybe jQuery too) is for a particular view (requires walking
+  //              the HTML tree looking for a parent template prefix that
+  //              matches the CSS prefix. (more thinking needed).
+  static String generate(List<Template> templates, String filename) {
+    List<String> fileParts = filename.split('.');
+    assert(fileParts.length == 2);
+    filename = fileParts[0];
+
+    StringBuffer buff = new StringBuffer();
+    int injectId = 0;         // Inject function id
+
+    buff.add("// Generated Dart class from HTML template.\r");
+    buff.add("// DO NOT EDIT.\r\r");
+
+    buff.add("String safeHTML(String html) {\r");
+    buff.add("  // TODO(terry): Escaping for XSS vulnerabilities TBD.\r");
+    buff.add("  return html;\r");
+    buff.add("}\r\r");
+
+    String addStylesheetFuncName = "add_${filename}_templatesStyles";
+    
+    for (final template in templates) {
+      // Emit the template class.
+      TemplateSignature sig = template.signature;
+      buff.add(_emitClass(sig.name, sig.params, template.content,
+        addStylesheetFuncName));
+    }
+
+    // TODO(terry): Stylesheet aggregator should not be global needs to be
+    //              bound to this template file not global to the app.
+
+    // Emit the stylesheet aggregator.
+    buff.add("\r\r// Inject all templates stylesheet once into the head.\r");
+    buff.add("bool ${filename}_stylesheet_added = false;\r");
+    buff.add("void ${addStylesheetFuncName}() {\r");
+    buff.add("  if (!${filename}_stylesheet_added) {\r");
+    buff.add("    StringBuffer styles = new StringBuffer();\r\r");
+
+    buff.add("    // All templates stylesheet.\r");
+
+    for (final template in templates) {
+      TemplateSignature sig = template.signature;
+      buff.add("    styles.add(${sig.name}.stylesheet);\r");
+    }
+
+    buff.add("\r    ${filename}_stylesheet_added = true;\r");
+
+    buff.add("    document.head.elements.add(new Element.html('<style>"
+             "\${styles.toString()}</style>'));\r");
+    buff.add("  }\r");
+    buff.add("}\r");
+
+    return buff.toString();
+  }
+
+  static String _emitCSSSelectors(css.Stylesheet stylesheet) {
+    if (stylesheet == null) {
+      return "";
+    }
+
+    List<String> classes = [];
+
+    for (final production in stylesheet.topLevels) {
+      if (production is css.IncludeDirective) {
+        for (final topLevel in production.styleSheet.topLevels) {
+          if (topLevel is css.RuleSet) {
+            classes = css.Generate.computeClassSelectors(topLevel, classes);
+          }
+        }
+      } else if (production is css.RuleSet) {
+        classes = css.Generate.computeClassSelectors(production, classes);
+      }
+    }
+
+    List<String> dartNames = [];
+
+    for (final String knownClass in classes) {
+      StringBuffer dartName = new StringBuffer();
+      List<String> splits = knownClass.split('-');
+      if (splits.length > 0) {
+        dartName.add(splits[0]);
+        for (int idx = 1; idx < splits.length; idx++) {
+          String part = splits[idx];
+          // Character between 'a'..'z' mapped to 'A'..'Z'
+          dartName.add("${part[0].toUpperCase()}${part.substring(1)}");
+        }
+        dartNames.add(dartName.toString());
+      }
+    }
+
+    StringBuffer buff = new StringBuffer();
+    if (classes.length > 0) {
+      assert(classes.length == dartNames.length);
+      buff.add("\r  // CSS class selectors for this template.\r");
+      for (int i = 0; i < classes.length; i++) {
+        buff.add(
+          "  static String get ${dartNames[i]}() => \"${classes[i]}\";\r");
+      }
+    }
+
+    return buff.toString();
+  }
+
+  static String _emitClass(String className,
+                           List<Map<Identifier, Identifier>> params,
+                           TemplateContent content,
+                           String addStylesheetFuncName) {
+    StringBuffer buff = new StringBuffer();
+
+    // Emit the template class.
+    buff.add("class ${className} {\r");
+
+    buff.add("  Element _fragment;\r\r");
+
+    bool anyParams = false;
+    for (final param in params) {
+      buff.add("  ${param['type']} ${param['name']};\r");
+      anyParams = true;
+    }
+    if (anyParams) buff.add("\r");
+
+    ElemCG ecg = new ElemCG();
+
+    ecg.pushBlock();
+
+    // TODO(terry): Only supports singlely rooted need to fix.
+    ecg.emitConstructHtml(content.html.children[0], "", "_fragment");
+
+    // Create all element names marked with var.
+    String decls = ecg.globalDeclarations;
+    if (decls.length > 0) {
+      buff.add("\r  // Elements bound to a variable:\r");
+      buff.add("${decls}\r");
+    }
+
+    // Create the constructor.
+    buff.add("  ${className}(");
+    bool firstParam = true;
+    for (final param in params) {
+      if (!firstParam) {
+        buff.add(", ");
+      }
+      buff.add("this.${param['name']}");
+      firstParam = false;
+    }
+    buff.add(") {\r");
+
+    String initializers = ecg.globalInitializers;
+    if (initializers.length > 0) {
+      buff.add("    //Global initializers.\r");
+      buff.add("${initializers}\r");
+    }
+
+    buff.add("    // Insure stylesheet for template exist in the document.\r");
+    buff.add("    ${addStylesheetFuncName}();\r\r");
+
+    buff.add("    _fragment = new Element.tag('div');\r");
+
+    buff.add(ecg.codeBody);     // HTML for constructor to build.
+
+    buff.add("  }\r\r");        // End constructor
+
+    buff.add("  Element get root() => _fragment.nodes.first;\r");
+
+    // Emit all CSS class selectors:
+    buff.add(_emitCSSSelectors(content.css));
+
+    // Emit the injection functions.
+    buff.add("\r  // Injection functions:");
+    for (final expr in ecg.expressions) {
+      buff.add("${expr}");
+    }
+
+    buff.add("\r  // Each functions:\r");
+    for (var eachFunc in ecg.eachs) {
+      buff.add("${eachFunc}\r");
+    }
+
+    buff.add("\r  // With functions:\r");
+    for (var withFunc in ecg.withs) {
+      buff.add("${withFunc}\r");
+    }
+
+    buff.add("\r  // CSS for this template.\r");
+    buff.add("  static final String stylesheet = ");
+
+    if (content.css != null) {
+      buff.add("\'\'\'\r    ${content.css.toString()}\r");
+      buff.add("  \'\'\';\r\r");
+
+      // TODO(terry): Emit all known selectors for this template.
+      buff.add("  // Stylesheet class selectors:\r");
+    } else {
+      buff.add("\"\";\r");
+    }
+
+    buff.add("}\r");              // End class
+
+    return buff.toString();
+  }
+}
+
+class ElemCG {
+  // List of identifiers and quoted strings (single and double quoted).
+  var identRe = const RegExp(
+    "\s*('\"\\'\\\"[^'\"\\'\\\"]+'\"\\'\\\"|[_A-Za-z][_A-Za-z0-9]*)");
+
+  List<CGBlock> _cgBlocks;
+  StringBuffer _globalDecls;        // Global var declarations for all blocks.
+  StringBuffer _globalInits;        // Global List var initializtion for all
+                                    // blocks in a #each.
+  String funcCall;                  // Func call after element creation?
+  List<String> expressions;         // List of injection function declarations.
+  List<String> eachs;               // List of each function declarations.
+  List<String> withs;               // List of with function declarations.
+
+  ElemCG() :
+    expressions = [],
+    eachs = [],
+    withs = [],
+    _cgBlocks = [],
+    _globalDecls = new StringBuffer(),
+    _globalInits = new StringBuffer();    
+
+  bool get isLastBlockConstructor() {
+    CGBlock block = _cgBlocks.last();
+    return block.isConstructor;
+  }
+
+  // Any current active #each blocks.
+  bool anyEachBlocks(int blockToCreateType) {
+    bool result = blockToCreateType == CGBlock.EACH;
+
+    for (final CGBlock block in _cgBlocks) {
+      if (block.isEach) {
+        result = result || true;
+      }
+    }
+
+    return result;
+  }
+
+  void pushBlock([int indent = 4, int blockType = CGBlock.CONSTRUCTOR]) {
+    closeStatement();
+    _cgBlocks.add(new CGBlock(indent, blockType, anyEachBlocks(blockType)));
+  }
+
+  void popBlock() {
+    _globalDecls.add(lastBlock.globalDeclarations);
+    _globalInits.add(lastBlock.globalInitializers);
+    _cgBlocks.removeLast();
+  }
+
+  CGStatement pushStatement(var elem, var parentName) {
+    return lastBlock.push(elem, parentName, false);
+  }
+
+  CGStatement pushExactStatement(var elem, var parentName) {
+    return lastBlock.push(elem, parentName, true);
+  }
+
+  bool get isClosedStatement() => lastBlock.last.isClosed;
+
+  void closeStatement() {
+    if (lastBlock != null && lastBlock.last != null &&
+        !lastBlock.last.isClosed) {
+      lastBlock.last.close();
+    }
+  }
+
+  String get lastVariableName() {
+    if (lastBlock != null && lastBlock.last != null) {
+      return lastBlock.last.variableName;
+    }
+  }
+
+  CGBlock get lastBlock() => _cgBlocks.length > 0 ? _cgBlocks.last() : null;
+
+  void add(String str) {
+    _cgBlocks.last().add(str);
+  }
+
+  String get globalDeclarations() {
+    assert(_cgBlocks.length == 1);    // Only constructor body should be left.
+    _globalDecls.add(lastBlock.globalDeclarations);
+    return _globalDecls.toString();
+  }
+
+  String get globalInitializers() {
+    assert(_cgBlocks.length == 1);    // Only constructor body should be left.
+    _globalInits.add(lastBlock.globalInitializers);
+    return _globalInits.toString();
+  }
+
+  String get codeBody() {
+    closeStatement();
+    return _cgBlocks.last().codeBody;
+  }
+  
+  /* scopeName for expression
+   * parentVarOrIndex if # it's a local variable if string it's an exposed
+   * name (specified by the var attribute) for this element.
+   *
+   */
+  emitElement(var elem,
+              [String scopeName = "",
+               var parentVarOrIdx = 0,
+               bool immediateNestedEach = false]) {
+    if (elem is TemplateElement) {
+      if (!elem.isFragment) {
+        add("<${elem.tagName}${elem.attributesToString()}>");
+      }
+      String prevParent = lastVariableName;
+      for (var childElem in elem.children) {
+        if (childElem is TemplateElement) {
+          if (childElem.hasVar) {
+            closeStatement();
+            emitConstructHtml(childElem, scopeName, prevParent,
+              childElem.varName);
+            closeStatement();
+          } else {
+            closeStatement();
+            emitConstructHtml(childElem, scopeName, prevParent);
+            closeStatement();
+          }
+        } else {
+          emitElement(childElem, scopeName, parentVarOrIdx);
+        }
+      }
+    } else if (elem is TemplateText) {
+      add("${elem.value}");
+    } else if (elem is TemplateExpression) {
+      emitExpressions(elem, scopeName);
+    } else if (elem is TemplateEachCommand) {
+      // Signal to caller new block coming in, returns "each_" prefix
+      emitEach(elem, "List", elem.listName.name, "parent", immediateNestedEach);
+    } else if (elem is TemplateWithCommand) {
+      // Signal to caller new block coming in, returns "each_" prefix
+      emitWith(elem, "var", elem.objectName.name, "parent");
+    }
+  }
+
+  // TODO(terry): Hack prefixing all names with "${scopeName}." but don't touch
+  //              quoted strings.
+  String _resolveNames(String expr, String prefixPart) {
+    StringBuffer newExpr = new StringBuffer();
+    Iterable<Match> matches = identRe.allMatches(expr);
+
+    int lastIdx = 0;
+    for (Match m in matches) {
+      if (m.start() > lastIdx) {
+        newExpr.add(expr.substring(lastIdx, m.start()));
+      }
+
+      bool identifier = true;
+      if (m.start() > 0)  {
+        int charCode = expr.charCodeAt(m.start() - 1);
+        // Starts with ' or " then it's not an identifier.
+        identifier = charCode != 34 /* " */ && charCode != 39 /* ' */;
+      }
+
+      String strMatch = expr.substring(m.start(), m.end());
+      if (identifier) {
+        newExpr.add("${prefixPart}.${strMatch}");
+      } else {
+        // Quoted string don't touch.
+        newExpr.add("${strMatch}");
+      }
+      lastIdx = m.end();
+    }
+
+    if (expr.length > lastIdx) {
+      newExpr.add(expr.substring(lastIdx));
+    }
+
+    return newExpr.toString();
+  }
+
+  /**
+   * Construct the HTML each top-level node get's it's own variable.
+   *
+   * TODO(terry): Might want to optimize if the other top-level nodes have no
+   *              control structures (with, each, if, etc.). We could
+   *              synthesize a root node and create all the top-level nodes
+   *              under the root node with one innerHTML.
+   */
+  void emitConstructHtml(var elem,
+                         [String scopeName = "",
+                          String parentName = "parent",
+                          var varIndex = 0,
+                          bool immediateNestedEach = false]) {
+    if (elem is TemplateElement) {
+      // Never look at the root node (fragment) get it's children.
+      if (elem.isFragment) {
+        elem = elem.children[0];
+      }
+
+      CGStatement stmt = pushStatement(elem, parentName);
+      emitElement(elem, scopeName, stmt.hasGlobalVariable ?
+          stmt.variableName : varIndex);
+    } else {
+      emitElement(elem, scopeName, varIndex, immediateNestedEach);
+    }
+  }
+
+  /* Any references to products.sales needs to be remaped to item.sales
+   * for now it's a hack look for first dot and replace with item.
+   */
+  String eachIterNameToItem(String iterName) {
+    String newName = iterName;
+    var dotForIter = iterName.indexOf('.');
+    if (dotForIter >= 0) {
+      newName = "item${iterName.substring(dotForIter)}";
+    }
+
+    return newName;
+  }
+
+  emitExpressions(TemplateExpression elem, String scopeName) {
+    StringBuffer func = new StringBuffer();
+
+    String newExpr = elem.expression;
+    if (scopeName.length > 0) {
+      // In a block #command need the scope passed in.
+      add("\$\{inject_${expressions.length}(item)\}");
+      func.add("\r  String inject_${expressions.length}(var item) {\r");
+      // Escape all single-quotes, this expression is embedded as a string 
+      // parameter for the call to safeHTML.
+      newExpr = _resolveNames(newExpr.replaceAll("'", "\\'"), "item");
+    } else {
+      // Not in a block #command item isn't passed in.
+      add("\$\{inject_${expressions.length}()\}");
+      func.add("\r  String inject_${expressions.length}() {\r");
+    }
+
+    func.add("    return safeHTML('\$\{${newExpr}\}');\r");
+    func.add("  }\r");
+
+    expressions.add(func.toString());
+  }
+  emitEach(TemplateEachCommand elem, String iterType, String iterName,
+      var parentVarOrIdx, bool nestedImmediateEach) {
+    TemplateDocument docFrag = elem.documentFragment;
+
+    int eachIndex = eachs.length;
+    eachs.add("");
+
+    StringBuffer funcBuff = new StringBuffer();
+    // Prepare function call "each_N(iterName," parent param computed later.
+    String funcName = "each_${eachIndex}";
+
+    funcBuff.add("  ${funcName}(${iterType} items, Element parent) {\r");
+    funcBuff.add("    for (var item in items) {\r");
+
+    pushBlock(6, CGBlock.EACH);
+
+    TemplateElement docFragChild = docFrag.children[0];
+    var children = docFragChild.isFragment ?
+        docFragChild.children : docFrag.children;
+    for (var child in children) {
+      // If any immediate children of the parent #each is an #each then
+      // so we need to pass the outer #each parent not the last statement's
+      // variableName when calling the nested #each.
+      bool eachChild = (child is TemplateEachCommand);
+      emitConstructHtml(child, iterName, parentVarOrIdx, 0, eachChild);
+    }
+
+    funcBuff.add(codeBody);
+
+    popBlock();
+
+    funcBuff.add("    }\r");
+    funcBuff.add("  }\r");
+
+    eachs[eachIndex] = funcBuff.toString();
+
+    // If nested each then we want to pass the parent otherwise we'll use the
+    // varName.
+    var varName = nestedImmediateEach ? "parent" : lastBlock.last.variableName;
+
+    pushExactStatement(elem, parentVarOrIdx);
+
+    // Setup call to each func as "each_n(xxxxx, " the parent param is filled
+    // in later when we known the parent variable.
+    add("${funcName}(${eachIterNameToItem(iterName)}, ${varName})");
+  }
+
+  emitWith(TemplateWithCommand elem, String withType, String withName,
+      var parentVarIndex) {
+    TemplateDocument docFrag = elem.documentFragment;
+
+    int withIndex = withs.length;
+    withs.add("");
+
+    StringBuffer funcBuff = new StringBuffer();
+    // Prepare function call "each_N(iterName," parent param computed later.
+    String funcName = "with_${withIndex}";
+
+    funcBuff.add("  ${funcName}(${withType} item, Element parent) {\r");
+
+    pushBlock(CGBlock.WITH);
+
+    TemplateElement docFragChild = docFrag.children[0];
+    var children = docFragChild.isFragment ?
+        docFragChild.children : docFrag.children;
+    for (var child in children) {
+      emitConstructHtml(child, withName, "parent");
+    }
+
+    funcBuff.add(codeBody);
+
+    popBlock();
+
+    funcBuff.add("  }\r");
+
+    withs[withIndex] = funcBuff.toString();
+
+    var varName = lastBlock.last.variableName;
+
+    pushExactStatement(elem, parentVarIndex);
+
+    // Setup call to each func as "each_n(xxxxx, " the parent param is filled
+    // in later when we known the parent variable.
+    add("${funcName}(${withName}, ${varName})");
+  }
+}