@yiyi_zhang/reactflow-ui 1.2.0 → 1.3.1

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

@@ -2,6 +2,7 @@ import React from 'react';
 import type { BusinessStep } from '../../stepmodel/types';
 import { ActionRegistry } from '../../actions/registry';
 import type { ActionDefinition } from '../../actions/types';
+import { type InsertPickerInfo } from './BusinessEditorContext';
 export interface StepListEditorProps {
     steps: BusinessStep[];
     onStepsChange: (next: BusinessStep[]) => void;
@@ -11,7 +12,7 @@ export interface StepListEditorProps {
     disabled?: boolean;
     /** 本列表所在容器的嵌套深度（顶层容器为 0） */
     depth: number;
-    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void, info?: InsertPickerInfo) => void;
     /** regular：分支 / 循环体内的宽松行；compact：并行泳道内的窄列行 */
     variant?: 'regular' | 'compact';
     /** 行背景色调；展开区域使用相反色调，保持层次 */
@@ -20,10 +21,13 @@ export interface StepListEditorProps {
     indexPrefix?: string;
     /** 序号徽标是否使用强调色（默认为中性底色） */
     accentIndexBadge?: boolean;
+    /** 动作选择器标题中的位置说明前缀，如"分支 VIP" */
+    insertLabel?: string;
 }
 /**
  * 分支 / 并行泳道 / 循环体共用的"子步骤列表"：
- * - 普通动作渲染为可展开的表单行
+ * - 普通动作渲染为可展开的表单行，头部与顶层卡片相同（改名、排序、版本徽标、敏感标记、校验与试跑状态）
+ * - 步骤之间可插入新步骤
  * - 控制流步骤（分支 / 并行 / 循环）交给 NestedControlStep 递归渲染，因此可任意层级嵌套
  */
 export declare const StepListEditor: React.FC<StepListEditorProps>;

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

@@ -0,0 +1,6 @@
+import type { BusinessStep } from '../../stepmodel/types';
+import type { ActionRegistry } from '../../actions/registry';
+/** 统计控制流内部（任意层级）的步骤数 */
+export declare function countNestedSteps(step: BusinessStep): number;
+/** 删除步骤前的确认文案：说清删的是什么、连带删除多少内部步骤、如何恢复 */
+export declare function confirmDeleteMessage(step: BusinessStep, registry: ActionRegistry): string;

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

@@ -0,0 +1,11 @@
+/**
+ * 试跑 / 运行状态 → 业务卡片徽标（CMASTER 规则 5：颜色 + 图标 + 中文词，不能只靠颜色）。
+ * icon 为 lucide 图标名，由组件映射为具体图标。
+ */
+export interface RunStatusBadge {
+    label: string;
+    /** 颜色 token（var(--cm-status-*)） */
+    color: string;
+    icon: 'check' | 'x' | 'timer' | 'skip' | 'loader' | 'circle' | 'ban' | 'alert';
+}
+export declare function runStatusBadge(status: string | undefined | null): RunStatusBadge;

package/dist/components/icons/CmIcon.d.ts

@@ -0,0 +1,17 @@
+import type { CSSProperties } from 'react';
+import { CM_ICONS } from './iconRegistry';
+interface CmIconProps {
+    /** Icon name from CM_ICONS (preferred) or a legacy emoji from host data. */
+    name: string | undefined | null;
+    size?: number;
+    /** Name to use when `name` is empty or unknown. */
+    fallback?: keyof typeof CM_ICONS;
+    style?: CSSProperties;
+    className?: string;
+}
+/**
+ * Renders a CMASTER data icon as a Lucide icon (stroke 1.75). Unknown non-empty values fall back to `fallback`,
+ * so host-supplied emoji or typos never reach the UI as raw glyphs.
+ */
+export declare function CmIcon({ name, size, fallback, style, className }: CmIconProps): import("react/jsx-runtime").JSX.Element;
+export default CmIcon;

package/dist/components/icons/iconRegistry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * CMASTER icon names → Lucide icons. Data (actions, templates, task types, library extensions) stores an icon as one
+ * of these kebab-case names, never as an emoji (design/guidelines/brand.md · 图标).
+ */
+export declare const CM_ICONS: {
+    activity: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    alert: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    book: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    flag: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    flame: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    library: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    lightbulb: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    lock: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    map: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    pause: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    undo: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    wrench: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    approval: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    clipboard: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    mail: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    pointer: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    x: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    ban: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    bell: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    'bell-ring': import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    braces: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    chart: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    circle: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    clock: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    cloud: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    code: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    database: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    'file-text': import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    folder: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    branch: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    merge: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    globe: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    'hard-drive': import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    hourglass: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    key: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    megaphone: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    message: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    monitor: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    moon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    package: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    pencil: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    play: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    plug: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    puzzle: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    radio: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    refresh: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    repeat: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    rocket: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    save: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    scale: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    search: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    send: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    server: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    settings: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    shield: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    shuffle: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    smartphone: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    sparkles: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    stop: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    'stop-circle': import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    sunrise: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    terminal: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    trash: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    upload: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    user: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    zap: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+};
+export type CmIconName = keyof typeof CM_ICONS;
+/**
+ * Legacy emoji → icon name. Older hosts and the governance service may still send emoji as `icon`; they render as the
+ * matching Lucide icon instead. Keys are compared after stripping the emoji variation selector (U+FE0F).
+ */
+export declare const EMOJI_ALIASES: Record<string, CmIconName>;
+/** Resolves an icon value (icon name or legacy emoji) to a registered icon name; null when unknown. */
+export declare function resolveIconName(icon: string | undefined | null): CmIconName | null;

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,74 @@
+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 { PendingPromotion } from './PromotionPanel';
+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;
+    /** 「新建流程」会替换画布上的流程，正在请用户确认 */
+    confirmReplace: boolean;
+    resolveConfirmReplace: (proceed: boolean) => void;
+    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'];
+    /** 已提交、未到终态的上线申请（按流程名称与版本） */
+    getPendingPromotion: (name: string, version: number) => PendingPromotion | null;
+    setPendingPromotion: (name: string, version: number, request: PendingPromotion | null) => void;
+}
+/**
+ * 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,28 @@
+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;
+    /** 关闭前已提交、尚未到终态的申请：重新打开时接着轮询，不会重复提交（R12） */
+    resumeRequest?: PendingPromotion | null;
+    /** 提交成功时传入申请；到达终态（SYNCED / REJECTED）时传 null。宿主据此保存 / 清除 resumeRequest */
+    onRequestChange?: (request: PendingPromotion | null) => void;
+}
+export interface PendingPromotion {
+    requestId: string;
+    targetType: PromotionTargetType;
+}
+/**
+ * 申请上线面板：选择目标类型 → 预览正式名称 → 提交 → 轮询进度（指数退避，30 秒封顶）。
+ * 轮询在关闭面板 / 卸载时中止。
+ */
+export declare function PromotionPanel({ provider, workflowName, version, onClose, onRequested, onStateChange, resumeRequest, onRequestChange }: PromotionPanelProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,19 @@
+import type { ProductInfo } from '../../providers/types';
+import type { WorkflowNameParts } from '../../onboarding/naming';
+export interface WorkflowNameBuilderProps {
+    /** 可选的所属产品（我的产品）；业务域取自所选产品 */
+    products: ProductInfo[];
+    /** 允许的业务域列表；提供时参与校验 */
+    domains?: string[];
+    /** 试用环境：类型固定为 tmp；否则可选 custom / std */
+    trial: boolean;
+    value: WorkflowNameParts;
+    onChange: (next: WorkflowNameParts) => void;
+    disabled?: boolean;
+}
+/**
+ * 五段式命名生成器：`类型-层级-业务域-产品-功能`。
+ * 受控组件：类型（试用固定 tmp）、层级、产品（下拉我的产品，业务域随产品带出）、功能（自由输入，推荐 snake_case），
+ * 实时预览完整名称并用 `validateWorkflowName` 校验。
+ */
+export declare function WorkflowNameBuilder({ products, domains, trial, value, onChange, disabled }: WorkflowNameBuilderProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,8 @@
+export { WorkflowNameBuilder } from './WorkflowNameBuilder';
+export type { WorkflowNameBuilderProps } from './WorkflowNameBuilder';
+export { OnboardingWizard } from './OnboardingWizard';
+export type { OnboardingWizardProps, OnboardingCreateResult } from './OnboardingWizard';
+export { PromotionPanel } from './PromotionPanel';
+export type { PromotionPanelProps } from './PromotionPanel';
+export { OnboardingGuideCard } from './OnboardingGuideCard';
+export type { OnboardingGuideCardProps } from './OnboardingGuideCard';

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

@@ -0,0 +1,11 @@
+import type { CSSProperties } from 'react';
+/** 自助接入组件共用的内联样式：只使用主题 CSS 变量，弹窗根节点另行设置 data-mode / data-brand */
+export declare const labelStyle: CSSProperties;
+export declare const inputStyle: CSSProperties;
+export declare const hintStyle: CSSProperties;
+export declare const errorStyle: CSSProperties;
+export declare const buttonBase: CSSProperties;
+export declare const primaryButton: CSSProperties;
+export declare const ghostButton: CSSProperties;
+export declare function disabledStyle(base: CSSProperties, disabled: boolean): CSSProperties;
+export declare const noticeStyle: (kind: "error" | "warning" | "success") => CSSProperties;

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

@@ -0,0 +1,17 @@
+import type { OnboardingContext, OnboardingProvider, ProductInfo } from '../../providers/types';
+export interface OnboardingData {
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    context: OnboardingContext | null;
+    domains: string[];
+    products: ProductInfo[];
+    error: string | null;
+    /** 重新加载（失败后重试） */
+    reload: () => void;
+    /** 新登记产品后本地追加，避免再请求一次 */
+    addProduct: (p: ProductInfo) => void;
+}
+/**
+ * 按 provider 实例加载一次：上下文、业务域、我的产品。
+ * provider 引用变化时重新加载；卸载或切换时中止进行中的请求。没有 provider 时保持 idle。
+ */
+export declare function useOnboardingData(provider: OnboardingProvider | undefined): OnboardingData;

package/dist/components/template/TemplateGallery.d.ts

@@ -6,5 +6,7 @@ export interface TemplateGalleryProps {
     onClose: () => void;
     onSelectTemplate: (configuredDef: WorkflowDef) => void;
     templateStore?: TemplateStore;
+    /** 试跑结束（快捷试跑或向导内试跑）：参数为最终状态或 'error'，用于接入埋点，不含数据 */
+    onSandboxRun?: (result: string) => void;
 }
 export declare const TemplateGallery: React.FC<TemplateGalleryProps>;

package/dist/components/template/TemplateSetupWizard.d.ts

@@ -5,5 +5,7 @@ export interface TemplateSetupWizardProps {
     template: WorkflowTemplate;
     onApply: (configuredDef: WorkflowDef) => void;
     onClose: () => void;
+    /** 向导内试跑结束：最终状态或 'error'（埋点用，不含数据） */
+    onSandboxRun?: (result: string) => void;
 }
 export declare const TemplateSetupWizard: React.FC<TemplateSetupWizardProps>;

package/dist/hooks/useConfirm.d.ts

@@ -1,12 +1,14 @@
 interface ConfirmState {
     message: string;
+    /** 确认按钮文案（动词开头，如"删除"）；缺省为"确定" */
+    confirmLabel?: string;
     resolve: (value: boolean) => void;
 }
 /**
  * 提供 Promise-based confirm 对话框替代 window.confirm
  */
 export declare const useConfirm: () => {
-    confirm: (message: string) => Promise<boolean>;
+    confirm: (message: string, confirmLabel?: string) => Promise<boolean>;
     confirmState: ConfirmState | null;
     handleConfirm: () => void;
     handleCancel: () => void;

package/dist/import/buildAction.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ImportedOperation → 业务动作（ActionDefinition）。
+ *
+ * - 字段：路径参数 / 查询参数 / 请求头参数 / 请求体属性，沿用 `buildFields` 规则（title → 标签、enum → 下拉、
+ *   类型 → 控件），全部支持插入数据胶囊；
+ * - 出参：2xx 响应 schema，沿用 `buildOutputs`，键为 Conductor HTTP 任务的真实输出路径
+ *   `response.body.<字段>`，因此数据胶囊引用 `${ref.output.response.body.xxx}` 运行时可直接取到；
+ * - 编译：Conductor `HTTP` 任务，`inputParameters` 里保留 `_actionId` 与各字段值，
+ *   使步骤重新打开时能被 `decompile` 还原为同一动作（动作未注册时退回「专业步骤」卡片，定义无损）。
+ */
+import type { ActionDefinition } from '../actions/types';
+import type { ImportedOperation } from './types';
+export interface BuildHttpActionOptions {
+    /** 已存在的动作 id（完整 id，如 `import.get_tickets`）：冲突时自动追加 `_2` 等后缀 */
+    existingIds?: Iterable<string>;
+    /** 动作 id 前缀，默认 `import` */
+    idPrefix?: string;
+}
+/**
+ * 由导入的接口生成 HTTP 业务动作。
+ * 固定请求头会再做一次敏感值检查（解析器已处理时这里是空操作），保证动作定义里不会出现凭据。
+ */
+export declare function buildHttpAction(op: ImportedOperation, opts?: BuildHttpActionOptions): ActionDefinition;

package/dist/import/common.d.ts

@@ -0,0 +1,23 @@
+/** 各格式解析器共用的收尾逻辑（纯函数）。 */
+import type { ImportedOperation } from './types';
+import type { ImportedParam } from './types';
+/** 收尾：替换固定请求头里的敏感值，并把提示并入接口的 warnings */
+export declare function finishOperation(op: ImportedOperation): ImportedOperation;
+/** 接口的展示标识：`GET /tickets/{id}` */
+export declare function operationLabel(op: Pick<ImportedOperation, 'method' | 'path'>): string;
+/** 汇总所有接口的提示（带接口前缀，去重） */
+export declare function collectWarnings(ops: ImportedOperation[], extra?: string[]): string[];
+/**
+ * 把 JSON 示例的顶层属性作为默认值写入 schema；敏感字段（任意层级，R7）的默认值换成占位。
+ * 嵌套字段的占位名取路径（`credentials.password` → `${workflow.input.credentialsPassword}`）；
+ * 敏感名下面的所有标量值都视为敏感（如 `credentials: { user, pass }`）。
+ */
+export declare function schemaWithDefaults(example: unknown, warnings: string[]): Record<string, any>;
+/** 递归替换敏感值；返回新值，不修改入参 */
+export declare function redactSensitive(value: unknown, path: string[], underSensitive: boolean, warnings: string[]): unknown;
+/** 把查询串解析为 query 参数（字面量作为默认值；敏感参数名的值替换为占位） */
+export declare function queryParamsFromString(query: string, warnings: string[]): ImportedParam[];
+/** Content-Type / Accept 由 body.contentType 与 accept 统一输出，不再作为固定头 */
+export declare function dropContentHeaders(headers: Record<string, string>): Record<string, string>;
+/** 不区分大小写取请求头的值 */
+export declare function findHeader(headers: Record<string, string>, name: string): string | undefined;

package/dist/import/curl.d.ts

@@ -0,0 +1,12 @@
+/**
+ * curl 命令 → ImportedOperation[]（恒为 0 或 1 个接口）。
+ * 支持：-X、-H（多个）、-d / --data / --data-raw / --data-binary、-u、--url、-G、行尾 `\` 续行、
+ * 单引号 / 双引号 / `$'…'`（浏览器「复制为 cURL」）。不执行任何命令。
+ */
+import type { ParseResult } from './types';
+/** 把命令行切成 token（兼容续行与常见引号写法） */
+export declare function tokenizeCurl(input: string): string[];
+/** 提示用的 curl 示例（对话框 placeholder 使用） */
+export declare const CURL_SAMPLE = "curl -X POST 'https://api.example.com/v1/tickets' \\\n  -H 'Content-Type: application/json' \\\n  -H 'Authorization: Bearer <token>' \\\n  -d '{\"title\":\"\u78C1\u76D8\u544A\u8B66\",\"priority\":\"high\"}'";
+/** 解析一条 curl 命令 */
+export declare function parseCurl(command: string): ParseResult;

package/dist/import/detect.d.ts

@@ -0,0 +1,9 @@
+/** 输入格式识别与统一入口（纯函数，不抛异常）。 */
+import type { DetectedFormat, ParseResult } from './types';
+/** 识别输入文本的格式 */
+export declare function detectFormat(text: string): DetectedFormat;
+/**
+ * 识别并解析：返回 ParseResult，永不抛异常。
+ * YAML 不受支持，返回固定提示 {@link YAML_HINT}。
+ */
+export declare function parseApiText(text: string): ParseResult;

package/dist/import/index.d.ts

@@ -0,0 +1,10 @@
+export * from './types';
+export { detectFormat, parseApiText } from './detect';
+export { parseOpenApi3, parseSwagger2 } from './openapi';
+export { parsePostman21 } from './postman';
+export { parseCurl, tokenizeCurl, CURL_SAMPLE } from './curl';
+export { buildHttpAction } from './buildAction';
+export type { BuildHttpActionOptions } from './buildAction';
+export { appendImportedActions, blankImportWorkflow, collectWorkflowInputRefs } from './insert';
+export { resolveSchema } from './schema';
+export { isSensitiveHeader, sanitizeHeaders, inputPlaceholder } from './sensitive';

package/dist/import/insert.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 把导入生成的动作作为步骤追加到流程末尾（纯函数，业务模式与专业模式共用）。
+ * B2 向导的「从接口导入」也可直接复用。
+ */
+import type { ActionDefinition } from '../actions/types';
+import type { TaskDef, WorkflowDef } from '../types/conductor';
+/** 没有当前流程时使用的空白骨架 */
+export declare function blankImportWorkflow(name?: string): WorkflowDef;
+/** 取出任务里引用的 `${workflow.input.xxx}` 的顶层入参名 */
+export declare function collectWorkflowInputRefs(tasks: TaskDef[]): string[];
+/**
+ * 为每个动作按默认值生成一个步骤并追加到 `def.tasks` 末尾；
+ * 步骤引用的 `${workflow.input.xxx}`（敏感头占位、路径参数默认值等）会补进流程的入参声明。
+ * 不修改入参，返回新的定义。
+ */
+export declare function appendImportedActions(def: WorkflowDef | null | undefined, actions: ActionDefinition[]): WorkflowDef;

package/dist/import/openapi.d.ts

@@ -0,0 +1,9 @@
+/**
+ * OpenAPI 3.x / Swagger 2.0（JSON 文档对象）→ ImportedOperation[]。
+ * 只做解析，不发请求；解析失败返回 { ok: false }，不抛异常。
+ */
+import type { ParseResult } from './types';
+/** 解析 OpenAPI 3.x 文档对象 */
+export declare function parseOpenApi3(doc: unknown): ParseResult;
+/** 解析 Swagger 2.0 文档对象 */
+export declare function parseSwagger2(doc: unknown): ParseResult;

package/dist/import/postman.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Postman Collection v2.1（JSON 文档对象）→ ImportedOperation[]。
+ * Postman 变量 `{{var}}` 转为 `${workflow.input.var}`；认证配置只生成占位，不读取凭据值。
+ */
+import type { ParseResult } from './types';
+/** `{{var}}` → `${workflow.input.var}`；记录用到的变量名 */
+export declare function convertPostmanVars(text: string, used?: Set<string>): string;
+/** 解析 Postman Collection v2.1 文档对象 */
+export declare function parsePostman21(doc: unknown): ParseResult;

package/dist/import/schema.d.ts

@@ -0,0 +1,15 @@
+/**
+ * JSON Schema 本地 `$ref` 解析（OpenAPI 3 `#/components/schemas/...`、Swagger 2 `#/definitions/...`）。
+ * 防循环引用，最大展开深度 6；不处理远程引用。
+ */
+import type { JsonSchema } from './types';
+export declare const MAX_SCHEMA_DEPTH = 6;
+/** 按 JSON Pointer（`#/a/b`）取值，找不到返回 undefined */
+export declare function resolvePointer(root: unknown, ref: string): unknown;
+/** 解开非 schema 对象（parameter / requestBody / response）上的 `$ref`，最多跳 10 次 */
+export declare function derefObject<T = any>(node: unknown, root: unknown): T | undefined;
+/**
+ * 解析 schema：展开本地 `$ref` 与 allOf，oneOf / anyOf 取第一个分支。
+ * 超过深度上限的节点只保留类型；循环引用处截断为 `{ type: 'object' }` 并在 warnings 中提示一次。
+ */
+export declare function resolveSchema(schema: unknown, root: unknown, warnings?: string[], maxDepth?: number): JsonSchema;