@yiyi_zhang/reactflow-ui 1.2.0 → 1.3.1

package/dist/import/selection.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Import dialog selection rules (R16): the dialog renders at most `limit` rows, so nothing outside what the user can
+ * see is ever selected implicitly.
+ */
+/** Default selection: every operation when all of them are shown, otherwise none. */
+export declare function initialSelection<T extends {
+    id: string;
+}>(operations: T[], limit: number): Set<string>;
+/** The rows shown and how many matching rows are hidden by the limit. */
+export declare function visibleSlice<T>(filtered: T[], limit: number): {
+    visible: T[];
+    hiddenCount: number;
+};
+/** Select-all / select-none applied to the visible rows only. */
+export declare function applyToVisible<T extends {
+    id: string;
+}>(selected: Set<string>, visible: T[], on: boolean): Set<string>;

package/dist/import/sensitive.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 敏感信息处理：请求头 / 查询参数 / 请求体字段里的凭据不落入流程定义，
+ * 一律替换为 `${workflow.input.xxx}` 占位，并给出提示。
+ */
+export declare function isSensitiveHeader(name: string): boolean;
+/** 查询参数 / 请求体字段名是否敏感 */
+export declare function isSensitiveName(name: string): boolean;
+/** 占位表达式：`${workflow.input.<camelName>}` */
+export declare function inputPlaceholder(name: string): string;
+export declare function sensitiveHeaderWarning(name: string): string;
+/**
+ * 替换请求头中的敏感值。已是 `${...}` 表达式的值视为已处理，原样保留。
+ * 返回新对象，不修改入参。
+ */
+export declare function sanitizeHeaders(headers: Record<string, string>): {
+    headers: Record<string, string>;
+    warnings: string[];
+};

package/dist/import/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 接口导入：解析结果的公共类型（纯数据，无 React 依赖）。
+ * 设计见 docs/design/v1.3.0-自助接入设计.md 第 4 节。
+ */
+/** 可导入的来源格式 */
+export type ImportFormat = 'openapi3' | 'swagger2' | 'postman21' | 'curl';
+/** detectFormat 的结果：除可导入格式外，还可能是 YAML（不支持）或无法识别 */
+export type DetectedFormat = ImportFormat | 'yaml' | 'unknown';
+/** JSON Schema 片段（已解析本地 $ref，保持宽松类型） */
+export type JsonSchema = Record<string, any>;
+export type ParamLocation = 'path' | 'query' | 'header';
+export interface ImportedParam {
+    name: string;
+    in: ParamLocation;
+    required: boolean;
+    schema: JsonSchema;
+    description?: string;
+    /** 导入时带入的默认值（curl / Postman 中的字面量；敏感名称已替换为占位） */
+    defaultValue?: string;
+}
+export interface ImportedBody {
+    /** 例如 application/json */
+    contentType: string;
+    /** object 且含 properties 时拆成多个字段；否则整体作为单个 `body` 字段 */
+    schema: JsonSchema;
+}
+export interface ImportedOperation {
+    /** 同一次解析内唯一，形如 `get_tickets_id`，用于动作 id（`import.<id>`） */
+    id: string;
+    /** 大写 HTTP 方法 */
+    method: string;
+    /** 服务地址（不含路径），可能为空或含 `${workflow.input.xxx}` */
+    baseUrl: string;
+    /** 路径模板，路径参数写作 `{id}` */
+    path: string;
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags: string[];
+    params: ImportedParam[];
+    /** 固定请求头（敏感头的值已替换为 `${workflow.input.xxx}` 占位） */
+    headers: Record<string, string>;
+    body?: ImportedBody;
+    /** 2xx 响应的 JSON Schema */
+    responseSchema?: JsonSchema;
+    /** 与该接口相关的提示（敏感头替换、不支持的部分等） */
+    warnings: string[];
+}
+export type ParseResult = {
+    ok: true;
+    format: ImportFormat;
+    operations: ImportedOperation[];
+    /** 汇总提示（含各接口的提示，已带接口前缀） */
+    warnings: string[];
+} | {
+    ok: false;
+    format?: DetectedFormat;
+    /** 面向用户的中文错误信息 */
+    error: string;
+};
+/** 提示用户把 YAML 转成 JSON 的固定文案 */
+export declare const YAML_HINT = "YAML \u8BF7\u5148\u8F6C\u4E3A JSON \u540E\u518D\u5BFC\u5165";

package/dist/import/util.d.ts

