@cfp-studio/plugin-react 17.3.0 → 17.3.2

package/README.md

@@ -3,13 +3,16 @@
 React 框架的 CFP Studio 插件，支持 React 组件/Story 静态分析、属性/类型提取、预览渲染、CSF/Storybook 兼容等。
 
 ## 特性
+
 - 自动检测并适配 React 16/17/18+ 项目
 - 支持 React 组件/Story 的批量静态分析与属性/类型提取
 - 兼容 CSF/Storybook 规范，支持 args/参数提取
 - 支持 preview 目录下自定义 Wrapper、ErrorBoundary、不同 React 版本渲染器
 - 内置丰富的 E2E/单元测试用例，覆盖多种工程模板
+- **兼容 UmiJS 4 工程**（`umi` / `@umijs/max`），见下文
 
 ## 架构与工作原理
+
 - 通过 `FrameworkPluginFactory` 实现插件注册与兼容性检测
 - 使用 `@cfp-studio/analyzer-react` 进行 TS/JSX 类型分析
 - `react-js-imports-plugin` 自动为 .js 文件注入 React 导入，兼容 React 17+ 新写法
@@ -17,6 +20,7 @@ React 框架的 CFP Studio 插件，支持 React 组件/Story 静态分析、属
 - 支持多种 React 工程模板（apps/ 下有多种测试工程）
 
 ## 主要 API/模块
+
 - `src/index.ts`：插件主入口，注册工厂与分析器
 - `src/react-js-imports-plugin.ts`：自动注入 React 导入
 - `preview/index.tsx`：前端渲染入口
@@ -24,19 +28,112 @@ React 框架的 CFP Studio 插件，支持 React 组件/Story 静态分析、属
 - `tests/`、`apps/`：丰富的测试与模板
 
 ## 用法示例
+
 ```ts
-import { reactFrameworkPlugin } from '@cfp-studio/plugin-react';
+import { reactFrameworkPlugin } from "@cfp-studio/plugin-react";
 // 传入 core/Previewer 或 createChromelessWorkspace 等集成
 ```
 
