@acorex-platform/framework-shared 0.0.30 → 0.0.32

package/core/src/lib/index.js

@@ -3,9 +3,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./core"), exports);
+tslib_1.__exportStar(require("./registry"), exports);
 tslib_1.__exportStar(require("./context-definition"), exports);
 tslib_1.__exportStar(require("./errors"), exports);
 tslib_1.__exportStar(require("./utils"), exports);
+tslib_1.__exportStar(require("./color-surface"), exports);
 tslib_1.__exportStar(require("./expression-evaluator"), exports);
 tslib_1.__exportStar(require("./multi-language-string"), exports);
 tslib_1.__exportStar(require("./data"), exports);
@@ -20,5 +22,6 @@ tslib_1.__exportStar(require("./mock"), exports);
 tslib_1.__exportStar(require("./integration"), exports);
 tslib_1.__exportStar(require("./identifier"), exports);
 tslib_1.__exportStar(require("./settings"), exports);
+tslib_1.__exportStar(require("./user-notification"), exports);
 //#endregion
 //# sourceMappingURL=index.js.map

package/core/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/core/src/lib/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;AAEpC,iDAAuB;AACvB,+DAAqC;AACrC,mDAAyB;AACzB,kDAAwB;AACxB,iEAAuC;AACvC,kEAAwC;AACxC,iDAAuB;AACvB,qDAA2B;AAC3B,wDAA8B;AAC9B,oDAA0B;AAC1B,qDAA2B;AAC3B,mDAAyB;AACzB,mDAAyB;AACzB,iDAAuB;AACvB,iDAAuB;AACvB,wDAA8B;AAC9B,uDAA6B;AAC7B,qDAA2B;AAE3B,YAAY"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/core/src/lib/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;AAEpC,iDAAuB;AACvB,qDAA2B;AAC3B,+DAAqC;AACrC,mDAAyB;AACzB,kDAAwB;AACxB,0DAAgC;AAChC,iEAAuC;AACvC,kEAAwC;AACxC,iDAAuB;AACvB,qDAA2B;AAC3B,wDAA8B;AAC9B,oDAA0B;AAC1B,qDAA2B;AAC3B,mDAAyB;AACzB,mDAAyB;AACzB,iDAAuB;AACvB,iDAAuB;AACvB,wDAA8B;AAC9B,uDAA6B;AAC7B,qDAA2B;AAC3B,8DAAoC;AAEpC,YAAY"}

package/core/src/lib/registry/index.d.ts

@@ -0,0 +1,2 @@
+export { createRegistry, AXPRegistryError, type AXPRegistry, type AXPRegistryDuplicates, type AXPRegistryListItem, type AXPRegistryOptions, } from './registry';
+//# sourceMappingURL=index.d.ts.map

package/core/src/lib/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC"}

package/core/src/lib/registry/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXPRegistryError = exports.createRegistry = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "createRegistry", { enumerable: true, get: function () { return registry_1.createRegistry; } });
+Object.defineProperty(exports, "AXPRegistryError", { enumerable: true, get: function () { return registry_1.AXPRegistryError; } });
+//# sourceMappingURL=index.js.map

package/core/src/lib/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/registry/index.ts"],"names":[],"mappings":";;;AAAA,uCAOoB;AANlB,0GAAA,cAAc,OAAA;AACd,4GAAA,gBAAgB,OAAA"}

package/core/src/lib/registry/registry.d.ts

@@ -0,0 +1,23 @@
+export interface AXPRegistryListItem<T> {
+    name: string;
+    value: T;
+}
+export interface AXPRegistry<T> {
+    register(name: string, value: T): void;
+    get(name: string): T;
+    has(name: string): boolean;
+    list(): ReadonlyArray<AXPRegistryListItem<T>>;
+}
+export type AXPRegistryDuplicates = 'throw' | 'replace';
+export interface AXPRegistryOptions {
+    duplicates?: AXPRegistryDuplicates;
+}
+export declare class AXPRegistryError extends Error {
+    constructor(message: string);
+}
+/**
+ * Named plugin bag. Pure TypeScript — no Nest or Angular.
+ * Hosts hold instances (`useFactory` / `InjectionToken`); tests call this directly.
+ */
+export declare function createRegistry<T>(options?: AXPRegistryOptions): AXPRegistry<T>;
+//# sourceMappingURL=registry.d.ts.map

