@nocobase/flow-engine 2.0.0-beta.9 → 2.0.1

package/lib/types.d.ts

@@ -147,6 +147,18 @@ export interface ActionDefinition<TModel extends FlowModel = FlowModel, TCtx ext
      * - StepDefinition.hideInSettings can override the ActionDefinition value.
      */
     hideInSettings?: boolean | ((ctx: TCtx) => boolean | Promise<boolean>);
+    /**
+     * Whether to disable this step/action in settings menus.
+     * - Supports static boolean and dynamic decision based on runtime context.
+     * - StepDefinition.disabledInSettings can override the ActionDefinition value.
+     */
+    disabledInSettings?: boolean | ((ctx: TCtx) => boolean | Promise<boolean>);
+    /**
+     * Optional reason shown when this step/action is disabled in settings menus.
+     * - Supports static string and dynamic resolver based on runtime context.
+     * - StepDefinition.disabledReasonInSettings can override the ActionDefinition value.
+     */
+    disabledReasonInSettings?: string | ((ctx: TCtx) => string | Promise<string>);
     /**
      * 在执行 Action 前为 ctx 定义临时属性。
      * - 仅支持 PropertyOptions 形态（例如：{ foo: { value: 5 } }）；
@@ -166,12 +178,27 @@ export interface ActionDefinition<TModel extends FlowModel = FlowModel, TCtx ext
  * - 允许扩展字符串以保持向后兼容。
  */
 export type FlowEventName = 'click' | 'submit' | 'reset' | 'remove' | 'openView' | 'dropdownOpen' | 'popupScroll' | 'search' | 'customRequest' | 'collapseToggle' | (string & {});
+/**
+ * 事件流的执行时机（phase）。
+ *
+ * 说明：
+ * - 缺省（phase 未配置）表示保持现有行为；
+ * - 当配置了 phase 时，运行时会将其映射为 `scheduleModelOperation` 的 `when` 锚点；
+ * - phase 同时适用于动态事件流（实例级）与静态流（内置）。
+ */
+export type FlowEventPhase = 'beforeAllFlows' | 'afterAllFlows' | 'beforeFlow' | 'afterFlow' | 'beforeStep' | 'afterStep';
 /**
  * Flow 事件类型（供 FlowDefinitionOptions.on 使用）。
  */
 export type FlowEvent<TModel extends FlowModel = FlowModel> = FlowEventName | {
     eventName: FlowEventName;
     defaultParams?: Record<string, any>;
+    /** 动态事件流的执行时机（默认 beforeAllFlows） */
+    phase?: FlowEventPhase;
+    /** phase 为 beforeFlow/afterFlow/beforeStep/afterStep 时使用 */
+    flowKey?: string;
+    /** phase 为 beforeStep/afterStep 时使用 */
+    stepKey?: string;
 };
 /**
  * 事件分发选项。

package/lib/utils/associationObjectVariable.d.ts

@@ -9,7 +9,7 @@
 import type { Collection } from '../data-source';
 import type { FlowContext, PropertyMetaFactory } from '../flowContext';
 /**
- * 创建一个用于“对象类变量”（如 formValues / currentObject）的 `resolveOnServer` 判定函数。
+ * 创建一个用于“对象类变量”（如 formValues / item）的 `resolveOnServer` 判定函数。
  * 仅当访问路径以“关联字段名”开头（且继续访问其子属性）时，返回 true 交由服务端解析；
  * 否则在前端解析即可。
  *
@@ -26,7 +26,7 @@ export declare function createAssociationSubpathResolver(collectionAccessor: ()
  *
  * @param collectionAccessor 获取集合对象，用于字段/元信息来源
  * @param title 变量组标题（用于 UI 展示）
- * @param valueAccessor 获取当前对象值（如 ctx.form.getFieldsValue() / ctx.currentObject）
+ * @param valueAccessor 获取当前对象值（如 ctx.form.getFieldsValue() / ctx.item）
  * @returns PropertyMetaFactory
  */
 export declare function createAssociationAwareObjectMetaFactory(collectionAccessor: () => Collection | null, title: string, valueAccessor: (ctx: FlowContext) => any): PropertyMetaFactory;

package/lib/utils/createCollectionContextMeta.js

@@ -87,6 +87,7 @@ function createMetaBaseProperties(field) {
   return {
     title: field.title || field.name,
     interface: field.interface,
+    options: field.options,
     uiSchema: field.uiSchema || {}
   };
 }

