@acorex/platform 21.0.0-next.90 → 21.0.0-next.92

package/types/acorex-platform-contracts.d.ts

@@ -191,6 +191,29 @@ declare enum AXPSystemActionType {
     Distribution = "distribution"
 }
 
+type AXPContextState = 'initiated' | 'restored' | 'changed' | 'patch';
+type AXPContextUpdateOrigin = 'user' | 'system';
+interface AXPContextUpdateOptions {
+    origin?: AXPContextUpdateOrigin;
+}
+interface AXPContextPatchOptions {
+    /** When true, updates the saved snapshot together with live data. */
+    updateSaved?: boolean;
+}
+type AXPContextData = {
+    [key: string]: any;
+};
+declare class AXPContextChangeEvent {
+    oldValue?: any;
+    newValue?: any;
+    path?: string;
+    state: AXPContextState;
+    data: any;
+    origin?: AXPContextUpdateOrigin;
+    /** Aggregated form dirty flag (context snapshot + composite widget dirty). */
+    isFormDirty?: boolean;
+}
+
 type AXDataSourceOperatorType = 'endsWith' | 'startsWith' | 'in' | 'equal' | 'isNull' | 'isEmpty' | 'lt' | 'lte' | 'gt' | 'gte' | 'contains';
 interface AXDataSourceOperator {
     type: AXDataSourceOperatorType;
@@ -211,6 +234,728 @@ interface AXDataSourceSortOption {
     dir?: 'asc' | 'desc';
 }
 
+declare const AXPSystemActions: Readonly<{
+    readonly View: {
+        readonly key: AXPSystemActionType.View;
+        readonly title: string;
+        readonly icon: "fa-light fa-eye";
+        readonly color: "primary";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Create: {
+        readonly key: AXPSystemActionType.Create;
+        readonly title: string;
+        readonly icon: "fa-light fa-plus";
+        readonly color: "primary";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Edit: {
+        readonly key: AXPSystemActionType.Update;
+        readonly title: string;
+        readonly icon: "fa-light fa-pen";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Delete: {
+        readonly key: AXPSystemActionType.Delete;
+        readonly title: string;
+        readonly icon: "fa-light fa-trash";
+        readonly color: "danger";
+        readonly critical: true;
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Approve: {
+        readonly key: AXPSystemActionType.Approve;
+        readonly title: string;
+        readonly icon: "fa-light fa-circle-check";
+        readonly color: "success";
+        readonly critical: true;
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Submit: {
+        readonly key: AXPSystemActionType.Submit;
+        readonly title: string;
+        readonly icon: "fa-light fa-paper-plane";
+        readonly color: "primary";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Reject: {
+        readonly key: AXPSystemActionType.Reject;
+        readonly title: string;
+        readonly icon: "fa-light fa-ban";
+        readonly color: "danger";
+        readonly critical: true;
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Export: {
+        readonly key: AXPSystemActionType.Export;
+        readonly title: string;
+        readonly icon: "fa-light fa-download";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Import: {
+        readonly key: AXPSystemActionType.Import;
+        readonly title: string;
+        readonly icon: "fa-light fa-upload";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Print: {
+        readonly key: AXPSystemActionType.Print;
+        readonly title: string;
+        readonly icon: "fa-light fa-print";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Duplicate: {
+        readonly key: AXPSystemActionType.Duplicate;
+        readonly title: string;
+        readonly icon: "fa-light fa-clone";
+        readonly color: "warning";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Archive: {
+        readonly key: AXPSystemActionType.Archive;
+        readonly title: string;
+        readonly icon: "fa-light fa-box-archive";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Restore: {
+        readonly key: AXPSystemActionType.Restore;
+        readonly title: string;
+        readonly icon: "fa-light fa-arrow-rotate-left";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Assign: {
+        readonly key: AXPSystemActionType.Assign;
+        readonly title: string;
+        readonly icon: "fa-light fa-user-plus";
+        readonly color: "primary";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Lock: {
+        readonly key: AXPSystemActionType.Lock;
+        readonly title: string;
+        readonly icon: "fa-light fa-lock";
+        readonly color: "warning";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Unlock: {
+        readonly key: AXPSystemActionType.Unlock;
+        readonly title: string;
+        readonly icon: "fa-light fa-unlock";
+        readonly color: "success";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Share: {
+        readonly key: AXPSystemActionType.Share;
+        readonly title: string;
+        readonly icon: "fa-light fa-share-nodes";
+        readonly color: "info";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Configure: {
+        readonly key: AXPSystemActionType.Configure;
+        readonly title: string;
+        readonly icon: "fa-light fa-sliders";
+        readonly color: "primary";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Reorder: {
+        readonly key: AXPSystemActionType.Reorder;
+        readonly title: string;
+        readonly icon: "fa-light fa-arrow-down-up-across-line";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Preview: {
+        readonly key: AXPSystemActionType.Preview;
+        readonly title: string;
+        readonly icon: "fa-light fa-magnifying-glass";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Publish: {
+        readonly key: AXPSystemActionType.Publish;
+        readonly title: string;
+        readonly icon: "fa-light fa-globe";
+        readonly color: "success";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Unpublish: {
+        readonly key: AXPSystemActionType.Unpublish;
+        readonly title: string;
+        readonly icon: "fa-light fa-globe-slash";
+        readonly color: "danger";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Upload: {
+        readonly key: AXPSystemActionType.Upload;
+        readonly title: string;
+        readonly icon: "fa-light fa-upload";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Download: {
+        readonly key: AXPSystemActionType.Download;
+        readonly title: string;
+        readonly icon: "fa-light fa-download";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Copy: {
+        readonly key: AXPSystemActionType.Copy;
+        readonly title: string;
+        readonly icon: "fa-light fa-copy";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Move: {
+        readonly key: AXPSystemActionType.Move;
+        readonly title: string;
+        readonly icon: "fa-light fa-arrow-right-arrow-left";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Rename: {
+        readonly key: AXPSystemActionType.Rename;
+        readonly title: string;
+        readonly icon: "fa-light fa-pen";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Manage: {
+        readonly key: AXPSystemActionType.Manage;
+        readonly title: string;
+        readonly icon: "fa-light fa-gear";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Info: {
+        readonly key: AXPSystemActionType.Info;
+        readonly title: string;
+        readonly icon: "fa-light fa-info";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Confirm: {
+        readonly key: AXPSystemActionType.Confirm;
+        readonly title: string;
+        readonly icon: "fa-light fa-check";
+        readonly color: "success";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Design: {
+        readonly key: AXPSystemActionType.Design;
+        readonly title: string;
+        readonly icon: "fa-light fa-paintbrush";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly VersionHistory: {
+        readonly key: AXPSystemActionType.VersionHistory;
+        readonly title: string;
+        readonly icon: "fa-light fa-history";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Compare: {
+        readonly key: AXPSystemActionType.Compare;
+        readonly title: string;
+        readonly icon: "fa-light fa-code-compare";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Comments: {
+        readonly key: AXPSystemActionType.Comments;
+        readonly title: string;
+        readonly icon: "fa-light fa-comments";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Sign: {
+        readonly key: AXPSystemActionType.Sign;
+        readonly title: string;
+        readonly icon: "fa-light fa-signature";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Setup: {
+        readonly key: AXPSystemActionType.Setup;
+        readonly title: string;
+        readonly icon: "fa-light fa-cog";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Send: {
+        readonly key: AXPSystemActionType.Send;
+        readonly title: string;
+        readonly icon: "fa-light fa-envelope";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Report: {
+        readonly key: AXPSystemActionType.Report;
+        readonly title: string;
+        readonly icon: "fa-light fa-chart-line";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Sent: {
+        readonly key: AXPSystemActionType.Sent;
+        readonly title: string;
+        readonly icon: "fa-light fa-paper-plane";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Review: {
+        readonly key: AXPSystemActionType.Review;
+        readonly title: string;
+        readonly icon: "fa-light fa-eye";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Generate: {
+        readonly key: AXPSystemActionType.Generate;
+        readonly title: string;
+        readonly icon: "fa-light fa-wand-magic-sparkles";
+        readonly color: "primary";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Refresh: {
+        readonly key: AXPSystemActionType.Refresh;
+        readonly title: string;
+        readonly icon: "fa-light fa-arrows-rotate";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Reload: {
+        readonly key: AXPSystemActionType.Reload;
+        readonly title: string;
+        readonly icon: "fa-light fa-arrows-rotate";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Search: {
+        readonly key: AXPSystemActionType.Search;
+        readonly title: string;
+        readonly icon: "fa-light fa-magnifying-glass";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Filter: {
+        readonly key: AXPSystemActionType.Filter;
+        readonly title: string;
+        readonly icon: "fa-light fa-filter";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Sort: {
+        readonly key: AXPSystemActionType.Sort;
+        readonly title: string;
+        readonly icon: "fa-light fa-arrow-down-up-across-line";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Start: {
+        readonly key: AXPSystemActionType.Start;
+        readonly title: string;
+        readonly icon: "fa-light fa-play";
+        readonly color: "success";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Stop: {
+        readonly key: AXPSystemActionType.Stop;
+        readonly title: string;
+        readonly icon: "fa-light fa-stop";
+        readonly color: "danger";
+        readonly critical: true;
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Pause: {
+        readonly key: AXPSystemActionType.Pause;
+        readonly title: string;
+        readonly icon: "fa-light fa-pause";
+        readonly color: "warning";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Cancel: {
+        readonly key: AXPSystemActionType.Cancel;
+        readonly title: string;
+        readonly icon: "fa-light fa-xmark";
+        readonly critical: true;
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Close: {
+        readonly key: AXPSystemActionType.Close;
+        readonly title: string;
+        readonly icon: "fa-light fa-xmark";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Complete: {
+        readonly key: AXPSystemActionType.Complete;
+        readonly title: string;
+        readonly icon: "fa-light fa-check";
+        readonly color: "success";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Save: {
+        readonly key: AXPSystemActionType.Save;
+        readonly title: string;
+        readonly icon: "fa-light fa-floppy-disk";
+        readonly color: "primary";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly SaveAs: {
+        readonly key: AXPSystemActionType.SaveAs;
+        readonly title: string;
+        readonly icon: "fa-light fa-floppy-disk";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Sync: {
+        readonly key: AXPSystemActionType.Sync;
+        readonly title: string;
+        readonly icon: "fa-light fa-arrows-rotate";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Reset: {
+        readonly key: AXPSystemActionType.Reset;
+        readonly title: string;
+        readonly icon: "fa-light fa-arrow-rotate-left";
+        readonly color: "warning";
+        readonly critical: true;
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Clear: {
+        readonly key: AXPSystemActionType.Clear;
+        readonly title: string;
+        readonly icon: "fa-light fa-eraser";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+    readonly Distribution: {
+        readonly key: AXPSystemActionType.Distribution;
+        readonly title: string;
+        readonly icon: "fa-light fa-share-nodes";
+        readonly color: "default";
+        readonly descriptions: {
+            readonly title: string;
+            readonly tooltip: string;
+            readonly permission: string;
+            readonly audit: string;
+        };
+    };
+}>;
+declare function getSystemActions(type: AXPSystemActionType): AXPSystemAction;
+/**
+ * Resolves the visual appearance (color and icon) for entity actions.
+ */
+declare function resolveActionLook(actionType: string): {
+    color: AXStyleColorType;
+    icon: string;
+};
+/**
+ * Resolves the title, description, icon and color for button actions.
+ */
+declare function getActionButton(actionType: string): {
+    name: string;
+    title: string;
+    description: string;
+    icon: string;
+    color: string;
+};
+
 type AXPPlatformScopeKey = 'P' | 'T' | 'U';
 declare enum AXPPlatformScope {
     Platform = "P",
@@ -243,6 +988,120 @@ interface AXPMiddlewareErrorResponse {
     };
 }
 
+declare function extractNestedFieldsWildcard(obj: any, basePath: string, fields: string[]): any;
+declare function setSmart(obj: any, smartPath: string, value: any): any;
+declare function getSmart(obj: any, smartPath: string): any;
+declare function extractValue<T = any>(value: any, key?: string): T | null;
+declare function cleanDeep(obj: any): any;
+type ChangeEntry = {
+    path: string;
+    oldValue: any;
+    newValue: any;
+    arrayDiff?: {
+        added: any[];
+        removed: any[];
+    };
+};
+declare function getChangedPaths(obj1: any, obj2: any): string[];
+declare function getDetailedChanges(obj1: any, obj2: any): ChangeEntry[];
+declare function getEnumValues(enumType: any): {
+    id: string;
+    title: string;
+}[];
+/**
+ * Lookup/select expose may write a resolved MLS string while the baseline keeps the locale map.
+ * Restore baseline shape when the string matches any locale entry.
+ */
+declare function shouldRestoreSavedMultiLanguageShape(value: unknown, savedAtPath: unknown): boolean;
+/**
+ * Semantic equality for lookup/select values when restoring saved baseline shape.
+ * Compares by selection identity (id), including two full items with the same id.
+ */
+declare function isSelectionValueEqual(a: unknown, b: unknown): boolean;
+/**
+ * Semantic equality for dirty-state and baseline checks.
+ * Prefer over lodash `isEqual` when comparing user-edited form/context data to a saved baseline.
+ *
+ * Arrays: `[]`, `null`, and all-empty lists are equivalent; non-empty arrays compare as multisets (order ignored).
+ */
+declare function isFormValueEqual(a: unknown, b: unknown): boolean;
+/**
+ * Returns whether `current` differs from the saved/clean `baseline` snapshot.
+ */
+declare function isFormContextDirty(current: Record<string, unknown>, baseline: Record<string, unknown>): boolean;
+interface FormContextDirtyDiffEntry {
+    path: string;
+    current: unknown;
+    baseline: unknown;
+    selectionEqual: boolean;
+}
+/**
+ * Lists paths where live context differs from baseline (for dirty-state trace logs).
+ */
+declare function summarizeFormContextDirtyDiff(current: Record<string, unknown>, baseline: Record<string, unknown>, maxEntries?: number): FormContextDirtyDiffEntry[];
+/**
+ * Clones a context object for use as a dirty-tracking baseline.
+ */
+declare function captureFormContextBaseline(context: Record<string, unknown>): Record<string, unknown>;
+
+/**
+ * If `raw` is a plain non-array object with a `value` property, returns `value`; otherwise returns `raw`.
+ */
+declare function unwrapValueProperty(raw: unknown): unknown;
+/**
+ * Coerces to a trimmed string. Plain objects may carry `{ value }` from setting widgets or `{ id }` from select payloads using `valueField: 'id'`.
+ */
+declare function coerceUnknownToTrimmedString(raw: unknown): string;
+/**
+ * Coerces to boolean: direct booleans pass through; wrapped `{ value: true | 'true' }` is respected; otherwise false.
+ */
+declare function coerceUnknownToBoolean(raw: unknown): boolean;
+/** Parses a finite number after optional `{ value }` unwrap; non-finite or empty string yields NaN. */
+declare function coerceUnknownToFiniteNumber(raw: unknown): number;
+/** Parses a Date after optional `{ value }` unwrap; invalid input yields Invalid Date. */
+declare function coerceUnknownToDate(raw: unknown): Date;
+
+declare function extractTextFromHtml(value: string): string;
+/**
+ * True when the string likely contains HTML markup (e.g. `<p>`, `<ul>`), as opposed to plain text.
+ * Used to choose innerHTML vs text interpolation for multilingual fields.
+ */
+declare function containsHtmlMarkup(value: string | null | undefined): boolean;
+/**
+ * Generate kebab-case group name from title
+ */
+declare function generateKebabCase(title: string): string;
+
+/**
+ * Locale-aware comparison of {@link AXPMultiLanguageString} values (plain string, `@scope:key`, or locale map).
+ * Resolves each side with {@link resolveMultiLanguageString} for `locale`, then compares with `String#localeCompare`.
+ */
+declare function compareMultiLanguageStrings(a: AXPMultiLanguageString | null | undefined, b: AXPMultiLanguageString | null | undefined, locale: string, collatorOptions?: Intl.CollatorOptions): number;
+/**
+ * Stable sort copy: orders items by resolved string for `getValue(item)` using the active `locale`.
+ */
+declare function sortByMultiLanguageString<T>(items: readonly T[], getValue: (item: T) => AXPMultiLanguageString | null | undefined, locale: string, collatorOptions?: Intl.CollatorOptions): T[];
+/**
+ * True when the resolved value contains `query` (case-insensitive) for `locale`.
+ * Useful for search/filter flows over {@link AXPMultiLanguageString}.
+ */
+declare function searchInMultiLanguageString(value: AXPMultiLanguageString | null | undefined, query: string, locale: string): boolean;
+
+/** Per-locale string map (`{ 'en-US': '...', 'fa-IR': '...' }`). */
+declare function isLocaleStringMap(value: unknown): value is Record<string, string>;
+/**
+ * Use locale-map read/write when the option is on or live/saved data is already a map.
+ * Auto-enables when API data is a map but the editor option was left off.
+ */
+declare function shouldUseLocaleMapShape(localeMapOptionEnabled: boolean, current: unknown, saved: unknown): boolean;
+/** Updates one locale entry; preserves sibling locales from current or saved map. */
+declare function buildLocaleTextMapValue(current: unknown, saved: unknown, lang: string, input: string): Record<string, string> | null;
+
+/**
+ * Resolves {@link AXPMultiLanguageString} to a plain string for the given locale.
+ */
+declare function resolveMultiLanguageString(value: AXPMultiLanguageString | null | undefined, locale: string): string;
+
 interface AXPPagedListResult<T = unknown> {
     items: T[];
     total: number;
@@ -2210,11 +3069,7 @@ declare const AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY = "Widget:Preview";
  * Standalone copy for connectivity mocks — no dependency on @acorex/core/translation.
  */
 declare function createMultiLanguageString(enUS: string, faIR?: string): Record<string, string>;
-/**
- * Resolves {@link AXPMultiLanguageString} to a plain string for the given locale.
- * Standalone copy for connectivity mocks — no dependency on @acorex/core/translation.
- */
-declare function resolveMultiLanguageString(value: AXPMultiLanguageString | null | undefined, locale: string): string;
+
 /**
  * Lightweight data helpers for mock seed files.
  * Standalone copy for connectivity mocks — no dependency on @acorex/platform/core.
@@ -2468,5 +3323,5 @@ declare class AXPIntegrationMissingScopeError extends Error {
     constructor(providerId: string, missingScopes: string[], message?: string);
 }
 
-export { AXPDataGenerator, AXPExportTemplateToken, AXPFileStorageStatus, AXPIntegrationExpiredError, AXPIntegrationMissingScopeError, AXPIntegrationNotConnectedError, AXPPlatformCoreDataSourceKeys, AXPPlatformScope, AXPRegionalSetting, AXPStatusProvider, AXPSystemActionType, AXPSystemStatusType, AXPSystemStatuses, AXPWidgetsCatalog, AXPWidgetsList, AXP_INTEGRATION_AUTH_METHOD_TYPE, AXP_INTEGRATION_CAPABILITY, AXP_INTEGRATION_CATEGORY, AXP_INTEGRATION_CONNECTION_SCOPE, AXP_INTEGRATION_CONNECTION_STATUS, AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY, createMultiLanguageString, getNestedKeys, getStatusInfo, getSystemStatus, normalizeDefinitionCategories, resolveMultiLanguageString, resolvePlatformScopeKey, resolvePlatformScopeName, resolveStatusLook, systemStatusToDefinition };
-export type { AXDataSourceFilterOption, AXDataSourceOperator, AXDataSourceOperatorType, AXDataSourceSortOption, AXFilterLogic, AXPActionMenuItem, AXPActivityCategory, AXPActivityDefinition, AXPActivityDefinitionCategoryRef, AXPActivityDefinitionQueryResult, AXPActivityExecutionContextState, AXPActivityIncident, AXPActivityStatus, AXPActivityVariable, AXPAddressData, AXPAddressLabel, AXPAddressMode, AXPAgentOutputKind, AXPApplicationUserReference, AXPBackButton, AXPBadge, AXPBookmark, AXPBreadcrumbItem, AXPCategorizedEntity, AXPCategorizedEntityDto, AXPCategoryEntity, AXPCategoryEntityWithItems, AXPCategoryListItem, AXPColumnQuery, AXPCommandMessage, AXPCompletionCallbackState, AXPConnection, AXPContent, AXPContentDirection, AXPContentType, AXPDataType, AXPDefinitionCategory, AXPElsaWorkflowExtensions, AXPEntityOp, AXPEntityReference, AXPEqualValidationRule, AXPExceptionState, AXPExecuteCommand, AXPExecuteCommandResult, AXPExportCsvOptions, AXPExportExcelOptions, AXPExportOptions, AXPExportPdfOptions, AXPExportPrintOptions, AXPExpression, AXPFileListItem, AXPFileManyStorageInfo, AXPFileSource, AXPFileStatus, AXPFileStorageCreateRequest, AXPFileStorageFindRequest, AXPFileStorageInfo, AXPFileStorageUpdateRequest, AXPFilterClause, AXPFilterDefinition, AXPFilterQuery, AXPFilterTriggerDefinition, AXPFlowDirection, AXPGridLayoutOptions, AXPGridPlacement, AXPIntegrationApiTokenAuthMethodDefinition, AXPIntegrationApiTokenSecretPayload, AXPIntegrationAuthContext, AXPIntegrationAuthFieldDefinition, AXPIntegrationAuthMethodDefinition, AXPIntegrationAuthMethodType, AXPIntegrationBasicAuthMethodDefinition, AXPIntegrationBasicSecretPayload, AXPIntegrationCapability, AXPIntegrationCategory, AXPIntegrationConnectionScope, AXPIntegrationConnectionStatus, AXPIntegrationOAuth2AuthMethodDefinition, AXPIntegrationOAuthSecretPayload, AXPIntegrationPatAuthMethodDefinition, AXPIntegrationPatSecretPayload, AXPIntegrationProviderDefinition, AXPIntegrationProviderListItemDto, AXPIntegrationProviderRuntimeHooks, AXPIntegrationResolvedCredentials, AXPIntegrationRuntimeContext, AXPIntegrationSecretPayload, AXPIntegrationValidationResult, AXPLogoConfig, AXPMaxLengthValidationRule, AXPMaybePromise, AXPMetaData, AXPMetaDataDefinition, AXPMetaDataFeatures, AXPMiddlewareErrorResponse, AXPMinLengthValidationRule, AXPMultiLanguageString, AXPMultiSourceRef, AXPOptionsData, AXPOutputTranscriptSegmentId, AXPPageStatus, AXPPagedListResult, AXPPartialNested, AXPPlatformScopeKey, AXPProperty, AXPPropertyGroup, AXPPropertyInterface, AXPQueryFetchResult, AXPQueryRequest, AXPReqexValidationRule, AXPRequiredValidationRule, AXPSafeIntegrationConnectionDto, AXPSortDefinition, AXPSortQuery, AXPSpreadsheetCellValue, AXPSpreadsheetData, AXPStatusDefinition, AXPStatusTransition, AXPStringValidationRules, AXPSystemAction, AXPTaskType, AXPUserReference, AXPValidationRule, AXPValidationRules, AXPValueTransformerFunction, AXPValueTransformerFunctions, AXPValueUnit, AXPValueUnits, AXPViewBlockDefinition, AXPViewDefinition, AXPViewFieldDefinition, AXPViewQuery, AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetTrigger, AXPWidgetTriggers, AXPWorkflowActivityInstance, AXPWorkflowBinding, AXPWorkflowCategory, AXPWorkflowContinuationBeforeInteractive, AXPWorkflowContinuationMetadata, AXPWorkflowDefinition, AXPWorkflowExtensions, AXPWorkflowFaultState, AXPWorkflowGraph, AXPWorkflowInstance, AXPWorkflowOutputProperty, AXPWorkflowState, AXPWorkflowStatus, AXPWorkflowSubStatus, AXPopupSizeType, AXStyleColorType };
+export { AXPContextChangeEvent, AXPDataGenerator, AXPExportTemplateToken, AXPFileStorageStatus, AXPIntegrationExpiredError, AXPIntegrationMissingScopeError, AXPIntegrationNotConnectedError, AXPPlatformCoreDataSourceKeys, AXPPlatformScope, AXPRegionalSetting, AXPStatusProvider, AXPSystemActionType, AXPSystemActions, AXPSystemStatusType, AXPSystemStatuses, AXPWidgetsCatalog, AXPWidgetsList, AXP_INTEGRATION_AUTH_METHOD_TYPE, AXP_INTEGRATION_CAPABILITY, AXP_INTEGRATION_CATEGORY, AXP_INTEGRATION_CONNECTION_SCOPE, AXP_INTEGRATION_CONNECTION_STATUS, AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY, buildLocaleTextMapValue, captureFormContextBaseline, cleanDeep, coerceUnknownToBoolean, coerceUnknownToDate, coerceUnknownToFiniteNumber, coerceUnknownToTrimmedString, compareMultiLanguageStrings, containsHtmlMarkup, createMultiLanguageString, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getStatusInfo, getSystemActions, getSystemStatus, isFormContextDirty, isFormValueEqual, isLocaleStringMap, isSelectionValueEqual, normalizeDefinitionCategories, resolveActionLook, resolveMultiLanguageString, resolvePlatformScopeKey, resolvePlatformScopeName, resolveStatusLook, searchInMultiLanguageString, setSmart, shouldRestoreSavedMultiLanguageShape, shouldUseLocaleMapShape, sortByMultiLanguageString, summarizeFormContextDirtyDiff, systemStatusToDefinition, unwrapValueProperty };
+export type { AXDataSourceFilterOption, AXDataSourceOperator, AXDataSourceOperatorType, AXDataSourceSortOption, AXFilterLogic, AXPActionMenuItem, AXPActivityCategory, AXPActivityDefinition, AXPActivityDefinitionCategoryRef, AXPActivityDefinitionQueryResult, AXPActivityExecutionContextState, AXPActivityIncident, AXPActivityStatus, AXPActivityVariable, AXPAddressData, AXPAddressLabel, AXPAddressMode, AXPAgentOutputKind, AXPApplicationUserReference, AXPBackButton, AXPBadge, AXPBookmark, AXPBreadcrumbItem, AXPCategorizedEntity, AXPCategorizedEntityDto, AXPCategoryEntity, AXPCategoryEntityWithItems, AXPCategoryListItem, AXPColumnQuery, AXPCommandMessage, AXPCompletionCallbackState, AXPConnection, AXPContent, AXPContentDirection, AXPContentType, AXPContextData, AXPContextPatchOptions, AXPContextState, AXPContextUpdateOptions, AXPContextUpdateOrigin, AXPDataType, AXPDefinitionCategory, AXPElsaWorkflowExtensions, AXPEntityOp, AXPEntityReference, AXPEqualValidationRule, AXPExceptionState, AXPExecuteCommand, AXPExecuteCommandResult, AXPExportCsvOptions, AXPExportExcelOptions, AXPExportOptions, AXPExportPdfOptions, AXPExportPrintOptions, AXPExpression, AXPFileListItem, AXPFileManyStorageInfo, AXPFileSource, AXPFileStatus, AXPFileStorageCreateRequest, AXPFileStorageFindRequest, AXPFileStorageInfo, AXPFileStorageUpdateRequest, AXPFilterClause, AXPFilterDefinition, AXPFilterQuery, AXPFilterTriggerDefinition, AXPFlowDirection, AXPGridLayoutOptions, AXPGridPlacement, AXPIntegrationApiTokenAuthMethodDefinition, AXPIntegrationApiTokenSecretPayload, AXPIntegrationAuthContext, AXPIntegrationAuthFieldDefinition, AXPIntegrationAuthMethodDefinition, AXPIntegrationAuthMethodType, AXPIntegrationBasicAuthMethodDefinition, AXPIntegrationBasicSecretPayload, AXPIntegrationCapability, AXPIntegrationCategory, AXPIntegrationConnectionScope, AXPIntegrationConnectionStatus, AXPIntegrationOAuth2AuthMethodDefinition, AXPIntegrationOAuthSecretPayload, AXPIntegrationPatAuthMethodDefinition, AXPIntegrationPatSecretPayload, AXPIntegrationProviderDefinition, AXPIntegrationProviderListItemDto, AXPIntegrationProviderRuntimeHooks, AXPIntegrationResolvedCredentials, AXPIntegrationRuntimeContext, AXPIntegrationSecretPayload, AXPIntegrationValidationResult, AXPLogoConfig, AXPMaxLengthValidationRule, AXPMaybePromise, AXPMetaData, AXPMetaDataDefinition, AXPMetaDataFeatures, AXPMiddlewareErrorResponse, AXPMinLengthValidationRule, AXPMultiLanguageString, AXPMultiSourceRef, AXPOptionsData, AXPOutputTranscriptSegmentId, AXPPageStatus, AXPPagedListResult, AXPPartialNested, AXPPlatformScopeKey, AXPProperty, AXPPropertyGroup, AXPPropertyInterface, AXPQueryFetchResult, AXPQueryRequest, AXPReqexValidationRule, AXPRequiredValidationRule, AXPSafeIntegrationConnectionDto, AXPSortDefinition, AXPSortQuery, AXPSpreadsheetCellValue, AXPSpreadsheetData, AXPStatusDefinition, AXPStatusTransition, AXPStringValidationRules, AXPSystemAction, AXPTaskType, AXPUserReference, AXPValidationRule, AXPValidationRules, AXPValueTransformerFunction, AXPValueTransformerFunctions, AXPValueUnit, AXPValueUnits, AXPViewBlockDefinition, AXPViewDefinition, AXPViewFieldDefinition, AXPViewQuery, AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetTrigger, AXPWidgetTriggers, AXPWorkflowActivityInstance, AXPWorkflowBinding, AXPWorkflowCategory, AXPWorkflowContinuationBeforeInteractive, AXPWorkflowContinuationMetadata, AXPWorkflowDefinition, AXPWorkflowExtensions, AXPWorkflowFaultState, AXPWorkflowGraph, AXPWorkflowInstance, AXPWorkflowOutputProperty, AXPWorkflowState, AXPWorkflowStatus, AXPWorkflowSubStatus, AXPopupSizeType, AXStyleColorType, FormContextDirtyDiffEntry };