@mlightcad/cad-simple-viewer 1.8.0-preview.2 → 1.8.0-preview.4

package/lib/ui/dock/AcUiDockPanel.d.ts

@@ -0,0 +1,204 @@
+/** Dock panel edge placement relative to the viewer host element. */
+export type AcUiDockPanelSide = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Translates dock chrome and tab labels. Callers typically pass
+ * `key => AcApI18n.t(key)` so plugin tests can mock the package export.
+ */
+export type AcUiDockPanelTranslate = (key: string) => string;
+/** Tab definition for {@link AcUiDockPanel}. */
+export interface AcUiDockPanelTab {
+    /** Stable tab identifier. */
+    id: string;
+    /**
+     * Full i18n message key for the tab label
+     * (for example `main.dockPanel.tab.layers`).
+     */
+    labelKey?: string;
+    /** Plain label when no i18n key is provided. */
+    label?: string;
+    /** Tab content element. */
+    content: HTMLElement;
+}
+/** Constructor options for {@link AcUiDockPanel}. */
+export interface AcUiDockPanelOptions {
+    /** Viewer host element; dock panel is appended as a direct child. */
+    host: HTMLElement;
+    /**
+     * Translates full message keys (chrome under `main.dockPanel.*` and tab
+     * {@link AcUiDockPanelTab.labelKey} values). Defaults to returning the key.
+     */
+    t?: AcUiDockPanelTranslate;
+    /** Initial dock side. @default 'left' */
+    defaultSide?: AcUiDockPanelSide;
+    /** Whether the panel starts open. @default false */
+    defaultOpen?: boolean;
+    /** Called when the panel is opened (including tab switches while open). */
+    onOpen?: () => void;
+    /** Bottom dock default height in px. @default 240 */
+    defaultHeight?: number;
+    /** Left/right dock default width in px. @default 280 */
+    defaultWidth?: number;
+}
+/**
+ * Chrome DevTools-style dock panel with tabs, open/close, and dock side selection.
+ */
+export declare class AcUiDockPanel {
+    private host;
+    private readonly translate;
+    private readonly root;
+    private readonly contentEl;
+    private readonly tabsWrap;
+    private readonly tabsEl;
+    private readonly overflowButton;
+    private readonly bodyEl;
+    private readonly resizeHandle;
+    private readonly sideMenuButton;
+    private readonly closeButton;
+    private readonly sheetChrome;
+    private readonly sheetGrabber;
+    private readonly sheetCloseButton;
+    private readonly tabs;
+    private readonly closeListeners;
+    private activeTabId?;
+    private side;
+    private isPanelOpen;
+    private size;
+    private defaultHeight;
+    private defaultWidth;
+    /** Invoked at the start of {@link open} so callers can dismiss sub-toolbars. */
+    private readonly onOpen?;
+    private sideMenuRoot?;
+    private overflowMenuRoot?;
+    private overflowTabIds;
+    private tabOverflowFrame?;
+    private tabOverflowObserver?;
+    private resizePointerId?;
+    private resizeStartPos;
+    private resizeStartSize;
+    /** Element that captured the active resize pointer (handle or sheet grabber). */
+    private resizeCaptureTarget?;
+    /** Wraps canvas content so only the drawing area shrinks when the dock opens. */
+    private dockMainWrapper?;
+    private mobileMediaQuery?;
+    private handleResizePointerDown;
+    private handleResizePointerMove;
+    private handleResizePointerUp;
+    private handleDocumentPointerDown;
+    /**
+     * @param options - Host, i18n, and initial layout options.
+     */
+    constructor(options: AcUiDockPanelOptions);
+    /**
+     * Registers a callback run each time the panel is closed (close button,
+     * toggle, or {@link close}).
+     *
+     * @returns Function that removes the callback.
+     */
+    addCloseListener(listener: () => void): () => void;
+    /** Whether a tab with the given id is registered. */
+    hasTab(tabId: string): boolean;
+    /**
+     * Registers a tab with the dock panel.
+     *
+     * @param tab - Tab definition.
+     * @returns `true` when the tab was added; `false` if it already exists or is invalid.
+     */
+    addTab(tab: AcUiDockPanelTab): boolean;
+    /**
+     * Moves the dock panel to a new mount element (for example when the canvas parent
+     * becomes available after plugin load).
+     *
+     * @param newHost - New mount target.
+     */
+    reparentTo(newHost: HTMLElement): void;
+    /** Ensures the panel root is attached to the current mount host. */
+    ensureMounted(): void;
+    /**
+     * Removes a tab and its content panel from the dock.
+     *
+     * @param tabId - Tab identifier to remove.
+     */
+    removeTab(tabId: string): void;
+    /** Whether the dock panel has any registered tabs. */
+    get hasTabs(): boolean;
+    /**
+     * Opens the panel and optionally activates a tab.
+     *
+     * @param tabId - Tab to activate.
+     */
+    open(tabId?: string): void;
+    /** Closes the panel without destroying it. */
+    close(): void;
+    /**
+     * Toggles panel visibility; when opening, activates the given tab.
+     *
+     * @param tabId - Tab to activate when opening.
+     */
+    toggle(tabId?: string): void;
+    /**
+     * Switches dock side and re-mounts within the host.
+     *
+     * @param side - New dock side.
+     */
+    setSide(side: AcUiDockPanelSide): void;
+    /** Current mount host element for the dock panel root. */
+    getMountHost(): HTMLElement;
+    /** Whether the panel is currently open. */
+    get isOpen(): boolean;
+    /** Current dock side. */
+    getSide(): AcUiDockPanelSide;
+    /** Current panel size in px (width for left/right, height for top/bottom). */
+    getSize(): number;
+    /**
+     * Sets panel size in px, clamped to the dock host bounds.
+     *
+     * @param size - Target size in px.
+     */
+    setPanelSize(size: number): void;
+    /** Current active tab id, if any. */
+    get activeTab(): string | undefined;
+    /** Updates tab labels and action button titles after locale change. */
+    refreshLocale(): void;
+    /** Removes the panel from the DOM and cleans up listeners. */
+    destroy(): void;
+    private openPanel;
+    private setActiveTab;
+    private ensureHostLayout;
+    /**
+     * Groups existing mount-target children so flex shrink applies to the canvas slot only.
+     */
+    private ensureDockMainWrapper;
+    /** Moves canvas content out of the dock wrapper and restores the original host tree. */
+    private releaseDockMainWrapper;
+    private clearHostLayoutClasses;
+    private mountToHost;
+    private applyLayoutState;
+    private setSize;
+    private getMaxSize;
+    /** Whether the dock is shown as a full-width sheet above the phone toolbar. */
+    private usesPhoneSheet;
+    /** Whether height (rather than width) is resized. */
+    private usesVerticalResize;
+    private bindMobileMediaQuery;
+    private unbindMobileMediaQuery;
+    private handleMobileMediaChange;
+    private syncPhoneSheetInset;
+    /** Combined height of the in-host toolbar and any visible sub-toolbars. */
+    private getPhoneChromeInset;
+    private isElementVisible;
+    private toggleSideMenu;
+    private openSideMenu;
+    private renderSideMenuItems;
+    private closeSideMenu;
+    private syncOutsidePointerListener;
+    private scheduleUpdateTabOverflow;
+    private updateTabOverflow;
+    private getTabLabel;
+    /** Translates a chrome string under `main.dockPanel.*`. */
+    private t;
+    private toggleOverflowMenu;
+    private openOverflowMenu;
+    private renderOverflowMenuItems;
+    private closeOverflowMenu;
+}
+//# sourceMappingURL=AcUiDockPanel.d.ts.map

package/lib/ui/dock/AcUiDockPanel.d.ts.map

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