@yiyi_zhang/reactflow-ui 1.1.0 → 1.3.0

package/dist/library/projections.d.ts

@@ -0,0 +1,53 @@
+import type { ActionDefinition } from '../actions/types';
+import { type ActionExtension } from '../actions/fromDefinitions';
+import type { SchemaDef } from '../types/conductor';
+import type { WorkflowLevel, WorkflowLibraryItem } from '../types/workflowLibrary';
+import type { TaskSchema } from '../services/ai/schemaRegistry';
+import type { LibraryCatalog, LibraryEntry } from './catalog';
+import type { LibraryExtension } from './types';
+/** LibraryExtension → ActionExtension（extension.action 中的显式设置优先） */
+export declare function toActionExtension(ext?: LibraryExtension): ActionExtension;
+/**
+ * 目录 → 动作。只投影 Provider 提供的条目（静态 workflowLibrary 条目只有摘要，没有入参定义，
+ * 不进入业务模式动作库，以保持原有 `actions` 行为不变）。
+ * 已下线条目仍会生成动作（已引用的步骤需要照常显示与编译），但带 `deprecated` 标记，选择器会隐藏。
+ */
+export declare function toActions(catalog: LibraryCatalog): ActionDefinition[];
+/** JSON Schema（Conductor SchemaDef）→ { 字段名: 类型串 }；`enum` 输出为 `a|b`。无可解析的 properties 返回 undefined */
+export declare function schemaToTypeStrings(schema?: SchemaDef): Record<string, string> | undefined;
+/**
+ * 目录 → 任务 Schema。
+ * - 有 inputSchema / outputSchema 时展开 properties；没有时退回 inputKeys / 工作流入参名 / outputKeys / outputParameters 的 key
+ * - 同名条目 Provider 优先于静态 `taskSchemas`；静态 Schema 在前，保持原有顺序
+ * - 已下线条目不输出（避免 AI 继续引用）
+ */
+export declare function toTaskSchemas(catalog: LibraryCatalog): TaskSchema[];
+/**
+ * 目录 → 旧版 WorkflowLibraryItem。
+ * - 未标注层级的条目按 L1 处理（调用规则最保守：只能被同层及更高层引用）
+ * - `version` 为字符串以兼容旧类型：静态条目保持原样，Provider 条目输出整数版本（即步骤将固定的版本）
+ * - 已下线条目不输出
+ */
+export declare function toLibraryItems(catalog: LibraryCatalog): WorkflowLibraryItem[];
+/** 目录条目 → 旧版 WorkflowLibraryItem（规则同 toLibraryItems；也用于服务端检索命中的转换） */
+export declare function entriesToLibraryItems(entries: LibraryEntry[]): WorkflowLibraryItem[];
+/**
+ * 动作选择器可见性过滤：
+ * - 已下线动作隐藏（已引用的步骤仍可通过 registry 正常显示与编译）
+ * - 提供 currentLevel 时，隐藏违反分层调用规则的流程库动作（L1 不显示 L2/L3，L2 不显示 L3）；未提供则不按层级过滤
+ */
+export declare function filterPickableActions(actions: ActionDefinition[], opts?: {
+    currentLevel?: WorkflowLevel;
+}): ActionDefinition[];
+/** 没有业务域的流程库动作所属分组 */
+export declare const OTHER_DOMAIN = "\u5176\u4ED6";
+/**
+ * 动作所属的业务域分组：有 domain 取 domain；流程库动作（kind = workflow）无 domain 归入「其他」；
+ * 其余（内置 / 非流程库）返回 null，继续按原有分类分组。
+ */
+export declare function libraryDomainOf(action: ActionDefinition): string | null;
+/**
+ * 收集动作中出现的业务域，按首次出现的顺序排列（顺序即目录顺序，不重新排序），「其他」固定最后。
+ * 没有任何动作带 domain 时返回空数组（选择器据此保持旧的分类分组）。
+ */
+export declare function collectLibraryDomains(actions: ActionDefinition[]): string[];

package/dist/library/types.d.ts

