@bleedingdev/modern-js-main-doc 3.8.1-ultramodern.4 → 3.8.2-ultramodern.2

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.
Files changed (7) hide show
  1. package/docs/en/configure/app/server/rsc.mdx +2 -2
  2. package/docs/en/guides/basic-features/render/rsc.mdx +2 -2
  3. package/docs/en/guides/get-started/ultramodern.mdx +19 -16
  4. package/docs/zh/configure/app/server/rsc.mdx +2 -2
  5. package/docs/zh/guides/basic-features/render/rsc.mdx +2 -2
  6. package/docs/zh/guides/get-started/ultramodern.mdx +16 -16
  7. package/package.json +2 -2
package/docs/en/configure/app/server/rsc.mdx CHANGED
@@ -10,9 +10,9 @@ title: rsc
10
10
  Configure React Server Components (RSC).
11
11
 
12
12
  :::warning UltraModern availability
13
- RSC is not shipped or supported in the current UltraModern company distribution. Keep this option `false`. The Rspack Flight runtime remains under upstream review, and enabling RSC intentionally fails unless an application supplies the complete optional toolchain.
13
+ RSC is experimental, default-off, and unsupported for external consumers; it is not shipped in the current UltraModern company distribution. Release-cohort and clean-room release-acceptance tests verify that RSC runtimes are absent and cannot resolve, and the release cohort has no maintained `@bleedingdev/*` RSC runtime package; when enabled, the framework intentionally fails closed unless an application supplies the complete optional toolchain.
14
14
 
15
- Do not install `react-server-dom-rspack` or add an application-level pnpm patch to bypass this boundary.
15
+ The root-only `react-server-dom-rspack@0.0.3` patch backports Flight decoder security fixes for this repository's RSC tests; it is never copied into generated workspaces or published to consumers, so an app installing the upstream package receives unpatched bytes. [SyMind/react#1](https://github.com/SyMind/react/pull/1) merged on 2026-08-11; [BleedingDev/react#1](https://github.com/BleedingDev/react/pull/1) and [rspack#15144](https://github.com/web-infra-dev/rspack/issues/15144) remain open. npm still reports `react-server-dom-rspack` `latest` as `0.0.3`, with no patched consumer release, so the root-only patch remains necessary for this repository's RSC tests. This boundary is pending final owner ratification.
16
16
  :::
17
17
 
