@arronqzy/blueprint-dsl 1.0.9 → 1.0.11

package/dist/index.d.cts

@@ -327,6 +327,47 @@ declare function validateJsonString(jsonString: 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;
+
+/**
+ * Isolate IndexedDB / localStorage / BroadcastChannel per App instance.
+ * Empty or omitted keeps the legacy global store names.
+ */
+declare function normalizeAppNameSpace(value?: string | null): string;
+declare function appStorageKey(base: string, nameSpace?: string | null): string;
+
 type LogicNodeConfig = {
     /** 用户手写的 update(input) 函数脚本 */
     sourceCode: string;
@@ -524,6 +565,7 @@ 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";
@@ -537,6 +579,8 @@ declare const lifecycleNodeDefinition: NodeDefinition;
 declare const fetchNodeDefinition: NodeDefinition;
 /** JSON 解析：收到真信号后将配置的 JSON 转为 object 输出 */
 declare const jsonNodeDefinition: NodeDefinition;
+/** 存储节点：收到真信号后先写入再读取 sessionStorage / localStorage */
+declare const storageNodeDefinition: NodeDefinition;
 /** 时钟节点：收到真信号后按间隔输出含当前时间的真信号 */
 declare const clockNodeDefinition: NodeDefinition;
 /** 并运算：两路输入均为真时输出真信号；单端口多连线按「或」合并 */
@@ -561,6 +605,7 @@ type RunnableGraphNode = {
     viewElementIds?: string[];
     fetchConfig?: FetchRequestConfig;
     jsonConfig?: JsonNodeConfig;
+    storageConfig?: StorageNodeConfig;
     logicConfig?: LogicNodeConfig;
     clockConfig?: ClockNodeConfig;
     eventConfig?: ViewEventNodeConfig;
@@ -674,6 +719,7 @@ declare class BlueprintGraphRunner {
     private registerFetchBehavior;
     private registerLogicBehavior;
     private registerJsonBehavior;
+    private registerStorageBehavior;
     private registerClockBehavior;
     private registerAndBehavior;
     private registerViewBindBehavior;
@@ -736,4 +782,4 @@ 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_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, type Scope, type ScopeAutocompleteState, 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, 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, detectBlueprintReferenceCycle, detectRuntimeBlueprintCycle, draftFetchHeadersText, evaluateScopeExpression, evaluateScopeTemplate, evaluateScopeTemplateInJson, executeFetch, executeLogicConfig, fetchConfigHasScopeTemplate, fetchNodeDefinition, filterEndpointSuggestions, formatBlueprintCycleMessage, formatClockTime, getActiveClockNodeIds, getClockTickDelayOffsetMs, getClockTickWaitMs, getFetchBodyValidationError, getFetchHeadersValidationError, getNodeDefinition, getScopeAutocompleteSuggestions, hasScopeTemplate, isClockNodeActive, isClockScheduleActive, isClockSessionAborted, isFalseSignal, isTrueSignal, isViewEventType, isWholeScopeExpression, jsonNodeDefinition, latestTraceOutputsByNode, lifecycleNodeDefinition, looksLikeJsonText, nodeDefinitionRegistry, normalizeClockConfig, normalizeFetchRequestConfig, normalizeViewEventConfig, parseFetchHeadersJson, parseJsonConfig, parseJsonText, parseScopeAutocomplete, parseSwaggerDocument, registerDefaultBehaviors, resolveBlueprintCallStack, resolveFetchBody, resolveFetchHeaders, resolveFetchIncomingScope, resolveFetchRequestUrl, resolveFetchScopeAutocompleteRoot, scheduleClockOutputs, serializeTraceValue, snapshotDomEvent, snapshotViewEventNode, startClockSchedule, stopAllClockSchedules, stopClockSchedule, stringifyScopeValue, subscribeActiveClockNodes, validateClockScheduleConfig, validateFetchJsonText, validateJsonString, validateLogicSourceCode, viewBindNodeDefinition, viewEventNodeDefinition };
+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, appStorageKey, 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, normalizeAppNameSpace, 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 };

package/dist/index.d.ts

@@ -327,6 +327,47 @@ declare function validateJsonString(jsonString: 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;
+
+/**
+ * Isolate IndexedDB / localStorage / BroadcastChannel per App instance.
+ * Empty or omitted keeps the legacy global store names.
+ */
+declare function normalizeAppNameSpace(value?: string | null): string;
+declare function appStorageKey(base: string, nameSpace?: string | null): string;
+
 type LogicNodeConfig = {
     /** 用户手写的 update(input) 函数脚本 */
     sourceCode: string;
@@ -524,6 +565,7 @@ 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";
@@ -537,6 +579,8 @@ declare const lifecycleNodeDefinition: NodeDefinition;
 declare const fetchNodeDefinition: NodeDefinition;
 /** JSON 解析：收到真信号后将配置的 JSON 转为 object 输出 */
 declare const jsonNodeDefinition: NodeDefinition;
+/** 存储节点：收到真信号后先写入再读取 sessionStorage / localStorage */
+declare const storageNodeDefinition: NodeDefinition;
 /** 时钟节点：收到真信号后按间隔输出含当前时间的真信号 */
 declare const clockNodeDefinition: NodeDefinition;
 /** 并运算：两路输入均为真时输出真信号；单端口多连线按「或」合并 */
@@ -561,6 +605,7 @@ type RunnableGraphNode = {
     viewElementIds?: string[];
     fetchConfig?: FetchRequestConfig;
     jsonConfig?: JsonNodeConfig;
+    storageConfig?: StorageNodeConfig;
     logicConfig?: LogicNodeConfig;
     clockConfig?: ClockNodeConfig;
     eventConfig?: ViewEventNodeConfig;
@@ -674,6 +719,7 @@ declare class BlueprintGraphRunner {
     private registerFetchBehavior;
     private registerLogicBehavior;
     private registerJsonBehavior;
+    private registerStorageBehavior;
     private registerClockBehavior;
     private registerAndBehavior;
     private registerViewBindBehavior;
@@ -736,4 +782,4 @@ 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_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, type Scope, type ScopeAutocompleteState, 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, 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, detectBlueprintReferenceCycle, detectRuntimeBlueprintCycle, draftFetchHeadersText, evaluateScopeExpression, evaluateScopeTemplate, evaluateScopeTemplateInJson, executeFetch, executeLogicConfig, fetchConfigHasScopeTemplate, fetchNodeDefinition, filterEndpointSuggestions, formatBlueprintCycleMessage, formatClockTime, getActiveClockNodeIds, getClockTickDelayOffsetMs, getClockTickWaitMs, getFetchBodyValidationError, getFetchHeadersValidationError, getNodeDefinition, getScopeAutocompleteSuggestions, hasScopeTemplate, isClockNodeActive, isClockScheduleActive, isClockSessionAborted, isFalseSignal, isTrueSignal, isViewEventType, isWholeScopeExpression, jsonNodeDefinition, latestTraceOutputsByNode, lifecycleNodeDefinition, looksLikeJsonText, nodeDefinitionRegistry, normalizeClockConfig, normalizeFetchRequestConfig, normalizeViewEventConfig, parseFetchHeadersJson, parseJsonConfig, parseJsonText, parseScopeAutocomplete, parseSwaggerDocument, registerDefaultBehaviors, resolveBlueprintCallStack, resolveFetchBody, resolveFetchHeaders, resolveFetchIncomingScope, resolveFetchRequestUrl, resolveFetchScopeAutocompleteRoot, scheduleClockOutputs, serializeTraceValue, snapshotDomEvent, snapshotViewEventNode, startClockSchedule, stopAllClockSchedules, stopClockSchedule, stringifyScopeValue, subscribeActiveClockNodes, validateClockScheduleConfig, validateFetchJsonText, validateJsonString, validateLogicSourceCode, viewBindNodeDefinition, viewEventNodeDefinition };
+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, appStorageKey, 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, normalizeAppNameSpace, 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 };

package/dist/index.js

@@ -810,6 +810,127 @@ function parseJsonConfig(config) {
   return result.value;
 }
 
+// src/storage-config.ts
+var STORAGE_KINDS = ["session", "local"];
+var DEFAULT_STORAGE_NODE_CONFIG = {
+  read: { storage: "local", key: "" },
+  set: { storages: [], key: "", value: "" }
+};
+function isStorageKind(value) {
+  return value === "session" || value === "local";
+}
+function uniqueStorageKinds(kinds) {
+  const next = /* @__PURE__ */ new Set();
+  for (const kind of kinds ?? []) {
+    if (isStorageKind(kind)) next.add(kind);
+  }
+  return STORAGE_KINDS.filter((kind) => next.has(kind));
+}
+function normalizeStorageConfig(config) {
+  const read = config?.read;
+  const set = config?.set;
+  return {
+    read: {
+      storage: read?.storage === "session" ? "session" : "local",
+      key: typeof read?.key === "string" ? read.key : ""
+    },
+    set: {
+      storages: uniqueStorageKinds(set?.storages),
+      key: typeof set?.key === "string" ? set.key : "",
+      value: typeof set?.value === "string" ? set.value : ""
+    }
+  };
+}
+function isStorageReadConfigured(config) {
+  return Boolean(config.read?.key?.trim());
+}
+function isStorageSetConfigured(config) {
+  return Boolean(config.set?.key?.trim()) && (config.set?.storages?.length ?? 0) > 0;
+}
+function resolveStorageWriteValue(template, scope) {
+  const raw = template ?? "";
+  const trimmed = raw.trim();
+  if (!trimmed) return "";
+  if (isWholeScopeExpression(trimmed)) {
+    const value = evaluateScopeExpression(trimmed.slice(1, -1), scope);
+    return value === void 0 ? "" : value;
+  }
+  if (hasScopeTemplate(raw)) {
+    return evaluateScopeTemplate(raw, scope);
+  }
+  return raw;
+}
+function serializeStorageValue(value) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function deserializeStorageValue(raw) {
+  if (raw === null) return null;
+  const trimmed = raw.trim();
+  if (!trimmed) return raw;
+  if (!looksLikeJsonText(trimmed)) return raw;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return raw;
+  }
+}
+function getDefaultStorageAccessors() {
+  if (typeof window === "undefined") return null;
+  try {
+    return {
+      session: window.sessionStorage,
+      local: window.localStorage
+    };
+  } catch {
+    return null;
+  }
+}
+function requireStorage(accessors, kind) {
+  const target = kind === "session" ? accessors?.session : accessors?.local;
+  if (!target) {
+    throw new Error(
+      kind === "session" ? "\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301 sessionStorage" : "\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301 localStorage"
+    );
+  }
+  return target;
+}
+function executeStorageConfig(config, incomingScope, accessors) {
+  const normalized = normalizeStorageConfig(config);
+  const store = accessors === void 0 ? getDefaultStorageAccessors() : accessors;
+  if (isStorageSetConfigured(normalized)) {
+    const value = resolveStorageWriteValue(normalized.set.value, incomingScope);
+    const serialized = serializeStorageValue(value);
+    const key = normalized.set.key.trim();
+    for (const kind of normalized.set.storages) {
+      requireStorage(store, kind).setItem(key, serialized);
+    }
+  }
+  if (!isStorageReadConfigured(normalized)) {
+    return null;
+  }
+  return deserializeStorageValue(
+    requireStorage(store, normalized.read.storage).getItem(
+      normalized.read.key.trim()
+    )
+  );
+}
+
+// src/app-namespace.ts
+function normalizeAppNameSpace(value) {
+  return (value ?? "").trim();
+}
+function appStorageKey(base, nameSpace) {
+  const ns = normalizeAppNameSpace(nameSpace);
+  if (!ns) return base;
+  return `${base}__${ns.slice(0, 120)}`;
+}
+
 // src/logic-config.ts
 var DEFAULT_LOGIC_NODE_CONFIG = {
   sourceCode: `function update(input) {
@@ -1242,6 +1363,7 @@ var DEFAULT_LOGIC_NODE_TYPE = "Logic";
 var LIFECYCLE_NODE_TYPE = "Lifecycle";
 var FETCH_NODE_TYPE = "DataFetch";
 var JSON_NODE_TYPE = "JsonNode";
+var STORAGE_NODE_TYPE = "StorageNode";
 var CLOCK_NODE_TYPE = "Clock";
 var AND_NODE_TYPE = "AndLogic";
 var VIEW_NODE_TYPE = "ViewBind";
@@ -1276,6 +1398,12 @@ var jsonNodeDefinition = {
   outputs: [{ name: "out", kind: "data" }],
   behavior: { kind: "js", ref: "json-parse-run" }
 };
+var storageNodeDefinition = {
+  type: STORAGE_NODE_TYPE,
+  inputs: [{ name: "in", kind: "data" }],
+  outputs: [{ name: "out", kind: "data" }],
+  behavior: { kind: "js", ref: "storage-run" }
+};
 var clockNodeDefinition = {
   type: CLOCK_NODE_TYPE,
   inputs: [{ name: "in", kind: "data" }],
@@ -1309,6 +1437,7 @@ var nodeDefinitionRegistry = {
   [LIFECYCLE_NODE_TYPE]: lifecycleNodeDefinition,
   [FETCH_NODE_TYPE]: fetchNodeDefinition,
   [JSON_NODE_TYPE]: jsonNodeDefinition,
+  [STORAGE_NODE_TYPE]: storageNodeDefinition,
   [CLOCK_NODE_TYPE]: clockNodeDefinition,
   [AND_NODE_TYPE]: andLogicNodeDefinition,
   [VIEW_NODE_TYPE]: viewBindNodeDefinition,
@@ -1495,6 +1624,7 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
     this.registerBlueprintRefBehavior();
     this.registerFetchBehavior();
     this.registerJsonBehavior();
+    this.registerStorageBehavior();
     this.registerLogicBehavior();
     this.registerClockBehavior();
     this.registerAndBehavior();
@@ -2325,6 +2455,48 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
       io.emitFlow("out");
     });
   }
+  registerStorageBehavior() {
+    const runner = this;
+    this.behaviors.registerJS("storage-run", async ({ token, io }) => {
+      const node = runner.requireNode(token.nodeId);
+      try {
+        const inputPort = token.inPort || "in";
+        const input = await io.getInput(inputPort);
+        if (isFalseSignal(input)) {
+          io.setOutput("out", input);
+          io.emitFlow("out");
+          return;
+        }
+        if (!isTrueSignal(input)) {
+          io.setOutput(
+            "out",
+            createFalseSignal("\u5B58\u50A8\u8282\u70B9\u9700\u8981\u6536\u5230\u771F\u4FE1\u53F7\u540E\u624D\u4F1A\u8BFB\u5199\u7F13\u5B58")
+          );
+          io.emitFlow("out");
+          return;
+        }
+        const incomingScope = runner.buildFetchIncomingScope(
+          token.nodeId,
+          inputPort,
+          input
+        );
+        const config = normalizeStorageConfig({
+          ...DEFAULT_STORAGE_NODE_CONFIG,
+          ...node.storageConfig
+        });
+        const value = executeStorageConfig(config, incomingScope);
+        io.setOutput("out", createTrueSignal(value));
+      } catch (error) {
+        io.setOutput(
+          "out",
+          createFalseSignal(
+            error instanceof Error ? error.message : String(error)
+          )
+        );
+      }
+      io.emitFlow("out");
+    });
+  }
   registerClockBehavior() {
     const runner = this;
     this.behaviors.registerJS("clock-run", async ({ token, io }) => {
@@ -2580,6 +2752,6 @@ var BlueprintGraphRunner = class _BlueprintGraphRunner {
   }
 };
 
-export { AND_NODE_TYPE, BLUEPRINT_ACTIVATION_INPUT_KEY, BLUEPRINT_CALL_STACK_KEY, BLUEPRINT_NODE_TYPE, BehaviorRegistry, BlueprintCycleError, BlueprintGraphRunner, CLOCK_NODE_TYPE, DEFAULT_CLOCK_NODE_CONFIG, DEFAULT_FETCH_REQUEST_CONFIG, DEFAULT_JSON_NODE_CONFIG, DEFAULT_LOGIC_NODE_CONFIG, DEFAULT_LOGIC_NODE_TYPE, DEFAULT_VIEW_EVENT_NODE_CONFIG, EVENT_NODE_TYPE, Executor, FETCH_CACHES, FETCH_CREDENTIALS, FETCH_HTTP_METHODS, FETCH_MODES, FETCH_NODE_TYPE, FETCH_REDIRECTS, FETCH_RESPONSE_TYPES, FETCH_SCOPE_AUTOCOMPLETE_FALLBACK, JSON_NODE_TYPE, LIFECYCLE_NODE_TYPE, LIFECYCLE_SIGNAL_KEY, PAGE_LIFECYCLE_LABELS, PAGE_LIFECYCLE_PHASES, UI_EVENT_PAYLOAD_KEY, VIEW_EVENT_SIGNAL_KEY, VIEW_EVENT_TYPES, VIEW_NODE_TYPE, 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, detectBlueprintReferenceCycle, detectRuntimeBlueprintCycle, draftFetchHeadersText, evaluateScopeExpression, evaluateScopeTemplate, evaluateScopeTemplateInJson, executeFetch, executeLogicConfig, fetchConfigHasScopeTemplate, fetchNodeDefinition, filterEndpointSuggestions, formatBlueprintCycleMessage, formatClockTime, getActiveClockNodeIds, getClockTickDelayOffsetMs, getClockTickWaitMs, getFetchBodyValidationError, getFetchHeadersValidationError, getNodeDefinition, getScopeAutocompleteSuggestions, hasScopeTemplate, isClockNodeActive, isClockScheduleActive, isClockSessionAborted, isFalseSignal, isTrueSignal, isViewEventType, isWholeScopeExpression, jsonNodeDefinition, latestTraceOutputsByNode, lifecycleNodeDefinition, looksLikeJsonText, nodeDefinitionRegistry, normalizeClockConfig, normalizeFetchRequestConfig, normalizeViewEventConfig, parseFetchHeadersJson, parseJsonConfig, parseJsonText, parseScopeAutocomplete, parseSwaggerDocument, registerDefaultBehaviors, resolveBlueprintCallStack, resolveFetchBody, resolveFetchHeaders, resolveFetchIncomingScope, resolveFetchRequestUrl, resolveFetchScopeAutocompleteRoot, scheduleClockOutputs, serializeTraceValue, snapshotDomEvent, snapshotViewEventNode, startClockSchedule, stopAllClockSchedules, stopClockSchedule, stringifyScopeValue, subscribeActiveClockNodes, validateClockScheduleConfig, validateFetchJsonText, validateJsonString, validateLogicSourceCode, viewBindNodeDefinition, viewEventNodeDefinition };
+export { AND_NODE_TYPE, BLUEPRINT_ACTIVATION_INPUT_KEY, BLUEPRINT_CALL_STACK_KEY, BLUEPRINT_NODE_TYPE, BehaviorRegistry, BlueprintCycleError, BlueprintGraphRunner, CLOCK_NODE_TYPE, 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, Executor, FETCH_CACHES, FETCH_CREDENTIALS, FETCH_HTTP_METHODS, FETCH_MODES, FETCH_NODE_TYPE, FETCH_REDIRECTS, FETCH_RESPONSE_TYPES, FETCH_SCOPE_AUTOCOMPLETE_FALLBACK, JSON_NODE_TYPE, LIFECYCLE_NODE_TYPE, LIFECYCLE_SIGNAL_KEY, PAGE_LIFECYCLE_LABELS, PAGE_LIFECYCLE_PHASES, STORAGE_KINDS, STORAGE_NODE_TYPE, UI_EVENT_PAYLOAD_KEY, VIEW_EVENT_SIGNAL_KEY, VIEW_EVENT_TYPES, VIEW_NODE_TYPE, abortClockNode, abortClockSession, andLogicNodeDefinition, appStorageKey, 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, normalizeAppNameSpace, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map