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

package/fesm2022/acorex-platform-contracts.mjs

@@ -1,3 +1,5 @@
+import { isPlainObject, get, set, isNil, isEmpty, isArray, merge, isObjectLike, transform, isEqual, differenceWith, union, cloneDeep } from 'lodash-es';
+
 //#region ---- Core contract types (no Angular / no @acorex/*) ----
 /** Returns dot-path keys for a nested plain object. */
 function getNestedKeys(obj, prefix = '') {
@@ -83,6 +85,855 @@ var AXPSystemActionType;
 })(AXPSystemActionType || (AXPSystemActionType = {}));
 //#endregion
 
+//#region ---- Context store contracts ----
+class AXPContextChangeEvent {
+}
+//#endregion
+
+/**
+ * Additional suggested generic actions for future consideration:
+ *
+ * Data & Content Actions:
+ * - Search = 'search' - Search functionality
+ * - Filter = 'filter' - Apply filters
+ * - Sort = 'sort' - Sort data
+ * - Group = 'group' - Group data
+ * - Expand = 'expand' - Expand details
+ * - Collapse = 'collapse' - Collapse details
+ * - Pin = 'pin' - Pin to favorites
+ * - Bookmark = 'bookmark' - Bookmark item
+ * - Favorite = 'favorite' - Mark as favorite
+ * - Star = 'star' - Star rating
+ *
+ * Workflow Actions:
+ * - Start = 'start' - Start process/workflow
+ * - Stop = 'stop' - Stop process
+ * - Pause = 'pause' - Pause process
+ * - Resume = 'resume' - Resume process
+ * - Cancel = 'cancel' - Cancel operation
+ * - Complete = 'complete' - Mark as complete
+ * - Close = 'close' - Close item
+ * - Reopen = 'reopen' - Reopen closed item
+ * - Forward = 'forward' - Forward to next step
+ * - Back = 'back' - Go back
+ *
+ * Communication Actions:
+ * - Reply = 'reply' - Reply to message
+ * - Forward = 'forward' - Forward message
+ * - Notify = 'notify' - Send notification
+ * - Invite = 'invite' - Invite user
+ * - Join = 'join' - Join group/meeting
+ * - Leave = 'leave' - Leave group/meeting
+ *
+ * Security Actions:
+ * - Login = 'login' - User login
+ * - Logout = 'logout' - User logout
+ * - Block = 'block' - Block user/content
+ * - Unblock = 'unblock' - Unblock user/content
+ * - Ban = 'ban' - Ban user
+ * - Unban = 'unban' - Unban user
+ * - Verify = 'verify' - Verify identity
+ * - Authenticate = 'authenticate' - Authenticate
+ *
+ * File & Media Actions:
+ * - Open = 'open' - Open file
+ * - Save = 'save' - Save file
+ * - SaveAs = 'save-as' - Save as new file
+ * - Attach = 'attach' - Attach file
+ * - Detach = 'detach' - Detach file
+ * - Compress = 'compress' - Compress files
+ * - Extract = 'extract' - Extract archive
+ * - Convert = 'convert' - Convert format
+ * - Crop = 'crop' - Crop image
+ * - Resize = 'resize' - Resize image
+ *
+ * System Actions:
+ * - Sync = 'sync' - Synchronize data
+ * - Backup = 'backup' - Create backup
+ * - Restore = 'restore' - Restore from backup
+ * - Reset = 'reset' - Reset to defaults
+ * - Clear = 'clear' - Clear data
+ * - Optimize = 'optimize' - Optimize performance
+ * - Update = 'update' - Update system
+ * - Install = 'install' - Install component
+ * - Uninstall = 'uninstall' - Uninstall component
+ * - Enable = 'enable' - Enable feature
+ * - Disable = 'disable' - Disable feature
+ *
+ * Analytics & Monitoring:
+ * - Monitor = 'monitor' - Monitor activity
+ * - Track = 'track' - Track progress
+ * - Analyze = 'analyze' - Analyze data
+ * - Debug = 'debug' - Debug issue
+ * - Log = 'log' - View logs
+ * - Alert = 'alert' - Set alert
+ * - Dashboard = 'dashboard' - View dashboard
+ * - Metrics = 'metrics' - View metrics
+ *
+ * Collaboration Actions:
+ * - Collaborate = 'collaborate' - Start collaboration
+ * - Share = 'share' - Share content
+ * - Comment = 'comment' - Add comment
+ * - Like = 'like' - Like content
+ * - Follow = 'follow' - Follow user/content
+ * - Subscribe = 'subscribe' - Subscribe to updates
+ * - Unsubscribe = 'unsubscribe' - Unsubscribe
+ * - Rate = 'rate' - Rate content
+ * - Review = 'review' - Review content
+ * - Recommend = 'recommend' - Recommend content
+ */
+const i18n$1 = (key) => `@general:actions.${key}`;
+const AXPSystemActions = Object.freeze({
+    View: {
+        key: AXPSystemActionType.View,
+        title: i18n$1('view.title'),
+        icon: 'fa-light fa-eye',
+        color: 'primary',
+        descriptions: {
+            title: i18n$1('view.title'),
+            tooltip: i18n$1('view.description'),
+            permission: i18n$1('view.permission'),
+            audit: i18n$1('view.audit')
+        }
+    },
+    Create: {
+        key: AXPSystemActionType.Create,
+        title: i18n$1('create.title'),
+        icon: 'fa-light fa-plus',
+        color: 'primary',
+        descriptions: {
+            title: i18n$1('create.title'),
+            tooltip: i18n$1('create.description'),
+            permission: i18n$1('create.permission'),
+            audit: i18n$1('create.audit')
+        }
+    },
+    Edit: {
+        key: AXPSystemActionType.Update,
+        title: i18n$1('edit.title'),
+        icon: 'fa-light fa-pen',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('edit.title'),
+            tooltip: i18n$1('edit.description'),
+            permission: i18n$1('edit.permission'),
+            audit: i18n$1('edit.audit')
+        }
+    },
+    Delete: {
+        key: AXPSystemActionType.Delete,
+        title: i18n$1('delete.title'),
+        icon: 'fa-light fa-trash',
+        color: 'danger',
+        critical: true,
+        descriptions: {
+            title: i18n$1('delete.title'),
+            tooltip: i18n$1('delete.description'),
+            permission: i18n$1('delete.permission'),
+            audit: i18n$1('delete.audit')
+        }
+    },
+    Approve: {
+        key: AXPSystemActionType.Approve,
+        title: i18n$1('approve.title'),
+        icon: 'fa-light fa-circle-check',
+        color: 'success',
+        critical: true,
+        descriptions: {
+            title: i18n$1('approve.title'),
+            tooltip: i18n$1('approve.description'),
+            permission: i18n$1('approve.permission'),
+            audit: i18n$1('approve.audit')
+        }
+    },
+    Submit: {
+        key: AXPSystemActionType.Submit,
+        title: i18n$1('submit.title'),
+        icon: 'fa-light fa-paper-plane',
+        color: 'primary',
+        descriptions: {
+            title: i18n$1('submit.title'),
+            tooltip: i18n$1('submit.description'),
+            permission: i18n$1('submit.permission'),
+            audit: i18n$1('submit.audit')
+        }
+    },
+    Reject: {
+        key: AXPSystemActionType.Reject,
+        title: i18n$1('reject.title'),
+        icon: 'fa-light fa-ban',
+        color: 'danger',
+        critical: true,
+        descriptions: {
+            title: i18n$1('reject.title'),
+            tooltip: i18n$1('reject.description'),
+            permission: i18n$1('reject.permission'),
+            audit: i18n$1('reject.audit')
+        }
+    },
+    Export: {
+        key: AXPSystemActionType.Export,
+        title: i18n$1('export.title'),
+        icon: 'fa-light fa-download',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('export.title'),
+            tooltip: i18n$1('export.description'),
+            permission: i18n$1('export.permission'),
+            audit: i18n$1('export.audit')
+        }
+    },
+    Import: {
+        key: AXPSystemActionType.Import,
+        title: i18n$1('import.title'),
+        icon: 'fa-light fa-upload',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('import.title'),
+            tooltip: i18n$1('import.description'),
+            permission: i18n$1('import.permission'),
+            audit: i18n$1('import.audit')
+        }
+    },
+    Print: {
+        key: AXPSystemActionType.Print,
+        title: i18n$1('print.title'),
+        icon: 'fa-light fa-print',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('print.title'),
+            tooltip: i18n$1('print.description'),
+            permission: i18n$1('print.permission'),
+            audit: i18n$1('print.audit')
+        }
+    },
+    Duplicate: {
+        key: AXPSystemActionType.Duplicate,
+        title: i18n$1('duplicate.title'),
+        icon: 'fa-light fa-clone',
+        color: 'warning',
+        descriptions: {
+            title: i18n$1('duplicate.title'),
+            tooltip: i18n$1('duplicate.description'),
+            permission: i18n$1('duplicate.permission'),
+            audit: i18n$1('duplicate.audit')
+        }
+    },
+    Archive: {
+        key: AXPSystemActionType.Archive,
+        title: i18n$1('archive.title'),
+        icon: 'fa-light fa-box-archive',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('archive.title'),
+            tooltip: i18n$1('archive.description'),
+            permission: i18n$1('archive.permission'),
+            audit: i18n$1('archive.audit')
+        }
+    },
+    Restore: {
+        key: AXPSystemActionType.Restore,
+        title: i18n$1('restore.title'),
+        icon: 'fa-light fa-arrow-rotate-left',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('restore.title'),
+            tooltip: i18n$1('restore.description'),
+            permission: i18n$1('restore.permission'),
+            audit: i18n$1('restore.audit')
+        }
+    },
+    Assign: {
+        key: AXPSystemActionType.Assign,
+        title: i18n$1('assign.title'),
+        icon: 'fa-light fa-user-plus',
+        color: 'primary',
+        descriptions: {
+            title: i18n$1('assign.title'),
+            tooltip: i18n$1('assign.description'),
+            permission: i18n$1('assign.permission'),
+            audit: i18n$1('assign.audit')
+        }
+    },
+    Lock: {
+        key: AXPSystemActionType.Lock,
+        title: i18n$1('lock.title'),
+        icon: 'fa-light fa-lock',
+        color: 'warning',
+        descriptions: {
+            title: i18n$1('lock.title'),
+            tooltip: i18n$1('lock.description'),
+            permission: i18n$1('lock.permission'),
+            audit: i18n$1('lock.audit')
+        }
+    },
+    Unlock: {
+        key: AXPSystemActionType.Unlock,
+        title: i18n$1('unlock.title'),
+        icon: 'fa-light fa-unlock',
+        color: 'success',
+        descriptions: {
+            title: i18n$1('unlock.title'),
+            tooltip: i18n$1('unlock.description'),
+            permission: i18n$1('unlock.permission'),
+            audit: i18n$1('unlock.audit')
+        }
+    },
+    Share: {
+        key: AXPSystemActionType.Share,
+        title: i18n$1('share.title'),
+        icon: 'fa-light fa-share-nodes',
+        color: 'info',
+        descriptions: {
+            title: i18n$1('share.title'),
+            tooltip: i18n$1('share.description'),
+            permission: i18n$1('share.permission'),
+            audit: i18n$1('share.audit')
+        }
+    },
+    Configure: {
+        key: AXPSystemActionType.Configure,
+        title: i18n$1('configure.title'),
+        icon: 'fa-light fa-sliders',
+        color: 'primary',
+        descriptions: {
+            title: i18n$1('configure.title'),
+            tooltip: i18n$1('configure.description'),
+            permission: i18n$1('configure.permission'),
+            audit: i18n$1('configure.audit')
+        }
+    },
+    Reorder: {
+        key: AXPSystemActionType.Reorder,
+        title: i18n$1('reorder.title'),
+        icon: 'fa-light fa-arrow-down-up-across-line',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('reorder.title'),
+            tooltip: i18n$1('reorder.description'),
+            permission: i18n$1('reorder.permission'),
+            audit: i18n$1('reorder.audit')
+        }
+    },
+    Preview: {
+        key: AXPSystemActionType.Preview,
+        title: i18n$1('preview.title'),
+        icon: 'fa-light fa-magnifying-glass',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('preview.title'),
+            tooltip: i18n$1('preview.description'),
+            permission: i18n$1('preview.permission'),
+            audit: i18n$1('preview.audit')
+        }
+    },
+    Publish: {
+        key: AXPSystemActionType.Publish,
+        title: i18n$1('publish.title'),
+        icon: 'fa-light fa-globe',
+        color: 'success',
+        descriptions: {
+            title: i18n$1('publish.title'),
+            tooltip: i18n$1('publish.description'),
+            permission: i18n$1('publish.permission'),
+            audit: i18n$1('publish.audit')
+        }
+    },
+    Unpublish: {
+        key: AXPSystemActionType.Unpublish,
+        title: i18n$1('unpublish.title'),
+        icon: 'fa-light fa-globe-slash',
+        color: 'danger',
+        descriptions: {
+            title: i18n$1('unpublish.title'),
+            tooltip: i18n$1('unpublish.description'),
+            permission: i18n$1('unpublish.permission'),
+            audit: i18n$1('unpublish.audit')
+        }
+    },
+    Upload: {
+        key: AXPSystemActionType.Upload,
+        title: i18n$1('upload.title'),
+        icon: 'fa-light fa-upload',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('upload.title'),
+            tooltip: i18n$1('upload.description'),
+            permission: i18n$1('upload.permission'),
+            audit: i18n$1('upload.audit')
+        }
+    },
+    Download: {
+        key: AXPSystemActionType.Download,
+        title: i18n$1('download.title'),
+        icon: 'fa-light fa-download',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('download.title'),
+            tooltip: i18n$1('download.description'),
+            permission: i18n$1('download.permission'),
+            audit: i18n$1('download.audit')
+        }
+    },
+    Copy: {
+        key: AXPSystemActionType.Copy,
+        title: i18n$1('copy.title'),
+        icon: 'fa-light fa-copy',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('copy.title'),
+            tooltip: i18n$1('copy.description'),
+            permission: i18n$1('copy.permission'),
+            audit: i18n$1('copy.audit')
+        }
+    },
+    Move: {
+        key: AXPSystemActionType.Move,
+        title: i18n$1('move.title'),
+        icon: 'fa-light fa-arrow-right-arrow-left',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('move.title'),
+            tooltip: i18n$1('move.description'),
+            permission: i18n$1('move.permission'),
+            audit: i18n$1('move.audit')
+        }
+    },
+    Rename: {
+        key: AXPSystemActionType.Rename,
+        title: i18n$1('rename.title'),
+        icon: 'fa-light fa-pen',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('rename.title'),
+            tooltip: i18n$1('rename.description'),
+            permission: i18n$1('rename.permission'),
+            audit: i18n$1('rename.audit')
+        }
+    },
+    Manage: {
+        key: AXPSystemActionType.Manage,
+        title: i18n$1('manage.title'),
+        icon: 'fa-light fa-gear',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('manage.title'),
+            tooltip: i18n$1('manage.description'),
+            permission: i18n$1('manage.permission'),
+            audit: i18n$1('manage.audit')
+        }
+    },
+    Info: {
+        key: AXPSystemActionType.Info,
+        title: i18n$1('info.title'),
+        icon: 'fa-light fa-info',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('info.title'),
+            tooltip: i18n$1('info.description'),
+            permission: i18n$1('info.permission'),
+            audit: i18n$1('info.audit')
+        }
+    },
+    Confirm: {
+        key: AXPSystemActionType.Confirm,
+        title: i18n$1('confirm.title'),
+        icon: 'fa-light fa-check',
+        color: 'success',
+        descriptions: {
+            title: i18n$1('confirm.title'),
+            tooltip: i18n$1('confirm.description'),
+            permission: i18n$1('confirm.permission'),
+            audit: i18n$1('confirm.audit')
+        }
+    },
+    Design: {
+        key: AXPSystemActionType.Design,
+        title: i18n$1('design.title'),
+        icon: 'fa-light fa-paintbrush',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('design.title'),
+            tooltip: i18n$1('design.description'),
+            permission: i18n$1('design.permission'),
+            audit: i18n$1('design.audit')
+        }
+    },
+    VersionHistory: {
+        key: AXPSystemActionType.VersionHistory,
+        title: i18n$1('version-history.title'),
+        icon: 'fa-light fa-history',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('version-history.title'),
+            tooltip: i18n$1('version-history.description'),
+            permission: i18n$1('version-history.permission'),
+            audit: i18n$1('version-history.audit')
+        }
+    },
+    Compare: {
+        key: AXPSystemActionType.Compare,
+        title: i18n$1('compare.title'),
+        icon: 'fa-light fa-code-compare',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('compare.title'),
+            tooltip: i18n$1('compare.description'),
+            permission: i18n$1('compare.permission'),
+            audit: i18n$1('compare.audit')
+        }
+    },
+    Comments: {
+        key: AXPSystemActionType.Comments,
+        title: i18n$1('comments.title'),
+        icon: 'fa-light fa-comments',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('comments.title'),
+            tooltip: i18n$1('comments.description'),
+            permission: i18n$1('comments.permission'),
+            audit: i18n$1('comments.audit')
+        }
+    },
+    Sign: {
+        key: AXPSystemActionType.Sign,
+        title: i18n$1('sign.title'),
+        icon: 'fa-light fa-signature',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('sign.title'),
+            tooltip: i18n$1('sign.description'),
+            permission: i18n$1('sign.permission'),
+            audit: i18n$1('sign.audit')
+        }
+    },
+    Setup: {
+        key: AXPSystemActionType.Setup,
+        title: i18n$1('setup.title'),
+        icon: 'fa-light fa-cog',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('setup.title'),
+            tooltip: i18n$1('setup.description'),
+            permission: i18n$1('setup.permission'),
+            audit: i18n$1('setup.audit')
+        }
+    },
+    Send: {
+        key: AXPSystemActionType.Send,
+        title: i18n$1('send.title'),
+        icon: 'fa-light fa-envelope',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('send.title'),
+            tooltip: i18n$1('send.description'),
+            permission: i18n$1('send.permission'),
+            audit: i18n$1('send.audit')
+        }
+    },
+    Report: {
+        key: AXPSystemActionType.Report,
+        title: i18n$1('report.title'),
+        icon: 'fa-light fa-chart-line',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('report.title'),
+            tooltip: i18n$1('report.description'),
+            permission: i18n$1('report.permission'),
+            audit: i18n$1('report.audit')
+        }
+    },
+    Sent: {
+        key: AXPSystemActionType.Sent,
+        title: i18n$1('sent.title'),
+        icon: 'fa-light fa-paper-plane',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('sent.title'),
+            tooltip: i18n$1('sent.description'),
+            permission: i18n$1('sent.permission'),
+            audit: i18n$1('sent.audit')
+        }
+    },
+    Review: {
+        key: AXPSystemActionType.Review,
+        title: i18n$1('review.title'),
+        icon: 'fa-light fa-eye',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('review.title'),
+            tooltip: i18n$1('review.description'),
+            permission: i18n$1('review.permission'),
+            audit: i18n$1('review.audit')
+        }
+    },
+    Generate: {
+        key: AXPSystemActionType.Generate,
+        title: i18n$1('generate.title'),
+        icon: 'fa-light fa-wand-magic-sparkles',
+        color: 'primary',
+        descriptions: {
+            title: i18n$1('generate.title'),
+            tooltip: i18n$1('generate.description'),
+            permission: i18n$1('generate.permission'),
+            audit: i18n$1('generate.audit')
+        }
+    },
+    Refresh: {
+        key: AXPSystemActionType.Refresh,
+        title: i18n$1('refresh.title'),
+        icon: 'fa-light fa-arrows-rotate',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('refresh.title'),
+            tooltip: i18n$1('refresh.description'),
+            permission: i18n$1('refresh.permission'),
+            audit: i18n$1('refresh.audit')
+        }
+    },
+    Reload: {
+        key: AXPSystemActionType.Reload,
+        title: i18n$1('reload.title'),
+        icon: 'fa-light fa-arrows-rotate',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('reload.title'),
+            tooltip: i18n$1('reload.description'),
+            permission: i18n$1('reload.permission'),
+            audit: i18n$1('reload.audit')
+        }
+    },
+    Search: {
+        key: AXPSystemActionType.Search,
+        title: i18n$1('search.title'),
+        icon: 'fa-light fa-magnifying-glass',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('search.title'),
+            tooltip: i18n$1('search.description'),
+            permission: i18n$1('search.permission'),
+            audit: i18n$1('search.audit')
+        }
+    },
+    Filter: {
+        key: AXPSystemActionType.Filter,
+        title: i18n$1('filter.title'),
+        icon: 'fa-light fa-filter',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('filter.title'),
+            tooltip: i18n$1('filter.description'),
+            permission: i18n$1('filter.permission'),
+            audit: i18n$1('filter.audit')
+        }
+    },
+    Sort: {
+        key: AXPSystemActionType.Sort,
+        title: i18n$1('sort.title'),
+        icon: 'fa-light fa-arrow-down-up-across-line',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('sort.title'),
+            tooltip: i18n$1('sort.description'),
+            permission: i18n$1('sort.permission'),
+            audit: i18n$1('sort.audit')
+        }
+    },
+    Start: {
+        key: AXPSystemActionType.Start,
+        title: i18n$1('start.title'),
+        icon: 'fa-light fa-play',
+        color: 'success',
+        descriptions: {
+            title: i18n$1('start.title'),
+            tooltip: i18n$1('start.description'),
+            permission: i18n$1('start.permission'),
+            audit: i18n$1('start.audit')
+        }
+    },
+    Stop: {
+        key: AXPSystemActionType.Stop,
+        title: i18n$1('stop.title'),
+        icon: 'fa-light fa-stop',
+        color: 'danger',
+        critical: true,
+        descriptions: {
+            title: i18n$1('stop.title'),
+            tooltip: i18n$1('stop.description'),
+            permission: i18n$1('stop.permission'),
+            audit: i18n$1('stop.audit')
+        }
+    },
+    Pause: {
+        key: AXPSystemActionType.Pause,
+        title: i18n$1('pause.title'),
+        icon: 'fa-light fa-pause',
+        color: 'warning',
+        descriptions: {
+            title: i18n$1('pause.title'),
+            tooltip: i18n$1('pause.description'),
+            permission: i18n$1('pause.permission'),
+            audit: i18n$1('pause.audit')
+        }
+    },
+    Cancel: {
+        key: AXPSystemActionType.Cancel,
+        title: i18n$1('cancel.title'),
+        icon: 'fa-light fa-xmark',
+        critical: true,
+        descriptions: {
+            title: i18n$1('cancel.title'),
+            tooltip: i18n$1('cancel.description'),
+            permission: i18n$1('cancel.permission'),
+            audit: i18n$1('cancel.audit')
+        }
+    },
+    Close: {
+        key: AXPSystemActionType.Close,
+        title: i18n$1('close.title'),
+        icon: 'fa-light fa-xmark',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('close.title'),
+            tooltip: i18n$1('close.description'),
+            permission: i18n$1('close.permission'),
+            audit: i18n$1('close.audit')
+        }
+    },
+    Complete: {
+        key: AXPSystemActionType.Complete,
+        title: i18n$1('complete.title'),
+        icon: 'fa-light fa-check',
+        color: 'success',
+        descriptions: {
+            title: i18n$1('complete.title'),
+            tooltip: i18n$1('complete.description'),
+            permission: i18n$1('complete.permission'),
+            audit: i18n$1('complete.audit')
+        }
+    },
+    Save: {
+        key: AXPSystemActionType.Save,
+        title: i18n$1('save.title'),
+        icon: 'fa-light fa-floppy-disk',
+        color: 'primary',
+        descriptions: {
+            title: i18n$1('save.title'),
+            tooltip: i18n$1('save.description'),
+            permission: i18n$1('save.permission'),
+            audit: i18n$1('save.audit')
+        }
+    },
+    SaveAs: {
+        key: AXPSystemActionType.SaveAs,
+        title: i18n$1('save-as.title'),
+        icon: 'fa-light fa-floppy-disk',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('save-as.title'),
+            tooltip: i18n$1('save-as.description'),
+            permission: i18n$1('save-as.permission'),
+            audit: i18n$1('save-as.audit')
+        }
+    },
+    Sync: {
+        key: AXPSystemActionType.Sync,
+        title: i18n$1('sync.title'),
+        icon: 'fa-light fa-arrows-rotate',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('sync.title'),
+            tooltip: i18n$1('sync.description'),
+            permission: i18n$1('sync.permission'),
+            audit: i18n$1('sync.audit')
+        }
+    },
+    Reset: {
+        key: AXPSystemActionType.Reset,
+        title: i18n$1('reset.title'),
+        icon: 'fa-light fa-arrow-rotate-left',
+        color: 'warning',
+        critical: true,
+        descriptions: {
+            title: i18n$1('reset.title'),
+            tooltip: i18n$1('reset.description'),
+            permission: i18n$1('reset.permission'),
+            audit: i18n$1('reset.audit')
+        }
+    },
+    Clear: {
+        key: AXPSystemActionType.Clear,
+        title: i18n$1('clear.title'),
+        icon: 'fa-light fa-eraser',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('clear.title'),
+            tooltip: i18n$1('clear.description'),
+            permission: i18n$1('clear.permission'),
+            audit: i18n$1('clear.audit')
+        }
+    },
+    Distribution: {
+        key: AXPSystemActionType.Distribution,
+        title: i18n$1('distribution.title'),
+        icon: 'fa-light fa-share-nodes',
+        color: 'default',
+        descriptions: {
+            title: i18n$1('distribution.title'),
+            tooltip: i18n$1('distribution.description'),
+            permission: i18n$1('distribution.permission'),
+            audit: i18n$1('distribution.audit')
+        }
+    },
+});
+function getSystemActions(type) {
+    return Object.values(AXPSystemActions).find(action => action.key === type);
+}
+/**
+ * Resolves the visual appearance (color and icon) for entity actions.
+ */
+function resolveActionLook(actionType) {
+    const systemActionType = actionType;
+    if (systemActionType) {
+        const systemAction = getSystemActions(systemActionType);
+        if (systemAction) {
+            return {
+                color: (systemAction.color || 'default'),
+                icon: systemAction.icon || ''
+            };
+        }
+    }
+    return {
+        color: 'default',
+        icon: ''
+    };
+}
+/**
+ * Resolves the title, description, icon and color for button actions.
+ */
+function getActionButton(actionType) {
+    const systemActionType = actionType;
+    if (systemActionType) {
+        const systemAction = getSystemActions(systemActionType);
+        if (systemAction) {
+            return {
+                name: actionType,
+                icon: systemAction.icon || '',
+                color: systemAction.color || 'default',
+                title: systemAction.title,
+                description: systemAction.descriptions.title
+            };
+        }
+    }
+    return {
+        name: actionType,
+        title: actionType,
+        description: `Perform ${actionType} action`,
+        icon: '',
+        color: 'default'
+    };
+}
+
 //#region ---- CDK / component shims (pure contracts, no @acorex/cdk) ----
 //#endregion
 
