@mlightcad/cad-simple-viewer 1.6.3 → 1.7.1

package/lib/app/notification/AcApNotificationEventBridge.js

@@ -0,0 +1,309 @@
+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);
+};
+import { eventBus } from '../../editor/global/eventBus';
+import { acapAnalyzeUnsupportedDrawing } from '../../util/AcApAnalyzeUnsupportedDrawing';
+import { AcApFontUtil } from '../../util/AcApFontUtil';
+import { acapFormatFontsMissedReplacement } from '../../util/AcApFormatFontMissedMessage';
+import { acapFormatUnsupportedEntitiesMessage, acapI18nTranslate } from '../../util/AcApFormatUnsupportedEntitiesMessage';
+import { acapFormatOpenFileErrorMessage, acapFormatOpenFileErrorTitle } from '../../util/AcApOpenFileErrorMessage';
+/**
+ * Subscribes to engine events and forwards user-visible alerts into the active
+ * {@link AcApNotificationCenter}.
+ *
+ * Shared by the built-in DOM center and host overrides (e.g. cad-viewer).
+ * Notifications are tagged with the current {@link AcApDocSession.id}.
+ */
+var AcApNotificationEventBridge = /** @class */ (function () {
+    /**
+     * @param docManager - Manager whose events and active session are observed.
+     * @param getCenter - Accessor for the currently installed notification center.
+     */
+    function AcApNotificationEventBridge(docManager, getCenter) {
+        var _this = this;
+        /** Parser unknown-entity counts keyed by {@link AcApDocSession.id}. */
+        this._pendingUnknownBySession = new Map();
+        /**
+         * Sessions that already received an unsupported-entity pass for the current
+         * open. Prevents tab switches from clearing and re-scanning (and from
+         * dropping warnings that depended solely on the one-shot PARSE stats).
+         */
+        this._unsupportedNotifiedSessions = new Set();
+        /** Whether {@link install} has attached listeners. */
+        this._installed = false;
+        /**
+         * Handles generic `message` bus events and mirrors them into the center.
+         *
+         * @param params - Message text and severity.
+         */
+        this._onMessage = function (params) {
+            var center = _this._getCenter();
+            var title = params.type === 'error'
+                ? acapI18nTranslate('main.notification.title.systemError')
+                : params.type === 'warning'
+                    ? acapI18nTranslate('main.notification.title.systemWarning')
+                    : params.type === 'success'
+                        ? acapI18nTranslate('main.notification.title.systemMessage')
+                        : acapI18nTranslate('main.notification.title.systemInfo');
+            var options = _this.sessionOptions();
+            switch (params.type) {
+                case 'error':
+                    center.error(title, params.message, options);
+                    break;
+                case 'warning':
+                    center.warning(title, params.message, options);
+                    break;
+                case 'success':
+                    center.success(title, params.message, options);
+                    break;
+                default:
+                    center.info(title, params.message, options);
+                    break;
+            }
+        };
+        /**
+         * Handles fonts that failed to load from the remote repository.
+         *
+         * @param params - Failed font descriptors.
+         */
+        this._onFontsNotLoaded = function (params) {
+            var fontNames = params.fonts.map(function (font) { return font.fontName; });
+            _this._getCenter().error(acapI18nTranslate('main.notification.title.fontNotLoaded'), acapI18nTranslate('main.message.fontsNotLoaded', {
+                fonts: acapFormatFontsMissedReplacement(fontNames)
+            }), __assign({ source: 'font-missed', fontNames: fontNames, persistent: true }, _this.sessionOptions()));
+        };
+        /**
+         * Handles fonts that could not be found in the remote repository.
+         *
+         * @param params - Missing font names.
+         */
+        this._onFontsNotFound = function (params) {
+            _this._getCenter().warning(acapI18nTranslate('main.notification.title.fontNotFound'), acapI18nTranslate('main.message.fontsNotFound', {
+                fonts: acapFormatFontsMissedReplacement(params.fonts)
+            }), __assign({ source: 'font-missed', fontNames: params.fonts }, _this.sessionOptions()));
+        };
+        /**
+         * Handles a single font required by the drawing that is unavailable at render time.
+         *
+         * Replaces any prior `font-missed` entry for the same font name.
+         *
+         * @param params - Font name and how many text objects require it.
+         */
+        this._onFontNotFound = function (params) {
+            var fontName = params.fontName.trim();
+            if (!fontName)
+                return;
+            var center = _this._getCenter();
+            center.removeWhere(function (notification) {
+                var _a;
+                return notification.source === 'font-missed' &&
+                    ((_a = notification.fontNames) === null || _a === void 0 ? void 0 : _a.includes(fontName)) === true;
+            });
+            center.warning(acapI18nTranslate('main.notification.title.fontNotFound'), acapI18nTranslate('main.message.fontMissedInDrawing', {
+                font: fontName,
+                count: params.count,
+                replacementFont: AcApFontUtil.getReplacementFontName(fontName)
+            }), __assign({ source: 'font-missed', fontNames: [fontName] }, _this.sessionOptions()));
+        };
+        /**
+         * Prunes resolved `font-missed` notifications when missed-data changes.
+         */
+        this._onMissedDataChanged = function () {
+            var missedFonts = Object.keys(_this._docManager.curView.missedData.fonts);
+            _this._getCenter().removeResolvedFontMissedNotifications(missedFonts);
+        };
+        /**
+         * Handles failure to fetch the available-fonts catalog.
+         *
+         * @param params - Catalog URL that failed.
+         */
+        this._onFailedToGetFonts = function (params) {
+            _this._getCenter().error(acapI18nTranslate('main.notification.title.systemError'), acapI18nTranslate('main.message.failedToGetAvaiableFonts', {
+                url: params.url
+            }), _this.sessionOptions());
+        };
+        /**
+         * Handles open-file failures and writes a persistent error notification.
+         *
+         * @param params - File name and structured error metadata.
+         */
+        this._onFailedToOpenFile = function (params) {
+            _this._getCenter().error(acapFormatOpenFileErrorTitle(params.errorCode), acapFormatOpenFileErrorMessage(params), _this.sessionOptions());
+        };
+        /**
+         * Captures `unknownEntityCount` from PARSE END for the active session.
+         *
+         * @param data - Open-file progress payload.
+         */
+        this._onOpenFileProgress = function (data) {
+            var _a;
+            if (data.stage === 'CONVERSION' &&
+                data.subStage === 'PARSE' &&
+                data.subStageStatus === 'END' &&
+                data.data) {
+                var stats = data.data;
+                var sessionId = _this._docManager.activeSessionId;
+                if (sessionId) {
+                    _this._pendingUnknownBySession.set(sessionId, (_a = stats.unknownEntityCount) !== null && _a !== void 0 ? _a : 0);
+                }
+            }
+        };
+        /**
+         * Resets unsupported-entity bookkeeping before a new open starts.
+         */
+        this._onDocumentToBeOpened = function () {
+            _this.syncActiveSession();
+            var sessionId = _this._docManager.activeSessionId;
+            if (sessionId) {
+                _this.forgetSession(sessionId);
+                _this._pendingUnknownBySession.set(sessionId, 0);
+            }
+            _this._getCenter().removeBySource('unsupported-entities');
+        };
+        /**
+         * Syncs the active session when a document is created.
+         */
+        this._onDocumentCreated = function () {
+            _this.syncActiveSession();
+        };
+        /**
+         * Syncs the session and runs unsupported-entity analysis on first activation.
+         *
+         * Subsequent activations for the same open skip re-analysis.
+         */
+        this._onDocumentActivated = function () {
+            _this.syncActiveSession();
+            var sessionId = _this._docManager.activeSessionId;
+            // Tab switch / re-activate: keep the existing unsupported warning and skip
+            // another full-database proxy scan.
+            if (sessionId && _this._unsupportedNotifiedSessions.has(sessionId)) {
+                return;
+            }
+            _this.notifyUnsupportedEntities();
+        };
+        /**
+         * Clears the closed session's notifications and local analysis state.
+         *
+         * @param args - Document about to be destroyed.
+         */
+        this._onDocumentToBeDestroyed = function (args) {
+            var session = _this._docManager.sessionFor(args.doc);
+            if (session) {
+                _this.forgetSession(session.id);
+                _this._getCenter().clearSession(session.id);
+            }
+        };
+        this._docManager = docManager;
+        this._getCenter = getCenter;
+    }
+    /**
+     * Builds options that stamp the active session id onto a new notification.
+     *
+     * @returns `{ sessionId }` when a session is active, otherwise `{}`.
+     */
+    AcApNotificationEventBridge.prototype.sessionOptions = function () {
+        var sessionId = this._docManager.activeSessionId;
+        return sessionId ? { sessionId: sessionId } : {};
+    };
+    /**
+     * Pushes the manager's active session id into the center.
+     */
+    AcApNotificationEventBridge.prototype.syncActiveSession = function () {
+        this._getCenter().setActiveSession(this._docManager.activeSessionId);
+    };
+    /**
+     * Drops per-session PARSE / analysis bookkeeping for a closed or reopened session.
+     *
+     * @param sessionId - Session to forget.
+     */
+    AcApNotificationEventBridge.prototype.forgetSession = function (sessionId) {
+        this._pendingUnknownBySession.delete(sessionId);
+        this._unsupportedNotifiedSessions.delete(sessionId);
+    };
+    /**
+     * Attaches event-bus and document-manager listeners. Idempotent.
+     */
+    AcApNotificationEventBridge.prototype.install = function () {
+        if (this._installed)
+            return;
+        this._installed = true;
+        this.syncActiveSession();
+        eventBus.on('message', this._onMessage);
+        eventBus.on('fonts-not-loaded', this._onFontsNotLoaded);
+        eventBus.on('fonts-not-found', this._onFontsNotFound);
+        eventBus.on('font-not-found', this._onFontNotFound);
+        eventBus.on('missed-data-changed', this._onMissedDataChanged);
+        eventBus.on('failed-to-get-avaiable-fonts', this._onFailedToGetFonts);
+        eventBus.on('failed-to-open-file', this._onFailedToOpenFile);
+        eventBus.on('open-file-progress', this._onOpenFileProgress);
+        this._docManager.events.documentToBeOpened.addEventListener(this._onDocumentToBeOpened);
+        this._docManager.events.documentCreated.addEventListener(this._onDocumentCreated);
+        this._docManager.events.documentActivated.addEventListener(this._onDocumentActivated);
+        this._docManager.events.documentToBeDestroyed.addEventListener(this._onDocumentToBeDestroyed);
+    };
+    /**
+     * Detaches all listeners and clears per-session analysis bookkeeping. Idempotent.
+     */
+    AcApNotificationEventBridge.prototype.uninstall = function () {
+        if (!this._installed)
+            return;
+        this._installed = false;
+        eventBus.off('message', this._onMessage);
+        eventBus.off('fonts-not-loaded', this._onFontsNotLoaded);
+        eventBus.off('fonts-not-found', this._onFontsNotFound);
+        eventBus.off('font-not-found', this._onFontNotFound);
+        eventBus.off('missed-data-changed', this._onMissedDataChanged);
+        eventBus.off('failed-to-get-avaiable-fonts', this._onFailedToGetFonts);
+        eventBus.off('failed-to-open-file', this._onFailedToOpenFile);
+        eventBus.off('open-file-progress', this._onOpenFileProgress);
+        this._docManager.events.documentToBeOpened.removeEventListener(this._onDocumentToBeOpened);
+        this._docManager.events.documentCreated.removeEventListener(this._onDocumentCreated);
+        this._docManager.events.documentActivated.removeEventListener(this._onDocumentActivated);
+        this._docManager.events.documentToBeDestroyed.removeEventListener(this._onDocumentToBeDestroyed);
+        this._pendingUnknownBySession.clear();
+        this._unsupportedNotifiedSessions.clear();
+    };
+    /**
+     * Analyzes the current document for unsupported entities and writes a warning
+     * when {@link AcApUnsupportedDrawingAnalysis.shouldWarn} is true.
+     *
+     * Marks the active session as notified so later tab switches do not rescan.
+     */
+    AcApNotificationEventBridge.prototype.notifyUnsupportedEntities = function () {
+        var _a;
+        var doc = this._docManager.curDocument;
+        if (!doc)
+            return;
+        var sessionId = this._docManager.activeSessionId;
+        var unknownCount = sessionId
+            ? ((_a = this._pendingUnknownBySession.get(sessionId)) !== null && _a !== void 0 ? _a : 0)
+            : 0;
+        var classOnly = acapAnalyzeUnsupportedDrawing(doc.database, unknownCount, {
+            scanProxies: false
+        });
+        var analysis = classOnly.isTianzhengDrawing || classOnly.unknownEntityCount > 0
+            ? classOnly
+            : acapAnalyzeUnsupportedDrawing(doc.database, unknownCount, {
+                scanProxies: true
+            });
+        if (sessionId) {
+            this._unsupportedNotifiedSessions.add(sessionId);
+        }
+        var center = this._getCenter();
+        center.removeBySource('unsupported-entities');
+        if (!analysis.shouldWarn)
+            return;
+        center.warning(acapI18nTranslate('main.notification.title.parsingWarning'), acapFormatUnsupportedEntitiesMessage(analysis), __assign({ source: 'unsupported-entities', persistent: true }, this.sessionOptions()));
+    };
+    return AcApNotificationEventBridge;
+}());
+export { AcApNotificationEventBridge };
+//# sourceMappingURL=AcApNotificationEventBridge.js.map

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

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

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

