@modern-js/core 1.4.6 → 1.5.0

package/.eslintrc.js

@@ -0,0 +1,10 @@
+module.exports = {
+  root: true,
+  extends: ['@modern-js'],
+  parserOptions: {
+    // the base path used to search for `tsconfig.json`
+    tsconfigRootDir: __dirname,
+    // the relative path to sub-package's `tsconfig.json`
+    project: ['./tsconfig.json'],
+  },
+};

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @modern-js/core
 
+## 1.5.0
+
+### Minor Changes
+
+- 80d8ddfe: feat: add `CliPlugin` type to define new plugin
+
+### Patch Changes
+
+- 80d3cfb7: fix: server.metrics type
+- 42c6b136: feat: support api.setAppContext
+- 4e7dcbd5: fix: server.logger type
+- 9e8bc4ab: fix: server.routes type
+- 0c556e59: fix: tools.less type
+- 2008fdbd: convert two packages server part, support server load plugin itself
+- Updated dependencies [5bf5868d]
+- Updated dependencies [80d8ddfe]
+- Updated dependencies [491145e3]
+  - @modern-js/utils@1.3.5
+  - @modern-js/plugin@1.3.0
+
 ## 1.4.6
 
 ### Patch Changes

package/dist/js/modern/context.js

@@ -4,8 +4,26 @@ import address from 'address';
 export const AppContext = createContext({});
 export const ConfigContext = createContext({});
 export const ResolvedConfigContext = createContext({});
+/**
+ * Set app context.
+ * @param value new app context. It will override previous app context.
+ */
+
+export const setAppContext = value => AppContext.set(value);
+/**
+ * Get app context, including directories, plugins and some static infos.
+ */
+
 export const useAppContext = () => AppContext.use().value;
+/**
+ * Get original content of user config.
+ */
+
 export const useConfigContext = () => ConfigContext.use().value;
