@yiyi_zhang/reactflow-ui 1.0.0 → 1.2.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { WorkflowIDE } from './WorkflowIDE';
 export type { WorkflowIDEProps, WorkflowIDERef } from './WorkflowIDE';
-export type { WorkflowDef, TaskDef, WorkflowInputParam, WorkflowInstance } from './types/conductor';
+export type { WorkflowDef, TaskDef, WorkflowInputParam, WorkflowInstance, SchemaDef } from './types/conductor';
 export { parseWorkflowInputParams } from './types/conductor';
 export type { AIServiceConfig } from './services/aiService';
 export type { ExecutionActions, RestartOptions, ViewMode, RunState, WorkflowExecutionInput } from './types/workflow';
@@ -8,3 +8,38 @@ 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 * from './actions/types';
+export { ActionRegistry, defaultActionRegistry } from './actions/registry';
+export { BUILTIN_ECS_ACTIONS } from './actions/builtin/ecs';
+export { BUILTIN_COMMON_ACTIONS } from './actions/builtin/common';
+export { buildActionFromWorkflowDef, buildActionFromTaskDef, buildActionsFromLibrary, buildActionsFromTaskDefs, } from './actions/fromDefinitions';
+export type { ActionExtension, RegisteredTaskDef, LibraryWorkflowEntry, RegisteredTaskEntry, } from './actions/fromDefinitions';
+export { createStepFromAction } from './stepmodel/factory';
+export * from './stepmodel/types';
+export { compileStepToTaskDef, compileStepModelToWorkflowDef, } from './stepmodel/compile';
+export { decompileTaskDefToStep, decompileWorkflowDefToStepModel, } from './stepmodel/decompile';
+export { StepFlowEditor } from './components/business/StepFlowEditor';
+export { DecisionBranchCard } from './components/business/DecisionBranchCard';
+export { ForkJoinCard } from './components/business/ForkJoinCard';
+export { LoopDoWhileCard } from './components/business/LoopDoWhileCard';
+export { DataPillInput } from './components/business/DataPillInput';
+export { ActionForm } from './components/business/ActionForm';
+export * from './template/types';
+export { TemplateStore, defaultTemplateStore } from './template/templateStore';
+export { applyTemplateVariables } from './template/applyTemplate';
+export { BUILTIN_WORKFLOW_TEMPLATES } from './template/builtin/templates';
+export { TemplateGallery } from './components/template/TemplateGallery';
+export { TemplateSetupWizard } from './components/template/TemplateSetupWizard';
+export * from './template/sanitizer/types';
+export { scanWorkflowDef, scanObjectForSensitiveFindings } from './template/sanitizer/rules';
+export { analyzeTasksForPruning, applyTaskPruning } from './template/sanitizer/prune';
+export { extractTemplateFromInstance } from './template/sanitizer/anonymize';
+export { TemplateExtractor } from './components/template/TemplateExtractor';
+export * from './utils/friendlyErrorTranslator';
+export { FriendlyErrorCard } from './components/business/FriendlyErrorCard';
+export type { FriendlyErrorCardProps } from './components/business/FriendlyErrorCard';
+export { RunStoryTimeline } from './components/business/RunStoryTimeline';
+export type { RunStoryTimelineProps } from './components/business/RunStoryTimeline';
+export * from './library';
+export type { WorkflowLevel, WorkflowLibraryItem } from './types/workflowLibrary';
+export type { TaskSchema } from './services/ai/schemaRegistry';

package/dist/library/catalog.d.ts

