@modern-js/main-doc 2.1.0 → 2.2.0

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/introduce.md

@@ -1,38 +0,0 @@
----
-sidebar_position: 1
----
-
-# Introduction
-
-The file operation API can be used in the `onForged` time to live function, which can add, delete and change the current project file.
-
-File operation API related path to fill in the project relative path, generator plugin will automatically add the current project path prefix.
-
-## File type
-
-The generator plugin divides file types into the following categories:
-
-- Text files: plain text content files, files that can be templated using handlebars.
-
-- Binary files: pictures, audio, video and other files.
-
-:::warning
-The jsx or tsx file using the variable is a binary file, and its syntax conflicts with handlebars render, which will cause the template file failed to create.
-:::
-
-- JSON files: Files in JSON format, such as `package.json`, `tsconfig.json`.
-
-- Text List File: A file consisting of lines of text, such as `.gitignore`, `.editorconfig`, `.npmrc`.
-
-The file manipulation API for the generator plugin will operate on these four file types.
-
-Its type is defined as:
-
-```ts
-export enum FileType {
-  Text = 'text',
-  Binary = 'binary',
-  Json = 'json',
-  TextRaw = 'textRaw',
-}
-```

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/updateJSONFile.md

@@ -1,53 +0,0 @@
----
-sidebar_position: 6
----
-
-# updateJSONFile
-
-Update the JSON file fields.
-
-This method is suitable for JSON file types, and can batch update field values in JSON files.
-
-This method is available on the `onForged` time to live API parameter.
-
-Its type is defined as:
-
-```ts
-export type ForgedAPI = {
-  updateJSONFile: (
-    fileName: string,
-    updateInfo: Record<string, unknown>,
-  ) => Promise<void>;
-  ...
-};
-```
-
-## fileName
-
-The filename or file path of the JSON file.
-
-## updateInfo
-
-Field update information.
-
-This information is represented in Record form.
-
-For example, the name field needs to be updated:
-
-```ts
-api.updateJSONFile(file, {
-  name: 'new name',
-});
-```
-
-Nested fields need to be updated:
-
-```ts
-api.updateJSONFile(file, {
-  'dependencies.name': 'new name',
-});
-```
-
-:::warning
-Pay attention to the field name when updating the nested field. If it is not a total volume update, the nested key should also be written into the field name.
-:::

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/file/updateModernConfig.md

@@ -1,26 +0,0 @@
----
-sidebar_position: 8
----
-
-# updateModernConfig
-
-Update the `modernConfig` field in `package.json`.
-
-This method is available on the `onForged` time to live API parameter.
-
-Its type is defined as:
-
-```ts
-export type ForgedAPI = {
-  updateModernConfig: (updateInfo: Record<string, any>) => Promise<void>;
-  ...
-};
-```
-
-## updateInfo
-
-Field update information.
-
-:::info
-This function is the package of updateJSONFile, which will automatically update the `modernConfig` field of `package.json`. Just fill in the update information relative to `modernConfig` in the updateInfo.
-:::

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/hook/afterForged.md

@@ -1,35 +0,0 @@
----
-sidebar_position: 2
----
-
-# AfterForged
-
-`afterForged` function is the generator plugin time to live function, which is usually used to define operations such as installation dependency and Git. Professional operations will be performed after the onForged function is executed.
-
-The method is available directly on the context.
-
-Its type is defined as:
-
-```ts
-export type PluginAfterForgedFunc = (
-  api: AfterForgedAPI,
-  inputData: Record<string, unknown>,
-) => Promise<void>;
-
-export interface IPluginContext {
-  afterForged: (func: PluginAfterForgedFunc) => void;
-  ...
-}
-```
-
-## func
-
-The onForged parameter is a callback function, and the function parameters are `api` and `inputData`.
-
-### api
-
-A list of supported functions in `afterForged` time to live, specifically viewabl [Git API](/docs/guides/topic-detail/generator/plugin/api/git/isInGitRepo) 和 [NPM API](/docs/guides/topic-detail/generator/plugin/api/npm/install).
-
-### inputData
-
-Current user input, the user can be used to obtain the current input information and configuration information.

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/addInputAfter.md