package/lib/utils/createEphemeralContext.js

@@ -52,7 +52,7 @@ async function createEphemeralContext(parent, contextDefs) {
           return (propKey, options) => scoped.defineProperty(propKey, options);
         }
         if (key === "defineMethod") {
-          return (name, fn, des) => scoped.defineMethod(name, fn, des);
+          return (name, fn, info) => scoped.defineMethod(name, fn, info);
         }
         if (Reflect.has(scopedObj, key)) {
           return Reflect.get(scopedObj, key, receiver);
@@ -112,7 +112,7 @@ async function createEphemeralContext(parent, contextDefs) {
           return (propKey, options) => parent.defineProperty(propKey, options);
         }
         if (key === "defineMethod") {
-          return (name, fn, des) => parent.defineMethod(name, fn, des);
+          return (name, fn, info) => parent.defineMethod(name, fn, info);
         }
         if (Reflect.has(scopedObj, key)) {
           return Reflect.get(scopedObj, key, receiver);

package/lib/utils/dateVariable.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+export declare function isCtxDatePathPrefix(pathSegments: string[]): boolean;
+export declare function encodeBase64Url(input: string): string;
+export declare function decodeBase64Url(input: string): string | undefined;
+export declare function isCtxDateExpression(value: unknown): value is string;
+export declare function isCompleteCtxDatePath(pathSegments: string[]): boolean;
+export declare function parseCtxDateExpression(value: unknown): any;
+export declare function serializeCtxDateValue(value: unknown): string | undefined;
+export declare function resolveCtxDatePath(pathSegments: string[]): any;

package/lib/utils/dateVariable.js

@@ -0,0 +1,380 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var dateVariable_exports = {};
+__export(dateVariable_exports, {
+  decodeBase64Url: () => decodeBase64Url,
+  encodeBase64Url: () => encodeBase64Url,
+  isCompleteCtxDatePath: () => isCompleteCtxDatePath,
+  isCtxDateExpression: () => isCtxDateExpression,
+  isCtxDatePathPrefix: () => isCtxDatePathPrefix,
+  parseCtxDateExpression: () => parseCtxDateExpression,
+  resolveCtxDatePath: () => resolveCtxDatePath,
+  serializeCtxDateValue: () => serializeCtxDateValue
+});
+module.exports = __toCommonJS(dateVariable_exports);
+var import_dayjs = __toESM(require("dayjs"));
+const CTX_DATE_REGEX = /^\{\{\s*ctx\.date(?:\.(.+?))?\s*\}\}$/;
+const PRESET_KEYS = /* @__PURE__ */ new Set([
+  "today",
+  "now",
+  "yesterday",
+  "tomorrow",
+  "thisWeek",
+  "lastWeek",
+  "nextWeek",
+  "thisMonth",
+  "lastMonth",
+  "nextMonth",
+  "thisQuarter",
+  "lastQuarter",
+  "nextQuarter",
+  "thisYear",
+  "lastYear",
+  "nextYear"
+]);
+const RELATIVE_DIRECTIONS = /* @__PURE__ */ new Set(["next", "past"]);
+const RELATIVE_UNITS = /* @__PURE__ */ new Set(["day", "week", "month", "year"]);
+function parseCtxDateSegments(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  const match = trimmed.match(CTX_DATE_REGEX);
+  if (!match) return null;
+  const rawPath = String(match[1] || "");
+  if (!rawPath) return [];
+  return rawPath.split(".").map((seg) => seg.trim()).filter(Boolean);
+}
+__name(parseCtxDateSegments, "parseCtxDateSegments");
+function isCtxDatePathPrefix(pathSegments) {
+  const segments = withDatePrefix((pathSegments || []).map((seg) => String(seg)));
+  if (segments[0] !== "date") return false;
+  if (segments.length === 1) return true;
+  if (segments[1] === "preset") {
+    if (segments.length === 2) return true;
+    return segments.length === 3 && PRESET_KEYS.has(segments[2]);
+  }
+  if (segments[1] === "relative") {
+    if (segments.length === 2) return true;
+    if (segments.length === 3) return RELATIVE_DIRECTIONS.has(segments[2]);
+    if (segments.length === 4) {
+      return RELATIVE_DIRECTIONS.has(segments[2]) && RELATIVE_UNITS.has(segments[3]);
+    }
+    if (segments.length === 5) {
+      return RELATIVE_DIRECTIONS.has(segments[2]) && RELATIVE_UNITS.has(segments[3]) && typeof parseNumberToken(segments[4]) === "number";
+    }
+    return false;
+  }
+  if (segments[1] === "exact") {
+    if (segments.length === 2) return true;
+    if (segments[2] === "single") {
+      if (segments.length === 3) return true;
+      if (segments.length === 4) return segments[3] === "date";
+      if (segments.length === 5) return segments[3] === "date" && /^v.+/.test(segments[4]);
+      return false;
+    }
+    if (segments[2] === "range") {
+      if (segments.length === 3) return true;
+      if (segments.length === 4) return segments[3] === "date";
+      if (segments.length === 5) return segments[3] === "date" && /^v.+/.test(segments[4]);
+      if (segments.length === 6) return segments[3] === "date" && /^v.+/.test(segments[4]) && /^v.+/.test(segments[5]);
+      return false;
+    }
+    return false;
+  }
+  return false;
+}
+__name(isCtxDatePathPrefix, "isCtxDatePathPrefix");
+function withDatePrefix(pathSegments) {
+  if (pathSegments[0] === "date") {
+    return pathSegments;
+  }
+  return ["date", ...pathSegments];
+}
+__name(withDatePrefix, "withDatePrefix");
+function toCtxDateExpression(pathSegments) {
+  const segs = withDatePrefix(pathSegments);
+  return `{{ ctx.${segs.join(".")} }}`;
+}
+__name(toCtxDateExpression, "toCtxDateExpression");
+function utf8ToBase64(input) {
+  const globalBuffer = globalThis == null ? void 0 : globalThis.Buffer;
+  if (globalBuffer && typeof globalBuffer.from === "function") {
+    return globalBuffer.from(input, "utf8").toString("base64");
+  }
+  if (typeof btoa === "function") {
+    const encoded = encodeURIComponent(input).replace(
+      /%([0-9A-F]{2})/g,
+      (_m, p1) => String.fromCharCode(parseInt(p1, 16))
+    );
+    return btoa(encoded);
+  }
+  throw new Error("No base64 encoder available");
+}
+__name(utf8ToBase64, "utf8ToBase64");
+function base64ToUtf8(input) {
+  const globalBuffer = globalThis == null ? void 0 : globalThis.Buffer;
+  if (globalBuffer && typeof globalBuffer.from === "function") {
+    return globalBuffer.from(input, "base64").toString("utf8");
+  }
+  if (typeof atob === "function") {
+    const binary = atob(input);
+    const encoded = Array.from(binary).map((char) => `%${char.charCodeAt(0).toString(16).padStart(2, "0")}`).join("");
+    return decodeURIComponent(encoded);
+  }
+  throw new Error("No base64 decoder available");
+}
+__name(base64ToUtf8, "base64ToUtf8");
+function normalizeToString(value) {
+  if (value == null) return void 0;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : void 0;
+  }
+  if (import_dayjs.default.isDayjs(value)) {
+    return value.toISOString();
+  }
+  if (value instanceof Date) {
+    return (0, import_dayjs.default)(value).toISOString();
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  return void 0;
+}
+__name(normalizeToString, "normalizeToString");
+function parseNumberToken(token) {
+  const match = String(token || "").match(/^n(\d+)$/);
+  if (!match) return void 0;
+  const parsed = Number(match[1]);
+  if (!Number.isFinite(parsed) || parsed <= 0) return void 0;
+  return parsed;
+}
+__name(parseNumberToken, "parseNumberToken");
+function startOfIsoWeek(date) {
+  const day = date.day();
+  const offset = day === 0 ? -6 : 1 - day;
+  return date.add(offset, "day").startOf("day");
+}
+__name(startOfIsoWeek, "startOfIsoWeek");
+function startOfQuarter(date) {
+  const month = date.month();
+  const quarterStartMonth = Math.floor(month / 3) * 3;
+  return date.month(quarterStartMonth).startOf("month");
+}
+__name(startOfQuarter, "startOfQuarter");
+function encodeBase64Url(input) {
+  const base64 = utf8ToBase64(String(input || ""));
+  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
+}
+__name(encodeBase64Url, "encodeBase64Url");
+function decodeBase64Url(input) {
+  try {
+    const raw = String(input || "").replace(/=+$/g, "");
+    if (!raw) return void 0;
+    if (!/^[A-Za-z0-9_-]+$/.test(raw)) return void 0;
+    const normalized = raw.replace(/-/g, "+").replace(/_/g, "/");
+    const padLength = normalized.length % 4 === 0 ? 0 : 4 - normalized.length % 4;
+    const padded = `${normalized}${"=".repeat(padLength)}`;
+    const decoded = base64ToUtf8(padded);
+    if (encodeBase64Url(decoded) !== raw) return void 0;
+    return decoded;
+  } catch (_error) {
+    return void 0;
+  }
+}
+__name(decodeBase64Url, "decodeBase64Url");
+function isCtxDateExpression(value) {
+  if (typeof value !== "string") return false;
+  return CTX_DATE_REGEX.test(value.trim());
+}
+__name(isCtxDateExpression, "isCtxDateExpression");
+function isCompleteCtxDatePath(pathSegments) {
+  if (!isCtxDatePathPrefix(pathSegments)) return false;
+  const segments = withDatePrefix((pathSegments || []).map((seg) => String(seg)));
+  if (segments[0] !== "date") return false;
+  if (segments[1] === "preset") {
+    return segments.length === 3 && PRESET_KEYS.has(segments[2]);
+  }
+  if (segments[1] === "relative") {
+    if (segments.length !== 5) return false;
+    return RELATIVE_DIRECTIONS.has(segments[2]) && RELATIVE_UNITS.has(segments[3]) && typeof parseNumberToken(segments[4]) === "number";
+  }
+  if (segments[1] === "exact" && segments[2] === "single" && segments[3] === "date") {
+    return segments.length === 5 && /^v.+/.test(segments[4]);
+  }
+  if (segments[1] === "exact" && segments[2] === "range" && segments[3] === "date") {
+    return segments.length === 6 && /^v.+/.test(segments[4]) && /^v.+/.test(segments[5]);
+  }
+  return false;
+}
+__name(isCompleteCtxDatePath, "isCompleteCtxDatePath");
+function parseCtxDateExpression(value) {
+  if (!isCtxDateExpression(value)) return void 0;
+  const segments = withDatePrefix(parseCtxDateSegments(value) || []);
+  if (segments[1] === "preset" && segments.length === 3 && PRESET_KEYS.has(segments[2])) {
+    return { type: segments[2] };
+  }
+  if (segments[1] === "relative" && segments.length === 5 && RELATIVE_DIRECTIONS.has(segments[2]) && RELATIVE_UNITS.has(segments[3])) {
+    const amount = parseNumberToken(segments[4]);
+    if (typeof amount === "number") {
+      return { type: segments[2], unit: segments[3], number: amount };
+    }
+    return void 0;
+  }
+  if (segments[1] === "exact" && segments[2] === "single" && segments[3] === "date" && segments.length === 5) {
+    const raw = String(segments[4] || "");
+    if (!raw.startsWith("v")) return void 0;
+    return decodeBase64Url(raw.slice(1));
+  }
+  if (segments[1] === "exact" && segments[2] === "range" && segments[3] === "date" && segments.length === 6) {
+    const leftRaw = String(segments[4] || "");
+    const rightRaw = String(segments[5] || "");
+    if (!leftRaw.startsWith("v") || !rightRaw.startsWith("v")) return void 0;
+    const left = decodeBase64Url(leftRaw.slice(1));
+    const right = decodeBase64Url(rightRaw.slice(1));
+    if (typeof left === "undefined" || typeof right === "undefined") return void 0;
+    return [left, right];
+  }
+  return void 0;
+}
+__name(parseCtxDateExpression, "parseCtxDateExpression");
+function serializeCtxDateValue(value) {
+  if (isCtxDateExpression(value)) {
+    return String(value).trim();
+  }
+  if (value == null || value === "") {
+    return void 0;
+  }
+  if (Array.isArray(value)) {
+    const start = normalizeToString(value[0]);
+    const end = normalizeToString(value[1]);
+    if (start && end) {
+      return toCtxDateExpression([
+        "date",
+        "exact",
+        "range",
+        "date",
+        `v${encodeBase64Url(start)}`,
+        `v${encodeBase64Url(end)}`
+      ]);
+    }
+    if (start) {
+      return toCtxDateExpression(["date", "exact", "single", "date", `v${encodeBase64Url(start)}`]);
+    }
+    return void 0;
+  }
+  if (typeof value === "object" && value) {
+    const typed = value;
+    const type = typeof typed.type === "string" ? typed.type : "";
+    if (type === "past" || type === "next") {
+      const unit = typeof typed.unit === "string" && RELATIVE_UNITS.has(typed.unit) ? typed.unit : "day";
+      const rawNumber = Number(typed.number);
+      const number = Number.isFinite(rawNumber) && rawNumber > 0 ? Math.floor(rawNumber) : 1;
+      return toCtxDateExpression(["date", "relative", type, unit, `n${number}`]);
+    }
+    if (PRESET_KEYS.has(type)) {
+      return toCtxDateExpression(["date", "preset", type]);
+    }
+  }
+  const single = normalizeToString(value);
+  if (single) {
+    return toCtxDateExpression(["date", "exact", "single", "date", `v${encodeBase64Url(single)}`]);
+  }
+  return void 0;
+}
+__name(serializeCtxDateValue, "serializeCtxDateValue");
+function resolveCtxDatePath(pathSegments) {
+  const segments = withDatePrefix((pathSegments || []).map((seg) => String(seg)));
+  if (segments[0] !== "date") return void 0;
+  if (segments[1] === "preset" && segments.length === 3) {
+    const key = segments[2];
+    if (key === "now") {
+      return (0, import_dayjs.default)().toISOString();
+    }
+    const now = (0, import_dayjs.default)();
+    if (key === "today") return now.format("YYYY-MM-DD");
+    if (key === "yesterday") return now.add(-1, "day").format("YYYY-MM-DD");
+    if (key === "tomorrow") return now.add(1, "day").format("YYYY-MM-DD");
+    if (key === "thisWeek") return startOfIsoWeek(now).format("YYYY-MM-DD");
+    if (key === "lastWeek") return startOfIsoWeek(now.add(-1, "week")).format("YYYY-MM-DD");
+    if (key === "nextWeek") return startOfIsoWeek(now.add(1, "week")).format("YYYY-MM-DD");
+    if (key === "thisMonth") return now.startOf("month").format("YYYY-MM-DD");
+    if (key === "lastMonth") return now.add(-1, "month").startOf("month").format("YYYY-MM-DD");
+    if (key === "nextMonth") return now.add(1, "month").startOf("month").format("YYYY-MM-DD");
+    if (key === "thisQuarter") return startOfQuarter(now).format("YYYY-MM-DD");
+    if (key === "lastQuarter") return startOfQuarter(now.add(-3, "month")).format("YYYY-MM-DD");
+    if (key === "nextQuarter") return startOfQuarter(now.add(3, "month")).format("YYYY-MM-DD");
+    if (key === "thisYear") return now.startOf("year").format("YYYY-MM-DD");
+    if (key === "lastYear") return now.add(-1, "year").startOf("year").format("YYYY-MM-DD");
+    if (key === "nextYear") return now.add(1, "year").startOf("year").format("YYYY-MM-DD");
+    return void 0;
+  }
+  if (segments[1] === "relative" && segments.length === 5 && RELATIVE_DIRECTIONS.has(segments[2]) && RELATIVE_UNITS.has(segments[3])) {
+    const amount = parseNumberToken(segments[4]);
+    if (typeof amount !== "number") return void 0;
+    const direction = segments[2] === "past" ? -1 : 1;
+    const unit = segments[3];
+    return (0, import_dayjs.default)().add(direction * amount, unit).format("YYYY-MM-DD");
+  }
+  if (segments[1] === "exact" && segments[2] === "single" && segments[3] === "date" && segments.length === 5) {
+    const token = String(segments[4] || "");
+    if (!token.startsWith("v")) return void 0;
+    return decodeBase64Url(token.slice(1));
+  }
+  if (segments[1] === "exact" && segments[2] === "range" && segments[3] === "date" && segments.length === 6) {
+    const leftToken = String(segments[4] || "");
+    const rightToken = String(segments[5] || "");
+    if (!leftToken.startsWith("v") || !rightToken.startsWith("v")) return void 0;
+    const left = decodeBase64Url(leftToken.slice(1));
+    const right = decodeBase64Url(rightToken.slice(1));
+    if (typeof left === "undefined" || typeof right === "undefined") return void 0;
+    return [left, right];
+  }
+  return void 0;
+}
+__name(resolveCtxDatePath, "resolveCtxDatePath");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  decodeBase64Url,
+  encodeBase64Url,
+  isCompleteCtxDatePath,
+  isCtxDateExpression,
+  isCtxDatePathPrefix,
+  parseCtxDateExpression,
+  resolveCtxDatePath,
+  serializeCtxDateValue
+});

