@bleedingdev/modern-js-main-doc 3.9.0-ultramodern.17 → 3.9.0-ultramodern.19

package/docs/en/configure/app/bff/effect.mdx

@@ -229,10 +229,6 @@ through `pnpm-workspace.yaml` overrides. For the current UltraModern cohort,
 generated apps use:
 
 ```yaml
-trustPolicyExclude:
-  - 'effect@4.0.0-rc.117'
-  - '@effect/opentelemetry@4.0.0-rc.117'
-
 overrides:
   '@effect/opentelemetry': 4.0.0-rc.117
   '@effect/vitest': 4.0.0-rc.117
@@ -244,10 +240,7 @@ Effect prerelease can fail while building layers or HTTP middleware because runt
 services come from different package instances. The strict 24-hour release-age
 gate applies to installed packages; the current cohort has no Effect age
 exemption, and override-only `@effect/vitest` is not an installed approval
-target. `trustPolicyExclude` is a separate policy:
-its exact `effect` and `@effect/opentelemetry` exceptions cover their
-trusted-publisher to provenance metadata transition and are not release-age
-approvals.
+target.
 
 ## Contract tests
 

package/docs/en/configure/app/source/react-compiler.mdx

@@ -11,6 +11,8 @@ Whether to enable [React Compiler](https://react.dev/learn/react-compiler). Reac
 
 Modern.js implements this capability based on the Rust-based React Compiler built into Rspack's `builtin:swc-loader` (equivalent to setting SWC's `jsc.transform.reactCompiler`), reusing Rspack's built-in SWC transform chain without introducing Babel.
 
+The compiler only runs for browser environments (`output.target: 'web'`). Server environments (`node`, the `web-worker` SSR worker and BFF code) render once per request and gain nothing from memoization, so they are never compiled.
+
 :::tip
 This option is disabled by default. It must be enabled explicitly for any React version, including React 19.
 :::

package/docs/en/guides/get-started/ultramodern.mdx

@@ -70,9 +70,7 @@ and `@effect/vitest@4.0.0-rc.117`. Do not add app-local direct Effect
 versions that disagree with those overrides. The strict 24-hour release-age
 gate applies to installed packages; this cohort carries no Effect age
 exemption, and override-only `@effect/vitest` is not an installed approval
-target. Independently, exact `trustPolicyExclude` entries for `effect`
-and `@effect/opentelemetry` cover their trusted-publisher to provenance
-metadata transition; they are not release-age approvals.
+target.
 
 ### Current generated dependency baseline
 

package/docs/en/plugin/server-plugins/api.mdx

@@ -191,6 +191,7 @@ Adds additional logic when the server resets.
       - `'file-change'`: File change event
     - `event.payload`: When `type` is `'file-change'`, contains an array of file change information.
 - **Execution Phase:** When files change or repack is needed.
+- **Repack Order:** On `'repack'` the dev server awaits the handlers in registration order before it purges the previous server bundle from the require cache. A rejecting handler skips the handlers after it. New requests wait until the handlers settle; requests already running keep the modules they loaded. A repack handler must not await a request to the dev server, because that request waits for the handler.
 - **Example:**
 
 ```typescript

package/docs/zh/configure/app/bff/effect.mdx

@@ -221,10 +221,6 @@ UltraModern 生成的 workspace 会通过 `pnpm-workspace.yaml` overrides 锁定
 Effect 版本组。当前 UltraModern 版本组使用：
 
 ```yaml
-trustPolicyExclude:
-  - 'effect@4.0.0-rc.117'
-  - '@effect/opentelemetry@4.0.0-rc.117'
-
 overrides:
   '@effect/opentelemetry': 4.0.0-rc.117
   '@effect/vitest': 4.0.0-rc.117
@@ -235,9 +231,6 @@ overrides:
 middleware 构建可能因为运行时 service 来自不同包实例而失败。严格的 24 小时发布年龄
 门禁适用于实际安装的包；当前版本组没有 Effect 年龄豁免，且仅用于 override 的
 `@effect/vitest` 不是已安装的审批目标。
-`trustPolicyExclude` 是另一项独立策略：其中精确的 `effect` 与
-`@effect/opentelemetry` 例外用于处理 trusted-publisher metadata 向 provenance
-attestation 的迁移，并不等同于 release-age 审批。
 
 ## 契约测试
 

package/docs/zh/configure/app/source/react-compiler.mdx

@@ -11,6 +11,8 @@ title: reactCompiler
 
 Modern.js 基于 Rspack `builtin:swc-loader` 内置的 Rust 版 React Compiler 实现该能力（等价于设置 SWC 的 `jsc.transform.reactCompiler`），复用 Rspack 内置的 SWC 转换链，无需额外引入 Babel。
 
+该编译仅作用于浏览器环境（`output.target: 'web'`）。服务端环境（`node`、`web-worker` SSR Worker 以及 BFF 代码）每次请求只渲染一次，无法从自动记忆化中获益，因此不会被编译。
+
 :::tip
 该配置默认关闭，任何 React 版本下都需要显式开启，包括 React 19。
 :::

package/docs/zh/guides/get-started/ultramodern.mdx

@@ -69,9 +69,6 @@ curl -I -H 'Accept-Language: cs-CZ,cs;q=0.9,en;q=0.1' https://<worker-host>/
 `@effect/vitest@4.0.0-rc.117`。不要添加与这些 overrides 冲突的 app 本地直接
 Effect 版本。严格的 24 小时发布年龄门禁适用于实际安装的包；当前版本组不包含 Effect
 年龄豁免，仅用于 override 的 `@effect/vitest` 也不是已安装的审批目标。
-`trustPolicyExclude` 是独立策略，仅为 `effect` 和
-`@effect/opentelemetry` 保留精确例外，以处理 trusted-publisher metadata 向
-provenance attestation 的迁移；它不属于 release-age 审批。
 
 ### 当前生成依赖基线
 

package/docs/zh/plugin/server-plugins/api.mdx

@@ -191,6 +191,7 @@ api.onPrepare(async () => {
       - `'file-change'`： 文件变化事件
     - `event.payload`： 当 `type` 为 `'file-change'` 时，包含文件变化信息数组。
 - **执行阶段：** 当文件发生变化或需要重新打包时。
+- **重新打包顺序：** 对于 `'repack'`，开发服务器会按注册顺序等待处理函数完成，再从 require 缓存中清除上一代服务端产物。某个处理函数抛出错误时，其后的处理函数不再执行。新请求会等待处理函数完成；已在执行的请求继续使用已加载的模块。重新打包处理函数不能等待发往开发服务器的请求，因为该请求会等待处理函数完成。
 - **示例：**
 
 ```typescript

package/package.json

@@ -19,13 +19,13 @@
     "modern.js",
     "ultramodern.js"
   ],
-  "version": "3.9.0-ultramodern.17",
+  "version": "3.9.0-ultramodern.19",
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.9.0-ultramodern.17",
-    "@modern-js/ultramodern-sandpack-profile": "npm:@bleedingdev/modern-js-ultramodern-sandpack-profile@3.9.0-ultramodern.17",
+    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.9.0-ultramodern.19",
+    "@modern-js/ultramodern-sandpack-profile": "npm:@bleedingdev/modern-js-ultramodern-sandpack-profile@3.9.0-ultramodern.19",
     "mermaid": "^11.17.2"
   },
   "devDependencies": {