@arronqzy/blueprint-dsl 1.0.8 → 1.0.10

package/dist/index.d.cts

@@ -0,0 +1,778 @@
+type Value = any;
+type PortSpec = {
+    name: string;
+    kind: "data" | "flow";
+    optional?: boolean;
+};
+type NodeDefinition = {
+    type: string;
+    inputs: PortSpec[];
+    outputs: PortSpec[];
+    behavior: {
+        kind: "js" | "blueprint";
+        ref: string;
+    };
+};
+type ExecutionToken = {
+    tokenId: string;
+    nodeId: string;
+    nodeType: string;
+    inPort: string;
+    scope: Scope;
+    correlationId?: string;
+};
+type Scope = {
+    parent?: Scope;
+    vars: Map<string, Value>;
+};
+
+/** 页面生命周期阶段 */
+declare const PAGE_LIFECYCLE_PHASES: readonly ["created", "beforeMount", "mounted", "updated", "beforeDestroy", "destroy", "activated", "deactivated", "blueprintActivated"];
+type PageLifecyclePhase = (typeof PAGE_LIFECYCLE_PHASES)[number];
+type LifecycleSignal = {
+    /** 触发的生命周期枚举 */
+    phase: PageLifecyclePhase;
+    /** 触发时刻（Unix 毫秒时间戳） */
+    timestamp: number;
+    /** ISO 8601 时间字符串，便于下游节点展示或日志 */
+    isoTime: string;
+};
+declare const PAGE_LIFECYCLE_LABELS: Record<PageLifecyclePhase, string>;
+declare function createLifecycleSignal(phase: PageLifecyclePhase): LifecycleSignal;
+
+/** 真信号：节点正常执行完成时的输出 */
+type TrueSignal<T = Value> = {
+    kind: "true";
+    value: T;
+    timestamp: number;
+    isoTime: string;
+};
+/** 假信号：节点执行出错时的输出 */
+type FalseSignal = {
+    kind: "false";
+    error: string;
+    timestamp: number;
+    isoTime: string;
+};
+type NodeSignal<T = Value> = TrueSignal<T> | FalseSignal;
+declare function isTrueSignal<T = Value>(signal: unknown): signal is TrueSignal<T>;
+declare function isFalseSignal(signal: unknown): signal is FalseSignal;
+declare function createTrueSignal<T = Value>(value: T): TrueSignal<T>;
+declare function createFalseSignal(error: string): FalseSignal;
+/**
+ * 同一输入端口连 n 条线时的「或」语义：任一为真则端口为真；
+ * 若无真且存在假信号则合并为假；全无连线则为 undefined。
+ */
+declare function combinePortSignalsOr(values: Array<Value | undefined>): Value | undefined;
+
+/** 嵌套蓝图执行完成后各节点的端口输出 */
+type BlueprintNodeOutputs = Record<string, Record<string, Value>>;
+/** 蓝图引用节点真信号携带的输出值 */
+type BlueprintRefOutput = {
+    nodeId: string;
+    nodeType: string;
+    libraryBlueprintId: string;
+    blueprintName?: string;
+    /** 嵌套蓝图各节点 out 端口的信号输出 */
+    nestedOutputs: BlueprintNodeOutputs;
+};
+
+type BehaviorContext = {
+    token: ExecutionToken;
+    io: {
+        getInput(name: string): Promise<Value>;
+        setOutput(name: string, value: Value): void;
+        emitFlow(port?: string): void;
+    };
+};
+type BehaviorFn = (ctx: BehaviorContext) => Promise<void>;
+
+type JSBehavior = {
+    kind: "js";
+    run: BehaviorFn;
+};
+type BlueprintBehavior = {
+    kind: "blueprint";
+    blueprintId: string;
+};
+type Behavior = JSBehavior | BlueprintBehavior;
+declare class BehaviorRegistry {
+    private map;
+    registerJS(id: string, fn: BehaviorFn): void;
+    registerBlueprint(id: string, blueprintId: string): void;
+    get(id: string): Behavior;
+}
+
+type ExecutorDeps = {
+    getNodeDefinition(type: string): NodeDefinition;
+    behaviors: BehaviorRegistry;
+    runBlueprint: (args: {
+        blueprintId: string;
+        token: ExecutionToken;
+    }) => Promise<void>;
+    getInputValue: (token: ExecutionToken, port: string) => Promise<Value>;
+    setNodeOutput: (token: ExecutionToken, port: string, value: Value) => void;
+    emitFlow: (token: ExecutionToken, outPort: string) => void;
+};
+declare class Executor {
+    private deps;
+    constructor(deps: ExecutorDeps);
+    executeToken(token: ExecutionToken): Promise<void>;
+}
+
+declare const LIFECYCLE_SIGNAL_KEY = "__lifecycleSignal";
+declare const BLUEPRINT_ACTIVATION_INPUT_KEY = "__blueprintActivationInput";
+declare const UI_EVENT_PAYLOAD_KEY = "__uiEventPayload";
+declare const VIEW_EVENT_SIGNAL_KEY = "__viewEventSignal";
+declare function registerDefaultBehaviors(registry: BehaviorRegistry): void;
+
+type SwaggerApiEndpoint = {
+    method: FetchHttpMethod;
+    path: string;
+    summary?: string;
+    operationId?: string;
+};
+type ParsedSwaggerDocument = {
+    apiBaseUrl: string;
+    endpoints: SwaggerApiEndpoint[];
+};
+declare function parseSwaggerDocument(spec: unknown, docsUrl: string): ParsedSwaggerDocument;
+declare function buildEndpointFullUrl(apiBaseUrl: string, pathOrEndpoint: string | Pick<SwaggerApiEndpoint, "path">): string;
+declare function buildEndpointSuggestions(apiBaseUrl: string, endpoints: SwaggerApiEndpoint[]): {
+    fullUrl: string;
+    label: string;
+    method: FetchHttpMethod;
+    path: string;
+    summary?: string;
+    operationId?: string;
+}[];
+declare function filterEndpointSuggestions(suggestions: ReturnType<typeof buildEndpointSuggestions>, query: string): {
+    fullUrl: string;
+    label: string;
+    method: FetchHttpMethod;
+    path: string;
+    summary?: string;
+    operationId?: string;
+}[];
+
+declare const FETCH_HTTP_METHODS: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
+type FetchHttpMethod = (typeof FETCH_HTTP_METHODS)[number];
+declare const FETCH_RESPONSE_TYPES: readonly ["json", "text"];
+type FetchResponseType = (typeof FETCH_RESPONSE_TYPES)[number];
+declare const FETCH_CREDENTIALS: readonly ["omit", "same-origin", "include"];
+declare const FETCH_MODES: readonly ["cors", "no-cors", "same-origin", "navigate"];
+declare const FETCH_CACHES: readonly ["default", "no-store", "reload", "no-cache", "force-cache", "only-if-cached"];
+declare const FETCH_REDIRECTS: readonly ["follow", "error", "manual"];
+type FetchUrlInputMode = "swagger" | "manual";
+type FetchRequestConfig = {
+    url: string;
+    method?: FetchHttpMethod;
+    headers?: Record<string, string>;
+    /**
+     * 请求头编辑器原文。可写 JSON，也可整段写成 `{scope?...}`。
+     * 运行时优先按该字段解析，避免未加引号的模板在 JSON.parse 时被丢掉。
+     */
+    headersJson?: string;
+    body?: string;
+    credentials?: RequestCredentials;
+    mode?: RequestMode;
+    cache?: RequestCache;
+    redirect?: RequestRedirect;
+    responseType?: FetchResponseType;
+    timeoutMs?: number;
+    /** Swagger / OpenAPI 文档 JSON 地址 */
+    swaggerDocsUrl?: string;
+    /** API 主机或基础路径，可与接口 path 组合 */
+    apiBaseUrl?: string;
+    /** 从 Swagger 文档解析出的接口列表 */
+    swaggerEndpoints?: SwaggerApiEndpoint[];
+    /** 请求 URL 输入方式：接口联想或手动输入 */
+    urlInputMode?: FetchUrlInputMode;
+};
+declare const DEFAULT_FETCH_REQUEST_CONFIG: FetchRequestConfig;
+/** 合并默认项与节点上保存的 fetch 配置，供运行时发起请求 */
+declare function normalizeFetchRequestConfig(config?: FetchRequestConfig): FetchRequestConfig;
+type FetchResultValue = {
+    status: number;
+    statusText: string;
+    url: string;
+    data: unknown;
+};
+/** 解析 fetch 节点的最终请求 URL，避免对已有主机信息的地址重复拼接 apiBaseUrl */
+declare function resolveFetchRequestUrl(config: Pick<FetchRequestConfig, "url" | "apiBaseUrl">): string;
+type ExecuteFetchOptions = {
+    signal?: AbortSignal;
+    /** 调试模式下 HTTP 非 2xx 仍返回响应体，不抛错 */
+    allowHttpError?: boolean;
+};
+declare function executeFetch(config: FetchRequestConfig, options?: ExecuteFetchOptions): Promise<FetchResultValue>;
+
+declare function hasScopeTemplate(value: string): boolean;
+declare function evaluateScopeExpression(expression: string, scope: unknown): unknown;
+declare function stringifyScopeValue(value: unknown): string;
+/** 将 `{scope?.a}` 替换为求值结果；无模板时原样返回 */
+declare function evaluateScopeTemplate(template: string, scope: unknown): string;
+/**
+ * 在 JSON 文本中替换 `{scope?...}`：
+ * - 位于字符串内时写入转义后的内容
+ * - 位于值位置时写入 JSON 字面量（对象/数组/字符串/数字）
+ */
+declare function evaluateScopeTemplateInJson(template: string, scope: unknown): string;
+declare function looksLikeJsonText(text: string): boolean;
+
+type ScopeAutocompleteState = {
+    templateStart: number;
+    cursor: number;
+    path: string[];
+    partialKey: string;
+};
+/** 解析光标处未闭合的 scope 模版表达式 */
+declare function parseScopeAutocomplete(text: string, cursor: number, scope: unknown): ScopeAutocompleteState | null;
+declare function getScopeAutocompleteSuggestions(scope: unknown, state: ScopeAutocompleteState): string[];
+declare function buildScopeExpression(path: string[], selectedKey: string): string;
+declare function applyScopeAutocompleteSelection(text: string, state: ScopeAutocompleteState, selectedKey: string): {
+    value: string;
+    cursor: number;
+};
+
+type IncomingNodeSource = {
+    id: string;
+    label?: string;
+    name?: string;
+    nodeType?: string;
+    type?: string;
+    role?: string;
+};
+type IncomingGraphEdge = {
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+};
+type IncomingNodeScopeEntry = {
+    id: string;
+    name: string;
+    type: string;
+    role?: string;
+    port: string;
+    kind: "true" | "false" | "pending";
+    value?: unknown;
+    error?: string;
+    timestamp?: number;
+    isoTime?: string;
+};
+type IncomingNodeScope = IncomingNodeScopeEntry | Record<string, IncomingNodeScopeEntry>;
+/** 尚无上游数据时，仍可联想 scope 的固定字段 */
+declare const FETCH_SCOPE_AUTOCOMPLETE_FALLBACK: IncomingNodeScopeEntry;
+declare function resolveFetchScopeAutocompleteRoot(scope: unknown): unknown;
+declare function createIncomingNodeScopeEntry(node: IncomingNodeSource | undefined, port: string, output: unknown): IncomingNodeScopeEntry;
+declare function buildIncomingNodeScope(entries: IncomingNodeScopeEntry[]): IncomingNodeScope | undefined;
+declare function collectIncomingNodeScopeEntries(options: {
+    targetNodeId: string;
+    targetPort?: string;
+    nodes: IncomingNodeSource[];
+    edges: IncomingGraphEdge[];
+    getOutput?: (nodeId: string, port: string) => unknown;
+}): IncomingNodeScopeEntry[];
+declare function resolveFetchIncomingScope(options: {
+    fetchNodeId: string;
+    inputPort?: string;
+    nodes: IncomingNodeSource[];
+    edges: IncomingGraphEdge[];
+    getOutput?: (nodeId: string, port: string) => unknown;
+    fallbackInput?: unknown;
+}): IncomingNodeScope | undefined;
+declare function latestTraceOutputsByNode(entries: Array<{
+    nodeId: string;
+    outputs?: Record<string, unknown>;
+}>): Record<string, Record<string, unknown>>;
+declare function parseJsonText(text: string): {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+declare function validateFetchJsonText(text: string, options?: {
+    allowEmpty?: boolean;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+declare function resolveFetchBody(body: string | undefined, scope?: unknown): string | undefined;
+declare function getFetchBodyValidationError(body: string | undefined, resolvedBody?: string): string | null;
+declare function getFetchHeadersValidationError(config: FetchRequestConfig, scope?: unknown): string | null;
+/** `{scope?...}` 整段表达式，区别于 JSON 对象 `{ "Authorization": "..." }` */
+declare function isWholeScopeExpression(text: string): boolean;
+/** 将请求头编辑器原文解析为对象；支持 JSON 内模板，也支持整段 `{scope?...}` */
+declare function parseFetchHeadersJson(text: string, scope?: unknown): Record<string, string> | undefined;
+declare function draftFetchHeadersText(config: FetchRequestConfig): string;
+declare function resolveFetchHeaders(config: FetchRequestConfig, scope?: unknown): Record<string, string> | undefined;
+/** 用上游 scope 解析 fetch 表单中的 URL / Base URL / headers / body */
+declare function applyFetchConfigScope(config: FetchRequestConfig, scope: unknown): FetchRequestConfig;
+declare function fetchConfigHasScopeTemplate(config: FetchRequestConfig): boolean;
+
+type JsonNodeConfig = {
+    jsonString: string;
+};
+declare const DEFAULT_JSON_NODE_CONFIG: JsonNodeConfig;
+declare function validateJsonString(jsonString: string): {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+declare function parseJsonConfig(config: JsonNodeConfig): unknown;
+
+type StorageKind = "session" | "local";
+type StorageReadConfig = {
+    storage: StorageKind;
+    key: string;
+};
+type StorageSetConfig = {
+    storages: StorageKind[];
+    key: string;
+    value: string;
+};
+type StorageNodeConfig = {
+    read: StorageReadConfig;
+    set: StorageSetConfig;
+};
+declare const STORAGE_KINDS: StorageKind[];
+declare const DEFAULT_STORAGE_NODE_CONFIG: StorageNodeConfig;
+type WebStorageLike = {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+};
+type StorageAccessors = {
+    session?: WebStorageLike | null;
+    local?: WebStorageLike | null;
+};
+declare function uniqueStorageKinds(kinds?: readonly unknown[]): StorageKind[];
+declare function normalizeStorageConfig(config?: Partial<StorageNodeConfig> | null): StorageNodeConfig;
+declare function isStorageReadConfigured(config: Pick<StorageNodeConfig, "read">): boolean;
+declare function isStorageSetConfigured(config: Pick<StorageNodeConfig, "set">): boolean;
+declare function resolveStorageWriteValue(template: string, scope: unknown): unknown;
+declare function serializeStorageValue(value: unknown): string;
+declare function deserializeStorageValue(raw: string | null): unknown;
+/** 先设置再读取。未配置设置则不写入；未配置读取则返回空。 */
+declare function executeStorageConfig(config: StorageNodeConfig, incomingScope: unknown, accessors?: StorageAccessors | null): unknown;
+
+type LogicNodeConfig = {
+    /** 用户手写的 update(input) 函数脚本 */
+    sourceCode: string;
+};
+declare const DEFAULT_LOGIC_NODE_CONFIG: LogicNodeConfig;
+declare function validateLogicSourceCode(sourceCode: string): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+declare function executeLogicConfig(config: LogicNodeConfig, input: unknown): unknown;
+
+type ClockNodeConfig = {
+    /** 两次输出之间的间隔秒数 */
+    intervalSeconds: number;
+    /** 输出值中的时间格式化模板，支持 YYYY、MM、DD、HH、mm、ss */
+    timeFormat: string;
+    /** 收到真信号后的输出次数，默认 1 */
+    outputCount: number;
+    /** 收到真信号后立即输出第一次，再按间隔继续；关闭则首次也等待 n 秒 */
+    emitImmediately: boolean;
+};
+type ClockSignalOutput = {
+    /** 按 timeFormat 格式化后的当前时间 */
+    formatted: string;
+    /** Unix 毫秒时间戳 */
+    timestamp: number;
+    /** ISO 8601 时间字符串 */
+    isoTime: string;
+};
+declare const DEFAULT_CLOCK_NODE_CONFIG: ClockNodeConfig;
+declare function normalizeClockConfig(config?: Partial<ClockNodeConfig> | null): ClockNodeConfig;
+declare function validateClockScheduleConfig(config: ClockNodeConfig): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** 将 Date 格式化为指定模板（YYYY/MM/DD/HH/mm/ss） */
+declare function formatClockTime(date: Date, pattern: string): string;
+declare function buildClockSignalValue(config: ClockNodeConfig, now?: Date): ClockSignalOutput;
+/**
+ * 第 tickIndex 次输出（从 0 起）相对调度起点的目标延迟（毫秒）。
+ * - 立即发送且次数 > 1：第 1 次为 0，其余依次为 m、2m…
+ * - 未立即发送：依次为 m、2m、3m…
+ */
+declare function getClockTickDelayOffsetMs(config: ClockNodeConfig, tickIndex: number): number;
+/** 距离第 tickIndex 次输出还应等待的毫秒数（基于调度起点） */
+declare function getClockTickWaitMs(config: ClockNodeConfig, tickIndex: number, scheduleStartMs: number, nowMs?: number): number;
+/** 停止指定会话的时钟调度 */
+declare function stopClockSchedule(sessionKey: string): void;
+declare function isClockScheduleActive(sessionKey: string): boolean;
+/** 中止时钟：取消剩余 tick，并标记会话供下游传播循环检测 */
+declare function abortClockSession(sessionKey: string): void;
+declare function isClockSessionAborted(sessionKey: string): boolean;
+declare function clearClockSessionAbort(sessionKey: string): void;
+/**
+ * 按配置依次触发 onTick；新的调度会取消同 sessionKey 的上一次调度。
+ * 返回取消函数。
+ */
+declare function startClockSchedule(options: {
+    sessionKey: string;
+    config: ClockNodeConfig;
+    onTick: () => void | Promise<void>;
+    onSettled?: () => void;
+}): () => void;
+/** 停止全部时钟调度（如蓝图面板卸载时） */
+declare function stopAllClockSchedules(): void;
+
+/** 视图事件节点可监听的常用 DOM 事件 */
+declare const VIEW_EVENT_TYPES: readonly ["click", "dblclick", "contextmenu", "mouseenter", "mouseleave"];
+type ViewEventType = (typeof VIEW_EVENT_TYPES)[number];
+type ViewEventNodeConfig = {
+    /** 监听的事件类型，至少一项；默认 click */
+    eventTypes: ViewEventType[];
+};
+declare const DEFAULT_VIEW_EVENT_NODE_CONFIG: ViewEventNodeConfig;
+declare function isViewEventType(value: unknown): value is ViewEventType;
+declare function normalizeViewEventConfig(config?: Partial<ViewEventNodeConfig> | null): ViewEventNodeConfig;
+/** 可序列化的 DOM 事件快照（原生 Event 无法作为蓝图信号传递） */
+type ViewEventSnapshot = {
+    type: string;
+    timeStamp: number;
+    clientX?: number;
+    clientY?: number;
+    pageX?: number;
+    pageY?: number;
+    button?: number;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+};
+/** 触发该事件的视图节点摘要 */
+type ViewEventNodeSnapshot = {
+    id: string;
+    name?: string;
+    materialType?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    layerId?: string;
+};
+/** 事件节点向下游发出的真信号 value */
+type ViewEventSignal = {
+    /** 触发事件（可序列化快照） */
+    event: ViewEventSnapshot;
+    /** 触发节点 */
+    node: ViewEventNodeSnapshot;
+    /** 触发的事件类型 */
+    eventType: ViewEventType;
+};
+declare function snapshotDomEvent(event: {
+    type: string;
+    timeStamp?: number;
+    clientX?: number;
+    clientY?: number;
+    pageX?: number;
+    pageY?: number;
+    button?: number;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+}): ViewEventSnapshot;
+declare function snapshotViewEventNode(node: Partial<ViewEventNodeSnapshot> & {
+    id: string;
+}): ViewEventNodeSnapshot;
+declare function createViewEventSignal(input: {
+    event: ViewEventSnapshot;
+    node: ViewEventNodeSnapshot;
+    eventType: ViewEventType;
+}): ViewEventSignal;
+declare function collectArmedViewEventNodeIds(nodes: Array<{
+    id: string;
+    nodeType?: string;
+    lifecyclePhase?: string;
+}>, edges: Array<{
+    source: string;
+    target: string;
+}>, eventNodeType: string, lifecycleNodeType: string, firedPhases: ReadonlySet<string>): Set<string>;
+/** 仅收集已由生命周期注册的事件节点绑定 */
+declare function collectArmedViewEventBindings(nodes: Array<{
+    id: string;
+    nodeType?: string;
+    lifecyclePhase?: string;
+    viewElementIds?: string[];
+    eventConfig?: Partial<ViewEventNodeConfig> | null;
+}>, edges: Array<{
+    source: string;
+    target: string;
+}>, eventNodeType: string, lifecycleNodeType: string, firedPhases: ReadonlySet<string>): Map<string, Set<ViewEventType>>;
+declare function collectViewEventBindings(nodes: Array<{
+    id?: string;
+    nodeType?: string;
+    viewElementIds?: string[];
+    eventConfig?: Partial<ViewEventNodeConfig> | null;
+}>, eventNodeType: string, armedNodeIds?: ReadonlySet<string>): Map<string, Set<ViewEventType>>;
+
+type ExecutionTraceEntry = {
+    id: string;
+    nodeId: string;
+    nodeLabel?: string;
+    nodeType: string;
+    startedAt: number;
+    finishedAt: number;
+    isoTime: string;
+    inputs: Record<string, unknown>;
+    outputs: Record<string, unknown>;
+    error?: string;
+    /** 时钟节点第几次 tick（从 1 开始） */
+    clockTickIndex?: number;
+    /** 时钟节点本次调度总 tick 数 */
+    clockTickTotal?: number;
+};
+type ExecutionRunRecord = {
+    runId: string;
+    blueprintId: string | null;
+    blueprintName: string;
+    lifecycleNodeId: string;
+    lifecycleNodeLabel?: string;
+    lifecyclePhase?: string;
+    startedAt: number;
+    finishedAt?: number;
+    status: "running" | "completed" | "paused" | "failed";
+    entries: ExecutionTraceEntry[];
+};
+declare function serializeTraceValue(value: Value | undefined): unknown;
+declare function createTraceEntryId(): string;
+
+declare const BLUEPRINT_NODE_TYPE = "Blueprint";
+declare const DEFAULT_LOGIC_NODE_TYPE = "Logic";
+declare const LIFECYCLE_NODE_TYPE = "Lifecycle";
+declare const FETCH_NODE_TYPE = "DataFetch";
+declare const JSON_NODE_TYPE = "JsonNode";
+declare const STORAGE_NODE_TYPE = "StorageNode";
+declare const CLOCK_NODE_TYPE = "Clock";
+declare const AND_NODE_TYPE = "AndLogic";
+declare const VIEW_NODE_TYPE = "ViewBind";
+declare const EVENT_NODE_TYPE = "ViewEvent";
+/** 蓝图引用节点：单入单出，收到真信号后执行嵌套蓝图 */
+declare const blueprintNodeDefinition: NodeDefinition;
+declare const defaultLogicNodeDefinition: NodeDefinition;
+/** 生命周期钩子节点：无入流，触发后向下游发出真/假信号 */
+declare const lifecycleNodeDefinition: NodeDefinition;
+/** 数据源获取：收到真信号后发起 fetch，成功/失败输出对应信号 */
+declare const fetchNodeDefinition: NodeDefinition;
+/** JSON 解析：收到真信号后将配置的 JSON 转为 object 输出 */
+declare const jsonNodeDefinition: NodeDefinition;
+/** 存储节点：收到真信号后先写入再读取 sessionStorage / localStorage */
+declare const storageNodeDefinition: NodeDefinition;
+/** 时钟节点：收到真信号后按间隔输出含当前时间的真信号 */
+declare const clockNodeDefinition: NodeDefinition;
+/** 并运算：两路输入均为真时输出真信号；单端口多连线按「或」合并 */
+declare const andLogicNodeDefinition: NodeDefinition;
+/** 视图绑定节点：收到信号后为关联视图元素写入 scope，并向下游透传 */
+declare const viewBindNodeDefinition: NodeDefinition;
+/** 视图事件节点：输入必须来自生命周期节点，对应阶段触发后注册事件，视图事件发生时输出真信号 */
+declare const viewEventNodeDefinition: NodeDefinition;
+declare const nodeDefinitionRegistry: Record<string, NodeDefinition>;
+declare function getNodeDefinition(type: string): NodeDefinition;
+
+type RunnableGraphNode = {
+    id: string;
+    nodeType: string;
+    label?: string;
+    role?: string;
+    lifecyclePhase?: PageLifecyclePhase;
+    /** 蓝图库记录 id，Blueprint 节点引用嵌套蓝图时使用 */
+    libraryBlueprintId?: string;
+    blueprintName?: string;
+    /** 视图绑定节点关联的视图画布元素 id */
+    viewElementIds?: string[];
+    fetchConfig?: FetchRequestConfig;
+    jsonConfig?: JsonNodeConfig;
+    storageConfig?: StorageNodeConfig;
+    logicConfig?: LogicNodeConfig;
+    clockConfig?: ClockNodeConfig;
+    eventConfig?: ViewEventNodeConfig;
+};
+type RunnableGraphEdge = {
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+};
+type RunnableGraph = {
+    nodes: RunnableGraphNode[];
+    edges: RunnableGraphEdge[];
+    /** 为 true 时调试/执行不因假信号阻塞队列 */
+    allowFalseSignalPropagation?: boolean;
+};
+type LibraryBlueprintResolver = (libraryBlueprintId: string) => Promise<RunnableGraph | null>;
+type ViewScopeUpdateCallback = (viewElementIds: string[], scope: unknown) => void;
+type DebugProgressCallback = (entries: ExecutionTraceEntry[]) => void;
+declare class BlueprintGraphRunner {
+    private graph;
+    private behaviors;
+    private outputs;
+    private resolveLibraryBlueprint?;
+    private debugQueue;
+    private debugExecutor;
+    private traceEntries;
+    private debugHistory;
+    private rootLibraryBlueprintId?;
+    private resolveBlueprintName?;
+    private cycleValidated;
+    private debugProgressCallback;
+    private onViewScopeUpdate?;
+    constructor(graph: RunnableGraph, options?: {
+        resolveLibraryBlueprint?: LibraryBlueprintResolver;
+        rootLibraryBlueprintId?: string | null;
+        resolveBlueprintName?: (libraryBlueprintId: string) => string;
+        onViewScopeUpdate?: ViewScopeUpdateCallback;
+    });
+    ensureNoBlueprintCycle(): Promise<void>;
+    private injectedInputs;
+    /**
+     * 从视图交互触发指定蓝图节点：向该节点 in 口注入真信号并执行下游。
+     * payload 写入 scope（UI_EVENT_PAYLOAD_KEY）供 Logic 等节点读取。
+     */
+    triggerNode(nodeId: string, inputValue?: unknown): Promise<void>;
+    private runFromNodeWithUiPayload;
+    emitLifecycle(phase: PageLifecyclePhase): Promise<void>;
+    /**
+     * 嵌套蓝图被引用且父级传入真信号时，触发 blueprintActivated 生命周期节点，
+     * 并将父级输入值写入 scope 供节点输出。
+     */
+    emitBlueprintActivated(inputValue: unknown, parentScope?: Scope): Promise<void>;
+    /**
+     * 视图节点触发事件时，匹配已注册（上游生命周期已触发）且绑定了该元素、事件类型的事件节点，发出真信号。
+     */
+    emitViewEvent(payload: ViewEventSignal, armedNodeIds?: ReadonlySet<string>): Promise<void>;
+    /** 时钟节点单次输出：向下游传播含当前时间的真信号 */
+    propagateClockOutput(nodeId: string, parentScope?: Scope, sessionKey?: string): Promise<void>;
+    private clockScopeId;
+    private startClockSchedule;
+    /** 中止指定时钟节点：停止剩余 tick 与正在执行的下游任务 */
+    abortClockNode(nodeId: string): void;
+    /** 从所有无入流 signal 的节点开始执行（嵌套蓝图调用） */
+    runFromFlowEntries(parentScope?: Scope, options?: {
+        preserveOutputs?: boolean;
+    }): Promise<BlueprintNodeOutputs>;
+    getNodeOutputs(): BlueprintNodeOutputs;
+    getTraceEntries(): ExecutionTraceEntry[];
+    isDebugSessionActive(): boolean;
+    isDebugQueueEmpty(): boolean;
+    /** 调试过程中同步最新蓝图拓扑与节点配置 */
+    updateGraph(graph: RunnableGraph): void;
+    /**
+     * 按当前图结构重建待执行队列。
+     * 已有 trace 时，从最后执行的节点按最新出边重新入队；便于编辑连线后继续单步调试。
+     */
+    refreshPendingQueueFromLatestGraph(): void;
+    canDebugStepBack(): boolean;
+    debugStepBack(): boolean;
+    private captureDebugSnapshot;
+    private restoreDebugSnapshot;
+    private pushDebugSnapshot;
+    beginDebugSession(lifecycleNodeId: string): void;
+    /** 调试中修改生命周期阶段后，同步队列头部的 scope 信号 */
+    refreshDebugLifecycleScope(lifecycleNodeId: string): void;
+    private applyLifecycleScopeForNode;
+    clearDebugSession(): void;
+    debugStep(nodeLabelById?: Record<string, string>, onProgress?: DebugProgressCallback): Promise<{
+        done: boolean;
+        entry?: ExecutionTraceEntry;
+        haltedByFalseSignal?: boolean;
+    }>;
+    private notifyDebugProgress;
+    private awaitClockDelay;
+    private buildTraceInputsForNode;
+    private appendDebugTraceEntry;
+    private enqueueDebugTargets;
+    private runDebugTokenSubqueue;
+    private executeDebugToken;
+    /**
+     * 调试模式下执行完整时钟序列：等待 n 次输出（含间隔），
+     * 每次更新 trace / 画布高亮，并同步跑完当次下游链。
+     */
+    private executeClockScheduleForDebug;
+    isDebugHaltedByFalseOutput(nodeId?: string): boolean;
+    private isFalseOutputNode;
+    private haltDebugQueueOnFalseOutput;
+    debugRunAll(nodeLabelById?: Record<string, string>, onProgress?: DebugProgressCallback): Promise<ExecutionTraceEntry[]>;
+    private registerBlueprintRefBehavior;
+    private registerFetchBehavior;
+    private registerLogicBehavior;
+    private registerJsonBehavior;
+    private registerStorageBehavior;
+    private registerClockBehavior;
+    private registerAndBehavior;
+    private registerViewBindBehavior;
+    private runFromNode;
+    private createExecutor;
+    private findSignalEntryNodes;
+    private collectOutputs;
+    private requireNode;
+    /** 队列中的 token 可能是在节点改类型（如视图绑定）之前入队的，执行前与最新图对齐 */
+    private syncTokenFromGraph;
+    private syncDebugQueueWithLatestGraph;
+    private findSignalTargets;
+    private findInboundSignalEdges;
+    private buildFetchIncomingScope;
+    /** 单端口多连线：任一为真则视为真（或语义）；支持 triggerNode 注入的入口信号 */
+    private resolvePortInputValue;
+    private findInboundSignalEdge;
+    private getNodeOutput;
+    private setNodeOutput;
+}
+
+declare const BLUEPRINT_CALL_STACK_KEY = "__blueprintCallStack";
+declare class BlueprintCycleError extends Error {
+    readonly cycleIds: string[];
+    constructor(cycleIds: string[], message: string);
+}
+declare function collectBlueprintLibraryRefs(graph: RunnableGraph): string[];
+declare function formatBlueprintCycleMessage(cycleIds: string[], resolveName?: (libraryBlueprintId: string) => string): string;
+type BlueprintCycleCheckOptions = {
+    rootGraph: RunnableGraph;
+    /** 当前蓝图对应的蓝图库 id；工作区蓝图未入库时为 null */
+    rootLibraryBlueprintId?: string | null;
+    resolveLibraryBlueprint: LibraryBlueprintResolver;
+    resolveBlueprintName?: (libraryBlueprintId: string) => string;
+};
+type BlueprintCycleCheckResult = {
+    ok: true;
+} | {
+    ok: false;
+    cycleIds: string[];
+    message: string;
+};
+declare function detectBlueprintReferenceCycle(options: BlueprintCycleCheckOptions): Promise<BlueprintCycleCheckResult>;
+declare function assertNoBlueprintReferenceCycle(options: BlueprintCycleCheckOptions): Promise<void>;
+declare function resolveBlueprintCallStack(scopeStack: string[] | undefined, rootLibraryBlueprintId?: string | null): string[];
+declare function detectRuntimeBlueprintCycle(callStack: string[], targetLibraryBlueprintId: string, resolveName?: (libraryBlueprintId: string) => string): BlueprintCycleCheckResult;
+
+declare function buildClockSessionKey(scopeId: string, nodeId: string): string;
+declare function abortClockNode(scopeId: string, nodeId: string): void;
+declare function scheduleClockOutputs(options: {
+    sessionKey: string;
+    config: ClockNodeConfig;
+    onTick: () => void | Promise<void>;
+    onSettled?: () => void;
+}): () => void;
+
+declare function createClockOutputValue(config: ClockNodeConfig): ClockSignalOutput;
+
+declare function isClockNodeActive(nodeId: string): boolean;
+declare function getActiveClockNodeIds(): string[];
+declare function subscribeActiveClockNodes(listener: () => void): () => boolean;
+
+export { AND_NODE_TYPE, BLUEPRINT_ACTIVATION_INPUT_KEY, BLUEPRINT_CALL_STACK_KEY, BLUEPRINT_NODE_TYPE, type Behavior, type BehaviorContext, type BehaviorFn, BehaviorRegistry, type BlueprintCycleCheckOptions, type BlueprintCycleCheckResult, BlueprintCycleError, BlueprintGraphRunner, type BlueprintNodeOutputs, type BlueprintRefOutput, CLOCK_NODE_TYPE, type ClockNodeConfig, type ClockSignalOutput, DEFAULT_CLOCK_NODE_CONFIG, DEFAULT_FETCH_REQUEST_CONFIG, DEFAULT_JSON_NODE_CONFIG, DEFAULT_LOGIC_NODE_CONFIG, DEFAULT_LOGIC_NODE_TYPE, DEFAULT_STORAGE_NODE_CONFIG, DEFAULT_VIEW_EVENT_NODE_CONFIG, EVENT_NODE_TYPE, type ExecuteFetchOptions, type ExecutionRunRecord, type ExecutionToken, type ExecutionTraceEntry, Executor, type ExecutorDeps, FETCH_CACHES, FETCH_CREDENTIALS, FETCH_HTTP_METHODS, FETCH_MODES, FETCH_NODE_TYPE, FETCH_REDIRECTS, FETCH_RESPONSE_TYPES, FETCH_SCOPE_AUTOCOMPLETE_FALLBACK, type FalseSignal, type FetchHttpMethod, type FetchRequestConfig, type FetchResponseType, type FetchResultValue, type FetchUrlInputMode, type IncomingGraphEdge, type IncomingNodeScope, type IncomingNodeScopeEntry, type IncomingNodeSource, JSON_NODE_TYPE, type JsonNodeConfig, LIFECYCLE_NODE_TYPE, LIFECYCLE_SIGNAL_KEY, type LibraryBlueprintResolver, type LifecycleSignal, type LogicNodeConfig, type NodeDefinition, type NodeSignal, PAGE_LIFECYCLE_LABELS, PAGE_LIFECYCLE_PHASES, type PageLifecyclePhase, type ParsedSwaggerDocument, type PortSpec, type RunnableGraph, type RunnableGraphEdge, type RunnableGraphNode, STORAGE_KINDS, STORAGE_NODE_TYPE, type Scope, type ScopeAutocompleteState, type StorageAccessors, type StorageKind, type StorageNodeConfig, type StorageReadConfig, type StorageSetConfig, type SwaggerApiEndpoint, type TrueSignal, UI_EVENT_PAYLOAD_KEY, VIEW_EVENT_SIGNAL_KEY, VIEW_EVENT_TYPES, VIEW_NODE_TYPE, type Value, type ViewEventNodeConfig, type ViewEventNodeSnapshot, type ViewEventSignal, type ViewEventSnapshot, type ViewEventType, type ViewScopeUpdateCallback, type WebStorageLike, abortClockNode, abortClockSession, andLogicNodeDefinition, applyFetchConfigScope, applyScopeAutocompleteSelection, assertNoBlueprintReferenceCycle, blueprintNodeDefinition, buildClockSessionKey, buildClockSignalValue, buildEndpointFullUrl, buildEndpointSuggestions, buildIncomingNodeScope, buildScopeExpression, clearClockSessionAbort, clockNodeDefinition, collectArmedViewEventBindings, collectArmedViewEventNodeIds, collectBlueprintLibraryRefs, collectIncomingNodeScopeEntries, collectViewEventBindings, combinePortSignalsOr, createClockOutputValue, createFalseSignal, createIncomingNodeScopeEntry, createLifecycleSignal, createTraceEntryId, createTrueSignal, createViewEventSignal, defaultLogicNodeDefinition, deserializeStorageValue, detectBlueprintReferenceCycle, detectRuntimeBlueprintCycle, draftFetchHeadersText, evaluateScopeExpression, evaluateScopeTemplate, evaluateScopeTemplateInJson, executeFetch, executeLogicConfig, executeStorageConfig, fetchConfigHasScopeTemplate, fetchNodeDefinition, filterEndpointSuggestions, formatBlueprintCycleMessage, formatClockTime, getActiveClockNodeIds, getClockTickDelayOffsetMs, getClockTickWaitMs, getFetchBodyValidationError, getFetchHeadersValidationError, getNodeDefinition, getScopeAutocompleteSuggestions, hasScopeTemplate, isClockNodeActive, isClockScheduleActive, isClockSessionAborted, isFalseSignal, isStorageReadConfigured, isStorageSetConfigured, isTrueSignal, isViewEventType, isWholeScopeExpression, jsonNodeDefinition, latestTraceOutputsByNode, lifecycleNodeDefinition, looksLikeJsonText, nodeDefinitionRegistry, normalizeClockConfig, normalizeFetchRequestConfig, normalizeStorageConfig, normalizeViewEventConfig, parseFetchHeadersJson, parseJsonConfig, parseJsonText, parseScopeAutocomplete, parseSwaggerDocument, registerDefaultBehaviors, resolveBlueprintCallStack, resolveFetchBody, resolveFetchHeaders, resolveFetchIncomingScope, resolveFetchRequestUrl, resolveFetchScopeAutocompleteRoot, resolveStorageWriteValue, scheduleClockOutputs, serializeStorageValue, serializeTraceValue, snapshotDomEvent, snapshotViewEventNode, startClockSchedule, stopAllClockSchedules, stopClockSchedule, storageNodeDefinition, stringifyScopeValue, subscribeActiveClockNodes, uniqueStorageKinds, validateClockScheduleConfig, validateFetchJsonText, validateJsonString, validateLogicSourceCode, viewBindNodeDefinition, viewEventNodeDefinition };