@@ -0,0 +1,23 @@
+/** 接口导入内部的小工具（纯函数）。 */
+import type { JsonSchema } from './types';
+export declare const HTTP_METHODS: readonly ["get", "post", "put", "delete", "patch", "head", "options"];
+export declare function isPlainObject(v: unknown): v is Record<string, any>;
+/** 去 BOM、首尾空白 */
+export declare function normalizeText(text: string): string;
+/** 把任意名称转为 snake_case 片段（只保留字母数字） */
+export declare function slugify(raw: string, maxLen?: number): string;
+/** 把名称转为 camelCase（用于 `${workflow.input.xxx}`） */
+export declare function camelName(raw: string): string;
+/** 在已有 id 集合内取唯一 id（冲突时追加 _2、_3…），并登记到集合 */
+export declare function uniqueId(base: string, used: Set<string>): string;
+/** 由一个 JSON 示例值推断简单 schema（不含 default） */
+export declare function inferSchema(value: unknown, depth?: number): JsonSchema;
+/** 取 schema 的主类型（忽略 null） */
+export declare function schemaType(schema: JsonSchema | undefined): string;
+/** 简单的 URL 拆分：baseUrl（协议+主机 或 `${...}` 变量）、路径、查询串 */
+export declare function splitUrl(raw: string): {
+    baseUrl: string;
+    path: string;
+    query: string;
+};
+export declare function safeDecode(s: string): string;

package/dist/index.d.ts

@@ -6,8 +6,11 @@ export type { AIServiceConfig } from './services/aiService';
 export type { ExecutionActions, RestartOptions, ViewMode, RunState, WorkflowExecutionInput } from './types/workflow';
 export { getCompletionItems, buildDataFlowGraph, refactorTaskReferenceName, getUpstreamAncestors, inferTaskOutputSchema, } from './services/wlsp/workflowLsp';
 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 { executeLocalSandboxDryRun, executeLocalSandboxDryRunAsync, buildDefaultWorkflowMockInput, generateDefaultTaskOutputPreview, } from './utils/localSandboxEngine';
+export type { SandboxDryRunOptions, SandboxAsyncOptions, TaskMockOverride, } from './utils/localSandboxEngine';
+export { runJq, JqError } from './utils/sandbox/jq';
+export { createWorkerScriptEvaluator } from './utils/sandbox/scriptRunner';
+export type { ScriptEvaluator, ScriptResult, WorkerScriptEvaluator } from './utils/sandbox/scriptRunner';
 export * from './actions/types';
 export { ActionRegistry, defaultActionRegistry } from './actions/registry';
 export { BUILTIN_ECS_ACTIONS } from './actions/builtin/ecs';
@@ -43,3 +46,19 @@ export type { RunStoryTimelineProps } from './components/business/RunStoryTimeli
 export * from './library';
 export type { WorkflowLevel, WorkflowLibraryItem } from './types/workflowLibrary';
 export type { TaskSchema } from './services/ai/schemaRegistry';
+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/library/versionStatus.d.ts

@@ -5,8 +5,8 @@ import type { LibraryLoadStatus } from './types';
  * | 场景 | 状态 |
  * |---|---|
  * | 步骤未记录版本 | unpinned：沿用原定义，不显示任何提示 |
