mm_tpl 2.4.3 → 2.4.5

package/tpl_rule.js

@@ -2,9 +2,19 @@
 
 /**
  * 原生模板语法规则
+ * @type {Object}
  */
 var nativeRule = {
 	test: /[ \t\r\n]*<!--\[(#?)((?:==|=#|[=-])?)[ \t]*([\w\W]*?)[ \t]*(-?)\]-->/,
+	
+	/**
+	 * 处理原生模板语法
+	 * @param {string} match - 匹配的字符串
+	 * @param {string} comment - 注释标记
+	 * @param {string} output - 输出类型
+	 * @param {string} code - 代码内容
+	 * @returns {Object} 处理结果
+	 */
 	use: function use(match, comment, output, code /*, trimMode*/ ) {
 		output = {
 			'-': 'raw',
@@ -33,9 +43,19 @@ var nativeRule = {
 
 /**
  * 简洁模板语法规则
+ * @type {Object}
  */
 var artRule = {
 	test: /[ \t\r\n]*\$\{([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*\}/,
+	
+	/**
+	 * 处理简洁模板语法
+	 * @param {string} match - 匹配的字符串
+	 * @param {string} raw - 原始输出标记
+	 * @param {string} close - 闭合标记
+	 * @param {string} code - 代码内容
+	 * @returns {Object} 处理结果
+	 */
 	use: function use(match, raw, close, code) {
 		var compiler = this;
 		var options = compiler.options;
@@ -51,7 +71,7 @@ var artRule = {
 
 		// 旧版语法升级提示
 		var warn = function warn(oldSyntax, newSyntax) {
-			console.warn((options.filename || 'anonymous') + ':' + (match.line + 1) + ':' + (match.start + 1) + '\n' + (
+			$.log.warn((options.filename || 'anonymous') + ':' + (match.line + 1) + ':' + (match.start + 1) + '\n' + (
 				'Template upgrade: ${' + oldSyntax + '} -> ${' + newSyntax + '}'));
 		};
 
@@ -179,9 +199,11 @@ var artRule = {
 		return result;
 	},
 
-	// 将多个 javascript 表达式拆分成组
-	// 支持基本运算、三元表达式、取值、运行函数，不支持 `typeof value` 操作
-	// 只支持 string、number、boolean、null、undefined 这几种类型声明，不支持 function、object、array
+	/**
+	 * 将多个javascript表达式拆分成组
+	 * @param {Array} esTokens - ES令牌数组
+	 * @returns {Array} 分组后的表达式数组
+	 */
 	_split: function _split(esTokens) {
 		esTokens = esTokens.filter(function(_ref) {
 			var type = _ref.type;
@@ -220,28 +242,32 @@ var artRule = {
 };
 
 /**
- * html注释模板语法规则
+ * HTML注释模板语法规则
+ * @type {Object}
  */
 var htmlRule = Object.assign({}, artRule, {
 	test: /[ \t\r\n]*<!--\{([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*\}-->/
 });
 
 /**
- * js注释模板语法规则
+ * JS注释模板语法规则
+ * @type {Object}
  */
 var jsRule = Object.assign({}, artRule, {
 	test: /[ \t\r\n]*\/\*\[([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*\]\*\//
 });
 
 /**
- * python注释模板语法规则
+ * Python注释模板语法规则
+ * @type {Object}
  */
 var pyRule = Object.assign({}, artRule, {
 	test: /[ \t\r\n]*##([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*##/
 });
 
 /**
- * python注释模板语法规则
+ * Python三引号注释模板语法规则
+ * @type {Object}
  */
 var pyRule2 = Object.assign({}, artRule, {
 	test: /"""#([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*#"""/
@@ -255,3 +281,7 @@ module.exports = {
 	pyRule,
 	pyRule2
 };
+
+
+
+