@jax-data-science/sci-image-visualizer 0.8.3 → 0.10.0

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

@@ -1,5 +1,4 @@
-import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
-import { MenuItem } from 'primeng/api';
+import { EventEmitter } from '@angular/core';
 import { IImageInfo } from '../contracts/image.contract';
 import { PlotType, PlotTypeId } from '../contracts/plot-type';
 import { ToolbarToolVisibility } from '../contracts/toolbar-config';
@@ -18,13 +17,13 @@ import * as i0 from "@angular/core";
  * diagram's right-click context menu and keyboard shortcuts, so keeping the
  * handlers in the host avoids duplicating that logic.
  */
-export declare class ToolbarComponent implements OnChanges {
+export declare class ToolbarComponent {
     /** Current image (gates which control groups are shown). */
     imageInfo: IImageInfo | undefined;
     /** A spatial dataset is on offer: its plot modes are a choice even with no image loaded. */
     hasSpatialDataset: boolean;
     /** Whether the plot-type dropdown shows: for an image, or a spatial dataset with none. */
-    get showPlotTypes(): boolean;
+    protected get showPlotTypes(): boolean;
     /** Plot types the active backend advertises, then any contributed modes. */
     plotTypeOptions: PlotTypeOption[];
     /** The selector's value: a built-in type or a contributed mode's id. */
@@ -40,7 +39,9 @@ export declare class ToolbarComponent implements OnChanges {
     /** Isosurface band as a 0–255 slider position (mapped onto the volume's real
      *  intensity range by the renderer). Defaults to the full range. */
     isoRange: number[];
+    /** The last slice index of a stack. */
     maxIndex: number;
+    /** The current slice (0-based). */
     zIndex: number;
     /** True for any 2D (non Surface-3D) plot type. */
     isHeatmap: boolean;
@@ -51,20 +52,25 @@ export declare class ToolbarComponent implements OnChanges {
      * controls — flipping that would show 2D pan/zoom and hide the orbit controls.
      */
     is3dRegions: boolean;
+    /** A napari volume / isosurface view: the Region Editor (regions in 3D) without drawing tools. */
+    isVolumeView: boolean;
+    /** Whether the volume view is split with the slice editor (the slice, with every region tool). */
+    sliceEditor: boolean;
+    /** The armed tool's mode (zoom, pan, a drawing tool, `samPoint`, …), or null. */
     activeDragMode: string | null;
+    /** The 3D camera mode (`turntable` / `orbit` / …). */
     activeSurface3dMode: string;
     /** Whether the napari 3D axes/scale gizmo is currently shown (drives the toggle's look). */
     axesVisible: boolean;
+    /** The napari surface wireframe is on. */
     wireframeActive: boolean;
     /** Active napari 3D decimate factor (1 = Full … 8 = ⅛; default ½). */
     resolutionScale: number;
-    /** Decimate-factor options for the Resolution dropdown. */
-    readonly decimateOptions: {
-        label: string;
-        value: number;
-    }[];
+    /** Magic-wand sensitivity. */
     wandSensitivity: number;
+    /** Brush diameter in image pixels. */
     brushSize: number;
+    /** Vertex-eraser radius in image pixels. */
     vertexEraserRadius: number;
     /** Whether a region action is available to undo (jit-ui#85). Greys out the
      *  Undo button when false (nothing done yet, or all steps already undone). */
@@ -72,6 +78,7 @@ export declare class ToolbarComponent implements OnChanges {
     /** Whether an undone region action is available to redo (jit-ui#85). Greys
      *  out the Redo button when false. */
     canRedo: boolean;
+    /** The single-image / stack choices of the Plotly stack toggle. */
     stackOptions: {
         name: string;
         val: string;
@@ -87,6 +94,7 @@ export declare class ToolbarComponent implements OnChanges {
         id: string;
         label: string;
     }[];
+    /** The selected SAM model id. */
     samModelId: string;
     /**
      * Tools contributed through {@link TOOLBAR_TOOLS}, already filtered to the
@@ -100,31 +108,48 @@ export declare class ToolbarComponent implements OnChanges {
     openDialogToolId: string | null;
     /** Active checkpoint per contributed tool, keyed by tool id. */
     toolModelIds: Record<string, string>;
+    /** A plot type or contributed mode was picked. */
     selectPlotType: EventEmitter<string>;
     /** Intensity (LINE) mode: add another colored line ROI + inset trace. */
     addProfileLine: EventEmitter<void>;
     /** Toggle image smoothing (bilinear) vs nearest-neighbour (crisp pixels). */
     toggleImageSmoothing: EventEmitter<void>;
+    /** The isosurface band slider moved: the new `[low, high]` pair. */
     isoRangeChange: EventEmitter<number[] | undefined>;
     /** Open the Channels & Histogram dialog (brightness/contrast, colormap, …). */
     openChannelHistogram: EventEmitter<void>;
     /** Open the spatial-omics controls (colour-by, legend, point display). */
     openSpatialControls: EventEmitter<void>;
+    /** Open the Region Editor dialog. */
     openRegionEditor: EventEmitter<void>;
+    /** Split the volume view with the slice editor, or close it. */
+    toggleSliceEditor: EventEmitter<void>;
+    /** A single-image / stack choice was picked. */
     selectStackOption: EventEmitter<{
         name: string;
         val: string;
     }>;
+    /** The live slice scrubber moved (fires while dragging). */
     zScrub: EventEmitter<number | undefined>;
+    /** The live slice scrubber was released on a slice. */
     zSlide: EventEmitter<number | undefined>;
+    /** A slice number was typed. */
     zIndexInput: EventEmitter<number>;
+    /** Re-plot at the typed slice. */
     reloadAndPlot: EventEmitter<void>;
+    /** Download the current view as PNG. */
     downloadImage: EventEmitter<void>;
+    /** Fit the image to the view. */
     autoscaleImage: EventEmitter<void>;
+    /** A zoom / pan / drawing tool button was clicked (its mode). */
     toggleDragMode: EventEmitter<string>;
+    /** Zoom in one step. */
     zoomIn: EventEmitter<void>;
+    /** Zoom out one step. */
     zoomOut: EventEmitter<void>;
+    /** A 3D camera mode button was clicked (its mode). */
     toggleSurface3dMode: EventEmitter<string>;
+    /** Reset the 3D camera. */
     resetSurfaceCamera: EventEmitter<void>;
     /** Toggle the napari 3D coordinate-axes / scale gizmo on/off. */
     toggleAxes: EventEmitter<void>;
@@ -132,6 +157,7 @@ export declare class ToolbarComponent implements OnChanges {
     toggleWireframe: EventEmitter<void>;
     /** Change the napari 3D decimate factor (reloads at the new resolution). */
     selectResolution: EventEmitter<number>;
+    /** Delete the selected region. */
     deleteRegion: EventEmitter<void>;
     /** Undo the last region action (jit-ui#85). */
     undoRegion: EventEmitter<void>;
@@ -154,105 +180,50 @@ export declare class ToolbarComponent implements OnChanges {
     openToolParams: EventEmitter<string>;
     /** SAM model picker (jit-ui#90 P1). */
     samModelChange: EventEmitter<string>;
+    /** The wand sensitivity slider moved. */
     wandSensitivityChange: EventEmitter<number | undefined>;
+    /** The brush size slider moved. */
     brushSizeChange: EventEmitter<number | undefined>;
+    /** The vertex-eraser radius slider moved. */
     vertexEraserRadiusChange: EventEmitter<number | undefined>;
-    /** Sliders' bounds — toolbar UI constants (the values are host-owned). */
-    readonly wandSensitivityMin = 0.5;
-    readonly wandSensitivityMax = 10;
-    readonly wandSensitivityStep = 0.1;
-    readonly brushSizeMin = 5;
-    readonly brushSizeMax = 300;
-    readonly brushSizeStep = 5;
-    readonly vertexEraserRadiusMin = 5;
-    readonly vertexEraserRadiusMax = 300;
-    readonly vertexEraserRadiusStep = 5;
-    readonly isoValueMin = 0;
-    readonly isoValueMax = 255;
-    readonly isoValueStep = 1;
-    displayHelpDialog: boolean;
-    /** Model picker for the Segment button's dropdown menu. The active model
-     *  (`samModelId`) is marked with a check; selecting an item emits
-     *  `samModelChange` (jit-ui#90 P1).
-     *
-     *  Held as a stable array (rebuilt only when `samModels`/`samModelId` change),
-     *  NOT a getter: a getter returns a fresh array with new `command` closures on
-     *  every change-detection tick, which makes the bound `p-menu` overlay rebuild
-     *  its DOM mid-interaction and swallow the click on a menu item.
-     *
-     *  `tooltip` carries the model's description from {@link MODEL_INFO}; the
-     *  menus' shared item template turns it into the hover info icon. p-menu's own
-     *  rendering ignores the field (it reads `item.title`), so it is free to use. */
-    samMenuItems: MenuItem[];
-    /**
-     * Model menus for the contributed tools, keyed by tool id. Same stable-array
-     * reasoning as {@link samMenuItems} — and it is why this is a map rebuilt in
-     * `ngOnChanges` rather than a method called from the template, which would
-     * hand `p-menu` a new array every tick.
-     *
-     * A contributed tool supplies its own per-model description, so unlike the
-     * SAM menu these do not consult {@link MODEL_INFO}: this library has no
-     * copy for checkpoints it does not know about.
-     */
-    toolMenuItems: Record<string, MenuItem[]>;
-    /** Rebuild the SAM model menu when the model list or active selection
-     *  changes (keeps the array reference stable across other CD ticks). */
-    ngOnChanges(changes: SimpleChanges): void;
-    /**
-     * Strip markup from a model description so it can be read aloud.
-     *
-     * The copy in MODEL_INFO and in a contribution's `ToolModelOption.info` is
-     * written for a visual tooltip rendered with `[escape]="false"`, so it carries
-     * `<b>` and `<br>`. Passed to `aria-label` verbatim a screen reader announces
-     * the tags, so they are removed and `<br>` becomes a sentence break. Entities
-     * used in that copy (`&nbsp;`, `&times;`, `&amp;`) are decoded for the same
-     * reason.
-     */
-    plainText(html: string): string;
-    /** Contributed tool names for the help dialog's prompted/no-prompt contrast,
-     *  e.g. "YOLO, Retinal layers". Empty when nothing is registered, which is
-     *  why the sentence that uses it is itself conditional. */
-    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: {
+    protected displayHelpDialog: boolean;
+    /** trackBy for the dialog tools' buttons. */
+    protected trackToolById(_index: number, tool: {
         id: string;
     }): string;
     /** The built-in type whose tools and controls apply to the current selection. */
-    get effectivePlotType(): PlotType;
+    protected get effectivePlotType(): PlotType;
     /** The Image plot type renders as a natively pan/zoom-able raster, so the
      *  generic zoom/pan tools are hidden. */
-    get isImageView(): boolean;
+    protected get isImageView(): boolean;
     /** Either spatial-omics mode is active, so its controls are worth offering.
      *  The 3D cloud needs the panel MORE than the 2D view does, not less: colouring,
      *  the legend and category show/hide are the only way to make sense of a
      *  million overlapping points. */
-    get isSpatialMode(): boolean;
-    /** A plot-type icon is a PrimeNG font glyph (e.g. `pi pi-image`) rather than an
-     *  SVG asset path — drives which element the selector item template renders. */
-    isPiIcon(icon: string | undefined): boolean;
+    protected get isSpatialMode(): boolean;
     /** Backends with a vertex-editing region overlay: OSD Image and napari-js WebGPU image
      *  (jit-ui#102). Gates the polygon / add-vertex / delete-vertex / Bézier-convert tools. */
-    get supportsRegionVertexTools(): boolean;
+    protected get supportsRegionVertexTools(): boolean;
     /** Plot types that scrub a z-stack live (the renderer swaps the slice in place): the OSD Image
      *  view, the napari-js WebGPU image, the napari-js surface — which rebuilds the height field
      *  from the picked slice (jit-ui#102) — and the 2D spatial-omics view, where a 3D dataset's
      *  registered volume is the image and the slider picks the section whose observations are
-     *  drawn. Drives the per-slice slider. */
-    get showsLiveSliceScrubber(): boolean;
+     *  drawn. Also a split volume view, whose slice editor shows the slice picked. Drives the
+     *  per-slice slider. */
+    protected get showsLiveSliceScrubber(): boolean;
     /** Any napari-js WebGPU plot type. The single-image/stack toggle + slice-number field are
      *  Plotly-only stack controls, so they're hidden for napari (jit-ui#102). */
-    get isNapariMode(): boolean;
+    protected get isNapariMode(): boolean;
     /** ISOSURFACE (Plotly or napari-js WebGPU, either resolution) shows the isovalue range slider. */
-    get isIsosurfaceMode(): boolean;
+    protected get isIsosurfaceMode(): boolean;
     /** The napari-js WebGPU surface — shows the wireframe toggle. */
-    get isNapariSurfaceMode(): boolean;
+    protected get isNapariSurfaceMode(): boolean;
     /** Any napari-js WebGPU 3D type (volume/isosurface/surface) — shows the Resolution control. */
-    get isNapari3dMode(): boolean;
+    protected get isNapari3dMode(): boolean;
     /** Intensity profile lines are Region-based and available in the Heatmap and
      *  Image plot types, which show the Intensity tool group. */
-    get isIntensityCapable(): boolean;
-    showHelp(): void;
+    protected get isIntensityCapable(): boolean;
+    protected showHelp(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ToolbarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ToolbarComponent, "plotting-toolbar", never, { "imageInfo": { "alias": "imageInfo"; "required": false; }; "hasSpatialDataset": { "alias": "hasSpatialDataset"; "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>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToolbarComponent, "plotting-toolbar", never, { "imageInfo": { "alias": "imageInfo"; "required": false; }; "hasSpatialDataset": { "alias": "hasSpatialDataset"; "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; }; "isVolumeView": { "alias": "isVolumeView"; "required": false; }; "sliceEditor": { "alias": "sliceEditor"; "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"; "toggleSliceEditor": "toggleSliceEditor"; "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, ["*"], true, never>;
 }

package/lib/toolbar/vertex-eraser/vertex-eraser-tool.service.d.ts

@@ -1,64 +1,57 @@
-import { WandService } from '../wand/wand.service';
-import { IViewportHost, IRegionDataHost } from '../../contracts/coordinate-transform.contract';
-import * as i0 from "@angular/core";
+import { IVertexEraserOptions } from '../../contracts/display-types';
+import { UndoGestureTarget } from '../tool-kit/undo-gesture';
+import { CanvasToolHost, ICanvasTool } from '../tool-kit/canvas-tool';
 /**
- * Collaboration interface the vertex eraser needs from its host backend.
- *
- * Extends {@link IViewportHost} for coordinate conversion + overlay attachment,
- * so the eraser is backend-agnostic (Plotly and OpenSeadragon both satisfy it).
+ * @deprecated One host serves every canvas tool: use {@link CanvasToolHost}.
+ * The eraser converts with its readback's per-axis ratios
+ * (`getCachedImageData().ratios`, RT-14); `getCachedImageRatio()` is gone.
  */
-export interface VertexEraserToolHost extends IViewportHost, IRegionDataHost {
-    /**
-     * Drop the wand's in-progress stroke. Called after the eraser modifies
-     * regions — the wand's accumulator may now reference stale vertices.
-     */
-    invalidateWandRegion(): void;
-    /**
-     * Data-coords-per-image-pixel ratio (== cachedImageRatios[0] || 1). Used to
-     * convert between matrix coordinates (the eraser's native space) and the
-     * backend's data coordinates.
-     */
-    getCachedImageRatio(): number;
-}
+export type VertexEraserToolHost = CanvasToolHost;
 /**
  * Vertex eraser. A custom canvas overlay that, on click/drag, removes any
  * polygon vertex within `radius` matrix-pixels of the cursor from every
- * `type: 'path'` shape on the plot. Polygons that fall below 3 vertices
- * (or polylines below 2) are removed entirely.
+ * annotation polygon/polyline (never an intensity-profile line). The outline is
+ * rejoined where it crosses the eraser's edge, so erasing a corner of a sparse
+ * outline (a traced box is four vertices) trims that corner instead of cutting
+ * to the next corners; a Bezier region's anchors are dropped outright. Polygons
+ * that fall below 3 vertices (or polylines below 2) are removed entirely.
  *
  * The cursor is rendered as a dashed-red circle on the overlay so the user
  * can see the active radius while moving.
  */
-export declare class VertexEraserToolService {
-    private wandService;
+export declare class VertexEraserTool implements ICanvasTool<IVertexEraserOptions> {
+    readonly id = "eraseVertex";
     private host;
-    private overlay;
+    private readonly overlay;
     private dragging;
     /** Eraser radius in image-pixel (matrix) coordinates. */
     private radius;
     private cursor;
-    private readonly boundMouseDown;
-    private readonly boundMouseMove;
-    private readonly boundMouseUp;
-    constructor(wandService: WandService);
-    bindHost(host: VertexEraserToolHost): void;
-    setMode(active: boolean): void;
+    /** Makes each drag one undo step, however long the user pauses (RT-12). */
+    private readonly gesture;
+    /** @param gestureTarget the region store, so each drag is one undo step. */
+    constructor(gestureTarget?: UndoGestureTarget | null);
+    /** Arm the eraser on `host`, optionally with a new radius. */
+    activate(host: CanvasToolHost, options?: IVertexEraserOptions): void;
+    /** Disarm: remove the overlay and its cursor. */
+    deactivate(): void;
+    setOptions(options: IVertexEraserOptions): void;
     /** Set eraser radius in matrix-pixel (image pixel) coordinates. */
     setRadius(radius: number): void;
     private createOverlay;
-    private destroyOverlay;
-    private onMouseDown;
-    private onMouseMove;
-    private onMouseUp;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerUp;
     private updateCursor;
     /** Draw the eraser radius circle at the current cursor position. */
     private drawCursor;
+    /** The data↔matrix frame of the host's readback (identity without one). */
+    private frame;
     /**
-     * Drop every vertex of every path-shape that lies within the eraser's
-     * radius of the cursor. Polygons reduced below 3 vertices (or polylines
-     * below 2) are removed entirely.
+     * Drop every vertex of every annotation polygon/polyline that lies within the
+     * eraser's radius of the cursor, rejoining the outline at the eraser's edge
+     * (see {@link eraseRingWithinRadius}). Polygons reduced below 3 vertices (or
+     * polylines below 2) are removed entirely. Edited regions keep their metadata.
      */
     private applyAtClient;
-    static ɵfac: i0.ɵɵFactoryDeclaration<VertexEraserToolService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<VertexEraserToolService>;
 }

package/lib/toolbar/view-controls/view-controls.component.d.ts

@@ -0,0 +1,54 @@
+import { EventEmitter } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * The toolbar's view group: 2D zoom / pan tools, or for a 3D view the camera
+ * modes and reset, the napari axes and wireframe toggles and the 3D
+ * resolution. Presentational: the host owns every value.
+ */
+export declare class ViewControlsComponent {
+    /** A 2D view (zoom tools) rather than a 3D one (camera controls). */
+    isHeatmap: boolean;
+    /** The host shows the zoom tools. */
+    zoomTools: boolean;
+    /** The OSD Image view (pans natively; no Plotly drag-zoom). */
+    isImageView: boolean;
+    /** The armed zoom/pan tool (`zoom`, `pan`, …), or null. */
+    activeDragMode: string | null;
+    /** The 3D camera mode (`turntable` / `orbit` / …). */
+    activeSurface3dMode: string;
+    /** A napari-js WebGPU view (axes toggle, napari camera). */
+    isNapariMode: boolean;
+    /** The napari-js surface (shows the wireframe toggle). */
+    isNapariSurfaceMode: boolean;
+    /** A napari-js 3D view (shows the Resolution dropdown). */
+    isNapari3dMode: boolean;
+    /** The napari 3D axes gizmo is shown. */
+    axesVisible: boolean;
+    /** The napari surface wireframe is on. */
+    wireframeActive: boolean;
+    /** Active napari 3D decimate factor (1 = Full … 8 = ⅛). */
+    resolutionScale: number;
+    /** A zoom/pan tool button was clicked (its mode). */
+    toggleDragMode: EventEmitter<string>;
+    /** Zoom in one step. */
+    zoomIn: EventEmitter<void>;
+    /** Zoom out one step. */
+    zoomOut: EventEmitter<void>;
+    /** A 3D camera mode button was clicked (its mode). */
+    toggleSurface3dMode: EventEmitter<string>;
+    /** Reset the 3D camera. */
+    resetSurfaceCamera: EventEmitter<void>;
+    /** Toggle the napari 3D axes gizmo. */
+    toggleAxes: EventEmitter<void>;
+    /** Toggle the napari surface wireframe. */
+    toggleWireframe: EventEmitter<void>;
+    /** A napari 3D decimate factor was picked. */
+    selectResolution: EventEmitter<number>;
+    /** Decimate-factor options for the Resolution dropdown. */
+    protected readonly decimateOptions: {
+        label: string;
+        value: number;
+    }[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<ViewControlsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ViewControlsComponent, "toolbar-view-controls", never, { "isHeatmap": { "alias": "isHeatmap"; "required": false; }; "zoomTools": { "alias": "zoomTools"; "required": false; }; "isImageView": { "alias": "isImageView"; "required": false; }; "activeDragMode": { "alias": "activeDragMode"; "required": false; }; "activeSurface3dMode": { "alias": "activeSurface3dMode"; "required": false; }; "isNapariMode": { "alias": "isNapariMode"; "required": false; }; "isNapariSurfaceMode": { "alias": "isNapariSurfaceMode"; "required": false; }; "isNapari3dMode": { "alias": "isNapari3dMode"; "required": false; }; "axesVisible": { "alias": "axesVisible"; "required": false; }; "wireframeActive": { "alias": "wireframeActive"; "required": false; }; "resolutionScale": { "alias": "resolutionScale"; "required": false; }; }, { "toggleDragMode": "toggleDragMode"; "zoomIn": "zoomIn"; "zoomOut": "zoomOut"; "toggleSurface3dMode": "toggleSurface3dMode"; "resetSurfaceCamera": "resetSurfaceCamera"; "toggleAxes": "toggleAxes"; "toggleWireframe": "toggleWireframe"; "selectResolution": "selectResolution"; }, never, never, true, never>;
+}

package/lib/toolbar/wand/wand-region-grow.d.ts

@@ -0,0 +1,49 @@
+import { Polygon } from '../../models/region';
+import { IWandOptions, WandType } from '../../contracts/display-types';
+import { CachedFrame } from '../tool-kit/frame-pixels';
+/**
+ * Wand region-grow pipeline (pure, DOM- and DI-free), modelled after QuPath's
+ * WandToolEventHandler: extract a square patch around the click, optionally
+ * blur it, compute a local threshold (per channel, or a CIELAB distance map),
+ * run a fixed-range flood fill from the centre, close the mask, and (for
+ * {@link computeWandRegion}) trace it to a polygon in image coordinates.
+ *
+ * `WandService` delegates here; workers and new code should import these
+ * functions directly.
+ */
+export type { WandType };
+export type WandOptions = IWandOptions;
+export interface WandImage {
+    /**
+     * Grayscale: number[][] where data[y][x] is intensity.
+     * RGB: [r,g,b][][] where data[y][x] is a 3-tuple.
+     * Or a packed RGBA readback, read as RGB (see `tool-kit/frame-pixels`).
+     */
+    data: CachedFrame;
+    width: number;
+    height: number;
+    isGrayscale: boolean;
+}
+/** A wand patch mask: `size`×`size` 0/1 cells in patch-local coordinates. */
+export interface WandPatchMask {
+    mask: Uint8Array;
+    size: number;
+}
+/**
+ * Grow a region from a click and trace it.
+ *
+ * @param image full-image pixel matrix (already in memory).
+ * @param cx click x in image-pixel coordinates.
+ * @param cy click y in image-pixel coordinates.
+ * @param options wand parameters; missing fields fall back to defaults.
+ * @returns a Polygon in image-pixel coordinates, or null if no region grew.
+ */
+export declare function computeWandRegion(image: WandImage, cx: number, cy: number, options?: WandOptions): Polygon | null;
+/**
+ * The wand's per-click flood-fill mask in patch-local coordinates: the same
+ * pipeline as {@link computeWandRegion}, stopping before contour tracing (the
+ * tools accumulate per-tick masks across a brush-style stroke).
+ *
+ * @throws when `options.patchSize` is even.
+ */
+export declare function computeWandPatchMask(image: WandImage, cx: number, cy: number, options?: WandOptions): WandPatchMask | null;