@bleedingdev/modern-js-app-tools 3.5.0-ultramodern.99 → 3.8.1-ultramodern.1

package/docs/configure/_meta.json

@@ -1,78 +0,0 @@
-[
-  "app/usage",
-  {
-    "type": "dir",
-    "name": "app/dev",
-    "label": "dev",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/bff",
-    "label": "bff",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/html",
-    "label": "html",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/tools",
-    "label": "tools",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/source",
-    "label": "source",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/resolve",
-    "label": "resolve",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/server",
-    "label": "server",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/output",
-    "label": "output",
-    "collapsed": true
-  },
-  "app/plugins",
-  {
-    "type": "dir",
-    "name": "app/security",
-    "label": "security",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/runtime",
-    "label": "runtime",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/performance",
-    "label": "performance",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "app/experiments",
-    "label": "experiments",
-    "collapsed": true
-  },
-  "app/builder-plugins",
-  "app/split-chunks"
-]

package/docs/configure/app/dev/hmr.mdx

@@ -1,14 +0,0 @@
----
-title: hmr
----
-
-# dev.hmr
-
-- **Type:** `boolean`
-- **Default:** `true`
-
-Whether to enable Hot Module Replacement.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="dev.hmr" />

package/docs/configure/app/dev/live-reload.mdx

@@ -1,14 +0,0 @@
----
-title: liveReload
----
-
-# dev.liveReload
-
-- **Type:** `boolean`
-- **Default:** `true`
-
-Whether to reload the page when source files are changed.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="dev.liveReload" />

package/docs/configure/app/dev/progress-bar.mdx

@@ -1,23 +0,0 @@
----
-title: progressBar
----
-
-# dev.progressBar
-
-- **Type:**
-
-```ts
-type ProgressBar =
-  | boolean
-  | {
-      id?: string;
-    };
-```
-
-- **Default:** true
-
-Whether to display progress bar during compilation.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="dev.progressBar" />

package/docs/configure/app/html/inject.mdx

@@ -1,14 +0,0 @@
----
-title: inject
----
-
-# html.inject
-
-- **Type:** `'head' | 'body' | boolean | Function`
-- **Default:** `'head'`
-
-Set the inject position of the `<script>` tag.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="html.inject" />

package/docs/configure/app/html/output-structure.mdx

@@ -1,14 +0,0 @@
----
-title: outputStructure
----
-
-# html.outputStructure
-
-- **Type:** `'flat' | 'nested'`
-- **Default:** `'nested'`
-
-Define the directory structure of the HTML output files.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="html.outputStructure" />

package/docs/configure/app/html/script-loading.mdx

@@ -1,14 +0,0 @@
----
-title: scriptLoading
----
-
-# html.scriptLoading
-
-- **Type:** `'defer' | 'blocking' | 'module'`
-- **Default:** `'defer'`
-
-Used to set how `<script>` tags are loaded.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="html.scriptLoading" />

package/docs/configure/app/html/template.mdx

@@ -1,14 +0,0 @@
----
-title: template
----
-
-# html.template
-
-- **Type:** `string | Function`
-- **Default:**
-
-Specifies the file path for the HTML template, which can be a relative or absolute path.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="html.template" />

package/docs/configure/app/html/title.mdx

@@ -1,22 +0,0 @@
----
-title: title
----
-
-# html.title
-
-- **Type:** `string ｜ Function`
-- **Default:** `''`
-
-Set the title tag of the HTML page, for example:
-
-```js
-export default {
-  html: {
-    title: 'example',
-  },
-};
-```
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="html.title" />

package/docs/configure/app/output/asset-prefix.mdx

@@ -1,18 +0,0 @@
----
-title: assetPrefix
----
-
-# output.assetPrefix
-
-- **Type:** `string | 'auto'`
-- **Default:** `'/'`
-
-In production mode, use this option to set the URL prefix for static assets, such as setting it to a CDN URL.
-
-import OutputAssetPrefixExtend from '@site-docs-en/components/output-asset-prefix-extend';
-
-<OutputAssetPrefixExtend />
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="output.assetPrefix" />

package/docs/configure/app/output/filename-hash.mdx

@@ -1,14 +0,0 @@
----
-title: filenameHash
----
-
-# output.filenameHash
-
-- **Type:** `boolean | string`
-- **Default:** `true`
-
-Whether to add a hash value to the filename after the production build.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="output.filenameHash" />

package/docs/configure/app/output/inject-styles.mdx

@@ -1,14 +0,0 @@
----
-title: injectStyles
----
-
-# output.injectStyles
-
-- **Type:** `boolean`
-- **Default:** `false`
-
-Whether to inject styles into DOM.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="output.injectStyles" />

package/docs/configure/app/output/polyfill.mdx

@@ -1,18 +0,0 @@
----
-title: polyfill
----
-
-# output.polyfill
-
-- **Type:** `'entry' | 'usage' | 'ua' | 'off'`
-- **Default:** `'entry'`
-
-Via `output.polyfill` you can configure how the polyfill is injected.
-
-import OutputPolyfillExtend from '@site-docs-en/components/output-polyfill-extend';
-
-<OutputPolyfillExtend />
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="output.polyfill" />