@@ -0,0 +1,58 @@
+import type { WorkflowDef } from '../types/conductor';
+import type { WorkflowLevel } from '../types/workflowLibrary';
+import type { ActionExtension, RegisteredTaskDef } from '../actions/fromDefinitions';
+/**
+ * 流程库数据源（LibraryProvider）公共类型。
+ * 设计见 docs/design/流程库数据源-LibraryProvider设计.md。
+ *
+ * 原则：来源可换，数据只有一份（LibraryCatalog），消费方只读投影（projections）。
+ */
+/** Conductor 标准之外的补充字段（层级、分类、图标等由宿主决定来源） */
+export interface LibraryExtension {
+    level?: WorkflowLevel;
+    category?: string;
+    /** 业务域展示名（如「通知协助」）。取值来自服务端的全局可调整列表，不在组件库内写死；缺省时尝试从流程名称解析 */
+    domain?: string;
+    icon?: string;
+    tags?: string[];
+    displayName?: string;
+    /** 已下线 / 不建议新引用（等价于 LibraryWorkflowRecord.deprecated，便于由 resolveExtension 一并给出） */
+    deprecated?: boolean;
+    /** 透传到 ActionExtension（字段级覆盖等） */
+    action?: ActionExtension;
+}
+export interface LibraryWorkflowRecord {
+    /** Conductor 标准 WorkflowDef（含 version: number） */
+    def: WorkflowDef;
+    extension?: LibraryExtension;
+    /** 宿主侧可读版本号（如 "1.2.0"），仅展示用 */
+    versionLabel?: string;
+    /** 已下线 / 不建议新引用 */
+    deprecated?: boolean;
+}
+export interface LibraryTaskRecord {
+    /** Conductor 标准 TaskDef */
+    def: RegisteredTaskDef;
+    extension?: LibraryExtension;
+}
+export interface LibraryListResult {
+    /** 每个 name 只需最新版本；可只含摘要（tasks 可为空） */
+    workflows: LibraryWorkflowRecord[];
+    tasks?: LibraryTaskRecord[];
+}
+export interface LibrarySearchOptions {
+    level?: WorkflowLevel;
+    /** 按业务域过滤（与 LibraryExtension.domain 同一取值） */
+    domain?: string;
+    limit?: number;
+}
+export interface LibraryProvider {
+    /** 列出目录（每个流程的最新发布版本） */
+    list(signal?: AbortSignal): Promise<LibraryListResult>;
+    /** 取指定版本的完整定义；version 缺省为最新。找不到返回 null（不抛错） */
+    get(name: string, version?: number, signal?: AbortSignal): Promise<LibraryWorkflowRecord | null>;
+    /** 可选：服务端检索，大目录时由 AI 工具与选择器使用 */
+    search?(query: string, opts?: LibrarySearchOptions, signal?: AbortSignal): Promise<LibraryWorkflowRecord[]>;
+}
+/** 目录加载状态 */
+export type LibraryLoadStatus = 'idle' | 'loading' | 'ready' | 'error';

package/dist/library/useLibraryCatalog.d.ts

@@ -0,0 +1,9 @@
+import { LibraryCatalog, type LibraryCatalogSnapshot } from './catalog';
+import type { LibraryProvider } from './types';
+/** 订阅目录状态（catalog 为空时返回恒定的 idle 快照）。目录数据变化时返回新的快照引用。 */
+export declare function useLibraryCatalogSnapshot(catalog: LibraryCatalog | undefined): LibraryCatalogSnapshot;
+/**
+ * 让目录跟随 provider：provider 引用变化时重新加载；卸载 / 更换时 abort 进行中的请求。
+ * 每个 IDE 实例自己持有 catalog，这里只负责驱动它。
+ */
+export declare function useLibraryCatalogLoader(catalog: LibraryCatalog, provider: LibraryProvider | undefined): void;

package/dist/library/version.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 版本号规范化：统一为整数（Conductor 的版本就是整数）。
+ *
+ * | 输入 | 结果 |
+ * |---|---|
+ * | 整数 | 原样 |
+ * | 静态 "3" | 3，label "3" |
+ * | 静态 "1.2.0" 等 | 取 parseInt 主版本号，label 保留原串，warn = true |
+ */
+export interface NormalizedVersion {
+    version: number;
+    /** 原始可读版本串（仅当输入是字符串，或无法原样用作整数时保留） */
+    label?: string;
+    /** 是否发生了有损转换（调用方据此告警一次） */
+    lossy: boolean;
+}
+export declare function normalizeVersion(input: number | string | undefined | null): NormalizedVersion;

package/dist/library/versionStatus.d.ts