- * | 库中有更高版本 | upgradable：「⬆ 有新版本 vN」，由用户确认差异后手动升级 |
- * | 固定版本在库中不存在 / 已下线 | unavailable：「⚠ 版本不可用」，保持原样编译，不自动改版本 |
+ * | 库中有更高版本 | upgradable：「有新版本 vN」，由用户确认差异后手动升级 |
+ * | 固定版本在库中不存在 / 已下线 | unavailable：「版本不可用」，保持原样编译，不自动改版本 |
  * | 目录加载中 / 加载失败 | pinned：不显示新版本提示，不影响编辑与编译 |
  */
 export type LibraryBadgeState = {

package/dist/logo.svg

@@ -1,37 +1,10 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
-  <defs>
-    <linearGradient id="bg-grad" x1="0" y1="0" x2="32" y2="32" gradientUnits="userSpaceOnUse">
-      <stop offset="0%" stop-color="#11172B" />
-      <stop offset="100%" stop-color="#090D18" />
-    </linearGradient>
-    <linearGradient id="border-grad" x1="0" y1="0" x2="32" y2="32" gradientUnits="userSpaceOnUse">
-      <stop offset="0%" stop-color="#6366F1" stop-opacity="0.75" />
-      <stop offset="100%" stop-color="#06B6D4" stop-opacity="0.45" />
-    </linearGradient>
-    <linearGradient id="branch-top" x1="9" y1="16" x2="23" y2="10" gradientUnits="userSpaceOnUse">
-      <stop offset="0%" stop-color="#818CF8" />
-      <stop offset="100%" stop-color="#22D3EE" />
-    </linearGradient>
-    <linearGradient id="branch-bottom" x1="9" y1="16" x2="23" y2="22" gradientUnits="userSpaceOnUse">
-      <stop offset="0%" stop-color="#6366F1" />
-      <stop offset="100%" stop-color="#34D399" />
-    </linearGradient>
-  </defs>
-
-  <!-- Minimalist Squircle Base -->
-  <rect x="1.25" y="1.25" width="29.5" height="29.5" rx="8" fill="url(#bg-grad)" stroke="url(#border-grad)" stroke-width="1.5" />
-
-  <!-- Bifurcated DAG Flow Curves -->
-  <path d="M 9.5 16 C 15 16, 15.5 10, 22.5 10" stroke="url(#branch-top)" stroke-width="2.4" stroke-linecap="round" />
-  <path d="M 9.5 16 C 15 16, 15.5 22, 22.5 22" stroke="url(#branch-bottom)" stroke-width="2.4" stroke-linecap="round" />
-
-  <!-- Origin Root Node -->
-  <circle cx="9.5" cy="16" r="3.4" fill="#6366F1" />
-  <circle cx="9.5" cy="16" r="1.4" fill="#F8FAFC" />
-
-  <!-- Upper Branch Target Node -->
-  <circle cx="22.5" cy="10" r="2.7" fill="#22D3EE" />
-
-  <!-- Lower Branch Deterministic Pass Node -->
-  <circle cx="22.5" cy="22" r="2.7" fill="#34D399" />
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128">
+  <rect width="128" height="128" rx="28" fill="#161311"/>
+  <rect x="1" y="1" width="126" height="126" rx="27" fill="none" stroke="#ff6a13" stroke-opacity="0.35" stroke-width="2"/>
+  <g transform="translate(18 18) scale(0.92)">
+    <g stroke="#ff6a13" stroke-width="3" opacity="0.7"><line x1="50" y1="50" x2="75.5" y2="24.5"/><line x1="50" y1="50" x2="14" y2="50"/><line x1="50" y1="50" x2="75.5" y2="75.5"/></g>
+    <path d="M75.46 24.54A36 36 0 1 0 75.46 75.46" fill="none" stroke="#ff6a13" stroke-width="9" stroke-linecap="round"/>
+    <g fill="#161311" stroke="#ff6a13" stroke-width="5"><circle cx="75.46" cy="24.54" r="7"/><circle cx="14" cy="50" r="7"/><circle cx="75.46" cy="75.46" r="7"/></g>
+    <circle cx="50" cy="50" r="10" fill="#ff6a13"/>
+  </g>
 </svg>

package/dist/onboarding/index.d.ts

@@ -0,0 +1,6 @@
+export { buildWorkflowName, validateNameParts, suggestFuncSlug, promotionTargetName, isPromotableName, buildSkeletonWorkflow, } from './naming';
+export type { WorkflowNameParts, PromotionTargetType, SkeletonInput } from './naming';
+export { nextPollDelay, isTerminalPromotionState, buildPromotionTimeline, promotionStateLabel, pollPromotion, } from './poll';
+export type { TimelineItem, PollOptions, PromotionState } from './poll';
+export { WIZARD_STEPS, WIZARD_STEP_LABEL, createInitialDraft, validateProductName, productStepError, namingStepErrors, draftToNameParts, canAdvance, nextStep, prevStep, availableSources, } from './wizardState';
+export type { WizardStep, WizardDraft, StartSource } from './wizardState';

package/dist/onboarding/naming.d.ts

@@ -0,0 +1,46 @@
+import type { WorkflowDef } from '../types/conductor';
+import type { WorkflowLevel } from '../types/workflowLibrary';
+import type { WorkflowNameType } from '../library/naming';
+/**
+ * 自助接入的命名辅助：纯函数，不依赖 React，可直接单测。
+ * 命名规范：`类型-层级-业务域-产品-功能`（见 src/library/naming.ts）。
+ */
+/** 申请上线时可选的目标类型 */
+export type PromotionTargetType = 'custom' | 'std';
+/** 五段式名称的各段 */
+export interface WorkflowNameParts {
+    type: WorkflowNameType;
+    level: WorkflowLevel;
+    domain: string;
+    product: string;
+    func: string;
+}
+/** 拼出完整流程名称。业务域 / 产品段会被去掉 `-`；功能段保持原样（仅去首尾空白，允许含 `-`） */
+export declare function buildWorkflowName(parts: WorkflowNameParts): string;
+/** 校验各段拼出的名称（空段会得到「xx不能为空」类错误），业务域白名单可选 */
+export declare function validateNameParts(parts: WorkflowNameParts, allowedDomains?: string[]): string[];
+/**
+ * 由用户输入的功能说明建议「功能」段：
+ * - 含中文：保持原样，仅去掉 `-`（避免破坏分段），空白折叠为 `_`；
+ * - 纯 ASCII：转小写 snake_case（驼峰拆词，连字符 / 空格 / 其他符号折叠为 `_`）。
+ */
+export declare function suggestFuncSlug(text: string): string;
+/**
+ * 申请上线后的正式名称：把类型段（第一段）替换为目标类型。
+ * 名称不符合五段规范时返回 null。
+ */
+export declare function promotionTargetName(tmpName: string, targetType: PromotionTargetType): string | null;
+/** 当前流程名称是否是可申请上线的临时流程（类型段为 tmp） */
+export declare function isPromotableName(name: string | undefined | null): boolean;
+export interface SkeletonInput {
+    name: string;
+    description?: string;
+    ownerEmail?: string;
+}
+/** 向导生成的骨架定义：version 1 / schemaVersion 2，空任务 */
+export declare function buildSkeletonWorkflow(input: SkeletonInput): WorkflowDef;
+/**
+ * 保存前的命名提示（设计 3.3，R15）：名称不符合五段规范时返回一句提示，符合时返回 null。
+ * 只提示、不阻断保存；服务端做权威校验。
+ */
+export declare function saveNameHint(name: string | undefined | null, allowedDomains?: string[]): string | null;

package/dist/onboarding/poll.d.ts

@@ -0,0 +1,42 @@
+import type { OnboardingProvider, PromotionStatus } from '../providers/types';
+/** 上线申请轮询：初始间隔、封顶间隔（毫秒） */
+export declare const POLL_BASE_MS = 2000;
+export declare const POLL_MAX_MS = 30000;
+/** 第 attempt 次（从 0 开始）等待的时长：指数退避 2s → 4s → 8s … 封顶 30s */
+export declare function nextPollDelay(attempt: number): number;
+export type PromotionState = PromotionStatus['state'];
+/**
+ * 终态：不会再变化，轮询据此停止。只有 SYNCED（已同步到生产）与 REJECTED（已驳回）是终态；
+ * APPROVED 之后还要同步，轮询继续（R12）。
+ */
+export declare function isTerminalPromotionState(state: PromotionState): boolean;
+export interface TimelineItem {
+    state: PromotionState;
+    label: string;
+    /** done 已完成 / current 进行中 / pending 未到 / failed 被驳回 */
+    status: 'done' | 'current' | 'pending' | 'failed';
+}
+export declare function promotionStateLabel(state: PromotionState): string;
+/**
+ * 进度时间线。正常路径：已提交 → 审批中 → 审批通过 → 已同步到生产；
+ * 被驳回时第三项替换为「已驳回」（failed），之后不再展示「已同步」。
+ */
+export declare function buildPromotionTimeline(state: PromotionState | null): TimelineItem[];
+export declare function isAbortError(e: unknown): boolean;
+/** 可被 AbortSignal 打断的等待 */
+export declare function abortableSleep(ms: number, signal?: AbortSignal): Promise<void>;
+export interface PollOptions {
+    provider: Pick<OnboardingProvider, 'getPromotion'>;
+    requestId: string;
+    signal?: AbortSignal;
+    /** 每次拿到状态时回调（含终态） */
+    onUpdate?: (status: PromotionStatus) => void;
+    /** 注入等待函数（测试用），默认 abortableSleep */
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+}
+/**
+ * 轮询上线申请直到终态（SYNCED / REJECTED）：先立即查一次，之后按 nextPollDelay 退避。
+ * APPROVED 不是终态：审批通过后继续轮询，直到同步到生产（SYNCED）。
+ * 请求失败直接抛出（由界面显示「重试」）；signal 中止时抛 AbortError。
+ */
+export declare function pollPromotion(opts: PollOptions): Promise<PromotionStatus>;

package/dist/onboarding/wizardState.d.ts

@@ -0,0 +1,44 @@
+import type { WorkflowLevel } from '../types/workflowLibrary';
+import type { ProductInfo } from '../providers/types';
+import type { WorkflowNameType } from '../library/naming';
+import type { WorkflowNameParts } from './naming';
+/** 向导步骤：产品 → 命名 → 起点 */
+export type WizardStep = 'product' | 'naming' | 'start';
+export declare const WIZARD_STEPS: readonly WizardStep[];
+export declare const WIZARD_STEP_LABEL: Record<WizardStep, string>;
+export type StartSource = 'blank' | 'template' | 'import';
+export interface WizardDraft {
+    /** existing：选择已有产品；new：登记新产品（仅试用环境） */
+    productMode: 'existing' | 'new';
+    productName: string;
+    domain: string;
+    systemCode: string;
+    type: WorkflowNameType;
+    level: WorkflowLevel;
+    func: string;
+    description: string;
+    source: StartSource;
+}
+export interface WizardContextLite {
+    trial: boolean;
+    products: ProductInfo[];
+}
+/** 初始草稿：有产品时默认选第一个；没有产品时（试用环境）进入登记模式 */
+export declare function createInitialDraft(ctx: WizardContextLite, level?: WorkflowLevel): WizardDraft;
+/** 产品名规则：非空、不含 `-` 与空白（会破坏五段切分） */
+export declare function validateProductName(name: string): string | null;
+/** 第 1 步的校验错误（null = 可继续） */
+export declare function productStepError(draft: WizardDraft, ctx: WizardContextLite, domains: string[]): string | null;
+/** 草稿 → 五段名称 */
+export declare function draftToNameParts(draft: WizardDraft, trial: boolean): WorkflowNameParts;
+/** 第 2 步的校验错误列表 */
+export declare function namingStepErrors(draft: WizardDraft, trial: boolean, domains: string[]): string[];
+/** 当前步骤是否允许进入下一步 */
+export declare function canAdvance(step: WizardStep, draft: WizardDraft, ctx: WizardContextLite, domains: string[]): boolean;
+export declare function nextStep(step: WizardStep): WizardStep;
+export declare function prevStep(step: WizardStep): WizardStep;
+/** 可选的起点：未提供对应回调时隐藏该选项（空白始终可用） */
+export declare function availableSources(opts: {
+    hasTemplate: boolean;
+    hasImport: boolean;
+}): StartSource[];

package/dist/parser/conductorGenerator.d.ts

@@ -30,7 +30,22 @@ export declare function insertFirstTaskIntoBranch(tasks: TaskDef[] | undefined,
     branchCase?: string;
     forkIndex?: number;
 }, newTask: TaskDef): boolean;
