@pisell/materials 1.10.19 → 1.10.21

package/es/components/PisellBasicGrid/PisellBasicGrid.d.ts

@@ -1,10 +1,9 @@
 import { PisellBasicGridProps } from "./types.js";
-import React from "react";
 //#region src/components/PisellBasicGrid/PisellBasicGrid.d.ts
 /**
  * 使用 memo 优化组件性能
  * @description 当 props 没有变化时，避免不必要的重新渲染
  */
-declare const MemoizedPisellBasicGrid: <T>(props: PisellBasicGridProps<T>) => React.JSX.Element;
+declare const MemoizedPisellBasicGrid: <T>(props: PisellBasicGridProps<T>) => JSX.Element;
 //#endregion
 export { MemoizedPisellBasicGrid };

package/es/components/PisellCards/components/GraphicTextCard/GraphicTextCard.d.ts

@@ -1,10 +1,9 @@
 import { GraphicTextCardProps } from "./types.js";
-import React from "react";
 //#region src/components/PisellCards/components/GraphicTextCard/GraphicTextCard.d.ts
 /**
  * Provider 包装器
  * 兼容 PisellCards 系统的 props 传递方式
  */
-declare const Provider: (props: GraphicTextCardProps) => React.JSX.Element;
+declare const Provider: (props: GraphicTextCardProps) => JSX.Element;
 //#endregion
 export { Provider };

package/es/components/PisellCards/components/MultilevelCard/MultilevelCard.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
 //#region src/components/PisellCards/components/MultilevelCard/MultilevelCard.d.ts
-declare const Provider: (props: any) => React.JSX.Element;
+declare const Provider: (props: any) => JSX.Element;
 //#endregion
 export { Provider };

package/es/components/PisellCards/components/PisellImageCard/PisellImageCard.d.ts

@@ -1,10 +1,9 @@
 import { PisellImageCardProps } from "./types.js";
-import React from "react";
 //#region src/components/PisellCards/components/PisellImageCard/PisellImageCard.d.ts
 /**
  * Provider 包装器
  * 兼容 PisellCards 系统的 props 传递方式
  */
-declare const Provider: (props: PisellImageCardProps) => React.JSX.Element;
+declare const Provider: (props: PisellImageCardProps) => JSX.Element;
 //#endregion
 export { Provider };

package/es/components/PisellCards/components/TabCard/TabCard.d.ts

@@ -1,5 +1,4 @@
-import React from "react";
 //#region src/components/PisellCards/components/TabCard/TabCard.d.ts
-declare const Provider: (props: any) => React.JSX.Element;
+declare const Provider: (props: any) => JSX.Element;
 //#endregion
 export { Provider };

package/es/components/PisellCards/components/TextCard/TextCard.d.ts

@@ -1,9 +1,8 @@
-import React from "react";
 //#region src/components/PisellCards/components/TextCard/TextCard.d.ts
 /**
  * Provider 包装器
  * 兼容 PisellCards 系统的 props 传递方式
  */
-declare const Provider: (props: any) => React.JSX.Element;
+declare const Provider: (props: any) => JSX.Element;
 //#endregion
 export { Provider };

package/es/components/PisellCards/index.d.ts

@@ -1,18 +1,16 @@
-/// <reference types="react" />
 import { PisellBasicCardProps } from "./types.js";
 import { ImageDataSource, ImageFillMode, PisellImageCardProps } from "./components/PisellImageCard/types.js";
 import { GraphicConfig, GraphicTextCardProps, GraphicTextCardSize, GraphicTextCardVariant } from "./components/GraphicTextCard/types.js";
 import { BadgeConfig, TabCardProps } from "./components/TabCard/types.js";
 import { MultilevelCardProps } from "./components/MultilevelCard/types.js";
-import * as _$react from "react";
 
 //#region src/components/PisellCards/index.d.ts
 declare const PisellCards: {
-  TabCard: (props: any) => _$react.JSX.Element;
-  TextCard: (props: any) => _$react.JSX.Element;
-  GraphicTextCard: (props: GraphicTextCardProps) => _$react.JSX.Element;
-  MultilevelCard: (props: any) => _$react.JSX.Element;
-  PisellImageCard: (props: PisellImageCardProps) => _$react.JSX.Element;
+  TabCard: (props: any) => JSX.Element;
+  TextCard: (props: any) => JSX.Element;
+  GraphicTextCard: (props: GraphicTextCardProps) => JSX.Element;
+  MultilevelCard: (props: any) => JSX.Element;
+  PisellImageCard: (props: PisellImageCardProps) => JSX.Element;
 };
 //#endregion
 export { PisellCards };

package/es/components/PisellFields/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { PisellSingleLineTextProps } from "../pisellSingleLineText/types.js";
 import { PisellLongTextProps } from "../pisellLongText/types.js";
 import { PisellNumberProps } from "../pisellNumber/types.js";

