@midwayjs/view 3.0.0-beta.8 → 3.0.2

package/README.md

@@ -1,11 +1,227 @@
 # midway-view
 
-[![Package Quality](http://npm.packagequality.com/shield/@midwayjs/view.svg)](http://packagequality.com/#?package=@midwayjs/view)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/midwayjs/midway/pulls)
+Base view component for midway.
 
-this is a sub package for midway.
+## Install
+
+@midwayjs/view don't have build-in view engine, So you should choose a template engine like ejs, and install `@midwayjs/view-ejs`.
+View component will be auto install and enable by import `view-ejs`.
+
+```bash
+$ npm i @midwayjs/view-ejs --save
+```
+
+## Usage
+
+First, import component in `src/configuration.ts`.
+
+```typescript
+import { Configuration } from '@midwayjs/decorator';
+import * as view from '@midwayjs/view-ejs';
+import { join } from 'path'
+
+@Configuration({
+  imports: [
+    // ...
+    view
+  ],
+  importConfigs: [
+    join(__dirname, 'config')
+  ]
+})
+export class ContainerLifeCycle {
+}
+```
+
+Configure the mapping, the file with `.ejs` extension will be rendered by ejs.
+
+```typescript
+// src/config/config.default.ts
+export const view = {
+  defaultViewEngine: 'ejs',
+  mapping: {
+    '.ejs': 'ejs',
+  },
+};
+
+// ejs config
+export const ejs = {};
+```
+
+In controller, you can call `ctx.render`.
+
+```typescript
+import { Inject, Provide } from '@midwayjs/decorator';
+import { Context } from '@midwayjs/koa';
+
+@Controller('/')
+export class HomeController {
+
+  @Inject()
+  ctx: Context;
+
+  @Get('/')
+  async render(){
+    await this.ctx.render('hello.ejs', {
+      data: 'world',
+    });
+  }
+}
+```
+
+## Use multiple view engine
+
+@midwayjs/view support multiple view engine, so you can use more than one template engine in one application.
+
+If you want add another template engine like nunjucks, then you can add @midwayjs/view-nunjucks component.
+
+Configure the plugin and mapping
+
+```typescript
+// src/config/config.default.ts
+export const view = {
+  mapping: {
+    '.ejs': 'ejs',
+    '.nj': 'nunjucks',
+  },
+};
+```
+You can simply render the file with .nj extension.
+
+```typescript
+await this.ctx.render('user.nj');
+```
+
+## Write a view engine
+
+Create a view engine class first, and implement render and renderString, if the template engine don't support, just throw an error.
+
+```typescript
+// lib/view.ts
+import { Provide } from '@midwayjs/decorator';
+
+@Provide()
+export class MyView {
+
+  @Config('xxxx')
+  viewConfig;
+
+  async render(fullpath, locals) {
+    return myengine.render(fullpath, locals);
+  }
+
+  async renderString() { throw new Error('not implement'); }
+};
+```
+
+These methods receive three arguments, `renderString` will pass tpl as the first argument instead of name in `render`.
+
+`render(name, locals, viewOptions)`
+
+- name: the file path that can resolve from root (`/view` by default)
+- locals: data used by template
+- viewOptions: the view options for each render, it can override the view default config in `config/config.default.js`. Plugin should implement it if it has config.
+  When you implement view engine, you will receive this options from `render`, the options contain:
+  - root: it will resolve the name to full path, but seperating root and name in viewOptions.
+  - name: the original name when call render
+  - locals: the original locals when call render
+
+`renderString(tpl, locals, viewOptions)`
+
+- tpl: the template string instead of the file, using in `renderString`
+- locals: same as `render`
+- viewOptions: same as `render`
+
+### Register
+
+After define a view engine, you can register it.
+
+```typescript
+// src/configuration.ts
+import { Configuration, Inject, Provide } from '@midwayjs/decorator';
+import * as koa from '@midwayjs/koa';
+import * as view from '@midwayjs/view';
+import { MyView } from './lib/my';
+
+@Configuration({
+  imports: [koa, view],
+  importConfigs: [join(__dirname, 'config')]
+})
+export class AutoConfiguration {
+
+  @Inject()
+  viewManager: view.ViewManager;
+
+  async onReady(){
+    this.viewManager.use('ejs', MyView);
+  }
+}
+
+```
+
+You can define a view engine name, normally it's a template name.
+
+## Configuration
+
+### Root
+
+Root is `${appDir}/view` by default, but you can define multiple directory.
+
+```typescript
+export default appInfo => {
+  const appDir = appInfo.appDir;
+  return {
+    view: {
+      rootDir: {
+        default: `${appDir}/view`,
+        anotherDir: `${appDir}/view2`
+      }
+    }
+  }
+}
+```
+
+### defaultExtension
+
+When render a file, you should specify a extension that let @midway/view know which engine you want to use. However you can define `defaultExtension` without write the extension.
+
+```typescript
+// src/config/config.default.ts
+export const view = {
+  defaultExtension: '.html',
+};
+
+// controller
+import { Inject, Provide } from '@midwayjs/decorator';
+import { Context } from '@midwayjs/koa';
+
+@Controller('/')
+export class HomeController {
+
+  @Inject()
+  ctx: Context;
+
+  @Get('/')
+  async render(){
+    // render user.html
+    await this.ctx.render('user');
+  }
+}
+```
+
+### viewEngine and defaultViewEngine
+
+If you are using `renderString`, you should specify viewEngine in view config, see example above.
+
+However, you can define `defaultViewEngine` without set each time.
+
+```js
+// config/config.default.js
+export const view = {
+  defaultViewEngine: 'ejs',
+};
+```
 
-Document: [https://midwayjs.org](https://midwayjs.org)
 
 ## License
 

package/dist/config/config.default.d.ts

@@ -1,3 +1,22 @@
-declare const _default: (appInfo: any) => any;
+declare const _default: (appInfo: any) => {
+    /**
+     * view default config
+     * @member Config#view
+     * @property {String} [rootDir=${appDir}/view] - give a path to find the file, object.values() got array and find for view file
+     * @property {Boolean} [cache=true] - whether cache the file's path
+     * @property {String} [defaultExtension] - defaultExtension can be added automatically when there is no extension  when call `ctx.render`
+     * @property {String} [defaultViewEngine] - set the default view engine if you don't want specify the viewEngine every request.
+     * @property {Object} mapping - map the file extension to view engine, such as `{ '.ejs': 'ejs' }`
+     */
+    view: {
+        cache: boolean;
+        defaultExtension: string;
+        defaultViewEngine: string;
+        mapping: {};
+        rootDir: {
+            default: string;
+        };
+    };
+};
 export default _default;
 //# sourceMappingURL=config.default.d.ts.map

package/dist/config/config.default.js

@@ -1,13 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = require("path");
-const extend = require("extend2");
-exports.default = appInfo => {
-    const originConfig = require('egg-view/config/config.default')(appInfo);
-    return extend(true, originConfig, {
-        view: {
-            root: (0, path_1.join)(appInfo.appDir, 'view'),
+exports.default = appInfo => ({
+    /**
+     * view default config
+     * @member Config#view
+     * @property {String} [rootDir=${appDir}/view] - give a path to find the file, object.values() got array and find for view file
+     * @property {Boolean} [cache=true] - whether cache the file's path
+     * @property {String} [defaultExtension] - defaultExtension can be added automatically when there is no extension  when call `ctx.render`
+     * @property {String} [defaultViewEngine] - set the default view engine if you don't want specify the viewEngine every request.
+     * @property {Object} mapping - map the file extension to view engine, such as `{ '.ejs': 'ejs' }`
+     */
+    view: {
+        cache: true,
+        defaultExtension: '.html',
+        defaultViewEngine: '',
+        mapping: {},
+        rootDir: {
+            default: (0, path_1.join)(appInfo.appDir, 'view'),
         },
-    });
-};
+    },
+});
 //# sourceMappingURL=config.default.js.map

package/dist/config/config.default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.default.js","sourceRoot":"","sources":["../../src/config/config.default.ts"],"names":[],"mappings":";;AAAA,+BAA4B;AAE5B,kBAAe,OAAO,CAAC,EAAE,CAAC,CAAC;IACzB;;;;;;;;OAQG;IACH,IAAI,EAAE;QACJ,KAAK,EAAE,IAAI;QACX,gBAAgB,EAAE,OAAO;QACzB,iBAAiB,EAAE,EAAE;QACrB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE;YACP,OAAO,EAAE,IAAA,WAAI,EAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;SACtC;KACF;CACF,CAAC,CAAC","sourcesContent":["import { join } from 'path';\n\nexport default appInfo => ({\n  /**\n   * view default config\n   * @member Config#view\n   * @property {String} [rootDir=${appDir}/view] - give a path to find the file, object.values() got array and find for view file\n   * @property {Boolean} [cache=true] - whether cache the file's path\n   * @property {String} [defaultExtension] - defaultExtension can be added automatically when there is no extension  when call `ctx.render`\n   * @property {String} [defaultViewEngine] - set the default view engine if you don't want specify the viewEngine every request.\n   * @property {Object} mapping - map the file extension to view engine, such as `{ '.ejs': 'ejs' }`\n   */\n  view: {\n    cache: true,\n    defaultExtension: '.html',\n    defaultViewEngine: '',\n    mapping: {},\n    rootDir: {\n      default: join(appInfo.appDir, 'view'),\n    },\n  },\n});\n"]}

package/dist/config/config.local.d.ts

@@ -1,3 +1,4 @@
-declare const _default: any;
-export default _default;
+export declare const view: {
+    cache: boolean;
+};
 //# sourceMappingURL=config.local.d.ts.map

package/dist/config/config.local.js

@@ -1,4 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = require('egg-view/config/config.local');
+exports.view = void 0;
+exports.view = {
+    cache: false,
+};
 //# sourceMappingURL=config.local.js.map

package/dist/config/config.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.local.js","sourceRoot":"","sources":["../../src/config/config.local.ts"],"names":[],"mappings":";;;AAAa,QAAA,IAAI,GAAG;IAClB,KAAK,EAAE,KAAK;CACb,CAAC","sourcesContent":["export const view = {\n  cache: false,\n};\n"]}

package/dist/configuration.d.ts

@@ -1,5 +1,6 @@
+import { MidwayApplicationManager } from '@midwayjs/core';
 export declare class ViewConfiguration {
-    app: any;
+    applicationManager: MidwayApplicationManager;
     onReady(container: any): Promise<void>;
 }
 //# sourceMappingURL=configuration.d.ts.map

package/dist/configuration.js

@@ -11,28 +11,58 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViewConfiguration = void 0;
 const decorator_1 = require("@midwayjs/decorator");
-const mw_util_1 = require("@midwayjs/mw-util");
 const DefaultConfig = require("./config/config.default");
 const LocalConfig = require("./config/config.local");
 const viewManager_1 = require("./viewManager");
+const core_1 = require("@midwayjs/core");
+const contextView_1 = require("./contextView");
 let ViewConfiguration = class ViewConfiguration {
     async onReady(container) {
-        if (!this.app.config) {
-            this.app.config = this.app.getConfig();
-        }
-        (0, mw_util_1.completeAssign)(this.app.context, require('egg-view/app/extend/context'));
-        this.app.view = await container.getAsync(viewManager_1.ViewManager);
-        if (!this.app.toAsyncFunction) {
-            this.app.toAsyncFunction = method => {
-                return method;
-            };
-        }
+        this.applicationManager
+            .getApplications(['koa', 'egg', 'faas'])
+            .forEach((app) => {
+            Object.defineProperties(app.context, {
+                /**
+                 * Render a file, then set to body, the parameter is same as {@link @ContextView#render}
+                 * @return {Promise} result
+                 */
+                render: {
+                    value: async function (...args) {
+                        const contextView = await this.requestContext.getAsync(contextView_1.ContextView);
+                        return contextView.render(...args).then(body => {
+                            this.body = body;
+                        });
+                    },
+                },
+                /**
+                 * Render a file, same as {@link @ContextView#render}
+                 * @return {Promise} result
+                 */
+                renderView: {
+                    value: async function (...args) {
+                        const contextView = await this.requestContext.getAsync(contextView_1.ContextView);
+                        return contextView.render(...args);
+                    },
+                },
+                /**
+                 * Render template string, same as {@link @ContextView#renderString}
+                 * @return {Promise} result
+                 */
+                renderString: {
+                    value: async function (...args) {
+                        const contextView = await this.requestContext.getAsync(contextView_1.ContextView);
+                        return contextView.renderString(...args);
+                    },
+                },
+            });
+        });
+        await container.getAsync(viewManager_1.ViewManager);
     }
 };
 __decorate([
-    (0, decorator_1.App)(),
-    __metadata("design:type", Object)
-], ViewConfiguration.prototype, "app", void 0);
+    (0, decorator_1.Inject)(),
+    __metadata("design:type", core_1.MidwayApplicationManager)
+], ViewConfiguration.prototype, "applicationManager", void 0);
 ViewConfiguration = __decorate([
     (0, decorator_1.Configuration)({
         namespace: 'view',

package/dist/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,mDAA4D;AAC5D,yDAAyD;AACzD,qDAAqD;AACrD,+CAA4C;AAC5C,yCAA0D;AAC1D,+CAA4C;AAW5C,IAAa,iBAAiB,GAA9B,MAAa,iBAAiB;IAI5B,KAAK,CAAC,OAAO,CAAC,SAAS;QACrB,IAAI,CAAC,kBAAkB;aACpB,eAAe,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;aACvC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE;YACpB,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE;gBACnC;;;mBAGG;gBACH,MAAM,EAAE;oBACN,KAAK,EAAE,KAAK,WAAW,GAAG,IAAI;wBAC5B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CACpD,yBAAW,CACZ,CAAC;wBACF,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;4BAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;wBACnB,CAAC,CAAC,CAAC;oBACL,CAAC;iBACF;gBAED;;;mBAGG;gBACH,UAAU,EAAE;oBACV,KAAK,EAAE,KAAK,WAAW,GAAG,IAAI;wBAC5B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CACpD,yBAAW,CACZ,CAAC;wBACF,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;oBACrC,CAAC;iBACF;gBAED;;;mBAGG;gBACH,YAAY,EAAE;oBACZ,KAAK,EAAE,KAAK,WAAW,GAAG,IAAI;wBAC5B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CACpD,yBAAW,CACZ,CAAC;wBACF,OAAO,WAAW,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;oBAC3C,CAAC;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEL,MAAM,SAAS,CAAC,QAAQ,CAAC,yBAAW,CAAC,CAAC;IACxC,CAAC;CACF,CAAA;AApDC;IADC,IAAA,kBAAM,GAAE;8BACW,+BAAwB;6DAAC;AAFlC,iBAAiB;IAT7B,IAAA,yBAAa,EAAC;QACb,SAAS,EAAE,MAAM;QACjB,aAAa,EAAE;YACb;gBACE,OAAO,EAAE,aAAa;gBACtB,KAAK,EAAE,WAAW;aACnB;SACF;KACF,CAAC;GACW,iBAAiB,CAsD7B;AAtDY,8CAAiB","sourcesContent":["import { Inject, Configuration } from '@midwayjs/decorator';\nimport * as DefaultConfig from './config/config.default';\nimport * as LocalConfig from './config/config.local';\nimport { ViewManager } from './viewManager';\nimport { MidwayApplicationManager } from '@midwayjs/core';\nimport { ContextView } from './contextView';\n\n@Configuration({\n  namespace: 'view',\n  importConfigs: [\n    {\n      default: DefaultConfig,\n      local: LocalConfig,\n    },\n  ],\n})\nexport class ViewConfiguration {\n  @Inject()\n  applicationManager: MidwayApplicationManager;\n\n  async onReady(container) {\n    this.applicationManager\n      .getApplications(['koa', 'egg', 'faas'])\n      .forEach((app: any) => {\n        Object.defineProperties(app.context, {\n          /**\n           * Render a file, then set to body, the parameter is same as {@link @ContextView#render}\n           * @return {Promise} result\n           */\n          render: {\n            value: async function (...args) {\n              const contextView = await this.requestContext.getAsync(\n                ContextView\n              );\n              return contextView.render(...args).then(body => {\n                this.body = body;\n              });\n            },\n          },\n\n          /**\n           * Render a file, same as {@link @ContextView#render}\n           * @return {Promise} result\n           */\n          renderView: {\n            value: async function (...args) {\n              const contextView = await this.requestContext.getAsync(\n                ContextView\n              );\n              return contextView.render(...args);\n            },\n          },\n\n          /**\n           * Render template string, same as {@link @ContextView#renderString}\n           * @return {Promise} result\n           */\n          renderString: {\n            value: async function (...args) {\n              const contextView = await this.requestContext.getAsync(\n                ContextView\n              );\n              return contextView.renderString(...args);\n            },\n          },\n        });\n      });\n\n    await container.getAsync(ViewManager);\n  }\n}\n"]}

package/dist/contextView.d.ts

@@ -0,0 +1,18 @@
+import { ViewManager } from './viewManager';
+import { IViewEngine, RenderOptions } from './interface';
+/**
+ * View instance for each request.
+ *
+ * It will find the view engine, and render it.
+ * The view engine should be registered in {@link ViewManager}.
+ */
+export declare class ContextView implements IViewEngine {
+    viewManager: ViewManager;
+    viewConfig: any;
+    ctx: any;
+    render(name: string, locals?: Record<string, any>, options?: RenderOptions): Promise<string>;
+    renderString(tpl: string, locals?: Record<string, any>, options?: RenderOptions): Promise<string>;
+    private getViewEngine;
+    private setLocals;
+}
+//# sourceMappingURL=contextView.d.ts.map

package/dist/contextView.js

@@ -0,0 +1,94 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextView = void 0;
+const viewManager_1 = require("./viewManager");
+const decorator_1 = require("@midwayjs/decorator");
+const assert = require("assert");
+const path_1 = require("path");
+/**
+ * View instance for each request.
+ *
+ * It will find the view engine, and render it.
+ * The view engine should be registered in {@link ViewManager}.
+ */
+let ContextView = class ContextView {
+    async render(name, locals, options) {
+        // retrieve fullpath matching name from `config.root`
+        const filename = await this.viewManager.resolve(name);
+        options = options !== null && options !== void 0 ? options : {};
+        options.name = name;
+        options.root = filename.replace((0, path_1.normalize)(name), '').replace(/[/\\]$/, '');
+        options.locals = locals;
+        // get the name of view engine,
+        // if viewEngine is specified in options, don't match extension
+        let viewEngineName = options.viewEngine;
+        if (!viewEngineName) {
+            const ext = (0, path_1.extname)(filename);
+            viewEngineName = this.viewManager.extMap.get(ext);
+        }
+        // use the default view engine that is configured if no matching above
+        if (!viewEngineName) {
+            viewEngineName = this.viewConfig.defaultViewEngine;
+        }
+        assert(viewEngineName, `Can't find viewEngine for ${filename}`);
+        // get view engine and render
+        const view = await this.getViewEngine(viewEngineName);
+        return await view.render(filename, this.setLocals(locals), options);
+    }
+    async renderString(tpl, locals, options) {
+        var _a;
+        options = options !== null && options !== void 0 ? options : {};
+        const viewEngineName = (_a = options.viewEngine) !== null && _a !== void 0 ? _a : this.viewConfig.defaultViewEngine;
+        assert(viewEngineName, "Can't find viewEngine");
+        // get view engine and render
+        const view = await this.getViewEngine(viewEngineName);
+        return await view.renderString(tpl, this.setLocals(locals), options);
+    }
+    async getViewEngine(name) {
+        // get view engine
+        const ViewEngine = this.viewManager.get(name);
+        assert(ViewEngine, `Can't find ViewEngine "${name}"`);
+        // use view engine to render
+        const engine = await this.ctx.requestContext.getAsync(ViewEngine);
+        // wrap render and renderString to support both async function and generator function
+        if (engine.render) {
+            engine.render = decorator_1.Utils.toAsyncFunction(engine.render);
+        }
+        if (engine.renderString) {
+            engine.renderString = decorator_1.Utils.toAsyncFunction(engine.renderString);
+        }
+        return engine;
+    }
+    setLocals(locals) {
+        return Object.assign({
+            ctx: this.ctx,
+            request: this.ctx.request,
+        }, this.ctx.locals, locals);
+    }
+};
+__decorate([
+    (0, decorator_1.Inject)(),
+    __metadata("design:type", viewManager_1.ViewManager)
+], ContextView.prototype, "viewManager", void 0);
+__decorate([
+    (0, decorator_1.Config)('view'),
+    __metadata("design:type", Object)
+], ContextView.prototype, "viewConfig", void 0);
+__decorate([
+    (0, decorator_1.Inject)(),
+    __metadata("design:type", Object)
+], ContextView.prototype, "ctx", void 0);
+ContextView = __decorate([
+    (0, decorator_1.Provide)()
+], ContextView);
+exports.ContextView = ContextView;
+//# sourceMappingURL=contextView.js.map

package/dist/contextView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextView.js","sourceRoot":"","sources":["../src/contextView.ts"],"names":[],"mappings":"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","sourcesContent":["import { ViewManager } from './viewManager';\nimport { Provide, Inject, Config, Utils } from '@midwayjs/decorator';\nimport * as assert from 'assert';\nimport { normalize, extname } from 'path';\nimport { IViewEngine, RenderOptions } from './interface';\n\n/**\n * View instance for each request.\n *\n * It will find the view engine, and render it.\n * The view engine should be registered in {@link ViewManager}.\n */\n@Provide()\nexport class ContextView implements IViewEngine {\n  @Inject()\n  viewManager: ViewManager;\n\n  @Config('view')\n  viewConfig;\n\n  @Inject()\n  ctx;\n\n  async render(\n    name: string,\n    locals?: Record<string, any>,\n    options?: RenderOptions\n  ): Promise<string> {\n    // retrieve fullpath matching name from `config.root`\n    const filename = await this.viewManager.resolve(name);\n    options = options ?? {};\n    options.name = name;\n    options.root = filename.replace(normalize(name), '').replace(/[/\\\\]$/, '');\n    options.locals = locals;\n\n    // get the name of view engine,\n    // if viewEngine is specified in options, don't match extension\n    let viewEngineName = options.viewEngine;\n    if (!viewEngineName) {\n      const ext = extname(filename);\n      viewEngineName = this.viewManager.extMap.get(ext);\n    }\n    // use the default view engine that is configured if no matching above\n    if (!viewEngineName) {\n      viewEngineName = this.viewConfig.defaultViewEngine;\n    }\n    assert(viewEngineName, `Can't find viewEngine for ${filename}`);\n\n    // get view engine and render\n    const view = await this.getViewEngine(viewEngineName);\n    return await view.render(filename, this.setLocals(locals), options);\n  }\n\n  async renderString(\n    tpl: string,\n    locals?: Record<string, any>,\n    options?: RenderOptions\n  ): Promise<string> {\n    options = options ?? {};\n    const viewEngineName =\n      options.viewEngine ?? this.viewConfig.defaultViewEngine;\n    assert(viewEngineName, \"Can't find viewEngine\");\n\n    // get view engine and render\n    const view = await this.getViewEngine(viewEngineName);\n    return await view.renderString(tpl, this.setLocals(locals), options);\n  }\n\n  private async getViewEngine(name) {\n    // get view engine\n    const ViewEngine = this.viewManager.get(name);\n    assert(ViewEngine, `Can't find ViewEngine \"${name}\"`);\n\n    // use view engine to render\n    const engine = await this.ctx.requestContext.getAsync(ViewEngine);\n    // wrap render and renderString to support both async function and generator function\n    if (engine.render) {\n      engine.render = Utils.toAsyncFunction(engine.render);\n    }\n    if (engine.renderString) {\n      engine.renderString = Utils.toAsyncFunction(engine.renderString);\n    }\n    return engine;\n  }\n\n  private setLocals(locals) {\n    return Object.assign(\n      {\n        ctx: this.ctx,\n        request: this.ctx.request,\n      },\n      this.ctx.locals,\n      locals\n    );\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { ViewConfiguration as Configuration } from './configuration';
+export * from './interface';
+export * from './contextView';
 export * from './viewManager';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -13,5 +13,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Configuration = void 0;
 var configuration_1 = require("./configuration");
 Object.defineProperty(exports, "Configuration", { enumerable: true, get: function () { return configuration_1.ViewConfiguration; } });
+__exportStar(require("./interface"), exports);
+__exportStar(require("./contextView"), exports);
 __exportStar(require("./viewManager"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,iDAAqE;AAA5D,8GAAA,iBAAiB,OAAiB;AAC3C,8CAA4B;AAC5B,gDAA8B;AAC9B,gDAA8B","sourcesContent":["export { ViewConfiguration as Configuration } from './configuration';\nexport * from './interface';\nexport * from './contextView';\nexport * from './viewManager';\n"]}

package/dist/interface.d.ts

@@ -0,0 +1,25 @@
+export interface RenderOptions {
+    name?: string;
+    root?: string;
+    locals?: Record<string, any>;
+    viewEngine?: string;
+}
+export interface IViewEngine {
+    /**
+     * Render a file by view engine, then set to body
+     * @param {String} name - the file path based on root
+     * @param {Object} [locals] - data used by template
+     * @param {Object} [options] - view options, you can use `options.viewEngine` to specify view engine
+     * @return {Promise<String>} result - return a promise with a render result
+     */
+    render(name: string, locals?: Record<string, any>, options?: RenderOptions): Promise<string>;
+    /**
+     * Render a template string by view engine
+     * @param {String} tpl - template string
+     * @param {Object} [locals] - data used by template
+     * @param {Object} [options] - view options, you can use `options.viewEngine` to specify view engine
+     * @return {Promise<String>} result - return a promise with a render result
+     */
+    renderString(tpl: string, locals?: Record<string, any>, options?: RenderOptions): Promise<string>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interface.js.map

package/dist/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"","sourcesContent":["export interface RenderOptions {\n  name?: string;\n  root?: string;\n  locals?: Record<string, any>;\n  viewEngine?: string;\n}\n\nexport interface IViewEngine {\n  /**\n   * Render a file by view engine, then set to body\n   * @param {String} name - the file path based on root\n   * @param {Object} [locals] - data used by template\n   * @param {Object} [options] - view options, you can use `options.viewEngine` to specify view engine\n   * @return {Promise<String>} result - return a promise with a render result\n   */\n  render(name: string, locals?: Record<string, any>, options?: RenderOptions): Promise<string>;\n\n  /**\n   * Render a template string by view engine\n   * @param {String} tpl - template string\n   * @param {Object} [locals] - data used by template\n   * @param {Object} [options] - view options, you can use `options.viewEngine` to specify view engine\n   * @return {Promise<String>} result - return a promise with a render result\n   */\n  renderString(\n    tpl: string,\n    locals?: Record<string, any>,\n    options?: RenderOptions\n  ): Promise<string>;\n}\n"]}

package/dist/viewManager.d.ts

@@ -1,9 +1,11 @@
-export declare class ViewManager {
+import { IViewEngine } from './interface';
+export declare class ViewManager extends Map {
     app: any;
-    innerManager: any;
-    get extMap(): any;
-    get config(): any;
-    init(): Promise<void>;
+    viewConfig: any;
+    config: any;
+    extMap: Map<any, any>;
+    fileMap: Map<any, any>;
+    init(): void;
     /**
      * This method can register view engine.
      *
@@ -18,15 +20,14 @@ export declare class ViewManager {
      * @param {String} name - the name of view engine
      * @param {Object} viewEngine - the class of view engine
      */
-    use(name: string, viewEngine: any): void;
+    use(name: string, viewEngine: new (...args: any[]) => IViewEngine): void;
     /**
      * Resolve the path based on the given name,
-     * if the name is `user.html` and root is `app/view` (by default),
-     * it will return `app/view/user.html`
+     * if the name is `user.html` and root is `view` (by default),
+     * it will return `view/user.html`
      * @param {String} name - the given path name, it's relative to config.root
      * @return {String} filename - the full path
      */
     resolve(name: string): Promise<string>;
-    get(key: any): any;
 }
 //# sourceMappingURL=viewManager.d.ts.map