+/** 收集任务树中所有 taskReferenceName */
+export declare function collectTaskRefs(tasks: TaskDef[] | undefined, acc?: Set<string>): Set<string>;
 /**
- * 同步 FORK_JOIN 与配套 JOIN 任务的 joinOn 字段
+ * 同步 FORK_JOIN 与配套 JOIN 任务的 joinOn 字段（E5）
+ *
+ * - 不传 `previousTasks`（加载 / 导入）：只给缺失或为空的 joinOn 补齐"各分支最后一个任务"，已有 joinOn 原样保留。
+ * - 传入 `previousTasks`（编辑操作前的任务树）：只更新被结构性编辑影响的那几项——
+ *   分支最后一个任务变了就替换对应项、新增 / 原本为空的分支追加其末尾任务、分支变空或任务被删除则移除该项；
+ *   用户原本没有 join 的分支保持不 join，其余条目（例如 join 分支中间的任务）不动。
+ *   分支结构没有变化时 joinOn 完全不改写。
  */
-export declare function syncForkJoinOn(tasks: TaskDef[] | undefined): void;
+export declare function syncForkJoinOn(tasks: TaskDef[] | undefined, previousTasks?: TaskDef[] | null): void;
+/**
+ * 迁移旧版本编辑器写在 WorkflowTask 顶层、Conductor 实际从 inputParameters 读取的字段（E2 / E20）。
+ * 只在 inputParameters 中没有同名键时迁移，原地修改。
+ */
+export declare function normalizeLegacyTaskFields(tasks: TaskDef[] | undefined): void;
+/** 找到 FORK_JOIN / FORK_JOIN_DYNAMIC 在同层紧随其后的配对 JOIN 引用名（E8） */
+export declare function findPairedJoinRef(tasks: TaskDef[] | undefined, forkRef: string): string | null;