@modern-js/app-tools 3.9.3 → 3.10.0

package/docs/index.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 [NEWModern.js 3.0 is released!→](/community/blog/v3-release-note)
 
 # Modern.js 3.0A Progressive React Framework for modern web development

package/docs/llms.txt

@@ -39,7 +39,7 @@
 - [Using Rsdoctor](/guides/basic-features/debug/rsdoctor.md): Rsdoctor is a Rspack build analysis tool. In Modern.js, we recommend using Rsdoctor to diagnose and analyze the build process and build outputs.
 - [Using Storybook](/guides/basic-features/debug/using-storybook.md): Storybook is a tool specifically designed for component debugging. It provides: A rich variety of debugging capabilitiesIntegration with some testing toolsReusable documentation contentSharing capabilitiesWorkflow automation
 - [Rstest](/guides/basic-features/testing/rstest.md): Rstest is a testing framework developed by the Rspack team and built on top of Rspack for fast test execution. This guide explains how to integrate Rstest with Modern.js for web app testing.
-- [Playwright](/guides/basic-features/testing/playwright.md): Playwright is a testing framework that allows you to run tests automatically in Chromium, Firefox, and WebKit environments using a single API. You can use it to write E2E tests. To use Playwright in Modern.js, you need to install the dependencies first. You can run the following commands: <PackageManagerTabs command={{ npm: "npm init playwright", yarn: "yarn create playwright", pnpm: "pnpm create playwright" }} /> The above commands will automatically install Playwright dependencies and help you install and configure it in your project through a series of prompts, including adding a playwright.config.ts file. After creating with the default configuration, you can see the following files in your project: This is the default test file. Now create some new pages and test them.
+- [Playwright](/guides/basic-features/testing/playwright.md): Playwright is a testing framework that allows you to run tests automatically in Chromium, Firefox, and WebKit environments using a single API. You can use it to write E2E tests. To use Playwright in Modern.js, you need to install the dependencies first. You can run the following commands: <PackageManagerTabs command={{ npm: 'npm init playwright', yarn: 'yarn create playwright', pnpm: 'pnpm create playwright', }} /> The above commands will automatically install Playwright dependencies and help you install and configure it in your project through a series of prompts, including adding a playwright.config.ts file. After creating with the default configuration, you can see the following files in your project: This is the default test file. Now create some new pages and test them.
 - [Path Alias](/guides/basic-features/alias.md): Path aliases allow developers to define aliases for modules, making it easier to reference them in code. This can be useful when you want to use a short, easy-to-remember name for a module instead of a long, complex path. For example, if you frequently reference the src/common/request.ts module in your project, you can define an alias for it as @request and then use `` in your code instead of writing the full relative path every time. This also allows you to move the module to a different location without needing to update all the import statements in your code. In Modern.js, there are two ways to set up path aliases: Through the paths configuration in tsconfig.json.Through the source.alias configuration.
 - [Environment Variables](/guides/basic-features/env-vars.md): Modern.js provides support for environment variables, including built-in environment variables and custom environment variables.
 - [Output Files](/guides/basic-features/output-files.md): This chapter will introduces the directory structure of output files and how to control the output directory of different types of files.
@@ -99,7 +99,7 @@
 - [hmr](/configure/app/dev/hmr.md): Type: booleanDefault: true Whether to enable Hot Module Replacement.
 - [host](/configure/app/dev/host.md): Type: stringDefault: 0.0.0.0 Specify the host that the dev server listens to. By default, the dev server will listen to 0.0.0.0, which means listening to all network interfaces, including localhost and public network addresses. If you want the dev server to listen only on localhost, you can set it to:
 - [https](/configure/app/dev/https.md): Type: boolean | { key: string; cert: string }Default: false After configuring this option, you can enable HTTPS Dev Server, and disabling the HTTP Dev Server. HTTP: HTTPS: Automatically generate certificates You can directly set https to true, Modern.js will automatically generate the HTTPS certificate based on devcert. When using this method, you need to manually install the devcert dependency in your project: Then configure dev.https to true: The devcert has some limitations, it does not currently support IP addresses yet. Manually set the certificate You can also manually pass in the certificate and the private key required in the dev.https option. This parameter will be directly passed to the createServer method of the https module in Node.js. For details, please refer to https.createServer. Clean up cert cache The certificate created by devcert is saved in ~/Library/Application\ Support/devcert. You may do some cleanup if needed.