package/lib/utils/exceptions.d.ts

@@ -20,3 +20,10 @@ export declare class FlowExitAllException extends Error {
     readonly modelUid: string;
     constructor(flowKey: string, modelUid: string, message?: string);
 }
+/**
+ * 取消当前保存但保持设置弹窗打开
+ * 用于“保存前确认”场景，用户取消时不应关闭弹窗也不应提示错误
+ */
+export declare class FlowCancelSaveException extends Error {
+    constructor(message?: string);
+}

package/lib/utils/exceptions.js

@@ -27,6 +27,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var exceptions_exports = {};
 __export(exceptions_exports, {
+  FlowCancelSaveException: () => FlowCancelSaveException,
   FlowExitAllException: () => FlowExitAllException,
   FlowExitException: () => FlowExitException
 });
@@ -55,8 +56,17 @@ const _FlowExitAllException = class _FlowExitAllException extends Error {
 };
 __name(_FlowExitAllException, "FlowExitAllException");
 let FlowExitAllException = _FlowExitAllException;
+const _FlowCancelSaveException = class _FlowCancelSaveException extends Error {
+  constructor(message = "Flow settings save cancelled.") {
+    super(message);
+    this.name = "FlowCancelSaveException";
+  }
+};
+__name(_FlowCancelSaveException, "FlowCancelSaveException");
+let FlowCancelSaveException = _FlowCancelSaveException;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  FlowCancelSaveException,
   FlowExitAllException,
   FlowExitException
 });