@@ -1,54 +0,0 @@
----
-sidebar_position: 3
----
-
-# addInputAfter
-
-Add input question after default input.
-
-The method is available directly on the context.
-
-Its type is defined as:
-
-```ts
-export interface IPluginContext {
-  addInputAfter: (key: string, input: Schema) => void;
-  ...
-}
-```
-
-## key
-
-Modern.js the problem keyword of the configuration of the engineering solution, the specific configuration viewable [Generator Configuration](/docs/guides/topic-detail/generator/config/common).
-
-## input
-
-Questions that need to be added, specific type definition viewable [Customize input related type definition](/docs/guides/topic-detail/generator/plugin/api/input/type).
-
-## Example
-
-Add input after package management tool:
-
-```ts
-context.addInputAfter('packageManager', {
-  type: 'object',
-  properties: {
-    language: {
-      type: 'string',
-      title: 'Develop Language',
-      enum: [
-        { label: 'TS', value: 'ts' },
-        { label: 'ES6+', value: 'js' },
-      ],
-    },
-  },
-});
-```
-
-:::info Notes
-1. The key of the added question cannot be duplicated with the key of the question of the item type itself provided by the Modern.js.
-
-2. The priority of adding the problem `addInputAfter` is higher than `addInputBefore`. When adding After problem to one `key` and Before problem to the next key at the same time, After problem will be before Before.
-
-3. When multiple questions need to be added before or after the same `key`, the method can be called multiple times, and the order of questions will be permutated in the order in which they are called.
-:::

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/addInputBefore.md

@@ -1,54 +0,0 @@
----
-sidebar_position: 2
----
-
-# addInputBefore
-
-Add input question before default input.
-
-The method is available directly on the context.
-
-Its type is defined as:
-
-```ts
-export interface IPluginContext {
-  addInputBefore: (key: string, input: Schema) => void;
-  ...
-}
-```
-
-## key
-
-Modern.js the problem keyword of the configuration of the engineering solution, the specific configuration viewable [Generator Configuration](/docs/guides/topic-detail/generator/config/common).
-
-## input
-
-Questions that need to be added, specific type definition viewable [Customize input related type definition](/docs/guides/topic-detail/generator/plugin/api/input/type).
-
-## Example
-
-Add input before package management tool:
-
-```ts
-context.addInputBefore('packageManager', {
-  type: 'object',
-  properties: {
-    language: {
-      type: 'string',
-      title: 'Develop Langauge',
-      enum: [
-        { label: 'TS', value: 'ts' },
-        { label: 'ES6+', value: 'js' },
-      ],
-    },
-  },
-});
-```
-
-:::info Notes
-1. The key of the added question cannot be duplicated with the key of the question of the item type itself provided by the Modern.js.
-
-2. The priority of adding the problem `addInputAfter` is higher than `addInputBefore`. When adding After problem to one `key` and Before problem to the next key at the same time, After problem will be before Before.
-
-3. When multiple questions need to be added before or after the same `key`, the method can be called multiple times, and the order of questions will be permutated in the order in which they are called.
-:::

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/setInput.md

@@ -1,42 +0,0 @@
----
-sidebar_position: 4
----
-
-# setInput
-
-Set the problem attribute.
-
-The method is available directly on the context.
-
-Its type is defined as:
-
-```ts
-export interface IPluginContext {
-  setInput: (key: string, field: string, value: unknown) => void;
-  ...
-}
-```
-
-## key
-
-The problem keyword can be the problem keyword of the Modern.js project solution, or the keyword of the new problem in the generator plugin.
-
-## filed
-
-he problem field to be set, you can modify other fields except the key of the current Input, Input specific type definition viewable [Customize input related type definition](/docs/guides/topic-detail/generator/plugin/api/input/type).
-
-## value
-
-The value of the problem field to be setted. value supports function, the function parameter is the current field value, and the return value needs to be the complete new field value.
-
-:::info
-For the input options provided by the Modern.js project type, only delete is temporarily supported, and increase is not supported. The increase will cause problems in the logical judgment in the code.
-:::
-
-## Example
-
-Modify the display name of `packageName`:
-
-```ts
-context.setInput('packageName', 'title', 'Show title');
-```

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/input/setInputValue.md