package/core/src/lib/registry/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/registry/registry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IACrB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,IAAI,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/C;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAMD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC,CAmC9E"}

package/core/src/lib/registry/registry.js

@@ -0,0 +1,57 @@
+"use strict";
+//#region ----- Types -----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXPRegistryError = void 0;
+exports.createRegistry = createRegistry;
+//#endregion
+//#region ----- Errors -----
+class AXPRegistryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AXPRegistryError';
+    }
+}
+exports.AXPRegistryError = AXPRegistryError;
+//#endregion
+//#region ----- Factory -----
+/**
+ * Named plugin bag. Pure TypeScript — no Nest or Angular.
+ * Hosts hold instances (`useFactory` / `InjectionToken`); tests call this directly.
+ */
+function createRegistry(options) {
+    var _a;
+    const duplicates = (_a = options === null || options === void 0 ? void 0 : options.duplicates) !== null && _a !== void 0 ? _a : 'throw';
+    const values = new Map();
+    const normalizeName = (name) => {
+        const normalized = typeof name === 'string' ? name.trim() : '';
+        if (!normalized) {
+            throw new AXPRegistryError('Registry name is required.');
+        }
+        return normalized;
+    };
+    return {
+        register(name, value) {
+            const key = normalizeName(name);
+            if (values.has(key) && duplicates === 'throw') {
+                throw new AXPRegistryError(`Registry already has "${key}".`);
+            }
+            values.set(key, value);
+        },
+        get(name) {
+            const key = normalizeName(name);
+            if (!values.has(key)) {
+                throw new AXPRegistryError(`Registry has no entry named "${key}".`);
+            }
+            return values.get(key);
+        },
+        has(name) {
+            const key = typeof name === 'string' ? name.trim() : '';
+            return key.length > 0 && values.has(key);
+        },
+        list() {
+            return [...values.entries()].map(([entryName, value]) => ({ name: entryName, value }));
+        },
+    };
+}
+//#endregion
+//# sourceMappingURL=registry.js.map

package/core/src/lib/registry/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/registry/registry.ts"],"names":[],"mappings":";AAAA,2BAA2B;;;AAuC3B,wCAmCC;AAtDD,YAAY;AAEZ,4BAA4B;AAE5B,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED,YAAY;AAEZ,6BAA6B;AAE7B;;;GAGG;AACH,SAAgB,cAAc,CAAI,OAA4B;;IAC5D,MAAM,UAAU,GAA0B,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,mCAAI,OAAO,CAAC;IACzE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAa,CAAC;IAEpC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE;QAC7C,MAAM,UAAU,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,CAAC,IAAY,EAAE,KAAQ;YAC7B,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;gBAC9C,MAAM,IAAI,gBAAgB,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,GAAG,CAAC,IAAY;YACd,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC;YACtE,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QACD,GAAG,CAAC,IAAY;YACd,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI;YACF,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACzF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,YAAY"}

package/core/src/lib/user-notification/index.d.ts

@@ -0,0 +1,3 @@
+export * from './user-notification.types';
+export * from './user-notification-delivery.util';
+//# sourceMappingURL=index.d.ts.map

package/core/src/lib/user-notification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/user-notification/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC"}

package/core/src/lib/user-notification/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./user-notification.types"), exports);
+tslib_1.__exportStar(require("./user-notification-delivery.util"), exports);
+//# sourceMappingURL=index.js.map

package/core/src/lib/user-notification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/user-notification/index.ts"],"names":[],"mappings":";;;AAAA,oEAA0C;AAC1C,4EAAkD"}

package/core/src/lib/user-notification/user-notification-delivery.util.d.ts

