@modern-js/module-tools-docs 2.0.1 → 2.0.3-beta.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/doc_build/html/main/index.html +16 -0
- package/doc_build/route.json +10 -0
- package/doc_build/static/css/main.css +2966 -0
- package/doc_build/static/css/main.css.map +1 -0
- package/doc_build/static/css/vendors-node_modules_pnpm_remix-run_router_1_2_0_node_modules_remix-run_router_dist_router_js-9d5e9c.css +68 -0
- package/doc_build/static/css/vendors-node_modules_pnpm_remix-run_router_1_2_0_node_modules_remix-run_router_dist_router_js-9d5e9c.css.map +1 -0
- package/doc_build/static/js/async/en_api_config_build-config.js +8406 -0
- package/doc_build/static/js/async/en_api_config_build-config.js.map +1 -0
- package/doc_build/static/js/async/en_api_config_build-preset.js +7865 -0
- package/doc_build/static/js/async/en_api_config_build-preset.js.map +1 -0
- package/doc_build/static/js/async/en_api_config_design-system.js +47805 -0
- package/doc_build/static/js/async/en_api_config_design-system.js.map +1 -0
- package/doc_build/static/js/async/en_api_config_plugins.js +1488 -0
- package/doc_build/static/js/async/en_api_config_plugins.js.map +1 -0
- package/doc_build/static/js/async/en_api_config_testing.js +2139 -0
- package/doc_build/static/js/async/en_api_config_testing.js.map +1 -0
- package/doc_build/static/js/async/en_api_index.js +51 -0
- package/doc_build/static/js/async/en_api_index.js.map +1 -0
- package/doc_build/static/js/async/en_api_plugin-api_plugin-hooks.js +14360 -0
- package/doc_build/static/js/async/en_api_plugin-api_plugin-hooks.js.map +1 -0
- package/doc_build/static/js/async/en_guide_advance_asset.js +3972 -0
- package/doc_build/static/js/async/en_guide_advance_asset.js.map +1 -0
- package/doc_build/static/js/async/en_guide_advance_build-umd.js +9857 -0
- package/doc_build/static/js/async/en_guide_advance_build-umd.js.map +1 -0
- package/doc_build/static/js/async/en_guide_advance_copy.js +6541 -0
- package/doc_build/static/js/async/en_guide_advance_copy.js.map +1 -0
- package/doc_build/static/js/async/en_guide_advance_external-dependency.js +3806 -0
- package/doc_build/static/js/async/en_guide_advance_external-dependency.js.map +1 -0
- package/doc_build/static/js/async/en_guide_advance_in-depth-about-build.js +5304 -0
- package/doc_build/static/js/async/en_guide_advance_in-depth-about-build.js.map +1 -0
- package/doc_build/static/js/async/en_guide_advance_in-depth-about-dev-command.js +146 -0
- package/doc_build/static/js/async/en_guide_advance_in-depth-about-dev-command.js.map +1 -0
- package/doc_build/static/js/async/en_guide_advance_theme-config.js +2486 -0
- package/doc_build/static/js/async/en_guide_advance_theme-config.js.map +1 -0
- package/doc_build/static/js/async/en_guide_basic_before-getting-started.js +3858 -0
- package/doc_build/static/js/async/en_guide_basic_before-getting-started.js.map +1 -0
- package/doc_build/static/js/async/en_guide_basic_command-preview.js +3973 -0
- package/doc_build/static/js/async/en_guide_basic_command-preview.js.map +1 -0
- package/doc_build/static/js/async/en_guide_basic_modify-output-product.js +3048 -0
- package/doc_build/static/js/async/en_guide_basic_modify-output-product.js.map +1 -0
- package/doc_build/static/js/async/en_guide_basic_publish-your-project.js +2180 -0
- package/doc_build/static/js/async/en_guide_basic_publish-your-project.js.map +1 -0
- package/doc_build/static/js/async/en_guide_basic_test-your-project.js +3887 -0
- package/doc_build/static/js/async/en_guide_basic_test-your-project.js.map +1 -0
- package/doc_build/static/js/async/en_guide_basic_use-micro-generator.js +186 -0
- package/doc_build/static/js/async/en_guide_basic_use-micro-generator.js.map +1 -0
- package/doc_build/static/js/async/en_guide_basic_using-storybook.js +4723 -0
- package/doc_build/static/js/async/en_guide_basic_using-storybook.js.map +1 -0
- package/doc_build/static/js/async/en_guide_best-practices_components.js +21400 -0
- package/doc_build/static/js/async/en_guide_best-practices_components.js.map +1 -0
- package/doc_build/static/js/async/en_guide_intro_getting-started.js +1904 -0
- package/doc_build/static/js/async/en_guide_intro_getting-started.js.map +1 -0
- package/doc_build/static/js/async/en_guide_intro_welcome.js +162 -0
- package/doc_build/static/js/async/en_guide_intro_welcome.js.map +1 -0
- package/doc_build/static/js/async/en_guide_intro_why-module-engineering-solution.js +96 -0
- package/doc_build/static/js/async/en_guide_intro_why-module-engineering-solution.js.map +1 -0
- package/doc_build/static/js/async/en_index.js +81 -0
- package/doc_build/static/js/async/en_index.js.map +1 -0
- package/doc_build/static/js/async/en_plugins_guide_getting-started.js +2556 -0
- package/doc_build/static/js/async/en_plugins_guide_getting-started.js.map +1 -0
- package/doc_build/static/js/async/en_plugins_guide_plugin-object.js +4173 -0
- package/doc_build/static/js/async/en_plugins_guide_plugin-object.js.map +1 -0
- package/doc_build/static/js/async/en_plugins_guide_setup-function.js +3815 -0
- package/doc_build/static/js/async/en_plugins_guide_setup-function.js.map +1 -0
- package/doc_build/static/js/async/en_plugins_official-list_overview.js +66 -0
- package/doc_build/static/js/async/en_plugins_official-list_overview.js.map +1 -0
- package/doc_build/static/js/async/packages_cli_doc-core_src_theme-default_components_Search_logic_search_ts.js +246 -0
- package/doc_build/static/js/async/packages_cli_doc-core_src_theme-default_components_Search_logic_search_ts.js.map +1 -0
- package/doc_build/static/js/async/vendors-node_modules_pnpm_code-hike_mdx_0_7_4_react_18_2_0_node_modules_code-hike_mdx_dist_co-06dd41.js +6656 -0
- package/doc_build/static/js/async/vendors-node_modules_pnpm_code-hike_mdx_0_7_4_react_18_2_0_node_modules_code-hike_mdx_dist_co-06dd41.js.map +1 -0
- package/doc_build/static/js/async/vendors-node_modules_pnpm_flexsearch_0_6_32_node_modules_flexsearch_dist_flexsearch_min_js.js +54 -0
- package/doc_build/static/js/async/vendors-node_modules_pnpm_flexsearch_0_6_32_node_modules_flexsearch_dist_flexsearch_min_js.js.map +1 -0
- package/doc_build/static/js/async/zh_api_config_build-config.js +11354 -0
- package/doc_build/static/js/async/zh_api_config_build-config.js.map +1 -0
- package/doc_build/static/js/async/zh_api_config_build-preset.js +7867 -0
- package/doc_build/static/js/async/zh_api_config_build-preset.js.map +1 -0
- package/doc_build/static/js/async/zh_api_config_design-system.js +48712 -0
- package/doc_build/static/js/async/zh_api_config_design-system.js.map +1 -0
- package/doc_build/static/js/async/zh_api_config_plugins.js +1488 -0
- package/doc_build/static/js/async/zh_api_config_plugins.js.map +1 -0
- package/doc_build/static/js/async/zh_api_config_testing.js +2132 -0
- package/doc_build/static/js/async/zh_api_config_testing.js.map +1 -0
- package/doc_build/static/js/async/zh_api_index.js +52 -0
- package/doc_build/static/js/async/zh_api_index.js.map +1 -0
- package/doc_build/static/js/async/zh_api_plugin-api_plugin-hooks.js +14392 -0
- package/doc_build/static/js/async/zh_api_plugin-api_plugin-hooks.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_advance_asset.js +3972 -0
- package/doc_build/static/js/async/zh_guide_advance_asset.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_advance_build-umd.js +9859 -0
- package/doc_build/static/js/async/zh_guide_advance_build-umd.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_advance_copy.js +6541 -0
- package/doc_build/static/js/async/zh_guide_advance_copy.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_advance_external-dependency.js +3808 -0
- package/doc_build/static/js/async/zh_guide_advance_external-dependency.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_advance_in-depth-about-build.js +5304 -0
- package/doc_build/static/js/async/zh_guide_advance_in-depth-about-build.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_advance_in-depth-about-dev-command.js +150 -0
- package/doc_build/static/js/async/zh_guide_advance_in-depth-about-dev-command.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_advance_theme-config.js +2477 -0
- package/doc_build/static/js/async/zh_guide_advance_theme-config.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_basic_before-getting-started.js +3849 -0
- package/doc_build/static/js/async/zh_guide_basic_before-getting-started.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_basic_command-preview.js +3805 -0
- package/doc_build/static/js/async/zh_guide_basic_command-preview.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_basic_modify-output-product.js +3064 -0
- package/doc_build/static/js/async/zh_guide_basic_modify-output-product.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_basic_publish-your-project.js +2241 -0
- package/doc_build/static/js/async/zh_guide_basic_publish-your-project.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_basic_test-your-project.js +3887 -0
- package/doc_build/static/js/async/zh_guide_basic_test-your-project.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_basic_use-micro-generator.js +192 -0
- package/doc_build/static/js/async/zh_guide_basic_use-micro-generator.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_basic_using-storybook.js +4669 -0
- package/doc_build/static/js/async/zh_guide_basic_using-storybook.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_best-practices_components.js +21100 -0
- package/doc_build/static/js/async/zh_guide_best-practices_components.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_intro_getting-started.js +1780 -0
- package/doc_build/static/js/async/zh_guide_intro_getting-started.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_intro_welcome.js +162 -0
- package/doc_build/static/js/async/zh_guide_intro_welcome.js.map +1 -0
- package/doc_build/static/js/async/zh_guide_intro_why-module-engineering-solution.js +96 -0
- package/doc_build/static/js/async/zh_guide_intro_why-module-engineering-solution.js.map +1 -0
- package/doc_build/static/js/async/zh_index.js +81 -0
- package/doc_build/static/js/async/zh_index.js.map +1 -0
- package/doc_build/static/js/async/zh_plugins_guide_getting-started.js +2604 -0
- package/doc_build/static/js/async/zh_plugins_guide_getting-started.js.map +1 -0
- package/doc_build/static/js/async/zh_plugins_guide_plugin-object.js +4169 -0
- package/doc_build/static/js/async/zh_plugins_guide_plugin-object.js.map +1 -0
- package/doc_build/static/js/async/zh_plugins_guide_setup-function.js +3815 -0
- package/doc_build/static/js/async/zh_plugins_guide_setup-function.js.map +1 -0
- package/doc_build/static/js/async/zh_plugins_official-list_overview.js +66 -0
- package/doc_build/static/js/async/zh_plugins_official-list_overview.js.map +1 -0
- package/doc_build/static/js/builder-runtime.js +1375 -0
- package/doc_build/static/js/builder-runtime.js.map +1 -0
- package/doc_build/static/js/lib-lodash.js +4907 -0
- package/doc_build/static/js/lib-lodash.js.map +1 -0
- package/doc_build/static/js/lib-polyfill.js +11847 -0
- package/doc_build/static/js/lib-polyfill.js.map +1 -0
- package/doc_build/static/js/lib-react.js +39510 -0
- package/doc_build/static/js/lib-react.js.map +1 -0
- package/doc_build/static/js/main.js +8563 -0
- package/doc_build/static/js/main.js.map +1 -0
- package/doc_build/static/js/vendors-node_modules_pnpm_remix-run_router_1_2_0_node_modules_remix-run_router_dist_router_js-9d5e9c.js +7328 -0
- package/doc_build/static/js/vendors-node_modules_pnpm_remix-run_router_1_2_0_node_modules_remix-run_router_dist_router_js-9d5e9c.js.map +1 -0
- package/doc_build/static/search_index.json +1 -0
- package/docs/.island/dist/404.html +41 -0
- package/docs/.island/dist/assets/asset.26aea654.js +160 -0
- package/docs/.island/dist/assets/asset.36e3d3c9.js +160 -0
- package/docs/.island/dist/assets/before-getting-started.0e863740.js +87 -0
- package/docs/.island/dist/assets/before-getting-started.2c6e6b8a.js +87 -0
- package/docs/.island/dist/assets/build-config.460d11d9.js +804 -0
- package/docs/.island/dist/assets/build-config.e155e534.js +854 -0
- package/docs/.island/dist/assets/build-preset.6c2c6c62.js +256 -0
- package/docs/.island/dist/assets/build-preset.d3da921d.js +256 -0
- package/docs/.island/dist/assets/build-umd.ba00f028.js +264 -0
- package/docs/.island/dist/assets/build-umd.edb9d163.js +273 -0
- package/docs/.island/dist/assets/command-preview.1dc93921.js +264 -0
- package/docs/.island/dist/assets/command-preview.ef7a9d01.js +264 -0
- package/docs/.island/dist/assets/components.esm.03560353.js +9 -0
- package/docs/.island/dist/assets/copy.28dc4d5f.js +277 -0
- package/docs/.island/dist/assets/copy.f4625565.js +277 -0
- package/docs/.island/dist/assets/design-system.8993234c.js +1254 -0
- package/docs/.island/dist/assets/design-system.b0ba163f.js +639 -0
- package/docs/.island/dist/assets/dev.b373b152.js +37 -0
- package/docs/.island/dist/assets/dev.b39fd42a.js +37 -0
- package/docs/.island/dist/assets/down.f35427d3.svg +1 -0
- package/docs/.island/dist/assets/extension.4bf3526b.js +1 -0
- package/docs/.island/dist/assets/extension.d64ed0b8.js +469 -0
- package/docs/.island/dist/assets/external-dependency.2ede7532.js +156 -0
- package/docs/.island/dist/assets/external-dependency.92ca89e0.js +156 -0
- package/docs/.island/dist/assets/getting-started.822cf0b2.js +117 -0
- package/docs/.island/dist/assets/getting-started.e2764829.js +114 -0
- package/docs/.island/dist/assets/github.3bf8ccee.svg +1 -0
- package/docs/.island/dist/assets/in-depth-about-build.94cc902d.js +375 -0
- package/docs/.island/dist/assets/in-depth-about-build.aa74de10.js +374 -0
- package/docs/.island/dist/assets/in-depth-about-dev-command.877bdb83.js +33 -0
- package/docs/.island/dist/assets/in-depth-about-dev-command.9736befd.js +39 -0
- package/docs/.island/dist/assets/index.01786ba7.js +30 -0
- package/docs/.island/dist/assets/index.6cef6f5f.js +4 -0
- package/docs/.island/dist/assets/index.cb118238.js +36 -0
- package/docs/.island/dist/assets/index.ccb6ce27.js +4 -0
- package/docs/.island/dist/assets/island_inject.69495876.js +1 -0
- package/docs/.island/dist/assets/island_inject.cdfb22d9.js +1 -0
- package/docs/.island/dist/assets/loading.8c9bb911.svg +1 -0
- package/docs/.island/dist/assets/modify-output-product.9e2394d7.js +100 -0
- package/docs/.island/dist/assets/modify-output-product.f363845a.js +100 -0
- package/docs/.island/dist/assets/moon.6b705924.svg +3 -0
- package/docs/.island/dist/assets/plugin.70a61997.js +42 -0
- package/docs/.island/dist/assets/plugin.80b12ee2.js +42 -0
- package/docs/.island/dist/assets/publish-your-project.7321c10e.js +164 -0
- package/docs/.island/dist/assets/publish-your-project.7326359f.js +166 -0
- package/docs/.island/dist/assets/right.89674cd7.svg +1 -0
- package/docs/.island/dist/assets/search.0aea6901.svg +1 -0
- package/docs/.island/dist/assets/search.11353245.js +222 -0
- package/docs/.island/dist/assets/search.a1b1cff3.js +3 -0
- package/docs/.island/dist/assets/search.f9025ced.js +3 -0
- package/docs/.island/dist/assets/style.09015a4b.css +1 -0
- package/docs/.island/dist/assets/style.2e5f7bc2.css +1970 -0
- package/docs/.island/dist/assets/sun.841dac10.svg +11 -0
- package/docs/.island/dist/assets/test-your-project.8ab2809e.js +190 -0
- package/docs/.island/dist/assets/test-your-project.9ae2a49e.js +190 -0
- package/docs/.island/dist/assets/test.2bfe276b.js +66 -0
- package/docs/.island/dist/assets/test.a2c00a3f.js +67 -0
- package/docs/.island/dist/assets/translator.b1077c44.svg +1 -0
- package/docs/.island/dist/assets/use-micro-generator.13c1a09f.js +60 -0
- package/docs/.island/dist/assets/use-micro-generator.dfe877f6.js +60 -0
- package/docs/.island/dist/assets/using-storybook.adb88cb8.js +260 -0
- package/docs/.island/dist/assets/using-storybook.b8e7dd04.js +260 -0
- package/docs/.island/dist/assets/welcome.94880043.js +13 -0
- package/docs/.island/dist/assets/welcome.b2140e7e.js +13 -0
- package/docs/.island/dist/assets/why-module-engineering-solution.bfe7981a.js +26 -0
- package/docs/.island/dist/assets/why-module-engineering-solution.e31cd19f.js +26 -0
- package/docs/.island/dist/chunk-COLCRJ2V.js +1 -0
- package/docs/.island/dist/chunk-K5FMOYDC.js +10 -0
- package/docs/.island/dist/chunk-WE42KMYS.js +26 -0
- package/docs/.island/dist/client-entry.js +3 -0
- package/docs/.island/dist/en/api/build-config.html +344 -0
- package/docs/.island/dist/en/api/build-preset.html +82 -0
- package/docs/.island/dist/en/api/design-system.html +155 -0
- package/docs/.island/dist/en/api/dev.html +45 -0
- package/docs/.island/dist/en/api/index.html +41 -0
- package/docs/.island/dist/en/api/plugin.html +48 -0
- package/docs/.island/dist/en/api/test.html +58 -0
- package/docs/.island/dist/en/guide/advance/asset.html +68 -0
- package/docs/.island/dist/en/guide/advance/build-umd.html +72 -0
- package/docs/.island/dist/en/guide/advance/copy.html +82 -0
- package/docs/.island/dist/en/guide/advance/extension.html +41 -0
- package/docs/.island/dist/en/guide/advance/external-dependency.html +71 -0
- package/docs/.island/dist/en/guide/advance/in-depth-about-build.html +148 -0
- package/docs/.island/dist/en/guide/advance/in-depth-about-dev-command.html +51 -0
- package/docs/.island/dist/en/guide/basic/before-getting-started.html +127 -0
- package/docs/.island/dist/en/guide/basic/command-preview.html +100 -0
- package/docs/.island/dist/en/guide/basic/modify-output-product.html +140 -0
- package/docs/.island/dist/en/guide/basic/publish-your-project.html +91 -0
- package/docs/.island/dist/en/guide/basic/test-your-project.html +72 -0
- package/docs/.island/dist/en/guide/basic/use-micro-generator.html +65 -0
- package/docs/.island/dist/en/guide/basic/using-storybook.html +113 -0
- package/docs/.island/dist/en/guide/intro/getting-started.html +76 -0
- package/docs/.island/dist/en/guide/intro/welcome.html +53 -0
- package/docs/.island/dist/en/guide/intro/why-module-engineering-solution.html +49 -0
- package/docs/.island/dist/en/index.html +42 -0
- package/docs/.island/dist/react-dom.js +1 -0
- package/docs/.island/dist/react-dom_client.js +1 -0
- package/docs/.island/dist/react.js +1 -0
- package/docs/.island/dist/react_jsx-runtime.js +10 -0
- package/docs/.island/dist/ssr-manifest.json +57 -0
- package/docs/.island/dist/test-result.png +0 -0
- package/docs/.island/dist/why-module-solution.png +0 -0
- package/docs/.island/dist/zh/api/build-config.html +361 -0
- package/docs/.island/dist/zh/api/build-preset.html +82 -0
- package/docs/.island/dist/zh/api/design-system.html +149 -0
- package/docs/.island/dist/zh/api/dev.html +46 -0
- package/docs/.island/dist/zh/api/index.html +41 -0
- package/docs/.island/dist/zh/api/plugin.html +48 -0
- package/docs/.island/dist/zh/api/test.html +59 -0
- package/docs/.island/dist/zh/guide/advance/asset.html +68 -0
- package/docs/.island/dist/zh/guide/advance/build-umd.html +72 -0
- package/docs/.island/dist/zh/guide/advance/copy.html +82 -0
- package/docs/.island/dist/zh/guide/advance/extension.html +127 -0
- package/docs/.island/dist/zh/guide/advance/external-dependency.html +71 -0
- package/docs/.island/dist/zh/guide/advance/in-depth-about-build.html +148 -0
- package/docs/.island/dist/zh/guide/advance/in-depth-about-dev-command.html +53 -0
- package/docs/.island/dist/zh/guide/basic/before-getting-started.html +127 -0
- package/docs/.island/dist/zh/guide/basic/command-preview.html +100 -0
- package/docs/.island/dist/zh/guide/basic/modify-output-product.html +140 -0
- package/docs/.island/dist/zh/guide/basic/publish-your-project.html +92 -0
- package/docs/.island/dist/zh/guide/basic/test-your-project.html +72 -0
- package/docs/.island/dist/zh/guide/basic/use-micro-generator.html +65 -0
- package/docs/.island/dist/zh/guide/basic/using-storybook.html +114 -0
- package/docs/.island/dist/zh/guide/intro/getting-started.html +79 -0
- package/docs/.island/dist/zh/guide/intro/welcome.html +53 -0
- package/docs/.island/dist/zh/guide/intro/why-module-engineering-solution.html +49 -0
- package/docs/.island/dist/zh/index.html +42 -0
- package/docs/en/api/config/build-config.md +20 -10
- package/docs/en/api/config/build-preset.md +3 -2
- package/docs/en/api/config/design-system.md +623 -615
- package/docs/en/api/config/plugins.md +2 -2
- package/docs/en/api/config/testing.md +2 -1
- package/docs/en/api/plugin-api/plugin-hooks.md +1 -1
- package/docs/en/guide/advance/asset.mdx +1 -5
- package/docs/en/guide/advance/build-umd.mdx +6 -6
- package/docs/en/guide/advance/copy.md +5 -5
- package/docs/en/guide/advance/external-dependency.mdx +2 -2
- package/docs/en/guide/advance/in-depth-about-build.md +21 -20
- package/docs/en/guide/advance/in-depth-about-dev-command.md +3 -2
- package/docs/en/guide/advance/theme-config.mdx +2 -2
- package/docs/en/guide/basic/before-getting-started.md +17 -10
- package/docs/en/guide/basic/command-preview.md +4 -4
- package/docs/en/guide/basic/modify-output-product.md +65 -68
- package/docs/en/guide/basic/publish-your-project.md +4 -4
- package/docs/en/guide/basic/test-your-project.mdx +6 -6
- package/docs/en/guide/basic/use-micro-generator.md +13 -5
- package/docs/en/guide/basic/using-storybook.mdx +4 -14
- package/docs/en/guide/best-practices/components.mdx +103 -97
- package/docs/en/guide/intro/getting-started.md +3 -3
- package/docs/en/index.md +14 -17
- package/docs/en/plugins/guide/getting-started.mdx +4 -4
- package/docs/en/plugins/guide/plugin-object.mdx +5 -5
- package/docs/en/plugins/guide/setup-function.mdx +2 -2
- package/docs/zh/api/config/_category_.json +1 -1
- package/docs/zh/api/config/build-config.md +33 -10
- package/docs/zh/api/config/build-preset.md +3 -2
- package/docs/zh/api/config/design-system.md +2 -2
- package/docs/zh/api/config/plugins.md +3 -3
- package/docs/zh/api/config/testing.md +3 -2
- package/docs/zh/api/index.md +1 -0
- package/docs/zh/api/plugin-api/_category_.json +1 -1
- package/docs/zh/api/plugin-api/plugin-hooks.md +56 -55
- package/docs/zh/guide/advance/asset.mdx +1 -6
- package/docs/zh/guide/advance/build-umd.mdx +6 -6
- package/docs/zh/guide/advance/copy.md +5 -5
- package/docs/zh/guide/advance/external-dependency.mdx +3 -3
- package/docs/zh/guide/advance/in-depth-about-build.md +21 -20
- package/docs/zh/guide/advance/in-depth-about-dev-command.md +3 -2
- package/docs/zh/guide/advance/theme-config.mdx +2 -2
- package/docs/zh/guide/basic/before-getting-started.md +16 -9
- package/docs/zh/guide/basic/command-preview.md +4 -4
- package/docs/zh/guide/basic/modify-output-product.md +45 -47
- package/docs/zh/guide/basic/publish-your-project.md +4 -4
- package/docs/zh/guide/basic/test-your-project.mdx +6 -6
- package/docs/zh/guide/basic/use-micro-generator.md +10 -6
- package/docs/zh/guide/basic/using-storybook.mdx +12 -20
- package/docs/zh/guide/best-practices/components.mdx +10 -10
- package/docs/zh/guide/intro/getting-started.md +3 -3
- package/docs/zh/index.md +1 -1
- package/docs/zh/plugins/guide/getting-started.mdx +5 -5
- package/docs/zh/plugins/guide/plugin-object.mdx +5 -5
- package/docs/zh/plugins/guide/setup-function.mdx +2 -2
- package/modern.config.ts +15 -8
- package/package.json +4 -4
|
@@ -4,15 +4,15 @@ sidebar_position: 1
|
|
|
4
4
|
|
|
5
5
|
# BuildConfig
|
|
6
6
|
|
|
7
|
-
本章节描述了 Module
|
|
7
|
+
本章节描述了 Module Tools 关于构建的所有配置
|
|
8
8
|
|
|
9
9
|
## alias
|
|
10
10
|
|
|
11
|
-
- 类型:`Record<string, string
|
|
11
|
+
- 类型:`Record<string, string> | Function`
|
|
12
12
|
- 默认值:`{'@': 'src',}`
|
|
13
13
|
|
|
14
14
|
:::tip
|
|
15
|
-
对于 TypeScript 项目,只需要在 `tsconfig.json` 中配置 [compilerOptions.paths](https://www.typescriptlang.org/tsconfig#paths), Module
|
|
15
|
+
对于 TypeScript 项目,只需要在 `tsconfig.json` 中配置 [compilerOptions.paths](https://www.typescriptlang.org/tsconfig#paths), Module Tools 会自动识别 `tsconfig.json` 里的别名,因此不需要额外配置 `alias` 字段。
|
|
16
16
|
:::
|
|
17
17
|
|
|
18
18
|
```js modern.config.ts
|
|
@@ -63,7 +63,7 @@ export default defineConfig({
|
|
|
63
63
|
|
|
64
64
|
### path
|
|
65
65
|
|
|
66
|
-
静态资源输出路径,会基于 [outDir](/
|
|
66
|
+
静态资源输出路径,会基于 [outDir](/api/config/build-config#outDir) 进行输出。
|
|
67
67
|
|
|
68
68
|
- 类型: `string`
|
|
69
69
|
- 默认值: `assets`
|
|
@@ -103,6 +103,19 @@ export default defineConfig({
|
|
|
103
103
|
- 类型: `boolean | Object`
|
|
104
104
|
- 默认值: `false`
|
|
105
105
|
|
|
106
|
+
:::tip
|
|
107
|
+
开启 svgr 后,仍然使用 default export 导出 svg,所以你只能导入默认值。
|
|
108
|
+
|
|
109
|
+
```js index.ts
|
|
110
|
+
// true
|
|
111
|
+
import logo from './logo.svg';
|
|
112
|
+
|
|
113
|
+
// false
|
|
114
|
+
import { ReactComponent } from './logo.svg';
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
:::
|
|
118
|
+
|
|
106
119
|
#### include
|
|
107
120
|
|
|
108
121
|
设定匹配的 svg 文件
|
|
@@ -218,7 +231,8 @@ export default defineConfig({
|
|
|
218
231
|
|
|
219
232
|
- 全局常量使用大写
|
|
220
233
|
- 自定义全局常量前缀后缀,确保独一无二
|
|
221
|
-
|
|
234
|
+
|
|
235
|
+
:::
|
|
222
236
|
|
|
223
237
|
## dts
|
|
224
238
|
|
|
@@ -236,7 +250,7 @@ TypeScript 配置文件的路径。
|
|
|
236
250
|
|
|
237
251
|
### distPath
|
|
238
252
|
|
|
239
|
-
类型文件的输出路径,基于 [outDir](/
|
|
253
|
+
类型文件的输出路径,基于 [outDir](/api/config/build-config#outDir) 进行输出。
|
|
240
254
|
|
|
241
255
|
- 类型: `string`
|
|
242
256
|
- 默认值: `./types`
|
|
@@ -286,6 +300,13 @@ export default defineConfig({
|
|
|
286
300
|
- 类型: `automatic | classic`
|
|
287
301
|
- 默认值: `automatic`
|
|
288
302
|
|
|
303
|
+
## metafile
|
|
304
|
+
|
|
305
|
+
esbuild 以 JSON 格式生成有关构建的一些元数据,可以通过例如 [bundle-buddy](https://bundle-buddy.com/esbuild) 的工具可视化
|
|
306
|
+
|
|
307
|
+
- type: `boolean`
|
|
308
|
+
- default: `false`
|
|
309
|
+
|
|
289
310
|
## minify
|
|
290
311
|
|
|
291
312
|
使用 esbuild 或者 terser 压缩代码,也可以传入 [terserOptions](https://github.com/terser/terser#minify-options)。
|
|
@@ -508,7 +529,7 @@ export default defineConfig({
|
|
|
508
529
|
根据文件名自动启用 CSS Modules。
|
|
509
530
|
|
|
510
531
|
- 类型: `boolean | RegExp`
|
|
511
|
-
- 默认值: `true
|
|
532
|
+
- 默认值: `true`
|
|
512
533
|
|
|
513
534
|
`true` : 为以 `.module.css` `.module.less` `.module.scss` `.module.sass` 文件名结尾的样式文件启用 CSS Modules。
|
|
514
535
|
|
|
@@ -580,7 +601,7 @@ const tailwind = {
|
|
|
580
601
|
|
|
581
602
|
值为 `Function` 类型时,函数返回的对象与默认配置通过 `Object.assign` 合并。
|
|
582
603
|
|
|
583
|
-
不允许出现 `theme` 属性,否则会构建失败, 使用 [`designSystem`](/
|
|
604
|
+
不允许出现 `theme` 属性,否则会构建失败, 使用 [`designSystem`](/api/config/design-system) 作为 `Tailwind CSS Theme` 配置。
|
|
584
605
|
|
|
585
606
|
其他的使用方式和 Tailwind CSS 一致: [快速传送门](https://tailwindcss.com/docs/configuration)。
|
|
586
607
|
|
|
@@ -589,7 +610,7 @@ const tailwind = {
|
|
|
589
610
|
指定构建的目标环境
|
|
590
611
|
|
|
591
612
|
- 类型: `'es5' | 'es6' | 'es2015' | 'es2016' | 'es2017' | 'es2018' | 'es2019' | 'es2020' | 'es2021' | 'es2022' | 'esnext'`
|
|
592
|
-
- 默认值: `'
|
|
613
|
+
- 默认值: `'es6'`
|
|
593
614
|
|
|
594
615
|
## umdGlobals
|
|
595
616
|
|
|
@@ -632,11 +653,13 @@ export default defineConfig({
|
|
|
632
653
|
```
|
|
633
654
|
|
|
634
655
|
此时 UMD 产物会去挂载到 `global.myLib` 上。
|
|
656
|
+
|
|
635
657
|
:::tip
|
|
636
658
|
|
|
637
659
|
- 需要遵守 UMD 规范,UMD 产物的模块名不能和全局变量名冲突
|
|
638
660
|
- 模块名不能含有 `-`,`@`,`/` 等特殊字符
|
|
639
|
-
|
|
661
|
+
|
|
662
|
+
:::
|
|
640
663
|
|
|
641
664
|
同时函数形式可以接收一个参数,为当前打包文件的输出路径
|
|
642
665
|
|
|
@@ -31,7 +31,8 @@ export default defineConfig({
|
|
|
31
31
|
- [npm](https://www.npmjs.com)
|
|
32
32
|
- [yarn](https://yarnpkg.com/)
|
|
33
33
|
- [pnpm](https://pnpm.io/)
|
|
34
|
-
|
|
34
|
+
|
|
35
|
+
:::
|
|
35
36
|
|
|
36
37
|
```json package.json
|
|
37
38
|
{
|
|
@@ -199,7 +200,7 @@ export const buildConfig = [
|
|
|
199
200
|
|
|
200
201
|
当想要使用支持其他 ECMAScript 版本的 `buildPreset` 预设的时候,可以直接在 `'npm-library'`、`'npm-library-with-umd'`、`'npm-component'`、`'npm-component-with-umd'` 这些预设值后面增加想要支持的版本。
|
|
201
202
|
|
|
202
|
-
例如希望 `'npm-library'` 预设支持 `es2017`,则可以按照如下方式配置:
|
|
203
|
+
例如希望 `'npm-library'` 预设支持 `'es2017'`,则可以按照如下方式配置:
|
|
203
204
|
|
|
204
205
|
```js modern.config.ts
|
|
205
206
|
import { defineConfig } from '@modern-js/module-tools';
|
|
@@ -6,7 +6,7 @@ sidebar_position: 3
|
|
|
6
6
|
|
|
7
7
|
本章描述了有关 designSystem 相关的配置
|
|
8
8
|
|
|
9
|
-
:::
|
|
9
|
+
:::tip
|
|
10
10
|
需要先通过 `pnpm run new` 启用 Tailwind CSS 功能。
|
|
11
11
|
:::
|
|
12
12
|
|
|
@@ -646,7 +646,7 @@ const designSystem = {
|
|
|
646
646
|
};
|
|
647
647
|
```
|
|
648
648
|
|
|
649
|
-
:::
|
|
649
|
+
:::tip
|
|
650
650
|
更多关于[TailwindCSS 配置](https://tailwindcss.com/docs/configuration#theme)
|
|
651
651
|
:::
|
|
652
652
|
|
|
@@ -9,10 +9,10 @@ sidebar_position: 4
|
|
|
9
9
|
- type:`Array<ModuleToolsPlugin>`
|
|
10
10
|
|
|
11
11
|
```js modern.config.ts
|
|
12
|
-
import {
|
|
12
|
+
import { examplePlugin } from './plugins/example';
|
|
13
13
|
export default defineConfig({
|
|
14
|
-
plugins: [
|
|
14
|
+
plugins: [examplePlugin()],
|
|
15
15
|
});
|
|
16
16
|
```
|
|
17
17
|
|
|
18
|
-
关于如何编写插件,可以查看[【插件编写指南】](/
|
|
18
|
+
关于如何编写插件,可以查看[【插件编写指南】](/plugins/guide/getting-started)。
|
package/docs/zh/api/index.md
CHANGED
|
@@ -4,24 +4,24 @@
|
|
|
4
4
|
|
|
5
5
|
目前主要包含两类生命周期钩子:
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
7
|
+
- 构建钩子:仅在执行 `build` 命令构建源码产物时触发。
|
|
8
|
+
- `buildPlatform` 钩子:仅在执行 `build --platform` 命令生成其他构建产物时触发。
|
|
9
|
+
- 调试钩子:运行 `dev` 命令时会触发的钩子。
|
|
10
10
|
|
|
11
11
|
## 构建钩子
|
|
12
12
|
|
|
13
13
|
在执行 `build` 命令的时候,会按照顺序触发以下 Hooks:
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
15
|
+
- `beforeBuild`
|
|
16
|
+
- `beforeBuildTask`
|
|
17
|
+
- `afterBuildTask`
|
|
18
|
+
- `afterBuild`
|
|
19
19
|
|
|
20
20
|
### `beforeBuild`
|
|
21
21
|
|
|
22
22
|
执行整体构建流程之前触发。
|
|
23
23
|
|
|
24
|
-
```
|
|
24
|
+
```ts
|
|
25
25
|
export default (): CliPlugin<ModuleTools> => ({
|
|
26
26
|
name: 'my-plugin',
|
|
27
27
|
|
|
@@ -29,16 +29,18 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
29
29
|
return {
|
|
30
30
|
beforeBuild(options: Options): Return {
|
|
31
31
|
return options.config;
|
|
32
|
-
}
|
|
33
|
-
}
|
|
32
|
+
},
|
|
33
|
+
};
|
|
34
34
|
},
|
|
35
35
|
});
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
参数和返回值类型:
|
|
39
39
|
|
|
40
|
-
```
|
|
41
|
-
type Options = {
|
|
40
|
+
```ts
|
|
41
|
+
type Options = {
|
|
42
|
+
options: { config: BuildConfig; cliOptions: BuildCommandOptions };
|
|
43
|
+
};
|
|
42
44
|
|
|
43
45
|
export interface BuildCommandOptions {
|
|
44
46
|
config: string;
|
|
@@ -52,13 +54,13 @@ export interface BuildCommandOptions {
|
|
|
52
54
|
type Return = BuildConfig;
|
|
53
55
|
```
|
|
54
56
|
|
|
55
|
-
> `BuildConfig` 类型参考 [API 配置](
|
|
57
|
+
> `BuildConfig` 类型参考 [API 配置](/api/)
|
|
56
58
|
|
|
57
59
|
### `beforeBuildTask`
|
|
58
60
|
|
|
59
|
-
根据构建配置,
|
|
61
|
+
根据构建配置,Module Tools 会将整体构建分成多个子构建任务。该 Hook 将会在每一个构建子任务之前触发。
|
|
60
62
|
|
|
61
|
-
```
|
|
63
|
+
```ts
|
|
62
64
|
export default (): CliPlugin<ModuleTools> => ({
|
|
63
65
|
name: 'my-plugin',
|
|
64
66
|
|
|
@@ -66,21 +68,21 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
66
68
|
return {
|
|
67
69
|
beforeBuildTask(config: BaseBuildConfig): BaseBuildConfig {
|
|
68
70
|
return config;
|
|
69
|
-
}
|
|
70
|
-
}
|
|
71
|
+
},
|
|
72
|
+
};
|
|
71
73
|
},
|
|
72
74
|
});
|
|
73
75
|
```
|
|
74
76
|
|
|
75
77
|
参数和返回值类型:
|
|
76
78
|
|
|
77
|
-
`BaseBuildConfig` 类型参考 [API 配置](
|
|
79
|
+
`BaseBuildConfig` 类型参考 [API 配置](/api/)。
|
|
78
80
|
|
|
79
81
|
### `afterBuildTask`
|
|
80
82
|
|
|
81
83
|
每一个构建子任务结束之后触发。
|
|
82
84
|
|
|
83
|
-
```
|
|
85
|
+
```ts
|
|
84
86
|
export default (): CliPlugin<ModuleTools> => ({
|
|
85
87
|
name: 'my-plugin',
|
|
86
88
|
|
|
@@ -88,15 +90,15 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
88
90
|
return {
|
|
89
91
|
afterBuildTask(options: BuildTaskResult): void {
|
|
90
92
|
// ...
|
|
91
|
-
}
|
|
92
|
-
}
|
|
93
|
+
},
|
|
94
|
+
};
|
|
93
95
|
},
|
|
94
96
|
});
|
|
95
97
|
```
|
|
96
98
|
|
|
97
99
|
参数和返回值类型:
|
|
98
100
|
|
|
99
|
-
```
|
|
101
|
+
```ts
|
|
100
102
|
export interface BuildTaskResult {
|
|
101
103
|
status: 'success' | 'fail';
|
|
102
104
|
message?: string;
|
|
@@ -108,7 +110,7 @@ export interface BuildTaskResult {
|
|
|
108
110
|
|
|
109
111
|
整体构建流程结束之后触发。
|
|
110
112
|
|
|
111
|
-
```
|
|
113
|
+
```ts
|
|
112
114
|
export default (): CliPlugin<ModuleTools> => ({
|
|
113
115
|
name: 'my-plugin',
|
|
114
116
|
|
|
@@ -116,15 +118,15 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
116
118
|
return {
|
|
117
119
|
afterBuild(options: BuildResult): void {
|
|
118
120
|
// ...
|
|
119
|
-
}
|
|
120
|
-
}
|
|
121
|
+
},
|
|
122
|
+
};
|
|
121
123
|
},
|
|
122
124
|
});
|
|
123
125
|
```
|
|
124
126
|
|
|
125
127
|
参数和返回值类型:
|
|
126
128
|
|
|
127
|
-
```
|
|
129
|
+
```ts
|
|
128
130
|
export interface BuildResult {
|
|
129
131
|
status: 'success' | 'fail';
|
|
130
132
|
message?: string;
|
|
@@ -142,16 +144,16 @@ module-tools 还提供了 `build --platform` 命令来执行特定的构建任
|
|
|
142
144
|
|
|
143
145
|
在执行 `build --platform` 后会按照以下顺序触发 Hooks:
|
|
144
146
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
147
|
+
- `registerBuildPlatform`
|
|
148
|
+
- `beforeBuildPlatform`
|
|
149
|
+
- `buildPlatform`
|
|
150
|
+
- `afterBuildPlatform`
|
|
149
151
|
|
|
150
152
|
### `registerBuildPlatform`
|
|
151
153
|
|
|
152
154
|
获取在执行 `build --platform` 命令时候需要运行的任务信息。
|
|
153
155
|
|
|
154
|
-
```
|
|
156
|
+
```ts
|
|
155
157
|
export default (): CliPlugin<ModuleTools> => ({
|
|
156
158
|
name: 'my-plugin',
|
|
157
159
|
|
|
@@ -173,7 +175,7 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
173
175
|
|
|
174
176
|
入参和返回的参数类型:
|
|
175
177
|
|
|
176
|
-
```
|
|
178
|
+
```ts
|
|
177
179
|
export interface RegisterBuildPlatformResult {
|
|
178
180
|
platform: string | string[];
|
|
179
181
|
build: (
|
|
@@ -187,7 +189,7 @@ export interface RegisterBuildPlatformResult {
|
|
|
187
189
|
|
|
188
190
|
当执行 `build --platform` 命令的时候,会触发所有已注册的构建任务。`beforeBuildPlatform` 会在执行整体的构建任务之前触发。
|
|
189
191
|
|
|
190
|
-
```
|
|
192
|
+
```ts
|
|
191
193
|
export default (): CliPlugin<ModuleTools> => ({
|
|
192
194
|
name: 'my-plugin',
|
|
193
195
|
|
|
@@ -203,7 +205,7 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
203
205
|
|
|
204
206
|
入参和返回的参数类型:
|
|
205
207
|
|
|
206
|
-
```
|
|
208
|
+
```ts
|
|
207
209
|
export interface RegisterBuildPlatformResult {
|
|
208
210
|
platform: string | string[];
|
|
209
211
|
build: (
|
|
@@ -217,7 +219,7 @@ export interface RegisterBuildPlatformResult {
|
|
|
217
219
|
|
|
218
220
|
当执行 `build --platform` 命令的时候,会触发所有已注册的构建任务。`buildPlatform` 会在每个构建任务执行之前触发。
|
|
219
221
|
|
|
220
|
-
```
|
|
222
|
+
```ts
|
|
221
223
|
export default (): CliPlugin<ModuleTools> => ({
|
|
222
224
|
name: 'my-plugin',
|
|
223
225
|
|
|
@@ -233,7 +235,7 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
233
235
|
|
|
234
236
|
入参和返回的参数类型:
|
|
235
237
|
|
|
236
|
-
```
|
|
238
|
+
```ts
|
|
237
239
|
export interface Options {
|
|
238
240
|
platform: string;
|
|
239
241
|
}
|
|
@@ -243,7 +245,7 @@ export interface Options {
|
|
|
243
245
|
|
|
244
246
|
当执行 `build --platform` 命令的时候,会触发所有已注册的构建任务。`afterBuildPlatform` 会在整体 platform 构建任务结束后触发。
|
|
245
247
|
|
|
246
|
-
```
|
|
248
|
+
```ts
|
|
247
249
|
export default (): CliPlugin<ModuleTools> => ({
|
|
248
250
|
name: 'my-plugin',
|
|
249
251
|
|
|
@@ -270,7 +272,6 @@ export interface BuildPlatformResult {
|
|
|
270
272
|
}
|
|
271
273
|
```
|
|
272
274
|
|
|
273
|
-
|
|
274
275
|
## 调试钩子
|
|
275
276
|
|
|
276
277
|
在执行 `dev` 命令的时候,会按照顺序触发以下 Hooks:
|
|
@@ -286,13 +287,13 @@ export interface BuildPlatformResult {
|
|
|
286
287
|
|
|
287
288
|
注册调试工具相关的数据。主要包含:
|
|
288
289
|
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
290
|
+
- 调试工具的名称
|
|
291
|
+
- 显示在菜单列表中的项目名称以及对应的值。
|
|
292
|
+
- `dev` 子命令的定义。
|
|
293
|
+
- 是否在运行调试任务之前执行源码构建
|
|
294
|
+
- 执行调试任务的函数。
|
|
294
295
|
|
|
295
|
-
```
|
|
296
|
+
```ts
|
|
296
297
|
export default (): CliPlugin<ModuleTools> => ({
|
|
297
298
|
name: 'my-plugin',
|
|
298
299
|
|
|
@@ -321,7 +322,7 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
321
322
|
|
|
322
323
|
入参和返回的参数类型:
|
|
323
324
|
|
|
324
|
-
```
|
|
325
|
+
```ts
|
|
325
326
|
export interface DevToolData {
|
|
326
327
|
name: string;
|
|
327
328
|
subCommands?: string[];
|
|
@@ -348,7 +349,7 @@ export interface DevToolData {
|
|
|
348
349
|
|
|
349
350
|
在收集完所有调试工具元数据后,执行 dev 任务之前触发。
|
|
350
351
|
|
|
351
|
-
```
|
|
352
|
+
```ts
|
|
352
353
|
export default (): CliPlugin<ModuleTools> => ({
|
|
353
354
|
name: 'my-plugin',
|
|
354
355
|
|
|
@@ -364,7 +365,7 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
364
365
|
|
|
365
366
|
入参和返回的参数类型:
|
|
366
367
|
|
|
367
|
-
```
|
|
368
|
+
```ts
|
|
368
369
|
export interface DevToolData {
|
|
369
370
|
name: string;
|
|
370
371
|
subCommands?: string[];
|
|
@@ -385,7 +386,7 @@ export interface DevToolData {
|
|
|
385
386
|
|
|
386
387
|
`beforeDevMenu` 在出现调试列表/菜单之前触发。接收 [inquirer question](https://github.com/SBoudrias/Inquirer.js#question) 作为参数。默认值为:
|
|
387
388
|
|
|
388
|
-
```
|
|
389
|
+
```ts
|
|
389
390
|
const question = [
|
|
390
391
|
{
|
|
391
392
|
name: 'choiceDevTool',
|
|
@@ -399,7 +400,7 @@ const question = [
|
|
|
399
400
|
|
|
400
401
|
`afterDevMenu` 选择调试列表/菜单选项后触发。
|
|
401
402
|
|
|
402
|
-
```
|
|
403
|
+
```ts
|
|
403
404
|
export default (): CliPlugin<ModuleTools> => ({
|
|
404
405
|
name: 'my-plugin',
|
|
405
406
|
|
|
@@ -411,7 +412,7 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
411
412
|
},
|
|
412
413
|
afterDevMenu(options: Options) {
|
|
413
414
|
console.info(`choise ${options.result.choiceDevTool} dev tools`);
|
|
414
|
-
}
|
|
415
|
+
},
|
|
415
416
|
};
|
|
416
417
|
},
|
|
417
418
|
});
|
|
@@ -419,7 +420,7 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
419
420
|
|
|
420
421
|
入参和返回的参数类型:
|
|
421
422
|
|
|
422
|
-
```
|
|
423
|
+
```ts
|
|
423
424
|
export type { QuestionCollection } from 'inquirer';
|
|
424
425
|
|
|
425
426
|
export interface Options {
|
|
@@ -427,7 +428,7 @@ export interface Options {
|
|
|
427
428
|
devTools: DevToolData[];
|
|
428
429
|
}
|
|
429
430
|
|
|
430
|
-
export type PromptResult = { choiceDevTool: string }
|
|
431
|
+
export type PromptResult = { choiceDevTool: string };
|
|
431
432
|
export interface DevToolData {
|
|
432
433
|
name: string;
|
|
433
434
|
subCommands?: string[];
|
|
@@ -448,7 +449,7 @@ export interface DevToolData {
|
|
|
448
449
|
|
|
449
450
|
执行调试任务之前触发。
|
|
450
451
|
|
|
451
|
-
```
|
|
452
|
+
```ts
|
|
452
453
|
export default (): CliPlugin<ModuleTools> => ({
|
|
453
454
|
name: 'my-plugin',
|
|
454
455
|
|
|
@@ -464,7 +465,7 @@ export default (): CliPlugin<ModuleTools> => ({
|
|
|
464
465
|
|
|
465
466
|
入参和返回的参数类型:
|
|
466
467
|
|
|
467
|
-
```
|
|
468
|
+
```ts
|
|
468
469
|
export interface DevToolData {
|
|
469
470
|
name: string;
|
|
470
471
|
subCommands?: string[];
|
|
@@ -485,7 +486,7 @@ export interface DevToolData {
|
|
|
485
486
|
|
|
486
487
|
在中断调试任务进程时触发。
|
|
487
488
|
|
|
488
|
-
```
|
|
489
|
+
```ts
|
|
489
490
|
export default (): CliPlugin<ModuleTools> => ({
|
|
490
491
|
name: 'my-plugin',
|
|
491
492
|
|
|
@@ -4,7 +4,7 @@ sidebar_position: 7
|
|
|
4
4
|
|
|
5
5
|
# 处理静态资源文件
|
|
6
6
|
|
|
7
|
-
模块工程会对代码中使用的静态资源进行处理。如果需要配置,则可以使用 [`buildConfig.asset`](/
|
|
7
|
+
模块工程会对代码中使用的静态资源进行处理。如果需要配置,则可以使用 [`buildConfig.asset`](/api/config/build-config#asset) API。
|
|
8
8
|
|
|
9
9
|
## 默认行为
|
|
10
10
|
|
|
@@ -18,7 +18,6 @@ sidebar_position: 7
|
|
|
18
18
|
|
|
19
19
|
- 设置静态资源路径为 `./assets`。
|
|
20
20
|
- 对于超过 **10kb** 的文件会内联到代码中。
|
|
21
|
-
- 对于 `.svg` 后缀的文件使用 [SVGR](https://react-svgr.com/)。
|
|
22
21
|
|
|
23
22
|
让我们看下面的例子:
|
|
24
23
|
|
|
@@ -143,7 +142,3 @@ export default defineConfig({
|
|
|
143
142
|
```
|
|
144
143
|
|
|
145
144
|
</CH.Spotlight>
|
|
146
|
-
|
|
147
|
-
## SVGR
|
|
148
|
-
|
|
149
|
-
WIP
|
|
@@ -22,7 +22,7 @@ export default defineConfig({
|
|
|
22
22
|
|
|
23
23
|
## umd 产物的第三方依赖处理
|
|
24
24
|
|
|
25
|
-
在 [【如何处理第三方依赖】](/
|
|
25
|
+
在 [【如何处理第三方依赖】](/guide/advance/external-dependency) 章节中,我们知道可以通过 [`autoExternals`](/api/config/build-config#autoexternal) 和 [`externals`](/api/config/build-config#externals) API 来控制项目是否对第三方依赖打包。
|
|
26
26
|
因此在构建 umd 产物的过程中,我们也可以这样使用:
|
|
27
27
|
|
|
28
28
|
<CH.Spotlight>
|
|
@@ -110,7 +110,7 @@ console.info(React);
|
|
|
110
110
|
- 在 Node.js 环境下,可以通过 `require('react')` 获取 react 依赖。
|
|
111
111
|
- 在 浏览器环境下,可以通过 `global.react` 获取 react 依赖。
|
|
112
112
|
|
|
113
|
-
然而在浏览器环境下,获取第三方依赖的时候,**全局变量名称不一定与依赖名称完全相同**,此时就要使用 [`buildConfig.umdGlobals`](/
|
|
113
|
+
然而在浏览器环境下,获取第三方依赖的时候,**全局变量名称不一定与依赖名称完全相同**,此时就要使用 [`buildConfig.umdGlobals`](/api/config/build-config#umdglobals) API。
|
|
114
114
|
|
|
115
115
|
还是使用之前的例子,当 `react` 依赖以 `windows.React` 或者 `global.React` 全局变量的形式存在于浏览器环境下,那么此时:
|
|
116
116
|
|
|
@@ -164,7 +164,7 @@ console.info(React);
|
|
|
164
164
|
|
|
165
165
|
此时我们会看到这样的产物代码。
|
|
166
166
|
|
|
167
|
-
```js dist/index.js focus=
|
|
167
|
+
```js dist/index.js focus=12:18
|
|
168
168
|
(function (global, factory) {
|
|
169
169
|
if (typeof module === 'object' && typeof module.exports === 'object')
|
|
170
170
|
factory();
|
|
@@ -203,7 +203,7 @@ export default () => {
|
|
|
203
203
|
|
|
204
204
|
**默认情况下,以源码文件名称作为该模块在浏览器里全局变量的名称**。对于上面的例子,其产物内容如下:
|
|
205
205
|
|
|
206
|
-
```js ./dist/index.js focus=
|
|
206
|
+
```js ./dist/index.js focus=9:9
|
|
207
207
|
(function (global, factory) {
|
|
208
208
|
if (typeof module === 'object' && typeof module.exports === 'object')
|
|
209
209
|
factory(exports);
|
|
@@ -218,7 +218,7 @@ export default () => {
|
|
|
218
218
|
});
|
|
219
219
|
```
|
|
220
220
|
|
|
221
|
-
如果需要修改它,则需要使用 [`buildConfig.umdModuleName`](/
|
|
221
|
+
如果需要修改它,则需要使用 [`buildConfig.umdModuleName`](/api/config/build-config#umdmodulename) API。
|
|
222
222
|
|
|
223
223
|
当使用该 API 后:
|
|
224
224
|
|
|
@@ -233,7 +233,7 @@ export default defineConfig({
|
|
|
233
233
|
|
|
234
234
|
此时构建产物的内容为:
|
|
235
235
|
|
|
236
|
-
```js ./dist/index.js focus=
|
|
236
|
+
```js ./dist/index.js focus=9:9
|
|
237
237
|
(function (global, factory) {
|
|
238
238
|
if (typeof module === 'object' && typeof module.exports === 'object')
|
|
239
239
|
factory(exports);
|
|
@@ -8,10 +8,10 @@ sidebar_position: 3
|
|
|
8
8
|
|
|
9
9
|
## 了解 Copy API
|
|
10
10
|
|
|
11
|
-
我们可以通过 [`buildConfig.copy`](/
|
|
11
|
+
我们可以通过 [`buildConfig.copy`](/api/config/build-config#copy) API 来使用 Copy 工具,它包含以下两个主要配置:
|
|
12
12
|
|
|
13
|
-
- [`patterns`](/
|
|
14
|
-
- [`options`](/
|
|
13
|
+
- [`patterns`](/api/config/build-config#copypatterns)
|
|
14
|
+
- [`options`](/api/config/build-config#copyoptions)
|
|
15
15
|
|
|
16
16
|
在开始学习之前可以先花一些时间了解它们。
|
|
17
17
|
|
|
@@ -34,7 +34,7 @@ export default defineConfig({
|
|
|
34
34
|
});
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
`patterns.context` 一般和 `patterns.from` 配合使用,默认情况下它的值与 [`buildConfig.sourceDir`](/
|
|
37
|
+
`patterns.context` 一般和 `patterns.from` 配合使用,默认情况下它的值与 [`buildConfig.sourceDir`](/api/config/build-config#sourcedir) 相同,因此我们可以按照如下方式指定 `src/data.json` 文件为要复制的文件:
|
|
38
38
|
|
|
39
39
|
> 默认情况下,`buildConfig.sourceDir` 为 `src`
|
|
40
40
|
|
|
@@ -70,7 +70,7 @@ export default defineConfig({
|
|
|
70
70
|
});
|
|
71
71
|
```
|
|
72
72
|
|
|
73
|
-
`patterns.to` 用于指定复制文件的输出路径,默认情况下它的值为 [`buildConfig.outDir`](
|
|
73
|
+
`patterns.to` 用于指定复制文件的输出路径,默认情况下它的值为 [`buildConfig.outDir`](/api/config/build-config#outDir)对应的值。因此我们按照如下方式将 `src/index.html` 复制到 `dist` 目录下:
|
|
74
74
|
|
|
75
75
|
```ts
|
|
76
76
|
export default defineConfig({
|
|
@@ -15,7 +15,7 @@ sidebar_position: 4
|
|
|
15
15
|
|
|
16
16
|
而 `"dependencies"` 下的依赖通常来说是和项目代码以及构建相关的,如果这些第三方依赖声明在 `"devDependencies"` 下,那么在生产环境下就会出现缺失依赖的问题。
|
|
17
17
|
|
|
18
|
-
除了 `"dependencies"` 以外,[`"peerDependencies"`](/
|
|
18
|
+
除了 `"dependencies"` 以外,[`"peerDependencies"`](/guide/basic/before-getting-started#peerdependencies) 也可以声明在生产环境下需要的依赖,不过它更强调项目在运行环境下存在 `"peerDependencies"` 声明的这些依赖,这类似于插件这样的机制。
|
|
19
19
|
|
|
20
20
|
## 第三方依赖的默认处理
|
|
21
21
|
|
|
@@ -81,8 +81,8 @@ console.info(React);
|
|
|
81
81
|
|
|
82
82
|
在构建配置中提供了以下 API 来处理第三方依赖:
|
|
83
83
|
|
|
84
|
-
- [`buildConfig.autoExternal`](/
|
|
85
|
-
- [`buildConfig.externals`](/
|
|
84
|
+
- [`buildConfig.autoExternal`](/api/config/build-config#autoexternal)
|
|
85
|
+
- [`buildConfig.externals`](/api/config/build-config#externals)
|
|
86
86
|
|
|
87
87
|
### 关闭默认行为
|
|
88
88
|
|