package/lib/utils/index.d.ts

@@ -8,11 +8,11 @@
  */
 export { BLOCK_GROUP_CONFIGS, BLOCK_TYPES, FLOW_ENGINE_NAMESPACE, MENU_KEYS, type BlockBuilderConfig, } from './constants';
 export { escapeT, getT, tExpr } from './translation';
-export { FlowExitException } from './exceptions';
+export { FlowCancelSaveException, FlowExitException } from './exceptions';
 export { defineAction } from './flow-definitions';
 export { isInheritedFrom } from './inheritance';
 export { resolveCreateModelOptions, resolveDefaultParams, resolveExpressions } from './params-resolvers';
-export { compileUiSchema, resolveStepUiSchema, resolveUiMode, shouldHideStepInSettings } from './schema-utils';
+export { compileUiSchema, resolveStepUiSchema, resolveStepDisabledInSettings, resolveUiMode, shouldHideStepInSettings, } from './schema-utils';
 export { setupRuntimeContextSteps } from './setupRuntimeContextSteps';
 export { createCollectionContextMeta } from './createCollectionContextMeta';
 export { createAssociationAwareObjectMetaFactory, createAssociationSubpathResolver } from './associationObjectVariable';
@@ -20,7 +20,12 @@ export { buildRecordMeta, collectContextParamsForTemplate, createCurrentRecordMe
 export { extractPropertyPath, formatPathToVariable, isVariableExpression } from './context';
 export { clearAutoFlowError, getAutoFlowError, setAutoFlowError, type AutoFlowError } from './autoFlowError';
 export { parsePathnameToViewParams, type ViewParam } from './parsePathnameToViewParams';
-export { createSafeDocument, createSafeWindow, createSafeNavigator } from './safeGlobals';
+export { decodeBase64Url, encodeBase64Url, isCompleteCtxDatePath, isCtxDatePathPrefix, isCtxDateExpression, parseCtxDateExpression, resolveCtxDatePath, serializeCtxDateValue, } from './dateVariable';
+export { createSafeDocument, createSafeWindow, createSafeNavigator, createSafeRunJSGlobals, runjsWithSafeGlobals, } from './safeGlobals';
+export { isRunJSValue, normalizeRunJSValue, extractUsedVariablePathsFromRunJS, type RunJSValue } from './runjsValue';
+export { resolveRunJSObjectValues } from './resolveRunJSObjectValues';
+export { prepareRunJsCode, preprocessRunJsTemplates } from './runjsTemplateCompat';
 export { createEphemeralContext } from './createEphemeralContext';
 export { pruneFilter } from './pruneFilter';
 export { isBeforeRenderFlow } from './flows';
+export { resolveModuleUrl, isCssFile } from './resolveModuleUrl';