@@ -0,0 +1,93 @@
+import type { WorkflowLevel, WorkflowLibraryItem } from '../types/workflowLibrary';
+import type { TaskSchema } from '../services/ai/schemaRegistry';
+import type { LibraryLoadStatus, LibraryProvider, LibrarySearchOptions, LibraryTaskRecord, LibraryWorkflowRecord } from './types';
+/** 规范化后的目录条目（每个 name 只有一个最新版本） */
+export interface LibraryEntry {
+    name: string;
+    /** 统一为整数 */
+    version: number;
+    versionLabel?: string;
+    description?: string;
+    level?: WorkflowLevel;
+    /** 业务域展示名：优先取 extension.domain，缺省时从流程名称解析 */
+    domain?: string;
+    tags: string[];
+    deprecated: boolean;
+    record: LibraryWorkflowRecord;
+    /** 条目来源：Provider 提供，或静态 prop（workflowLibrary）。同名时 Provider 优先 */
+    source: 'provider' | 'static';
+}
+/** 目录状态快照（引用在每次变化时更新，供 useSyncExternalStore 使用） */
+export interface LibraryCatalogSnapshot {
+    status: LibraryLoadStatus;
+    error?: Error;
+    /** 每次数据 / 状态变化递增，便于作为 useMemo 依赖 */
+    revision: number;
+}
+export interface LibraryCatalogOptions {
+    /** 兼容旧 `workflowLibrary` prop 的静态条目 */
+    staticItems?: WorkflowLibraryItem[];
+    /** 兼容旧 `taskSchemas` prop 的静态 Schema */
+    staticTaskSchemas?: TaskSchema[];
+}
+/** 把一条记录规范化为目录条目 */
+export declare function entryFromRecord(record: LibraryWorkflowRecord, source: LibraryEntry['source'], onLossy?: (name: string, label: string) => void): LibraryEntry;
+/**
+ * 流程库目录：把 Provider 与静态 prop 规范化成一份数据。
+ * 每个实例独立（不是全局单例）；通过 subscribe / getSnapshot 接入 React。
+ */
+export declare class LibraryCatalog {
+    private provider?;
+    private staticItems;
+    private staticSchemas;
+    private providerEntries;
+    private providerTasks;
+    private merged;
+    private versionCache;
+    private warned;
+    private listeners;
+    /** 每次 load / setProvider 递增，用于丢弃过期的异步结果 */
+    private generation;
+    private controller;
+    private snapshot;
+    constructor(provider?: LibraryProvider, options?: LibraryCatalogOptions);
+    /** 更换数据源：丢弃旧数据与缓存，状态回到 idle（需再调用 load） */
+    setProvider(provider?: LibraryProvider): void;
+    /** 更新静态条目 / Schema（对应旧 prop 变化） */
+    setStatic(options: LibraryCatalogOptions): void;
+    hasProvider(): boolean;
+    /** Provider 是否支持服务端检索 */
+    hasServerSearch(): boolean;
+    /**
+     * 拉取目录：同名多版本去重取最大 version。
+     * 同一时刻只保留最新一次加载：新的 load / reload / setProvider / abort 会取消上一次（abort 其请求并丢弃其结果）；
+     * 传入的 signal 被 abort 时同样取消。网络错误记为 error 状态，不抛出。
+     */
+    load(signal?: AbortSignal): Promise<void>;
+    /** 重新加载（供 UI「点击重试」使用） */
+    reload(): Promise<void>;
+    /** 取消进行中的加载（组件卸载时调用）；已加载的数据保留 */
+    abort(): void;
+    latest(name: string): LibraryEntry | undefined;
+    entries(): LibraryEntry[];
+    /** Provider 提供的原子任务定义 */
+    tasks(): LibraryTaskRecord[];
+    /** 静态 Schema（Provider 未覆盖的部分由 projections 合并） */
+    staticTaskSchemas(): TaskSchema[];
+    /**
+     * 取指定版本的完整定义（历史版本按需获取并缓存）。
+     * 找不到返回 null；网络错误向上抛出，由调用方决定如何提示。
+     */
+    getVersion(name: string, version: number, signal?: AbortSignal): Promise<LibraryWorkflowRecord | null>;
+    /**
+     * 服务端检索。Provider 未实现 search 时返回 null，调用方应退回本地匹配。
+     * 结果不并入目录（只是一次查询的命中）。
+     */
+    search(query: string, opts?: LibrarySearchOptions, signal?: AbortSignal): Promise<LibraryEntry[] | null>;
+    getSnapshot: () => LibraryCatalogSnapshot;
+    subscribe: (listener: () => void) => (() => void);
+    private warnLossy;
+    /** Provider 条目优先，静态条目补充同名之外的部分 */
+    private rebuild;
+    private setState;
+}

package/dist/library/conductorProvider.d.ts