@@ -0,0 +1,10 @@
+import type { AXPUserNotificationDelivery, AXPUserNotificationInboxOptions, AXPUserNotificationToastOptions } from './user-notification.types';
+export declare const AXP_USER_NOTIFICATION_TOAST_DEFAULTS: Readonly<AXPUserNotificationToastOptions>;
+export declare const AXP_USER_NOTIFICATION_INBOX_DEFAULTS: Readonly<AXPUserNotificationInboxOptions>;
+export declare function axpResolveUserNotificationDelivery(delivery: AXPUserNotificationDelivery): {
+    toast: AXPUserNotificationToastOptions | null;
+    inbox: AXPUserNotificationInboxOptions | null;
+};
+export declare function axpShouldDeliverUserNotificationInbox(delivery: AXPUserNotificationDelivery): boolean;
+export declare function axpShouldDeliverUserNotificationToast(delivery: AXPUserNotificationDelivery): boolean;
+//# sourceMappingURL=user-notification-delivery.util.d.ts.map

package/core/src/lib/user-notification/user-notification-delivery.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-notification-delivery.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/user-notification/user-notification-delivery.util.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,2BAA2B,EAC3B,+BAA+B,EAC/B,+BAA+B,EAChC,MAAM,2BAA2B,CAAC;AAMnC,eAAO,MAAM,oCAAoC,EAAE,QAAQ,CAAC,+BAA+B,CAO1F,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,QAAQ,CAAC,+BAA+B,CAE1F,CAAC;AAmBF,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,2BAA2B,GAAG;IACzF,KAAK,EAAE,+BAA+B,GAAG,IAAI,CAAC;IAC9C,KAAK,EAAE,+BAA+B,GAAG,IAAI,CAAC;CAC/C,CAKA;AAED,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,2BAA2B,GAAG,OAAO,CAEpG;AAED,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,2BAA2B,GAAG,OAAO,CAEpG"}

package/core/src/lib/user-notification/user-notification-delivery.util.js

@@ -0,0 +1,45 @@
+"use strict";
+//#region ---- Imports ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_USER_NOTIFICATION_INBOX_DEFAULTS = exports.AXP_USER_NOTIFICATION_TOAST_DEFAULTS = void 0;
+exports.axpResolveUserNotificationDelivery = axpResolveUserNotificationDelivery;
+exports.axpShouldDeliverUserNotificationInbox = axpShouldDeliverUserNotificationInbox;
+exports.axpShouldDeliverUserNotificationToast = axpShouldDeliverUserNotificationToast;
+//#endregion
+//#region ---- Defaults ----
+exports.AXP_USER_NOTIFICATION_TOAST_DEFAULTS = {
+    location: 'bottom-center',
+    timeOut: 3000,
+    timeOutProgress: true,
+    closeButton: true,
+    color: 'primary',
+    showActions: true,
+};
+exports.AXP_USER_NOTIFICATION_INBOX_DEFAULTS = {
+    priority: 'Notice',
+};
+//#endregion
+//#region ---- Delivery resolution ----
+function resolveChannel(value, defaults) {
+    if (value === false || value === undefined) {
+        return null;
+    }
+    if (value === true) {
+        return Object.assign({}, defaults);
+    }
+    return Object.assign(Object.assign({}, defaults), value);
+}
+function axpResolveUserNotificationDelivery(delivery) {
+    return {
+        toast: resolveChannel(delivery.toast, exports.AXP_USER_NOTIFICATION_TOAST_DEFAULTS),
+        inbox: resolveChannel(delivery.inbox, exports.AXP_USER_NOTIFICATION_INBOX_DEFAULTS),
+    };
+}
+function axpShouldDeliverUserNotificationInbox(delivery) {
+    return axpResolveUserNotificationDelivery(delivery).inbox !== null;
+}
+function axpShouldDeliverUserNotificationToast(delivery) {
+    return axpResolveUserNotificationDelivery(delivery).toast !== null;
+}
+//#endregion
+//# sourceMappingURL=user-notification-delivery.util.js.map

