@mlightcad/cad-simple-viewer 1.7.0 → 1.7.1

package/lib/ui/toolbar/AcUiSubToolbar.d.ts

@@ -0,0 +1,125 @@
+import type { AcUiResolvedToolbarChrome } from './resolveToolbarChrome';
+import type { AcUiSubToolbarPosition, AcUiToolbarI18n, AcUiToolbarItem, AcUiToolbarPlacement } from './types';
+/** Constructor options for {@link AcUiSubToolbar}. */
+export interface AcUiSubToolbarMountOptions {
+    /** i18n helper for button tooltips. */
+    i18n: AcUiToolbarI18n;
+    /** Child items to render. */
+    items: AcUiToolbarItem[];
+    /** Parent toolbar button used for positioning and outside-click exclusion. */
+    anchor: HTMLElement;
+    /** Main toolbar root used to place the strip beside the parent bar. */
+    toolbarRoot: HTMLElement;
+    /** Canvas mount that receives the strip (positioned absolutely). */
+    host: HTMLElement;
+    /** Parent toolbar edge placement. */
+    placement: AcUiToolbarPlacement;
+    /** Resolved layout and chrome options. */
+    chrome: AcUiResolvedToolbarChrome;
+    /**
+     * Aligns the strip along the parent toolbar axis.
+     * @default 'front'
+     */
+    position?: AcUiSubToolbarPosition;
+    /** Cross-axis host margins inherited from the parent toolbar. */
+    getCrossAxisInset: () => {
+        near: number;
+        far: number;
+    };
+    /**
+     * When true, canvas / outside clicks do not close the strip.
+     * Only the parent button (or an explicit {@link close}) dismisses it.
+     */
+    sticky: boolean;
+    /** Whether command buttons should be disabled (document loading / missing). */
+    commandsDisabled: boolean;
+    /** Invoked when a leaf item is activated. */
+    onSelect: (item: AcUiToolbarItem, button: HTMLButtonElement) => void;
+    /** Invoked when the strip is closed. */
+    onClose?: () => void;
+    /**
+     * Keeps a dismissible strip open when the event target lies in related UI
+     * (for example a nested sub-toolbar opened from this strip).
+     */
+    shouldKeepOpenForTarget?: (target: Node) => boolean;
+}
+/**
+ * Icon strip shown beside a parent toolbar button (HTML-export tool-strip model).
+ *
+ * Sticky strips stay open until the parent is clicked again. Dismissible strips
+ * close on outside click, matching a lightweight flyout toolbar.
+ */
+export declare class AcUiSubToolbar {
+    private options;
+    /** Strip root appended to {@link AcUiSubToolbarMountOptions.host}. */
+    private root;
+    /** Child items last passed to the constructor or {@link refresh}. */
+    private items;
+    /** Whether command buttons are disabled. */
+    private commandsDisabled;
+    /** Whether {@link close} has already run. */
+    private closed;
+    /** Closes a dismissible strip when the user clicks outside. */
+    private handleDocumentClick;
+    /**
+     * @param options - Host, placement, items, and selection callback.
+     */
+    constructor(options: AcUiSubToolbarMountOptions);
+    /** Whether this strip ignores canvas / outside clicks. */
+    get sticky(): boolean;
+    /** Parent button that opened this strip. */
+    get anchor(): HTMLElement;
+    /** Strip root element (used when stacking nested strips). */
+    get rootElement(): HTMLDivElement;
+    /**
+     * Hides or shows the strip without destroying it (used when
+     * {@link AcUiSubToolbarOptions.replaceOnNested} replaces this strip with a
+     * nested one).
+     *
+     * @param hidden - When true, the strip is not visible and does not receive
+     *   pointer events.
+     */
+    setHidden(hidden: boolean): void;
+    /**
+     * Replaces child items and re-renders without closing the strip.
+     *
+     * @param items - Updated child items (e.g. after a toggle).
+     * @param commandsDisabled - Optional override for command disabled state.
+     */
+    refresh(items: AcUiToolbarItem[], commandsDisabled?: boolean): void;
+    /** Whether `target` lies inside this strip root. */
+    containsTarget(target: Node): boolean;
+    /** Updates button labels and tooltips after locale change. */
+    refreshLocale(): void;
+    /** Repositions the strip beside the parent toolbar after layout changes. */
+    syncPosition(): void;
+    /**
+     * Resolves left (horizontal strip) or top (vertical strip) from
+     * {@link AcUiSubToolbarPosition}.
+     */
+    private resolveMainAxisOffset;
+    /** Visible toolbar buttons used for front/end edge alignment. */
+    private queryVisibleButtons;
+    /** Detaches the strip and removes the outside-click listener. */
+    close(): void;
+    private syncRootClasses;
+    private applyChromeLayout;
+    /**
+     * Caps labeled button width slightly below height so icon+label buttons stay
+     * portrait-shaped and long captions ellipsize. Skipped when wrap-pack already
+     * assigned slot widths (full rows fill the strip evenly).
+     */
+    private applyLabeledButtonMaxWidth;
+    /**
+     * Stretch + wrap horizontal strips:
+     * - Full rows fill the strip evenly.
+     * - A short last row (when there are prior full rows) keeps that slot width
+     *   and stays left-aligned.
+     * - A single incomplete row stretches buttons across the full strip.
+     */
+    private applyWrapPackLayout;
+    private applyStretchSize;
+    private applyOverflowLayout;
+    private renderButtons;
+}
+//# sourceMappingURL=AcUiSubToolbar.d.ts.map

