mm_tpl 2.7.2 → 2.7.4

package/lib/{engine.js → tpl.js}

@@ -1,7 +1,10 @@
 const engine = require('art-template');
 const {
   Base
-} = require('mm_expand');
+} = require('./base.js');
+const {
+  FileUtil
+} = require('./file.js');
 const Hook = require('./hook.js');
 const {
   nativeRule,
@@ -26,9 +29,7 @@ const {
 const {
   Lang
 } = require('./lang.js');
-const {
-  Memory
-} = require('./memory.js');
+const Memory = require('./memory.js');
 
 /**
  * 模板引擎类
@@ -36,15 +37,16 @@ const {
  * 渲染结果不做页面级缓存，页面缓存交由 web 中间件按完整请求上下文负责
  * @class
  */
-class Engine extends Base {
+class Tpl extends Base {
   /**
    * 配置参数
    */
   static config = {
     /**
      * 应用根目录，目录结构见 doc/目录结构.md
+     * 默认为运行根目录，宿主应用建议显式传入自身根目录
      */
-    root: $.run_path + '',
+    root: FileUtil.getRunPath(),
     /**
      * 主题目录，相对应用根目录
      */
@@ -116,7 +118,7 @@ class Engine extends Base {
     rules: [nativeRule, artRule, htmlRule, jsRule, pyRule, pyRule2],
     /**
      * 复数规则，键为语言代码，语言代码统一用小写下划线（如 zh_cn、en_us）
-     * mm_expand 的 Lang 已内置 zh_cn、en 规则，其他语言代码需在此登记才能按语言取复数形式
+     * 内置 BaseLang 已含 zh_cn、en 规则，其他语言代码需在此登记才能按语言取复数形式
      */
     plural_rules: {
       'en_us': function (count) {
@@ -127,12 +129,33 @@ class Engine extends Base {
      * 变换字符串
      */
     change_str: ['\\#', '\\<', '\\${', '\\*', '\\"""'],
+    /**
+     * 日志对象，需含 warn / error 等方法，留空则用 console
+     * 实例的 this.log 与实例级钩子的错误输出都走该对象
+     */
+    logger: null,
   };
   /**
    * 语言包文件缓存
    * 按语言包目录组缓存，形如 {目录组: {fingerprint, dict}}，文件未变化时复用解析结果
    */
   static lang_cache = {};
+  /**
+   * 全局钩子实例
+   * 所有引擎实例共享，与实例级 this.hook 一起参与执行，全局先执行、实例级后执行
+   * 宿主应用注册跨实例钩子时使用，如 Tpl.global_hook.addFunc(...)
+   */
+  static global_hook = new Hook();
+  /**
+   * 全局数据袋
+   * 渲染时注入模型的 globalBag 字段，供模板跨实例共享数据
+   */
+  static global_bag = {};
+  /**
+   * 全局语言包字典
+   * 实例未配置任何语言包时的回退字典，形如 { 语言代码: 词条对象 }
+   */
+  static global_dict = {};
   /**
    * 创建引擎实例
    * @param {Object} config - 配置选项
@@ -216,9 +239,9 @@ class Engine extends Base {
     this.funcs = {};
 
     /**
-     * 实例级钩子，仅作用于当前实例；与全局 $.hook 一起参与执行，全局先执行、实例级后执行
+     * 实例级钩子，仅作用于当前实例；与全局钩子 Tpl.global_hook 一起参与执行，全局先执行、实例级后执行
      */
-    this.hook = new Hook();
+    this.hook = new Hook(this.config.logger);
 
     /**
      * 初始化
@@ -230,7 +253,7 @@ class Engine extends Base {
 /**
  * 初始化模板
  */
-Engine.prototype._initTpl = function () {
+Tpl.prototype._initTpl = function () {
   var cg = this.config;
   // 引擎默认值为全局配置，仅主实例写入，避免多实例互相覆盖
   if (!cg.is_fork) {
@@ -245,7 +268,7 @@ Engine.prototype._initTpl = function () {
  * 支持 config.js 的 { defaults: { theme, style, lang } } 写法
  * @param {Object} config - 配置参数
  */
-Engine.prototype._setConfig = function (config) {
+Tpl.prototype._setConfig = function (config) {
   if (!config) {
     return;
   }
@@ -259,7 +282,7 @@ Engine.prototype._setConfig = function (config) {
  * @param {Object} config - 配置参数
  * @returns {Object} 规范化后的配置
  */
-Engine.prototype._normalizeConfig = function (config) {
+Tpl.prototype._normalizeConfig = function (config) {
   if (!config || typeof (config.defaults) !== 'object' || !config.defaults) {
     return config;
   }
@@ -283,9 +306,9 @@ Engine.prototype._normalizeConfig = function (config) {
  * @param {string} theme - 主题名称
  * @returns {string} 主题根目录全路径
  */
-Engine.prototype.getThemeDir = function (theme) {
+Tpl.prototype.getThemeDir = function (theme) {
   var cg = this.config;
-  return theme.fullname(cg.theme_dir.fullname(this.dir));
+  return FileUtil.fullname(theme, FileUtil.fullname(cg.theme_dir, this.dir));
 };
 
 /**
@@ -294,12 +317,12 @@ Engine.prototype.getThemeDir = function (theme) {
  * @param {string} style - 风格名称，为空时取主题下的风格目录本身
  * @returns {string} 风格目录全路径
  */
-Engine.prototype.getStyleDir = function (theme, style) {
-  var dir = this.config.style_dir.fullname(this.getThemeDir(theme));
+Tpl.prototype.getStyleDir = function (theme, style) {
+  var dir = FileUtil.fullname(this.config.style_dir, this.getThemeDir(theme));
   if (!style) {
     return dir;
   }
-  return style.fullname(dir);
+  return FileUtil.fullname(style, dir);
 };
 
 /**
@@ -310,12 +333,12 @@ Engine.prototype.getStyleDir = function (theme, style) {
  * @param {string} theme - 主题名称，不传时取当前主题
  * @returns {Array<string>} 模板目录列表
  */
-Engine.prototype.getTemplateDirs = function (theme) {
+Tpl.prototype.getTemplateDirs = function (theme) {
   var cg = this.config;
   var cur_theme = theme || this.current_theme;
   var dirs = [];
   if (cg.diy_dir) {
-    dirs.push(cg.diy_dir.fullname(this.dir));
+    dirs.push(FileUtil.fullname(cg.diy_dir, this.dir));
   }
   if (cur_theme) {
     dirs.push(this.getThemeDir(cur_theme));
@@ -333,7 +356,7 @@ Engine.prototype.getTemplateDirs = function (theme) {
  * @param {string} theme - 主题名称，不传时取当前主题
  * @returns {Array<string>} 组件目录列表
  */
-Engine.prototype.getComponentDirs = function (theme) {
+Tpl.prototype.getComponentDirs = function (theme) {
   var cg = this.config;
   if (!cg.component_dir) {
     return [];
@@ -341,13 +364,13 @@ Engine.prototype.getComponentDirs = function (theme) {
   var cur_theme = theme || this.current_theme;
   var dirs = [];
   if (cg.diy_dir) {
-    dirs.push(cg.component_dir.fullname(cg.diy_dir.fullname(this.dir)));
+    dirs.push(FileUtil.fullname(cg.component_dir, FileUtil.fullname(cg.diy_dir, this.dir)));
   }
   if (cur_theme) {
-    dirs.push(cg.component_dir.fullname(this.getThemeDir(cur_theme)));
+    dirs.push(FileUtil.fullname(cg.component_dir, this.getThemeDir(cur_theme)));
   }
   if (cg.default_theme && cg.default_theme !== cur_theme) {
-    dirs.push(cg.component_dir.fullname(this.getThemeDir(cg.default_theme)));
+    dirs.push(FileUtil.fullname(cg.component_dir, this.getThemeDir(cg.default_theme)));
   }
   return dirs;
 };
@@ -361,7 +384,7 @@ Engine.prototype.getComponentDirs = function (theme) {
  * @param {string} style - 风格名称，不传时取当前风格；显式传空字符串表示用主题下的风格目录本身
  * @returns {Array<string>} 样式目录列表
  */
-Engine.prototype.getStyleDirs = function (theme, style) {
+Tpl.prototype.getStyleDirs = function (theme, style) {
   var cg = this.config;
   var cur_theme = theme || this.current_theme;
   // 风格取自入参或当前值，为空时以默认风格兜底，不做跨风格回退
@@ -377,7 +400,7 @@ Engine.prototype.getStyleDirs = function (theme, style) {
   var base = cg.base_style || '';
   var dirs = [];
   if (cg.diy_dir) {
-    dirs.push(cg.diy_dir.fullname(this.dir));
+    dirs.push(FileUtil.fullname(cg.diy_dir, this.dir));
   }
   for (var i = 0; i < themes.length; i++) {
     dirs.push(this.getStyleDir(themes[i], cur_style));
@@ -395,21 +418,21 @@ Engine.prototype.getStyleDirs = function (theme, style) {
  * @param {string} theme - 主题名称，不传时取当前主题
  * @returns {Array<string>} 脚本目录列表
  */
-Engine.prototype.getJsDirs = function (theme) {
+Tpl.prototype.getJsDirs = function (theme) {
   var cg = this.config;
   var cur_theme = theme || this.current_theme;
   var dirs = [];
   if (cg.diy_dir) {
-    dirs.push(cg.diy_dir.fullname(this.dir));
+    dirs.push(FileUtil.fullname(cg.diy_dir, this.dir));
   }
   if (cur_theme && cg.theme_js_dir) {
-    dirs.push(cg.theme_js_dir.fullname(this.getThemeDir(cur_theme)));
+    dirs.push(FileUtil.fullname(cg.theme_js_dir, this.getThemeDir(cur_theme)));
   }
   if (cg.default_theme && cg.default_theme !== cur_theme && cg.theme_js_dir) {
-    dirs.push(cg.theme_js_dir.fullname(this.getThemeDir(cg.default_theme)));
+    dirs.push(FileUtil.fullname(cg.theme_js_dir, this.getThemeDir(cg.default_theme)));
   }
   if (cg.js_dir) {
-    dirs.push(cg.js_dir.fullname(this.dir));
+    dirs.push(FileUtil.fullname(cg.js_dir, this.dir));
   }
   return dirs;
 };
@@ -418,7 +441,7 @@ Engine.prototype.getJsDirs = function (theme) {
  * 预设值
  * @param {boolean} force - 是否跳过语言包缓存强制重新加载
  */
-Engine.prototype._preset = function (force) {
+Tpl.prototype._preset = function (force) {
   // 基类构造期间会触发一次预设，此时加载器尚未就绪
   if (!this.lang_loader) {
     return;
@@ -430,7 +453,7 @@ Engine.prototype._preset = function (force) {
  * 获取当前语言
  * @returns {string} 语言代码
  */
-Engine.prototype.getLang = function () {
+Tpl.prototype.getLang = function () {
   if (this.lang) {
     return this.lang.now;
   }
@@ -442,7 +465,7 @@ Engine.prototype.getLang = function () {
  * @param {string} lang - 语言代码
  * @returns {string} 设置后的语言代码
  */
-Engine.prototype.setLang = function (lang) {
+Tpl.prototype.setLang = function (lang) {
   if (typeof (lang) !== 'string' || !lang) {
     this.log('warn', '语言参数无效，保持当前语言：' + this.getLang());
     return this.getLang();
@@ -458,7 +481,7 @@ Engine.prototype.setLang = function (lang) {
  * @param {...any} args - 替换参数，对象按命名占位符，其余按位置占位符
  * @returns {string} 翻译后的文本
  */
-Engine.prototype.t = function (key, ...args) {
+Tpl.prototype.t = function (key, ...args) {
   return this._translate(key, args);
 };
 
@@ -468,7 +491,7 @@ Engine.prototype.t = function (key, ...args) {
  * @param {Array<any>} args - 替换参数
  * @returns {string} 翻译后的文本
  */
-Engine.prototype._translate = function (key, args) {
+Tpl.prototype._translate = function (key, args) {
   var val = this.lang.get(key);
   if (typeof (val) !== 'string' || !args.length) {
     return val;
@@ -488,7 +511,7 @@ Engine.prototype._translate = function (key, args) {
  * @param {Object} data - 键值对
  * @returns {string} 填充后的文本
  */
-Engine.prototype._fillNamed = function (text, data) {
+Tpl.prototype._fillNamed = function (text, data) {
   for (var key in data) {
     var val = data[key];
     if (val === undefined || val === null) {
@@ -508,7 +531,7 @@ Engine.prototype._fillNamed = function (text, data) {
  * @param {...any} args - 额外替换参数，依次替换 {1}、{2} 等占位符
  * @returns {string} 翻译后的文本
  */
-Engine.prototype.tc = function (key, count, ...args) {
+Tpl.prototype.tc = function (key, count, ...args) {
   return this.lang.tc(key, count, ...args);
 };
 
@@ -517,7 +540,7 @@ Engine.prototype.tc = function (key, count, ...args) {
  * 过滤掉无词条的语言，Lang 内置的 zh_cn、en 空字典不计入
  * @returns {Array<string>} 语言代码数组
  */
-Engine.prototype.getLangs = function () {
+Tpl.prototype.getLangs = function () {
   if (!this.lang) {
     return [];
   }
@@ -539,7 +562,7 @@ Engine.prototype.getLangs = function () {
  * @param {boolean} force - 是否跳过缓存强制重新读取语言包文件
  * @returns {Array<string>} 重新加载后的语言列表
  */
-Engine.prototype.reloadLangs = function (force) {
+Tpl.prototype.reloadLangs = function (force) {
   var lang = this.getLang();
   this._preset(force);
   this.setLang(lang);
@@ -551,7 +574,7 @@ Engine.prototype.reloadLangs = function (force) {
  * @param {string} lang - 语言代码
  * @returns {Object|null} 语言包对象，不存在时返回null
  */
-Engine.prototype.loadLang = function (lang) {
+Tpl.prototype.loadLang = function (lang) {
   if (typeof (lang) !== 'string' || !lang) {
     this.log('warn', '语言参数无效：' + lang);
     return null;
@@ -570,9 +593,9 @@ Engine.prototype.loadLang = function (lang) {
  * 传入对象需实现 getUser / setUser / delUser / hasUser / listUsers / clear 六个同步方法
  * 留空或接口不完整时回退为内置内存存储（Memory）
  * @param {Object} store - 存储对象
- * @returns {Engine} 当前实例
+ * @returns {Tpl} 当前实例
  */
-Engine.prototype.setStore = function (store) {
+Tpl.prototype.setStore = function (store) {
   if (!store || !this._isStore(store)) {
     if (store) {
       this.log('warn', 'user_store 接口不完整，回退为内置内存存储');
@@ -589,7 +612,7 @@ Engine.prototype.setStore = function (store) {
  * 派生实例复用该对象即可共享同一份用户偏好
  * @returns {Object} 存储对象
  */
-Engine.prototype.getStore = function () {
+Tpl.prototype.getStore = function () {
   return this.store;
 };
 
@@ -598,7 +621,7 @@ Engine.prototype.getStore = function () {
  * @param {Object} store - 存储对象
  * @returns {boolean} 六个同步方法是否齐备
  */
-Engine.prototype._isStore = function (store) {
+Tpl.prototype._isStore = function (store) {
   var methods = ['getUser', 'setUser', 'delUser', 'hasUser', 'listUsers', 'clear'];
   for (var i = 0; i < methods.length; i++) {
     if (typeof (store[methods[i]]) !== 'function') {
@@ -614,7 +637,7 @@ Engine.prototype._isStore = function (store) {
  * @param {Object} prefs - 用户偏好，形如 { style, lang }
  * @returns {Object} 规范化后的偏好
  */
-Engine.prototype._prefs = function (prefs) {
+Tpl.prototype._prefs = function (prefs) {
   if (!prefs || typeof (prefs) !== 'object') {
     throw new TypeError('用户偏好必须是对象');
   }
@@ -641,7 +664,7 @@ Engine.prototype._prefs = function (prefs) {
  * @param {Object} prefs - 用户偏好，形如 { style, lang }，只取这两个字段
  * @returns {Object} 保存后的用户偏好
  */
-Engine.prototype.setUser = function (user_id, prefs) {
+Tpl.prototype.setUser = function (user_id, prefs) {
   return this.store.setUser(user_id, this._prefs(prefs));
 };
 
@@ -650,7 +673,7 @@ Engine.prototype.setUser = function (user_id, prefs) {
  * @param {string|number} user_id - 用户标识
  * @returns {Object|null} 用户偏好，未登记时返回 null
  */
-Engine.prototype.getUser = function (user_id) {
+Tpl.prototype.getUser = function (user_id) {
   return this.store.getUser(user_id);
 };
 
@@ -659,7 +682,7 @@ Engine.prototype.getUser = function (user_id) {
  * @param {string|number} user_id - 用户标识
  * @returns {boolean} 是否删除成功
  */
-Engine.prototype.removeUser = function (user_id) {
+Tpl.prototype.removeUser = function (user_id) {
   return this.store.delUser(user_id);
 };
 
@@ -667,7 +690,7 @@ Engine.prototype.removeUser = function (user_id) {
  * 获取已登记的用户标识列表
  * @returns {Array<string>} 用户标识数组
  */
-Engine.prototype.getUsers = function () {
+Tpl.prototype.getUsers = function () {
   return this.store.listUsers();
 };
 
@@ -679,7 +702,7 @@ Engine.prototype.getUsers = function () {
  * @param {Object} options - 其他渲染参数，可省略
  * @returns {Object} 渲染参数，含 style 与 lang
  */
-Engine.prototype.userOptions = function (user_id, options) {
+Tpl.prototype.userOptions = function (user_id, options) {
   var opt = Object.assign({}, options);
   var record = this.store.getUser(user_id);
   opt.style = (record && record.style !== undefined) ? record.style : this.current_style;
@@ -695,8 +718,8 @@ Engine.prototype.userOptions = function (user_id, options) {
  * @param {...any} args - 附加参数
  * @returns {Promise<any>} 执行结果
  */
-Engine.prototype.runFunc = async function (name, req, ...args) {
-  var ret = await $.hook.runFunc(name, this.viewBag, req, ...args);
+Tpl.prototype.runFunc = async function (name, req, ...args) {
+  var ret = await Tpl.global_hook.runFunc(name, this.viewBag, req, ...args);
   var ret_inst = await this.hook.runFunc(name, this.viewBag, req, ...args);
   return ret_inst || ret;
 };
@@ -708,19 +731,19 @@ Engine.prototype.runFunc = async function (name, req, ...args) {
  * @param {...any} args - 附加参数
  * @returns {Promise<any>} 执行结果
  */
-Engine.prototype.runHook = Engine.prototype.runFunc;
+Tpl.prototype.runHook = Tpl.prototype.runFunc;
 
 /**
  * 初始化前处理
  * @param {Object} config - 配置参数
  */
-Engine.prototype._initBefore = function (config) { };
+Tpl.prototype._initBefore = function (config) { };
 
 /**
  * 初始化主处理
  * @param {Object} config - 配置参数
  */
-Engine.prototype._initMain = function (config) {
+Tpl.prototype._initMain = function (config) {
   this.setConfig(config);
   this._initTpl();
 };
@@ -730,7 +753,7 @@ Engine.prototype._initMain = function (config) {
  * 构建字符转义规则，供渲染前后转义与还原使用
  * @param {Object} config - 配置参数
  */
-Engine.prototype._initAfter = function (config) {
+Tpl.prototype._initAfter = function (config) {
   this.escape_rule = TplUtil.buildEscapeRule(this.config.change_str);
 };
 
@@ -738,7 +761,7 @@ Engine.prototype._initAfter = function (config) {
  * 初始化模板
  * @param {Object} config - 配置参数
  */
-Engine.prototype._init = function (config) {
+Tpl.prototype._init = function (config) {
   this._initBefore(config);
   this._initMain(config);
   this._initAfter(config);
@@ -748,7 +771,7 @@ Engine.prototype._init = function (config) {
  * 获取当前主题
  * @returns {string} 主题名称
  */
-Engine.prototype.getTheme = function () {
+Tpl.prototype.getTheme = function () {
   return this.current_theme;
 };
 
@@ -760,7 +783,7 @@ Engine.prototype.getTheme = function () {
  * @param {boolean} force - 是否跳过目录校验
  * @returns {string} 设置后的主题名称
  */
-Engine.prototype.setTheme = function (theme, force) {
+Tpl.prototype.setTheme = function (theme, force) {
   if (typeof (theme) !== 'string' || !theme) {
     this.log('warn', '主题参数无效，保持当前主题：' + this.current_theme);
     return this.current_theme;
@@ -782,7 +805,7 @@ Engine.prototype.setTheme = function (theme, force) {
  * 获取当前风格
  * @returns {string} 风格名称，未设置时返回空字符串
  */
-Engine.prototype.getStyle = function () {
+Tpl.prototype.getStyle = function () {
   return this.current_style;
 };
 
@@ -792,7 +815,7 @@ Engine.prototype.getStyle = function () {
  * @param {boolean} force - 是否跳过目录校验
  * @returns {string} 设置后的风格名称
  */
-Engine.prototype.setStyle = function (style, force) {
+Tpl.prototype.setStyle = function (style, force) {
   if (typeof (style) !== 'string') {
     this.log('warn', '风格参数无效，保持当前风格：' + this.current_style);
     return this.current_style;
@@ -811,7 +834,7 @@ Engine.prototype.setStyle = function (style, force) {
  * @param {boolean} restore 是否还原转义字符
  * @returns {string} 转义后的字符串
  */
-Engine.prototype.escape = function (body, restore) {
+Tpl.prototype.escape = function (body, restore) {
   return TplUtil.escape(body, this.escape_rule, restore);
 };
 
@@ -820,7 +843,7 @@ Engine.prototype.escape = function (body, restore) {
  * @param {Object} m - 模型对象
  * @returns {Object} 处理后的模型
  */
-Engine.prototype._loadFuncBefore = function (m) {
+Tpl.prototype._loadFuncBefore = function (m) {
   // m.$i18n = function(key) {
   //   return $.i18n(key);
   // }
@@ -832,7 +855,7 @@ Engine.prototype._loadFuncBefore = function (m) {
  * @param {Object} m 模型对象
  * @returns {Object} 处理后的模型
  */
-Engine.prototype.loadFunc = function (m) {
+Tpl.prototype.loadFunc = function (m) {
   this._loadFuncBefore(m);
   var _this = this;
   m.view = function (file, model, options) {
@@ -856,13 +879,13 @@ Engine.prototype.loadFunc = function (m) {
   };
   m.hookAction = function (name, ...args) {
     // 全局动作钩子先输出，实例级动作钩子后输出
-    return $.hook.runAction(name, m, ...args) + _this.hook.runAction(name, m, ...args);
+    return Tpl.global_hook.runAction(name, m, ...args) + _this.hook.runAction(name, m, ...args);
   };
   m.hookFilter = function (name, content, ...args) {
     if (!content) {
       content = '';
     }
-    var ret = $.hook.runFilter(name, m, content, ...args);
+    var ret = Tpl.global_hook.runFilter(name, m, content, ...args);
     return _this.hook.runFilter(name, m, ret, ...args);
   };
   if (this.lang) {
@@ -887,7 +910,7 @@ Engine.prototype.loadFunc = function (m) {
  * @param {Function} func - 函数
  * @returns {boolean} 是否设置成功
  */
-Engine.prototype.setFunc = function (name, func) {
+Tpl.prototype.setFunc = function (name, func) {
   if (typeof (name) !== 'string' || !name) {
     this.log('warn', '模板函数名无效：' + name);
     return false;
@@ -905,7 +928,7 @@ Engine.prototype.setFunc = function (name, func) {
  * @param {string} name - 函数名
  * @returns {boolean} 是否存在并删除成功
  */
-Engine.prototype.removeFunc = function (name) {
+Tpl.prototype.removeFunc = function (name) {
   if (this.funcs[name] === undefined) {
     return false;
   }
@@ -917,7 +940,7 @@ Engine.prototype.removeFunc = function (name) {
  * 获取模板函数表
  * @returns {Object} 模板函数表
  */
-Engine.prototype.getFuncs = function () {
+Tpl.prototype.getFuncs = function () {
   return this.funcs;
 };
 
@@ -928,12 +951,12 @@ Engine.prototype.getFuncs = function () {
  * @param {Object} options - 配置参数
  * @returns {string} 渲染结果
  */
-Engine.prototype._renderMain = function (body, model, options) {
+Tpl.prototype._renderMain = function (body, model, options) {
   var ret = '';
   if (body) {
     var m = Object.assign({}, {
       viewBag: this.viewBag,
-      globalBag: $.globalBag
+      globalBag: Tpl.global_bag
     }, model);
     this.loadFunc(m);
     ret = this.engine.render(body, m, options);
@@ -948,7 +971,7 @@ Engine.prototype._renderMain = function (body, model, options) {
  * @param {Object} options - 渲染参数
  * @returns {Object|null} 原风格与原语言，未涉及临时选项时返回 null
  */
-Engine.prototype._applyTempOptions = function (options) {
+Tpl.prototype._applyTempOptions = function (options) {
   if (!options) {
     return null;
   }
@@ -974,7 +997,7 @@ Engine.prototype._applyTempOptions = function (options) {
  * 恢复临时选项
  * @param {Object|null} prev - _applyTempOptions 返回的原值
  */
-Engine.prototype._restoreTempOptions = function (prev) {
+Tpl.prototype._restoreTempOptions = function (prev) {
   if (!prev) {
     return;
   }
@@ -992,7 +1015,7 @@ Engine.prototype._restoreTempOptions = function (prev) {
  * @param {Object} options - 配置参数
  * @returns {string} 渲染结果
  */
-Engine.prototype.render = function (body, model, options) {
+Tpl.prototype.render = function (body, model, options) {
   var prev = this._applyTempOptions(options);
   try {
     body = this.escape(body);
@@ -1009,7 +1032,7 @@ Engine.prototype.render = function (body, model, options) {
  * @param {Object} options - 配置参数
  * @returns {Function} 渲染函数
  */
-Engine.prototype.compile = function (body, options) {
+Tpl.prototype.compile = function (body, options) {
   return this.engine.compile(body, options);
 };
 
@@ -1019,7 +1042,7 @@ Engine.prototype.compile = function (body, options) {
  * @param {Object} options - 配置参数，dir 为指定的查找目录
  * @returns {string} 模板文件路径
  */
-Engine.prototype.getFile = function (file, options) {
+Tpl.prototype.getFile = function (file, options) {
   return this.template.getFile(file, options);
 };
 
@@ -1029,7 +1052,7 @@ Engine.prototype.getFile = function (file, options) {
  * 结果按优先级升序排列：基础风格在前打底，当前风格与自定义目录在后覆盖
  * @returns {Array<string>} 样式文件全路径列表
  */
-Engine.prototype.getCssFiles = function () {
+Tpl.prototype.getCssFiles = function () {
   return this.css.getFiles();
 };
 
@@ -1041,7 +1064,7 @@ Engine.prototype.getCssFiles = function () {
  * @param {string} style - 风格名称，不传时取当前风格
  * @returns {Array<string>} 命中的样式文件全路径列表，顺序即引用顺序
  */
-Engine.prototype.matchCssFiles = function (pattern, theme, style) {
+Tpl.prototype.matchCssFiles = function (pattern, theme, style) {
   return this.css.matchFiles(pattern, theme, style);
 };
 
@@ -1054,7 +1077,7 @@ Engine.prototype.matchCssFiles = function (pattern, theme, style) {
  * @param {string} style - 风格名称，不传时取当前风格
  * @returns {string|Array<string>|null} 样式文件全路径；无通配符且不存在时返回 null
  */
-Engine.prototype.getCssFile = function (name, theme, style) {
+Tpl.prototype.getCssFile = function (name, theme, style) {
   if (!name || typeof (name) !== 'string') {
     return null;
   }
@@ -1072,7 +1095,7 @@ Engine.prototype.getCssFile = function (name, theme, style) {
  * @param {string} theme - 主题名称，不传时取当前主题
  * @returns {Array<string>} 命中的脚本文件全路径列表，顺序即执行顺序
  */
-Engine.prototype.matchJsFiles = function (pattern, theme) {
+Tpl.prototype.matchJsFiles = function (pattern, theme) {
   return this.js.matchFiles(pattern, theme);
 };
 
@@ -1082,7 +1105,7 @@ Engine.prototype.matchJsFiles = function (pattern, theme) {
  * 结果按优先级升序排列：应用级公共脚本在前，主题脚本与自定义目录在后
  * @returns {Array<string>} 脚本文件全路径列表
  */
-Engine.prototype.getJsFiles = function () {
+Tpl.prototype.getJsFiles = function () {
   return this.js.getFiles();
 };
 
@@ -1094,7 +1117,7 @@ Engine.prototype.getJsFiles = function () {
  * @param {string} theme - 主题名称，不传时取当前主题
  * @returns {string|Array<string>|null} 脚本文件全路径；无通配符且不存在时返回 null
  */
-Engine.prototype.getJsFile = function (name, theme) {
+Tpl.prototype.getJsFile = function (name, theme) {
   if (!name || typeof (name) !== 'string') {
     return null;
   }
@@ -1112,7 +1135,7 @@ Engine.prototype.getJsFile = function (name, theme) {
  * @param {Object} options - 配置参数，dir 为指定的查找目录
  * @returns {string} 组件文件路径
  */
-Engine.prototype.getComponentFile = function (name, options) {
+Tpl.prototype.getComponentFile = function (name, options) {
   return this.template.getComponent(name, options);
 };
 
@@ -1125,7 +1148,7 @@ Engine.prototype.getComponentFile = function (name, options) {
  * @param {Object} options - 配置参数
  * @returns {string} 渲染结果
  */
-Engine.prototype.component = function (name, model, options) {
+Tpl.prototype.component = function (name, model, options) {
   var dirs = this.getComponentDirs();
   if (!dirs.length) {
     this.error = {
@@ -1135,14 +1158,14 @@ Engine.prototype.component = function (name, model, options) {
     return '';
   }
   var f = this.getComponentFile(name, options);
-  if (!f.hasFile()) {
+  if (!FileUtil.hasFile(f)) {
     this.error = {
       code: 10000,
       message: f + '组件不存在！'
     };
     return '';
   }
-  var body = f.loadText();
+  var body = FileUtil.loadText(f);
   if (!body) {
     return '';
   }
@@ -1160,18 +1183,18 @@ Engine.prototype.component = function (name, model, options) {
  * @param {Object} options - 配置参数
  * @returns {string} 渲染结果
  */
-Engine.prototype.view = function (file, model, options) {
+Tpl.prototype.view = function (file, model, options) {
   var prev = this._applyTempOptions(options);
   try {
     var f = this.getFile(file, options);
-    if (!f.hasFile()) {
+    if (!FileUtil.hasFile(f)) {
       this.error = {
         code: 10000,
         message: f + '文件不存在！'
       };
     }
     else {
-      var body = f.loadText();
+      var body = FileUtil.loadText(f);
       if (body) {
         body = this.escape(body);
         body = this._renderMain(body, model, options);
@@ -1189,15 +1212,15 @@ Engine.prototype.view = function (file, model, options) {
  * 设置视图数据
  * @param {Object} obj - 要设置的数据对象
  */
-Engine.prototype.set = function (obj) {
-  $.push(this.viewBag, obj, true);
+Tpl.prototype.set = function (obj) {
+  TplUtil.mergeDeep(this.viewBag, obj, true);
 };
 
 /**
  * 删除视图数据
  * @param {Array|string} keys - 要删除的键或键数组
  */
-Engine.prototype.del = function (keys) {
+Tpl.prototype.del = function (keys) {
   if (typeof (keys) == 'string') {
     delete this.viewBag[keys];
   } else {
@@ -1212,7 +1235,7 @@ Engine.prototype.del = function (keys) {
  * @param {string} key - 数据键名
  * @returns {any} 数据值
  */
-Engine.prototype.get = function (key) {
+Tpl.prototype.get = function (key) {
   return this.viewBag[key];
 };
 
@@ -1224,9 +1247,9 @@ Engine.prototype.get = function (key) {
  * @param {string} config.theme - 主题名称
  * @param {string} config.style - 风格名称
  * @param {string} config.lang - 语言代码
- * @returns {Engine} 派生出的引擎实例
+ * @returns {Tpl} 派生出的引擎实例
  */
-Engine.prototype.fork = function (config) {
+Tpl.prototype.fork = function (config) {
   var cg = config || {};
   var lang = (cg.lang && this.lang.isSupported(cg.lang)) ? cg.lang : this.getLang();
   var cfg = Object.assign({}, this.config, {
@@ -1237,7 +1260,7 @@ Engine.prototype.fork = function (config) {
     // 用户偏好属于用户而非实例，派生实例复用同一份存储
     user_store: this.getStore()
   });
-  var tpl = new Engine(cfg);
+  var tpl = new Tpl(cfg);
   tpl.dir = this.dir;
   if (cg.theme) {
     tpl.setTheme(cg.theme);
@@ -1245,12 +1268,12 @@ Engine.prototype.fork = function (config) {
   if (cg.style) {
     tpl.setStyle(cg.style);
   }
-  $.push(tpl.viewBag, this.viewBag, true);
+  TplUtil.mergeDeep(tpl.viewBag, this.viewBag, true);
   // 模板函数属于站点级扩展，派生实例继承同一份
   tpl.funcs = Object.assign({}, this.funcs);
   return tpl;
 };
 
 module.exports = {
-  Engine
+  Tpl
 };