@@ -1,30 +0,0 @@
----
-sidebar_position: 7
----
-
-# setInputValue
-
-Sets the input default value.
-
-The method is available directly on the context.
-
-Its type is defined as:
-
-```ts
-export interface IPluginContext {
-    setInputValue: (value: Record<string, unknown>) => void;
-  ...
-}
-```
-
-## Example
-
-```ts
-context.setInputValue({
-  moduleRunWay: 'no',
-});
-```
-
-:::warning
-This method only supports setting the configuration parameter value corresponding to the project solution integrated by the generator plugin, and does not support setting the project solution type (solution) and project scene (scenes). These two configurations can be set by the `--config` parameter at execution default value.
-:::

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/createElement.md

@@ -1,33 +0,0 @@
----
-sidebar_position: 2
----
-
-# createElement
-
-Create engineering elements that only support application engineering solutions.
-
-This method is available on the `onForged` API parameter.
-
-Its type is defined as:
-
-```ts
-export enum ActionElement {
-  Entry = 'entry',
-  Server = 'server',
-}
-export type ForgedAPI = {
-  createElement: (
-    element: ActionElement,
-    params: Record<string, unknown>,
-  ) => Promise<void>;
-  ...
-};
-```
-
-## element
-
-Project element type, supports entry and server.
-
-## params
-
-For other parameters of creating elements, please refer to[MWA New Command](/docs/guides/topic-detail/generator/config/mwa).

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/createSubProject.md

@@ -1,35 +0,0 @@
----
-sidebar_position: 4
----
-
-# createSubProject
-
-Create subprojects and only support Monorepo engineering solutions.
-
-This method is available on the `onForged` API parameter.
-
-Its type is defined as:
-
-```ts
-export enum SubSolution {
-  MWA = 'mwa',
-  MWATest = 'mwa_test',
-  Module = 'module',
-  InnerModule = 'inner_module',
-}
-export type ForgedAPI = {
-  createSubProject: (
-    solution: SubSolution,
-    params: Record<string, unknown>,
-  ) => Promise<void>;
-  ...
-};
-```
-
-## solution
-
-Sub-project engineering solution name.
-
-## params
-
-For other parameters of creating subprojects, please refer to[Monorepo Create Sub Project](/docs/guides/topic-detail/generator/config/monorepo).

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/enableFunc.md

@@ -1,44 +0,0 @@
----
-sidebar_position: 3
----
-
-# enableFunc
-
-Enable functionality to support application and module engineering scenarios.
-
-This method is available on the `onForged` API parameter.
-
-Its type is defined as:
-
-```ts
-export enum ActionFunction {
-  UnBundle = 'unbundle',
-  TailwindCSS = 'tailwindcss',
-  BFF = 'bff',
-  MicroFrontend = 'micro_frontend',
-  I18n = 'i18n',
-  Test = 'test',
-  E2ETest = 'e2e_test',
-  Doc = 'doc',
-  Storybook = 'storybook',
-  RuntimeApi = 'runtimeApi',
-  SSG = 'ssg',
-  Polyfill = 'polyfill',
-  Deploy = 'deploy',
-}
-export type ForgedAPI = {
-  enableFunc: (
-    func: ActionFunction,
-    params?: Record<string, unknown> | undefined,
-  ) => Promise<void>;
-  ...
-};
-```
-
-## func
-
-The function name is passed according to the functions supported by the different engineering solutions.
-
-## params
-
-For other parameters when the function is enabled, please refer to[MWA New Command](/docs/guides/topic-detail/generator/config/mwa)和[Module New Command](/docs/guides/topic-detail/generator/config/module).

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/api/new/introduce.md

@@ -1,15 +0,0 @@
----
-sidebar_position: 1
----
-
-# Introduction
-
-The three engineering solutions provided by the Modern.js support executing the new command in the project to create elements and enable functions. In the generator plugin, the relevant API can be directly called to create some elements and enable supported functions by default.
-
-Different engineering solutions to support new operations:
-
-- [MWA](/docs/guides/topic-detail/generator/config/mwa)
-
-- [Module](/docs/guides/topic-detail/generator/config/module)
-
-- [Monorepo](/docs/guides/topic-detail/generator/config/monorepo)

package/en/docusaurus-plugin-content-docs/current/guides/topic-detail/generator/plugin/develop.md

