@jax-data-science/sci-image-visualizer 0.5.0 → 0.6.0

package/lib/contracts/display-types.d.ts

@@ -38,6 +38,16 @@ export interface IWandOptions {
 export interface IBrushOptions {
     /** Brush diameter in matrix (image) pixels. */
     size?: number;
+    /**
+     * Paint as one class: new regions take this label, and a stroke only extends
+     * or merges regions with the same label. Unset = the plain brush (label
+     * `'Region'`, extends any region). `setBrushMode(true, …)` sets the class in
+     * full; `setBrushOptions` changes it only when `label` or `color` is passed,
+     * so a size-only update keeps it.
+     */
+    label?: string;
+    /** Colour for the painted regions instead of the shape colour. Kept against preset re-apply. */
+    color?: string;
 }
 /** What drives point colour in the spatial-omics mode: an annotation column
  *  from the dataset, or one feature (gene) vector fetched on demand. */

package/lib/contracts/plot-type-contribution.contract.d.ts

@@ -103,6 +103,31 @@ export interface PlotModeViewport {
      *  A new subscriber first receives the current rect when the viewport is ready. */
     settled$: Observable<PlotModeRect>;
 }
+/** The class a {@link PlotModeTools.armBrush} stroke paints. */
+export interface PlotModeBrushClass {
+    /** Label for the painted regions; the stroke only extends or merges regions with it. */
+    label?: string;
+    /** Colour for the painted regions (instead of the toolbar's shape colour). */
+    color?: string;
+}
+/**
+ * The visualizer's own toolbar tools, armed on a mode's behalf. Going through
+ * this rather than {@link IVisualizer} keeps the toolbar in step: the armed
+ * tool's button is highlighted and its controls (e.g. the brush size) show.
+ */
+export interface PlotModeTools {
+    /**
+     * Arm the toolbar brush, painting `brushClass`. Calling it again while the
+     * brush is armed switches class; the next stroke starts a region of it.
+     * The user picking any tool from the toolbar (including the brush) replaces
+     * this with the plain tool.
+     */
+    armBrush(brushClass?: PlotModeBrushClass): void;
+    /** Disarm whatever tool is armed, as if the user toggled it off. */
+    disarm(): void;
+    /** The armed toolbar tool id ('brush', 'pan', … or null). Replays the current value. */
+    activeTool$: Observable<string | null>;
+}
 /** Everything a contributed mode gets to work with while it is active. */
 export interface PlotModeContext {
     /** Full public visualizer API: regions, region overlay (tool modes), undo, etc. */
@@ -110,6 +135,8 @@ export interface PlotModeContext {
     viewport: PlotModeViewport;
     /** Current image info from IMAGE_STATE_PORT (null until an image is loaded). */
     imageInfo$: Observable<IImageInfo | null>;
+    /** Toolbar tools (since 0.6.0). Optional so a context built for 0.5.0 still type-checks. */
+    tools?: PlotModeTools;
 }
 /** A live activation of a contributed mode. */
 export interface PlotModeSession {

package/lib/contracts/toolbar-tool.contract.d.ts

@@ -35,6 +35,17 @@
  * than an escape hatch that returns a component — the moment one tool draws
  * itself, the toolbar stops being able to lay tools out consistently.
  *
+ * DIALOG TOOLS
+ * Some tools are not "set parameters, run once" but an interactive session: the
+ * user paints, the tool retrains and redraws, over and over (DIANNE). A schema
+ * cannot describe that, so {@link ToolbarDialogToolContribution} is the one
+ * variant that renders its own body. The toolbar still owns the button, its
+ * placement and the dialog chrome; the tool only fills the dialog, with plain
+ * DOM (`mount`), so it needs neither Angular nor this library's PrimeNG version.
+ * Its button sits with the host's own actions at the start of the toolbar, and
+ * shows only in the Image view, the view its context ({@link ToolDialogContext})
+ * draws over.
+ *
  * WHY AN EMPTY MODEL LIST HIDES THE TOOL
  * {@link ToolbarToolContribution.models} returning `[]` removes the tool from
  * the toolbar entirely. This preserves the behaviour the built-in tools already
@@ -45,6 +56,7 @@
 import { InjectionToken } from '@angular/core';
 import type { Observable } from 'rxjs';
 import type { IVisualizer } from './visualizer.contract';
+import type { PlotModeContext, PlotModeSession, PlotModeTools } from './plot-type-contribution.contract';
 /** A number field. Rendered as a stepper, matching the built-in dialogs. */
 export interface NumberParamSpec {
     id: string;
@@ -177,14 +189,81 @@ export interface ToolbarToolContribution {
     run(viz: IVisualizer, params: Record<string, unknown>): Promise<number>;
 }
 /**
- * Multi-provider token for contributed tools.
+ * What a dialog tool gets while its dialog is open: the same surface a
+ * contributed plot mode gets (the public visualizer, the Image view's viewport
+ * and the current image), with the toolbar tools always present.
+ */
+export type ToolDialogContext = PlotModeContext & {
+    tools: PlotModeTools;
+};
+/** A live dialog-tool session. `deactivate()` runs exactly once, after the body's teardown. */
+export type ToolDialogSession = PlotModeSession;
+/**
+ * A toolbar tool that opens a dialog instead of running once (see DIALOG TOOLS
+ * above). Clicking its button opens the dialog and starts a session; clicking it
+ * again, or closing the dialog, ends it.
+ *
+ * The session is bound to the Image view on screen. When that view is re-rendered
+ * (another image, another slice) the session ends and, with the dialog still
+ * open, a fresh one starts once the new view is ready. Leaving the Image view
+ * closes the dialog. As with plot modes, nothing the tool throws or rejects
+ * escapes: a failed start closes the dialog with a warning.
+ */
+export interface ToolbarDialogToolContribution {
+    kind: 'dialog';
+    /** Stable identity. Must not clash with another toolbar tool. */
+    id: string;
+    /** Short name; the dialog title unless `dialog.title` is set. */
+    label: string;
+    icon: ToolIcon;
+    /** Tooltip on the button. */
+    tooltip: string;
+    /** Order among the dialog tools. Lower sorts first; ties keep registration order. */
+    order?: number;
+    dialog?: {
+        title?: string;
+        /** CSS width of the dialog. Default `'22rem'`. */
+        width?: string;
+    };
+    /** Entry for the help dialog's tool list, rendered as HTML (trusted content). */
+    help?: {
+        body: string;
+    };
+    /** Start a session, once the Image view's viewport is ready. */
+    activate(ctx: ToolDialogContext): ToolDialogSession | Promise<ToolDialogSession>;
+    /**
+     * Render the dialog body into `host`; return its teardown (called before
+     * `deactivate()`). Called after `activate` resolves, once the dialog has rendered and
+     * `host` is in the document, so the body can measure itself.
+     */
+    mount(host: HTMLElement, ctx: ToolDialogContext, session: ToolDialogSession): () => void;
+}
+/** Anything provided on {@link TOOLBAR_TOOLS}. A run tool has no `kind`. */
+export type ToolbarContribution = ToolbarToolContribution | ToolbarDialogToolContribution;
+/** Whether a contribution is a {@link ToolbarDialogToolContribution}. */
+export declare function isDialogToolContribution(c: unknown): c is ToolbarDialogToolContribution;
+/**
+ * Multi-provider token for contributed tools: run tools
+ * ({@link ToolbarToolContribution}) and, since 0.6.0, dialog tools
+ * ({@link ToolbarDialogToolContribution}).
  *
  * Deliberately has no `factory`: unregistered means no tools, which is what
  * makes this library shippable without the closed model packages. Inject it
  * `{ optional: true }` and treat null as empty.
  */
-export declare const TOOLBAR_TOOLS: InjectionToken<readonly ToolbarToolContribution[]>;
+export declare const TOOLBAR_TOOLS: InjectionToken<readonly ToolbarContribution[]>;
 /** Sort contributed tools into display order. */
-export declare function sortToolContributions(tools: readonly ToolbarToolContribution[]): ToolbarToolContribution[];
-/** The tools a toolbar should actually show: those with at least one model. */
-export declare function visibleToolContributions(tools: readonly ToolbarToolContribution[] | null | undefined): ToolbarToolContribution[];
+export declare function sortToolContributions<T extends {
+    order?: number;
+}>(tools: readonly T[]): T[];
+/** The run tools a toolbar should actually show: those with at least one model.
+ *  Dialog tools are left out (see {@link dialogToolContributions}). */
+export declare function visibleToolContributions(tools: readonly ToolbarContribution[] | null | undefined): ToolbarToolContribution[];
+/**
+ * The dialog tools, in display order. A malformed one (no string `id`, no
+ * `activate` or `mount` function) or a repeated `id` is dropped with a warning
+ * rather than breaking the toolbar.
+ */
+export declare function dialogToolContributions(tools: readonly ToolbarContribution[] | null | undefined, log?: {
+    warn(...args: unknown[]): void;
+}): ToolbarDialogToolContribution[];

package/lib/toolbar/brush/brush-tool.service.d.ts

@@ -4,6 +4,15 @@ import * as i0 from "@angular/core";
 /** Brush parameters. `size` is the brush *diameter* in matrix (image) pixels. */
 export interface BrushOptions {
     size?: number;
+    /**
+     * Paint as one class. With `label` set, new regions take this label, and the
+     * stroke only adopts or merges regions that already have it, so painting one
+     * class never grows another class's region. `color` colours the painted
+     * regions instead of the toolbar's shape colour. Leave both unset for the
+     * plain toolbar brush.
+     */
+    label?: string;
+    color?: string;
 }
 /**
  * The brush host is identical to the wand's — both need the cached-image
@@ -60,6 +69,8 @@ export declare class BrushToolService {
     private lastMatrix;
     private dragging;
     private size;
+    /** The class being painted ({@link BrushOptions.label} / `color`); null = plain brush. */
+    private paintClass;
     private readonly boundMouseDown;
     private readonly boundMouseMove;
     private readonly boundMouseUp;
@@ -68,6 +79,13 @@ export declare class BrushToolService {
     bindHost(host: BrushToolHost): void;
     /** Toggle the brush on/off. */
     setMode(active: boolean, options?: BrushOptions): void;
+    /**
+     * Update size and/or class while armed. The class changes only when `label`
+     * or `color` is passed (as a key, even `undefined`), so a size-only update
+     * keeps it. Switching class drops the active region, so the next stroke
+     * starts a region of the new class.
+     */
+    setOptions(options?: BrushOptions): void;
     /** Live-update the brush size (matrix-pixel diameter). */
     setSize(size: number): void;
     /** Drop the active brush region so the next stroke starts a new one. */
@@ -102,6 +120,9 @@ export declare class BrushToolService {
      * erase stroke deletes every pixel.
      */
     private dropActiveShape;
+    /** Whether the stroke may adopt or merge `region`: always for the plain brush,
+     *  otherwise only a region of the class being painted. */
+    private paintsInto;
     /** A region's closed-polygon vertices (image/data coords), or null when it
      *  isn't a fillable closed polygon (rectangles, open polylines). */
     private regionVerts;

package/lib/toolbar/toolbar.component.d.ts

@@ -3,7 +3,7 @@ import { MenuItem } from 'primeng/api';
 import { IImageInfo } from '../contracts/image.contract';
 import { PlotType, PlotTypeId } from '../contracts/plot-type';
 import { ToolbarToolVisibility } from '../contracts/toolbar-config';
-import { ToolbarToolContribution } from '../contracts/toolbar-tool.contract';
+import { ToolbarDialogToolContribution, ToolbarToolContribution } from '../contracts/toolbar-tool.contract';
 import { PlotTypeOption } from '../contracts/plot-type-contribution.contract';
 import * as i0 from "@angular/core";
 /**
@@ -90,6 +90,10 @@ export declare class ToolbarComponent implements OnChanges {
      * per-tool parameter state; this component only draws them.
      */
     contributedTools: ToolbarToolContribution[];
+    /** Dialog tools (TOOLBAR_TOOLS, kind: 'dialog'), sorted; shown in the Image view. */
+    dialogTools: ToolbarDialogToolContribution[];
+    /** Id of the dialog tool whose dialog is open, or null. */
+    openDialogToolId: string | null;
     /** Active checkpoint per contributed tool, keyed by tool id. */
     toolModelIds: Record<string, string>;
     selectPlotType: EventEmitter<string>;
@@ -135,6 +139,8 @@ export declare class ToolbarComponent implements OnChanges {
     segmentCellpose: EventEmitter<void>;
     /** Run a contributed tool over the current view, by tool id. */
     runTool: EventEmitter<string>;
+    /** A dialog tool's button was clicked: open its dialog, or close it if open. */
+    toggleDialogTool: EventEmitter<string>;
     /** Pick a contributed tool's checkpoint. */
     toolModelChange: EventEmitter<{
         toolId: string;
@@ -205,7 +211,9 @@ export declare class ToolbarComponent implements OnChanges {
     get contributedToolNames(): string;
     /** Keeps each contributed tool's `p-menu` overlay alive across CD ticks —
      *  re-creating it mid-interaction swallows the click on a menu item. */
-    trackToolById(_index: number, tool: ToolbarToolContribution): string;
+    trackToolById(_index: number, tool: {
+        id: string;
+    }): string;
     /** The built-in type whose tools and controls apply to the current selection. */
     get effectivePlotType(): PlotType;
     /** The Image plot type renders as a natively pan/zoom-able raster, so the
@@ -242,5 +250,5 @@ export declare class ToolbarComponent implements OnChanges {
     get isIntensityCapable(): boolean;
     showHelp(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ToolbarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ToolbarComponent, "plotting-toolbar", never, { "imageInfo": { "alias": "imageInfo"; "required": false; }; "plotTypeOptions": { "alias": "plotTypeOptions"; "required": false; }; "selectedPlotType": { "alias": "selectedPlotType"; "required": false; }; "basePlotType": { "alias": "basePlotType"; "required": false; }; "isoRange": { "alias": "isoRange"; "required": false; }; "maxIndex": { "alias": "maxIndex"; "required": false; }; "zIndex": { "alias": "zIndex"; "required": false; }; "isHeatmap": { "alias": "isHeatmap"; "required": false; }; "is3dRegions": { "alias": "is3dRegions"; "required": false; }; "activeDragMode": { "alias": "activeDragMode"; "required": false; }; "activeSurface3dMode": { "alias": "activeSurface3dMode"; "required": false; }; "axesVisible": { "alias": "axesVisible"; "required": false; }; "wireframeActive": { "alias": "wireframeActive"; "required": false; }; "resolutionScale": { "alias": "resolutionScale"; "required": false; }; "wandSensitivity": { "alias": "wandSensitivity"; "required": false; }; "brushSize": { "alias": "brushSize"; "required": false; }; "vertexEraserRadius": { "alias": "vertexEraserRadius"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; "stackOptions": { "alias": "stackOptions"; "required": false; }; "tools": { "alias": "tools"; "required": false; }; "imageSmoothingEnabled": { "alias": "imageSmoothingEnabled"; "required": false; }; "samModels": { "alias": "samModels"; "required": false; }; "samModelId": { "alias": "samModelId"; "required": false; }; "contributedTools": { "alias": "contributedTools"; "required": false; }; "toolModelIds": { "alias": "toolModelIds"; "required": false; }; }, { "selectPlotType": "selectPlotType"; "addProfileLine": "addProfileLine"; "toggleImageSmoothing": "toggleImageSmoothing"; "isoRangeChange": "isoRangeChange"; "openChannelHistogram": "openChannelHistogram"; "openSpatialControls": "openSpatialControls"; "openRegionEditor": "openRegionEditor"; "selectStackOption": "selectStackOption"; "zScrub": "zScrub"; "zSlide": "zSlide"; "zIndexInput": "zIndexInput"; "reloadAndPlot": "reloadAndPlot"; "downloadImage": "downloadImage"; "autoscaleImage": "autoscaleImage"; "toggleDragMode": "toggleDragMode"; "zoomIn": "zoomIn"; "zoomOut": "zoomOut"; "toggleSurface3dMode": "toggleSurface3dMode"; "resetSurfaceCamera": "resetSurfaceCamera"; "toggleAxes": "toggleAxes"; "toggleWireframe": "toggleWireframe"; "selectResolution": "selectResolution"; "deleteRegion": "deleteRegion"; "undoRegion": "undoRegion"; "redoRegion": "redoRegion"; "segmentRegions": "segmentRegions"; "segmentCellpose": "segmentCellpose"; "runTool": "runTool"; "toolModelChange": "toolModelChange"; "openToolParams": "openToolParams"; "samModelChange": "samModelChange"; "wandSensitivityChange": "wandSensitivityChange"; "brushSizeChange": "brushSizeChange"; "vertexEraserRadiusChange": "vertexEraserRadiusChange"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToolbarComponent, "plotting-toolbar", never, { "imageInfo": { "alias": "imageInfo"; "required": false; }; "plotTypeOptions": { "alias": "plotTypeOptions"; "required": false; }; "selectedPlotType": { "alias": "selectedPlotType"; "required": false; }; "basePlotType": { "alias": "basePlotType"; "required": false; }; "isoRange": { "alias": "isoRange"; "required": false; }; "maxIndex": { "alias": "maxIndex"; "required": false; }; "zIndex": { "alias": "zIndex"; "required": false; }; "isHeatmap": { "alias": "isHeatmap"; "required": false; }; "is3dRegions": { "alias": "is3dRegions"; "required": false; }; "activeDragMode": { "alias": "activeDragMode"; "required": false; }; "activeSurface3dMode": { "alias": "activeSurface3dMode"; "required": false; }; "axesVisible": { "alias": "axesVisible"; "required": false; }; "wireframeActive": { "alias": "wireframeActive"; "required": false; }; "resolutionScale": { "alias": "resolutionScale"; "required": false; }; "wandSensitivity": { "alias": "wandSensitivity"; "required": false; }; "brushSize": { "alias": "brushSize"; "required": false; }; "vertexEraserRadius": { "alias": "vertexEraserRadius"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; "stackOptions": { "alias": "stackOptions"; "required": false; }; "tools": { "alias": "tools"; "required": false; }; "imageSmoothingEnabled": { "alias": "imageSmoothingEnabled"; "required": false; }; "samModels": { "alias": "samModels"; "required": false; }; "samModelId": { "alias": "samModelId"; "required": false; }; "contributedTools": { "alias": "contributedTools"; "required": false; }; "dialogTools": { "alias": "dialogTools"; "required": false; }; "openDialogToolId": { "alias": "openDialogToolId"; "required": false; }; "toolModelIds": { "alias": "toolModelIds"; "required": false; }; }, { "selectPlotType": "selectPlotType"; "addProfileLine": "addProfileLine"; "toggleImageSmoothing": "toggleImageSmoothing"; "isoRangeChange": "isoRangeChange"; "openChannelHistogram": "openChannelHistogram"; "openSpatialControls": "openSpatialControls"; "openRegionEditor": "openRegionEditor"; "selectStackOption": "selectStackOption"; "zScrub": "zScrub"; "zSlide": "zSlide"; "zIndexInput": "zIndexInput"; "reloadAndPlot": "reloadAndPlot"; "downloadImage": "downloadImage"; "autoscaleImage": "autoscaleImage"; "toggleDragMode": "toggleDragMode"; "zoomIn": "zoomIn"; "zoomOut": "zoomOut"; "toggleSurface3dMode": "toggleSurface3dMode"; "resetSurfaceCamera": "resetSurfaceCamera"; "toggleAxes": "toggleAxes"; "toggleWireframe": "toggleWireframe"; "selectResolution": "selectResolution"; "deleteRegion": "deleteRegion"; "undoRegion": "undoRegion"; "redoRegion": "redoRegion"; "segmentRegions": "segmentRegions"; "segmentCellpose": "segmentCellpose"; "runTool": "runTool"; "toggleDialogTool": "toggleDialogTool"; "toolModelChange": "toolModelChange"; "openToolParams": "openToolParams"; "samModelChange": "samModelChange"; "wandSensitivityChange": "wandSensitivityChange"; "brushSizeChange": "brushSizeChange"; "vertexEraserRadiusChange": "vertexEraserRadiusChange"; }, never, ["*"], false, never>;
 }

package/lib/visualizer.component.d.ts

@@ -14,7 +14,7 @@ import { IVisualizer } from './contracts/visualizer.contract';
 import { SamToolService } from './toolbar/segmentation/sam-tool.service';
 import { SamPointToolService } from './toolbar/segmentation/sam-point-tool.service';
 import { CellSegmentToolService } from './toolbar/segmentation/cell-segment-tool.service';
-import { NumberParamSpec, SelectParamSpec, ToolParamSpec, ToolbarToolContribution } from './contracts/toolbar-tool.contract';
+import { NumberParamSpec, SelectParamSpec, ToolParamSpec, ToolbarContribution, ToolbarDialogToolContribution, ToolbarToolContribution } from './contracts/toolbar-tool.contract';
 import { ToolbarToolVisibility } from './contracts/toolbar-config';
 import { VizConfig } from './contracts/viz-config';
 import { SpatialDataPort } from './contracts/ports/spatial-data.port';
@@ -121,6 +121,8 @@ export declare class VisualizerComponent implements OnInit, OnChanges, AfterView
     wandSensitivity: number;
     /** Brush diameter in image-pixel coordinates (drives the painted disc size). */
     brushSize: number;
+    /** Class the brush paints while a plot mode armed it (PlotModeTools.armBrush); null = plain brush. */
+    private brushClass;
     /** SAM model picker options + current selection (jit-ui#90 P1). Only models
      *  with a hosted ONNX pair (configured via setSamModelUrls at app init) are
      *  offered, so the picker can't select a model that can't run. */
@@ -136,6 +138,22 @@ export declare class VisualizerComponent implements OnInit, OnChanges, AfterView
      * and help dialog simply omit that group.
      */
     contributedTools: ToolbarToolContribution[];
+    /**
+     * Dialog tools registered through {@link TOOLBAR_TOOLS} (`kind: 'dialog'`),
+     * sorted. Their buttons sit with the host's own actions and show in the Image
+     * view only; each opens a floating dialog the tool fills.
+     */
+    dialogTools: ToolbarDialogToolContribution[];
+    /** The dialog tool the user has open (its session may be between renders). */
+    openDialogToolId: string | null;
+    /** The open dialog tool's live dialog, as the template renders it. */
+    toolDialog: {
+        title: string;
+        width: string;
+        host: HTMLElement;
+    } | null;
+    /** Dialog-tool sessions: the same lifecycle and isolation as contributed plot modes. */
+    private readonly toolDialogs;
     /** Active checkpoint per contributed tool. */
     toolModelIds: Record<string, string>;
     /**
@@ -318,7 +336,7 @@ export declare class VisualizerComponent implements OnInit, OnChanges, AfterView
     private wheelListener?;
     /** Debounced z-slice scrubbing (see SliceScrubber — refactoring plan Step 7). */
     private readonly scrubber;
-    constructor(state: ImageStatePort, plotService: IVisualizer, messageService: MessageService, ngZone: NgZone, cdr: ChangeDetectorRef, session: VisualizerStore, samTool: SamToolService, cellSegmentTool: CellSegmentToolService, samPointTool: SamPointToolService, regionOps: RegionOpsService, vizConfig?: VizConfig | undefined, toolContributions?: readonly ToolbarToolContribution[], spatialData?: SpatialDataPort | undefined, plotTypeContributions?: readonly PlotTypeContribution[], injector?: Injector | undefined);
+    constructor(state: ImageStatePort, plotService: IVisualizer, messageService: MessageService, ngZone: NgZone, cdr: ChangeDetectorRef, session: VisualizerStore, samTool: SamToolService, cellSegmentTool: CellSegmentToolService, samPointTool: SamPointToolService, regionOps: RegionOpsService, vizConfig?: VizConfig | undefined, toolContributions?: readonly ToolbarContribution[], spatialData?: SpatialDataPort | undefined, plotTypeContributions?: readonly PlotTypeContribution[], injector?: Injector | undefined);
     /**
      * Plot types offered in the selector for the current image:
      *  - Outside **test mode**, only the curated default set (descriptors with a
@@ -454,6 +472,8 @@ export declare class VisualizerComponent implements OnInit, OnChanges, AfterView
     onToggleImageSmoothing(): void;
     resetAxes(): void;
     toggleDragMode(mode: string): void;
+    /** Arm `mode` (or nothing) across every tool, keeping the toolbar in step. */
+    private applyDragMode;
     /** Region draw/select/edit modes routed through the region overlay. The
      *  The vertex tools (drawpolygon/addpoint/deletepoint/move) are
      *  handled by the OpenSeadragon overlay; Plotly's overlay maps them to no-op. */
@@ -606,6 +626,38 @@ export declare class VisualizerComponent implements OnInit, OnChanges, AfterView
     private fallBackFromPlotMode;
     /** Run change detection; returns what it threw (logged), or null. */
     private detectChangesSafely;
+    /** The toolbar button: open the tool's dialog, or close it if it is open. */
+    toggleDialogTool(id: string): void;
+    /** Close the open dialog tool: its body is torn down, then its session ends. */
+    closeDialogTool(): void;
+    /** Start (or restart, after a re-render) the open dialog tool's session. */
+    private activateOpenDialogTool;
+    /** The live dialog body's teardown, and a pending wait for its host to connect. */
+    private toolDialogTeardown;
+    private toolDialogFrame;
+    /**
+     * The session is live: render the dialog, then mount the tool's body once the host
+     * element is in the document, so `mount()` can measure it and start widgets that need
+     * a connected element.
+     */
+    private showToolDialog;
+    /** How many animation frames to wait for the dialog to attach the body's host. */
+    private static readonly TOOL_DIALOG_ATTACH_FRAMES;
+    /**
+     * Mount `tool`'s body into `host` once it is connected (the dialog may attach it a
+     * frame later, when it moves itself to `<body>`). If it never connects within
+     * {@link TOOL_DIALOG_ATTACH_FRAMES} it is mounted anyway, with a warning, rather than
+     * leaving an empty dialog. A throwing `mount()` fails the session like a failed start.
+     */
+    private mountToolDialogBody;
+    /** The session is about to end: tear the body down first, then drop the dialog. */
+    private hideToolDialog;
+    /** A dialog tool could not start: close it and say so. */
+    private dialogToolFailed;
+    /** Where the open dialog tool's host element is attached once its dialog renders. */
+    set toolDialogSlot(ref: ElementRef<HTMLElement> | undefined);
+    /** Toolbar tools for contributed modes. Calls can come from outside Angular, hence the zone. */
+    private readonly plotModeTools;
     /** Deactivate whatever tool is armed and clear every tool mode. */
     private deactivateActiveTool;
     static ɵfac: i0.ɵɵFactoryDeclaration<VisualizerComponent, [null, null, null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jax-data-science/sci-image-visualizer",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "engines": {
     "node": ">=20.9.0"
   },