18
18
  ```ts title="modern.config.ts"
package/docs/en/guides/basic-features/render/rsc.mdx CHANGED
@@ -22,9 +22,9 @@ Before starting, we recommend reading React's official [Server Components docume
22
22
  ## Quick Start
23
23
 
24
24
  :::warning UltraModern availability
25
- RSC is not shipped or supported in the current UltraModern company distribution. The framework keeps [`server.rsc`](/configure/app/server/rsc) disabled while the Rspack Flight runtime is completed upstream. Do not install `react-server-dom-rspack` or carry an application-level pnpm patch to enable it early.
25
+ RSC is experimental, default-off, and unsupported for external consumers; it is not shipped in the current UltraModern company distribution. Release-cohort and clean-room release-acceptance tests verify that RSC runtimes are absent and cannot resolve, and the release cohort has no maintained `@bleedingdev/*` RSC runtime package; when enabled, the framework intentionally fails closed unless an application supplies the complete optional toolchain.
26
26
 
27
- The remainder of this page is retained as reference material for future upstream adoption.
27
+ The root-only `react-server-dom-rspack@0.0.3` patch backports Flight decoder security fixes for this repository's RSC tests; it is never copied into generated workspaces or published to consumers, so an app installing the upstream package receives unpatched bytes. [SyMind/react#1](https://github.com/SyMind/react/pull/1) merged on 2026-08-11; [BleedingDev/react#1](https://github.com/BleedingDev/react/pull/1) and [rspack#15144](https://github.com/web-infra-dev/rspack/issues/15144) remain open. npm still reports `react-server-dom-rspack` `latest` as `0.0.3`, with no patched consumer release, so the root-only patch remains necessary for this repository's RSC tests. This boundary is pending final owner ratification.
28
28
  :::
29
29
 
30
30
  Keep [`server.rsc`](/configure/app/server/rsc) set to `false`:
package/docs/en/guides/get-started/ultramodern.mdx CHANGED
@@ -78,20 +78,22 @@ mise exec -- pnpm check
78
78
  mise exec -- pnpm build
79
79
  ```
80
80
 
81
- ### Migrating to `3.5.0-ultramodern.18`
81
+ ### Migrating localized Cloudflare SSR workspaces
82
82
 
83
- Use `3.5.0-ultramodern.18` or newer for localized Cloudflare SSR workspaces.
84
- This cohort moves bare locale-root redirects into the framework-owned
83
+ Current cohorts localize Cloudflare SSR workspaces.
84
+ The framework moves bare locale-root redirects into the framework-owned
85
85
  Cloudflare Worker entry and the i18n server runtime. A request for `/` is
86
86
  redirected server-side with `302` to the negotiated locale path, for example
87
87
  `/cs` for `Accept-Language: cs-CZ` or `/en` for English and fallback traffic.
88
88
 
89
89
  Existing generated workspaces should upgrade the whole BleedingDev Modern
90
- package cohort together:
90
+ package cohort together. Resolve the current cohort version first, then run
91
+ the matching migration:
91
92
 
92
93
  ```bash
93
- pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.18 ultramodern \
94
- migrate-strict-effect --version 3.5.0-ultramodern.18
94
+ COHORT="$(npm view @bleedingdev/modern-js-create version)"
95
+ pnpm dlx "@bleedingdev/modern-js-create@$COHORT" ultramodern \
96
+ migrate-strict-effect --version "$COHORT"
95
97
  pnpm install
96
98
  pnpm check
97
99
  pnpm build
@@ -114,22 +116,23 @@ Do not fix older root `404` responses by adding app-owned root route files,
114
116
  client-side redirects, custom navigation wrappers, Cloudflare Worker
115
117
  postprocessing, generated output edits, or local redirect shims. If `/` still
116
118
  returns `404` after upgrading, confirm the production build log shows
117
- `Modern.js Framework v3.5.0-ultramodern.18` or newer and redeploy the Worker.
119
+ `Modern.js Framework v<cohort-version>` for the cohort you migrated to and
120
+ redeploy the Worker.
118
121
 
119
- Strict generated API migration requires `3.5.0-ultramodern.10` or newer.
120
- `3.4.0-ultramodern.20` and earlier cohorts do not include this full direct
121
- `api/index.ts` generator, generated `.mts` checks, strict Oxlint boundary rule
122
- set, Effect cohort overrides, and strict Effect migration command. Agents that
123
- cannot install that BleedingDev cohort yet should use the local Modern.js
124
- workspace for migration validation; otherwise pin `3.5.0-ultramodern.10` or
125
- newer with `--ultramodern-package-version`.
122
+ Strict generated API migration is part of every current cohort: the direct
123
+ `api/index.ts` generator, generated `.mts` checks, the strict Oxlint boundary
124
+ rule set, Effect cohort overrides, and the strict Effect migration command.
125
+ Agents that cannot install the BleedingDev cohort yet should use the local
126
+ Modern.js workspace for migration validation; otherwise pin the target cohort
127
+ with `--ultramodern-package-version`.
126
128
 
127
129
  Before hand-editing package aliases or generated metadata, run the framework
128
130
  migration command from the target workspace:
129
131
 
130
132
  ```bash
131
- pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.10 ultramodern \
132
- migrate-strict-effect --version 3.5.0-ultramodern.10
133
+ COHORT="$(npm view @bleedingdev/modern-js-create version)"
134
+ pnpm dlx "@bleedingdev/modern-js-create@$COHORT" ultramodern \
135
+ migrate-strict-effect --version "$COHORT"
133
136
  pnpm api:check
134
137
  pnpm contract:check
135
138
  ```
package/docs/zh/configure/app/server/rsc.mdx CHANGED
@@ -10,9 +10,9 @@ title: rsc
10
10
  配置 React Server Components (RSC)。
11
11
 
12
12
  :::warning UltraModern 可用性
13
- 当前 UltraModern 公司发行版不提供也不支持 RSC。请保持该选项为 `false`。Rspack Flight 运行时仍在上游审查中；除非应用显式提供完整的可选工具链，否则启用 RSC 会按设计失败。
13
+ RSC 仍属实验性能力，默认关闭，且不对外部消费者提供支持；当前 UltraModern 公司发行版不会随附 RSC。发布批次与 clean-room 发布验收测试验证 RSC 运行时不存在且无法解析，发布批次也没有已维护的 `@bleedingdev/*` RSC 运行时包；启用 RSC 时，除非应用提供完整的可选工具链，否则框架会按 fail-closed 处理。
14
14
 
15
- 请勿安装 `react-server-dom-rspack`，也不要添加应用级 pnpm 补丁来绕过此边界。
15
+ 根目录专用的 `react-server-dom-rspack@0.0.3` 补丁仅为本仓库的 RSC 回归测试回移 Flight 解码器安全修复；它不会复制到生成工作区或发布给消费者，因此应用自行安装上游包得到的是未打补丁的字节。[SyMind/react#1](https://github.com/SyMind/react/pull/1) 已于 2026-08-11 合并；[BleedingDev/react#1](https://github.com/BleedingDev/react/pull/1) 与 [rspack#15144](https://github.com/web-infra-dev/rspack/issues/15144) 仍处于 open 状态。npm 上 `react-server-dom-rspack` 的 `latest` 仍为 `0.0.3`，且没有包含补丁的消费者发行版，因此根目录补丁对于本仓库的 RSC 测试仍是必要的。此边界仍待所有者最终批准。
16
16
  :::
17
17
 
18
18
  ```ts title="modern.config.ts"
package/docs/zh/guides/basic-features/render/rsc.mdx CHANGED
@@ -22,9 +22,9 @@ React Server Components (RSC) 是一种新的组件类型，允许在服务端
22
22
  ## 快速开始
23
23
 
24
24
  :::warning UltraModern 可用性
25
- 当前 UltraModern 公司发行版不提供也不支持 RSC。在 Rspack Flight 运行时完成上游工作之前，框架会保持 [`server.rsc`](/configure/app/server/rsc) 关闭。请勿安装 `react-server-dom-rspack`，也不要携带应用级 pnpm 补丁来提前启用它。
25
+ RSC 仍属实验性能力，默认关闭，且不对外部消费者提供支持；当前 UltraModern 公司发行版不会随附 RSC。发布批次与 clean-room 发布验收测试验证 RSC 运行时不存在且无法解析，发布批次也没有已维护的 `@bleedingdev/*` RSC 运行时包；启用 RSC 时，除非应用提供完整的可选工具链，否则框架会按 fail-closed 处理。
26
26
 
27
- 本页其余内容仅作为未来采用上游实现时的参考资料保留。
27
+ 根目录专用的 `react-server-dom-rspack@0.0.3` 补丁仅为本仓库的 RSC 回归测试回移 Flight 解码器安全修复；它不会复制到生成工作区或发布给消费者，因此应用自行安装上游包得到的是未打补丁的字节。[SyMind/react#1](https://github.com/SyMind/react/pull/1) 已于 2026-08-11 合并；[BleedingDev/react#1](https://github.com/BleedingDev/react/pull/1) 与 [rspack#15144](https://github.com/web-infra-dev/rspack/issues/15144) 仍处于 open 状态。npm 上 `react-server-dom-rspack` 的 `latest` 仍为 `0.0.3`，且没有包含补丁的消费者发行版，因此根目录补丁对于本仓库的 RSC 测试仍是必要的。此边界仍待所有者最终批准。
28
28
  :::
29
29
 
30
30
  请保持 [`server.rsc`](/configure/app/server/rsc) 为 `false`：
package/docs/zh/guides/get-started/ultramodern.mdx CHANGED
@@ -71,18 +71,19 @@ mise exec -- pnpm check
71
71
  mise exec -- pnpm build
72
72
  ```
73
73
 
74
- ### 迁移到 `3.5.0-ultramodern.18`
74
+ ### 迁移本地化 Cloudflare SSR workspace
75
75
 
76
- 本地化 Cloudflare SSR workspace 应使用 `3.5.0-ultramodern.18` 或更新版本。这个
77
- cohort 将裸 locale root 重定向移动到框架拥有的 Cloudflare Worker entry 和 i18n
76
+ 当前 cohort 均支持本地化 Cloudflare SSR workspace。框架将裸 locale root 重定向移动到框架拥有的 Cloudflare Worker entry 和 i18n
78
77
  server runtime 中。请求 `/` 时，框架会按语言协商在服务端返回 `302`，例如
79
78
  `Accept-Language: cs-CZ` 会跳转到 `/cs`，英语或 fallback 流量会跳转到 `/en`。
80
79
 
81
- 既有生成 workspace 应整体升级同一个 BleedingDev Modern package cohort：
80
+ 既有生成 workspace 应整体升级同一个 BleedingDev Modern package cohort。
81
+ 先解析当前 cohort 版本，再运行同版本迁移命令：
82
82
 
83
83
  ```bash
84
- pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.18 ultramodern \
85
- migrate-strict-effect --version 3.5.0-ultramodern.18
84
+ COHORT="$(npm view @bleedingdev/modern-js-create version)"
85
+ pnpm dlx "@bleedingdev/modern-js-create@$COHORT" ultramodern \
86
+ migrate-strict-effect --version "$COHORT"
86
87
  pnpm install
87
88
  pnpm check
88
89
  pnpm build
@@ -102,21 +103,20 @@ redirect 后，应返回匹配语言的 SSR 页面，文档语言和 i18n SSR
102
103
 
103
104
  不要通过 app 自有 root route、客户端 redirect、自定义导航 wrapper、Cloudflare Worker
104
105
  postprocess、生成产物编辑或本地 redirect shim 来修复旧版本的 root `404`。如果升级后
105
- `/` 仍然返回 `404`，先确认生产构建日志显示
106
- `Modern.js Framework v3.5.0-ultramodern.18` 或更新版本，然后重新部署 Worker。
106
+ `/` 仍然返回 `404`，先确认生产构建日志显示的
107
+ `Modern.js Framework v<cohort-version>` 就是迁移目标 cohort，然后重新部署 Worker。
107
108
 
108
- 严格生成 API 迁移要求 `3.5.0-ultramodern.10` 或更新版本。
109
- `3.4.0-ultramodern.20` 及更早 cohort 还没有这套完整的直接
110
- `api/index.ts` 生成器、生成的 `.mts` 检查、严格 Oxlint 边界规则、Effect 版本组
111
- overrides 和严格 Effect 迁移命令。还不能安装该 BleedingDev cohort 的 agent 应使用本地
112
- Modern.js workspace 做迁移校验；否则用 `--ultramodern-package-version` 固定
113
- `3.5.0-ultramodern.10` 或更新版本。
109
+ 严格生成 API 迁移是当前每个 cohort 的组成部分：直接 `api/index.ts` 生成器、生成的
110
+ `.mts` 检查、严格 Oxlint 边界规则、Effect 版本组 overrides 和严格 Effect 迁移命令。
111
+ 还不能安装 BleedingDev cohort 的 agent 应使用本地 Modern.js workspace 做迁移校验；
112
+ 否则用 `--ultramodern-package-version` 固定目标 cohort。
114
113
 
115
114
  手写 package alias 或生成 metadata 之前，先在目标 workspace 运行框架迁移命令：
116
115
 
117
116
  ```bash
118
- pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.10 ultramodern \
119
- migrate-strict-effect --version 3.5.0-ultramodern.10
117
+ COHORT="$(npm view @bleedingdev/modern-js-create version)"
118
+ pnpm dlx "@bleedingdev/modern-js-create@$COHORT" ultramodern \
119
+ migrate-strict-effect --version "$COHORT"
120
120
  pnpm api:check
121
121
  pnpm contract:check
122
122
  ```
package/package.json CHANGED
@@ -19,12 +19,12 @@
19
19
  "modern.js",
20
20
  "ultramodern.js"
21
21
  ],
22
- "version": "3.8.1-ultramodern.4",
22
+ "version": "3.8.2-ultramodern.2",
23
23
  "publishConfig": {
24
24
  "access": "public"
25
25
  },
26
26
  "dependencies": {
27
- "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.8.1-ultramodern.4",
27
+ "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.8.2-ultramodern.2",
28
28
  "mermaid": "^11.16.0"
29
29
  },
30
30
  "devDependencies": {