@arronqzy/blueprint-dsl 1.0.14 → 1.0.16

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference path="../vendor/dayjs/esm/locale/index.d.ts" />
 type Value = any;
 type PortSpec = {
     name: string;
@@ -163,7 +164,15 @@ 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 FetchUrlInputMode = "swagger" | "manual" | "collection";
+type ApiCollectionSyncNotice = {
+    source: "api-collection-sync";
+    collectionName: string;
+    endpointName: string;
+    /** 机器字段名：url / method / headers / body / apiBaseUrl */
+    changedFields: string[];
+    updatedAt: number;
+};
 type FetchRequestConfig = {
     url: string;
     method?: FetchHttpMethod;
@@ -186,8 +195,17 @@ type FetchRequestConfig = {
     apiBaseUrl?: string;
     /** 从 Swagger 文档解析出的接口列表 */
     swaggerEndpoints?: SwaggerApiEndpoint[];
-    /** 请求 URL 输入方式：接口联想或手动输入 */
+    /** 请求 URL 输入方式：接口联想、手动输入，或接口集合回填 */
     urlInputMode?: FetchUrlInputMode;
+    /** 接口集合记录 id（urlInputMode=collection） */
+    apiCollectionId?: string;
+    /** 集合内选中的接口名称 */
+    apiCollectionEndpointName?: string;
+    /**
+     * 接口集合同步后的配置区提示；用户可关闭。
+     * source 固定为 api-collection-sync，表示来源是数据集合更新。
+     */
+    apiCollectionSyncNotice?: ApiCollectionSyncNotice | null;
 };
 declare const DEFAULT_FETCH_REQUEST_CONFIG: FetchRequestConfig;
 /** 合并默认项与节点上保存的 fetch 配置，供运行时发起请求 */
@@ -207,29 +225,501 @@ type ExecuteFetchOptions = {
 };
 declare function executeFetch(config: FetchRequestConfig, options?: ExecuteFetchOptions): Promise<FetchResultValue>;
 
+declare function dayjs (date?: dayjs.ConfigType): dayjs.Dayjs
+
+declare function dayjs (date?: dayjs.ConfigType, format?: dayjs.OptionType, strict?: boolean): dayjs.Dayjs
+
+declare function dayjs (date?: dayjs.ConfigType, format?: dayjs.OptionType, locale?: string, strict?: boolean): dayjs.Dayjs
+
+declare namespace dayjs {
+  interface ConfigTypeMap {
+    default: string | number | Date | Dayjs | null | undefined
+  }
+
+  export type ConfigType = ConfigTypeMap[keyof ConfigTypeMap]
+
+  export interface FormatObject { locale?: string, format?: string, utc?: boolean }
+
+  export type OptionType = FormatObject | string | string[]
+
+  export type UnitTypeShort = 'd' | 'D' | 'M' | 'y' | 'h' | 'm' | 's' | 'ms'
+
+  export type UnitTypeLong = 'millisecond' | 'second' | 'minute' | 'hour' | 'day' | 'month' | 'year' | 'date'
+
+  export type UnitTypeLongPlural = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years' | 'dates'
+  
+  export type UnitType = UnitTypeLong | UnitTypeLongPlural | UnitTypeShort;
+
+  export type OpUnitType = UnitType | "week" | "weeks" | 'w';
+  export type QUnitType = UnitType | "quarter" | "quarters" | 'Q';
+  export type ManipulateType = Exclude<OpUnitType, 'date' | 'dates'>;
+  class Dayjs {
+    constructor (config?: ConfigType)
+    /**
+     * All Day.js objects are immutable. Still, `dayjs#clone` can create a clone of the current object if you need one.
+     * ```
+     * dayjs().clone()// => Dayjs
+     * dayjs(dayjs('2019-01-25')) // passing a Dayjs object to a constructor will also clone it
+     * ```
+     * Docs: https://day.js.org/docs/en/parse/dayjs-clone
+     */
+    clone(): Dayjs
+    /**
+     * This returns a `boolean` indicating whether the Day.js object contains a valid date or not.
+     * ```
+     * dayjs().isValid()// => boolean
+     * ```
+     * Docs: https://day.js.org/docs/en/parse/is-valid
+     */
+    isValid(): boolean
+    /**
+     * Get the year.
+     * ```
+     * dayjs().year()// => 2020
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/year
+     */
+    year(): number
+    /**
+     * Set the year.
+     * ```
+     * dayjs().year(2000)// => Dayjs
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/year
+     */
+    year(value: number): Dayjs
+    /**
+     * Get the month.
+     *
+     * Months are zero indexed, so January is month 0.
+     * ```
+     * dayjs().month()// => 0-11
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/month
+     */
+    month(): number
+    /**
+     * Set the month.
+     *
+     * Months are zero indexed, so January is month 0.
+     *
+     * Accepts numbers from 0 to 11. If the range is exceeded, it will bubble up to the next year.
+     * ```
+     * dayjs().month(0)// => Dayjs
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/month
+     */
+    month(value: number): Dayjs
+    /**
+     * Get the date of the month.
+     * ```
+     * dayjs().date()// => 1-31
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/date
+     */
+    date(): number
+    /**
+     * Set the date of the month.
+     *
+     * Accepts numbers from 1 to 31. If the range is exceeded, it will bubble up to the next months.
+     * ```
+     * dayjs().date(1)// => Dayjs
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/date
+     */
+    date(value: number): Dayjs
+    /**
+     * Get the day of the week.
+     *
+     * Returns numbers from 0 (Sunday) to 6 (Saturday).
+     * ```
+     * dayjs().day()// 0-6
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/day
+     */
+    day(): 0 | 1 | 2 | 3 | 4 | 5 | 6
+    /**
+     * Set the day of the week.
+     *
+     * Accepts numbers from 0 (Sunday) to 6 (Saturday). If the range is exceeded, it will bubble up to next weeks.
+     * ```
+     * dayjs().day(0)// => Dayjs
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/day
+     */
+    day(value: number): Dayjs
+    /**
+     * Get the hour.
+     * ```
+     * dayjs().hour()// => 0-23
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/hour
+     */
+    hour(): number
+    /**
+     * Set the hour.
+     *
+     * Accepts numbers from 0 to 23. If the range is exceeded, it will bubble up to the next day.
+     * ```
+     * dayjs().hour(12)// => Dayjs
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/hour
+     */
+    hour(value: number): Dayjs
+    /**
+     * Get the minutes.
+     * ```
+     * dayjs().minute()// => 0-59
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/minute
+     */
+    minute(): number
+    /**
+     * Set the minutes.
+     *
+     * Accepts numbers from 0 to 59. If the range is exceeded, it will bubble up to the next hour.
+     * ```
+     * dayjs().minute(59)// => Dayjs
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/minute
+     */
+    minute(value: number): Dayjs
+    /**
+     * Get the seconds.
+     * ```
+     * dayjs().second()// => 0-59
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/second
+     */
+    second(): number
+    /**
+     * Set the seconds.
+     *
+     * Accepts numbers from 0 to 59. If the range is exceeded, it will bubble up to the next minutes.
+     * ```
+     * dayjs().second(1)// Dayjs
+     * ```
+     */
+    second(value: number): Dayjs
+    /**
+     * Get the milliseconds.
+     * ```
+     * dayjs().millisecond()// => 0-999
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/millisecond
+     */
+    millisecond(): number
+    /**
+     * Set the milliseconds.
+     *
+     * Accepts numbers from 0 to 999. If the range is exceeded, it will bubble up to the next seconds.
+     * ```
+     * dayjs().millisecond(1)// => Dayjs
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/millisecond
+     */
+    millisecond(value: number): Dayjs
+    /**
+     * Generic setter, accepting unit as first argument, and value as second, returns a new instance with the applied changes.
+     *
+     * In general:
+     * ```
+     * dayjs().set(unit, value) === dayjs()[unit](value)
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     * ```
+     * dayjs().set('date', 1)
+     * dayjs().set('month', 3) // April
+     * dayjs().set('second', 30)
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/set
+     */
+    set(unit: UnitType, value: number): Dayjs
+    /**
+     * String getter, returns the corresponding information getting from Day.js object.
+     *
+     * In general:
+     * ```
+     * dayjs().get(unit) === dayjs()[unit]()
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     * ```
+     * dayjs().get('year')
+     * dayjs().get('month') // start 0
+     * dayjs().get('date')
+     * ```
+     * Docs: https://day.js.org/docs/en/get-set/get
+     */
+    get(unit: UnitType): number
+    /**
+     * Returns a cloned Day.js object with a specified amount of time added.
+     * ```
+     * dayjs().add(7, 'day')// => Dayjs
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     *
+     * Docs: https://day.js.org/docs/en/manipulate/add
+     */
+    add(value: number, unit?: ManipulateType): Dayjs
+    /**
+     * Returns a cloned Day.js object with a specified amount of time subtracted.
+     * ```
+     * dayjs().subtract(7, 'year')// => Dayjs
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     *
+     * Docs: https://day.js.org/docs/en/manipulate/subtract
+     */
+    subtract(value: number, unit?: ManipulateType): Dayjs
+    /**
+     * Returns a cloned Day.js object and set it to the start of a unit of time.
+     * ```
+     * dayjs().startOf('year')// => Dayjs
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     *
+     * Docs: https://day.js.org/docs/en/manipulate/start-of
+     */
+    startOf(unit: OpUnitType): Dayjs
+    /**
+     * Returns a cloned Day.js object and set it to the end of a unit of time.
+     * ```
+     * dayjs().endOf('month')// => Dayjs
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     *
+     * Docs: https://day.js.org/docs/en/manipulate/end-of
+     */
+    endOf(unit: OpUnitType): Dayjs
+    /**
+     * Get the formatted date according to the string of tokens passed in.
+     *
+     * To escape characters, wrap them in square brackets (e.g. [MM]).
+     * ```
+     * dayjs().format()// => current date in ISO8601, without fraction seconds e.g. '2020-04-02T08:02:17-05:00'
+     * dayjs('2019-01-25').format('[YYYYescape] YYYY-MM-DDTHH:mm:ssZ[Z]')// 'YYYYescape 2019-01-25T00:00:00-02:00Z'
+     * dayjs('2019-01-25').format('DD/MM/YYYY') // '25/01/2019'
+     * ```
+     * Docs: https://day.js.org/docs/en/display/format
+     */
+    format(template?: string): string
+    /**
+     * This indicates the difference between two date-time in the specified unit.
+     *
+     * To get the difference in milliseconds, use `dayjs#diff`
+     * ```
+     * const date1 = dayjs('2019-01-25')
+     * const date2 = dayjs('2018-06-05')
+     * date1.diff(date2) // 20214000000 default milliseconds
+     * date1.diff() // milliseconds to current time
+     * ```
+     *
+     * To get the difference in another unit of measurement, pass that measurement as the second argument.
+     * ```
+     * const date1 = dayjs('2019-01-25')
+     * date1.diff('2018-06-05', 'month') // 7
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     *
+     * Docs: https://day.js.org/docs/en/display/difference
+     */
+    diff(date?: ConfigType, unit?: QUnitType | OpUnitType, float?: boolean): number
+    /**
+     * This returns the number of **milliseconds** since the Unix Epoch of the Day.js object.
+     * ```
+     * dayjs('2019-01-25').valueOf() // 1548381600000
+     * +dayjs(1548381600000) // 1548381600000
+     * ```
+     * To get a Unix timestamp (the number of seconds since the epoch) from a Day.js object, you should use Unix Timestamp `dayjs#unix()`.
+     *
+     * Docs: https://day.js.org/docs/en/display/unix-timestamp-milliseconds
+     */
+    valueOf(): number
+    /**
+     * This returns the Unix timestamp (the number of **seconds** since the Unix Epoch) of the Day.js object.
+     * ```
+     * dayjs('2019-01-25').unix() // 1548381600
+     * ```
+     * This value is floored to the nearest second, and does not include a milliseconds component.
+     *
+     * Docs: https://day.js.org/docs/en/display/unix-timestamp
+     */
+    unix(): number
+    /**
+     * Get the number of days in the current month.
+     * ```
+     * dayjs('2019-01-25').daysInMonth() // 31
+     * ```
+     * Docs: https://day.js.org/docs/en/display/days-in-month
+     */
+    daysInMonth(): number
+    /**
+     * To get a copy of the native `Date` object parsed from the Day.js object use `dayjs#toDate`.
+     * ```
+     * dayjs('2019-01-25').toDate()// => Date
+     * ```
+     */
+    toDate(): Date
+    /**
+     * To serialize as an ISO 8601 string.
+     * ```
+     * dayjs('2019-01-25').toJSON() // '2019-01-25T02:00:00.000Z'
+     * ```
+     * Docs: https://day.js.org/docs/en/display/as-json
+     */
+    toJSON(): string
+    /**
+     * To format as an ISO 8601 string.
+     * ```
+     * dayjs('2019-01-25').toISOString() // '2019-01-25T02:00:00.000Z'
+     * ```
+     * Docs: https://day.js.org/docs/en/display/as-iso-string
+     */
+    toISOString(): string
+    /**
+     * Returns a string representation of the date.
+     * ```
+     * dayjs('2019-01-25').toString() // 'Fri, 25 Jan 2019 02:00:00 GMT'
+     * ```
+     * Docs: https://day.js.org/docs/en/display/as-string
+     */
+    toString(): string
+    /**
+     * Get the UTC offset in minutes.
+     * ```
+     * dayjs().utcOffset()
+     * ```
+     * Docs: https://day.js.org/docs/en/manipulate/utc-offset
+     */
+    utcOffset(): number
+    /**
+     * This indicates whether the Day.js object is before the other supplied date-time.
+     * ```
+     * dayjs().isBefore(dayjs('2011-01-01')) // default milliseconds
+     * ```
+     * If you want to limit the granularity to a unit other than milliseconds, pass it as the second parameter.
+     * ```
+     * dayjs().isBefore('2011-01-01', 'year')// => boolean
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     *
+     * Docs: https://day.js.org/docs/en/query/is-before
+     */
+    isBefore(date?: ConfigType, unit?: OpUnitType): boolean
+    /**
+     * This indicates whether the Day.js object is the same as the other supplied date-time.
+     * ```
+     * dayjs().isSame(dayjs('2011-01-01')) // default milliseconds
+     * ```
+     * If you want to limit the granularity to a unit other than milliseconds, pass it as the second parameter.
+     * ```
+     * dayjs().isSame('2011-01-01', 'year')// => boolean
+     * ```
+     * Docs: https://day.js.org/docs/en/query/is-same
+     */
+    isSame(date?: ConfigType, unit?: OpUnitType): boolean
+    /**
+     * This indicates whether the Day.js object is after the other supplied date-time.
+     * ```
+     * dayjs().isAfter(dayjs('2011-01-01')) // default milliseconds
+     * ```
+     * If you want to limit the granularity to a unit other than milliseconds, pass it as the second parameter.
+     * ```
+     * dayjs().isAfter('2011-01-01', 'year')// => boolean
+     * ```
+     * Units are case insensitive, and support plural and short forms.
+     *
+     * Docs: https://day.js.org/docs/en/query/is-after
+     */
+    isAfter(date?: ConfigType, unit?: OpUnitType): boolean
+
+    locale(): string
+
+    locale(preset: string | ILocale, object?: Partial<ILocale>): Dayjs
+  }
+
+  export type PluginFunc<T = unknown> = (option: T, c: typeof Dayjs, d: typeof dayjs) => void
+
+  export function extend<T = unknown>(plugin: PluginFunc<T>, option?: T): Dayjs
+
+  export function locale(preset?: string | ILocale, object?: Partial<ILocale>, isLocal?: boolean): string
+
+  export function isDayjs(d: any): d is Dayjs
+
+  export function unix(t: number): Dayjs
+
+  const Ls : { [key: string] :  ILocale }
+}
+
+/** 模版根：`scope` 为流程数据，`system` 为系统内置工具 */
+type TemplateRootName = "scope" | "system";
+declare const TEMPLATE_ROOT_NAMES: TemplateRootName[];
+/** dayjs 实例常用方法（用于联想；运行时走真实 dayjs 原型） */
+declare const SYSTEM_TIME_METHOD_NAMES: readonly ["add", "subtract", "set", "get", "millisecond", "second", "minute", "hour", "date", "day", "weekday", "isoWeekday", "dayOfYear", "week", "isoWeek", "month", "quarter", "year", "weekYear", "isoWeekYear", "startOf", "endOf", "format", "fromNow", "toNow", "from", "to", "calendar", "diff", "valueOf", "unix", "daysInMonth", "toDate", "toArray", "toJSON", "toISOString", "toObject", "toString", "isBefore", "isSame", "isAfter", "isSameOrBefore", "isSameOrAfter", "isBetween", "isLeapYear", "isValid", "clone", "locale", "utcOffset", "local", "utc", "isUTC"];
+/** Math 静态成员（联想用） */
+declare const SYSTEM_MATH_KEYS: readonly ["E", "LN10", "LN2", "LOG10E", "LOG2E", "PI", "SQRT1_2", "SQRT2", "abs", "acos", "acosh", "asin", "asinh", "atan", "atan2", "atanh", "cbrt", "ceil", "clz32", "cos", "cosh", "exp", "expm1", "floor", "fround", "hypot", "imul", "log", "log10", "log1p", "log2", "max", "min", "pow", "random", "round", "sign", "sin", "sinh", "sqrt", "tan", "tanh", "trunc"];
+/** Location 常用属性 / 方法（联想用） */
+declare const SYSTEM_LOCATION_KEYS: readonly ["href", "protocol", "host", "hostname", "port", "pathname", "search", "hash", "origin", "ancestorOrigins", "assign", "reload", "replace", "toString"];
+type SystemTime = ReturnType<typeof dayjs>;
+type SystemRoot = {
+    /** 当前时间的 dayjs 对象（每次 createSystemRoot 取「此刻」） */
+    time: SystemTime;
+    /** JS Math */
+    math: Math;
+    /** 当前页 Location；非浏览器环境为只读占位 */
+    location: Location | SystemLocationStub;
+};
+type SystemLocationStub = {
+    href: string;
+    protocol: string;
+    host: string;
+    hostname: string;
+    port: string;
+    pathname: string;
+    search: string;
+    hash: string;
+    origin: string;
+    assign: (url: string) => void;
+    reload: () => void;
+    replace: (url: string) => void;
+    toString: () => string;
+};
+/** 每次求值新建，保证 `time` 为当前时刻 */
+declare function createSystemRoot(): SystemRoot;
+/** 联想用静态树（不依赖运行时实例） */
+declare function getSystemAutocompleteTree(): Record<string, unknown>;
+declare function isDayjsValue(value: unknown): value is SystemTime;
+
+/** @deprecated 名称保留兼容；实际同时识别 scope 与 system */
 declare function hasScopeTemplate(value: string): boolean;
-declare function evaluateScopeExpression(expression: string, scope: unknown): unknown;
+declare const hasTemplateExpression: typeof hasScopeTemplate;
+declare function evaluateScopeExpression(expression: string, scope: unknown, system?: SystemRoot): unknown;
 declare function stringifyScopeValue(value: unknown): string;
-/** 将 `{scope?.a}` 替换为求值结果；无模板时原样返回 */
-declare function evaluateScopeTemplate(template: string, scope: unknown): string;
+/** 将 `{scope?...}` / `{system?...}` 替换为求值结果；无模板时原样返回 */
+declare function evaluateScopeTemplate(template: string, scope: unknown, system?: SystemRoot): string;
 /**
- * 在 JSON 文本中替换 `{scope?...}`：
+ * 在 JSON 文本中替换模板：
  * - 位于字符串内时写入转义后的内容
  * - 位于值位置时写入 JSON 字面量（对象/数组/字符串/数字）
  */
-declare function evaluateScopeTemplateInJson(template: string, scope: unknown): string;
+declare function evaluateScopeTemplateInJson(template: string, scope: unknown, system?: SystemRoot): string;
 declare function looksLikeJsonText(text: string): boolean;
+/** 编码时保留未解析的 scope/system 模版片段 */
+declare function preserveTemplateTokensInEncode(value: string): boolean;
 
 type ScopeAutocompleteState = {
     templateStart: number;
     cursor: number;
+    /** 正在补全根名 scope / system */
+    suggestingRoot: boolean;
+    root: TemplateRootName | null;
     path: string[];
     partialKey: string;
 };
-/** 解析光标处未闭合的 scope 模版表达式 */
+/** 解析光标处未闭合的 scope / system 模版表达式 */
 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 buildScopeExpression(path: string[], selectedKey: string, root?: TemplateRootName): string;
 declare function applyScopeAutocompleteSelection(text: string, state: ScopeAutocompleteState, selectedKey: string): {
     value: string;
     cursor: number;
@@ -306,26 +796,78 @@ declare function getFetchBodyValidationError(body: string | undefined, resolvedB
 declare function getFetchHeadersValidationError(config: FetchRequestConfig, scope?: unknown): string | null;
 /** `{scope?...}` 整段表达式，区别于 JSON 对象 `{ "Authorization": "..." }` */
 declare function isWholeScopeExpression(text: string): boolean;
-/** 将请求头编辑器原文解析为对象；支持 JSON 内模板，也支持整段 `{scope?...}` */
+/** 将请求头编辑器原文解析为对象；支持 JSON 内模板，也支持整段 `{scope?...}` / `{system?...}` */
 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 */
+/** 用上游 scope / 系统 system 解析 fetch 表单中的 URL / Base URL / headers / body */
 declare function applyFetchConfigScope(config: FetchRequestConfig, scope: unknown): FetchRequestConfig;
 declare function fetchConfigHasScopeTemplate(config: FetchRequestConfig): boolean;
 
+/**
+ * JSON 文本静态检查：解析失败位置 + 常见全角/中文标点嫌疑字符。
+ */
+type JsonErrorRange = {
+    /** 含头不含尾的 UTF-16 下标 */
+    start: number;
+    end: number;
+    /** suspect = 全角/中文标点；parse = 解析器报错位置 */
+    kind: "suspect" | "parse";
+};
+type JsonLintResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+    ranges: JsonErrorRange[];
+};
+/** 从引擎错误信息中尽量取出出错下标 */
+declare function extractJsonErrorPosition(message: string, text: string): number | null;
+/**
+ * 轻量扫描：找到第一个非法 token 的起始下标。
+ * 用于 V8 等只报 `Unexpected token 'a'`、不带 position 的场景。
+ */
+declare function findJsonSyntaxErrorOffset(text: string): number | null;
+declare function findSuspectCharRanges(text: string): JsonErrorRange[];
+/**
+ * 检查 JSON 文本。失败时尽量给出可高亮的区间（含中文引号等嫌疑字符）。
+ */
+declare function lintJsonString(jsonString: string): JsonLintResult;
+/** 将错误区间应用到文本，生成带 <mark> 的 HTML（调用方需保证样式） */
+declare function renderJsonWithErrorHighlights(text: string, ranges: JsonErrorRange[], markClass?: string): string;
+
 type JsonNodeConfig = {
     jsonString: string;
 };
 declare const DEFAULT_JSON_NODE_CONFIG: JsonNodeConfig;
+
 declare function validateJsonString(jsonString: string): {
     ok: true;
     value: unknown;
 } | {
     ok: false;
     error: string;
+    ranges?: JsonErrorRange[];
+};
+/**
+ * 配置期校验：
+ * - 先做语法 lint（含错误区间）
+ * - 语法通过且含 scope/system 模版时标记 deferred（运行时再替换）
+ */
+declare function validateJsonStringAllowingScope(jsonString: string): {
+    ok: true;
+    value: unknown;
+    deferred?: false;
+} | {
+    ok: true;
+    deferred: true;
+} | {
+    ok: false;
+    error: string;
+    ranges: JsonErrorRange[];
 };
-declare function parseJsonConfig(config: JsonNodeConfig): unknown;
+declare function parseJsonConfig(config: JsonNodeConfig, scope?: unknown): unknown;
 
 type StorageKind = "session" | "local";
 type StorageReadConfig = {
@@ -356,8 +898,14 @@ declare function normalizeStorageConfig(config?: Partial<StorageNodeConfig> | nu
 declare function isStorageReadConfigured(config: Pick<StorageNodeConfig, "read">): boolean;
 declare function isStorageSetConfigured(config: Pick<StorageNodeConfig, "set">): boolean;
 declare function resolveStorageWriteValue(template: string, scope: unknown): unknown;
+/** Resolve a storage key that may contain `{scope...}` templates. */
+declare function resolveStorageKey(key: string, scope: unknown): string;
 declare function serializeStorageValue(value: unknown): string;
 declare function deserializeStorageValue(raw: string | null): unknown;
+/** Enumerate keys currently present in sessionStorage / localStorage. */
+declare function listBrowserStorageKeys(kind: StorageKind | readonly StorageKind[]): string[];
+/** Empty query returns all keys; otherwise case-insensitive substring match. */
+declare function filterStorageKeySuggestions(keys: readonly string[], query: string): string[];
 /** 先设置再读取。未配置设置则不写入；未配置读取则返回空。 */
 declare function executeStorageConfig(config: StorageNodeConfig, incomingScope: unknown, accessors?: StorageAccessors | null): unknown;
 
@@ -529,6 +1077,116 @@ declare function collectViewEventBindings(nodes: Array<{
     eventConfig?: Partial<ViewEventNodeConfig> | null;
 }>, eventNodeType: string, armedNodeIds?: ReadonlySet<string>): Map<string, Set<ViewEventType>>;
 
+declare const API_COLLECTION_DOCUMENT_VERSION: 1;
+/** 集合内单条接口 */
+type ApiCollectionEndpoint = {
+    /** 下拉展示名，集合内建议唯一 */
+    name: string;
+    /** 请求路径或完整 URL，可含 `{scope?...}` */
+    url: string;
+    method: FetchHttpMethod;
+    /** 查询参数；选中后会拼进 url；value 可含 `{scope?...}` */
+    params?: Record<string, string>;
+    /** 请求头；value 可含 `{scope?...}` */
+    headers?: Record<string, string>;
+    /** 请求体原文（多为 JSON 字符串），可含 `{scope?...}` */
+    body?: string;
+    /** 接口说明；配置侧栏选中时气泡展示 */
+    description?: string;
+};
+/** 用户上传 / 编辑的 JSON 文档形状 */
+type ApiCollectionDocument = {
+    version: typeof API_COLLECTION_DOCUMENT_VERSION;
+    /** 集合显示名 */
+    name: string;
+    /** 可选 API 主机，写入 Fetch 的 apiBaseUrl；可含 `{scope?...}` */
+    baseUrl?: string;
+    apis: ApiCollectionEndpoint[];
+};
+/** 运行时 / IndexedDB 记录 */
+type ApiCollectionRecord = {
+    id: string;
+    name: string;
+    /** true 时写入 IndexedDB；false 仅内存，刷新丢失 */
+    persistLocal: boolean;
+    document: ApiCollectionDocument;
+    /** 编辑器里的原文，便于再编辑 */
+    rawJson: string;
+    createdAt: number;
+    updatedAt: number;
+};
+type ApiCollectionListItem = {
+    id: string;
+    name: string;
+    persistLocal: boolean;
+    apiCount: number;
+    updatedAt: number;
+};
+type ApiCollectionParseResult = {
+    ok: true;
+    document: ApiCollectionDocument;
+    rawJson: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** 校验并规范化集合文档（对象或已 parse 的 JSON） */
+declare function validateApiCollectionDocument(input: unknown): {
+    ok: true;
+    document: ApiCollectionDocument;
+} | {
+    ok: false;
+    error: string;
+};
+/** 解析上传 / 编辑框里的 JSON 文本 */
+declare function parseApiCollectionJson(text: string): ApiCollectionParseResult;
+declare function createApiCollectionId(): string;
+declare function apiCollectionToListItem(record: ApiCollectionRecord): ApiCollectionListItem;
+/** 可下载的示例模版（已通过校验；value 可写 `{scope?...}`） */
+declare function getApiCollectionTemplateDocument(): ApiCollectionDocument;
+declare function getApiCollectionTemplateJson(): string;
+declare function downloadApiCollectionTemplate(filename?: string): void;
+/** 把 params 拼进 url（params 的 value 支持 Scope 模版） */
+declare function buildApiCollectionEndpointUrl(endpoint: ApiCollectionEndpoint): string;
+/** 同步匹配用：去掉 query / hash，忽略末尾斜杠 */
+declare function normalizeApiCollectionUrlKey(url: string): string;
+type ApiCollectionFetchNodeLike = {
+    id: string;
+    label?: string;
+    fetchConfig?: FetchRequestConfig | null;
+};
+type ApiCollectionSyncChangedField = "url" | "method" | "headers" | "body" | "apiBaseUrl";
+type ApiCollectionSyncNodePatch = {
+    nodeId: string;
+    nodeLabel: string;
+    changedFields: ApiCollectionSyncChangedField[];
+    fetchConfigPatch: Partial<FetchRequestConfig>;
+};
+type ApiCollectionSyncResult = {
+    updatedCount: number;
+    nodes: Array<{
+        id: string;
+        label: string;
+        changedFields: ApiCollectionSyncChangedField[];
+    }>;
+};
+/**
+ * 按 URL（忽略 query）匹配 Fetch 节点，生成回填 patch。
+ * URL 对不上的节点不会出现在结果里。
+ */
+declare function buildApiCollectionSyncPatches(options: {
+    collectionId: string;
+    document: ApiCollectionDocument;
+    nodes: ApiCollectionFetchNodeLike[];
+}): ApiCollectionSyncNodePatch[];
+declare function toApiCollectionSyncResult(patches: ApiCollectionSyncNodePatch[]): ApiCollectionSyncResult;
+/** 选中集合接口后回填到 Fetch 配置 */
+declare function applyApiCollectionEndpointToFetchConfig(options: {
+    collectionId: string;
+    document: ApiCollectionDocument;
+    endpoint: ApiCollectionEndpoint;
+}): Partial<FetchRequestConfig>;
+
 type ExecutionTraceEntry = {
     id: string;
     nodeId: string;
@@ -782,4 +1440,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_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 };
+export { AND_NODE_TYPE, API_COLLECTION_DOCUMENT_VERSION, type ApiCollectionDocument, type ApiCollectionEndpoint, type ApiCollectionFetchNodeLike, type ApiCollectionListItem, type ApiCollectionParseResult, type ApiCollectionRecord, type ApiCollectionSyncChangedField, type ApiCollectionSyncNodePatch, type ApiCollectionSyncNotice, type ApiCollectionSyncResult, 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 JsonErrorRange, 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, SYSTEM_LOCATION_KEYS, SYSTEM_MATH_KEYS, SYSTEM_TIME_METHOD_NAMES, type Scope, type ScopeAutocompleteState, type StorageAccessors, type StorageKind, type StorageNodeConfig, type StorageReadConfig, type StorageSetConfig, type SwaggerApiEndpoint, type SystemLocationStub, type SystemRoot, type SystemTime, TEMPLATE_ROOT_NAMES, type TemplateRootName, 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, apiCollectionToListItem, appStorageKey, applyApiCollectionEndpointToFetchConfig, applyFetchConfigScope, applyScopeAutocompleteSelection, assertNoBlueprintReferenceCycle, blueprintNodeDefinition, buildApiCollectionEndpointUrl, buildApiCollectionSyncPatches, buildClockSessionKey, buildClockSignalValue, buildEndpointFullUrl, buildEndpointSuggestions, buildIncomingNodeScope, buildScopeExpression, clearClockSessionAbort, clockNodeDefinition, collectArmedViewEventBindings, collectArmedViewEventNodeIds, collectBlueprintLibraryRefs, collectIncomingNodeScopeEntries, collectViewEventBindings, combinePortSignalsOr, createApiCollectionId, createClockOutputValue, createFalseSignal, createIncomingNodeScopeEntry, createLifecycleSignal, createSystemRoot, createTraceEntryId, createTrueSignal, createViewEventSignal, defaultLogicNodeDefinition, deserializeStorageValue, detectBlueprintReferenceCycle, detectRuntimeBlueprintCycle, downloadApiCollectionTemplate, draftFetchHeadersText, evaluateScopeExpression, evaluateScopeTemplate, evaluateScopeTemplateInJson, executeFetch, executeLogicConfig, executeStorageConfig, extractJsonErrorPosition, fetchConfigHasScopeTemplate, fetchNodeDefinition, filterEndpointSuggestions, filterStorageKeySuggestions, findJsonSyntaxErrorOffset, findSuspectCharRanges, formatBlueprintCycleMessage, formatClockTime, getActiveClockNodeIds, getApiCollectionTemplateDocument, getApiCollectionTemplateJson, getClockTickDelayOffsetMs, getClockTickWaitMs, getFetchBodyValidationError, getFetchHeadersValidationError, getNodeDefinition, getScopeAutocompleteSuggestions, getSystemAutocompleteTree, hasScopeTemplate, hasTemplateExpression, isClockNodeActive, isClockScheduleActive, isClockSessionAborted, isDayjsValue, isFalseSignal, isStorageReadConfigured, isStorageSetConfigured, isTrueSignal, isViewEventType, isWholeScopeExpression, jsonNodeDefinition, latestTraceOutputsByNode, lifecycleNodeDefinition, lintJsonString, listBrowserStorageKeys, looksLikeJsonText, nodeDefinitionRegistry, normalizeApiCollectionUrlKey, normalizeAppNameSpace, normalizeClockConfig, normalizeFetchRequestConfig, normalizeStorageConfig, normalizeViewEventConfig, parseApiCollectionJson, parseFetchHeadersJson, parseJsonConfig, parseJsonText, parseScopeAutocomplete, parseSwaggerDocument, preserveTemplateTokensInEncode, registerDefaultBehaviors, renderJsonWithErrorHighlights, resolveBlueprintCallStack, resolveFetchBody, resolveFetchHeaders, resolveFetchIncomingScope, resolveFetchRequestUrl, resolveFetchScopeAutocompleteRoot, resolveStorageKey, resolveStorageWriteValue, scheduleClockOutputs, serializeStorageValue, serializeTraceValue, snapshotDomEvent, snapshotViewEventNode, startClockSchedule, stopAllClockSchedules, stopClockSchedule, storageNodeDefinition, stringifyScopeValue, subscribeActiveClockNodes, toApiCollectionSyncResult, uniqueStorageKinds, validateApiCollectionDocument, validateClockScheduleConfig, validateFetchJsonText, validateJsonString, validateJsonStringAllowingScope, validateLogicSourceCode, viewBindNodeDefinition, viewEventNodeDefinition };