@@ -0,0 +1,41 @@
+import type { WorkflowDef } from '../types/conductor';
+import type { RegisteredTaskDef } from '../actions/fromDefinitions';
+import type { LibraryExtension, LibraryProvider } from './types';
+export interface ConductorLibraryProviderOptions {
+    /** Conductor API 根地址，如 `https://conductor.example.com/api`（尾部斜杠可有可无） */
+    baseUrl: string;
+    /**
+     * 认证头等，由宿主在每次请求前注入（组件库不保存任何凭据）。
+     * 可返回 Promise，便于异步刷新 token。
+     */
+    headers?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** 自定义 fetch（测试 / 网关封装）；缺省使用全局 fetch */
+    fetch?: typeof fetch;
+    /** 是否同时拉取已注册的原子任务定义（`/metadata/taskdefs`），默认 false */
+    includeTaskDefs?: boolean;
+    /** 只暴露「流程库」内的工作流（如按名前缀 / ownerEmail）；对列表与单个获取都生效 */
+    filter?: (def: WorkflowDef) => boolean;
+    /** 补充字段（层级、分类、图标、是否下线等）的来源由宿主决定 */
+    resolveExtension?: (def: WorkflowDef) => LibraryExtension | undefined;
+    /** 原子任务的补充字段来源（仅 includeTaskDefs 时使用） */
+    resolveTaskExtension?: (def: RegisteredTaskDef) => LibraryExtension | undefined;
+    /**
+     * 网关路径不同可覆盖（相对 baseUrl）。
+     * `workflow` 为单个工作流的路径：含 `{name}` 时按模板替换，否则在其后追加 `/{name}`。
+     */
+    paths?: {
+        workflows?: string;
+        workflow?: string;
+        taskDefs?: string;
+    };
+}
+/**
+ * Conductor OSS 默认的流程库数据源：
+ * - `GET {baseUrl}/metadata/workflow`            列出工作流（同名多版本时客户端取最大 version）
+ * - `GET {baseUrl}/metadata/workflow/{name}?version={v}`  取指定版本，404 返回 null
+ * - `GET {baseUrl}/metadata/taskdefs`            已注册任务（includeTaskDefs 时）
+ *
+ * 不内置 `search`（Conductor OSS 元数据接口没有检索能力）；需要服务端检索请自行实现 LibraryProvider。
+ * 网络错误 / 非 404 的 HTTP 错误会抛出，由目录层捕获为 `error` 状态。
+ */
+export declare function createConductorLibraryProvider(options: ConductorLibraryProviderOptions): LibraryProvider;

package/dist/library/diff.d.ts

@@ -0,0 +1,62 @@
+import type { WorkflowDef } from '../types/conductor';
+import type { ActionField } from '../actions/types';
+/**
+ * 流程库能力升级差异（纯函数）：对比旧、新两个版本的入参 / 出参，
+ * 让用户在确认升级前看清「哪些已填内容会受影响」。
+ */
+export interface InputChange {
+    key: string;
+    /** 旧版本的类型描述，如「数字，必填」「可选值 a|b」 */
+    from: string;
+    /** 新版本的类型描述 */
+    to: string;
+    /** 该入参是否已填写过值（类型变化后已填值可能不再有效） */
+    valueFilled: boolean;
+}
+export interface WorkflowVersionDiff {
+    /** 新增入参（field.required 标出必填） */
+    addedInputs: ActionField[];
+    /** 删除的入参 */
+    removedInputs: ActionField[];
+    /** 类型 / 枚举 / 必填变化 */
+    changedInputs: InputChange[];
+    addedOutputs: string[];
+    removedOutputs: string[];
+    /** removedInputs 中已填值的 key：升级后这些值将丢失 */
+    lostValueKeys: string[];
+    /** removedOutputs 中被其它步骤引用的 key：升级后下游引用将失效 */
+    brokenOutputRefs: string[];
+}
+export interface DiffOptions {
+    /** 其它步骤中引用了本步骤哪些出参 key（见 collectReferencedOutputKeys）；缺省视为没有引用 */
+    referencedOutputs?: Iterable<string>;
+}
+/**
+ * @param oldDef       步骤当前固定版本的定义
+ * @param newDef       目录最新版本的定义
+ * @param filledValues 步骤上已填写的入参值
+ */
+export declare function diffWorkflowVersions(oldDef: WorkflowDef, newDef: WorkflowDef, filledValues?: Record<string, unknown>, options?: DiffOptions): WorkflowVersionDiff;
+/** 没有任何入参 / 出参变化 */
+export declare function isDiffEmpty(diff: WorkflowVersionDiff): boolean;
+/**
+ * 在若干结构（其它步骤的入参值等）中查找对 `${ref.output.<key>...}` 的引用，返回被引用的出参 key。
+ * 用于判断升级删除某个出参后，下游引用是否会失效。
+ */
+export declare function collectReferencedOutputKeys(taskReferenceName: string, parts: unknown[]): Set<string>;
+export interface DiffSummary {
+    /** 会影响已填内容的条目（置顶显示） */
+    impacts: string[];
+    /** 其它变化 */
+    changes: string[];
+}
+/** 把差异整理为面向用户的文字条目：会影响已填内容的置顶 */
+export declare function summarizeDiff(diff: WorkflowVersionDiff): DiffSummary;
+/** 升级确认框文案（含升级差异）。无差异时提示「入参出参未变化」。 */
+export declare function buildUpgradeConfirmMessage(name: string, pinned: number | undefined, latest: number, diff: WorkflowVersionDiff): string;
+/**
+ * 升级后调整步骤已填的入参值：
+ * - 删除的入参：移除其值（与差异中「值将丢失」一致）
+ * - 新增且有默认值的入参：补上默认值（用户已填的不覆盖）
+ */
+export declare function applyUpgradeToValues(values: Record<string, any>, diff: WorkflowVersionDiff): Record<string, any>;