@@ -0,0 +1,185 @@
+import { type AcUiNotificationBellPlacement } from '../../ui/AcUiDefaultNotificationUi';
+import type { AcApDocManager } from '../AcApDocManager';
+import type { AcApNotificationCenter } from './AcApNotificationTypes';
+export type { AcUiNotificationBellPlacement };
+/**
+ * Options for {@link AcApNotificationService.install} /
+ * {@link acapInstallNotificationService}.
+ */
+export interface AcApNotificationServiceOptions {
+    /**
+     * Host element for the built-in notification bell/panel.
+     * Defaults to the active view canvas container (`curView.container`) so the
+     * chrome is positioned relative to the drawing area, not the browser window.
+     */
+    host?: HTMLElement;
+    /**
+     * When `false`, skips installing the built-in DOM UI (bridge still runs so a
+     * later custom center receives events). Default `true`.
+     */
+    showDefaultUi?: boolean;
+    /**
+     * When `false`, skips the event bridge entirely. Default `true`.
+     */
+    enableBridge?: boolean;
+    /**
+     * Corner for the built-in notification bell.
+     *
+     * When omitted: phone uses `top-right` (below the shortcut toolbar); pad and
+     * desktop use `bottom-right`. Pass a value to override, or call
+     * {@link acapSetNotificationUiPlacement} later.
+     */
+    placement?: AcUiNotificationBellPlacement;
+}
+/**
+ * Owns the active {@link AcApNotificationCenter}, optional default DOM UI, and
+ * the shared event bridge.
+ *
+ * Hosts override the center with {@link acapSetNotificationCenter}; passing
+ * `null` restores the built-in store + UI.
+ */
+declare class AcApNotificationService {
+    /** Currently active center (built-in store or host adapter). */
+    private _center;
+    /** Built-in store instance used when no custom center is installed. */
+    private _defaultStore;
+    /** Optional default DOM bell / panel ({@link AcUiDefaultNotificationUi}). */
+    private _defaultUi?;
+    /** Shared event bridge that writes into {@link _center}. */
+    private _bridge?;
+    /** Explicit host for the default UI, when provided at install time. */
+    private _host?;
+    /** Whether the built-in DOM UI should be mounted when not overridden. */
+    private _showDefaultUi;
+    /** Explicit bell placement; `undefined` uses layout defaults. */
+    private _placement?;
+    /** `true` when {@link _center} is a host-supplied override. */
+    private _isCustom;
+    /** Document manager last passed to {@link install}. */
+    private _docManager?;
+    /**
+     * Installs bridge + default UI for a document manager instance.
+     * Safe to call once per {@link AcApDocManager.createInstance}.
+     *
+     * @param docManager - Manager whose sessions and events are observed.
+     * @param options - Bridge / UI install flags.
+     */
+    install(docManager: AcApDocManager, options?: AcApNotificationServiceOptions): void;
+    /**
+     * Explicit bell placement, or `undefined` when using layout defaults.
+     */
+    get placement(): AcUiNotificationBellPlacement | undefined;
+    /**
+     * Sets or clears the built-in notification bell corner.
+     *
+     * Applies immediately when the default DOM UI is mounted. Pass `undefined`
+     * to restore layout-based defaults.
+     *
+     * @param placement - Corner placement, or `undefined` for auto.
+     */
+    setPlacement(placement: AcUiNotificationBellPlacement | undefined): void;
+    /**
+     * Active notification center (built-in or host override).
+     */
+    get center(): AcApNotificationCenter;
+    /**
+     * Whether a host-supplied center is currently installed.
+     */
+    get isCustom(): boolean;
+    /**
+     * Replaces the active notification center.
+     *
+     * @param center - Custom center, or `null` to restore the built-in default.
+     */
+    setCenter(center: AcApNotificationCenter | null): void;
+    /**
+     * Restores the built-in store and remounts the default UI when enabled.
+     */
+    private restoreDefault;
+    /**
+     * Resolves the DOM host for the default bell / panel.
+     *
+     * @returns Explicit host, view container, or `document.body`.
+     */
+    private resolveHost;
+    /**
+     * Mounts (or remounts) {@link AcUiDefaultNotificationUi} on {@link resolveHost}.
+     */
+    private mountDefaultUi;
+    /**
+     * Tears down the default DOM UI if present.
+     */
+    private disposeDefaultUi;
+    /**
+     * Tears down bridge and UI (e.g. DocManager destroy).
+     *
+     * Resets to a fresh built-in store so a later {@link install} / host
+     * {@link setCenter} does not reuse a disposed custom center instance.
+     */
+    dispose(): void;
+}
+/** Process-wide notification service singleton. */
+declare const notificationService: AcApNotificationService;
+/**
+ * Returns the active notification center (built-in or host override).
+ *
+ * @returns The center currently owned by the service.
+ */
+export declare function acapNotificationCenter(): AcApNotificationCenter;
+/**
+ * Installs / replaces the host notification center.
+ *
+ * Pass `null` to restore the built-in DOM notification center.
+ *
+ * @param center - Custom center adapter, or `null` to restore the default.
+ *
+ * @example
+ * ```ts
+ * // cad-viewer
+ * acapSetNotificationCenter(vueNotificationAdapter)
+ *
+ * // later / on unmount
+ * acapSetNotificationCenter(null)
+ * ```
+ */
+export declare function acapSetNotificationCenter(center: AcApNotificationCenter | null): void;
+/**
+ * Returns the explicit built-in notification bell placement, if any.
+ *
+ * @returns Placement override, or `undefined` when using layout defaults.
+ */
+export declare function acapGetNotificationUiPlacement(): AcUiNotificationBellPlacement | undefined;
+/**
+ * Sets the built-in notification bell corner (default DOM UI only).
+ *
+ * Pass `undefined` / omit override via `null` to restore layout defaults:
+ * phone `top-right`, pad / desktop `bottom-right`.
+ *
+ * Has no effect when a custom center replaced the default UI
+ * (`showDefaultUi: false` or {@link acapSetNotificationCenter}).
+ *
+ * @param placement - Corner placement, or `null` / `undefined` for auto.
+ *
+ * @example
+ * ```ts
+ * acapSetNotificationUiPlacement('bottom-left')
+ * acapSetNotificationUiPlacement(null) // restore auto
+ * ```
+ */
+export declare function acapSetNotificationUiPlacement(placement: AcUiNotificationBellPlacement | null | undefined): void;
+/**
+ * @internal Used by {@link AcApDocManager}.
+ *
+ * @param docManager - Manager to bind the bridge to.
+ * @param options - Bridge / UI install flags.
+ */
+export declare function acapInstallNotificationService(docManager: AcApDocManager, options?: AcApNotificationServiceOptions): void;
+/**
+ * @internal Used by {@link AcApDocManager.destroy}.
+ */
+export declare function acapDisposeNotificationService(): void;
+/**
+ * Process-wide service instance (bridge + center + optional default UI).
+ */
+export { notificationService as acapNotificationService };
+//# sourceMappingURL=AcApNotificationService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcApNotificationService.d.ts","sourceRoot":"","sources":["../../../src/app/notification/AcApNotificationService.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAErE,YAAY,EAAE,6BAA6B,EAAE,CAAA;AAE7C;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,6BAA6B,CAAA;CAC1C;AAED;;;;;;GAMG;AACH,cAAM,uBAAuB;IAC3B,gEAAgE;IAChE,OAAO,CAAC,OAAO,CAAsD;IACrE,uEAAuE;IACvE,OAAO,CAAC,aAAa,CAAwC;IAC7D,6EAA6E;IAC7E,OAAO,CAAC,UAAU,CAAC,CAA2B;IAC9C,4DAA4D;IAC5D,OAAO,CAAC,OAAO,CAAC,CAA6B;IAC7C,uEAAuE;IACvE,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,yEAAyE;IACzE,OAAO,CAAC,cAAc,CAAO;IAC7B,iEAAiE;IACjE,OAAO,CAAC,UAAU,CAAC,CAA+B;IAClD,+DAA+D;IAC/D,OAAO,CAAC,SAAS,CAAQ;IACzB,uDAAuD;IACvD,OAAO,CAAC,WAAW,CAAC,CAAgB;IAEpC;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,GAAE,8BAAmC;IAqBhF;;OAEG;IACH,IAAI,SAAS,IAAI,6BAA6B,GAAG,SAAS,CAEzD;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,SAAS,EAAE,6BAA6B,GAAG,SAAS;IAKjE;;OAEG;IACH,IAAI,MAAM,IAAI,sBAAsB,CAEnC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAqB/C;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;;;;OAKG;IACH,OAAO;CAaR;AAED,mDAAmD;AACnD,QAAA,MAAM,mBAAmB,yBAAgC,CAAA;AAEzD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,sBAAsB,CAE/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,GAAG,IAAI,QAGtC;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAC1C,6BAA6B,GAC7B,SAAS,CAEZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,6BAA6B,GAAG,IAAI,GAAG,SAAS,QAG5D;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE,8BAA8B,QAGzC;AAED;;GAEG;AACH,wBAAgB,8BAA8B,SAE7C;AAED;;GAEG;AACH,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,CAAA"}