+/**
+ * Get normalized content of user config.
+ */
+
 export const useResolvedConfigContext = () => ResolvedConfigContext.use().value;
 export const initAppContext = (appDirectory, plugins, configFile, options) => {
   const {

package/dist/js/modern/index.js

@@ -5,41 +5,23 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
 import path from 'path';
-import { compatRequire, pkgUp, ensureAbsolutePath, logger } from '@modern-js/utils';
-import { createAsyncManager, createAsyncWorkflow, createParallelWorkflow, createAsyncWaterfall } from '@modern-js/plugin';
+import { pkgUp, ensureAbsolutePath, logger } from '@modern-js/utils';
 import { enable } from '@modern-js/plugin/node';
 import { program } from "./utils/commander";
 import { resolveConfig, loadUserConfig } from "./config";
 import { loadPlugins } from "./loadPlugins";
-import { AppContext, ConfigContext, initAppContext, ResolvedConfigContext, useAppContext, useConfigContext, useResolvedConfigContext } from "./context";
+import { AppContext, ConfigContext, initAppContext, ResolvedConfigContext } from "./context";
 import { initWatcher } from "./initWatcher";
 import { loadEnv } from "./loadEnv";
+import { manager } from "./manager";
 export * from "./config";
 export * from '@modern-js/plugin';
-export * from '@modern-js/plugin/node';
+export * from '@modern-js/plugin/node'; // TODO: remove export after refactor all plugins
+
+export { manager, mountHook, usePlugins, createPlugin, registerHook } from "./manager";
+// TODO: remove export after refactor all plugins
+export { AppContext, ConfigContext, ResolvedConfigContext, useAppContext, useConfigContext, useResolvedConfigContext } from "./pluginAPI";
 program.name('modern').usage('<command> [options]').version(process.env.MODERN_JS_VERSION || '0.1.0');
-const hooksMap = {
-  config: createParallelWorkflow(),
-  resolvedConfig: createAsyncWaterfall(),
-  validateSchema: createParallelWorkflow(),
-  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-  prepare: createAsyncWorkflow(),
-  commands: createAsyncWorkflow(),
-  watchFiles: createParallelWorkflow(),
-  fileChange: createAsyncWorkflow(),
-  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-  beforeExit: createAsyncWorkflow(),
-  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-  beforeRestart: createAsyncWorkflow()
-};
-export const manager = createAsyncManager(hooksMap);
-export const {
-  createPlugin,
-  registe: registerHook,
-  useRunner: mountHook
-} = manager;
-export const usePlugins = plugins => plugins.forEach(plugin => manager.usePlugin(compatRequire(require.resolve(plugin))));
-export { AppContext, ResolvedConfigContext, useAppContext, useConfigContext, useResolvedConfigContext, ConfigContext };
 
 const initAppDir = async cwd => {
   if (!cwd) {
@@ -75,8 +57,7 @@ const createCli = () => {
     loadEnv(appDirectory, process.env[`${metaName.toUpperCase()}_ENV`]);
     const loaded = await loadUserConfig(appDirectory, options === null || options === void 0 ? void 0 : options.configFile, options === null || options === void 0 ? void 0 : options.packageJsonConfig);
     const plugins = loadPlugins(appDirectory, loaded.config, {
-      internalPlugins: options === null || options === void 0 ? void 0 : options.plugins,
-      transformPlugin: options === null || options === void 0 ? void 0 : options.transformPlugin
+      internalPlugins: options === null || options === void 0 ? void 0 : options.plugins
     });
     plugins.forEach(plugin => plugin.cli && manager.usePlugin(plugin.cli));
     const appContext = initAppContext(appDirectory, plugins, loaded.filePath, options === null || options === void 0 ? void 0 : options.options);

package/dist/js/modern/loadPlugins.js

@@ -5,6 +5,7 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
 import { isDepExists, createDebugger, compatRequire, INTERNAL_PLUGINS } from '@modern-js/utils';
+import { createPlugin } from "./manager";
 const debug = createDebugger('load-plugins');
 
 /**
@@ -51,14 +52,12 @@ export function getAppPlugins(appDirectory, pluginConfig, internalPlugins) {
  * @param appDirectory - Application root directory.
  * @param userConfig - Resolved user config.
  * @param options.internalPlugins - Internal plugins.
- * @param options.transformPlugin - transform plugin before using it.
  * @returns Plugin Objects has been required.
  */
 
 export const loadPlugins = (appDirectory, userConfig, options = {}) => {
   const {
-    internalPlugins,
-    transformPlugin
+    internalPlugins
   } = options;
 
   const resolvePlugin = p => {
@@ -67,10 +66,9 @@ export const loadPlugins = (appDirectory, userConfig, options = {}) => {
     let module = compatRequire(path);
     const pluginOptions = Array.isArray(p) ? p[1] : undefined;
 
-    if (transformPlugin) {
-      module = transformPlugin(module, userConfig, pluginOptions);
-    } else {
-      module = typeof module === 'function' ? module(pluginOptions) : module;
+    if (typeof module === 'function') {
+      const plugin = module(pluginOptions);
+      module = createPlugin(plugin.setup, plugin);
     }
 
     return {
@@ -106,10 +104,7 @@ export const loadPlugins = (appDirectory, userConfig, options = {}) => {
 
 
     if (server && typeof server === 'string') {
-      const path = tryResolve(server, appDirectory);
-      loadedPlugin.server = {
-        pluginPath: path
-      };
+      loadedPlugin.server = server;
       loadedPlugin.serverPkg = server;
     }
 

package/dist/js/modern/manager.js

@@ -0,0 +1,28 @@
+import { createAsyncManager, createAsyncWorkflow, createAsyncWaterfall, createParallelWorkflow } from '@modern-js/plugin';
+import { compatRequire } from '@modern-js/utils';
+import { pluginAPI } from "./pluginAPI";
+const baseHooks = {
+  config: createParallelWorkflow(),
+  resolvedConfig: createAsyncWaterfall(),
+  validateSchema: createParallelWorkflow(),
+  prepare: createAsyncWorkflow(),
+  commands: createAsyncWorkflow(),
+  watchFiles: createParallelWorkflow(),
+  fileChange: createAsyncWorkflow(),
+  beforeExit: createAsyncWorkflow(),
+  beforeRestart: createAsyncWorkflow()
+};
+/** All hooks of cli plugin. */
+
+export const manager = createAsyncManager(baseHooks, pluginAPI);
+/** Plugin options of a cli plugin. */
+
+export const {
+  createPlugin,
+  registerHook,
+  useRunner: mountHook
+} = manager;
+export const usePlugins = plugins => plugins.forEach(pluginPath => {
+  const module = compatRequire(require.resolve(pluginPath));
+  manager.usePlugin(module);
+});

package/dist/js/modern/pluginAPI.js

@@ -0,0 +1,11 @@
+import { AppContext, ConfigContext, setAppContext, useAppContext, useConfigContext, ResolvedConfigContext, useResolvedConfigContext } from "./context";
+export const pluginAPI = {
+  setAppContext,
+  useAppContext,
+  useConfigContext,
+  useResolvedConfigContext
+};
+/** all apis for cli plugin */
+
+// TODO: only export types after refactor all plugins
+export { AppContext, ConfigContext, ResolvedConfigContext, useAppContext, useConfigContext, useResolvedConfigContext };

package/dist/js/node/context.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useResolvedConfigContext = exports.useConfigContext = exports.useAppContext = exports.initAppContext = exports.ResolvedConfigContext = exports.ConfigContext = exports.AppContext = void 0;
+exports.useResolvedConfigContext = exports.useConfigContext = exports.useAppContext = exports.setAppContext = exports.initAppContext = exports.ResolvedConfigContext = exports.ConfigContext = exports.AppContext = void 0;
 
 var _path = _interopRequireDefault(require("path"));
 
@@ -18,13 +18,34 @@ exports.AppContext = AppContext;
 const ConfigContext = (0, _plugin.createContext)({});
 exports.ConfigContext = ConfigContext;
 const ResolvedConfigContext = (0, _plugin.createContext)({});
+/**
+ * Set app context.
+ * @param value new app context. It will override previous app context.
+ */
+
 exports.ResolvedConfigContext = ResolvedConfigContext;
 
+const setAppContext = value => AppContext.set(value);
+/**
+ * Get app context, including directories, plugins and some static infos.
+ */
+
+
+exports.setAppContext = setAppContext;
+
 const useAppContext = () => AppContext.use().value;
+/**
+ * Get original content of user config.
+ */
+
 
 exports.useAppContext = useAppContext;
 
 const useConfigContext = () => ConfigContext.use().value;
+/**
+ * Get normalized content of user config.
+ */
+
 
 exports.useConfigContext = useConfigContext;
 

package/dist/js/node/index.js

@@ -4,16 +4,16 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 var _exportNames = {
+  cli: true,
+  initAppDir: true,
+  initAppContext: true,
   manager: true,
-  createPlugin: true,
-  registerHook: true,
   mountHook: true,
   usePlugins: true,
-  cli: true,
-  initAppDir: true,
+  createPlugin: true,
+  registerHook: true,
   AppContext: true,
   ConfigContext: true,
-  initAppContext: true,
   ResolvedConfigContext: true,
   useAppContext: true,
   useConfigContext: true,
@@ -22,46 +22,75 @@ var _exportNames = {
 Object.defineProperty(exports, "AppContext", {
   enumerable: true,
   get: function () {
-    return _context.AppContext;
+    return _pluginAPI.AppContext;
   }
 });
 Object.defineProperty(exports, "ConfigContext", {
   enumerable: true,
   get: function () {
-    return _context.ConfigContext;
+    return _pluginAPI.ConfigContext;
   }
 });
 Object.defineProperty(exports, "ResolvedConfigContext", {
   enumerable: true,
   get: function () {
-    return _context.ResolvedConfigContext;
+    return _pluginAPI.ResolvedConfigContext;
+  }
+});
+exports.cli = void 0;
+Object.defineProperty(exports, "createPlugin", {
+  enumerable: true,
+  get: function () {
+    return _manager.createPlugin;
   }
 });
-exports.createPlugin = exports.cli = void 0;
 Object.defineProperty(exports, "initAppContext", {
   enumerable: true,
   get: function () {
     return _context.initAppContext;
   }
 });
-exports.registerHook = exports.mountHook = exports.manager = exports.initAppDir = void 0;
+exports.initAppDir = void 0;
+Object.defineProperty(exports, "manager", {
+  enumerable: true,
+  get: function () {
+    return _manager.manager;
+  }
+});
+Object.defineProperty(exports, "mountHook", {
+  enumerable: true,
+  get: function () {
+    return _manager.mountHook;
+  }
+});
+Object.defineProperty(exports, "registerHook", {
+  enumerable: true,
+  get: function () {
+    return _manager.registerHook;
+  }
+});
 Object.defineProperty(exports, "useAppContext", {
   enumerable: true,
   get: function () {
-    return _context.useAppContext;
+    return _pluginAPI.useAppContext;
   }
 });
 Object.defineProperty(exports, "useConfigContext", {
   enumerable: true,
   get: function () {
-    return _context.useConfigContext;
+    return _pluginAPI.useConfigContext;
+  }
+});
+Object.defineProperty(exports, "usePlugins", {
+  enumerable: true,
+  get: function () {
+    return _manager.usePlugins;
   }
 });
-exports.usePlugins = void 0;
 Object.defineProperty(exports, "useResolvedConfigContext", {
   enumerable: true,
   get: function () {
-    return _context.useResolvedConfigContext;
+    return _pluginAPI.useResolvedConfigContext;
   }
 });
 
@@ -69,20 +98,6 @@ var _path = _interopRequireDefault(require("path"));
 
 var _utils = require("@modern-js/utils");
 
-var _plugin = require("@modern-js/plugin");
-
-Object.keys(_plugin).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _plugin[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function () {
-      return _plugin[key];
-    }
-  });
-});
-
 var _node = require("@modern-js/plugin/node");
 
 Object.keys(_node).forEach(function (key) {
@@ -121,6 +136,24 @@ var _initWatcher = require("./initWatcher");
 
 var _loadEnv = require("./loadEnv");
 
+var _manager = require("./manager");
+
+var _plugin = require("@modern-js/plugin");
+
+Object.keys(_plugin).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _plugin[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _plugin[key];
+    }
+  });
+});
+
+var _pluginAPI = require("./pluginAPI");
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
@@ -131,35 +164,6 @@ function _defineProperty(obj, key, value) { if (key in obj) { Object.definePrope
 
 _commander.program.name('modern').usage('<command> [options]').version(process.env.MODERN_JS_VERSION || '0.1.0');
 
-const hooksMap = {
-  config: (0, _plugin.createParallelWorkflow)(),
-  resolvedConfig: (0, _plugin.createAsyncWaterfall)(),
-  validateSchema: (0, _plugin.createParallelWorkflow)(),
-  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-  prepare: (0, _plugin.createAsyncWorkflow)(),
-  commands: (0, _plugin.createAsyncWorkflow)(),
-  watchFiles: (0, _plugin.createParallelWorkflow)(),
-  fileChange: (0, _plugin.createAsyncWorkflow)(),
-  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-  beforeExit: (0, _plugin.createAsyncWorkflow)(),
-  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-  beforeRestart: (0, _plugin.createAsyncWorkflow)()
-};
-const manager = (0, _plugin.createAsyncManager)(hooksMap);
-exports.manager = manager;
-const {
-  createPlugin,
-  registe: registerHook,
-  useRunner: mountHook
-} = manager;
-exports.mountHook = mountHook;
-exports.registerHook = registerHook;
-exports.createPlugin = createPlugin;
-
-const usePlugins = plugins => plugins.forEach(plugin => manager.usePlugin((0, _utils.compatRequire)(require.resolve(plugin))));
-
-exports.usePlugins = usePlugins;
-
 const initAppDir = async cwd => {
   if (!cwd) {
     // eslint-disable-next-line no-param-reassign
@@ -189,24 +193,27 @@ const createCli = () => {
     var _options$options$meta, _options$options;
 
     (0, _node.enable)();
-    manager.clear();
+
+    _manager.manager.clear();
+
     restartOptions = options;
     const appDirectory = await initAppDir();
     const metaName = (_options$options$meta = options === null || options === void 0 ? void 0 : (_options$options = options.options) === null || _options$options === void 0 ? void 0 : _options$options.metaName) !== null && _options$options$meta !== void 0 ? _options$options$meta : 'MODERN';
     (0, _loadEnv.loadEnv)(appDirectory, process.env[`${metaName.toUpperCase()}_ENV`]);
     const loaded = await (0, _config.loadUserConfig)(appDirectory, options === null || options === void 0 ? void 0 : options.configFile, options === null || options === void 0 ? void 0 : options.packageJsonConfig);
     const plugins = (0, _loadPlugins.loadPlugins)(appDirectory, loaded.config, {
-      internalPlugins: options === null || options === void 0 ? void 0 : options.plugins,
-      transformPlugin: options === null || options === void 0 ? void 0 : options.transformPlugin
+      internalPlugins: options === null || options === void 0 ? void 0 : options.plugins
     });
-    plugins.forEach(plugin => plugin.cli && manager.usePlugin(plugin.cli));
+    plugins.forEach(plugin => plugin.cli && _manager.manager.usePlugin(plugin.cli));
     const appContext = (0, _context.initAppContext)(appDirectory, plugins, loaded.filePath, options === null || options === void 0 ? void 0 : options.options);
-    manager.run(() => {
+
+    _manager.manager.run(() => {
       _context.ConfigContext.set(loaded.config);
 
       _context.AppContext.set(appContext);
     });
-    hooksRunner = await manager.init();
+
+    hooksRunner = await _manager.manager.init();
     ['SIGINT', 'SIGTERM', 'unhandledRejection', 'uncaughtException'].forEach(event => {
       process.on(event, async err => {
         await hooksRunner.beforeExit();
@@ -230,7 +237,7 @@ const createCli = () => {
       resolved: config
     }); // update context value
 
-    manager.run(() => {
+    _manager.manager.run(() => {
       _context.ConfigContext.set(loaded.config);
 
       _context.ResolvedConfigContext.set(resolved);
@@ -240,6 +247,7 @@ const createCli = () => {
         distDirectory: (0, _utils.ensureAbsolutePath)(appDirectory, resolved.output.path)
       }));
     });
+
     await hooksRunner.prepare();
     return {
       loadedConfig: loaded,
@@ -258,7 +266,8 @@ const createCli = () => {
       program: _commander.program
     });
     (0, _initWatcher.initWatcher)(loadedConfig, appContext.appDirectory, resolved.source.configDir, hooksRunner, argv);
-    manager.run(() => _commander.program.parse(process.argv));
+
+    _manager.manager.run(() => _commander.program.parse(process.argv));
   }
 
   async function restart() {
@@ -270,7 +279,9 @@ const createCli = () => {
     _utils.logger.info('Restart...\n');
 
     let hasGetError = false;
-    const runner = manager.useRunner();
+
+    const runner = _manager.manager.useRunner();
+
     await runner.beforeRestart();
 
     try {
@@ -280,7 +291,7 @@ const createCli = () => {
       hasGetError = true;
     } finally {
       if (!hasGetError) {
-        manager.run(() => _commander.program.parse(process.argv));
+        _manager.manager.run(() => _commander.program.parse(process.argv));
       }
     }
   }

package/dist/js/node/loadPlugins.js

@@ -8,6 +8,8 @@ exports.loadPlugins = void 0;
 
 var _utils = require("@modern-js/utils");
 
+var _manager = require("./manager");
+
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
@@ -60,15 +62,13 @@ function getAppPlugins(appDirectory, pluginConfig, internalPlugins) {
  * @param appDirectory - Application root directory.
  * @param userConfig - Resolved user config.
  * @param options.internalPlugins - Internal plugins.
- * @param options.transformPlugin - transform plugin before using it.
  * @returns Plugin Objects has been required.
  */
 
 
 const loadPlugins = (appDirectory, userConfig, options = {}) => {
   const {
-    internalPlugins,
-    transformPlugin
+    internalPlugins
   } = options;
 
   const resolvePlugin = p => {
@@ -77,10 +77,9 @@ const loadPlugins = (appDirectory, userConfig, options = {}) => {
     let module = (0, _utils.compatRequire)(path);
     const pluginOptions = Array.isArray(p) ? p[1] : undefined;
 
-    if (transformPlugin) {
-      module = transformPlugin(module, userConfig, pluginOptions);
-    } else {
-      module = typeof module === 'function' ? module(pluginOptions) : module;
+    if (typeof module === 'function') {
+      const plugin = module(pluginOptions);
+      module = (0, _manager.createPlugin)(plugin.setup, plugin);
     }
 
     return {
@@ -116,10 +115,7 @@ const loadPlugins = (appDirectory, userConfig, options = {}) => {
 
 
     if (server && typeof server === 'string') {
-      const path = tryResolve(server, appDirectory);
-      loadedPlugin.server = {
-        pluginPath: path
-      };
+      loadedPlugin.server = server;
       loadedPlugin.serverPkg = server;
     }
 

package/dist/js/node/manager.js

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.usePlugins = exports.registerHook = exports.mountHook = exports.manager = exports.createPlugin = void 0;
+
+var _plugin = require("@modern-js/plugin");
+
+var _utils = require("@modern-js/utils");
+
+var _pluginAPI = require("./pluginAPI");
+
+const baseHooks = {
+  config: (0, _plugin.createParallelWorkflow)(),
+  resolvedConfig: (0, _plugin.createAsyncWaterfall)(),
+  validateSchema: (0, _plugin.createParallelWorkflow)(),
+  prepare: (0, _plugin.createAsyncWorkflow)(),
+  commands: (0, _plugin.createAsyncWorkflow)(),
+  watchFiles: (0, _plugin.createParallelWorkflow)(),
+  fileChange: (0, _plugin.createAsyncWorkflow)(),
+  beforeExit: (0, _plugin.createAsyncWorkflow)(),
+  beforeRestart: (0, _plugin.createAsyncWorkflow)()
+};
+/** All hooks of cli plugin. */
+
+const manager = (0, _plugin.createAsyncManager)(baseHooks, _pluginAPI.pluginAPI);
+/** Plugin options of a cli plugin. */
+
+exports.manager = manager;
+const {
+  createPlugin,
+  registerHook,
+  useRunner: mountHook
+} = manager;
+exports.mountHook = mountHook;
+exports.registerHook = registerHook;
+exports.createPlugin = createPlugin;
+
+const usePlugins = plugins => plugins.forEach(pluginPath => {
+  const module = (0, _utils.compatRequire)(require.resolve(pluginPath));
+  manager.usePlugin(module);
+});
+
+exports.usePlugins = usePlugins;

package/dist/js/node/pluginAPI.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "AppContext", {
+  enumerable: true,
+  get: function () {
+    return _context.AppContext;
+  }
+});
+Object.defineProperty(exports, "ConfigContext", {
+  enumerable: true,
+  get: function () {
+    return _context.ConfigContext;
+  }
+});
+Object.defineProperty(exports, "ResolvedConfigContext", {
+  enumerable: true,
+  get: function () {
+    return _context.ResolvedConfigContext;
+  }
+});
+exports.pluginAPI = void 0;
+Object.defineProperty(exports, "useAppContext", {
+  enumerable: true,
+  get: function () {
+    return _context.useAppContext;
+  }
+});
+Object.defineProperty(exports, "useConfigContext", {
+  enumerable: true,
+  get: function () {
+    return _context.useConfigContext;
+  }
+});
+Object.defineProperty(exports, "useResolvedConfigContext", {
+  enumerable: true,
+  get: function () {
+    return _context.useResolvedConfigContext;
+  }
+});
+
+var _context = require("./context");
+
+const pluginAPI = {
+  setAppContext: _context.setAppContext,
+  useAppContext: _context.useAppContext,
+  useConfigContext: _context.useConfigContext,
+  useResolvedConfigContext: _context.useResolvedConfigContext
+};
+/** all apis for cli plugin */
+
+exports.pluginAPI = pluginAPI;

package/dist/types/config/index.d.ts

@@ -65,7 +65,7 @@ interface OutputConfig {
   enableTsLoader?: boolean;
 }
 interface ServerConfig {
-  routes?: Record<string, string | {
+  routes?: Record<string, string | string[] | {
     route: string | string[];
     disableSpa?: boolean;
   }>;
@@ -76,8 +76,8 @@ interface ServerConfig {
   ssrByEntries?: Record<string, boolean | Record<string, unknown>>;
   baseUrl?: string | Array<string>;
   port?: number;
-  logger?: Record<string, any>;
-  metrics?: Record<string, any>;
+  logger?: boolean | Record<string, any>;
+  metrics?: boolean | Record<string, any>;
   enableMicroFrontendDebug?: boolean;
 }
 interface DevConfig {

package/dist/types/context.d.ts

@@ -6,8 +6,26 @@ export type { IAppContext };
 export declare const AppContext: import("@modern-js/plugin").Context<IAppContext>;
 export declare const ConfigContext: import("@modern-js/plugin").Context<UserConfig>;
 export declare const ResolvedConfigContext: import("@modern-js/plugin").Context<NormalizedConfig>;
+/**
+ * Set app context.
+ * @param value new app context. It will override previous app context.
+ */
+
+export declare const setAppContext: (value: IAppContext) => void;
+/**
+ * Get app context, including directories, plugins and some static infos.
+ */
+
 export declare const useAppContext: () => IAppContext;
+/**
+ * Get original content of user config.
+ */
+
 export declare const useConfigContext: () => UserConfig;
+/**
+ * Get normalized content of user config.
+ */
+
 export declare const useResolvedConfigContext: () => NormalizedConfig;
 export declare const initAppContext: (appDirectory: string, plugins: Array<LoadedPlugin>, configFile: string | false, options?: {
   metaName?: string | undefined;

package/dist/types/index.d.ts

@@ -1,111 +1,22 @@
 import { INTERNAL_PLUGINS } from '@modern-js/utils';
-import { ParallelWorkflow, AsyncWorkflow, Progresses2Runners, AsyncWaterfall } from '@modern-js/plugin';
 import type { Hooks } from '@modern-js/types';
 import { ErrorObject } from 'ajv';
-import { Command } from './utils/commander';
-import { TransformPlugin } from './loadPlugins';
-import { AppContext, ConfigContext, IAppContext, initAppContext, ResolvedConfigContext, useAppContext, useConfigContext, useResolvedConfigContext } from './context';
-import { NormalizedConfig } from './config/mergeConfig';
+import { IAppContext, initAppContext } from './context';
+import type { NormalizedConfig } from './config/mergeConfig';
 export type { Hooks };
 export * from './config';
 export * from '@modern-js/plugin';
 export * from '@modern-js/plugin/node';
-export declare type HooksRunner = Progresses2Runners<{
-  config: ParallelWorkflow<void>;
-  resolvedConfig: AsyncWaterfall<{
-    resolved: NormalizedConfig;
-  }>;
-  validateSchema: ParallelWorkflow<void>;
-  prepare: AsyncWorkflow<void, void>;
-  commands: AsyncWorkflow<{
-    program: Command;
-  }, void>;
-  watchFiles: ParallelWorkflow<void>;
-  fileChange: AsyncWorkflow<{
-    filename: string;
-    eventType: 'add' | 'change' | 'unlink';
-  }, void>;
-  beforeExit: AsyncWorkflow<void, void>;
-}>;
-export declare const manager: import("@modern-js/plugin").AsyncManager<Hooks, {
-  config: ParallelWorkflow<void, unknown>;
-  resolvedConfig: AsyncWaterfall<{
-    resolved: NormalizedConfig;
-  }>;
-  validateSchema: ParallelWorkflow<void, unknown>;
-  prepare: AsyncWorkflow<void, void>;
-  commands: AsyncWorkflow<{
-    program: Command;
-  }, void>;
-  watchFiles: ParallelWorkflow<void, unknown>;
-  fileChange: AsyncWorkflow<{
-    filename: string;
-    eventType: 'add' | 'change' | 'unlink';
-  }, void>;
-  beforeExit: AsyncWorkflow<void, void>;
-  beforeRestart: AsyncWorkflow<void, void>;
-}>;
-export declare const createPlugin: (initializer: import("@modern-js/plugin").AsyncInitializer<Partial<import("@modern-js/plugin").Progresses2Threads<{
-  config: ParallelWorkflow<void, unknown>;
-  resolvedConfig: AsyncWaterfall<{
-    resolved: NormalizedConfig;
-  }>;
-  validateSchema: ParallelWorkflow<void, unknown>;
-  prepare: AsyncWorkflow<void, void>;
-  commands: AsyncWorkflow<{
-    program: Command;
-  }, void>;
-  watchFiles: ParallelWorkflow<void, unknown>;
-  fileChange: AsyncWorkflow<{
-    filename: string;
-    eventType: 'add' | 'change' | 'unlink';
-  }, void>;
-  beforeExit: AsyncWorkflow<void, void>;
-  beforeRestart: AsyncWorkflow<void, void>;
-} & import("@modern-js/plugin").ClearDraftProgress<Hooks>>>>, options?: import("@modern-js/plugin").PluginOptions | undefined) => import("@modern-js/plugin").AsyncPlugin<Partial<import("@modern-js/plugin").Progresses2Threads<{
-  config: ParallelWorkflow<void, unknown>;
-  resolvedConfig: AsyncWaterfall<{
-    resolved: NormalizedConfig;
-  }>;
-  validateSchema: ParallelWorkflow<void, unknown>;
-  prepare: AsyncWorkflow<void, void>;
-  commands: AsyncWorkflow<{
-    program: Command;
-  }, void>;
-  watchFiles: ParallelWorkflow<void, unknown>;
-  fileChange: AsyncWorkflow<{
-    filename: string;
-    eventType: 'add' | 'change' | 'unlink';
-  }, void>;
-  beforeExit: AsyncWorkflow<void, void>;
-  beforeRestart: AsyncWorkflow<void, void>;
-} & import("@modern-js/plugin").ClearDraftProgress<Hooks>>>>, registerHook: (newShape: Partial<Hooks>) => void, mountHook: () => Progresses2Runners<{
-  config: ParallelWorkflow<void, unknown>;
-  resolvedConfig: AsyncWaterfall<{
-    resolved: NormalizedConfig;
-  }>;
-  validateSchema: ParallelWorkflow<void, unknown>;
-  prepare: AsyncWorkflow<void, void>;
-  commands: AsyncWorkflow<{
-    program: Command;
-  }, void>;
-  watchFiles: ParallelWorkflow<void, unknown>;
-  fileChange: AsyncWorkflow<{
-    filename: string;
-    eventType: 'add' | 'change' | 'unlink';
-  }, void>;
-  beforeExit: AsyncWorkflow<void, void>;
-  beforeRestart: AsyncWorkflow<void, void>;
-} & import("@modern-js/plugin").ClearDraftProgress<Hooks>>;
-export declare const usePlugins: (plugins: string[]) => void;
-export { AppContext, ResolvedConfigContext, useAppContext, useConfigContext, useResolvedConfigContext, ConfigContext };
+export { manager, mountHook, usePlugins, createPlugin, registerHook } from './manager';
+export type { CliHooks, CliPlugin, CliHookCallbacks } from './manager';
+export { AppContext, ConfigContext, ResolvedConfigContext, useAppContext, useConfigContext, useResolvedConfigContext } from './pluginAPI';
+export type { PluginAPI } from './pluginAPI';
 export type { NormalizedConfig, IAppContext };
 declare const initAppDir: (cwd?: string | undefined) => Promise<string>;
 export interface CoreOptions {
   configFile?: string;
   packageJsonConfig?: string;
   plugins?: typeof INTERNAL_PLUGINS;
-  transformPlugin?: TransformPlugin;
   onSchemaError?: (error: ErrorObject) => void;
   options?: {
     metaName?: string;

package/dist/types/initWatcher.d.ts

@@ -1,4 +1,4 @@
 import chokidar from 'chokidar';
 import { LoadedConfig } from './config';
-import { HooksRunner } from '.';
+import { HooksRunner } from './manager';
 export declare const initWatcher: (loaded: LoadedConfig, appDirectory: string, configDir: string | undefined, hooksRunner: HooksRunner, argv: string[]) => Promise<chokidar.FSWatcher | undefined>;

package/dist/types/loadPlugins.d.ts

@@ -12,19 +12,16 @@ export declare type PluginConfigItem = {
   server?: Plugin;
 } | Plugin;
 export declare type PluginConfig = Array<PluginConfigItem>;
-export declare type TransformPlugin = (plugin: PluginConfig, resolvedConfig: UserConfig, pluginOptions?: any) => PluginConfig;
 export declare function getAppPlugins(appDirectory: string, pluginConfig: PluginConfig, internalPlugins?: typeof INTERNAL_PLUGINS): PluginConfigItem[];
 /**
  * Load internal plugins which in @modern-js scope and user's custom plugins.
  * @param appDirectory - Application root directory.
  * @param userConfig - Resolved user config.
  * @param options.internalPlugins - Internal plugins.
- * @param options.transformPlugin - transform plugin before using it.
  * @returns Plugin Objects has been required.
  */
 
 export declare const loadPlugins: (appDirectory: string, userConfig: UserConfig, options?: {
   internalPlugins?: typeof INTERNAL_PLUGINS;
-  transformPlugin?: TransformPlugin;
 }) => LoadedPlugin[];
 export {};

package/dist/types/manager.d.ts

@@ -0,0 +1,74 @@
+import { ToThreads, ToRunners, AsyncSetup, PluginOptions, AsyncWorkflow, AsyncWaterfall, ParallelWorkflow } from '@modern-js/plugin';
+import type { Hooks } from '@modern-js/types';
+import type { Command } from './utils/commander';
+import type { NormalizedConfig } from './config/mergeConfig';
+import { pluginAPI } from './pluginAPI';
+export declare type HooksRunner = ToRunners<{
+  config: ParallelWorkflow<void>;
+  resolvedConfig: AsyncWaterfall<{
+    resolved: NormalizedConfig;
+  }>;
+  validateSchema: ParallelWorkflow<void>;
+  prepare: AsyncWorkflow<void, void>;
+  commands: AsyncWorkflow<{
+    program: Command;
+  }, void>;
+  watchFiles: ParallelWorkflow<void>;
+  fileChange: AsyncWorkflow<{
+    filename: string;
+    eventType: 'add' | 'change' | 'unlink';
+  }, void>;
+  beforeExit: AsyncWorkflow<void, void>;
+  beforeRestart: AsyncWorkflow<void, void>;
+}>;
+declare const baseHooks: {
+  config: ParallelWorkflow<void, unknown>;
+  resolvedConfig: AsyncWaterfall<{
+    resolved: NormalizedConfig;
+  }>;
+  validateSchema: ParallelWorkflow<void, unknown>;
+  prepare: AsyncWorkflow<void, void>;
+  commands: AsyncWorkflow<{
+    program: Command;
+  }, void>;
+  watchFiles: ParallelWorkflow<void, unknown>;
+  fileChange: AsyncWorkflow<{
+    filename: string;
+    eventType: 'add' | 'change' | 'unlink';
+  }, void>;
+  beforeExit: AsyncWorkflow<void, void>;
+  beforeRestart: AsyncWorkflow<void, void>;
+};
+/** All hooks of cli plugin. */
+
+export declare type CliHooks = typeof baseHooks & Hooks;
+/** All hook callbacks of cli plugin. */
+
+export declare type CliHookCallbacks = ToThreads<CliHooks>;
+export declare const manager: import("@modern-js/plugin").AsyncManager<CliHooks, {
+  setAppContext: (value: import("@modern-js/types").IAppContext) => void;
+  useAppContext: () => import("@modern-js/types").IAppContext;
+  useConfigContext: () => import("./config").UserConfig;
+  useResolvedConfigContext: () => NormalizedConfig;
+}>;
+/** Plugin options of a cli plugin. */
+
+export declare type CliPlugin = PluginOptions<CliHooks, AsyncSetup<CliHooks, typeof pluginAPI>>;
+export declare const createPlugin: (setup?: AsyncSetup<CliHooks, {
+  setAppContext: (value: import("@modern-js/types").IAppContext) => void;
+  useAppContext: () => import("@modern-js/types").IAppContext;
+  useConfigContext: () => import("./config").UserConfig;
+  useResolvedConfigContext: () => NormalizedConfig;
+}> | undefined, options?: PluginOptions<CliHooks, AsyncSetup<CliHooks, {
+  setAppContext: (value: import("@modern-js/types").IAppContext) => void;
+  useAppContext: () => import("@modern-js/types").IAppContext;
+  useConfigContext: () => import("./config").UserConfig;
+  useResolvedConfigContext: () => NormalizedConfig;
+}>> | undefined) => import("@modern-js/plugin").AsyncPlugin<CliHooks, {
+  setAppContext: (value: import("@modern-js/types").IAppContext) => void;
+  useAppContext: () => import("@modern-js/types").IAppContext;
+  useConfigContext: () => import("./config").UserConfig;
+  useResolvedConfigContext: () => NormalizedConfig;
+}>, registerHook: (newHooks: Partial<CliHooks>) => void, mountHook: () => ToRunners<CliHooks>;
+export declare const usePlugins: (plugins: string[]) => void;
+export {};

package/dist/types/pluginAPI.d.ts

@@ -0,0 +1,13 @@
+import type { CommonAPI } from '@modern-js/plugin';
+import type { CliHooks } from './manager';
+import { AppContext, ConfigContext, useAppContext, useConfigContext, ResolvedConfigContext, useResolvedConfigContext } from './context';
+export declare const pluginAPI: {
+  setAppContext: (value: import("@modern-js/types/cli").IAppContext) => void;
+  useAppContext: () => import("@modern-js/types/cli").IAppContext;
+  useConfigContext: () => import("./config").UserConfig;
+  useResolvedConfigContext: () => import(".").NormalizedConfig;
+};
+/** all apis for cli plugin */
+
+export declare type PluginAPI = typeof pluginAPI & CommonAPI<CliHooks>;
+export { AppContext, ConfigContext, ResolvedConfigContext, useAppContext, useConfigContext, useResolvedConfigContext };

package/package.json

@@ -11,7 +11,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "1.4.6",
+  "version": "1.5.0",
   "jsnext:source": "./src/index.ts",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/js/node/index.js",
@@ -43,8 +43,8 @@
     "@babel/code-frame": "^7.14.5",
     "@babel/runtime": "^7",
     "@modern-js/load-config": "^1.2.2",
-    "@modern-js/plugin": "^1.2.1",
-    "@modern-js/utils": "^1.3.4",
+    "@modern-js/plugin": "^1.3.0",
+    "@modern-js/utils": "^1.3.5",
     "address": "^1.1.2",
     "ajv": "^8.6.2",
     "ajv-keywords": "^5.0.0",
@@ -61,7 +61,7 @@
   "devDependencies": {
     "btsm": "2.2.2",
     "@types/babel__code-frame": "^7.0.3",
-    "@modern-js/types": "^1.3.4",
+    "@modern-js/types": "^1.3.5",
     "@types/jest": "^26",
     "@types/lodash.clonedeep": "^4.5.6",
     "@types/lodash.mergewith": "^4.6.6",

package/tests/loadPlugin.test.ts

@@ -38,9 +38,7 @@ describe('load plugins', () => {
         cliPkg: path.join(fixture, './test-plugin-a.js'),
       },
       {
-        server: {
-          pluginPath: path.join(fixture, './test-plugin-b.js'),
-        },
+        server: './test-plugin-b',
         serverPkg: './test-plugin-b',
       },
     ]);
@@ -56,22 +54,8 @@ describe('load plugins', () => {
       plugins: [{ cli: ['./test-plugin-c', 'c'] }, ['./test-plugin-c', 'c2']],
     });
 
-    expect(plugins).toEqual([
-      {
-        cli: {
-          name: 'c',
-          pluginPath: path.join(fixture, './test-plugin-c.js'),
-        },
-        cliPkg: './test-plugin-c',
-      },
-      {
-        cli: {
-          name: 'c2',
-          pluginPath: path.join(fixture, './test-plugin-c.js'),
-        },
-        cliPkg: './test-plugin-c',
-      },
-    ]);
+    expect(plugins[0].cli.name).toEqual('c');
+    expect(plugins[1].cli.name).toEqual('c2');
   });
 
   test('should load user string plugin successfully', () => {
@@ -95,26 +79,6 @@ describe('load plugins', () => {
     ]);
   });
 
-  test('should call transformPlugin', () => {
-    const fixture = path.resolve(
-      __dirname,
-      './fixtures/load-plugin/user-plugins',
-    );
-
-    const options = {
-      transformPlugin: jest.fn(),
-    };
-    options.transformPlugin.mockImplementation((plugins, _) => plugins);
-
-    loadPlugins(
-      fixture,
-      { plugins: [{ cli: path.join(fixture, './test-plugin-a.js') }] },
-      options,
-    );
-
-    expect(options.transformPlugin).toHaveBeenCalled();
-  });
-
   test(`should throw error when plugin not found `, () => {
     const fixture = path.resolve(__dirname, './fixtures/load-plugin/not-found');
 

package/tests/pluginAPI.test.ts

@@ -0,0 +1,19 @@
+import { CliPlugin, manager } from '../src';
+
+describe('pluginAPI', () => {
+  it('api.setAppContext', done => {
+    const plugin = (): CliPlugin => ({
+      setup(api) {
+        api.setAppContext({
+          ...api.useAppContext(),
+          packageName: 'foo',
+        });
+
+        expect(api.useAppContext().packageName).toEqual('foo');
+        done();
+      },
+    });
+
+    manager.clone().usePlugin(plugin).init();
+  });
+});