@@ -120,6 +971,890 @@ function resolvePlatformScopeName(scope) {
 //#region ---- Core contracts ----
 //#endregion
 
+//#region ---- Locale map shape ----
+/** Per-locale string map (`{ 'en-US': '...', 'fa-IR': '...' }`). */
+function isLocaleStringMap(value) {
+    if (!isPlainObject(value)) {
+        return false;
+    }
+    const entries = Object.values(value);
+    if (entries.length === 0) {
+        return false;
+    }
+    return entries.every((entry) => entry === null || entry === undefined || typeof entry === '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.
+ */
+function shouldUseLocaleMapShape(localeMapOptionEnabled, current, saved) {
+    return localeMapOptionEnabled || isLocaleStringMap(current) || isLocaleStringMap(saved);
+}
+/** Updates one locale entry; preserves sibling locales from current or saved map. */
+function buildLocaleTextMapValue(current, saved, lang, input) {
+    const seed = isLocaleStringMap(current)
+        ? { ...current }
+        : isLocaleStringMap(saved)
+            ? { ...saved }
+            : {};
+    seed[lang] = input ?? '';
+    for (const key of Object.keys(seed)) {
+        if ((seed[key] ?? '').trim() === '') {
+            delete seed[key];
+        }
+    }
+    return Object.keys(seed).length === 0 ? null : seed;
+}
+//#endregion
+
+function extractNestedFieldsWildcard(obj, basePath, fields) {
+    const result = {};
+    if (fields.length === 1 && fields[0] === '*') {
+        const fullObj = get(obj, basePath);
+        return isPlainObject(fullObj) ? fullObj : {};
+    }
+    for (const field of fields) {
+        const fullPath = basePath ? `${basePath}.${field}` : field;
+        const value = get(obj, fullPath);
+        set(result, field, value);
+    }
+    return result;
+}
+function setSmart(obj, smartPath, value) {
+    const pathParts = smartPath.split('.');
+    const lastPart = pathParts[pathParts.length - 1];
+    const fieldMatch = lastPart.match(/^\{(.+)\}$/);
+    if (!fieldMatch) {
+        // Fix: If value is undefined and we're setting a nested property,
+        // check if the parent object exists and if setting this would result in
+        // all properties being undefined. If so, set the parent to null instead.
+        if (isNil(value) && pathParts.length > 1) {
+            const parentPath = pathParts.slice(0, -1).join('.');
+            const parentObj = get(obj, parentPath);
+            // If parent is already null/undefined, don't recreate the object structure
+            if (isNil(parentObj)) {
+                return obj;
+            }
+            // Check if parent is a plain object (not array, not null)
+            if (isPlainObject(parentObj)) {
+                const existingKeys = Object.keys(parentObj);
+                // Check if all existing properties are null/undefined using lodash
+                const allNil = isEmpty(existingKeys) || existingKeys.every((key) => isNil(parentObj[key]));
+                if (allNil) {
+                    // Set parent to null instead of creating/keeping an object with all undefined properties
+                    set(obj, parentPath, null);
+                    return obj;
+                }
+            }
+        }
+        set(obj, smartPath, value);
+        // After setting, check again if parent should be null using lodash
+        if (isNil(value) && pathParts.length > 1) {
+            const parentPath = pathParts.slice(0, -1).join('.');
+            const parentObj = get(obj, parentPath);
+            if (isPlainObject(parentObj)) {
+                // Use lodash to check if all properties are null/undefined
+                const allNil = Object.keys(parentObj).every((key) => isNil(parentObj[key]));
+                if (allNil) {
+                    set(obj, parentPath, null);
+                }
+            }
+        }
+        return obj;
+    }
+    const fields = fieldMatch[1].split(',').map((f) => f.trim());
+    const basePath = pathParts.slice(0, -1).join('.');
+    const [arrayKey, ...restPath] = basePath.split('.');
+    // Make sure the array exists
+    if (!obj[arrayKey])
+        obj[arrayKey] = [];
+    // 🟡 Case A: value is array (normal set)
+    if (isArray(value)) {
+        for (let i = 0; i < value.length; i++) {
+            const item = value[i];
+            const targetItem = obj[arrayKey][i] ?? {};
+            const nested = {};
+            if (restPath.length > 0) {
+                const picked = extractNestedFieldsWildcard(item, restPath.join('.'), fields);
+                set(nested, restPath.join('.'), picked);
+            }
+            else {
+                const picked = extractNestedFieldsWildcard(item, '', fields);
+                Object.assign(nested, picked);
+            }
+            obj[arrayKey][i] = merge({}, targetItem, nested);
+        }
+    }
+    // 🟢 Case B: value is a single value → broadcast
+    else {
+        for (let i = 0; i < obj[arrayKey].length; i++) {
+            const targetItem = obj[arrayKey][i] ?? {};
+            const nested = {};
+            if (restPath.length > 0) {
+                for (const field of fields) {
+                    set(nested, `${restPath.join('.')}.${field}`, value);
+                }
+            }
+            else {
+                for (const field of fields) {
+                    set(nested, field, value);
+                }
+            }
+            obj[arrayKey][i] = merge({}, targetItem, nested);
+        }
+    }
+    return obj;
+}
+function extractFieldsFromPath(obj, basePath, fields) {
+    if (fields.length === 1 && fields[0] === '*') {
+        const fullObj = basePath ? get(obj, basePath) : obj;
+        return isPlainObject(fullObj) ? fullObj : {};
+    }
+    const result = {};
+    for (const field of fields) {
+        const fullPath = basePath ? `${basePath}.${field}` : field;
+        const val = get(obj, fullPath);
+        if (val !== undefined) {
+            result[field] = val;
+        }
+    }
+    return result;
+}
+function getSmart(obj, smartPath) {
+    const pathParts = smartPath.split('.');
+    const lastPart = pathParts[pathParts.length - 1];
+    const fieldMatch = lastPart.match(/^\{(.+)\}$/);
+    // Simple get (no fields)
+    if (!fieldMatch) {
+        return get(obj, smartPath);
+    }
+    const fields = fieldMatch[1].split(',').map((f) => f.trim());
+    const basePath = pathParts.slice(0, -1).join('.');
+    const items = get(obj, basePath);
+    if (!isArray(items))
+        return [];
+    const nestedPath = basePath.includes('.') ? basePath.split('.').slice(1).join('.') : '';
+    return items.map((item) => {
+        return extractFieldsFromPath(item, nestedPath, fields);
+    });
+}
+function extractValue(value, key = 'id') {
+    if (isNil(value)) {
+        return null;
+    }
+    return isObjectLike(value) ? get(value, key) : value;
+}
+function cleanDeep(obj) {
+    return transform(obj, (result, value, key) => {
+        if (isObjectLike(value)) {
+            const cleaned = cleanDeep(value);
+            if (!isEmpty(cleaned)) {
+                result[key] = cleaned;
+            }
+        }
+        else if (!isNil(value) && // not null or undefined
+            !(typeof value === 'string' && value.trim() === '') && // not empty string
+            !(Array.isArray(value) && value.length === 0) // not empty array
+        ) {
+            result[key] = value;
+        }
+    });
+}
+function getDeepChanges(obj1, obj2) {
+    const changes = [];
+    function walk(o1, o2, currentPath = []) {
+        // If both values are deeply equal, skip
+        if (isEqual(o1, o2))
+            return;
+        const isObj1Nil = o1 === null || o1 === undefined;
+        const isObj2Nil = o2 === null || o2 === undefined;
+        // If obj1 is null/undefined and obj2 is not, treat entire obj2 as added
+        if (isObj1Nil && !isObj2Nil) {
+            if (isPlainObject(o2)) {
+                for (const key of Object.keys(o2)) {
+                    walk(undefined, o2[key], [...currentPath, key]);
+                }
+            }
+            else if (Array.isArray(o2)) {
+                changes.push({
+                    path: currentPath.join('.'),
+                    oldValue: undefined,
+                    newValue: o2,
+                    arrayDiff: {
+                        added: o2,
+                        removed: [],
+                    },
+                });
+            }
+            else {
+                changes.push({
+                    path: currentPath.join('.'),
+                    oldValue: undefined,
+                    newValue: o2,
+                });
+            }
+            return;
+        }
+        // If obj2 is null/undefined and obj1 is not, treat entire obj1 as removed
+        if (!isObj1Nil && isObj2Nil) {
+            if (isPlainObject(o1)) {
+                for (const key of Object.keys(o1)) {
+                    walk(o1[key], undefined, [...currentPath, key]);
+                }
+            }
+            else if (Array.isArray(o1)) {
+                changes.push({
+                    path: currentPath.join('.'),
+                    oldValue: o1,
+                    newValue: undefined,
+                    arrayDiff: {
+                        added: [],
+                        removed: o1,
+                    },
+                });
+            }
+            else {
+                changes.push({
+                    path: currentPath.join('.'),
+                    oldValue: o1,
+                    newValue: undefined,
+                });
+            }
+            return;
+        }
+        // If both are arrays, compare items
+        if (Array.isArray(o1) && Array.isArray(o2)) {
+            if (!isEqual(o1, o2)) {
+                const added = differenceWith(o2, o1, isEqual);
+                const removed = differenceWith(o1, o2, isEqual);
+                changes.push({
+                    path: currentPath.join('.'),
+                    oldValue: o1,
+                    newValue: o2,
+                    arrayDiff: {
+                        added,
+                        removed,
+                    },
+                });
+            }
+            return;
+        }
+        // If both are plain objects, walk each key
+        if (isPlainObject(o1) && isPlainObject(o2)) {
+            const allKeys = union(Object.keys(o1), Object.keys(o2));
+            for (const key of allKeys) {
+                walk(o1[key], o2[key], [...currentPath, key]);
+            }
+            return;
+        }
+        // Primitive values or mismatched types
+        changes.push({
+            path: currentPath.join('.'),
+            oldValue: o1,
+            newValue: o2,
+        });
+    }
+    walk(obj1, obj2);
+    return changes;
+}
+// Method 1: Returns only changed paths
+function getChangedPaths(obj1, obj2) {
+    return getDeepChanges(obj1, obj2).map((change) => change.path);
+}
+// Method 2: Returns full change entries
+function getDetailedChanges(obj1, obj2) {
+    return getDeepChanges(obj1, obj2);
+}
+function getEnumValues(enumType) {
+    return Object.entries(enumType).map(([key, value]) => ({ id: value, title: key }));
+}
+//#region ---- Form value equality (dirty / baseline) ----
+/** Whether a value uses the multi-language text widget shape (string or locale map). */
+function isMultiLanguageFormShape(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (typeof value === 'string') {
+        return true;
+    }
+    return isLocaleStringMap(value);
+}
+/** Drops empty/whitespace locale entries from a multi-language map. */
+function normalizeLocaleStringMap(value) {
+    const normalized = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry !== 'string') {
+            continue;
+        }
+        const trimmed = entry.trim();
+        if (trimmed !== '') {
+            normalized[key] = trimmed;
+        }
+    }
+    return Object.keys(normalized).length === 0 ? null : normalized;
+}
+function compareMultiLanguageLocaleStrings(a, b) {
+    const htmlEqual = compareHtmlFormValues(a, b);
+    if (htmlEqual !== null) {
+        return htmlEqual;
+    }
+    return a === b;
+}
+/**
+ * Compares multi-language field values (plain string vs locale map) for dirty/baseline checks.
+ * Returns `null` when either side is not a multi-language shape (caller uses generic normalization).
+ */
+function compareMultiLanguageFormValues(a, b) {
+    if (!isMultiLanguageFormShape(a) || !isMultiLanguageFormShape(b)) {
+        return null;
+    }
+    const normalizeScalar = (value) => {
+        if (value === null || value === undefined) {
+            return null;
+        }
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            return trimmed === '' ? null : trimmed;
+        }
+        if (isLocaleStringMap(value)) {
+            return normalizeLocaleStringMap(value);
+        }
+        return null;
+    };
+    const left = normalizeScalar(a);
+    const right = normalizeScalar(b);
+    if (left === null && right === null) {
+        return true;
+    }
+    if (left === null || right === null) {
+        return false;
+    }
+    if (typeof left === 'string' && typeof right === 'string') {
+        return compareMultiLanguageLocaleStrings(left, right);
+    }
+    if (typeof left === 'string' && typeof right === 'object') {
+        return Object.values(right).some((text) => typeof text === 'string' && compareMultiLanguageLocaleStrings(left, text));
+    }
+    if (typeof right === 'string' && typeof left === 'object') {
+        return Object.values(left).some((text) => typeof text === 'string' && compareMultiLanguageLocaleStrings(right, text));
+    }
+    if (typeof left !== 'object' || typeof right !== 'object') {
+        return false;
+    }
+    const leftMap = left;
+    const rightMap = right;
+    const leftKeys = Object.keys(leftMap).sort();
+    const rightKeys = Object.keys(rightMap).sort();
+    if (leftKeys.length !== rightKeys.length) {
+        return false;
+    }
+    return leftKeys.every((key) => compareMultiLanguageLocaleStrings(leftMap[key], rightMap[key]));
+}
+/**
+ * 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.
+ */
+function shouldRestoreSavedMultiLanguageShape(value, savedAtPath) {
+    if (typeof value !== 'string' || !isLocaleStringMap(savedAtPath)) {
+        return false;
+    }
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        return false;
+    }
+    return Object.values(savedAtPath).some((entry) => typeof entry === 'string' && entry.trim() === trimmed);
+}
+/** Decode common HTML entities for rich-text baseline compare. */
+function decodeHtmlEntities(value) {
+    return value
+        .replace(/&#x([0-9a-f]+);/gi, (_, hex) => String.fromCharCode(parseInt(hex, 16)))
+        .replace(/&#(\d+);/g, (_, dec) => String.fromCharCode(parseInt(dec, 10)))
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"');
+}
+function looksLikeHtmlFormValue(value) {
+    return /<[a-z][\s\S]*>/i.test(value.trim());
+}
+/** Normalizes rich-text HTML for semantic dirty/baseline compare (e.g. Quill `p`/`br` drift). */
+function normalizeRichTextHtmlForCompare(value) {
+    const html = decodeHtmlEntities(value.trim());
+    if (typeof document === 'undefined') {
+        return html.replace(/\s+/g, ' ').trim();
+    }
+    const doc = new DOMParser().parseFromString(html, 'text/html');
+    return (doc.body.textContent ?? '').replace(/\s+/g, ' ').trim();
+}
+/**
+ * Compares rich-text HTML strings by visible text (ignores `p` vs `br` structure drift).
+ * Returns `null` when either side is not HTML markup.
+ */
+function compareHtmlFormValues(a, b) {
+    if (typeof a !== 'string' || typeof b !== 'string') {
+        return null;
+    }
+    if (!looksLikeHtmlFormValue(a) || !looksLikeHtmlFormValue(b)) {
+        return null;
+    }
+    return normalizeRichTextHtmlForCompare(a) === normalizeRichTextHtmlForCompare(b);
+}
+/** Lookup/select filter-mode payload: `{ value, displayText?, operation }`. */
+function isFilterFormShape(value) {
+    if (!isPlainObject(value)) {
+        return false;
+    }
+    const record = value;
+    return 'value' in record && 'operation' in record;
+}
+/**
+ * Compares filter-mode widget values by selection identity; ignores derived `displayText`.
+ */
+function compareFilterFormValues(a, b) {
+    if (!isFilterFormShape(a) || !isFilterFormShape(b)) {
+        return null;
+    }
+    const left = a;
+    const right = b;
+    if (!isFormValueEqual(left['value'], right['value'])) {
+        return false;
+    }
+    const opLeft = get(left, 'operation.type');
+    const opRight = get(right, 'operation.type');
+    if (opLeft !== undefined || opRight !== undefined) {
+        return opLeft === opRight;
+    }
+    return true;
+}
+function isReferenceScalar(value) {
+    return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';
+}
+/** Scalar id or `{ id }` identity used by lookup/select widgets. */
+function getReferenceId(value) {
+    if (isNil(value)) {
+        return undefined;
+    }
+    if (isReferenceScalar(value)) {
+        return value;
+    }
+    if (isPlainObject(value)) {
+        const id = get(value, 'id');
+        if (!isNil(id)) {
+            return id;
+        }
+    }
+    return undefined;
+}
+/**
+ * Compares scalar selection ids to full lookup/select items (`5` vs `{ id: 5, ... }`).
+ * Does not apply when both sides are objects — those use structural compare so field edits stay dirty.
+ */
+function compareReferenceFormValues(a, b) {
+    const refA = getReferenceId(a);
+    const refB = getReferenceId(b);
+    if (refA === undefined || refB === undefined) {
+        return null;
+    }
+    const aIsScalar = isReferenceScalar(a);
+    const bIsScalar = isReferenceScalar(b);
+    if (!aIsScalar && !bIsScalar) {
+        return null;
+    }
+    return isEqual(normalizeFormValue(refA), normalizeFormValue(refB));
+}
+/**
+ * Semantic equality for lookup/select values when restoring saved baseline shape.
+ * Compares by selection identity (id), including two full items with the same id.
+ */
+function isSelectionValueEqual(a, b) {
+    const filterEqual = compareFilterFormValues(a, b);
+    if (filterEqual !== null) {
+        return filterEqual;
+    }
+    const refA = getReferenceId(a);
+    const refB = getReferenceId(b);
+    if (refA !== undefined && refB !== undefined) {
+        return isEqual(normalizeFormValue(refA), normalizeFormValue(refB));
+    }
+    return isFormValueEqual(a, b);
+}
+/**
+ * Stable sort key for order-insensitive array comparison (after normalization).
+ */
+function formValueSortKey(value) {
+    if (value === null) {
+        return '\0';
+    }
+    if (typeof value === 'number') {
+        return `n:${value}`;
+    }
+    if (typeof value === 'boolean') {
+        return `b:${value}`;
+    }
+    if (typeof value === 'string') {
+        return `s:${value}`;
+    }
+    try {
+        return `j:${JSON.stringify(value)}`;
+    }
+    catch {
+        return `u:${String(value)}`;
+    }
+}
+/**
+ * Sorts normalized array items so order does not affect dirty checks.
+ */
+function sortNormalizedArrayItems(items) {
+    return [...items].sort((a, b) => formValueSortKey(a).localeCompare(formValueSortKey(b)));
+}
+/**
+ * Normalizes a form/context value for semantic baseline comparison.
+ *
+ * Rules:
+ * - `null`, `undefined`, whitespace-only strings, and empty arrays → `null` (empty)
+ * - Numeric strings → numbers (`"5"` and `5` match)
+ * - Arrays → elements normalized; empty/all-empty → `null`; otherwise sorted (order ignored)
+ * - Plain objects → keys sorted; `null`/empty nested values omitted
+ * - `Date` → epoch milliseconds
+ */
+function normalizeFormValue(value) {
+    if (value === undefined || value === null) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (trimmed === '') {
+            return null;
+        }
+        if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+            const num = Number(trimmed);
+            if (!Number.isNaN(num)) {
+                return num;
+            }
+        }
+        return trimmed;
+    }
+    if (typeof value === 'number') {
+        return Number.isNaN(value) ? null : value;
+    }
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (value instanceof Date) {
+        return value.getTime();
+    }
+    if (isArray(value)) {
+        const normalizedItems = value
+            .map((item) => normalizeFormValue(item))
+            .filter((item) => item !== null);
+        if (normalizedItems.length === 0) {
+            return null;
+        }
+        return sortNormalizedArrayItems(normalizedItems);
+    }
+    if (isPlainObject(value)) {
+        const record = value;
+        if (isLocaleStringMap(record)) {
+            return normalizeLocaleStringMap(record);
+        }
+        const normalized = {};
+        for (const key of Object.keys(record).sort()) {
+            const next = normalizeFormValue(record[key]);
+            if (next !== null) {
+                normalized[key] = next;
+            }
+        }
+        return normalized;
+    }
+    return value;
+}
+/**
+ * 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).
+ */
+function isFormValueEqual(a, b) {
+    const multiLanguageEqual = compareMultiLanguageFormValues(a, b);
+    if (multiLanguageEqual !== null) {
+        return multiLanguageEqual;
+    }
+    const filterEqual = compareFilterFormValues(a, b);
+    if (filterEqual !== null) {
+        return filterEqual;
+    }
+    const referenceEqual = compareReferenceFormValues(a, b);
+    if (referenceEqual !== null) {
+        return referenceEqual;
+    }
+    if (isArray(a) && isArray(b)) {
+        // Empty repeater rows normalize away; raw length must differ before multiset compare.
+        if (a.length !== b.length) {
+            return false;
+        }
+        return isEqual(normalizeFormValue(a), normalizeFormValue(b));
+    }
+    if (isPlainObject(a) && isPlainObject(b)) {
+        const left = a;
+        const right = b;
+        const keys = new Set([...Object.keys(left), ...Object.keys(right)]);
+        for (const key of keys) {
+            if (!isFormValueEqual(left[key], right[key])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    if (typeof a === 'string' && typeof b === 'string') {
+        const htmlEqual = compareHtmlFormValues(a, b);
+        if (htmlEqual !== null) {
+            return htmlEqual;
+        }
+    }
+    return isEqual(normalizeFormValue(a), normalizeFormValue(b));
+}
+/**
+ * Returns whether `current` differs from the saved/clean `baseline` snapshot.
+ */
+function isFormContextDirty(current, baseline) {
+    return !isFormValueEqual(current, baseline);
+}
+/**
+ * Lists paths where live context differs from baseline (for dirty-state trace logs).
+ */
+function summarizeFormContextDirtyDiff(current, baseline, maxEntries = 12) {
+    const diffs = [];
+    const walk = (path, currentValue, baselineValue) => {
+        if (diffs.length >= maxEntries) {
+            return;
+        }
+        if (isFormValueEqual(currentValue, baselineValue)) {
+            return;
+        }
+        const bothPlainObjects = isPlainObject(currentValue) &&
+            isPlainObject(baselineValue) &&
+            !isArray(currentValue) &&
+            !isArray(baselineValue);
+        if (bothPlainObjects) {
+            const left = currentValue;
+            const right = baselineValue;
+            const keys = new Set([...Object.keys(left), ...Object.keys(right)]);
+            for (const key of keys) {
+                if (diffs.length >= maxEntries) {
+                    return;
+                }
+                const nextPath = path ? `${path}.${key}` : key;
+                walk(nextPath, left[key], right[key]);
+            }
+            return;
+        }
+        diffs.push({
+            path: path || '(root)',
+            current: currentValue,
+            baseline: baselineValue,
+            selectionEqual: isSelectionValueEqual(currentValue, baselineValue),
+        });
+    };
+    walk('', current, baseline);
+    return diffs;
+}
+/**
+ * Clones a context object for use as a dirty-tracking baseline.
+ */
+function captureFormContextBaseline(context) {
+    return cloneDeep(context);
+}
+//#endregion
+
+//#region ---- Unwrapping ----
+/**
+ * If `raw` is a plain non-array object with a `value` property, returns `value`; otherwise returns `raw`.
+ */
+function unwrapValueProperty(raw) {
+    if (raw && typeof raw === 'object' && !Array.isArray(raw) && !(raw instanceof Date) && 'value' in raw) {
+        return raw.value;
+    }
+    return raw;
+}
+//#endregion
+//#region ---- Scalar coercion ----
+/**
+ * Coerces to a trimmed string. Plain objects may carry `{ value }` from setting widgets or `{ id }` from select payloads using `valueField: 'id'`.
+ */
+function coerceUnknownToTrimmedString(raw) {
+    if (typeof raw === 'string') {
+        return raw.trim();
+    }
+    if (raw && typeof raw === 'object' && !Array.isArray(raw) && !(raw instanceof Date)) {
+        const r = raw;
+        if ('value' in r && r['value'] != null) {
+            return String(r['value']).trim();
+        }
+        if ('id' in r && r['id'] != null) {
+            return String(r['id']).trim();
+        }
+    }
+    return '';
+}
+/**
+ * Coerces to boolean: direct booleans pass through; wrapped `{ value: true | 'true' }` is respected; otherwise false.
+ */
+function coerceUnknownToBoolean(raw) {
+    if (typeof raw === 'boolean') {
+        return raw;
+    }
+    if (raw && typeof raw === 'object' && 'value' in raw) {
+        const v = raw.value;
+        return v === true || v === 'true';
+    }
+    return false;
+}
+/** Parses a finite number after optional `{ value }` unwrap; non-finite or empty string yields NaN. */
+function coerceUnknownToFiniteNumber(raw) {
+    const v = unwrapValueProperty(raw);
+    if (v === null || v === undefined) {
+        return NaN;
+    }
+    if (typeof v === 'number') {
+        return Number.isFinite(v) ? v : NaN;
+    }
+    if (typeof v === 'boolean') {
+        return v ? 1 : 0;
+    }
+    if (typeof v === 'string') {
+        const t = v.trim();
+        if (t === '') {
+            return NaN;
+        }
+        const n = Number(t);
+        return Number.isFinite(n) ? n : NaN;
+    }
+    return NaN;
+}
+/** Parses a Date after optional `{ value }` unwrap; invalid input yields Invalid Date. */
+function coerceUnknownToDate(raw) {
+    const v = unwrapValueProperty(raw);
+    if (v === null || v === undefined) {
+        return new Date(NaN);
+    }
+    if (v instanceof Date) {
+        return new Date(v.getTime());
+    }
+    if (typeof v === 'number' && Number.isFinite(v)) {
+        return new Date(v);
+    }
+    if (typeof v === 'string') {
+        const t = v.trim();
+        if (t === '') {
+            return new Date(NaN);
+        }
+        return new Date(t);
+    }
+    return new Date(NaN);
+}
+//#endregion
+
+function extractTextFromHtml(value) {
+    const div = document.createElement('div');
+    div.innerHTML = value;
+    return div.textContent || div.innerText || '';
+}
+/**
+ * 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.
+ */
+function containsHtmlMarkup(value) {
+    if (value == null) {
+        return false;
+    }
+    const t = value.trim();
+    if (!t) {
+        return false;
+    }
+    return /<\/?[a-z][\s\S]*?>/i.test(t);
+}
+/**
+ * Generate kebab-case group name from title
+ */
+function generateKebabCase(title) {
+    return title
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9\s-]/g, '') // Remove special characters
+        .replace(/\s+/g, '-') // Replace spaces with hyphens
+        .replace(/-+/g, '-') // Replace multiple hyphens with single
+        .replace(/^-+|-+$/g, ''); // Remove leading/trailing hyphens
+}
+
+//#region ---- Shared utilities ----
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Resolve ----
+/**
+ * Resolves {@link AXPMultiLanguageString} to a plain string for the given locale.
+ */
+function resolveMultiLanguageString(value, locale) {
+    if (value == null || value === '') {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    const direct = value[locale];
+    if (typeof direct === 'string' && direct.length > 0) {
+        return direct;
+    }
+    const enUS = value['en-US'];
+    if (typeof enUS === 'string' && enUS.length > 0) {
+        return enUS;
+    }
+    for (const entry of Object.values(value)) {
+        if (typeof entry === 'string' && entry.length > 0) {
+            return entry;
+        }
+    }
+    return '';
+}
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Compare & sort ----
+const DEFAULT_COLLATOR_OPTIONS = { sensitivity: 'base' };
+/**
+ * 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`.
+ */
+function compareMultiLanguageStrings(a, b, locale, collatorOptions = DEFAULT_COLLATOR_OPTIONS) {
+    const sa = resolveMultiLanguageString(a ?? '', locale);
+    const sb = resolveMultiLanguageString(b ?? '', locale);
+    return sa.localeCompare(sb, locale, collatorOptions);
+}
+/**
+ * Stable sort copy: orders items by resolved string for `getValue(item)` using the active `locale`.
+ */
+function sortByMultiLanguageString(items, getValue, locale, collatorOptions) {
+    return [...items].sort((x, y) => compareMultiLanguageStrings(getValue(x), getValue(y), locale, collatorOptions));
+}
+/**
+ * True when the resolved value contains `query` (case-insensitive) for `locale`.
+ * Useful for search/filter flows over {@link AXPMultiLanguageString}.
+ */
+function searchInMultiLanguageString(value, query, locale) {
+    const q = query.trim().toLocaleLowerCase(locale);
+    if (!q) {
+        return true;
+    }
+    const text = resolveMultiLanguageString(value ?? '', locale).toLocaleLowerCase(locale);
+    return text.includes(q);
+}
+//#endregion
+
+//#region ---- Multi-language string utilities ----
+//#endregion
+
 //#region ---- Category & entity operation types ----
 //#endregion
 
@@ -892,32 +2627,6 @@ function createMultiLanguageString(enUS, faIR) {
         'fa-IR': faIR ?? enUS,
     };
 }
-/**
- * Resolves {@link AXPMultiLanguageString} to a plain string for the given locale.
- * Standalone copy for connectivity mocks — no dependency on @acorex/core/translation.
- */
-function resolveMultiLanguageString(value, locale) {
-    if (value == null || value === '') {
-        return '';
-    }
-    if (typeof value === 'string') {
-        return value;
-    }
-    const direct = value[locale];
-    if (typeof direct === 'string' && direct.length > 0) {
-        return direct;
-    }
-    const enUS = value['en-US'];
-    if (typeof enUS === 'string' && enUS.length > 0) {
-        return enUS;
-    }
-    for (const entry of Object.values(value)) {
-        if (typeof entry === 'string' && entry.length > 0) {
-            return entry;
-        }
-    }
-    return '';
-}
 /**
  * Lightweight data helpers for mock seed files.
  * Standalone copy for connectivity mocks — no dependency on @acorex/platform/core.
@@ -1186,5 +2895,5 @@ class AXPIntegrationMissingScopeError extends Error {
  * Generated bundle index. Do not edit.
  */
 
-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 { 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 };
 //# sourceMappingURL=acorex-platform-contracts.mjs.map