-- [lazyCompilation](/configure/app/dev/lazy-compilation.md): Type: Default: false Enable lazy compilation (compilation on demand), implemented based on Rspack's lazy compilation feature.
+- [lazyCompilation](/configure/app/dev/lazy-compilation.md): Type: Default: depends on how the application renders:Pure CSR and streaming SSR applications: { imports: true, entries: false }, which compiles dynamic imports on demand;Applications using string SSR (including any entry in server.ssrByEntries using string SSR), RSC or SSG: false. Enable lazy compilation (compilation on demand), implemented based on Rspack's lazy compilation feature. This option only takes effect in the dev server and does not affect production build output. When enabled for streaming SSR applications, route components are still compiled eagerly so that first-screen JS/CSS injection stays correct. An explicitly configured dev.lazyCompilation always takes precedence over the default. To disable it:
 - [liveReload](/configure/app/dev/live-reload.md): Type: booleanDefault: true Whether to reload the page when source files are changed.
 - [mockDir](/configure/app/dev/mock-dir.md): Type: stringDefault: './config/mock' Sets the directory containing the Mock API entry file. Relative paths are resolved from the application directory, and absolute paths are also supported. Modern.js loads index.ts or index.js from this directory during development. For example, move the Mock API entry to mocks/index.ts: This is also useful in a monorepo when multiple applications share one Mock directory:
 - [progressBar](/configure/app/dev/progress-bar.md): Type: Default: true Whether to display progress bar during compilation.
@@ -226,11 +226,11 @@
 - [Introduction](/plugin/introduction.md): Modern.js provides a powerful plugin system that allows developers to extend the framework's functionality, customize the build process, and meet a variety of personalized development needs. Whether you want to add a custom command, optimize build output, or implement a unique deployment solution, Modern.js's plugin system provides robust support.
 - [Plugin System](/plugin/plugin-system.md): Modern.js adopts a highly extensible, plugin-based architecture, where its core functionalities and extended capabilities are implemented through plugins. The plugin system not only ensures the framework's flexibility but also provides developers with powerful customization options. This document focuses on how to write Modern.js plugins, helping you quickly get started with plugin development.
 - [CLI Plugin API](/plugin/cli-plugins/api.md): Modern.js's CLI plugins allow you to extend and customize the functionality of Modern.js projects during the build and development process.
-- [Life Cycle](/plugin/cli-plugins/life-cycle.md): `} </Mermaid>
+- [Life Cycle](/plugin/cli-plugins/life-cycle.md): `}
 - [Plugin API](/plugin/runtime-plugins/api.md): Modern.js's Runtime Plugins allow you to extend and modify the behavior of your application during its React code execution. With Runtime Plugins, you can easily perform initialization tasks, implement React Higher-Order Component (HOC) wrapping, and more.
-- [Life Cycle](/plugin/runtime-plugins/life-cycle.md): `} </Mermaid>
+- [Life Cycle](/plugin/runtime-plugins/life-cycle.md): `}
 - [Plugin API](/plugin/server-plugins/api.md): Modern.js's Server plugins allow you to extend and customize functionality during the server-side request processing phase, such as adding middleware, modifying request responses, etc.
-- [Life Cycle](/plugin/server-plugins/life-cycle.md): `} </Mermaid>
+- [Life Cycle](/plugin/server-plugins/life-cycle.md): `}
 - [Overview](/plugin/official/cli-plugins.md): @modern-js/plugin-bff: Provides BFF services and unified invocation capabilities.@modern-js/plugin-ssg: Provides static site generation capabilities.
 - [BFF Plugin](/plugin/official/cli-plugins/plugin-bff.md): In a Modern.js application, developers can define API files under the api/lambda directory and export API functions using the BFF plugin. In the frontend code, these API functions can be directly invoked by importing the file, which initiates the API requests. For more details, refer to BFF - Basic Usage.
 - [SSG Plugin](/plugin/official/cli-plugins/plugin-ssg.md): SSG (Static Site Generation) is a technical solution that renders complete static web pages at build time based on data and templates. This means that in a production environment, pages are populated with content by default and can be cached by a CDN. For pages that do not require dynamic data, SSG can provide better performance and higher security. For more details, refer to Static Site Generation (SSG).