package/es/components/PisellFields/index.js

@@ -1,14 +1,25 @@
 import PisellSingleLineText_default from "../pisellSingleLineText/PisellSingleLineText.js";
+import "../pisellSingleLineText/index.js";
 import PisellLongText_default from "../pisellLongText/PisellLongText.js";
+import "../pisellLongText/index.js";
 import MemoizedPisellNumber from "../pisellNumber/PisellNumber.js";
+import "../pisellNumber/index.js";
 import MemoizedPisellCurrency from "../pisellCurrency/PisellCurrency.js";
+import "../pisellCurrency/index.js";
 import MemoizedPisellPercent from "../pisellPercent/PisellPercent.js";
+import "../pisellPercent/index.js";
 import PisellPhone_default from "../pisellPhone/PisellPhone.js";
+import "../pisellPhone/index.js";
 import PisellEmail_default from "../pisellEmail/PisellEmail.js";
+import "../pisellEmail/index.js";
 import PisellUrl_default from "../pisellUrl/PisellUrl.js";
+import "../pisellUrl/index.js";
 import PisellRating_default from "../pisellRating/PisellRating.js";
+import "../pisellRating/index.js";
 import PisellSingleSelect from "../pisellSingleSelect/PisellSingleSelect.js";
+import "../pisellSingleSelect/index.js";
 import PisellMultipleSelect from "../pisellMultipleSelect/PisellMultipleSelect.js";
+import "../pisellMultipleSelect/index.js";
 //#region src/components/PisellFields/index.tsx
 /**
 * PisellFields 命名空间

package/es/components/PisellGroupView/PisellGroupView.d.ts

@@ -1,9 +1,8 @@
 import { PisellGroupViewProps } from "./types.js";
-import React from "react";
 //#region src/components/PisellGroupView/PisellGroupView.d.ts
 /**
  * 使用 memo 优化性能：props 未变化时跳过重渲染
  */
-declare const MemoizedPisellGroupView: <T>(props: PisellGroupViewProps<T>) => React.JSX.Element;
+declare const MemoizedPisellGroupView: <T>(props: PisellGroupViewProps<T>) => JSX.Element;
 //#endregion
 export { MemoizedPisellGroupView };

package/es/components/PisellLayouts/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { PisellBasicGridProps } from "../PisellBasicGrid/types.js";
 import { PisellScrollViewProps, PisellScrollViewRef } from "../PisellScrollView/types.js";
 import { FloorMapFullscreenMode, FloorMapItemBase, FloorMapLayoutContextValue, PisellFloorMapLayoutProps, PisellFloorMapLayoutRef } from "../pisellFloorMapLayout/types.js";