package/lib/ui/toolbar/AcUiSubToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcUiSubToolbar.d.ts","sourceRoot":"","sources":["../../../src/ui/toolbar/AcUiSubToolbar.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAUvE,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAEhB,sDAAsD;AACtD,MAAM,WAAW,0BAA0B;IACzC,uCAAuC;IACvC,IAAI,EAAE,eAAe,CAAA;IACrB,6BAA6B;IAC7B,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,8EAA8E;IAC9E,MAAM,EAAE,WAAW,CAAA;IACnB,uEAAuE;IACvE,WAAW,EAAE,WAAW,CAAA;IACxB,oEAAoE;IACpE,IAAI,EAAE,WAAW,CAAA;IACjB,qCAAqC;IACrC,SAAS,EAAE,oBAAoB,CAAA;IAC/B,0CAA0C;IAC1C,MAAM,EAAE,yBAAyB,CAAA;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAA;IACjC,iEAAiE;IACjE,iBAAiB,EAAE,MAAM;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACtD;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAA;IACf,+EAA+E;IAC/E,gBAAgB,EAAE,OAAO,CAAA;IACzB,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACpE,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,CAAA;CACpD;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAsBb,OAAO,CAAC,OAAO;IArB3B,sEAAsE;IACtE,OAAO,CAAC,IAAI,CAAgB;IAC5B,qEAAqE;IACrE,OAAO,CAAC,KAAK,CAAmB;IAChC,4CAA4C;IAC5C,OAAO,CAAC,gBAAgB,CAAS;IACjC,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAQ;IACtB,+DAA+D;IAC/D,OAAO,CAAC,mBAAmB,CAO1B;IAED;;OAEG;gBACiB,OAAO,EAAE,0BAA0B;IAsBvD,0DAA0D;IAC1D,IAAI,MAAM,YAET;IAED,4CAA4C;IAC5C,IAAI,MAAM,gBAET;IAED,6DAA6D;IAC7D,IAAI,WAAW,mBAEd;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO;IAMzB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,gBAAgB,CAAC,EAAE,OAAO;IAU5D,oDAAoD;IACpD,cAAc,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO;IAIrC,8DAA8D;IAC9D,aAAa;IAuBb,4EAA4E;IAC5E,YAAY;IA4GZ;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAmE7B,iEAAiE;IACjE,OAAO,CAAC,mBAAmB;IAM3B,iEAAiE;IACjE,KAAK;IAQL,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,iBAAiB;IAOzB;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAiBlC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAuE3B,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,aAAa;CA2EtB"}