package/core/src/lib/user-notification/user-notification-delivery.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-notification-delivery.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/user-notification/user-notification-delivery.util.ts"],"names":[],"mappings":";AAAA,2BAA2B;;;AA0C3B,gFAQC;AAED,sFAEC;AAED,sFAEC;AAlDD,YAAY;AAEZ,4BAA4B;AAEf,QAAA,oCAAoC,GAA8C;IAC7F,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE,IAAK;IACd,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,IAAI;IACjB,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,IAAI;CAClB,CAAC;AAEW,QAAA,oCAAoC,GAA8C;IAC7F,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF,YAAY;AAEZ,uCAAuC;AAEvC,SAAS,cAAc,CACrB,KAA8B,EAC9B,QAAW;IAEX,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,yBAAY,QAAQ,EAAG;IACzB,CAAC;IACD,uCAAY,QAAQ,GAAK,KAAK,EAAG;AACnC,CAAC;AAED,SAAgB,kCAAkC,CAAC,QAAqC;IAItF,OAAO;QACL,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,4CAAoC,CAAC;QAC3E,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,4CAAoC,CAAC;KAC5E,CAAC;AACJ,CAAC;AAED,SAAgB,qCAAqC,CAAC,QAAqC;IACzF,OAAO,kCAAkC,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;AACrE,CAAC;AAED,SAAgB,qCAAqC,CAAC,QAAqC;IACzF,OAAO,kCAAkC,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;AACrE,CAAC;AAED,YAAY"}

package/core/src/lib/user-notification/user-notification.types.d.ts

@@ -0,0 +1,56 @@
+export type AXPUserNotificationPriority = 'Notice' | 'Danger' | 'Warning';
+export type AXPUserNotificationToastColor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning';
+/** Common overlay anchor locations for transient toast delivery. */
+export type AXPUserNotificationToastLocation = 'bottom-center' | 'bottom-start' | 'bottom-end' | 'top-center' | 'top-start' | 'top-end';
+export interface AXPUserNotificationToastAction {
+    text: string;
+    color?: AXPUserNotificationToastColor;
+    onClick?: () => void | Promise<void>;
+}
+export interface AXPUserNotificationToastOptions {
+    location?: AXPUserNotificationToastLocation;
+    timeOut?: number;
+    timeOutProgress?: boolean;
+    closeButton?: boolean;
+    color?: AXPUserNotificationToastColor;
+    /** When false, toast actions/buttons are omitted (e.g. user is already on the target screen). */
+    showActions?: boolean;
+}
+export interface AXPUserNotificationInboxAction {
+    title: string;
+    command: {
+        name: string;
+        options?: Record<string, unknown>;
+    };
+}
+export interface AXPUserNotificationInboxOptions {
+    definitionKey?: string;
+    priority?: AXPUserNotificationPriority;
+    actions?: AXPUserNotificationInboxAction[];
+}
+export interface AXPUserNotificationDelivery {
+    /** Ephemeral overlay. `true` = defaults; `false`/omit = off. */
+    toast?: boolean | AXPUserNotificationToastOptions;
+    /** Persistent in-app inbox row. `true` = defaults; `false`/omit = off. */
+    inbox?: boolean | AXPUserNotificationInboxOptions;
+}
+/**
+ * Unified user-notification request. Features build this once; client/server presenters
+ * decide which channels to deliver.
+ */
+export interface AXPUserNotificationRequest {
+    correlationId: string;
+    idempotencyKey?: string;
+    title: string;
+    body: string;
+    icon?: string;
+    /** Display name for inbox persistence; defaults to {@link title}. */
+    name?: string;
+    delivery: AXPUserNotificationDelivery;
+    /** Client-side toast button actions (mapped when {@link AXPUserNotificationToastOptions.showActions} is true). */
+    toastActions?: AXPUserNotificationToastAction[];
+    /** Inbox recipient; server paths must set explicitly. Client defaults to session user. */
+    recipientUserId?: string;
+    data?: Record<string, unknown>;
+}
+//# sourceMappingURL=user-notification.types.d.ts.map

package/core/src/lib/user-notification/user-notification.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-notification.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/user-notification/user-notification.types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1E,MAAM,MAAM,6BAA6B,GACrC,SAAS,GACT,WAAW,GACX,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AAEd,oEAAoE;AACpE,MAAM,MAAM,gCAAgC,GACxC,eAAe,GACf,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,gCAAgC,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACtC,iGAAiG;IACjG,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,+BAA+B;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,OAAO,CAAC,EAAE,8BAA8B,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,2BAA2B;IAC1C,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,GAAG,+BAA+B,CAAC;IAClD,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,GAAG,+BAA+B,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,2BAA2B,CAAC;IACtC,kHAAkH;IAClH,YAAY,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAChD,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/core/src/lib/user-notification/user-notification.types.js