package/docs/plugin/cli-plugins/api.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # CLI Plugin API
 
 Modern.js's CLI plugins allow you to extend and customize the functionality of Modern.js projects during the build and development process.

package/docs/plugin/cli-plugins/life-cycle.md

@@ -1,2 +1,4 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Life Cycle
 

package/docs/plugin/introduction.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Introduction
 
 Modern.js provides a powerful plugin system that allows developers to extend the framework's functionality, customize the build process, and meet a variety of personalized development needs. Whether you want to add a custom command, optimize build output, or implement a unique deployment solution, Modern.js's plugin system provides robust support.

package/docs/plugin/official/cli-plugins/plugin-bff.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # BFF Plugin
 
 In a Modern.js application, developers can define API files under the `api/lambda` directory and export API functions using the BFF plugin. In the frontend code, these API functions can be directly invoked by importing the file, which initiates the API requests.

package/docs/plugin/official/cli-plugins/plugin-ssg.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # SSG Plugin
 
 SSG (Static Site Generation) is a technical solution that renders complete static web pages at build time based on data and templates. This means that in a production environment, pages are populated with content by default and can be cached by a CDN. For pages that do not require dynamic data, SSG can provide better performance and higher security.

package/docs/plugin/official/cli-plugins/plugin-styled-components.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Styled Components Plugin
 
 In a Modern.js application, developers can use the Styled Components plugin to utilize the styled-components library within the app, enabling CSS-in-JS functionality.

package/docs/plugin/official/cli-plugins.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Overview
 
 - [@modern-js/plugin-bff](/plugin/official/cli-plugins/plugin-bff.md): Provides BFF services and unified invocation capabilities.

package/docs/plugin/plugin-system.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Plugin System
 
 Modern.js adopts a highly extensible, plugin-based architecture, where its core functionalities and extended capabilities are implemented through plugins. The plugin system not only ensures the framework's flexibility but also provides developers with powerful customization options. This document focuses on how to write Modern.js plugins, helping you quickly get started with plugin development.
@@ -190,9 +192,7 @@ Example:
 // Define Hooks
 import { createSyncHook } from '@modern-js/plugin';
 
-type RouteObject = {
-  /** TODO **/
-};
+type RouteObject = {/** TODO **/};
 const modifyRoutes = createSyncHook<(routes: RouteObject[]) => RouteObject[]>();
 
 // Register Hooks in the plugin

package/docs/plugin/runtime-plugins/api.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Plugin API
 
 Modern.js's Runtime Plugins allow you to extend and modify the behavior of your application during its React code execution. With Runtime Plugins, you can easily perform initialization tasks, implement React Higher-Order Component (HOC) wrapping, and more.

package/docs/plugin/runtime-plugins/life-cycle.md

@@ -1,2 +1,4 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Life Cycle
 

package/docs/plugin/server-plugins/api.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Plugin API
 
 Modern.js's Server plugins allow you to extend and customize functionality during the server-side request processing phase, such as adding middleware, modifying request responses, etc.

package/docs/plugin/server-plugins/life-cycle.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Life Cycle
 
 