@@ -1,124 +0,0 @@
----
-sidebar_position: 3
----
-
-# How to develop generator plugins
-
-## Create project
-
-Modern.js provides a generator plugin to create a generator plugin project, you can directly execute the following command to create:
-
-```bash
-npx @modern-js/create plugin --plugin @modern-js/generator-plugin-plugin
-```
-
-Different plugin types will ask different questions. You can choose the plugin type according to your needs.
-
-### Extension type
-
-```
-? Please select the solution you want to create Module Solution
-? Please select the scene you want to create 生成器插件
-? Plugin Package Name plugin
-? Development Language TS
-? Package Management Tool pnpm
-? Plugin Type extend
-? Plugin Base Type MWA Solution
-```
-
-### Customized type
-
-```
-? Plugin Package Name plugin
-? Development Language TS
-? Package Management Tool pnpm
-? Plugin Type custom
-? Plugin Key mobile-app
-? Plugin Show Name Mobile App
-? Plugin Base Type MWA Solution
-```
-
-After the execution of the create project command is completed, a project for developing the generator plugin will be generated accordingly, and the `meta` information will also be generated according to your selection in the `package.json`.
-
-:::info
-For generator plugin development, please refer to `@modern-js/generator-plugin-plugin`. [Source Code](https://github.com/modern-js-dev/modern.js/tree/main/packages/generator/plugins/generator-plugin)
-:::
-
-## Develop plugin logic
-
-Complete plugin logic development in `src/index.ts`.
-
-The plugin exports a function by default, the function parameter is `context`, and some methods are provided on `context` to directly operate on the current project.
-
-A brief introduction to the provided methods, the complete API list viewable [Generator Plugin API](/docs/guides/topic-detail/generator/plugin/api/introduce).
-
-### Customize input
-
-- addInputBefore
-
-Add input before the default input, such as adding questions before the `Select package management tool` question.
-
-Specific Modern.js configuration viewable for each problem [Project Solution Configuration](/docs/guides/topic-detail/generator/config/common).
-
-```ts
-context.addInputBefore('input2', {
-  type: 'object',
-  properties: {
-    'input1.2': {
-      type: 'string',
-      title: 'input1.2',
-    },
-  },
-});
-```
-
-- setInput
-
-Set attributes of existing problems.
-
-```ts
-context.setInput('test', 'type', 'number');
-context.setInput('test', 'enum', [{ value: 'option1', label: '选项一' }]);
-```
-
-### onForged
-
-After the implementation of the hook related operations of the project plan type file is completed, multiple extended inspection will execute its `onForged` function in sequence according to the `plugin` parameter order.
-
-The `onForged` parameter is a callback function, and the function parameters are `api` and `input`.
-
-Some file manipulation related methods are provided on the `api`, which can operate on the current template file in this hook.
-
-`input` is the current user input, which can be used to obtain the current input information and configuration information of the user.
-
-When you need a new template file, you can add it directly in the `templates` directory. In the `onForged` function, you can directly operate the `templates` directory file. For example, the `templateFile` parameter in the `addFile` below is the file in the `templates` directory. There is no need to display the declaration `templates` here, just write the relative path relative to `templates`.
-
-API functions supported in `onForged` can also be found in [Generator Plugin API](/docs/guides/topic-detail/generator/plugin/api/hook/onForged).
-
-```ts
-context.onForged(async (api: ForgedAPI, input: Record<string, unknown>) => {
-  const { language } = input;
-  api.addFile({
-    type: FileType.Text,
-    file: `src/index.${language as string}`,
-    templateFile: `index.${language as string}.handlebars`,
-    force: true,
-  });
-});
-```
-
-### afterForged
-
-After the `onForged` function is executed, it can mainly install dependencies, Git operations, etc.
-
-If your project plan is based on the three projects provided by the Modern.js, this hook function may not be required. The default project plan will automatically include the installation dependency and commit code logic.
-
-The generator plugin also supports a customized `custom` type, which only provides a small amount of development-level best practice code, such as `.gitignore`, `editorConfig` and other files. In this case, you need to manually supplement the installation dependency and Git operation logic in the `afterForged` function.
-
-The `afterForged` parameter is also a callback function, and the function parameters are `api` and `input`.
-
-The `api` will provide some npm, Git and other methods, which can install dependency and Git operations in this hook.
-
-`input` is the current user input, which can be used to obtain the current input information and configuration information of the user.
-
-The API functions supported in `afterForged` can also be found in [Generator Plugin API] (/docs/guides/topic-detail/generator/plugin/api/hook/afterForged).