@@ -0,0 +1,5 @@
+"use strict";
+//#region ---- User notification contracts (leaf) ----
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=user-notification.types.js.map

package/core/src/lib/user-notification/user-notification.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-notification.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/user-notification/user-notification.types.ts"],"names":[],"mappings":";AAAA,sDAAsD;;AA6EtD,YAAY"}

package/core/src/lib/utils/index.d.ts

@@ -1,5 +1,6 @@
 export * from './object-util';
 export * from './password.util';
+export * from './random-uuid.util';
 export * from './scalar-coercion';
 export * from './string.util';
 //# sourceMappingURL=index.d.ts.map

package/core/src/lib/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/utils/index.ts"],"names":[],"mappings":"AAEA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/utils/index.ts"],"names":[],"mappings":"AAEA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/core/src/lib/utils/index.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./object-util"), exports);
 tslib_1.__exportStar(require("./password.util"), exports);
+tslib_1.__exportStar(require("./random-uuid.util"), exports);
 tslib_1.__exportStar(require("./scalar-coercion"), exports);
 tslib_1.__exportStar(require("./string.util"), exports);
 //#endregion

package/core/src/lib/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/utils/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;AAEpC,wDAA8B;AAC9B,0DAAgC;AAChC,4DAAkC;AAClC,wDAA8B;AAE9B,YAAY"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/utils/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;AAEpC,wDAA8B;AAC9B,0DAAgC;AAChC,6DAAmC;AACnC,4DAAkC;AAClC,wDAA8B;AAE9B,YAAY"}

package/core/src/lib/utils/random-uuid.util.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates a RFC 4122 v4 UUID.
+ *
+ * `crypto.randomUUID()` is unavailable in some browsers (notably Safari) on
+ * non-secure origins such as `http://192.168.x.x`. Falls back to
+ * `crypto.getRandomValues()` when present, otherwise a time/random suffix.
+ */
+export declare function createRandomUuid(): string;
+/**
+ * Patches `globalThis.crypto.randomUUID` when missing (Safari on HTTP).
+ * Call once before app bootstrap so third-party code can use the Web Crypto API.
+ */
+export declare function ensureRandomUuidPolyfill(): void;
+//# sourceMappingURL=random-uuid.util.d.ts.map

package/core/src/lib/utils/random-uuid.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-uuid.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/utils/random-uuid.util.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAmB/C"}

package/core/src/lib/utils/random-uuid.util.js

@@ -0,0 +1,54 @@
+"use strict";
+//#region ----- Random UUID (secure context + HTTP fallback) -----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRandomUuid = createRandomUuid;
+exports.ensureRandomUuidPolyfill = ensureRandomUuidPolyfill;
+function randomUuidViaGetRandomValues() {
+    const cryptoRef = globalThis.crypto;
+    if (cryptoRef && typeof cryptoRef.getRandomValues === 'function') {
+        const bytes = new Uint8Array(16);
+        cryptoRef.getRandomValues(bytes);
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
+        return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    }
+    return `${Date.now().toString(16)}-${Math.random().toString(16).slice(2, 10)}-${Math.random().toString(16).slice(2, 6)}-4${Math.random().toString(16).slice(2, 5)}-8${Math.random().toString(16).slice(2, 14)}`;
+}
+/**
+ * Generates a RFC 4122 v4 UUID.
+ *
+ * `crypto.randomUUID()` is unavailable in some browsers (notably Safari) on
+ * non-secure origins such as `http://192.168.x.x`. Falls back to
+ * `crypto.getRandomValues()` when present, otherwise a time/random suffix.
+ */
+function createRandomUuid() {
+    const cryptoRef = globalThis.crypto;
+    if (cryptoRef && typeof cryptoRef.randomUUID === 'function') {
+        return cryptoRef.randomUUID();
+    }
+    return randomUuidViaGetRandomValues();
+}
+/**
+ * Patches `globalThis.crypto.randomUUID` when missing (Safari on HTTP).
+ * Call once before app bootstrap so third-party code can use the Web Crypto API.
+ */
+function ensureRandomUuidPolyfill() {
+    if (typeof globalThis === 'undefined') {
+        return;
+    }
+    const cryptoRef = globalThis.crypto;
+    if (!cryptoRef || typeof cryptoRef.randomUUID === 'function') {
+        return;
+    }
+    if (typeof cryptoRef.getRandomValues !== 'function') {
+        return;
+    }
+    Object.defineProperty(cryptoRef, 'randomUUID', {
+        value: () => randomUuidViaGetRandomValues(),
+        configurable: true,
+        writable: true,
+    });
+}
+//#endregion
+//# sourceMappingURL=random-uuid.util.js.map

