@yiyi_zhang/reactflow-ui 1.1.0 → 1.2.0

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>