@mlightcad/cad-simple-viewer 1.7.0 → 1.7.1

package/lib/app/notification/AcApNotificationStore.js

@@ -0,0 +1,345 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+/**
+ * In-memory notification store used by the built-in DOM notification UI and as
+ * a reference implementation for custom centers.
+ *
+ * Notifications are kept in per-session buckets. {@link notifications} /
+ * {@link unreadCount} / mutation helpers (except {@link clearSession} and
+ * {@link remove} by id) operate on the active session.
+ */
+var AcApNotificationStore = /** @class */ (function () {
+    function AcApNotificationStore() {
+        /** Per-session notification lists keyed by {@link AcApDocSession.id}. */
+        this._buckets = new Map();
+        /** Session currently exposed via {@link notifications}. */
+        this._activeSessionId = null;
+        /** Monotonic counter used to allocate notification ids. */
+        this._nextId = 1;
+        /** Observers notified after any mutating change. */
+        this._listeners = new Set();
+    }
+    Object.defineProperty(AcApNotificationStore.prototype, "notifications", {
+        /**
+         * Notifications for the active document session only.
+         */
+        get: function () {
+            return this.activeList();
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApNotificationStore.prototype, "unreadCount", {
+        /**
+         * Number of notifications in the active session.
+         */
+        get: function () {
+            return this.activeList().length;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcApNotificationStore.prototype, "activeSessionId", {
+        /**
+         * Currently active session id, or `null` when none is set.
+         */
+        get: function () {
+            return this._activeSessionId;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Registers a change listener.
+     *
+     * @param listener - Callback invoked after list / session mutations.
+     * @returns Unsubscribe function.
+     */
+    AcApNotificationStore.prototype.subscribe = function (listener) {
+        var _this = this;
+        this._listeners.add(listener);
+        return function () {
+            _this._listeners.delete(listener);
+        };
+    };
+    /**
+     * Notifies all {@link subscribe} listeners.
+     */
+    AcApNotificationStore.prototype.emitChange = function () {
+        var e_1, _a;
+        try {
+            for (var _b = __values(this._listeners), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var listener = _c.value;
+                listener();
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    };
+    /**
+     * Returns the mutable list for the active session, or an empty array.
+     */
+    AcApNotificationStore.prototype.activeList = function () {
+        var _a;
+        if (this._activeSessionId == null)
+            return [];
+        return (_a = this._buckets.get(this._activeSessionId)) !== null && _a !== void 0 ? _a : [];
+    };
+    /**
+     * Replaces the active session's list, deleting the bucket when empty.
+     *
+     * @param list - Next notification list for the active session.
+     */
+    AcApNotificationStore.prototype.setActiveList = function (list) {
+        if (this._activeSessionId == null)
+            return;
+        if (list.length === 0) {
+            this._buckets.delete(this._activeSessionId);
+        }
+        else {
+            this._buckets.set(this._activeSessionId, list);
+        }
+    };
+    /**
+     * Resolves which session bucket an add should target.
+     *
+     * @param explicit - Optional `sessionId` from the input payload.
+     * @returns Session id, or `null` when neither explicit nor active is set.
+     */
+    AcApNotificationStore.prototype.resolveSessionId = function (explicit) {
+        return explicit !== null && explicit !== void 0 ? explicit : this._activeSessionId;
+    };
+    /**
+     * Switches which document's list is exposed via {@link notifications}.
+     *
+     * @param sessionId - Active session id, or `null` when none.
+     */
+    AcApNotificationStore.prototype.setActiveSession = function (sessionId) {
+        if (this._activeSessionId === sessionId)
+            return;
+        this._activeSessionId = sessionId;
+        this.emitChange();
+    };
+    /**
+     * Drops all notifications for a closed document session.
+     *
+     * @param sessionId - Session whose bucket should be deleted.
+     */
+    AcApNotificationStore.prototype.clearSession = function (sessionId) {
+        if (!this._buckets.has(sessionId)) {
+            if (this._activeSessionId === sessionId) {
+                this.emitChange();
+            }
+            return;
+        }
+        this._buckets.delete(sessionId);
+        this.emitChange();
+    };
+    /**
+     * Inserts a notification into the resolved session bucket (newest first).
+     *
+     * @param notification - Entry fields without `id` / `timestamp`.
+     * @returns The assigned id, or `''` when no session could be resolved.
+     */
+    AcApNotificationStore.prototype.add = function (notification) {
+        var _a;
+        var sessionId = this.resolveSessionId(notification.sessionId);
+        if (sessionId == null) {
+            // No active document yet — drop rather than creating an orphan bucket.
+            return '';
+        }
+        var entry = __assign(__assign({}, notification), { sessionId: sessionId, id: "notification-".concat(this._nextId++), timestamp: new Date() });
+        var list = (_a = this._buckets.get(sessionId)) !== null && _a !== void 0 ? _a : [];
+        this._buckets.set(sessionId, __spreadArray([entry], __read(list), false));
+        this.emitChange();
+        return entry.id;
+    };
+    /**
+     * Adds an `info` notification to the active (or explicit) session.
+     *
+     * @param title - Headline text.
+     * @param message - Optional body.
+     * @param options - Extra fields merged into the entry.
+     * @returns The assigned notification id.
+     */
+    AcApNotificationStore.prototype.info = function (title, message, options) {
+        return this.add(__assign({ type: 'info', title: title, message: message }, options));
+    };
+    /**
+     * Adds a `warning` notification to the active (or explicit) session.
+     *
+     * @param title - Headline text.
+     * @param message - Optional body.
+     * @param options - Extra fields merged into the entry.
+     * @returns The assigned notification id.
+     */
+    AcApNotificationStore.prototype.warning = function (title, message, options) {
+        return this.add(__assign({ type: 'warning', title: title, message: message }, options));
+    };
+    /**
+     * Adds an `error` notification (defaults to `persistent: true`).
+     *
+     * @param title - Headline text.
+     * @param message - Optional body.
+     * @param options - Extra fields merged into the entry.
+     * @returns The assigned notification id.
+     */
+    AcApNotificationStore.prototype.error = function (title, message, options) {
+        return this.add(__assign({ type: 'error', title: title, message: message, persistent: true }, options));
+    };
+    /**
+     * Adds a `success` notification to the active (or explicit) session.
+     *
+     * @param title - Headline text.
+     * @param message - Optional body.
+     * @param options - Extra fields merged into the entry.
+     * @returns The assigned notification id.
+     */
+    AcApNotificationStore.prototype.success = function (title, message, options) {
+        return this.add(__assign({ type: 'success', title: title, message: message }, options));
+    };
+    /**
+     * Removes a notification by id from any session bucket.
+     *
+     * @param id - Notification id previously returned by {@link add}.
+     */
+    AcApNotificationStore.prototype.remove = function (id) {
+        var e_2, _a;
+        try {
+            for (var _b = __values(this._buckets), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var _d = __read(_c.value, 2), sessionId = _d[0], list = _d[1];
+                var next = list.filter(function (n) { return n.id !== id; });
+                if (next.length === list.length)
+                    continue;
+                if (next.length === 0) {
+                    this._buckets.delete(sessionId);
+                }
+                else {
+                    this._buckets.set(sessionId, next);
+                }
+                this.emitChange();
+                return;
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+    };
+    /**
+     * Clears notifications for the active session only.
+     */
+    AcApNotificationStore.prototype.clear = function () {
+        if (this._activeSessionId == null)
+            return;
+        if (!this._buckets.has(this._activeSessionId))
+            return;
+        this._buckets.delete(this._activeSessionId);
+        this.emitChange();
+    };
+    /**
+     * Removes notifications matching a predicate from the active session.
+     *
+     * @param predicate - Return `true` for entries that should be removed.
+     */
+    AcApNotificationStore.prototype.removeWhere = function (predicate) {
+        var list = this.activeList();
+        if (list.length === 0)
+            return;
+        var next = list.filter(function (n) { return !predicate(n); });
+        if (next.length === list.length)
+            return;
+        this.setActiveList(next);
+        this.emitChange();
+    };
+    /**
+     * Removes all active-session notifications with the given source.
+     *
+     * @param source - Producer to clear.
+     */
+    AcApNotificationStore.prototype.removeBySource = function (source) {
+        this.removeWhere(function (notification) { return notification.source === source; });
+    };
+    /**
+     * Drops `font-missed` entries that no longer apply given the still-missing fonts.
+     *
+     * @param missedFontNames - Fonts that are still unresolved.
+     */
+    AcApNotificationStore.prototype.removeResolvedFontMissedNotifications = function (missedFontNames) {
+        var missed = new Set(missedFontNames);
+        this.removeWhere(function (notification) {
+            var _a;
+            if (notification.source !== 'font-missed')
+                return false;
+            if (missed.size === 0)
+                return true;
+            if (!((_a = notification.fontNames) === null || _a === void 0 ? void 0 : _a.length))
+                return false;
+            return !notification.fontNames.some(function (fontName) { return missed.has(fontName); });
+        });
+    };
+    /**
+     * Clears listeners, all session buckets, and the active session pointer.
+     */
+    AcApNotificationStore.prototype.dispose = function () {
+        this._listeners.clear();
+        this._buckets.clear();
+        this._activeSessionId = null;
+    };
+    return AcApNotificationStore;
+}());
+export { AcApNotificationStore };
+//# sourceMappingURL=AcApNotificationStore.js.map

package/lib/app/notification/AcApNotificationStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApNotificationStore.js","sourceRoot":"","sources":["../../../src/app/notification/AcApNotificationStore.ts"],"names":[],"mappings":"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"}

package/lib/app/notification/AcApNotificationTypes.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Identifies the subsystem that produced a notification for grouping / cleanup.
+ */
+export type AcApNotificationSource = 'font-missed' | 'unsupported-entities';
+/**
+ * Sources the default / Vue UIs collapse into expandable groups.
+ */
+export declare const ACAP_GROUPABLE_NOTIFICATION_SOURCES: readonly AcApNotificationSource[];
+/**
+ * Visual severity category for a notification entry.
+ */
+export type AcApNotificationType = 'info' | 'warning' | 'error' | 'success';
+/**
+ * A clickable action rendered on a notification.
+ */
+export interface AcApNotificationAction {
+    /** Button label shown in the UI. */
+    label: string;
+    /** Handler invoked when the action is activated. */
+    action: () => void;
+    /** When `true`, the UI may emphasize this action as the primary choice. */
+    primary?: boolean;
+}
+/**
+ * One notification entry stored in a session bucket.
+ */
+export interface AcApNotification {
+    /** Stable id assigned by the store (`notification-N`). */
+    id: string;
+    /** Visual severity and icon category. */
+    type: AcApNotificationType;
+    /** Short headline shown in the list / panel. */
+    title: string;
+    /** Optional longer body text. */
+    message?: string;
+    /** Creation time used for ordering and relative timestamps. */
+    timestamp: Date;
+    /** Optional action buttons rendered with the entry. */
+    actions?: AcApNotificationAction[];
+    /** When `true`, hosts should not auto-dismiss the entry. */
+    persistent?: boolean;
+    /** Optional auto-dismiss delay in milliseconds (host-defined). */
+    timeout?: number;
+    /** Producer used for grouping and selective removal. */
+    source?: AcApNotificationSource;
+    /**
+     * Font names associated with a `font-missed` notification, used when pruning
+     * resolved missing-font alerts.
+     */
+    fontNames?: string[];
+    /**
+     * {@link AcApDocSession.id} of the document this notification belongs to.
+     * Assigned by the store when omitted (uses the active session).
+     */
+    sessionId?: string;
+}
+/**
+ * Fields accepted when creating a notification (`id` / `timestamp` assigned by the store).
+ */
+export type AcApNotificationInput = Omit<AcApNotification, 'id' | 'timestamp'>;
+/**
+ * Host-replaceable notification center API.
+ *
+ * Notifications are **per document session** (MDI). {@link notifications} and
+ * {@link unreadCount} always reflect the active session set via
+ * {@link setActiveSession}. Hosts such as `cad-viewer` can call
+ * {@link acapSetNotificationCenter} to supply their own UI while reusing the
+ * shared event bridge.
+ */
+export interface AcApNotificationCenter {
+    /** Notifications for the active document session only. */
+    readonly notifications: readonly AcApNotification[];
+    /** Number of notifications in the active session (same as list length). */
+    readonly unreadCount: number;
+    /**
+     * Inserts a notification into the resolved session bucket.
+     *
+     * @param notification - Entry fields without `id` / `timestamp`.
+     * @returns The assigned id, or `''` when no session could be resolved.
+     */
+    add(notification: AcApNotificationInput): string;
+    /**
+     * Adds an `info` notification.
+     *
+     * @param title - Headline text.
+     * @param message - Optional body.
+     * @param options - Extra fields merged into the entry.
+     * @returns The assigned notification id.
+     */
+    info(title: string, message?: string, options?: Partial<AcApNotification>): string;
+    /**
+     * Adds a `warning` notification.
+     *
+     * @param title - Headline text.
+     * @param message - Optional body.
+     * @param options - Extra fields merged into the entry.
+     * @returns The assigned notification id.
+     */
+    warning(title: string, message?: string, options?: Partial<AcApNotification>): string;
+    /**
+     * Adds an `error` notification (defaults to `persistent: true`).
+     *
+     * @param title - Headline text.
+     * @param message - Optional body.
+     * @param options - Extra fields merged into the entry.
+     * @returns The assigned notification id.
+     */
+    error(title: string, message?: string, options?: Partial<AcApNotification>): string;
+    /**
+     * Adds a `success` notification.
+     *
+     * @param title - Headline text.
+     * @param message - Optional body.
+     * @param options - Extra fields merged into the entry.
+     * @returns The assigned notification id.
+     */
+    success(title: string, message?: string, options?: Partial<AcApNotification>): string;
+    /**
+     * Removes a notification by id from any session bucket.
+     *
+     * @param id - Notification id previously returned by {@link add}.
+     */
+    remove(id: string): void;
+    /** Clears notifications for the active session. */
+    clear(): void;
+    /**
+     * Removes notifications matching a predicate from the active session.
+     *
+     * @param predicate - Return `true` for entries that should be removed.
+     */
+    removeWhere(predicate: (notification: AcApNotification) => boolean): void;
+    /**
+     * Removes all active-session notifications with the given {@link source}.
+     *
+     * @param source - Producer to clear.
+     */
+    removeBySource(source: AcApNotificationSource): void;
+    /**
+     * Drops `font-missed` entries that no longer apply given the still-missing fonts.
+     *
+     * @param missedFontNames - Fonts that are still unresolved; entries whose
+     *   `fontNames` no longer intersect this set are removed. An empty set removes
+     *   every `font-missed` entry in the active session.
+     */
+    removeResolvedFontMissedNotifications(missedFontNames: Iterable<string>): void;
+    /**
+     * Switches which document's list is exposed via {@link notifications}.
+     * Called by the event bridge on document activate.
+     *
+     * @param sessionId - Active {@link AcApDocSession.id}, or `null` when none.
+     */
+    setActiveSession(sessionId: string | null): void;
+    /**
+     * Drops all notifications for a closed document session.
+     *
+     * @param sessionId - Session whose bucket should be deleted.
+     */
+    clearSession(sessionId: string): void;
+    /**
+     * Subscribe to list / active-session changes. Returns an unsubscribe function.
+     * Optional for custom centers that do not need observation.
+     *
+     * @param listener - Callback invoked after any mutating change.
+     * @returns Function that removes the listener.
+     */
+    subscribe?(listener: () => void): () => void;
+    /** Dispose UI / listeners owned by this center. Optional. */
+    dispose?(): void;
+}
+/**
+ * One visual group produced by {@link acapGroupNotifications} for panel UIs.
+ */
+export interface AcApNotificationGroup {
+    /** Stable key (`font-missed`, `unsupported-entities`, or `single:<id>`). */
+    key: string;
+    /** Present when the group collapses a groupable {@link AcApNotificationSource}. */
+    source?: AcApNotificationSource;
+    /** Entries in insertion order within the group. */
+    items: AcApNotification[];
+    /** `true` when the UI should render an expandable header (multiple items). */
+    collapsible: boolean;
+    /** Highest-severity type among {@link items}. */
+    type: AcApNotificationType;
+    /** Newest {@link AcApNotification.timestamp} in the group. */
+    latestTimestamp: Date;
+}
+/**
+ * Groups notifications for UI panels (`font-missed` / `unsupported-entities` collapse).
+ *
+ * @param notifications - Flat list for the active session (newest first).
+ * @returns Groups in first-seen order; collapsible only when a groupable source
+ *   has more than one item.
+ */
+export declare function acapGroupNotifications(notifications: readonly AcApNotification[]): AcApNotificationGroup[];
+//# sourceMappingURL=AcApNotificationTypes.d.ts.map

package/lib/app/notification/AcApNotificationTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApNotificationTypes.d.ts","sourceRoot":"","sources":["../../../src/app/notification/AcApNotificationTypes.ts"],"names":[],"mappings":"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"}

package/lib/app/notification/AcApNotificationTypes.js

@@ -0,0 +1,78 @@
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+/**
+ * Sources the default / Vue UIs collapse into expandable groups.
+ */
+export var ACAP_GROUPABLE_NOTIFICATION_SOURCES = ['font-missed', 'unsupported-entities'];
+/**
+ * Severity rank used when collapsing groupable notifications into one header type.
+ */
+var TYPE_RANK = {
+    error: 3,
+    warning: 2,
+    info: 1,
+    success: 0
+};
+/**
+ * Groups notifications for UI panels (`font-missed` / `unsupported-entities` collapse).
+ *
+ * @param notifications - Flat list for the active session (newest first).
+ * @returns Groups in first-seen order; collapsible only when a groupable source
+ *   has more than one item.
+ */
+export function acapGroupNotifications(notifications) {
+    var e_1, _a;
+    var groups = new Map();
+    var order = [];
+    try {
+        for (var notifications_1 = __values(notifications), notifications_1_1 = notifications_1.next(); !notifications_1_1.done; notifications_1_1 = notifications_1.next()) {
+            var notification = notifications_1_1.value;
+            var source = notification.source;
+            var isGroupable = source != null &&
+                ACAP_GROUPABLE_NOTIFICATION_SOURCES.includes(source);
+            var key = isGroupable ? source : "single:".concat(notification.id);
+            var existing = groups.get(key);
+            if (existing) {
+                existing.items.push(notification);
+                if (TYPE_RANK[notification.type] > TYPE_RANK[existing.type]) {
+                    existing.type = notification.type;
+                }
+                if (notification.timestamp > existing.latestTimestamp) {
+                    existing.latestTimestamp = notification.timestamp;
+                }
+                continue;
+            }
+            groups.set(key, {
+                key: key,
+                source: isGroupable ? source : undefined,
+                items: [notification],
+                collapsible: false,
+                type: notification.type,
+                latestTimestamp: notification.timestamp
+            });
+            order.push(key);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (notifications_1_1 && !notifications_1_1.done && (_a = notifications_1.return)) _a.call(notifications_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return order.map(function (key) {
+        var group = groups.get(key);
+        group.collapsible = group.source != null && group.items.length > 1;
+        return group;
+    });
+}
+//# sourceMappingURL=AcApNotificationTypes.js.map

package/lib/app/notification/AcApNotificationTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApNotificationTypes.js","sourceRoot":"","sources":["../../../src/app/notification/AcApNotificationTypes.ts"],"names":[],"mappings":";;;;;;;;;;;AAKA;;GAEG;AACH,MAAM,CAAC,IAAM,mCAAmC,GAC9C,CAAC,aAAa,EAAE,sBAAsB,CAAU,CAAA;AA4MlD;;GAEG;AACH,IAAM,SAAS,GAAyC;IACtD,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;CACX,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,aAA0C;;IAE1C,IAAM,MAAM,GAAG,IAAI,GAAG,EAAiC,CAAA;IACvD,IAAM,KAAK,GAAa,EAAE,CAAA;;QAE1B,KAA2B,IAAA,kBAAA,SAAA,aAAa,CAAA,4CAAA,uEAAE,CAAC;YAAtC,IAAM,YAAY,0BAAA;YACrB,IAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAA;YAClC,IAAM,WAAW,GACf,MAAM,IAAI,IAAI;gBACb,mCAAyD,CAAC,QAAQ,CACjE,MAAM,CACP,CAAA;YACH,IAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,MAAO,CAAC,CAAC,CAAC,iBAAU,YAAY,CAAC,EAAE,CAAE,CAAA;YAE/D,IAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAChC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;gBACjC,IAAI,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5D,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAA;gBACnC,CAAC;gBACD,IAAI,YAAY,CAAC,SAAS,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;oBACtD,QAAQ,CAAC,eAAe,GAAG,YAAY,CAAC,SAAS,CAAA;gBACnD,CAAC;gBACD,SAAQ;YACV,CAAC;YAED,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;gBACd,GAAG,KAAA;gBACH,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBACxC,KAAK,EAAE,CAAC,YAAY,CAAC;gBACrB,WAAW,EAAE,KAAK;gBAClB,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,eAAe,EAAE,YAAY,CAAC,SAAS;aACxC,CAAC,CAAA;YACF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;;;;;;;;;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,UAAA,GAAG;QAClB,IAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;QAC9B,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;QAClE,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/lib/app/notification/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Barrel exports for the notification center application subsystem
+ * (types, store, event bridge, service).
+ *
+ * The default DOM chrome lives in `src/ui` as {@link AcUiDefaultNotificationUi}.
+ *
+ * See `docs/notification-center.md` for architecture and host-override guidance.
+ */
+export * from './AcApNotificationTypes';
+export * from './AcApNotificationStore';
+export * from './AcApNotificationEventBridge';
+export * from './AcApNotificationService';
+//# sourceMappingURL=index.d.ts.map

package/lib/app/notification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/notification/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA"}

package/lib/app/notification/index.js

@@ -0,0 +1,13 @@
+/**
+ * Barrel exports for the notification center application subsystem
+ * (types, store, event bridge, service).
+ *
+ * The default DOM chrome lives in `src/ui` as {@link AcUiDefaultNotificationUi}.
+ *
+ * See `docs/notification-center.md` for architecture and host-override guidance.
+ */
+export * from './AcApNotificationTypes';
+export * from './AcApNotificationStore';
+export * from './AcApNotificationEventBridge';
+export * from './AcApNotificationService';
+//# sourceMappingURL=index.js.map

package/lib/app/notification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app/notification/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA"}