@@ -0,0 +1,44 @@
+import type { LibraryLoadStatus } from './types';
+/**
+ * 流程库能力徽标的状态（纯函数，便于单测）。
+ *
+ * | 场景 | 状态 |
+ * |---|---|
+ * | 步骤未记录版本 | unpinned：沿用原定义，不显示任何提示 |
+ * | 库中有更高版本 | upgradable：「⬆ 有新版本 vN」，由用户确认差异后手动升级 |
+ * | 固定版本在库中不存在 / 已下线 | unavailable：「⚠ 版本不可用」，保持原样编译，不自动改版本 |
+ * | 目录加载中 / 加载失败 | pinned：不显示新版本提示，不影响编辑与编译 |
+ */
+export type LibraryBadgeState = {
+    kind: 'unpinned';
+} | {
+    kind: 'pinned';
+    pinned: number;
+} | {
+    kind: 'upgradable';
+    pinned: number;
+    latest: number;
+} | {
+    kind: 'unavailable';
+    pinned: number;
+    reason: 'deprecated' | 'removed' | 'missing-version';
+};
+export interface LibraryBadgeInputs {
+    /** 步骤上记录的固定版本 */
+    pinned: number | undefined;
+    /**
+     * 目录加载状态。`undefined` 表示没有流程库目录参与（仅有 `actions` prop），
+     * 此时沿用旧行为：只按动作上记录的最新版本提示升级，不判断「版本不可用」。
+     */
+    catalogStatus: LibraryLoadStatus | undefined;
+    /** 库中（或动作上记录的）当前最新版本；不存在时为 undefined */
+    latest: {
+        version: number;
+        deprecated: boolean;
+    } | undefined;
+    /** 固定版本是否仍存在于库中（异步检查结果；undefined = 未知，按存在处理） */
+    pinnedExists: boolean | undefined;
+}
+export declare function resolveLibraryBadgeState(input: LibraryBadgeInputs): LibraryBadgeState;
+/** 「版本不可用」的原因说明（用于徽标 tooltip） */
+export declare function describeUnavailable(name: string, pinned: number, reason: 'deprecated' | 'removed' | 'missing-version'): string;

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,41 @@
+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;

package/dist/onboarding/poll.d.ts

@@ -0,0 +1,39 @@
+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'];
+/** 终态：不会再变化，轮询据此停止 */
+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>;
+}
+/**
+ * 轮询上线申请直到终态（APPROVED / REJECTED / SYNCED）：先立即查一次，之后按 nextPollDelay 退避。
+ * APPROVED 视为终态（审批已有结论），轮询随之停止。
+ * 请求失败直接抛出（由界面显示「重试」）；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/product-launch.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <link rel="icon" type="image/svg+xml" href="/logo.svg" />
+  <link rel="icon" type="image/svg+xml" href="./logo.svg" />
   <title>[Product Launch] Conductor Workflow IDE v1.0 GA · 让工作流编排与联调从 4.5 小时缩短至 12 分钟</title>
   <style>
     /* ==========================================================================
@@ -738,7 +738,7 @@
   <!-- Sticky Launch Bar -->
   <header class="launch-nav">
     <div class="nav-left">
-      <a href="/" class="brand-logo">
+      <a href="./" class="brand-logo">
         <svg width="26" height="26" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg" style="flex-shrink:0;">
           <defs>
             <linearGradient id="nav-bg" x1="0" y1="0" x2="32" y2="32" gradientUnits="userSpaceOnUse">
@@ -772,7 +772,7 @@
       <span style="color:var(--text-muted);">@yiyi_zhang/reactflow-ui · 下一代 AI 原生工作流编排与本地确定性沙箱 IDE</span>
     </div>
     <div class="nav-right">
-      <a href="/app" class="ghost-btn">🎮 进入在线交互演练场</a>
+      <a href="./app" class="ghost-btn">🎮 进入在线交互演练场</a>
       <button class="cta-btn" onclick="document.getElementById('quickstart').scrollIntoView({behavior:'smooth'})">
         30 秒极速接入 →
       </button>

package/dist/providers/WorkflowIdeProvider.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from 'react';
+import type { IdeProviders } from './types';
+export interface WorkflowIdeProviderProps {
+    providers: IdeProviders;
+    children: ReactNode;
+}
+/**
+ * 统一注册扩展点：宿主配置一次，其下所有 `WorkflowIDE` / `AiWorkflowIDE` 共用。
+ * `providers` 对象每次渲染重新创建也没关系——只有某个 provider 引用变化时才会通知下游。
+ *
+ * ```tsx
+ * <WorkflowIdeProvider providers={{ library, telemetry }}>
+ *   <WorkflowIDE … />
+ * </WorkflowIdeProvider>
+ * ```
+ */
+export declare function WorkflowIdeProvider({ providers, children }: WorkflowIdeProviderProps): import("react/jsx-runtime").JSX.Element;
+/** 读取外层 `WorkflowIdeProvider` 提供的扩展点；没有外层时返回空对象（不抛错） */
+export declare function useIdeProviders(): IdeProviders;
+/**
+ * IDE 内部使用：合并「专用 prop > 组件 providers prop > 外层 Provider」，结果按字段引用稳定。
+ */
+export declare function useResolvedProviders(componentProviders: IdeProviders | undefined, override?: Partial<IdeProviders>): IdeProviders;

