@mlightcad/cad-simple-viewer 1.6.3 → 1.7.1

package/lib/ui/AcUiDefaultNotificationUi.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Built-in notification bell / panel for hosts that do not supply their own center.
+ *
+ * Lives under `src/ui` (`AcUi*`) because it is presentational DOM chrome.
+ * The application service / store / event bridge remain under `src/app/notification` (`AcAp*`).
+ *
+ * @module AcUiDefaultNotificationUi
+ * @packageDocumentation
+ */
+import { type AcApNotificationCenter } from '../app/notification/AcApNotificationTypes';
+/**
+ * Corner placement for the built-in notification bell.
+ *
+ * Panel presentation still follows layout kind (phone / pad sheet vs desktop
+ * popover); this only controls where the bell sits on the canvas host.
+ */
+export type AcUiNotificationBellPlacement = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+/** Options for {@link AcUiDefaultNotificationUi}. */
+export interface AcUiDefaultNotificationUiOptions {
+    /**
+     * Explicit bell corner. When omitted, phone uses `top-right` (below the
+     * shortcut toolbar) and pad / desktop use `bottom-right`.
+     */
+    placement?: AcUiNotificationBellPlacement;
+}
+/**
+ * Built-in notification UI for hosts that do not supply their own center.
+ *
+ * Interaction (aligned with iOS Notification Center ideas, adapted to CAD chrome):
+ * - Hidden entirely when there are no notifications (no idle bell clutter).
+ * - With messages: show only a badge-bearing bell; the list opens on tap.
+ * - Anchored to the **canvas host** (view container), not the browser window.
+ * - Desktop / pad: bell at the host's bottom-right by default; pad panel is a
+ *   top sheet sized like the session input panel.
+ * - Phone: bell sits **below** the shortcut toolbar (measured live); panel is
+ *   a full-width top sheet + dimmed backdrop.
+ *
+ * Theme tokens follow {@link resolveUiTheme} / `--ml-ui-*`.
+ */
+export declare class AcUiDefaultNotificationUi {
+    /** Canvas / view container the chrome is positioned relative to. */
+    private readonly _host;
+    /** Center whose active-session list drives the UI. */
+    private readonly _center;
+    /** Absolute overlay root covering the host. */
+    private readonly _root;
+    /** Full-host dismiss button shown behind phone / pad sheets. */
+    private readonly _backdrop;
+    /** Badge-bearing bell button. */
+    private readonly _bell;
+    /** Unread count badge on the bell. */
+    private readonly _badge;
+    /** Notification list panel / phone sheet. */
+    private readonly _panel;
+    /** Scrollable list body inside the panel. */
+    private readonly _list;
+    /** Localized panel title element. */
+    private readonly _titleEl;
+    /** Keys of collapsible groups the user has expanded. */
+    private _expandedGroups;
+    /** Whether the list panel is currently open. */
+    private _panelOpen;
+    /** Latest UI layout kind from {@link acedGetUiLayout}. */
+    private _layoutKind;
+    /** Explicit placement override; `undefined` means layout-based default. */
+    private _placement?;
+    /** Unsubscribe callbacks for center / theme / layout subscriptions. */
+    private readonly _unsubs;
+    /** Observes host / shortcut toolbar size for top-anchor repositioning. */
+    private _shortcutObserver?;
+    /** Pending `requestAnimationFrame` id for {@link scheduleReposition}. */
+    private _repositionRaf;
+    /**
+     * Builds and mounts the default notification chrome.
+     *
+     * @param center - Center to observe and mutate (clear / remove).
+     * @param host - Element that owns the absolute overlay (typically the canvas container).
+     * @param options - Optional bell placement override.
+     */
+    constructor(center: AcApNotificationCenter, host: HTMLElement, options?: AcUiDefaultNotificationUiOptions);
+    /** Outside-click handler that closes the panel on pointerdown. */
+    private _onDocPointer;
+    /** Window resize handler that schedules chrome repositioning. */
+    private _onWindowResize;
+    /**
+     * Explicit placement override, or `undefined` when using layout defaults.
+     */
+    get placement(): AcUiNotificationBellPlacement | undefined;
+    /**
+     * Sets or clears the bell corner placement.
+     *
+     * Pass `undefined` to restore layout-based defaults (phone `top-right`,
+     * pad / desktop `bottom-right`).
+     *
+     * @param placement - Corner placement, or `undefined` for auto.
+     */
+    setPlacement(placement: AcUiNotificationBellPlacement | undefined): void;
+    /**
+     * Applies the current UI theme tokens to the overlay root.
+     */
+    private applyTheme;
+    /**
+     * Updates layout modifier classes and repositions top-anchored chrome.
+     *
+     * @param kind - Responsive layout kind (`phone` / `pad` / `desktop`).
+     */
+    private applyLayout;
+    /**
+     * Effective bell placement (explicit override or layout default).
+     */
+    private resolvePlacement;
+    /**
+     * Places the bell below the live shortcut toolbar when using a top
+     * placement. Bottom placements use CSS on the full-host root.
+     *
+     * The root always covers the canvas host (`inset: 0`) so panel `width: 100%`
+     * resolves against the drawing area, not the 36px bell box.
+     */
+    private repositionChrome;
+    /**
+     * Coalesces reposition work onto the next animation frame.
+     */
+    private scheduleReposition;
+    /**
+     * Refreshes localized title / aria labels on the bell and panel.
+     */
+    private refreshChromeLabels;
+    /**
+     * Opens or closes the notification panel.
+     *
+     * Forced closed when the active session has no messages.
+     *
+     * @param open - Desired open state.
+     */
+    private setPanelOpen;
+    /**
+     * Syncs root / panel / backdrop visibility from message count and panel state.
+     */
+    private syncPanelVisibility;
+    /**
+     * Reacts to center changes: updates the badge and optionally refreshes the open list.
+     */
+    private render;
+    /**
+     * Rebuilds the panel list from the active session's notifications.
+     */
+    private renderList;
+    /**
+     * Renders a collapsible group header (and expanded body when open).
+     *
+     * @param group - Groupable notification cluster.
+     * @returns DOM subtree for the group.
+     */
+    private renderGroup;
+    /**
+     * Renders a single notification row with optional message and dismiss control.
+     *
+     * @param notification - Entry to display.
+     * @returns DOM subtree for the item.
+     */
+    private renderItem;
+    /**
+     * Unsubscribes listeners, disconnects observers, and removes the overlay from the DOM.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=AcUiDefaultNotificationUi.d.ts.map

package/lib/ui/AcUiDefaultNotificationUi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcUiDefaultNotificationUi.d.ts","sourceRoot":"","sources":["../../src/ui/AcUiDefaultNotificationUi.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAGL,KAAK,sBAAsB,EAG5B,MAAM,2CAA2C,CAAA;AA8BlD;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GACrC,cAAc,GACd,aAAa,GACb,WAAW,GACX,UAAU,CAAA;AAEd,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,SAAS,CAAC,EAAE,6BAA6B,CAAA;CAC1C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAAyB;IACpC,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,wDAAwD;IACxD,OAAO,CAAC,eAAe,CAAoB;IAC3C,gDAAgD;IAChD,OAAO,CAAC,UAAU,CAAQ;IAC1B,0DAA0D;IAC1D,OAAO,CAAC,WAAW,CAA8B;IACjD,2EAA2E;IAC3E,OAAO,CAAC,UAAU,CAAC,CAA+B;IAClD,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB,CAAC,CAAgB;IAC1C,yEAAyE;IACzE,OAAO,CAAC,cAAc,CAAI;IAE1B;;;;;;OAMG;gBAED,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,gCAAqC;IAiGhD,kEAAkE;IAClE,OAAO,CAAC,aAAa,CAAwB;IAC7C,iEAAiE;IACjE,OAAO,CAAC,eAAe,CAAY;IAEnC;;OAEG;IACH,IAAI,SAAS,IAAI,6BAA6B,GAAG,SAAS,CAEzD;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,SAAS,EAAE,6BAA6B,GAAG,SAAS;IAMjE;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAuExB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,MAAM;IAgBd;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IA8BnB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IA4BlB;;OAEG;IACH,OAAO;CAaR"}