@@ -31,7 +30,7 @@ import * as _$react from "react";
  * </PisellLayouts.ScrollView>
  */
 declare const PisellLayouts: {
-  BasicGrid: <T>(props: PisellBasicGridProps<T>) => _$react.JSX.Element;
+  BasicGrid: <T>(props: PisellBasicGridProps<T>) => JSX.Element;
   ScrollView: _$react.ForwardRefExoticComponent<Omit<PisellScrollViewProps, "ref"> & _$react.RefAttributes<PisellScrollViewRef>>;
   FloorMapLayout: <T_1 extends FloorMapItemBase = FloorMapItemBase>(props: PisellFloorMapLayoutProps<T_1> & {
     ref?: _$react.Ref<PisellFloorMapLayoutRef | null> | undefined;
@@ -42,7 +41,7 @@ declare const PisellLayouts: {
   Header: _$react.FC<PisellHeaderProps>;
   Sider: _$react.FC<PisellSiderProps>;
   Container: <T_2 extends RenderType>(props: PisellContainerProps<T_2>) => any;
-  Row: (props: PisellRowProps) => _$react.JSX.Element;
+  Row: (props: PisellRowProps) => JSX.Element;
   ViewGrid: _$react.FC<PisellViewGridProps>;
 };
 //#endregion

package/es/components/PisellMetrics/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { PisellMetricCardProps } from "../pisellMetricCard/types.js";
 import { PisellStatisticListProps } from "../pisellStatisticList/index.js";
 import { PisellStatisticProps } from "../cardMetricItem/index.js";
@@ -22,8 +21,8 @@ import * as _$react from "react";
  */
 declare const PisellMetrics: {
   MetricCard: _$react.FC<PisellMetricCardProps>;
-  StatisticList: (props: PisellStatisticListProps) => _$react.JSX.Element;
-  MetricItem: (props: PisellStatisticProps) => _$react.JSX.Element;
+  StatisticList: (props: PisellStatisticListProps) => JSX.Element;
+  MetricItem: (props: PisellStatisticProps) => JSX.Element;
 };
 //#endregion
 export { PisellMetrics };

package/es/components/PisellSelectionFlow/PisellSelectionFlow.js

@@ -19,6 +19,7 @@ const SelectionFlow = ({ registry, draftAdapter, steps, initialDraft, initialSte
 	const flowGenerationRef = useRef(0);
 	const draftRevisionRef = useRef(0);
 	const navigationRevisionRef = useRef(0);
+	const preparationRevisionRef = useRef(0);
 	const transitionPendingRef = useRef(false);
 	const processDraftChangeRef = useRef(() => void 0);
 	const onDraftChangeRef = useRef(onDraftChange);
@@ -82,6 +83,7 @@ const SelectionFlow = ({ registry, draftAdapter, steps, initialDraft, initialSte
 			mountedRef.current = false;
 			if (flowGenerationRef.current === generation) flowGenerationRef.current += 1;
 			navigationRevisionRef.current += 1;
+			preparationRevisionRef.current += 1;
 			moduleInitializationRef.current.clear();
 			moduleDependencyLifecycleRef.current.clear();
 			pendingModuleChangeRef.current.clear();
@@ -297,7 +299,7 @@ const SelectionFlow = ({ registry, draftAdapter, steps, initialDraft, initialSte
 		draft,
 		moduleState
 	});
-	const { validateCurrentStep, complete, next, back } = useFlowNavigation({
+	const { validateCurrentStep, prepareSteps, complete, next, back } = useFlowNavigation({
 		registry,
 		draftAdapter,
 		createRuntimeIssue,
@@ -313,6 +315,7 @@ const SelectionFlow = ({ registry, draftAdapter, steps, initialDraft, initialSte
 		currentStepKeyRef,
 		validatedCompletionRef,
 		navigationRevisionRef,
+		preparationRevisionRef,
 		transitionPendingRef,
 		completedRef,
 		completionPromiseRef,
@@ -347,6 +350,7 @@ const SelectionFlow = ({ registry, draftAdapter, steps, initialDraft, initialSte
 		back,
 		updateDraft,
 		validateCurrentStep,
+		prepareSteps,
 		complete,
 		getState
 	}), [
@@ -354,6 +358,7 @@ const SelectionFlow = ({ registry, draftAdapter, steps, initialDraft, initialSte
 		complete,
 		getState,
 		next,
+		prepareSteps,
 		updateDraft,
 		validateCurrentStep
 	]);
@@ -377,6 +382,7 @@ const SelectionFlow = ({ registry, draftAdapter, steps, initialDraft, initialSte
 		context: contextValue,
 		updateDraft,
 		validateCurrentStep,
+		prepareSteps,
 		complete,
 		next,
 		back,

package/es/components/PisellSelectionFlow/hooks/useFlowNavigation.js

@@ -5,7 +5,7 @@ import { getCompiledStepsFingerprint, getSelectionFlowErrorMessage, normalizeFlo
 import { useCallback } from "react";
 //#region src/components/PisellSelectionFlow/hooks/useFlowNavigation.ts
 /** 导航、校验与提交门禁独立于模块加载生命周期。 */
-const useFlowNavigation = ({ registry, draftAdapter, createRuntimeIssue, mountedRef, moduleStateRef, moduleRevisionRef, draftRevisionRef, flowGenerationRef, moduleHandlesRef, configurationErrorRef, compiledStepsRef, currentStepIndexRef, currentStepKeyRef, validatedCompletionRef, navigationRevisionRef, transitionPendingRef, completedRef, completionPromiseRef, isCompletingRef, draftRef, onCompleteRef, ensureModuleReady, commitModuleState, getFreshContext, onValidationFailed, setCurrentStepIndex, setCompletionError, setCompletionReason, setIsCompleting }) => {
+const useFlowNavigation = ({ registry, draftAdapter, createRuntimeIssue, mountedRef, moduleStateRef, moduleRevisionRef, draftRevisionRef, flowGenerationRef, moduleHandlesRef, configurationErrorRef, compiledStepsRef, currentStepIndexRef, currentStepKeyRef, validatedCompletionRef, navigationRevisionRef, preparationRevisionRef, transitionPendingRef, completedRef, completionPromiseRef, isCompletingRef, draftRef, onCompleteRef, ensureModuleReady, commitModuleState, getFreshContext, onValidationFailed, setCurrentStepIndex, setCompletionError, setCompletionReason, setIsCompleting }) => {
 	const validateModule = useCallback(function() {
 		var _ref = _asyncToGenerator(function* (module) {
 			const adapter = resolveFlowModuleAdapter(registry, module.type);
@@ -104,6 +104,106 @@ const useFlowNavigation = ({ registry, draftAdapter, createRuntimeIssue, mounted
 		for (const module of step.modules) if (!(yield validateModule(module))) return false;
 		return true;
 	}), [validateModule]);
+	const prepareSteps = useCallback(_asyncToGenerator(function* (options = {}) {
+		var _options$fromStepInde;
+		if (!mountedRef.current || configurationErrorRef.current) return {
+			prepared: false,
+			cancelled: !mountedRef.current
+		};
+		const preparationRevision = preparationRevisionRef.current + 1;
+		preparationRevisionRef.current = preparationRevision;
+		const navigationRevision = navigationRevisionRef.current;
+		const flowGeneration = flowGenerationRef.current;
+		const compiledFingerprint = getCompiledStepsFingerprint(compiledStepsRef.current);
+		const fromStepIndex = Math.max(0, (_options$fromStepInde = options.fromStepIndex) !== null && _options$fromStepInde !== void 0 ? _options$fromStepInde : currentStepIndexRef.current + 1);
+		const isCurrentPreparation = () => mountedRef.current && preparationRevisionRef.current === preparationRevision && navigationRevisionRef.current === navigationRevision && flowGenerationRef.current === flowGeneration && getCompiledStepsFingerprint(compiledStepsRef.current) === compiledFingerprint;
+		const targetModules = compiledStepsRef.current.filter((step) => step.index >= fromStepIndex).flatMap((step) => step.modules.map((module) => ({
+			step,
+			module
+		})));
+		for (let pass = 0; pass <= targetModules.length; pass += 1) {
+			for (const { step, module } of targetModules) {
+				if (!isCurrentPreparation()) return {
+					prepared: false,
+					cancelled: true
+				};
+				const adapter = resolveFlowModuleAdapter(registry, module.type);
+				if (!(adapter === null || adapter === void 0 ? void 0 : adapter.validateAutoResolution)) return {
+					prepared: false,
+					firstUnresolvedStepIndex: step.index,
+					moduleKey: module.key
+				};
+				if (!(yield ensureModuleReady(module))) {
+					const state = moduleStateRef.current[module.key];
+					return isCurrentPreparation() ? {
+						prepared: false,
+						firstUnresolvedStepIndex: step.index,
+						moduleKey: module.key,
+						message: state === null || state === void 0 ? void 0 : state.message
+					} : {
+						prepared: false,
+						cancelled: true
+					};
+				}
+				if (!isCurrentPreparation()) return {
+					prepared: false,
+					cancelled: true
+				};
+				const validationDraftRevision = draftRevisionRef.current;
+				try {
+					const context = getFreshContext();
+					if (!context) return {
+						prepared: false,
+						cancelled: true
+					};
+					const result = normalizeFlowValidationResult(yield adapter.validateAutoResolution(context, module));
+					if (!isCurrentPreparation() || draftRevisionRef.current !== validationDraftRevision) return {
+						prepared: false,
+						cancelled: true
+					};
+					if (!result.valid) return {
+						prepared: false,
+						firstUnresolvedStepIndex: step.index,
+						moduleKey: module.key,
+						message: result.message
+					};
+				} catch (error) {
+					return isCurrentPreparation() ? {
+						prepared: false,
+						firstUnresolvedStepIndex: step.index,
+						moduleKey: module.key,
+						message: getSelectionFlowErrorMessage(error)
+					} : {
+						prepared: false,
+						cancelled: true
+					};
+				}
+			}
+			if (!targetModules.find(({ module }) => {
+				var _moduleStateRef$curre;
+				return ((_moduleStateRef$curre = moduleStateRef.current[module.key]) === null || _moduleStateRef$curre === void 0 ? void 0 : _moduleStateRef$curre.status) !== "ready";
+			})) return isCurrentPreparation() ? { prepared: true } : {
+				prepared: false,
+				cancelled: true
+			};
+		}
+		const unresolved = targetModules.find(({ module }) => {
+			var _moduleStateRef$curre2;
+			return ((_moduleStateRef$curre2 = moduleStateRef.current[module.key]) === null || _moduleStateRef$curre2 === void 0 ? void 0 : _moduleStateRef$curre2.status) !== "ready";
+		});
+		return unresolved ? {
+			prepared: false,
+			firstUnresolvedStepIndex: unresolved.step.index,
+			moduleKey: unresolved.module.key
+		} : {
+			prepared: false,
+			cancelled: true
+		};
+	}), [
+		ensureModuleReady,
+		getFreshContext,
+		registry
+	]);
 	const runBeforeLeaveForCurrentStep = useCallback(_asyncToGenerator(function* () {
 		if (configurationErrorRef.current) return false;
 		const stepIndex = currentStepIndexRef.current;
@@ -188,8 +288,8 @@ const useFlowNavigation = ({ registry, draftAdapter, createRuntimeIssue, mounted
 		const latestRevisionFingerprint = latestSteps.flatMap((step) => step.modules).map((module) => `${module.key}:${moduleRevisionRef.current.get(module.key) || 0}`).join("|");
 		if (compiledFingerprint !== latestCompiledFingerprint || revisionFingerprint !== latestRevisionFingerprint || draftRevision !== draftRevisionRef.current) {
 			const targetStep = latestSteps.find((step) => step.modules.some((module) => {
-				var _moduleStateRef$curre;
-				return ((_moduleStateRef$curre = moduleStateRef.current[module.key]) === null || _moduleStateRef$curre === void 0 ? void 0 : _moduleStateRef$curre.status) !== "ready";
+				var _moduleStateRef$curre3;
+				return ((_moduleStateRef$curre3 = moduleStateRef.current[module.key]) === null || _moduleStateRef$curre3 === void 0 ? void 0 : _moduleStateRef$curre3.status) !== "ready";
 			})) || latestSteps[0];
 			const targetModule = targetStep === null || targetStep === void 0 ? void 0 : targetStep.modules[0];
 			if (targetStep && targetModule) {
@@ -274,6 +374,7 @@ const useFlowNavigation = ({ registry, draftAdapter, createRuntimeIssue, mounted
 	]);
 	return {
 		validateCurrentStep,
+		prepareSteps,
 		runBeforeLeaveForCurrentStep,
 		complete,
 		next: useCallback(_asyncToGenerator(function* () {

package/es/components/PisellSelectionFlow/index.d.ts

@@ -1,4 +1,4 @@
-import { CompiledSelectionFlowModuleConfig, CompiledSelectionFlowStep, FlowModuleBeforeLeaveResult, FlowModuleBeforeLeaveReturn, FlowModuleDataMap, FlowModuleHandle, FlowModuleState, FlowModuleStateMap, FlowModuleStatus, FlowModuleValidationResult, FlowModuleValidationReturn, PisellSelectionFlowController, PisellSelectionFlowProps, SelectionFlowCompileError, SelectionFlowCompileIssue, SelectionFlowCompileIssueCode, SelectionFlowContextValue, SelectionFlowDraftAdapter, SelectionFlowDraftChange, SelectionFlowDraftUpdateMeta, SelectionFlowMessageCode, SelectionFlowMetadata, SelectionFlowModuleAdapter, SelectionFlowModuleConfig, SelectionFlowModuleInput, SelectionFlowModuleRegistry, SelectionFlowRef, SelectionFlowRuntimeIssue, SelectionFlowSnapshot, SelectionFlowStepConfig, SelectionFlowValidationFeedback } from "./types.js";
+import { CompiledSelectionFlowModuleConfig, CompiledSelectionFlowStep, FlowModuleBeforeLeaveResult, FlowModuleBeforeLeaveReturn, FlowModuleDataMap, FlowModuleHandle, FlowModuleState, FlowModuleStateMap, FlowModuleStatus, FlowModuleValidationResult, FlowModuleValidationReturn, PisellSelectionFlowController, PisellSelectionFlowProps, SelectionFlowCompileError, SelectionFlowCompileIssue, SelectionFlowCompileIssueCode, SelectionFlowContextValue, SelectionFlowDraftAdapter, SelectionFlowDraftChange, SelectionFlowDraftUpdateMeta, SelectionFlowMessageCode, SelectionFlowMetadata, SelectionFlowModuleAdapter, SelectionFlowModuleConfig, SelectionFlowModuleInput, SelectionFlowModuleRegistry, SelectionFlowPrepareStepsOptions, SelectionFlowPrepareStepsResult, SelectionFlowRef, SelectionFlowRuntimeIssue, SelectionFlowSnapshot, SelectionFlowStepConfig, SelectionFlowValidationFeedback } from "./types.js";
 import { _default } from "./PisellSelectionFlow.js";
 import { useSelectionFlowContext, useTypedSelectionFlowContext } from "./context.js";
 import { compileSelectionFlow, compileSelectionFlowSteps, hasSelectionDraftFieldValue, isSelectionModuleType, resolveFlowModuleAdapter } from "./compiler.js";

package/es/components/PisellSelectionFlow/types.d.ts

@@ -57,6 +57,18 @@ type FlowModuleValidationResult = boolean | {
   message?: string;
 };
 type FlowModuleValidationReturn = FlowModuleValidationResult | Promise<FlowModuleValidationResult>;
+interface SelectionFlowPrepareStepsOptions {
+  /** 从哪个已编译步骤开始准备；默认从当前步骤的下一步开始。 */
+  fromStepIndex?: number;
+}
+interface SelectionFlowPrepareStepsResult {
+  prepared: boolean;
+  /** 新一轮准备、导航、重新编译或卸载使本轮结果失效。 */
+  cancelled?: boolean;
+  firstUnresolvedStepIndex?: number;
+  moduleKey?: string;
+  message?: string;
+}
 type FlowModuleBeforeLeaveResult = boolean | {
   allowed: boolean;
   message?: string;
@@ -98,6 +110,11 @@ interface SelectionFlowModuleAdapter<TDraft, TDraftUpdate, TField extends string
   reconcile?: (context: SelectionFlowContextValue<TDraft, TDraftUpdate, TField, TModuleType, TServices, THostContext>, change: SelectionFlowDraftChange<TDraft, TField, TModuleType>, module: CompiledSelectionFlowModuleConfig<TModuleType>) => void | Promise<void>;
   clearDependencies?: (context: SelectionFlowContextValue<TDraft, TDraftUpdate, TField, TModuleType, TServices, THostContext>, change: SelectionFlowDraftChange<TDraft, TField, TModuleType>, module: CompiledSelectionFlowModuleConfig<TModuleType>) => void | Promise<void>;
   validate?: (context: SelectionFlowContextValue<TDraft, TDraftUpdate, TField, TModuleType, TServices, THostContext>, handle: FlowModuleHandle | null, module: CompiledSelectionFlowModuleConfig<TModuleType>) => FlowModuleValidationReturn;
+  /**
+   * 模块完成 refresh 后，判断当前值能否在无界面的情况下安全采用。
+   * 不提供即表示该模块必须由用户进入步骤确认。
+   */
+  validateAutoResolution?: (context: SelectionFlowContextValue<TDraft, TDraftUpdate, TField, TModuleType, TServices, THostContext>, module: CompiledSelectionFlowModuleConfig<TModuleType>) => FlowModuleValidationReturn;
   beforeLeave?: (context: SelectionFlowContextValue<TDraft, TDraftUpdate, TField, TModuleType, TServices, THostContext>, handle: FlowModuleHandle | null, module: CompiledSelectionFlowModuleConfig<TModuleType>) => FlowModuleBeforeLeaveReturn;
 }
 type SelectionFlowModuleRegistry<TDraft, TDraftUpdate, TField extends string, TModuleType extends string, TServices = unknown, THostContext = unknown> = Record<TModuleType, SelectionFlowModuleAdapter<TDraft, TDraftUpdate, TField, TModuleType, TServices, THostContext>>;
@@ -117,6 +134,7 @@ interface SelectionFlowRef<TDraft, TDraftUpdate, TField extends string = string,
   back: () => boolean;
   updateDraft: (update: TDraftUpdate, meta: SelectionFlowDraftUpdateMeta<TField, TModuleType>) => void;
   validateCurrentStep: () => Promise<boolean>;
+  prepareSteps: (options?: SelectionFlowPrepareStepsOptions) => Promise<SelectionFlowPrepareStepsResult>;
   complete: () => Promise<boolean>;
   getState: () => SelectionFlowSnapshot<TDraft, TModuleType>;
 }
@@ -139,6 +157,7 @@ interface PisellSelectionFlowController<TDraft, TDraftUpdate, TField extends str
   completionReason?: SelectionFlowRuntimeIssue;
   updateDraft: (update: TDraftUpdate, meta: SelectionFlowDraftUpdateMeta<TField, TModuleType>) => void;
   validateCurrentStep: () => Promise<boolean>;
+  prepareSteps: (options?: SelectionFlowPrepareStepsOptions) => Promise<SelectionFlowPrepareStepsResult>;
   complete: () => Promise<boolean>;
   next: () => Promise<boolean>;
   back: () => boolean;
@@ -176,4 +195,4 @@ declare class SelectionFlowCompileError extends Error {
   constructor(issues: readonly SelectionFlowCompileIssue[]);
 }
 //#endregion
-export { CompiledSelectionFlowModuleConfig, CompiledSelectionFlowStep, FlowModuleBeforeLeaveResult, FlowModuleBeforeLeaveReturn, FlowModuleDataMap, FlowModuleHandle, FlowModuleState, FlowModuleStateMap, FlowModuleStatus, FlowModuleValidationResult, FlowModuleValidationReturn, PisellSelectionFlowController, PisellSelectionFlowProps, SelectionFlowCompileError, SelectionFlowCompileIssue, SelectionFlowCompileIssueCode, SelectionFlowContextValue, SelectionFlowDraftAdapter, SelectionFlowDraftChange, SelectionFlowDraftUpdateMeta, SelectionFlowMessageCode, SelectionFlowMetadata, SelectionFlowModuleAdapter, SelectionFlowModuleConfig, SelectionFlowModuleInput, SelectionFlowModuleRegistry, SelectionFlowRef, SelectionFlowRuntimeIssue, SelectionFlowSnapshot, SelectionFlowStepConfig, SelectionFlowValidationFeedback };
+export { CompiledSelectionFlowModuleConfig, CompiledSelectionFlowStep, FlowModuleBeforeLeaveResult, FlowModuleBeforeLeaveReturn, FlowModuleDataMap, FlowModuleHandle, FlowModuleState, FlowModuleStateMap, FlowModuleStatus, FlowModuleValidationResult, FlowModuleValidationReturn, PisellSelectionFlowController, PisellSelectionFlowProps, SelectionFlowCompileError, SelectionFlowCompileIssue, SelectionFlowCompileIssueCode, SelectionFlowContextValue, SelectionFlowDraftAdapter, SelectionFlowDraftChange, SelectionFlowDraftUpdateMeta, SelectionFlowMessageCode, SelectionFlowMetadata, SelectionFlowModuleAdapter, SelectionFlowModuleConfig, SelectionFlowModuleInput, SelectionFlowModuleRegistry, SelectionFlowPrepareStepsOptions, SelectionFlowPrepareStepsResult, SelectionFlowRef, SelectionFlowRuntimeIssue, SelectionFlowSnapshot, SelectionFlowStepConfig, SelectionFlowValidationFeedback };

package/es/components/appVersionControl/index.d.ts

@@ -1,6 +1,5 @@
 import { AppVersionControlProps } from "./types.js";
-import React from "react";
 //#region src/components/appVersionControl/index.d.ts
-declare const AppVersionControl: (props: AppVersionControlProps) => React.JSX.Element;
+declare const AppVersionControl: (props: AppVersionControlProps) => JSX.Element;
 //#endregion
 export { AppVersionControl };

package/es/components/appVersionControl/types.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 //#region src/components/appVersionControl/types.d.ts
 interface Version {
   id: string;

package/es/components/auto-complete-number/index.d.ts

@@ -1,4 +1,3 @@
-import React from "react";
 import { AutoCompleteProps, InputNumberProps } from "antd";
 
 //#region src/components/auto-complete-number/index.d.ts
@@ -8,6 +7,6 @@ interface AutoCompleteNumberProps {
   value?: any;
   onChange?: any;
 }
-declare const AutoCompleteNumber: (props: AutoCompleteNumberProps) => React.JSX.Element;
+declare const AutoCompleteNumber: (props: AutoCompleteNumberProps) => JSX.Element;
 //#endregion
 export { AutoCompleteNumber };

package/es/components/badge/index.d.ts

@@ -1,5 +1,4 @@
-import React from "react";
 //#region src/components/badge/index.d.ts
-declare const Badge$1: (props: any) => React.JSX.Element;
+declare const Badge$1: (props: any) => JSX.Element;
 //#endregion
 export { Badge$1 as Badge };

package/es/components/batch-editor/index.d.ts

@@ -1,4 +1,3 @@
-import React from "react";
 //#region src/components/batch-editor/index.d.ts
 interface BatchEditorProps {
   columns: any[];
@@ -7,6 +6,6 @@ interface BatchEditorProps {
   rowKey: string;
   otherTableProps: any;
 }
-declare const BatchEditor: (props: BatchEditorProps) => React.JSX.Element;
+declare const BatchEditor: (props: BatchEditorProps) => JSX.Element;
 //#endregion
 export { BatchEditor };

package/es/components/calendar/index.d.ts

@@ -1,7 +1,4 @@
-/// <reference types="react" />
-import * as _$react from "react";
-
 //#region src/components/calendar/index.d.ts
-declare const Calendar: (props: any) => _$react.JSX.Element;
+declare const Calendar: (props: any) => JSX.Element;
 //#endregion
 export { Calendar };

package/es/components/cardMetricItem/index.d.ts

@@ -11,6 +11,6 @@ interface PisellStatisticProps {
   showCurrencySymbol?: boolean;
   style?: any;
 }
-declare const CardMetricItem: (props: PisellStatisticProps) => React.JSX.Element;
+declare const CardMetricItem: (props: PisellStatisticProps) => JSX.Element;
 //#endregion
 export { CardMetricItem, PisellStatisticProps };

package/es/components/cardPro/index.d.ts

@@ -1,5 +1,4 @@
-import React from "react";
 //#region src/components/cardPro/index.d.ts
-declare const _default: (props: any) => React.JSX.Element;
+declare const _default: (props: any) => JSX.Element;
 //#endregion
 export { _default };

package/es/components/checkbox/index.d.ts

@@ -1,7 +1,4 @@
-/// <reference types="react" />
-import * as _$react from "react";
-
 //#region src/components/checkbox/index.d.ts
-declare const Checkbox: (props: any) => _$react.JSX.Element;
+declare const Checkbox: (props: any) => JSX.Element;
 //#endregion
 export { Checkbox };

package/es/components/classicLayout/index.d.ts

@@ -1,5 +1,4 @@
-import React from "react";
 //#region src/components/classicLayout/index.d.ts
-declare const ClassicLayout: (props: any) => React.JSX.Element;
+declare const ClassicLayout: (props: any) => JSX.Element;
 //#endregion
 export { ClassicLayout };

package/es/components/config-provider/index.d.ts

@@ -1,10 +1,9 @@
-import React from "react";
 import { ConfigProviderProps } from "antd/es/config-provider";
 
 //#region src/components/config-provider/index.d.ts
 interface ConfigProviderProps$1 extends ConfigProviderProps {
   [key: string]: any;
 }
-declare const ConfigProvider: (props: ConfigProviderProps$1) => React.JSX.Element;
+declare const ConfigProvider: (props: ConfigProviderProps$1) => JSX.Element;
 //#endregion
 export { ConfigProvider, ConfigProviderProps$1 as ConfigProviderProps };

package/es/components/customSelect/index.d.ts

@@ -13,6 +13,6 @@ interface CustomSelectProps<T extends BaseOption> extends Omit<SelectProps<T['va
   className?: string;
   style?: React.CSSProperties;
 }
-declare const CustomSelect: <T extends BaseOption>(props: CustomSelectProps<T>) => React.JSX.Element;
+declare const CustomSelect: <T extends BaseOption>(props: CustomSelectProps<T>) => JSX.Element;
 //#endregion
 export { CustomSelect };

package/es/components/dataSourceComponents/dataSourceForm/group/index.d.ts

@@ -16,6 +16,6 @@ interface FormGroupProps {
  * @Author: shengjie.zuo
  * @Date: 2024-11-25 17:14:25
  */
-declare const FormGroup: (props: FormGroupProps) => React.JSX.Element;
+declare const FormGroup: (props: FormGroupProps) => JSX.Element;
 //#endregion
 export { FormGroup };

package/es/components/dataSourceComponents/dataSourceForm/submitButton/index.d.ts

@@ -35,6 +35,6 @@ interface SubmitButtonProps extends ButtonProps {
     placement: 'top' | 'topLeft' | 'topRight' | 'bottom' | 'bottomLeft' | 'bottomRight';
   };
 }
-declare const SubmitButton: (props: SubmitButtonProps) => React.JSX.Element | null;
+declare const SubmitButton: (props: SubmitButtonProps) => JSX.Element | null;
 //#endregion
 export { SubmitButton };

package/es/components/dataSourceComponents/dataSourceMenu/index.d.ts

@@ -6,6 +6,6 @@ import React from "react";
  * @title: 数据源表单组件
  * @description: 基于数据源动态生成表单，支持编辑、查看、禁用三种模式
  */
-declare const DataSourceMenu: (props: PisellMenuProps, ref: React.Ref<any>) => React.JSX.Element;
+declare const DataSourceMenu: (props: PisellMenuProps, ref: React.Ref<any>) => JSX.Element;
 //#endregion
 export { DataSourceMenu };

package/es/components/dataSourceComponents/dataSourceShow/dataSourceQRCode/index.d.ts

@@ -1,7 +1,4 @@
-/// <reference types="react" />
-import * as _$react from "react";
-
 //#region src/components/dataSourceComponents/dataSourceShow/dataSourceQRCode/index.d.ts
-declare const DataSourceQRCode: (props: any) => _$react.JSX.Element;
+declare const DataSourceQRCode: (props: any) => JSX.Element;
 //#endregion
 export { DataSourceQRCode };

package/es/components/dataSourceComponents/dataSourceShow/dataSourceTypography/index.d.ts

@@ -7,8 +7,8 @@ interface DataSourceTypographyProps {
   children: React.ReactNode;
 }
 declare const DataSourceTypography: {
-  (props: DataSourceTypographyProps): React.JSX.Element;
-  Text: (props: ParsedProps) => React.JSX.Element;
+  (props: DataSourceTypographyProps): JSX.Element;
+  Text: (props: ParsedProps) => JSX.Element;
 };
 //#endregion
 export { DataSourceTypography };

package/es/components/dataSourceComponents/dataSourceTable/type.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { LocalSettingsType } from "../../table/types.js";
 import { DataSourceType } from "../provider/dataSource/DataSourceContext.js";
 import { ColumnType } from "antd/es/table";

package/es/components/dataSourceComponents/dataSourceWrapper/index.d.ts

@@ -1,7 +1,6 @@
 import { DataSourceContextProps } from "../provider/dataSource/DataSourceContext.js";
-import React from "react";
 
 //#region src/components/dataSourceComponents/dataSourceWrapper/index.d.ts
-declare const DataSourceWrapper: (props: DataSourceContextProps) => React.JSX.Element;
+declare const DataSourceWrapper: (props: DataSourceContextProps) => JSX.Element;
 //#endregion
 export { DataSourceWrapper };

package/es/components/dataSourceComponents/fields/Checkbox/WithMode.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { CheckboxGroupProps } from "./type.js";
 import { WithModeProps } from "../../dataSourceForm/utils.js";
 import * as _$react from "react";

package/es/components/dataSourceComponents/fields/Radio/WithMode.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { WithModeProps } from "../../dataSourceForm/utils.js";
 import { RadioGroupProps } from "./type.js";
 import * as _$react from "react";