@midwayjs/view 3.0.0-beta.7 → 3.0.1

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/midway](https://midwayjs.org/midway)
 
 ## 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.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/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/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/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/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/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

package/dist/viewManager.js

@@ -10,19 +10,32 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViewManager = void 0;
-const OriginViewManager = require("egg-view/lib/view_manager");
 const decorator_1 = require("@midwayjs/decorator");
-const mw_util_1 = require("@midwayjs/mw-util");
-let ViewManager = class ViewManager {
-    get extMap() {
-        return this.innerManager.extMap;
+const assert = require("assert");
+const path = require("path");
+const fs_1 = require("fs");
+let ViewManager = class ViewManager extends Map {
+    constructor() {
+        super(...arguments);
+        this.extMap = new Map();
+        this.fileMap = new Map();
     }
-    get config() {
-        return this.innerManager.config;
-    }
-    async init() {
-        const mockApp = (0, mw_util_1.createMockApp)(this.app);
-        this.innerManager = new OriginViewManager(mockApp);
+    init() {
+        this.config = this.viewConfig;
+        const rootSet = new Set(Object.values(this.config.rootDir));
+        if (this.config.root) {
+            this.config.root.split(/\s*,\s*/g).forEach(filepath => {
+                rootSet.add(filepath);
+            });
+        }
+        this.config.root = Array.from(rootSet.values()).filter(filepath => {
+            return (0, fs_1.existsSync)(filepath);
+        });
+        this.extMap = new Map();
+        this.fileMap = new Map();
+        for (const ext of Object.keys(this.config.mapping)) {
+            this.extMap.set(ext, this.config.mapping[ext]);
+        }
     }
     /**
      * This method can register view engine.
@@ -39,35 +52,70 @@ let ViewManager = class ViewManager {
      * @param {Object} viewEngine - the class of view engine
      */
     use(name, viewEngine) {
-        return this.innerManager.use(name, viewEngine);
+        assert(name, 'name is required');
+        assert(!this.has(name), `${name} has been registered`);
+        assert(viewEngine, 'viewEngine is required');
+        assert(viewEngine.prototype.render, 'viewEngine should implement `render` method');
+        assert(viewEngine.prototype.renderString, 'viewEngine should implement `renderString` method');
+        this.set(name, viewEngine);
     }
     /**
      * 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
      */
     async resolve(name) {
-        return this.innerManager.resolve(name);
-    }
-    get(key) {
-        return this.innerManager.get(key);
+        const config = this.config;
+        // check cache
+        let filename = this.fileMap.get(name);
+        if (config.cache && filename)
+            return filename;
+        // try find it with default extension
+        filename = await resolvePath([name, name + config.defaultExtension], config.root);
+        assert(filename, `Can't find ${name} from ${config.root.join(',')}`);
+        // set cache
+        this.fileMap.set(name, filename);
+        return filename;
     }
 };
 __decorate([
     (0, decorator_1.App)(),
     __metadata("design:type", Object)
 ], ViewManager.prototype, "app", void 0);
+__decorate([
+    (0, decorator_1.Config)('view'),
+    __metadata("design:type", Object)
+], ViewManager.prototype, "viewConfig", void 0);
 __decorate([
     (0, decorator_1.Init)(),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
+    __metadata("design:returntype", void 0)
 ], ViewManager.prototype, "init", null);
 ViewManager = __decorate([
     (0, decorator_1.Provide)(),
     (0, decorator_1.Scope)(decorator_1.ScopeEnum.Singleton)
 ], ViewManager);
 exports.ViewManager = ViewManager;
+async function resolvePath(names, root) {
+    for (const name of names) {
+        for (const dir of root) {
+            const filename = path.join(dir, name);
+            try {
+                await fs_1.promises.access(filename, fs_1.constants.R_OK);
+                if (inpath(dir, filename)) {
+                    return filename;
+                }
+            }
+            catch (err) {
+                // ignore
+            }
+        }
+    }
+}
+function inpath(parent, sub) {
+    return sub.indexOf(parent) > -1;
+}
 //# sourceMappingURL=viewManager.js.map

package/index.d.ts

@@ -1,54 +1,11 @@
+import { IViewEngine } from './dist';
 export * from './dist/index';
 
-interface RenderOptions {
-  name?: string;
-  root?: string;
-  locals?: Record<string, any>;
-  viewEngine?: string;
-}
-
 declare module '@midwayjs/core/dist/interface' {
-  interface Context {
-    /**
-     * 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?: any, options?: RenderOptions): Promise<null>;
-
-    /**
-     * Render a file by view engine and return it
-     * @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
-     */
-    renderView(
-      name: string,
-      locals?: 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(
-      name: string,
-      locals?: any,
-      options?: RenderOptions
-    ): Promise<string>;
-  }
-
   interface MidwayConfig {
     view?: {
       /**
-       * give a path to find the file, you can specify multiple path with `,` delimiter
+       * give a path to find the file, it will be override rootDir.default
        */
       root?: string;
       /**
@@ -67,6 +24,31 @@ declare module '@midwayjs/core/dist/interface' {
        * map the file extension to view engine, such as `{ '.ejs': 'ejs' }`
        */
       mapping?: Record<string, string>;
+      /**
+       * give multi-path for root, it can be overwrite or add in different component
+       */
+      rootDir?: Record<string, string>;
     };
   }
 }
+
+declare module '@midwayjs/koa/dist/interface' {
+  // eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface Context extends IViewEngine {
+    //...
+  }
+}
+
+declare module '@midwayjs/web/dist/interface' {
+  // eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface Context extends IViewEngine {
+    //...
+  }
+}
+
+declare module '@midwayjs/faas/dist/interface' {
+  // eslint-disable-next-line @typescript-eslint/no-empty-interface
+  interface Context extends IViewEngine {
+    //...
+  }
+}

package/package.json

@@ -1,21 +1,20 @@
 {
   "name": "@midwayjs/view",
-  "version": "3.0.0-beta.7",
-  "description": "Midway Component for egg-view",
+  "version": "3.0.1",
+  "description": "Midway Component for render view",
   "main": "dist/index.js",
   "typings": "index.d.ts",
   "scripts": {
     "build": "tsc",
-    "test": "node --require=ts-node/register ../../node_modules/.bin/jest",
-    "cov": "node --require=ts-node/register ../../node_modules/.bin/jest --coverage --forceExit",
+    "test": "node --require=ts-node/register ../../node_modules/.bin/jest --runInBand",
+    "cov": "node --require=ts-node/register ../../node_modules/.bin/jest --runInBand --coverage --forceExit",
     "ci": "npm run test"
   },
   "keywords": [
     "midway",
     "component",
     "midway-view",
-    "view",
-    "egg-view"
+    "view"
   ],
   "author": "",
   "files": [
@@ -27,16 +26,11 @@
     "node": ">=12"
   },
   "license": "MIT",
-  "dependencies": {
-    "@midwayjs/mw-util": "^1.0.0",
-    "egg-view": "^2.1.3",
-    "extend2": "^1.0.0"
-  },
   "devDependencies": {
-    "@midwayjs/core": "^3.0.0-beta.7",
-    "@midwayjs/decorator": "^3.0.0-beta.7",
-    "@midwayjs/koa": "^3.0.0-beta.7",
-    "@midwayjs/mock": "^3.0.0-beta.7"
+    "@midwayjs/core": "^3.0.1",
+    "@midwayjs/decorator": "^3.0.0",
+    "@midwayjs/koa": "^3.0.1",
+    "@midwayjs/mock": "^3.0.1"
   },
-  "gitHead": "24590729121d9110e2d960db5b5e587cf55a1efc"
+  "gitHead": "f345b4ed0392e5c3b9e815438ef0a377ad6da076"
 }

package/CHANGELOG.md

@@ -1,499 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-# [3.0.0-beta.7](https://github.com/midwayjs/midway/compare/v3.0.0-beta.6...v3.0.0-beta.7) (2021-12-03)
-
-
-### Bug Fixes
-
-* add app.keys ([#1395](https://github.com/midwayjs/midway/issues/1395)) ([c44afc6](https://github.com/midwayjs/midway/commit/c44afc6cc6764a959d1fa7ae04d60099282d156a))
-
-
-
-
-
-# [3.0.0-beta.6](https://github.com/midwayjs/midway/compare/v3.0.0-beta.5...v3.0.0-beta.6) (2021-11-26)
-
-**Note:** Version bump only for package @midwayjs/view
-
-
-
-
-
-# [3.0.0-beta.5](https://github.com/midwayjs/midway/compare/v3.0.0-beta.4...v3.0.0-beta.5) (2021-11-25)
-
-**Note:** Version bump only for package @midwayjs/view
-
-
-
-
-
-# [3.0.0-beta.4](https://github.com/midwayjs/midway/compare/v3.0.0-beta.3...v3.0.0-beta.4) (2021-11-24)
-
-**Note:** Version bump only for package @midwayjs/view
-
-
-
-
-
-# [3.0.0-beta.3](https://github.com/midwayjs/midway/compare/v3.0.0-beta.2...v3.0.0-beta.3) (2021-11-18)
-
-
-### Features
-
-* add component and framework config definition ([#1367](https://github.com/midwayjs/midway/issues/1367)) ([b2fe615](https://github.com/midwayjs/midway/commit/b2fe6157f99659471ff1333eca0b86bb889f61a3))
-
-
-
-
-
-# [3.0.0-beta.2](https://github.com/midwayjs/midway/compare/v3.0.0-beta.1...v3.0.0-beta.2) (2021-11-16)
-
-**Note:** Version bump only for package @midwayjs/view
-
-
-
-
-
-# [3.0.0-beta.1](https://github.com/midwayjs/midway/compare/v2.12.4...v3.0.0-beta.1) (2021-11-14)
-
-
-### Features
-
-* add view, view-ejs and view-nunjucks ([#1308](https://github.com/midwayjs/midway/issues/1308)) ([a00f44b](https://github.com/midwayjs/midway/commit/a00f44bd769052245cd49d49ab417d621bb89caa))
-
-
-
-
-
-## [2.13.2](https://github.com/midwayjs/midway/compare/v2.13.1...v2.13.2) (2021-09-09)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.13.1](https://github.com/midwayjs/midway/compare/v2.13.0...v2.13.1) (2021-09-08)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-# [2.13.0](https://github.com/midwayjs/midway/compare/v2.12.9...v2.13.0) (2021-09-07)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.12.9](https://github.com/midwayjs/midway/compare/v2.12.8...v2.12.9) (2021-09-01)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.12.7](https://github.com/midwayjs/midway/compare/v2.12.6...v2.12.7) (2021-08-22)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.12.5](https://github.com/midwayjs/midway/compare/v2.12.4...v2.12.5) (2021-08-18)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.12.3](https://github.com/midwayjs/midway/compare/v2.12.2...v2.12.3) (2021-08-09)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.12.1](https://github.com/midwayjs/midway/compare/v2.12.0...v2.12.1) (2021-08-01)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-# [2.12.0](https://github.com/midwayjs/midway/compare/v2.11.7...v2.12.0) (2021-07-30)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.11.6](https://github.com/midwayjs/midway/compare/v2.11.5...v2.11.6) (2021-07-16)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.11.5](https://github.com/midwayjs/midway/compare/v2.11.4...v2.11.5) (2021-07-15)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.11.4](https://github.com/midwayjs/midway/compare/v2.11.3...v2.11.4) (2021-07-06)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.11.3](https://github.com/midwayjs/midway/compare/v2.11.2...v2.11.3) (2021-07-02)
-
-
-### Bug Fixes
-
-* hide real error when user code throw error ([#1128](https://github.com/midwayjs/midway/issues/1128)) ([e728b0b](https://github.com/midwayjs/midway/commit/e728b0b80956c09cfb856ffe082f44fa29cfeb82))
-
-
-
-
-
-## [2.11.2](https://github.com/midwayjs/midway/compare/v2.11.1...v2.11.2) (2021-06-28)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.11.1](https://github.com/midwayjs/midway/compare/v2.11.0...v2.11.1) (2021-06-19)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-# [2.11.0](https://github.com/midwayjs/midway/compare/v2.10.19...v2.11.0) (2021-06-10)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.18](https://github.com/midwayjs/midway/compare/v2.10.17...v2.10.18) (2021-05-26)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.14](https://github.com/midwayjs/midway/compare/v2.10.13...v2.10.14) (2021-05-11)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.13](https://github.com/midwayjs/midway/compare/v2.10.12...v2.10.13) (2021-05-08)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.12](https://github.com/midwayjs/midway/compare/v2.10.11...v2.10.12) (2021-05-07)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.11](https://github.com/midwayjs/midway/compare/v2.10.10...v2.10.11) (2021-04-29)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.10](https://github.com/midwayjs/midway/compare/v2.10.9...v2.10.10) (2021-04-24)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.9](https://github.com/midwayjs/midway/compare/v2.10.8...v2.10.9) (2021-04-21)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.8](https://github.com/midwayjs/midway/compare/v2.10.7...v2.10.8) (2021-04-21)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.7](https://github.com/midwayjs/midway/compare/v2.10.6...v2.10.7) (2021-04-17)
-
-
-### Bug Fixes
-
-* add event name args ([#986](https://github.com/midwayjs/midway/issues/986)) ([bfd8232](https://github.com/midwayjs/midway/commit/bfd82320aee8600d8fa30bd2821a0e68c80fd755))
-* format ([#997](https://github.com/midwayjs/midway/issues/997)) ([456cc14](https://github.com/midwayjs/midway/commit/456cc14513bdb000d1aa3130e9719caf7a8a803f))
-
-
-### Features
-
-* add midway task component ([#995](https://github.com/midwayjs/midway/issues/995)) ([befb81d](https://github.com/midwayjs/midway/commit/befb81dee90f01a20bba2c1835e8685cf85a76e7))
-
-
-
-
-
-## [2.10.6](https://github.com/midwayjs/midway/compare/v2.10.5...v2.10.6) (2021-04-14)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.5](https://github.com/midwayjs/midway/compare/v2.10.4...v2.10.5) (2021-04-13)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.4](https://github.com/midwayjs/midway/compare/v2.10.3...v2.10.4) (2021-04-10)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.3](https://github.com/midwayjs/midway/compare/v2.10.2...v2.10.3) (2021-04-07)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.10.2](https://github.com/midwayjs/midway/compare/v2.10.1...v2.10.2) (2021-04-05)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-# [2.10.0](https://github.com/midwayjs/midway/compare/v2.9.3...v2.10.0) (2021-04-02)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.9.3](https://github.com/midwayjs/midway/compare/v2.9.2...v2.9.3) (2021-03-30)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.9.2](https://github.com/midwayjs/midway/compare/v2.9.1...v2.9.2) (2021-03-27)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.9.1](https://github.com/midwayjs/midway/compare/v2.9.0...v2.9.1) (2021-03-24)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-# [2.9.0](https://github.com/midwayjs/midway/compare/v2.8.13...v2.9.0) (2021-03-22)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.13](https://github.com/midwayjs/midway/compare/v2.8.12...v2.8.13) (2021-03-17)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.11](https://github.com/midwayjs/midway/compare/v2.8.10...v2.8.11) (2021-03-12)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.9](https://github.com/midwayjs/midway/compare/v2.8.8...v2.8.9) (2021-03-08)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.8](https://github.com/midwayjs/midway/compare/v2.8.7...v2.8.8) (2021-03-06)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.7](https://github.com/midwayjs/midway/compare/v2.8.6...v2.8.7) (2021-03-04)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.6](https://github.com/midwayjs/midway/compare/v2.8.5...v2.8.6) (2021-03-03)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.5](https://github.com/midwayjs/midway/compare/v2.8.4...v2.8.5) (2021-03-03)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.4](https://github.com/midwayjs/midway/compare/v2.8.3...v2.8.4) (2021-03-03)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.3](https://github.com/midwayjs/midway/compare/v2.8.2...v2.8.3) (2021-03-01)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.8.2](https://github.com/midwayjs/midway/compare/v2.8.0...v2.8.2) (2021-02-27)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-# [2.8.0](https://github.com/midwayjs/midway/compare/v2.7.7...v2.8.0) (2021-02-24)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.7.7](https://github.com/midwayjs/midway/compare/v2.7.6...v2.7.7) (2021-02-20)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.7.5](https://github.com/midwayjs/midway/compare/v2.7.4...v2.7.5) (2021-02-08)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.7.3](https://github.com/midwayjs/midway/compare/v2.7.2...v2.7.3) (2021-02-02)
-
-
-### Bug Fixes
-
-* egg socket io missing session middleware ([#835](https://github.com/midwayjs/midway/issues/835)) ([6e605a1](https://github.com/midwayjs/midway/commit/6e605a15b64bf51182b393b68d66d0867c571b94))
-
-
-
-
-
-## [2.7.2](https://github.com/midwayjs/midway/compare/v2.7.1...v2.7.2) (2021-01-28)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-## [2.7.1](https://github.com/midwayjs/midway/compare/v2.7.0...v2.7.1) (2021-01-28)
-
-**Note:** Version bump only for package @midwayjs/typegoose
-
-
-
-
-
-# [2.7.0](https://github.com/midwayjs/midway/compare/v2.6.13...v2.7.0) (2021-01-27)
-
-
-### Features
-
-* support entry file in bootstrap ([#819](https://github.com/midwayjs/midway/issues/819)) ([49a5ff6](https://github.com/midwayjs/midway/commit/49a5ff662134bdd42dc3a80738b44a05138f8f7c))