package/dist/providers/resolve.d.ts

@@ -0,0 +1,20 @@
+import type { IdeProviders } from './types';
+/** 各层来源，按优先级从高到低排列 */
+export interface ProviderSources {
+    /** 组件上的专用 prop（如 `libraryProvider`），优先级最高 */
+    override?: Partial<IdeProviders>;
+    /** 组件的 `providers` prop */
+    component?: Partial<IdeProviders>;
+    /** 外层 `WorkflowIdeProvider` */
+    context?: Partial<IdeProviders>;
+}
+/**
+ * 按字段解析：专用 prop > 组件 `providers` prop > 外层 `WorkflowIdeProvider` > 无。
+ * 某一层的字段为 undefined 时才落到下一层（不是整个对象覆盖）。纯函数，每次返回新对象。
+ */
+export declare function resolveProviders(sources?: ProviderSources): IdeProviders;
+/**
+ * 稳定化：各字段引用都与 prev 相同时返回 prev 本身。
+ * 宿主每次渲染新建 `providers` 对象、但 provider 实例不变时，下游拿到的仍是同一个对象，不会触发目录重载。
+ */
+export declare function stabilizeProviders(prev: IdeProviders | undefined, next: IdeProviders): IdeProviders;

package/dist/providers/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 扩展点注册：统一的 Provider 集合与自助接入（Onboarding）契约。
+ * 设计见 docs/design/v1.3.0-自助接入设计.md 第 2、3.2 节。
+ */
+import type { LibraryProvider } from '../library/types';
+import type { TelemetrySink } from '../telemetry/types';
+export interface OnboardingContext {
+    env: 'TEST' | 'PROD';
+    user: {
+        id: string;
+        name: string;
+    };
+    /** 当前环境是否开放自助试用（生产为 false） */
+    trialEnabled: boolean;
+}
+export interface ProductInfo {
+    name: string;
+    domain: string;
+    status: 'PENDING' | 'ACTIVE';
+    role: 'OWNER' | 'MEMBER';
+}
+export type StartTrialResult = {
+    status: 'ok';
+    product: ProductInfo;
+} | {
+    status: 'conflict';
+    owners: {
+        id: string;
+        name: string;
+    }[];
+};
+export interface PromotionStatus {
+    requestId: string;
+    state: 'SUBMITTED' | 'REVIEWING' | 'APPROVED' | 'REJECTED' | 'SYNCED';
+    targetName?: string;
+    comment?: string;
+    updatedAt: string;
+}
+export interface OnboardingProvider {
+    getContext(signal?: AbortSignal): Promise<OnboardingContext>;
+    listDomains(signal?: AbortSignal): Promise<string[]>;
+    listMyProducts(signal?: AbortSignal): Promise<ProductInfo[]>;
+    startTrial(input: {
+        productName: string;
+        domain: string;
+        systemCode?: string;
+    }): Promise<StartTrialResult>;
+    requestPromotion(input: {
+        workflowName: string;
+        version: number;
+        targetType: 'custom' | 'std';
+    }): Promise<{
+        requestId: string;
+    }>;
+    getPromotion(requestId: string, signal?: AbortSignal): Promise<PromotionStatus>;
+}
+/** 宿主配置一次、页面内所有 IDE 共用的扩展点集合 */
+export interface IdeProviders {
+    /** 流程库数据源（1.2.0 已有） */
+    library?: LibraryProvider;
+    /** 自助接入（1.3.0；B1 仅定义契约，界面在 B2） */
+    onboarding?: OnboardingProvider;
+    /** 接入埋点（1.3.0） */
+    telemetry?: TelemetrySink;
+}