package/docs/tutorials/examples/csr-auth.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Route Authorization
 
 Modern.js defaults to the convention-based routing based on React Router v7. For more details, please refer to [Routing](/guides/basic-features/routes/routes.md#routing).

package/docs/tutorials/foundations/introduction.md

@@ -1,3 +1,5 @@
+> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
+
 # Modern.js Example Library
 
 Welcome to Modern.js Example Library! Here you'll find practical code examples to help you get started with Modern.js quickly.

package/lib/types.d.ts

@@ -186,7 +186,6 @@ declare module '*?url' {
   export default src;
 }
 
-
 declare module '*.css' {
   const classes: { readonly [key: string]: string };
   export default classes;

package/package.json

@@ -15,7 +15,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.9.3",
+  "version": "3.10.0",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
   "exports": {
@@ -114,10 +114,10 @@
   },
   "dependencies": {
     "@babel/parser": "^7.29.9",
-    "@babel/traverse": "^7.29.8",
+    "@babel/traverse": "^7.29.10",
     "@babel/types": "^7.29.8",
-    "@rsbuild/core": "2.2.9",
-    "@swc/core": "1.15.41",
+    "@rsbuild/core": "2.2.13",
+    "@swc/core": "1.16.18",
     "@swc/helpers": "^0.5.17",
     "es-module-lexer": "^1.7.0",
     "flatted": "^3.4.4",
@@ -126,19 +126,18 @@
     "ndepe": "^0.1.13",
     "pkg-types": "^1.3.1",
     "std-env": "^3.10.0",
-    "@modern-js/builder": "3.9.3",
-    "@modern-js/i18n-utils": "3.9.3",
-    "@modern-js/plugin": "3.9.3",
-    "@modern-js/plugin-data-loader": "3.9.3",
-    "@modern-js/prod-server": "3.9.3",
-    "@modern-js/server": "3.9.3",
-    "@modern-js/server-utils": "3.9.3",
-    "@modern-js/server-core": "3.9.3",
-    "@modern-js/types": "3.9.3",
-    "@modern-js/utils": "3.9.3"
+    "@modern-js/builder": "3.10.0",
+    "@modern-js/i18n-utils": "3.10.0",
+    "@modern-js/plugin": "3.10.0",
+    "@modern-js/plugin-data-loader": "3.10.0",
+    "@modern-js/prod-server": "3.10.0",
+    "@modern-js/server": "3.10.0",
+    "@modern-js/server-core": "3.10.0",
+    "@modern-js/server-utils": "3.10.0",
+    "@modern-js/utils": "3.10.0",
+    "@modern-js/types": "3.10.0"
   },
   "devDependencies": {
-    "@rslib/core": "1.0.1",
     "@types/babel__traverse": "7.28.0",
     "@types/node": "^20",
     "ts-node": "^10.9.2",
@@ -165,8 +164,8 @@
     "access": "public"
   },
   "scripts": {
-    "dev": "rslib build --watch",
-    "build": "rslib build && node ./bin/modern-bundle-docs.js",
+    "dev": "rs lib --watch",
+    "build": "rs lib && node ./bin/modern-bundle-docs.js",
     "test": "rstest"
   }
 }

package/{rslib.config.mts → rstack.config.mts}

@@ -1,8 +1,8 @@
 import path from 'path';
 import { rslibConfig } from '@modern-js/rslib';
-import { defineConfig } from '@rslib/core';
+import { define } from 'rstack';
 
-export default defineConfig({
+define.lib({
   ...rslibConfig,
   lib: rslibConfig.lib?.map(libConfig => {
     return {
@@ -37,11 +37,11 @@ export default defineConfig({
               ]),
           {
             from: 'plugins/deploy/platforms/templates/*.cjs',
-            context: path.join(__dirname, 'src'),
+            context: path.join(import.meta.dirname, 'src'),
           },
           {
             from: 'plugins/deploy/platforms/templates/*.mjs',
-            context: path.join(__dirname, 'src'),
+            context: path.join(import.meta.dirname, 'src'),
           },
         ],
       },

package/dist/cjs/types/config/testing.js

@@ -1,18 +0,0 @@
-"use strict";
-var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.r = (exports1)=>{
-        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
-            value: 'Module'
-        });
-        Object.defineProperty(exports1, '__esModule', {
-            value: true
-        });
-    };
-})();
-var __webpack_exports__ = {};
-__webpack_require__.r(__webpack_exports__);
-for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
-Object.defineProperty(exports, '__esModule', {
-    value: true
-});

package/dist/esm-node/types/config/testing.mjs

@@ -1 +0,0 @@
-import "node:module";

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

@@ -1,8 +0,0 @@
-import type { TestConfig } from '@modern-js/types';
-export interface TestingUserConfig {
-    /**
-     * Decide which transformer will be used to compile file
-     * @default 'babel-jest'
-     */
-    transformer?: TestConfig['transformer'];
-}