package/docs/configure/app/performance/preconnect.mdx

@@ -1,20 +0,0 @@
----
-title: preconnect
----
-
-# performance.preconnect
-
-- **Type:** `undefined | Array<string | PreconnectOption>`
-
-```ts
-interface PreconnectOption {
-  href: string;
-  crossorigin?: boolean;
-}
-```
-
-- **Default:** `undefined`
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="performance.preconnect" />

package/docs/configure/app/performance/profile.mdx

@@ -1,14 +0,0 @@
----
-title: profile
----
-
-# performance.profile
-
-- **Type:** `boolean`
-- **Default:** `false`
-
-Whether capture timing information for each module, same as the [profile](https://rspack.rs/config/other-options#profile) config of Rspack.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="performance.profile" />

package/docs/configure/app/performance/remove-console.mdx

@@ -1,14 +0,0 @@
----
-title: removeConsole
----
-
-# performance.removeConsole
-
-- **Type:** `boolean | ConsoleType[]`
-- **Default:** `false`
-
-Whether to remove `console.[methodName]` in production build.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="performance.removeConsole" />

package/docs/configure/app/performance/remove-moment-locale.mdx

@@ -1,14 +0,0 @@
----
-title: removeMomentLocale
----
-
-# performance.removeMomentLocale
-
-- **Type:** `boolean`
-- **Default:** `false`
-
-Whether to remove the locales of [moment.js](https://momentjs.com/).
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="performance.removeMomentLocale" />

package/docs/configure/app/resolve/alias.mdx

@@ -1,13 +0,0 @@
----
-title: alias
----
-
-# resolve.alias
-
-- **Type:** `string[]`
-
-Create aliases for module paths to simplify import paths or redirect module references.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="resolve.alias" />

package/docs/configure/app/server/rsc.mdx

@@ -1,30 +0,0 @@
----
-title: rsc
----
-
-# server.rsc
-
-- **Type:** `boolean`
-- **Default:** `false`
-
-Enable React Server Components (RSC) configuration.
-
-When set to `true`, enables React Server Components support in Modern.js. This allows components to be rendered on the server, providing better performance and developer experience.
-
-```ts title="modern.config.ts"
-export default defineConfig({
-  server: {
-    rsc: true,
-  },
-});
-```
-
-:::tip Prerequisites
-Before enabling RSC, ensure:
-1. React and React DOM are upgraded to version 19 (recommended 19.2.4 or above)
-2. Install the `react-server-dom-rspack@0.0.2` dependency
-
-:::
-
-For more information about using RSC, see the [React Server Components guide](/guides/basic-features/render/rsc).
-

package/docs/configure/app/server/ssr.mdx

@@ -1,85 +0,0 @@
----
-title: ssr
----
-
-# server.ssr
-
-- **Type:** `boolean` | `Object`
-- **Default:** `false`
-
-Enable SSR configuration.
-
-### Boolean Type
-
-When the value type is `boolean`, it indicates whether to enable SSR deployment mode. The default is `false` to disable it.
-
-```ts title="modern.config.ts"
-export default defineConfig({
-  server: {
-    ssr: true,
-  },
-});
-```
-
-### Object Type
-
-When the value type is `Object`, the following properties can be configured:
-
-| Name              | Type                                                         | Default                                   | Description                                                                     |
-| ---------------- | ------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------- |
-| mode             | `string`                                  | `stream`          | which defaults to using streaming rendering. Configure `string` to use `renderToString` for rendering       |
-| forceCSR         | `boolean`                                 | `false`           | which is off by default for forcing CSR rendering. Configure `true` to force CSR by adding `?csr=true` or adding `x-modern-ssr-fallback` header when accessing the page |
-| unsafeHeaders    | `string[]`                                | `[]`              | For safety reasons, Modern.js does not add excessive content to SSR_DATA. Developers can use this configuration to specify the headers that need to be injected      |
-| loaderFailureMode| `clientRender \| errorBoundary`           | `errorBoundary`   | The default configuration is `'errorBoundary'`, when an error occurs in [data loader](/en/guides/basic-features/data/data-fetch.html#data-loader-recommended), it will default to rendering the [`Error`](/guides/basic-features/routes/routes#error-handling) component of the route. When configured as `'clientRender'`, if a loader throws an error, it switch to client-side rendering，you can use it with [Client Loader](/en/guides/basic-features/data/data-fetch.html#client-loader) |
-| moduleFederationAppSSR | `boolean`                            | `false`           | Enables app-level Module Federation SSR contract handshake. Enable this in both host and remote apps when using app-level MF SSR |
-
-
-```ts title="modern.config.ts"
-export default defineConfig({
-  server: {
-    ssr: {
-      forceCSR: true,
-      mode: 'stream',
-      unsafeHeaders: ['User-Agent'],
-      moduleFederationAppSSR: true,
-    },
-  },
-});
-```
-
-### Active Fallback
-
-In a production environment, there are scenarios where it is necessary to actively fallback an SSR project to CSR. Examples include
-
-1. When the SSR fails, a fallback to the CSR is required to ensure product availability.
-
-2. When the SSR is working normally, but there are rendering failures during csr, debugging is required.
-
-3. When the SSR server is under heavy load, it may be necessary to fallback some traffic directly to the CSR to avoid service downtime.
-
-By configuring `server.ssr.forceCSR` to `true` in the project, you can control this behavior through query strings or request headers.
-
-For example, in a custom Web Server middleware, you can actively fallback when traffic exceeds a certain threshold:
-
-```ts title="server/modern.server.ts"
-import {
-  defineServerConfig,
-  type MiddlewareHandler,
-} from '@modern-js/server-runtime';
-
-export const handler: MiddlewareHandler = async (c, next) => {
-  if (condition) {
-    c.set('forceCSR', '1');
-  }
-  await next();
-};
-
-export default defineServerConfig({
-  middlewares: [
-    {
-      name: 'request-middleware',
-      handler,
-    },
-  ],
-});
-```

package/docs/configure/app/source/enable-async-entry.mdx

@@ -1,54 +0,0 @@
----
-title: enableAsyncEntry
----
-
-# source.enableAsyncEntry
-
-- **Type:** `boolean`
-- **Default:** `false`
-
-This option is used for Rspack Module Federation scenario.
-
-When this option is enabled, Modern.js will wrap the automatically generated entry files with dynamic import (Asynchronous Boundaries), allowing page code to consume remote modules generated by Module Federation.
-
-## Background
-
-import ModuleFederation from '@site-docs-en/components/module-federation.mdx';
-
-<ModuleFederation />
-
-## Example
-
-First, enable this option in the configuration file:
-
-```ts title="modern.config.ts"
-export default defineConfig({
-  source: {
-    enableAsyncEntry: true,
-  },
-});
-```
-
-Then run the `dev` or `build` command, and you will see that the files automatically generated by Modern.js have the following structure:
-
-```bash
-node_modules
-  └─ .modern-js
-     └─ main
-        ├─ bootstrap.jsx  # asynchronous entry file
-        ├─ index.js      # real entry code
-        └─ index.html
-```
-
-The contents of `bootstrap.js` are as follows:
-
-```js
-import('./index.jsx');
-```
-
-At this point, you can consume any remote module in the current page.
-
-:::info
-Modern.js does not have ModuleFederationPlugin plugin built in. Please configure the ModuleFederationPlugin yourself via [tools.bundlerChain](/configure/app/tools/bundler-chain).
-
-:::

package/docs/configure/app/tools/rspack.mdx

@@ -1,14 +0,0 @@
----
-title: rspack
----
-
-# tools.rspack
-
-- **Type:** `Rspack.Configuration | Function | undefined`
-- **Default:** `undefined`
-
-`tools.rspack` is used to configure [Rspack](https://rspack.rs/).
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="tools.rspack" />

package/docs/configure/app/tools/style-loader.mdx

@@ -1,14 +0,0 @@
----
-title: styleLoader
----
-
-# tools.styleLoader
-
-- **Type:** `Object | Function`
-- **Default:** `{}`
-
-The config of [style-loader](https://github.com/webpack-contrib/style-loader) can be set through `tools.styleLoader`.
-
-import RsbuildConfig from '@site-docs-en/components/rsbuild-config-tooltip';
-
-<RsbuildConfig configName="tools.styleLoader" />

package/docs/guides/_meta.json

@@ -1,37 +0,0 @@
-[
-  {
-    "type": "dir",
-    "name": "get-started",
-    "label": "gettingStarted"
-  },
-  {
-    "type": "dir",
-    "name": "concept",
-    "label": "concept"
-  },
-  {
-    "type": "dir",
-    "name": "basic-features",
-    "label": "basic"
-  },
-  {
-    "type": "dir",
-    "name": "advanced-features",
-    "label": "advanced"
-  },
-  {
-    "type": "dir",
-    "name": "topic-detail",
-    "label": "topic"
-  },
-  {
-    "type": "dir",
-    "name": "troubleshooting",
-    "label": "troubleshooting"
-  },
-  {
-    "type": "dir",
-    "name": "upgrade",
-    "label": "Upgrade"
-  }
-]

package/docs/guides/advanced-features/_meta.json

@@ -1,32 +0,0 @@
-[
-  {
-    "type": "dir",
-    "name": "bff",
-    "label": "use-bff",
-    "collapsed": true
-  },
-
-  {
-    "type": "dir",
-    "name": "page-performance",
-    "label": "page-performance",
-    "collapsed": true
-  },
-  "build-performance",
-  "compatibility",
-  "low-level",
-  "source-build",
-  {
-    "type": "dir",
-    "name": "server-monitor",
-    "label": "server-monitor",
-    "collapsed": true
-  },
-  {
-    "type": "dir",
-    "name": "international",
-    "label": "Internationalization",
-    "collapsed": true
-  },
-  "web-server"
-]

package/docs/guides/advanced-features/bff/_meta.json

@@ -1,10 +0,0 @@
-[
-  "function",
-  "frameworks",
-  "data-platform",
-  "operators",
-  "extend-server",
-  "sdk",
-  "upload",
-  "cross-project"
-]