+## UmiJS 支持
+
+支持 **Umi 4**（`umi` 或 `@umijs/max`，已用 `4.7.30` 验证）。Umi 5 不存在，npm 最新即 4.x。
+
+**Umi 3 明确不支持**（不再维护，且用的是 react-router 5，与 Umi 4 是两套语义）。
+Umi 3 工程会走普通 React 路径：不 alias `umi`，也不加 `@/` 别名。
+纯 React 组件能渲染；用了 `import … from "umi"` 的组件会明确报错（不会给出误导性的假实现）。
+
+完整设计与决策记录见 [`docs/spec-umijs-support.md`](docs/spec-umijs-support.md)。
+
+自动生效的三件事（无需配置）：
+
+| 能力 | 说明 |
+| --- | --- |
+| `@/` → `src/` 别名 | **不依赖工程的 `tsconfig.paths`**；`@@/` → `src/.umi/` 仅在生成目录存在时添加 |
+| 传递依赖的 React | 真实 Umi 4 工程不声明 `react`，由框架包带入；插件会解析实际安装位置 |
+| 生成目录排除 | `src/.umi*` 不进组件列表 |
+
+### Umi 运行时的降级行为
+
+`umi` 是服务端 + 客户端混合包，直接在浏览器里跑会用到 `process.platform` 等 Node API 而崩。
+预览用 [`preview/shims/umi.tsx`](preview/shims/umi.tsx) 顶替它，**只改模块解析，不碰业务代码**。
+
+| API | 预览里的行为 |
+| --- | --- |
+| `useModel` | **恒返回 `{}`**（不猜初值）。要真实初值请在 `__previewjs__/Wrapper.tsx` 里包 Provider |
+| `useRequest` / `useFetcher` | **返回空态**：`{ data: undefined, loading: false, … }` / `state: "idle"`，`useRequest` 会打一条 `console.debug` |
+| `history` / `useNavigate` / `useLocation` | 内存版位置栈，`push` 后可被 `useLocation` 观察到 |
+| `useParams` / `useSearchParams` | 空值（`{}` / 空 `URLSearchParams`） |
+| `useAppData` | 结构完整的空上下文（`routes: {}`、`clientRoutes: []` 等）。`clientRoutes.length` 为 `0`，不是 `undefined` |
+| `useSelectedRoutes` / `useMatch` / `useRoutes` / `useOutlet` | 空值（`[]` / `null`） |
+| `useRouteProps` / `useRouteData` / `useOutletContext` | 空对象（`{}` / `{ route: {} }`） |
+| `useServerLoaderData` / `useClientLoaderData` / `useLoaderData` | 空态（`{ data: undefined }` / `undefined`） |
+| `Link` / `NavLink` / `LinkWithPrefetch` | 渲染成 `<a>`，点击被拦截 |
+| `Outlet` / `Navigate` | 渲染 `null`；`Navigate` 会把目标路径记进内存 location |
+| `Helmet` / `HelmetProvider` | 渲染子节点，不改文档头 |
+| `connect` / `withRouter` | 直通 HOC |
+| `createSearchParams` / `generatePath` / `matchPath` / `resolvePath` | **真实语义**（不需要路由上下文，没必要降级） |
+| `matchRoutes` | 恒 `null`（预览没有路由表） |
+| `createMemoryHistory` / `createBrowserHistory` / `createHashHistory` | 同内存版 `history`（接口较真实 `history` 包小很多） |
+| `request` / `renderClient` / `__getRoot` | **显式抛错**，并说明「请用 DevBrowser（应用预览）」 |
+
+判据：**渲染路径上的高频 API 给降级值**（抛错会让整棵树挂掉），**不在渲染路径的显式失败**。
+`useRequest` 返回空态意味着组件会显示「无数据」—— 那是预期行为，不是 bug。
+
+### 为什么导出面必须完整
+
+ESM 是**静态**导出校验：shim 少导出任何一个 Umi 名字，整个模块就
+`SyntaxError: does not provide an export named '…'`，组件连挂载机会都没有 ——
+**预览直接白屏**，而报错里只有 `__previewjs_internal__/renderer/shims/umi.tsx`
+这个内部路径，用户看不出发生了什么。
+
+所以即使是用不上的应用级 API（`renderClient` / `__getRoot`）也**显式导出并抛错**，
+而不是省略。`tests/umi.spec.ts` 的用例 3d 把这条约束固化成了回归测试
+（故意把一个导出去掉，它就会红）。
+
+### 用真实的 `react-router`（accessory lib）
+
+组件里直接 `import { useHref } from "react-router"` 是支持的 —— 插件会把
+`react-router` / `react-router-dom` 解析到 `umi` 依赖树里的实际安装位置（它们是 **`umi` 的传递依赖**）。
+
+但这些 hook 必须活在 `<Router>` 里。**预览不替你决定路由形态**（memory / hash / browser、
+初始路径、basename），请在 `__previewjs__/Wrapper.tsx` 里自己包一层：
+
+```tsx
+import { ReactNode } from "react";
+import { MemoryRouter } from "react-router-dom";
+
+export const Wrapper = ({ children }: { children: ReactNode }) => {
+	return <MemoryRouter initialEntries={["/"]}>{children}</MemoryRouter>;
+};
+```
+
+（导出必须是**具名** `Wrapper`。）不包的话会报
+`useHref() may be used only in the context of a <Router> component`。
+
+> 版本以 Umi 为准（当前 `react-router` **6.3.0**）。用了 6.4+ 的 API（如 `createBrowserRouter`）会报
+> `does not provide an export named`。
+
+更一般的 Wrapper 用法（主题、状态、布局、能做什么 / 做不到什么）见
+[用户文档 · 组件预览](../../../../docs/user/04-component-preview.md#用-wrapper-包住组件)。
+
+### 不覆盖的范围
+
+- **路由 / 页面级约定**（`pages/*` 的 route props、layout、约定式路由）—— 预览把页面当普通组件渲染。
+  整站/带数据场景走应用预览（dev server），见 `docs/specs/0001-runtime-bridge`。
+- **`.umirc.ts` 的 `alias` / `proxy` 配置** —— 预览不读 Umi 的工程配置（`alias` 的原因见 spec §23.1）。
+- **`@umijs/max` 插件生态的语义**（`access` / `initialState` / `micro`）—— 只有上面表里的降级值。
+
 ## 依赖
+
 - `react`、`@cfp-studio/*`、`typescript`、`vite`、`esbuild-plugin-polyfill-node`
 - 测试：`vitest`、`@playwright/test`
 
 ## 构建
+
 ```sh
 pnpm build
 ```
 
 ## 许可证
+
 MIT

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 /// <reference types="node" />
-import { Reader } from "@cfp-studio/vfs";
 import * as fs$1 from "node:fs";
 import * as url$1 from "node:url";
 import { URL as URL$1 } from "node:url";
+import { Reader } from "@cfp-studio/vfs";
 import { Analyzer } from "@cfp-studio/analyzer-api";
 import * as http from "node:http";
 import { Agent, ClientRequest, ClientRequestArgs, IncomingMessage, OutgoingHttpHeaders, Server } from "node:http";
@@ -15,6 +15,8 @@ import * as stream from "node:stream";
 import { Duplex, DuplexOptions } from "node:stream";
 import { SecureContextOptions } from "node:tls";
 import { ZlibOptions } from "node:zlib";
+import Lightningcss from "lightningcss";
+import DartSass from "sass";
 import SassEmbedded from "sass-embedded";
 import Less from "less";
 import Stylus from "stylus";
@@ -34,7 +36,7 @@ type FrameworkPluginInfo = {
  * @returns 实现了 Api 接口的 AxiosApi 实例
  */
 //#endregion
-//#region ../../../../node_modules/.pnpm/@types+estree@1.0.8/node_modules/@types/estree/index.d.ts
+//#region ../../../../node_modules/.pnpm/@types+estree@1.0.9/node_modules/@types/estree/index.d.ts
 // This definition file follows a somewhat unusual format. ESTree allows
 // runtime type checks based on the `type` parameter. In order to explain this
 // to typescript we want to use discriminated union types:
@@ -284,7 +286,7 @@ interface PrivateIdentifier extends BaseNode {
 }
 interface Property extends BaseNode {
   type: "Property";
-  key: Expression | PrivateIdentifier;
+  key: Expression;
   value: Expression | Pattern; // Could be an AssignmentProperty
   kind: "init" | "get" | "set";
   method: boolean;
@@ -558,7 +560,7 @@ interface AwaitExpression extends BaseExpression {
   argument: Expression;
 }
 //#endregion
-//#region ../../../../node_modules/.pnpm/rollup@4.52.0/node_modules/rollup/dist/rollup.d.ts
+//#region ../../../../node_modules/.pnpm/rollup@4.65.0/node_modules/rollup/dist/rollup.d.ts
 declare module 'estree' {
   export interface Decorator extends BaseNode {
     type: 'Decorator';
@@ -638,11 +640,11 @@ type DecodedSourceMapOrMissing = {
   missing?: false | undefined;
 });
 interface SourceMap$1 {
-  file: string;
+  file?: string | undefined;
   mappings: string;
   names: string[];
   sources: string[];
-  sourcesContent?: string[] | undefined;
+  sourcesContent?: (string | null)[] | undefined;
   version: number;
   debugId?: string | undefined;
   toString(): string;
@@ -664,7 +666,8 @@ interface SourceDescription extends Partial<PartialNull<ModuleOptions>> {
 }
 interface TransformModuleJSON {
   ast?: ProgramNode | undefined;
-  code: string; // note if plugins use new this.cache to opt-out auto transform cache
+  code: string;
+  safeVariableNames: Record<string, string> | null; // note if plugins use new this.cache to opt-out auto transform cache
   customTransformCache: boolean;
   originalCode: string;
   originalSourcemap: ExistingDecodedSourceMap | null;
@@ -672,6 +675,7 @@ interface TransformModuleJSON {
   transformDependencies: string[];
 }
 interface ModuleJSON extends TransformModuleJSON, ModuleOptions {
+  safeVariableNames: Record<string, string> | null;
   ast: ProgramNode;
   dependencies: string[];
   id: string;
@@ -727,6 +731,7 @@ interface ModuleInfo extends ModuleOptions {
   dynamicallyImportedIds: readonly string[];
   exportedBindings: Record<string, string[]> | null;
   exports: string[] | null;
+  safeVariableNames: Record<string, string> | null;
   hasDefaultExport: boolean | null;
   id: string;
   implicitlyLoadedAfterOneOf: readonly string[];
@@ -774,6 +779,7 @@ interface PluginContext extends MinimalPluginContext$1 {
   } & Partial<PartialNull<ModuleOptions>>) => Promise<ModuleInfo>;
   parse: ParseAst;
   resolve: (source: string, importer?: string, options?: {
+    importerAttributes?: Record<string, string>;
     attributes?: Record<string, string>;
     custom?: CustomPluginOptions;
     isEntry?: boolean;
@@ -810,10 +816,12 @@ type ResolveIdResult = string | NullValue | false | PartialResolvedId;
 type ResolveIdHook = (this: PluginContext, source: string, importer: string | undefined, options: {
   attributes: Record<string, string>;
   custom?: CustomPluginOptions;
+  importerAttributes?: Record<string, string> | undefined;
   isEntry: boolean;
 }) => ResolveIdResult;
 type ShouldTransformCachedModuleHook = (this: PluginContext, options: {
   ast: ProgramNode;
+  attributes: Record<string, string>;
   code: string;
   id: string;
   meta: CustomPluginOptions;
@@ -824,7 +832,12 @@ type ShouldTransformCachedModuleHook = (this: PluginContext, options: {
 type IsExternal = (source: string, importer: string | undefined, isResolved: boolean) => boolean;
 type HasModuleSideEffects = (id: string, external: boolean) => boolean;
 type LoadResult = SourceDescription | string | NullValue;
-type LoadHook = (this: PluginContext, id: string) => LoadResult;
+type LoadHook = (this: PluginContext, id: string, // temporarily marked as optional for better Vite type-compatibility
+options?: {
+  // unused, temporarily added for better Vite type-compatibility
+  ssr?: boolean | undefined; // temporarily marked as optional for better Vite type-compatibility
+  attributes?: Record<string, string>;
+} | undefined) => LoadResult;
 interface TransformPluginContext extends PluginContext {
   debug: LoggingFunctionWithPosition;
   error: (error: RollupError | string, pos?: number | {
@@ -836,7 +849,12 @@ interface TransformPluginContext extends PluginContext {
   warn: LoggingFunctionWithPosition;
 }
 type TransformResult$2 = string | NullValue | Partial<SourceDescription>;
-type TransformHook = (this: TransformPluginContext, code: string, id: string) => TransformResult$2;
+type TransformHook = (this: TransformPluginContext, code: string, id: string, // temporarily marked as optional for better Vite type-compatibility
+options?: {
+  // unused, temporarily added for better Vite type-compatibility
+  ssr?: boolean | undefined; // temporarily marked as optional for better Vite type-compatibility
+  attributes?: Record<string, string>;
+} | undefined) => TransformResult$2;
 type ModuleParsedHook = (this: PluginContext, info: ModuleInfo) => void;
 type RenderChunkHook = (this: PluginContext, code: string, chunk: RenderedChunk, options: NormalizedOutputOptions, meta: {
   chunks: Record<string, RenderedChunk>;
@@ -846,13 +864,16 @@ type RenderChunkHook = (this: PluginContext, code: string, chunk: RenderedChunk,
 } | string | NullValue;
 type ResolveDynamicImportHook = (this: PluginContext, specifier: string | AstNode, importer: string, options: {
   attributes: Record<string, string>;
+  importerAttributes: Record<string, string>;
 }) => ResolveIdResult;
 type ResolveImportMetaHook = (this: PluginContext, property: string | null, options: {
+  attributes: Record<string, string>;
   chunkId: string;
   format: InternalModuleFormat;
   moduleId: string;
 }) => string | NullValue;
 type ResolveFileUrlHook = (this: PluginContext, options: {
+  attributes: Record<string, string>;
   chunkId: string;
   fileName: string;
   format: InternalModuleFormat;
@@ -903,6 +924,7 @@ interface FunctionPluginHooks {
     chunk: PreRenderedChunkWithFileName;
     targetChunk: PreRenderedChunkWithFileName | null;
     getTargetChunkImports: () => DynamicImportTargetChunk[] | null;
+    targetModuleAttributes: Record<string, string>;
   }) => {
     left: string;
     right: string;
@@ -1318,16 +1340,14 @@ interface AwaitingEventEmitter<T extends Record<string, (...parameters: any) =>
   off<K extends keyof T>(event: K, listener: AwaitedEventListener<T, K>): this;
   /**
    * Registers an event listener that will be awaited before Rollup continues.
-   * All listeners will be awaited in parallel while rejections are tracked via
-   * Promise.all.
+   * All listeners are invoked and awaited in parallel. Rollup waits until all
+   * of them have settled and then throws the first rejection, if any.
    */
   on<K extends keyof T>(event: K, listener: AwaitedEventListener<T, K>): this;
   /**
-   * Registers an event listener that will be awaited before Rollup continues.
-   * All listeners will be awaited in parallel while rejections are tracked via
-   * Promise.all.
-   * Listeners are removed automatically when removeListenersForCurrentRun is
-   * called, which happens automatically after each run.
+   * Registers an event listener like `on`. Listeners are removed automatically
+   * when removeListenersForCurrentRun is called, which happens right before each
+   * rebuild, after the changes that triggered it were announced.
    */
   onCurrentRun<K extends keyof T>(event: K, listener: (...parameters: Parameters<T[K]>) => Promise<ReturnType<T[K]>>): this;
   removeAllListeners(): this;
@@ -1428,7 +1448,7 @@ interface RollupFileStats {
   birthtime: Date;
 }
 //#endregion
-//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.19.2_jiti@2.6.1_less@4.2.2_lightningcss@1.30.2_sass@1.85.1_terser@5.40.0_tsx@4.19.3_yaml@2.7.0/node_modules/vite/types/hmrPayload.d.ts
+//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.1_13c54df9746541450cb8a36e10ae9cdd/node_modules/vite/types/hmrPayload.d.ts
 type HotPayload = ConnectedPayload | PingPayload | UpdatePayload | FullReloadPayload | CustomPayload | ErrorPayload | PrunePayload;
 interface ConnectedPayload {
   type: 'connected';
@@ -1487,7 +1507,7 @@ interface ErrorPayload {
   };
 }
 //#endregion
-//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.19.2_jiti@2.6.1_less@4.2.2_lightningcss@1.30.2_sass@1.85.1_terser@5.40.0_tsx@4.19.3_yaml@2.7.0/node_modules/vite/types/customEvent.d.ts
+//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.1_13c54df9746541450cb8a36e10ae9cdd/node_modules/vite/types/customEvent.d.ts
 interface CustomEventMap {
   'vite:beforeUpdate': UpdatePayload;
   'vite:afterUpdate': UpdatePayload;
@@ -1518,7 +1538,7 @@ interface InvalidatePayload {
  */
 type InferCustomEventPayload<T extends string> = T extends keyof CustomEventMap ? CustomEventMap[T] : any;
 //#endregion
-//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.19.2_jiti@2.6.1_less@4.2.2_lightningcss@1.30.2_sass@1.85.1_terser@5.40.0_tsx@4.19.3_yaml@2.7.0/node_modules/vite/dist/node/moduleRunnerTransport.d-DJ_mE5sf.d.ts
+//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.1_13c54df9746541450cb8a36e10ae9cdd/node_modules/vite/dist/node/moduleRunnerTransport.d-DJ_mE5sf.d.ts
 interface FetchFunctionOptions {
   cached?: boolean;
   startOffset?: number;
@@ -2181,12 +2201,12 @@ declare global {
   interface URL {}
 }
 //#endregion
-//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.19.2_jiti@2.6.1_less@4.2.2_lightningcss@1.30.2_sass@1.85.1_terser@5.40.0_tsx@4.19.3_yaml@2.7.0/node_modules/vite/types/internal/lightningcssOptions.d.ts
+//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.1_13c54df9746541450cb8a36e10ae9cdd/node_modules/vite/types/internal/lightningcssOptions.d.ts
 /* eslint-enable @typescript-eslint/ban-ts-comment */
 type LightningCSSOptions = Omit<Lightningcss.BundleAsyncOptions<Lightningcss.CustomAtRules>, 'filename' | 'resolver' | 'minify' | 'sourceMap' | 'analyzeDependencies' // properties not overridden by Vite, but does not make sense to set by end users
 | 'inputSourceMap' | 'projectRoot'>;
 //#endregion
-//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.19.2_jiti@2.6.1_less@4.2.2_lightningcss@1.30.2_sass@1.85.1_terser@5.40.0_tsx@4.19.3_yaml@2.7.0/node_modules/vite/types/internal/cssPreprocessorOptions.d.ts
+//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.1_13c54df9746541450cb8a36e10ae9cdd/node_modules/vite/types/internal/cssPreprocessorOptions.d.ts
 /* eslint-enable @typescript-eslint/ban-ts-comment */
 // https://github.com/type-challenges/type-challenges/issues/29285
 type IsAny<T> = boolean extends (T extends never ? true : false) ? true : false;
@@ -2209,7 +2229,7 @@ declare global {
   interface HTMLLinkElement {}
 }
 //#endregion
-//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.19.2_jiti@2.6.1_less@4.2.2_lightningcss@1.30.2_sass@1.85.1_terser@5.40.0_tsx@4.19.3_yaml@2.7.0/node_modules/vite/types/metadata.d.ts
+//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.1_13c54df9746541450cb8a36e10ae9cdd/node_modules/vite/types/metadata.d.ts
 interface ChunkMetadata {
   importedAssets: Set<string>;
   importedCss: Set<string>;
@@ -2242,7 +2262,7 @@ declare module 'rollup' {
   }
 }
 //#endregion
-//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.19.2_jiti@2.6.1_less@4.2.2_lightningcss@1.30.2_sass@1.85.1_terser@5.40.0_tsx@4.19.3_yaml@2.7.0/node_modules/vite/dist/node/index.d.ts
+//#region ../../../../node_modules/.pnpm/vite@6.4.5_@types+node@24.1_13c54df9746541450cb8a36e10ae9cdd/node_modules/vite/dist/node/index.d.ts
 interface Alias {
   find: string | RegExp;
   replacement: string;
@@ -5701,10 +5721,16 @@ interface FrameworkPluginFactory {
   /**
    * 检查当前项目的依赖是否与该框架插件兼容。
    *
-   * @param dependencies - 项目的依赖包信息。
+   * @param dependencies - 项目的依赖包信息。**只含工程 `package.json` 里显式声明的包**
+   *   （`dependencies` / `devDependencies` / `peerDependencies` 的并集），
+   *   不含传递依赖。
+   * @param rootDir - 工程根目录（可选，向后兼容）。
+   *   有些框架（如 Umi 4）**不显式声明 `react`**，而由框架包作为传递依赖带入 ——
+   *   那种情况下 `dependencies.react` 是 `undefined`，插件需要靠 `rootDir` 自行解析。
+   *   见 `docs/spec-umijs-support.md` §15。
    * @returns 一个 Promise，解析为布尔值，表示是否兼容。
    */
-  isCompatible(dependencies: PackageDependencies): Promise<boolean>;
+  isCompatible(dependencies: PackageDependencies, rootDir?: string): Promise<boolean>;
   /**
    * 创建框架插件实例。
    *
@@ -5742,6 +5768,17 @@ interface FrameworkPlugin extends Analyzer {
    * @returns Vite 用户配置对象。
    */
   viteConfig: (configuredPlugins: Plugin[]) => UserConfig;
+  /**
+   * 该框架的**生成目录** glob，供文件爬取排除（可选）。
+   *
+   * 用于框架把代码生成到工程内的场景 —— 例如 Umi 4 的 `src/.umi`，
+   * dev server 一跑就是几万行。不排除的话它们会进组件树，
+   * 既慢又干扰（`docs/spec-umijs-support.md` G2）。
+   *
+   * 语义边界：**只是"不扫这些路径"**，不是 gitignore，也不影响文件读取
+   * （`@cfp-studio/reader` 仍能读到）。不实现该字段即保持现状。
+   */
+  ignoredPaths?: string[];
   /**
    * 清理插件资源的方法。
    * 当插件不再使用时，调用此方法释放资源。
@@ -5758,11 +5795,23 @@ interface FrameworkPlugin extends Analyzer {
 //#endregion
 //#region src/index.d.ts
 /**
- * 定义一个名为 reactFrameworkPlugin 的框架插件工厂对象
+ * Umi 4 工程里需要从依赖预构建中排除的 native 模块。
+ *
+ * **为什么需要**：`@umijs/bundler-vite` 自带一份 `vite@7`，其依赖 `fsevents`
+ * 含 `.node` 二进制；esbuild 的依赖预构建没有 `.node` 的 loader，会导致
+ * `error while updating dependencies` 而整个预览起不来。
+ *
+ * 实测（`docs/spec-umijs-support.md` §11.2）：不加这两项，任何
+ * `import ... from "umi"` 的组件都无法预览。
+ *
+ * 只排除**已知的 native 模块**，不做 `platform: "node"` 之类的全局放宽 ——
+ * 那会改变所有依赖的构建目标。
  */
+declare const UMI_NATIVE_MODULES_TO_EXCLUDE: string[];
+declare const UMI_GENERATED_DIR_GLOBS: string[];
 declare const reactFrameworkPlugin: FrameworkPluginFactory;
 /**
  * 导出默认的 reactFrameworkPlugin 对象
  */
 //#endregion
-export { reactFrameworkPlugin as default };
+export { UMI_GENERATED_DIR_GLOBS, UMI_NATIVE_MODULES_TO_EXCLUDE, reactFrameworkPlugin as default };

package/dist/index.mjs

@@ -1 +1 @@
-import{createAnalyzer as e}from"@cfp-studio/analyzer-api/analyzer";import{createFileSystemReader as t,createStackedReader as n}from"@cfp-studio/vfs";import r from"node:fs";import i from"node:path";import a from"typescript";import o from"node:url";import{decodePreviewableId as s,defineSpecialTypes as c,generatePreviewableId as l}from"@cfp-studio/analyzer-api";import{parseSerializableValue as u}from"@cfp-studio/serializable-values";import{extractArgs as d,extractCsf3Stories as f,extractStoriesInfo as p,resolvePreviewableId as m}from"@cfp-studio/storybook-helpers";import{EMPTY_OBJECT_TYPE as h,NODE_TYPE as g,UNKNOWN_TYPE as _,arrayType as v,dereferenceType as y,functionType as b,helpers as x,maybeOptionalType as S,objectType as C,stripUnusedTypes as w}from"@cfp-studio/type-analyzer";import T from"@vitejs/plugin-react";import{polyfillNode as E}from"esbuild-plugin-polyfill-node";function D(e,t){for(let n of e.statements)if(a.isExpressionStatement(n)&&a.isBinaryExpression(n.expression)&&n.expression.operatorToken.kind===a.SyntaxKind.EqualsToken&&a.isPropertyAccessExpression(n.expression.left)&&a.isIdentifier(n.expression.left.expression)){if(n.expression.left.expression.text!==t)continue;if(n.expression.left.name.text===`propTypes`)return n.expression.right}else if(a.isClassDeclaration(n)&&n.name){if(n.name.text!==t)continue;for(let e of n.members)if(a.isPropertyDeclaration(e)&&e.initializer&&e.name.getText()===`propTypes`)return e.initializer}return null}function O(e,t,n,r,i){let a=t.sourceFile(n),o=null;a&&(o=D(a,r));let s=null;return s=o?A(t,o):k(e,t,i),{props:s.type,types:{...s.collected}}}function k(e,t,n){let r=n.getParameters()[0];if(!r)return{type:h,collected:{}};if(!r.valueDeclaration)return{type:_,collected:{}};let i=t.checker.getTypeOfSymbolAtLocation(r,r.valueDeclaration);try{let{type:e,collected:n}=t.resolveType(i);if([e]=y(e,n,[]),e.kind===`object`&&a.isParameter(r.valueDeclaration)&&a.isObjectBindingPattern(r.valueDeclaration.name)){let t=r.valueDeclaration.name,n=new Set,i=new Set,o=!1;for(let e of t.elements){if(e.dotDotDotToken){o=!0;break}let t=e.propertyName||e.name;if(!a.isIdentifier(t)){o=!0;break}n.add(t.text),e.initializer&&i.add(t.text)}o||(e=C(Object.fromEntries(Object.entries(e.fields).filter(([e])=>n.has(e)).map(([e,t])=>[e,S(t,i.has(e))]))))}return{type:e,collected:n}}catch(n){e.warn(`Unable to resolve props type for ${t.checker.typeToString(i)}`),e.error(n.toString())}return{type:_,collected:{}}}function A(e,t){let n=e.checker.getTypeAtLocation(t),r={},i={};for(let t of n.getProperties())r[t.name]=(()=>{if(!t.valueDeclaration)return _;let n=e.checker.getTypeAtLocation(t.valueDeclaration),r=e.resolveTypeArguments(n),a=r.types[0];return a?(i={...i,...r.collected},S(a,n.symbol.name===`Requireable`)):_})();let a=C(r);return{type:a,collected:w(i,[a])}}async function j(e,t,n,r){let o=t.sourceFile(r);if(!o)return[];let c=[];for(let e of o.statements)if(a.isExportAssignment(e)){if(a.isIdentifier(e.expression))continue;c.push([`default`,e,e.expression])}else if(a.isVariableStatement(e))for(let t of e.declarationList.declarations)!a.isIdentifier(t.name)||!t.initializer||c.push([t.name.text,e,t.initializer]);else if(a.isFunctionDeclaration(e)){let t=!!e.modifiers?.find(e=>e.kind===a.SyntaxKind.ExportKeyword)&&!!e.modifiers?.find(e=>e.kind===a.SyntaxKind.DefaultKeyword),n=e.name?.text;(t||n)&&c.push([n||`default`,e,e])}else a.isClassDeclaration(e)&&e.name&&c.push([e.name.text,e,e]);let m=p(o);e.debug(`**storiresInfo: ${m}`);let h=[],g=d(o),v=x.extractExportedNames(o);async function y(i,a,o){if(o===`default`&&m)return null;let s=g[o],c=o===`default`||!!v[o],l=N(t.checker,a);if(m&&c&&(s||l?.parameters.length===0)){let r=M(e,t,n,m.component);return{...i,analyze:async()=>({args:s?{sourcePosition:{start:s.getStart(),end:s.getEnd()},value:await u(s)}:null}),associatedComponent:r}}return l?{...i,exported:c,analyze:async()=>O(e,t,r,o,l)}:null}for(let[e,t,a]of c){let o=await y({id:l({filePath:i.relative(n,r),name:e}),sourcePosition:{start:t.getStart(),end:t.getEnd()}},a,e);o&&h.push(o)}return[...h,...await f(n,t,o,async r=>{let{filePath:a}=s(r),o=(await j(e,t,n,i.join(n,a))).find(e=>e.id===r);return!o||!(`exported`in o)?{props:_,types:{}}:o.analyze()})]}function M(e,t,n,r){let a=m(n,t.checker,r);return r&&a?{id:a,analyze:async()=>{let o=N(t.checker,r);if(!o)return{props:_,types:{}};let{filePath:c,name:l}=s(a);return O(e,t,i.join(n,c),l,o)}}:null}function N(e,t){let n=e.getTypeAtLocation(t);if(n.flags===a.TypeFlags.Any&&a.isCallExpression(t)&&a.isPropertyAccessExpression(t.expression)&&a.isIdentifier(t.expression.name)&&t.expression.name.text===`bind`){let r=e.getSymbolAtLocation(t.expression.expression);r?.valueDeclaration&&a.isVariableDeclaration(r.valueDeclaration)&&r.valueDeclaration.initializer&&(n=e.getTypeAtLocation(r.valueDeclaration.initializer))}for(let e of n.getCallSignatures())if(P(e.getReturnType()))return e;if(n.symbol){let r=e.getTypeOfSymbolAtLocation(n.symbol,t);for(let e of r.getConstructSignatures())if(e.getReturnType().getProperty(`render`))return e}return null}function P(e){return!!I(e)}const F=new Set([`Element`,`ReactElement`]);function I(e){if(e.isUnion()){for(let t of e.types)if(I(t))return!0}return F.has(e.symbol?.getEscapedName().toString())}const L=c({Component:g,ComponentClass:b(g),FunctionComponent:b(g),ReactElement:g,ReactNode:g,ReactNodeArray:v(g),ReactPortal:g}),R=e({typeAnalyzerOptions:({reader:e,rootDir:s})=>{let c=o.fileURLToPath(new URL(`.`,import.meta.url)),l=i.join(c,`..`,`types`),u=i.join(c,`..`,`node_modules`),d=r.existsSync(l)?l:u;return{reader:n([e,t({mapping:{from:d,to:i.join(s,`node_modules`)},watch:!1}),...d===l?[t({mapping:{from:l,to:i.join(s,`node_modules`,`@types`)},watch:!1})]:[]]),specialTypes:L,tsCompilerOptions:{jsx:a.JsxEmit.ReactJSX,jsxImportSource:`react`}}},crawlFile:({logger:e,resolver:t,rootDir:n,absoluteFilePath:r})=>j(e,t,n,r)}),z=/import (\* as )?React[ ,]/;function B(){return{name:`previewjs:react-js-imports`,async transform(e,t){return t.includes(`node_modules`)||i.extname(t)!==`.js`||z.test(e)?e:`import React from 'react';${e}`}}}const V={info:{apiVersion:5,name:`@cfp-studio/plugin-react`},isCompatible:async e=>{let t=await e.react?.readInstalledVersion();if(!t)return!1;let[n,r]=t.split(`.`).map(e=>Number.parseInt(e));return Number.isNaN(n)||Number.isNaN(r)?!1:n>=17||n===16&&r>=14},async create({rootDir:e,reader:t,logger:n,dependencies:r}){let a=o.fileURLToPath(new URL(`.`,import.meta.url)),s=R({rootDir:e,reader:t,logger:n});return{defaultWrapperPath:`__previewjs__/Wrapper.tsx`,previewDirPath:i.join(a,`..`,`preview`),...s,viteConfig:e=>{let t=e.find(e=>e.name.startsWith(`vite:react-`));return{optimizeDeps:{esbuildOptions:{plugins:r.next?[E()]:[]}},resolve:{alias:{"react-native":`react-native-web`}},plugins:[B(),...e,...t?[]:[T()],{name:`previewjs:update-react-import`,async transform(e,t){if(!t.endsWith(`__previewjs_internal__/renderer/index.tsx`))return;let n=Number.parseInt(await r.react?.readInstalledVersion()||`0`);return e.replace(/__PREVIEWJS_PLUGIN_REACT_IMPORT_PATH__/g,n>=18?`./render-18`:`./render-16`)}}]}}}}};export{V as default};
+import{createRequire as e}from"node:module";import t from"node:fs";import n from"node:path";import r from"node:url";import i from"@vitejs/plugin-react";import{polyfillNode as a}from"esbuild-plugin-polyfill-node";import{createAnalyzer as o}from"@cfp-studio/analyzer-api/analyzer";import{createFileSystemReader as s,createStackedReader as c}from"@cfp-studio/vfs";import l from"typescript";import{decodePreviewableId as u,defineSpecialTypes as d,generatePreviewableId as f}from"@cfp-studio/analyzer-api";import{parseSerializableValue as p}from"@cfp-studio/serializable-values";import{extractArgs as m,extractCsf3Stories as h,extractStoriesInfo as g,resolvePreviewableId as _}from"@cfp-studio/storybook-helpers";import{EMPTY_OBJECT_TYPE as v,NODE_TYPE as y,UNKNOWN_TYPE as b,arrayType as x,dereferenceType as S,functionType as C,helpers as w,maybeOptionalType as T,objectType as E,stripUnusedTypes as D}from"@cfp-studio/type-analyzer";function O(e,t){for(let n of e.statements)if(l.isExpressionStatement(n)&&l.isBinaryExpression(n.expression)&&n.expression.operatorToken.kind===l.SyntaxKind.EqualsToken&&l.isPropertyAccessExpression(n.expression.left)&&l.isIdentifier(n.expression.left.expression)){if(n.expression.left.expression.text!==t)continue;if(n.expression.left.name.text===`propTypes`)return n.expression.right}else if(l.isClassDeclaration(n)&&n.name){if(n.name.text!==t)continue;for(let e of n.members)if(l.isPropertyDeclaration(e)&&e.initializer&&e.name.getText()===`propTypes`)return e.initializer}return null}function k(e,t,n,r,i){let a=t.sourceFile(n),o=null;a&&(o=O(a,r));let s=null;return s=o?j(t,o):A(e,t,i),{props:s.type,types:{...s.collected}}}function A(e,t,n){let r=n.getParameters()[0];if(!r)return{type:v,collected:{}};if(!r.valueDeclaration)return{type:b,collected:{}};let i=t.checker.getTypeOfSymbolAtLocation(r,r.valueDeclaration);try{let{type:e,collected:n}=t.resolveType(i);if([e]=S(e,n,[]),e.kind===`object`&&l.isParameter(r.valueDeclaration)&&l.isObjectBindingPattern(r.valueDeclaration.name)){let t=r.valueDeclaration.name,n=new Set,i=new Set,a=!1;for(let e of t.elements){if(e.dotDotDotToken){a=!0;break}let t=e.propertyName||e.name;if(!l.isIdentifier(t)){a=!0;break}n.add(t.text),e.initializer&&i.add(t.text)}a||(e=E(Object.fromEntries(Object.entries(e.fields).filter(([e])=>n.has(e)).map(([e,t])=>[e,T(t,i.has(e))]))))}return{type:e,collected:n}}catch(n){e.warn(`Unable to resolve props type for ${t.checker.typeToString(i)}`),e.error(n.toString())}return{type:b,collected:{}}}function j(e,t){let n=e.checker.getTypeAtLocation(t),r={},i={};for(let t of n.getProperties())r[t.name]=(()=>{if(!t.valueDeclaration)return b;let n=e.checker.getTypeAtLocation(t.valueDeclaration),r=e.resolveTypeArguments(n),a=r.types[0];return a?(i={...i,...r.collected},T(a,n.symbol.name===`Requireable`)):b})();let a=E(r);return{type:a,collected:D(i,[a])}}async function M(e,t,r,i){let a=t.sourceFile(i);if(!a)return[];let o=[];for(let e of a.statements)if(l.isExportAssignment(e)){if(l.isIdentifier(e.expression))continue;o.push([`default`,e,e.expression])}else if(l.isVariableStatement(e))for(let t of e.declarationList.declarations)!l.isIdentifier(t.name)||!t.initializer||o.push([t.name.text,e,t.initializer]);else if(l.isFunctionDeclaration(e)){let t=!!e.modifiers?.find(e=>e.kind===l.SyntaxKind.ExportKeyword)&&!!e.modifiers?.find(e=>e.kind===l.SyntaxKind.DefaultKeyword),n=e.name?.text;(t||n)&&o.push([n||`default`,e,e])}else l.isClassDeclaration(e)&&e.name&&o.push([e.name.text,e,e]);let s=g(a);e.debug(`**storiresInfo: ${s}`);let c=[],d=m(a),_=w.extractExportedNames(a);async function v(n,a,o){if(o===`default`&&s)return null;let c=d[o],l=o===`default`||!!_[o],u=P(t.checker,a);if(s&&l&&(c||u?.parameters.length===0)){let i=N(e,t,r,s.component);return{...n,analyze:async()=>({args:c?{sourcePosition:{start:c.getStart(),end:c.getEnd()},value:await p(c)}:null}),associatedComponent:i}}return u?{...n,exported:l,analyze:async()=>k(e,t,i,o,u)}:null}for(let[e,t,a]of o){let o=await v({id:f({filePath:n.relative(r,i),name:e}),sourcePosition:{start:t.getStart(),end:t.getEnd()}},a,e);o&&c.push(o)}return[...c,...await h(r,t,a,async i=>{let{filePath:a}=u(i),o=(await M(e,t,r,n.join(r,a))).find(e=>e.id===i);return!o||!(`exported`in o)?{props:b,types:{}}:o.analyze()})]}function N(e,t,r,i){let a=_(r,t.checker,i);return i&&a?{id:a,analyze:async()=>{let o=P(t.checker,i);if(!o)return{props:b,types:{}};let{filePath:s,name:c}=u(a);return k(e,t,n.join(r,s),c,o)}}:null}function P(e,t){let n=e.getTypeAtLocation(t);if(n.flags===l.TypeFlags.Any&&l.isCallExpression(t)&&l.isPropertyAccessExpression(t.expression)&&l.isIdentifier(t.expression.name)&&t.expression.name.text===`bind`){let r=e.getSymbolAtLocation(t.expression.expression);r?.valueDeclaration&&l.isVariableDeclaration(r.valueDeclaration)&&r.valueDeclaration.initializer&&(n=e.getTypeAtLocation(r.valueDeclaration.initializer))}for(let e of n.getCallSignatures())if(F(e.getReturnType()))return e;if(n.symbol){let r=e.getTypeOfSymbolAtLocation(n.symbol,t);for(let e of r.getConstructSignatures())if(e.getReturnType().getProperty(`render`))return e}return null}function F(e){return!!L(e)}const I=new Set([`Element`,`ReactElement`]);function L(e){if(e.isUnion()){for(let t of e.types)if(L(t))return!0}return I.has(e.symbol?.getEscapedName().toString())}const R=d({Component:y,ComponentClass:C(y),FunctionComponent:C(y),ReactElement:y,ReactNode:y,ReactNodeArray:x(y),ReactPortal:y}),z=o({typeAnalyzerOptions:({reader:e,rootDir:i})=>{let a=r.fileURLToPath(new URL(`.`,import.meta.url)),o=n.join(a,`..`,`types`),u=n.join(a,`..`,`node_modules`),d=t.existsSync(o)?o:u;return{reader:c([e,s({mapping:{from:d,to:n.join(i,`node_modules`)},watch:!1}),...d===o?[s({mapping:{from:o,to:n.join(i,`node_modules`,`@types`)},watch:!1})]:[]]),specialTypes:R,tsCompilerOptions:{jsx:l.JsxEmit.ReactJSX,jsxImportSource:`react`}}},crawlFile:({logger:e,resolver:t,rootDir:n,absoluteFilePath:r})=>M(e,t,n,r)}),B={line:`data-inspector-line`,column:`data-inspector-column`,relativePath:`data-inspector-relative-path`};function V(e){return e.includes(B.relativePath)}function H(e,t){if(!e.includes(`<`)||V(e))return;let n=l.createSourceFile(t.relativePath,e,l.ScriptTarget.Latest,!0,l.ScriptKind.TSX),r=[],i=e=>{if(l.isJsxElement(e)||l.isJsxSelfClosingElement(e)){let i=l.isJsxElement(e)?e.openingElement:e,a=i.tagName.getStart(n),{line:o,character:s}=n.getLineAndCharacterOfPosition(a),c=i.tagName.getEnd(),u=` ${B.line}="${o+1}" ${B.column}="${s+1}" ${B.relativePath}="${U(t.relativePath)}"`;r.push({at:c,text:u})}l.forEachChild(e,i)};if(i(n),r.length===0)return;r.sort((e,t)=>t.at-e.at);let a=e;for(let{at:e,text:t}of r)a=a.slice(0,e)+t+a.slice(e);return a}function U(e){return e.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`)}const W=/import (\* as )?React[ ,]/;function G(){return{name:`previewjs:react-js-imports`,async transform(e,t){return t.includes(`node_modules`)||n.extname(t)!==`.js`||W.test(e)?e:`import React from 'react';${e}`}}}const K=e(import.meta.url),q=[`fsevents`];function J(e,t){if(t.react)return{};let r={};for(let t of[`react`,`react-dom`])try{let i=K.resolve(`${t}/package.json`,{paths:[e]});r[t]=n.dirname(i)}catch{}return r}function Y(e,r){try{let i=K.resolve(e,{paths:[r]}),a=n.dirname(i);for(;a!==n.dirname(a);){let e=n.join(a,`package.json`);if(t.existsSync(e)){let n=JSON.parse(t.readFileSync(e,`utf8`));return typeof n.version==`string`?n.version:null}a=n.dirname(a)}return null}catch{return null}}const X=[`src/.umi/**`,`src/.umi-production/**`,`src/.umi-test/**`,`src/.umi-tmp/**`];function Z(){let e=``;return{name:`previewjs:inspector-attrs`,enforce:`pre`,configResolved(t){e=t.root},transform(t,r){let i=r.split(`?`)[0]??r;if(!/\.[jt]sx$/.test(i)||i.includes(`node_modules`)||i.includes(`__previewjs__`)||i.includes(`__previewjs_internal__`))return;let a=H(t,{relativePath:n.relative(e,i).split(n.sep).join(`/`)});if(a!==void 0)return{code:a,map:null}}}}const Q={info:{apiVersion:5,name:`@cfp-studio/plugin-react`},isCompatible:async(e,t)=>{let n=await e.react?.readInstalledVersion();if(!n&&t&&(n=Y(`react`,t)),!n)return!1;let[r,i]=n.split(`.`).map(e=>Number.parseInt(e));return Number.isNaN(r)||Number.isNaN(i)?!1:r>=17||r===16&&i>=14},async create({rootDir:e,reader:o,logger:s,dependencies:c}){let l=r.fileURLToPath(new URL(`.`,import.meta.url)),u=await c.umi?.readInstalledVersion()??await c[`@umijs/max`]?.readInstalledVersion(),d=u?Number.parseInt(u.split(`.`)[0]??`0`)>=4:!1,f=z({rootDir:e,reader:o,logger:s}),p=n.join(l,`..`,`preview`),m=J(e,c),h=`/__previewjs_internal__/renderer/shims/umi.tsx`,g=n.join(e,`src`),_={};if(d){t.existsSync(g)&&(_[`@`]=g);let r=n.join(g,`.umi`);t.existsSync(r)?_[`@@`]=r:s.debug(`umi: 跳过 @@ 别名，src/.umi 不存在（dev server 未启动）`);let i=(()=>{try{return n.dirname(K.resolve(`umi`,{paths:[e]}))}catch{try{return n.dirname(K.resolve(`@umijs/max`,{paths:[e]}))}catch{return e}}})();for(let e of[`react-router`,`react-router-dom`])try{let t=K.resolve(`${e}/package.json`,{paths:[i]});_[e]=n.dirname(t)}catch{s.debug(`umi: 跳过 ${e} 别名，解析不到实际安装位置`)}}return{defaultWrapperPath:`__previewjs__/Wrapper.tsx`,previewDirPath:p,ignoredPaths:d?X:[],...f,viteConfig:e=>{let t=e.find(e=>e.name.startsWith(`vite:react-`));return{optimizeDeps:{...d?{exclude:q}:{},esbuildOptions:{plugins:c.next?[a()]:[]}},resolve:{alias:{"react-native":`react-native-web`,...m,...d?{umi:h,"@umijs/max":h,..._}:{}}},plugins:[Z(),G(),...e,...t?[]:[i()],{name:`previewjs:update-react-import`,async transform(e,t){if(!t.endsWith(`__previewjs_internal__/renderer/index.tsx`))return;let n=Number.parseInt(await c.react?.readInstalledVersion()||`0`);return e.replace(/__PREVIEWJS_PLUGIN_REACT_IMPORT_PATH__/g,n>=18?`./render-18`:`./render-16`)}}]}}}}};export{X as UMI_GENERATED_DIR_GLOBS,q as UMI_NATIVE_MODULES_TO_EXCLUDE,Q as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfp-studio/plugin-react",
-  "version": "17.3.0",
+  "version": "17.3.2",
   "license": "MIT",
   "files": [
     "dist",
@@ -16,10 +16,10 @@
     "esbuild-plugin-polyfill-node": "0.3.0",
     "typescript": "5.9.3",
     "@cfp-studio/analyzer-api": "0.1.13",
-    "@cfp-studio/type-analyzer": "10.1.8",
-    "@cfp-studio/serializable-values": "9.0.8",
     "@cfp-studio/storybook-helpers": "6.0.2",
-    "@cfp-studio/vfs": "2.1.6"
+    "@cfp-studio/serializable-values": "9.0.8",
+    "@cfp-studio/type-analyzer": "10.1.8",
+    "@cfp-studio/vfs": "2.1.8"
   },
   "devDependencies": {
     "@playwright/test": "1.64.1",
@@ -33,9 +33,9 @@
     "react-dom": "18.3.1",
     "vite": "6.4.5",
     "vitest": "5.0.5",
-    "@cfp-studio/core": "1.0.6",
+    "@cfp-studio/core": "1.0.8",
     "@cfp-studio/testing": "14.0.1",
-    "@cfp-studio/iframe": "18.2.0"
+    "@cfp-studio/iframe": "18.4.3"
   },
   "engines": {
     "node": ">=20"
@@ -51,7 +51,7 @@
     "typecheck": "tsc --noEmit && tsc -p preview/tsconfig.json",
     "test": "node scripts/prepare-types.mjs && vitest run",
     "test:watch": "vitest watch",
-    "e2e-test": "pnpm --dir tests/apps/react16 install --ignore-workspace --ignore-scripts && pnpm --dir tests/apps/react17 install --ignore-workspace --ignore-scripts && pnpm --dir tests/apps/react18 install --ignore-workspace --ignore-scripts && pnpm --dir tests/apps/react-sass install --ignore-workspace --ignore-scripts && playwright test",
+    "e2e-test": "pnpm --dir tests/apps/react16 install --ignore-workspace --ignore-scripts && pnpm --dir tests/apps/react17 install --ignore-workspace --ignore-scripts && pnpm --dir tests/apps/react18 install --ignore-workspace --ignore-scripts && pnpm --dir tests/apps/react-sass install --ignore-workspace --ignore-scripts && pnpm --dir tests/apps/umi4 install --ignore-workspace --ignore-scripts && pnpm --dir tests/apps/umi-max install --ignore-workspace --ignore-scripts && tsx scripts/link-shared-umi-fixtures.ts && playwright test",
     "lint": "oxlint",
     "format": "oxfmt --write ."
   }

package/preview/error-boundary.tsx

@@ -2,48 +2,42 @@ import type { ReactNode } from "react";
 import { Component } from "react";
 
 type ErrorBoundaryProps = {
-  renderId: number;
-  children: ReactNode;
+	renderId: number;
+	children: ReactNode;
 };
 
 let errorBoundaryInstance: ErrorBoundary | null = null;
 
-export async function expectErrorBoundary(
-  renderId: number,
-  shouldAbortRender: () => boolean
-) {
-  while (
-    !errorBoundaryInstance ||
-    errorBoundaryInstance.props.renderId !== renderId
-  ) {
-    await new Promise((resolve) => setTimeout(resolve, 100));
-    if (shouldAbortRender()) {
-      return null;
-    }
-  }
-  return errorBoundaryInstance;
+export async function expectErrorBoundary(renderId: number, shouldAbortRender: () => boolean) {
+	while (!errorBoundaryInstance || errorBoundaryInstance.props.renderId !== renderId) {
+		await new Promise((resolve) => setTimeout(resolve, 100));
+		if (shouldAbortRender()) {
+			return null;
+		}
+	}
+	return errorBoundaryInstance;
 }
 
 export class ErrorBoundary extends Component<ErrorBoundaryProps> {
-  state = {
-    error: null as Error | null,
-  };
-
-  constructor(props: ErrorBoundaryProps) {
-    super(props);
-    // eslint-disable-next-line @typescript-eslint/no-this-alias
-    errorBoundaryInstance = this;
-  }
-
-  static getDerivedStateFromError(error: Error) {
-    return { error };
-  }
-
-  render() {
-    if (this.state.error) {
-      return <></>;
-    }
-
-    return this.props.children;
-  }
+	state = {
+		error: null as Error | null,
+	};
+
+	constructor(props: ErrorBoundaryProps) {
+		super(props);
+		// eslint-disable-next-line @typescript-eslint/no-this-alias
+		errorBoundaryInstance = this;
+	}
+
+	static getDerivedStateFromError(error: Error) {
+		return { error };
+	}
+
+	render() {
+		if (this.state.error) {
+			return <></>;
+		}
+
+		return this.props.children;
+	}
 }