package/core/src/lib/utils/random-uuid.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-uuid.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/utils/random-uuid.util.ts"],"names":[],"mappings":";AAAA,kEAAkE;;AAwBlE,4CAOC;AAMD,4DAmBC;AAtDD,SAAS,4BAA4B;IACnC,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QACjC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAEpC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrF,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7G,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAClN,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,4BAA4B,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB;IACtC,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,IAAI,OAAO,SAAS,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QACpD,OAAO;IACT,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE;QAC7C,KAAK,EAAE,GAAG,EAAE,CAAC,4BAA4B,EAAE;QAC3C,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;AACL,CAAC;AAED,YAAY"}

package/core/src/lib/widgets/widgets-list.d.ts

@@ -4,6 +4,7 @@ export declare const AXPWidgetsList: {
         TagEditor: string;
         CheckBox: string;
         ColorBox: string;
+        ColorChooser: string;
         ColorPalette: string;
         DateTimeBox: string;
         AddressBox: string;

package/core/src/lib/widgets/widgets-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgets-list.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/widgets/widgets-list.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuJ1B,CAAC"}
+{"version":3,"file":"widgets-list.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/widgets/widgets-list.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwJ1B,CAAC"}

package/core/src/lib/widgets/widgets-list.js

@@ -7,6 +7,7 @@ exports.AXPWidgetsList = {
         TagEditor: 'tag-editor',
         CheckBox: 'checkbox-editor',
         ColorBox: 'color-editor',
+        ColorChooser: 'color-chooser',
         ColorPalette: 'color-palette-editor',
         DateTimeBox: 'date-time-editor',
         AddressBox: 'address-editor',

package/core/src/lib/widgets/widgets-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"widgets-list.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/widgets/widgets-list.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"widgets-list.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/core/src/lib/widgets/widgets-list.ts"],"names":[],"mappings":"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"}

package/entity/src/lib/types/entity-card-field.types.d.ts

@@ -1,8 +1,8 @@
 import type { AXPExpression, AXStyleColorType } from '@acorex-platform/framework-shared/core';
 import type { AXPEntityPropertyLayoutConfig } from './entity-property.types';
 import type { AXPEntityDisplayField } from './entity-display-field.types';
-/** Card layout field presentation in master list card view. */
-export type AXPCardFieldDisplay = 'simple' | 'badge';
+/** Card layout field presentation (list card/row and lookup popover). */
+export type AXPCardFieldDisplay = 'simple' | 'badge' | 'meta' | 'more';
 /** Badge color: semantic token or per-row expression (`{{ context.eval(...) }}`). */
 export type AXPCardBadgeColor = AXStyleColorType | AXPExpression;
 export interface AXPCardBadgeDisplayOptions {
@@ -15,12 +15,15 @@ export interface AXPCardBadgeDisplay {
 }
 /** Shorthand (`badge` / `simple`) or structured badge config with optional per-row color. */
 export type AXPCardFieldDisplayConfig = AXPCardFieldDisplay | AXPCardBadgeDisplay;
-/** Card layout field in master list view. */
+/** Card layout field. */
 export type AXPCardField = AXPEntityDisplayField & {
     layout?: AXPEntityPropertyLayoutConfig;
     /**
-     * Field presentation. Default: `simple` (card body).
-     * Use `badge` or `{ type: 'badge', options: { color } }` for header chips beside title.
+     * Field presentation.
+     * `meta` — unlabeled header extra (identifier/code, or contact when that is the identity extra).
+     * `simple` — labeled body rows for values that need context (code, lookup, date).
+     * `badge` or `{ type: 'badge', options: { color } }` — header chips beside the title.
+     * `more` — extra labeled body facts revealed by the card More button.
      */
     display?: AXPCardFieldDisplayConfig;
     /**
@@ -30,6 +33,29 @@ export type AXPCardField = AXPEntityDisplayField & {
      */
     badgeColor?: AXPCardBadgeColor;
 };
+/** Identity header for a reusable entity card. */
+export interface AXPEntityCardHeader {
+    /** Property path, expression (`{{ ... }}`), or literal — evaluated per row. */
+    title?: string;
+    description?: string;
+    icon?: string;
+    /** Property path to an image/avatar/file field. Initials are used when empty. */
+    avatar?: string;
+}
+/**
+ * Shared card preview contract.
+ * Stored on `interfaces.master.card`; list mode uses `enabled`,
+ * other hosts (lookup popover) ignore `enabled` and reuse header + fields.
+ */
+export interface AXPEntityCardLayout {
+    enabled?: boolean;
+    header: AXPEntityCardHeader;
+    fields: AXPCardField[];
+}
+/** Whether the card field is shown as a header-less fact (icon + value). */
+export declare function isCardFieldMetaDisplay(display: AXPCardFieldDisplayConfig | undefined): boolean;
+/** Whether the card field is revealed by the More button (not in the initial preview). */
+export declare function isCardFieldMoreDisplay(display: AXPCardFieldDisplayConfig | undefined): boolean;
 /** Whether the card field is shown as a header badge (not in the card body). */
 export declare function isCardFieldBadgeDisplay(display: AXPCardFieldDisplayConfig | undefined): display is 'badge' | AXPCardBadgeDisplay;
 /** Resolves static badge color config from {@link AXPCardField.display} and legacy {@link AXPCardField.badgeColor}. */

package/entity/src/lib/types/entity-card-field.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-card-field.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/types/entity-card-field.types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC9F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAEjE,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;AAED,6FAA6F;AAC7F,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAElF,6CAA6C;AAC7C,MAAM,MAAM,YAAY,GAAG,qBAAqB,GAAG;IACjD,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC;;;OAGG;IACH,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAC7C,OAAO,IAAI,OAAO,GAAG,mBAAmB,CAK1C;AAED,uHAAuH;AACvH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,YAAY,CAAC,GAClD,iBAAiB,GAAG,SAAS,CAQ/B"}
+{"version":3,"file":"entity-card-field.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/types/entity-card-field.types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC9F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,yEAAyE;AACzE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvE,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAEjE,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;AAED,6FAA6F;AAC7F,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAElF,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,qBAAqB,GAAG;IACjD,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAAG,OAAO,CAE9F;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAAG,OAAO,CAE9F;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAC7C,OAAO,IAAI,OAAO,GAAG,mBAAmB,CAK1C;AAED,uHAAuH;AACvH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,YAAY,CAAC,GAClD,iBAAiB,GAAG,SAAS,CAQ/B"}

package/entity/src/lib/types/entity-card-field.types.js

@@ -1,8 +1,18 @@
 "use strict";
 //#region ---- Entity card fields ----
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCardFieldMetaDisplay = isCardFieldMetaDisplay;
+exports.isCardFieldMoreDisplay = isCardFieldMoreDisplay;
 exports.isCardFieldBadgeDisplay = isCardFieldBadgeDisplay;
 exports.resolveCardFieldBadgeColor = resolveCardFieldBadgeColor;
+/** Whether the card field is shown as a header-less fact (icon + value). */
+function isCardFieldMetaDisplay(display) {
+    return display === 'meta' || display == null;
+}
+/** Whether the card field is revealed by the More button (not in the initial preview). */
+function isCardFieldMoreDisplay(display) {
+    return display === 'more';
+}
 /** Whether the card field is shown as a header badge (not in the card body). */
 function isCardFieldBadgeDisplay(display) {
     if (display === 'badge') {

package/entity/src/lib/types/entity-card-field.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-card-field.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/types/entity-card-field.types.ts"],"names":[],"mappings":";AAAA,sCAAsC;;AA2CtC,0DAOC;AAGD,gEAUC;AArBD,gFAAgF;AAChF,SAAgB,uBAAuB,CACrC,OAA8C;IAE9C,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC;AACrF,CAAC;AAED,uHAAuH;AACvH,SAAgB,0BAA0B,CACxC,KAAmD;;IAEnD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACxE,OAAO,MAAA,MAAA,KAAK,CAAC,OAAO,CAAC,OAAO,0CAAE,KAAK,mCAAI,KAAK,CAAC,UAAU,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,UAAU,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,YAAY"}
+{"version":3,"file":"entity-card-field.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/types/entity-card-field.types.ts"],"names":[],"mappings":";AAAA,sCAAsC;;AAmEtC,wDAEC;AAGD,wDAEC;AAGD,0DAOC;AAGD,gEAUC;AA/BD,4EAA4E;AAC5E,SAAgB,sBAAsB,CAAC,OAA8C;IACnF,OAAO,OAAO,KAAK,MAAM,IAAI,OAAO,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,0FAA0F;AAC1F,SAAgB,sBAAsB,CAAC,OAA8C;IACnF,OAAO,OAAO,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,gFAAgF;AAChF,SAAgB,uBAAuB,CACrC,OAA8C;IAE9C,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC;AACrF,CAAC;AAED,uHAAuH;AACvH,SAAgB,0BAA0B,CACxC,KAAmD;;IAEnD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACxE,OAAO,MAAA,MAAA,KAAK,CAAC,OAAO,CAAC,OAAO,0CAAE,KAAK,mCAAI,KAAK,CAAC,UAAU,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,UAAU,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,YAAY"}

package/entity/src/lib/types/entity-definition.types.d.ts

@@ -3,7 +3,9 @@ import type { AXPEntityDetailListView } from './entity-detail-list.types';
 import type { AXPEntityFormats } from './entity-formats.types';
 import type { AXPEntityTableColumn } from './entity-display-field.types';
 import type { AXPEntityMasterCreateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityMasterUpdateLayoutView } from './entity-layout-view.types';
+import type { AXPEntityCardLayout } from './entity-card-field.types';
 import type { AXPEntityMasterListView } from './entity-master-list.types';
+import type { AXPEntityMasterStyling } from './entity-master-styling.types';
 import type { AXPRelatedEntity } from './entity-related-layout.types';
 import type { AXPQueryFilter } from './entity-query-view.types';
 import type { AXPEntityCommand, AXPEntityQuery } from './entity-action.types';
@@ -75,17 +77,23 @@ export interface AXPEntity {
     };
     validations?: AXPValidationRules;
     interfaces?: {
-        master?: {
-            single?: AXPEntityMasterSingleLayoutView;
-            list?: AXPEntityMasterListView;
-            create?: AXPEntityMasterCreateLayoutView;
-            update?: AXPEntityMasterUpdateLayoutView;
-        };
+        master?: AXPEntityMasterInterfaces;
         detail?: {
             list?: AXPEntityDetailListView;
         };
     };
 }
+/** Master surfaces: record layouts plus the shared identity card. */
+export interface AXPEntityMasterInterfaces {
+    single?: AXPEntityMasterSingleLayoutView;
+    list?: AXPEntityMasterListView;
+    create?: AXPEntityMasterCreateLayoutView;
+    update?: AXPEntityMasterUpdateLayoutView;
+    /** Shared identity card (list card/row, lookup popover). List mode honors `enabled`. */
+    card?: AXPEntityCardLayout;
+    /** Record/field CSS classes shared by table, card, and single. */
+    styling?: AXPEntityMasterStyling;
+}
 export declare function getEntityInfo(entity: AXPEntity): {
     source: string;
     module: {
@@ -168,12 +176,7 @@ export interface AXPEntityV2 {
     columns?: AXPEntityTableColumn[];
     validations?: AXPValidationRules;
     interfaces?: {
-        master?: {
-            single?: AXPEntityMasterSingleLayoutView;
-            list?: AXPEntityMasterListView;
-            create?: AXPEntityMasterCreateLayoutView;
-            update?: AXPEntityMasterUpdateLayoutView;
-        };
+        master?: AXPEntityMasterInterfaces;
         detail?: {
             list?: AXPEntityDetailListView;
         };