@yiyi_zhang/reactflow-ui 1.2.0 → 1.3.1

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,67 @@
+/**
+ * 扩展点注册：统一的 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';
+    /** `email` 写入向导生成的骨架流程的 ownerEmail（可选） */
+    user: {
+        id: string;
+        name: string;
+        email?: 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;
+}