package/dist/library/index.d.ts

@@ -0,0 +1,16 @@
+export * from './types';
+export { normalizeVersion } from './version';
+export type { NormalizedVersion } from './version';
+export { canCallLevel } from './level';
+export { parseWorkflowName, validateWorkflowName, WORKFLOW_NAME_TYPES } from './naming';
+export type { ParsedWorkflowName, WorkflowNameType } from './naming';
+export { LibraryCatalog, entryFromRecord } from './catalog';
+export type { LibraryEntry, LibraryCatalogSnapshot, LibraryCatalogOptions } from './catalog';
+export { toActions, toActionExtension, toTaskSchemas, toLibraryItems, entriesToLibraryItems, filterPickableActions, libraryDomainOf, collectLibraryDomains, OTHER_DOMAIN, schemaToTypeStrings, } from './projections';
+export { useLibraryCatalogSnapshot, useLibraryCatalogLoader } from './useLibraryCatalog';
+export { createConductorLibraryProvider } from './conductorProvider';
+export type { ConductorLibraryProviderOptions } from './conductorProvider';
+export { diffWorkflowVersions, isDiffEmpty, summarizeDiff, buildUpgradeConfirmMessage, applyUpgradeToValues, collectReferencedOutputKeys, } from './diff';
+export type { WorkflowVersionDiff, InputChange, DiffOptions, DiffSummary } from './diff';
+export { resolveLibraryBadgeState, describeUnavailable } from './versionStatus';
+export type { LibraryBadgeState, LibraryBadgeInputs } from './versionStatus';

package/dist/library/level.d.ts

@@ -0,0 +1,6 @@
+import type { WorkflowLevel } from '../types/workflowLibrary';
+/**
+ * 分层调用规则：高层可调用低层及同层，禁止反向跨层。
+ * L3 -> L3/L2/L1；L2 -> L2/L1；L1 -> L1。任一方层级未知时视为允许（不做限制）。
+ */
+export declare function canCallLevel(caller: WorkflowLevel | undefined, callee: WorkflowLevel | undefined): boolean;

package/dist/library/naming.d.ts

@@ -0,0 +1,28 @@
+import type { WorkflowLevel } from '../types/workflowLibrary';
+/**
+ * 治理平台的流程命名规范：`类型-层级-业务域-产品-功能`，以 `-` 分隔。
+ * - 类型：std（通用）/ proxy（代理）/ tmp（临时，自动清理）/ custom（自定义）
+ * - 层级：L1 / L2 / L3
+ * - 业务域：来自全局可调整的列表（由服务端提供，这里不写死，只当字符串处理）
+ * - 产品：自由名称（内部不含 `-`）
+ * - 功能：第 4 个 `-` 之后的全部内容（自身可含 `-`）
+ */
+export type WorkflowNameType = 'std' | 'proxy' | 'tmp' | 'custom';
+export interface ParsedWorkflowName {
+    type: WorkflowNameType;
+    level: WorkflowLevel;
+    domain: string;
+    product: string;
+    func: string;
+}
+export declare const WORKFLOW_NAME_TYPES: readonly WorkflowNameType[];
+/**
+ * 解析流程名称。段数不足 5、类型或层级不合法时返回 null（不抛错）。
+ * 业务域 / 产品 / 功能只做切分，不在此校验是否为空或是否在白名单内（见 validateWorkflowName）。
+ */
+export declare function parseWorkflowName(name: string): ParsedWorkflowName | null;
+/**
+ * 校验流程名称，返回中文错误列表（空数组 = 合法）。
+ * 仅当提供 allowedDomains 时才校验业务域是否在列表内。
+ */
+export declare function validateWorkflowName(name: string, allowedDomains?: string[]): string[];

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/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>