@yiyi_zhang/reactflow-ui 1.1.0 → 1.3.0

package/dist/AiWorkflowIDE.d.ts

@@ -10,6 +10,8 @@ import type { WorkflowDef, WorkflowInstance } from './types/conductor';
 import type { AiConfig } from './services/ai/protocolAdapter';
 import type { AiMetrics } from './store/aiStore';
 import type { WorkflowLibraryItem } from './types/workflowLibrary';
+import type { LibraryProvider } from './library/types';
+import type { IdeProviders } from './providers/types';
 import type { ExecutionActions, ThemeMode, ThemeColor, LayoutDirection, ViewMode, WorkflowExecutionInput } from './types/workflow';
 import type { CustomTool } from './services/ai/toolRegistry';
 import type { CustomValidationRule } from './services/ai/ruleEngine';
@@ -42,6 +44,32 @@ export interface AiWorkflowIDEProps {
      * ```
      */
     workflowLibrary?: WorkflowLibraryItem[];
+    /**
+     * 流程库数据源（LibraryProvider）。提供后，库内流程 / 任务定义经规范化后同时投影为
+     * AI 目录（`workflowLibrary`）、任务 Schema（`taskSchemas`）与检索工具的数据来源；
+     * 同名条目 Provider 优先于静态 prop，静态 prop 仍可单独使用。
+     *
+     * `libraryProvider` 引用变化时重新加载，组件卸载时中止进行中的请求。
+     * AI 新建的 SUB_WORKFLOW 会固定为目录当前最新版本，已有版本号不会被自动改变。
+     *
+     * ```tsx
+     * const provider = createConductorLibraryProvider({ baseUrl, headers });
+     * <AiWorkflowIDE libraryProvider={provider} />
+     * ```
+     */
+    libraryProvider?: LibraryProvider;
+    /**
+     * 统一扩展点集合（`library` / `onboarding` / `telemetry`）。
+     * 解析顺序：专用 prop（如 `libraryProvider`）> 本 prop > 外层 `WorkflowIdeProvider` > 无。
+     * 按字段比较引用，宿主每次渲染新建对象但 provider 实例不变时不会触发目录重载。
+     */
+    providers?: IdeProviders;
+    /**
+     * 流程库目录注入系统提示词的条数上限，默认 50（按层级 L3 -> L1 截断）。
+     * 超出部分会提示 AI 改用 `search_workflow_library` 检索。
+     * 提供 `libraryProvider` 时，任务 Schema 段落同样受此上限约束。
+     */
+    promptCatalogLimit?: number;
     /**
      * AI 模型配置（集成方提供）。
      *

package/dist/WorkflowIDE.d.ts

@@ -2,6 +2,9 @@ import { ThemeMode, ThemeColor, LayoutDirection, ValidationResults, ExecutionAct
 import { WorkflowDef, WorkflowInstance } from './types/conductor';
 import { AIServiceConfig } from './services/aiService';
 import { ActionDefinition } from './actions/types';
+import type { WorkflowLevel } from './types/workflowLibrary';
+import type { LibraryProvider } from './library/types';
+import type { IdeProviders } from './providers/types';
 import './styles/tokens.css';
 import './styles/executionStyles.css';
 /**
@@ -16,6 +19,8 @@ export interface WorkflowIDERef {
     save: () => void;
     /** 创建空白工作流 */
     createBlankWorkflow: (name?: string) => void;
+    /** 打开「导入接口」对话框（OpenAPI / Swagger / Postman / curl），供宿主或自助接入向导调用 */
+    openApiImport: () => void;
 }
 /**
  * WorkflowIDE 组件的属性接口
@@ -105,6 +110,31 @@ export interface WorkflowIDEProps {
      * 宿主可传入自定义业务动作（如私有云/特定系统连接器）。
      */
     actions?: ActionDefinition[];
+    /**
+     * 流程库数据源（LibraryProvider）。提供后，库内流程 / 任务定义会生成业务动作并注册到本实例的动作库：
+     * 流程库能力编译为 `SUB_WORKFLOW`，步骤在首次引用时固定为目录当前最新版本，
+     * 库发布新版本后步骤不会自动跟随，徽标提示「有新版本」，由用户确认差异后手动升级。
+     *
+     * 同名动作 Provider 优先于 `actions`；不传时 `actions` 的行为完全不变。
+     * `libraryProvider` 引用变化时重新加载，组件卸载时中止进行中的请求。
+     *
+     * ```tsx
+     * const provider = createConductorLibraryProvider({ baseUrl, headers });
+     * <WorkflowIDE uiMode="business" libraryProvider={provider} />
+     * ```
+     */
+    libraryProvider?: LibraryProvider;
+    /**
+     * 统一扩展点集合（`library` / `onboarding` / `telemetry`）。
+     * 解析顺序：专用 prop（如 `libraryProvider`）> 本 prop > 外层 `WorkflowIdeProvider` > 无。
+     * 按字段比较引用，宿主每次渲染新建对象但 provider 实例不变时不会触发目录重载。
+     */
+    providers?: IdeProviders;
+    /**
+     * 当前正在编辑的工作流层级（L1 / L2 / L3）。
+     * 提供时，动作选择器隐藏违反分层调用规则的流程库动作（L1 不显示 L2/L3，L2 不显示 L3）；未提供则不过滤。
+     */
+    currentWorkflowLevel?: WorkflowLevel;
     /**
      * 组件容器高度。
      * @default '100%'

package/dist/actions/fromDefinitions.d.ts

@@ -0,0 +1,70 @@
+import type { SchemaDef, WorkflowDef } from '../types/conductor';
+import type { ActionCategory, ActionDefinition, ActionField, ActionOutputField } from './types';
+import type { WorkflowLevel } from '../types/workflowLibrary';
+/**
+ * 从 Conductor OSS 标准定义（WorkflowDef / 已注册 TaskDef）生成业务动作。
+ *
+ * 设计原则：
+ * - 库本身不发请求：定义数据由接入方从治理层取得（权限过滤也在治理层完成）。
+ * - 标准结构给不了的信息（中文名、分类、图标、风险等级、特殊控件、层级、标签）
+ *   通过可选的 ActionExtension 补充；缺省时按合理默认值降级，保证任何定义都能出现在动作库里。
+ */
+/** 治理层/接入方提供的补充字段（均可选，按名称一一对应） */
+export interface ActionExtension {
+    /** 业务展示名（缺省使用定义名称） */
+    label?: string;
+    description?: string;
+    category?: ActionCategory;
+    icon?: string;
+    riskLevel?: 'safe' | 'sensitive';
+    connector?: string;
+    level?: WorkflowLevel;
+    /** 业务域展示名 */
+    domain?: string;
+    tags?: string[];
+    /** 为 true 时不进入动作库（例如用户无权限、已下线） */
+    hidden?: boolean;
+    /** 按入参 key 覆盖表单字段属性（中文标签、控件类型、下拉选项等） */
+    fieldOverrides?: Record<string, Partial<ActionField>>;
+    /** 按出参 key 覆盖出参说明（中文标签、示例值） */
+    outputOverrides?: Record<string, Partial<ActionOutputField>>;
+}
+/** Conductor `/metadata/taskdefs` 返回的已注册任务定义（只列本模块用到的标准字段） */
+export interface RegisteredTaskDef {
+    name: string;
+    description?: string;
+    /** 仅文档用途，不强制 */
+    inputKeys?: string[];
+    outputKeys?: string[];
+    inputTemplate?: Record<string, any>;
+    inputSchema?: SchemaDef;
+    outputSchema?: SchemaDef;
+    ownerEmail?: string;
+}
+/**
+ * 将 JSON Schema 的 properties 转为表单字段；没有 schema 时退化为仅有 key 列表
+ * （Conductor 的 inputKeys / inputParameters 只有名称），类型一律按文本处理。
+ */
+export declare function buildFields(schema: SchemaDef | undefined, fallbackKeys: string[], inputTemplate?: Record<string, any>): ActionField[];
+/** 出参：优先 outputSchema；其次 outputKeys / outputParameters 的 key（后者是输出模板，其 key 即对外接口） */
+export declare function buildOutputs(schema: SchemaDef | undefined, fallbackKeys: string[], outputTemplate?: Record<string, any>): ActionOutputField[];
+/**
+ * 把流程库中的一个工作流定义生成为动作：业务用户只面对入参表单与出参，
+ * 编译为 SUB_WORKFLOW 引用。版本由步骤上的 libraryRef 决定（首次引用时固定）。
+ * 被 extension.hidden 标记时返回 null。
+ */
+export declare function buildActionFromWorkflowDef(def: WorkflowDef, ext?: ActionExtension): ActionDefinition | null;
+/** 已注册任务定义生成原子动作，编译为同名 SIMPLE 任务。 */
+export declare function buildActionFromTaskDef(def: RegisteredTaskDef, ext?: ActionExtension): ActionDefinition | null;
+export interface LibraryWorkflowEntry {
+    workflowDef: WorkflowDef;
+    extension?: ActionExtension;
+}
+export interface RegisteredTaskEntry {
+    taskDef: RegisteredTaskDef;
+    extension?: ActionExtension;
+}
+/** 批量生成流程库动作（自动跳过 hidden） */
+export declare function buildActionsFromLibrary(entries: LibraryWorkflowEntry[]): ActionDefinition[];
+/** 批量生成原子任务动作（自动跳过 hidden） */
+export declare function buildActionsFromTaskDefs(entries: RegisteredTaskEntry[]): ActionDefinition[];

package/dist/actions/registry.d.ts

@@ -5,6 +5,7 @@ export declare class ActionRegistry {
     constructor(initialActions?: ActionDefinition[]);
     register(action: ActionDefinition): void;
     registerAll(actions: ActionDefinition[]): void;
+    unregister(id: string): void;
     getAction(id: string): ActionDefinition | undefined;
     getAllActions(): ActionDefinition[];
     getActionsByCategory(category?: ActionCategory): ActionDefinition[];

package/dist/actions/types.d.ts

@@ -1,4 +1,5 @@
 import type { TaskDef } from '../types/conductor';
+import type { WorkflowLevel } from '../types/workflowLibrary';
 export type ActionCategory = 'compute' | 'storage' | 'network' | 'monitor' | 'notify' | 'logic' | 'human' | 'custom';
 export type ActionFieldType = 'text' | 'textarea' | 'number' | 'select' | 'boolean' | 'account' | 'cron-friendly';
 export interface ActionFieldOption {
@@ -28,6 +29,16 @@ export interface CompileCtx {
     taskReferenceName: string;
     stepIndex: number;
     workflowName?: string;
+    /**
+     * 该步骤引用流程库能力时记录的 {名称, 版本}。
+     * 版本在首次引用时固定，库升级后不会自动跟随；version 缺省表示沿用原定义（不显式指定版本）。
+     */
+    libraryRef?: LibraryRef;
+}
+/** 步骤对流程库能力（SUB_WORKFLOW）的引用记录 */
+export interface LibraryRef {
+    name: string;
+    version?: number;
 }
 export interface ActionDefinition {
     id: string;
@@ -36,6 +47,21 @@ export interface ActionDefinition {
     icon: string;
     description: string;
     connector?: string;
+    /** 动作来源：task = 原子任务（默认），workflow = 流程库能力（以 SUB_WORKFLOW 引用） */
+    kind?: 'task' | 'workflow';
+    /** kind = workflow 时：库中该能力的当前最新版本，用于提示“有新版本可升级” */
+    workflowRef?: {
+        name: string;
+        version: number;
+    };
+    /** 流程库层级 L1 / L2 / L3（调用方向规则见 workflowLibrary） */
+    level?: WorkflowLevel;
+    /** 业务域展示名（流程库动作）；动作选择器据此分组，缺省归入「其他」 */
+    domain?: string;
+    /** 已下线 / 不建议新引用：动作选择器隐藏，但已引用的步骤照常显示与编译 */
+    deprecated?: boolean;
+    tags?: string[];
+    ownerEmail?: string;
     riskLevel: 'safe' | 'sensitive';
     fields: ActionField[];
     outputs: ActionOutputField[];

package/dist/ai.d.ts

@@ -21,6 +21,15 @@ export type { CustomTool } from './services/ai/toolRegistry';
 export type { CustomValidationRule } from './services/ai/ruleEngine';
 export type { TaskSchema } from './services/ai/schemaRegistry';
 export type { WorkflowLevel, WorkflowLibraryItem, WorkflowLibraryDetail } from './types/workflowLibrary';
+export type { LibraryProvider, LibraryExtension, LibraryWorkflowRecord, LibraryTaskRecord, LibraryListResult, LibrarySearchOptions, LibraryLoadStatus, } from './library/types';
+export { LibraryCatalog } from './library/catalog';
+export type { LibraryEntry, LibraryCatalogSnapshot, LibraryCatalogOptions } from './library/catalog';
+export { toActions, toTaskSchemas, toLibraryItems } from './library/projections';
+export { parseWorkflowName, validateWorkflowName } from './library/naming';
+export type { ParsedWorkflowName, WorkflowNameType } from './library/naming';
+export { createConductorLibraryProvider } from './library/conductorProvider';
+export type { ConductorLibraryProviderOptions } from './library/conductorProvider';
+export { DEFAULT_PROMPT_CATALOG_LIMIT } from './services/ai/systemPrompt';
 export type { AiEvent, AiEventType } from './types/aiEvents';
 export type { DiffSummary, PartialAcceptSelection, PatchOp } from './services/ai/toolExecutor';
 export { applyPartialProposal, describeDiff, computeDiff } from './services/ai/toolExecutor';
@@ -32,3 +41,19 @@ export { getCompletionItems, buildDataFlowGraph, refactorTaskReferenceName, getU
 export type { WlspCompletionItem, DataFlowGraph, DataFlowEdge, InferredField, UpstreamTaskInfo, } from './services/wlsp/workflowLsp';
 export { executeLocalSandboxDryRun, buildDefaultWorkflowMockInput, generateDefaultTaskOutputPreview, } from './utils/localSandboxEngine';
 export type { SandboxDryRunOptions, TaskMockOverride, } from './utils/localSandboxEngine';
+export { WorkflowIdeProvider, useIdeProviders } from './providers/WorkflowIdeProvider';
+export type { WorkflowIdeProviderProps } from './providers/WorkflowIdeProvider';
+export { resolveProviders, stabilizeProviders } from './providers/resolve';
+export type { ProviderSources } from './providers/resolve';
+export type { IdeProviders, OnboardingProvider, OnboardingContext, ProductInfo, StartTrialResult, PromotionStatus, } from './providers/types';
+export { WorkflowNameBuilder, OnboardingWizard, PromotionPanel, OnboardingGuideCard } from './components/onboarding';
+export type { WorkflowNameBuilderProps, OnboardingWizardProps, OnboardingCreateResult, PromotionPanelProps, OnboardingGuideCardProps, } from './components/onboarding';
+export { buildWorkflowName, validateNameParts, suggestFuncSlug, promotionTargetName, isPromotableName, buildSkeletonWorkflow, nextPollDelay, isTerminalPromotionState, buildPromotionTimeline, promotionStateLabel, pollPromotion, } from './onboarding';
+export type { WorkflowNameParts, PromotionTargetType, SkeletonInput, TimelineItem, PromotionState, StartSource } from './onboarding';
+export { createTelemetryBuffer } from './telemetry/buffer';
+export type { TelemetryBuffer, TelemetryBufferOptions } from './telemetry/buffer';
+export type { TelemetrySink, IdeEvent, IdeEventName } from './telemetry/types';
+export { detectFormat, parseApiText, parseOpenApi3, parseSwagger2, parsePostman21, parseCurl, buildHttpAction, appendImportedActions, sanitizeHeaders, } from './import';
+export type { ImportFormat, DetectedFormat, ImportedOperation, ImportedParam, ImportedBody, ParseResult, BuildHttpActionOptions, } from './import';
+export { ApiImportDialog } from './components/import/ApiImportDialog';
+export type { ApiImportDialogProps, ApiImportInsertInfo } from './components/import/ApiImportDialog';

package/dist/components/AiNative/AiCommandCenter.d.ts

@@ -12,6 +12,10 @@ import type { AiEvent } from '../../types/aiEvents';
 interface AiCommandCenterProps {
     systemPrompt?: string;
     systemPromptExtra?: string;
+    /** 流程库目录注入提示词的条数上限（缺省 50） */
+    promptCatalogLimit?: number;
+    /** 任务 Schema 注入提示词的条数上限（缺省不限制） */
+    promptSchemaLimit?: number;
     showConfigButton?: boolean;
     onShowConfig: () => void;
     executionActions?: ExecutionActions;

package/dist/components/business/ActionPickerModal.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+import type { WorkflowLevel } from '../../types/workflowLibrary';
+import type { LibraryCatalog } from '../../library/catalog';
+export interface ActionPickerModalProps {
+    registry: ActionRegistry;
+    /** 展示用的步骤序号（从 1 开始） */
+    stepNumber: number;
+    onClose: () => void;
+    onSelect: (action: ActionDefinition) => void;
+    /**
+     * 当前正在编辑的工作流层级。提供时隐藏违反分层调用规则的流程库动作
+     * （L1 不显示 L2/L3，L2 不显示 L3）；未提供则不按层级过滤。
+     */
+    currentWorkflowLevel?: WorkflowLevel;
+    /** 流程库目录：用于显示「加载中 / 加载失败，点击重试」状态 */
+    libraryCatalog?: LibraryCatalog;
+}
+/**
+ * 业务动作选择弹窗：分类筛选 + 关键字搜索。
+ * 筛选状态与过滤计算都放在弹窗内部：仅在弹窗打开时才会随输入重新计算，
+ * 不再拖累编辑器每次渲染（动作库可能有成百上千项）。
+ */
+export declare const ActionPickerModal: React.FC<ActionPickerModalProps>;

package/dist/components/business/DataPillInput.d.ts

@@ -10,5 +10,7 @@ export interface DataPillInputProps {
     registry?: ActionRegistry;
     workflowInputParams?: any[];
     disabled?: boolean;
+    /** 初始即展开「插入数据」选择面板（例如下拉字段刚切换为动态取值时） */
+    defaultShowPicker?: boolean;
 }
 export declare const DataPillInput: React.FC<DataPillInputProps>;

package/dist/components/business/DecisionBranchCard.d.ts

@@ -9,5 +9,7 @@ export interface DecisionBranchCardProps {
     disabled?: boolean;
     onChange: (updated: BusinessStep) => void;
     onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
+    depth?: number;
 }
 export declare const DecisionBranchCard: React.FC<DecisionBranchCardProps>;

package/dist/components/business/ForkJoinCard.d.ts

@@ -9,5 +9,7 @@ export interface ForkJoinCardProps {
     disabled?: boolean;
     onChange: (updated: BusinessStep) => void;
     onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
+    depth?: number;
 }
 export declare const ForkJoinCard: React.FC<ForkJoinCardProps>;

package/dist/components/business/LibraryVersionBadge.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import type { ActionDefinition } from '../../actions/types';
+import type { LibraryCatalog } from '../../library/catalog';
+import { type WorkflowVersionDiff } from '../../library/diff';
+export interface LibraryVersionBadgeProps {
+    step: BusinessStep;
+    action?: ActionDefinition;
+    disabled?: boolean;
+    /**
+     * 流程库目录。提供后：
+     * - 升级前取旧、新两个版本的定义，展示入参 / 出参差异再确认
+     * - 固定版本在库中不存在 / 已下线时显示「⚠ 版本不可用」
+     * 未提供时沿用旧行为（只按动作上记录的最新版本提示升级）。
+     */
+    catalog?: LibraryCatalog;
+    /** 其它步骤中引用了本步骤哪些出参 key（用于差异里的「下游引用将失效」提示） */
+    getReferencedOutputs?: () => Iterable<string>;
+    /** 用户确认升级后回调：库中最新版本号，以及（能取到两个版本定义时的）升级差异 */
+    onUpgrade: (latestVersion: number, diff?: WorkflowVersionDiff) => void;
+}
+/**
+ * 流程库能力的版本标记：
+ * - 显示步骤引用时固定的版本（库升级后不会自动跟随）
+ * - 库中有更新版本时，提示并允许用户在看过升级差异后手动升级
+ * - 固定版本不可用（不存在 / 已下线）时给出警示，保持原样编译，不自动改版本
+ * - 目录加载失败时不显示新版本提示，不影响编辑与编译
+ */
+export declare const LibraryVersionBadge: React.FC<LibraryVersionBadgeProps>;

package/dist/components/business/LoopDoWhileCard.d.ts

@@ -9,5 +9,7 @@ export interface LoopDoWhileCardProps {
     disabled?: boolean;
     onChange: (updated: BusinessStep) => void;
     onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
+    depth?: number;
 }
 export declare const LoopDoWhileCard: React.FC<LoopDoWhileCardProps>;

package/dist/components/business/NestedControlStep.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+export interface NestedControlStepProps {
+    step: BusinessStep;
+    index: number;
+    /** 当前嵌套层级（顶层卡片内的第一层子控制流为 1），用于缩进与视觉区分 */
+    depth?: number;
+    upstreamSteps: BusinessStep[];
+    registry?: ActionRegistry;
+    disabled?: boolean;
+    onChange: (updated: BusinessStep) => void;
+    onDelete: () => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+}
+/**
+ * 分支 / 并行泳道 / 循环体内部的"子控制流"渲染器。
+ * 通过它，DecisionBranchCard / ForkJoinCard / LoopDoWhileCard 可以互相递归嵌套，
+ * 支持例如「分支 A 内再包含一个分支」「泳道内再有并行或循环」等任意层级。
+ */
+export declare const NestedControlStep: React.FC<NestedControlStepProps>;

package/dist/components/business/StepFlowEditor.d.ts

@@ -1,11 +1,26 @@
 import React from 'react';
 import type { WorkflowDef, WorkflowInstance } from '../../types/conductor';
+import type { BusinessStep } from '../../stepmodel/types';
 import { ActionRegistry } from '../../actions/registry';
+import type { LibraryCatalog } from '../../library/catalog';
+import type { WorkflowLevel } from '../../types/workflowLibrary';
 export interface StepFlowEditorProps {
     workflowDef: WorkflowDef | null;
     onChange: (def: WorkflowDef) => void;
     registry?: ActionRegistry;
     readOnly?: boolean;
     workflowExecution?: WorkflowInstance;
+    /** 流程库目录（由 WorkflowIDE 按 libraryProvider 创建）：用于动作选择器状态与版本徽标 */
+    libraryCatalog?: LibraryCatalog;
+    /** 当前正在编辑的工作流层级：提供时选择器隐藏违反分层调用规则的流程库动作 */
+    currentWorkflowLevel?: WorkflowLevel;
+    /** 提供时，步骤头部显示「🤖」按钮，点击请 AI 介绍该步骤（AI IDE 中使用） */
+    onAskAi?: (step: BusinessStep) => void;
+    /** 通过动作选择器新增步骤后回调（埋点用）：source = library（流程库能力）/ builtin（内置或宿主动作） */
+    onStepAdded?: (info: {
+        source: 'library' | 'builtin';
+    }) => void;
+    /** 本地沙箱试跑结束后回调（埋点用）：result 为执行状态，或 'error'（试跑抛错） */
+    onSandboxRun?: (result: string) => void;
 }
 export declare const StepFlowEditor: React.FC<StepFlowEditorProps>;

package/dist/components/business/StepListEditor.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+export interface StepListEditorProps {
+    steps: BusinessStep[];
+    onStepsChange: (next: BusinessStep[]) => void;
+    /** 本列表之前的所有上游步骤（用于参数胶囊联想）；列表内前序步骤会自动追加 */
+    upstreamSteps: BusinessStep[];
+    registry?: ActionRegistry;
+    disabled?: boolean;
+    /** 本列表所在容器的嵌套深度（顶层容器为 0） */
+    depth: number;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** regular：分支 / 循环体内的宽松行；compact：并行泳道内的窄列行 */
+    variant?: 'regular' | 'compact';
+    /** 行背景色调；展开区域使用相反色调，保持层次 */
+    rowTone?: 'primary' | 'secondary';
+    /** 序号徽标前缀，如「轮内 」 */
+    indexPrefix?: string;
+    /** 序号徽标是否使用强调色（默认为中性底色） */
+    accentIndexBadge?: boolean;
+}
+/**
+ * 分支 / 并行泳道 / 循环体共用的"子步骤列表"：
+ * - 普通动作渲染为可展开的表单行
+ * - 控制流步骤（分支 / 并行 / 循环）交给 NestedControlStep 递归渲染，因此可任意层级嵌套
+ */
+export declare const StepListEditor: React.FC<StepListEditorProps>;

package/dist/components/import/ApiImportDialog.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { ActionDefinition } from '../../actions/types';
+import type { ImportFormat } from '../../import/types';
+export interface ApiImportInsertInfo {
+    format: ImportFormat;
+    /** 本次插入的步骤数 */
+    count: number;
+    /** 解析时产生的提示（敏感头替换、不支持的部分等） */
+    warnings: string[];
+}
+export interface ApiImportDialogProps {
+    open: boolean;
+    onClose: () => void;
+    /**
+     * 确认插入：actions 为所选接口生成的 HTTP 业务动作（按文档顺序）。
+     * 调用方负责把动作注册到动作库并把步骤追加到流程（可用 `appendImportedActions`）；
+     * 对话框在回调返回后自动关闭。B2 向导的「从接口导入」可直接复用本组件。
+     */
+    onInsert: (actions: ActionDefinition[], info: ApiImportInsertInfo) => void;
+    /** 已存在的动作 id，用于避免重复导入时 id 冲突 */
+    existingActionIds?: Iterable<string>;
+}
+/**
+ * 接口导入对话框：粘贴或上传 -> 识别格式 -> 勾选接口 -> 插入为步骤。
+ * 外层仅在打开时挂载内容，因此每次打开都是干净状态。
+ */
+export declare const ApiImportDialog: React.FC<ApiImportDialogProps>;

package/dist/components/onboarding/ModalShell.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from 'react';
+export interface ModalShellProps {
+    /** 用于 aria-labelledby 的标题元素 id */
+    titleId: string;
+    title: string;
+    onClose: () => void;
+    children: ReactNode;
+    footer?: ReactNode;
+    width?: number;
+}
+/**
+ * 自助接入弹窗外壳：Portal 渲染到 body，并带上 data-mode / data-brand 使主题变量生效。
+ * 无障碍：role="dialog" + aria-modal + 标题关联；Esc 关闭；Tab 在弹窗内循环；关闭后焦点回到打开前的元素。
+ */
+export declare function ModalShell({ titleId, title, onClose, children, footer, width }: ModalShellProps): import("react").ReactPortal | null;

package/dist/components/onboarding/OnboardingController.d.ts

@@ -0,0 +1,67 @@
+import type { OnboardingProvider, ProductInfo } from '../../providers/types';
+import type { WorkflowLevel } from '../../types/workflowLibrary';
+import type { IdeEventName } from '../../telemetry/types';
+import type { OnboardingCreateResult } from './OnboardingWizard';
+import type { OnboardingData } from './useOnboardingData';
+/** 向导创建骨架后、选择了模板 / 导入时暂存的流程身份，供宿主在后续步骤里保留名称 */
+export interface PendingIdentity {
+    name: string;
+    description: string;
+    ownerEmail?: string;
+}
+export interface OnboardingControllerOptions {
+    /** 解析后的 providers.onboarding；不存在时一切入口都不出现 */
+    provider: OnboardingProvider | undefined;
+    /** useTelemetry 返回的 track */
+    track: (name: IdeEventName, props?: Record<string, unknown>) => void;
+    /** 只读 / 运行态时隐藏入口 */
+    disabled?: boolean;
+    /** 向导「模板中心」起点的回调；不提供则隐藏该选项 */
+    onPickTemplate?: () => void;
+    /** 向导「从接口导入」起点的回调；不提供则隐藏该选项 */
+    onImportApi?: () => void;
+    ownerEmail?: string;
+}
+export interface OnboardingController {
+    enabled: boolean;
+    data: OnboardingData;
+    /** 向导选择的层级；宿主没有传 currentWorkflowLevel 时作为默认值 */
+    level: WorkflowLevel | undefined;
+    wizardOpen: boolean;
+    promoOpen: boolean;
+    openWizard: () => void;
+    openPromotion: () => void;
+    /** 当前流程是否可申请上线（名称可解析且类型为 tmp） */
+    canPromote: boolean;
+    /** 是否显示空画布的「开始试用」引导 */
+    showGuide: boolean;
+    dismissGuide: () => void;
+    /** 取走并清空暂存的流程身份（选了模板 / 导入后使用） */
+    takePendingIdentity: () => PendingIdentity | null;
+    provider: OnboardingProvider | undefined;
+    /** 以下供 OnboardingOverlays 使用 */
+    close: () => void;
+    handleCreate: (r: OnboardingCreateResult) => void;
+    handleTrialStarted: (p: ProductInfo) => void;
+    onPickTemplate?: () => void;
+    onImportApi?: () => void;
+    ownerEmail?: string;
+    track: OnboardingControllerOptions['track'];
+}
+/**
+ * IDE 内部使用：把自助接入的状态与动作集中在一处，IDE 只需渲染
+ * `<OnboardingToolbarButtons>`、`<OnboardingOverlays>` 与（可选）引导卡片。
+ */
+export declare function useOnboardingController(opts: OnboardingControllerOptions): OnboardingController;
+/** 工具栏入口：「新建流程」与「申请上线」。没有 onboarding provider 时不渲染任何内容 */
+export declare function OnboardingToolbarButtons({ c }: {
+    c: OnboardingController;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** 弹窗：向导与申请上线面板（Portal 渲染，自带主题属性） */
+export declare function OnboardingOverlays({ c }: {
+    c: OnboardingController;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** 空画布引导：覆盖整个 IDE 的半透明层（不拦截点击），卡片居中；仅 `c.showGuide` 时渲染 */
+export declare function OnboardingGuideOverlay({ c }: {
+    c: OnboardingController;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/onboarding/OnboardingGuideCard.d.ts

@@ -0,0 +1,10 @@
+export interface OnboardingGuideCardProps {
+    onStart: () => void;
+    /** 提供时显示「暂不使用」，用于露出画布原有的空状态 */
+    onDismiss?: () => void;
+}
+/**
+ * 空画布上的「开始试用」引导卡片。
+ * 仅在测试环境开放自助试用且用户还没有所属产品时由宿主显示。
+ */
+export declare function OnboardingGuideCard({ onStart, onDismiss }: OnboardingGuideCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/onboarding/OnboardingWizard.d.ts

@@ -0,0 +1,42 @@
+import type { OnboardingProvider, ProductInfo } from '../../providers/types';
+import type { WorkflowDef } from '../../types/conductor';
+import type { WorkflowLevel } from '../../types/workflowLibrary';
+import type { StartSource } from '../../onboarding/wizardState';
+export interface OnboardingCreateResult {
+    /** 向导生成的骨架定义（名称已按规范拼好） */
+    def: WorkflowDef;
+    /** 所选层级，宿主可据此设置 `currentWorkflowLevel` */
+    level: WorkflowLevel;
+    /** 起点：空白 / 模板中心 / 从接口导入 */
+    source: StartSource;
+}
+export interface OnboardingWizardProps {
+    /** 只用到 startTrial；传完整的 OnboardingProvider 即可 */
+    provider: Pick<OnboardingProvider, 'startTrial'>;
+    /** 当前环境是否开放自助试用（决定能否登记新产品、类型是否固定 tmp） */
+    trialEnabled: boolean;
+    /** 我的产品 */
+    products: ProductInfo[];
+    /** 业务域列表 */
+    domains: string[];
+    /** 默认层级，默认 L2 */
+    defaultLevel?: WorkflowLevel;
+    /** 写入骨架定义的负责人邮箱 */
+    ownerEmail?: string;
+    onClose: () => void;
+    /** 完成：交给宿主把骨架设为当前流程 */
+    onCreate: (result: OnboardingCreateResult) => void;
+    /** 新产品登记成功（宿主可刷新「我的产品」、上报 trial_started） */
+    onTrialStarted?: (product: ProductInfo) => void;
+    /** 选择「从模板中心开始」：创建骨架后调用，宿主打开模板中心；不提供则隐藏该选项 */
+    onPickTemplate?: () => void;
+    /** 选择「从接口导入」：创建骨架后调用，宿主打开导入面板；不提供则隐藏该选项 */
+    onImportApi?: () => void;
+}
+/**
+ * 自助接入向导（3 步弹窗）：产品 → 命名 → 起点。
+ * - 试用环境可登记新产品（startTrial）；产品被他人占用时提示联系负责人；
+ * - 接口失败停在当前步，显示「重试」，已填内容保留；
+ * - 完成后用 `onCreate({ def, level, source })` 交给宿主设置当前流程。
+ */
+export declare function OnboardingWizard({ provider, trialEnabled, products, domains, defaultLevel, ownerEmail, onClose, onCreate, onTrialStarted, onPickTemplate, onImportApi, }: OnboardingWizardProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/onboarding/PromotionPanel.d.ts

@@ -0,0 +1,20 @@
+import type { OnboardingProvider, PromotionStatus } from '../../providers/types';
+import type { PromotionTargetType } from '../../onboarding/naming';
+export interface PromotionPanelProps {
+    /** 用到 requestPromotion / getPromotion */
+    provider: Pick<OnboardingProvider, 'requestPromotion' | 'getPromotion'>;
+    /** 当前（tmp 类型的）流程名称 */
+    workflowName: string;
+    /** 当前流程版本 */
+    version: number;
+    onClose: () => void;
+    /** 提交成功（埋点：promotion_requested） */
+    onRequested?: (targetType: PromotionTargetType) => void;
+    /** 状态变化（埋点：promotion_state），同一状态只回调一次 */
+    onStateChange?: (state: PromotionStatus['state']) => void;
+}
+/**
+ * 申请上线面板：选择目标类型 → 预览正式名称 → 提交 → 轮询进度（指数退避，30 秒封顶）。
+ * 轮询在关闭面板 / 卸载时中止。
+ */
+export declare function PromotionPanel({ provider, workflowName, version, onClose, onRequested, onStateChange }: PromotionPanelProps): import("react/jsx-runtime").JSX.Element;