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

package/lib/spatial-controls/spatial-controls.component.d.ts

@@ -1,22 +1,16 @@
-import { EventEmitter, NgZone, OnDestroy, OnInit } from '@angular/core';
+import { EventEmitter, NgZone, OnInit } from '@angular/core';
 import { IVisualizer, ISpatialControls } from '../contracts/visualizer.contract';
 import { SpatialDataset } from '../contracts/spatial-dataset.contract';
-import { ColormapNode, SpatialViewState, TranscriptGlyphName } from '../contracts/display-types';
+import { ColormapNode, SpatialViewState } from '../contracts/display-types';
+import { PanelOption, parseGeneGroups } from '../spatial/spatial-panel-model';
 import { SpatialSelectionMask } from '../spatial/spatial-selection';
+import { GenePickerModel } from './spatial-gene-picker';
+import { SpatialKeyModel, SpatialLegendEntry } from './spatial-key/spatial-key.model';
 import * as i0 from "@angular/core";
-/** One legend row for a categorical colouring. */
-export interface SpatialLegendEntry {
-    label: string;
-    color: string;
-}
-/**
- * `group,gene` rows (CSV or TSV, header optional) → gene groups, in file order.
- * Exported for tests.
- */
-export declare function parseGeneGroups(text: string): {
-    name: string;
-    genes: string[];
-}[];
+/** @deprecated Moved to `spatial-key/spatial-key.model`; re-exported for one release. */
+export type { SpatialLegendEntry };
+/** @deprecated Moved to `spatial/spatial-panel-model`; re-exported for one release. */
+export { parseGeneGroups };
 /**
  * Spatial-omics controls: a non-modal, resizable, draggable dialog for choosing
  * what the observation markers are coloured by, and how they are drawn.
@@ -30,8 +24,11 @@ export declare function parseGeneGroups(text: string): {
  * The legend swatches and the continuous colour bar are built with the SAME
  * functions the renderer uses (`categoryColors` → `resolveCategoryColors`,
  * `spatialContinuousLut`), so the key cannot drift from what is on screen.
+ *
+ * OnPush: the controls' streams, the key and gene-list models (which re-enter the zone
+ * when their async work lands) and an awaited category selection mark it for check.
  */
-export declare class SpatialControlsComponent implements OnInit, OnDestroy {
+export declare class SpatialControlsComponent implements OnInit {
     private readonly viz;
     private readonly zone;
     /** The embedded chart, so a dialog resize can re-fit it. */
@@ -45,139 +42,75 @@ export declare class SpatialControlsComponent implements OnInit, OnDestroy {
      * far more direct signal than watching boxes, and firing once on release means
      * no relayout churn during the drag.
      */
-    onResizeEnd(): void;
+    protected onResizeEnd(): void;
     /** Dialog visibility, two-way bound so a toolbar button can open it. */
     visible: boolean;
     /** Set while the 3D cloud is the active mode. Changes what the ROI selection
      *  MEANS — a screen-space lasso cutting through the cloud's full depth rather
      *  than a shape in tissue coordinates — so the hint below it says so. */
     is3d: boolean;
+    /** The dialog was opened or closed; two-way with {@link visible}. */
     visibleChange: EventEmitter<boolean>;
-    readonly clipOptions: {
-        label: string;
-        value: [number, number];
-    }[];
     /** Null when the host bound no `SPATIAL_DATA_PORT`. */
-    controls: ISpatialControls | null;
-    dataset: SpatialDataset | null;
-    view: SpatialViewState;
-    /** Colour-by column choices — "None" plus every column the dataset declares. */
-    columnOptions: {
-        label: string;
-        value: string | null;
-    }[];
-    selectedColumn: string | null;
-    /** Virtual-scrolled only past this many options: the scroller earns its
-     *  complexity for a few thousand names, and for eight it adds only overhead —
-     *  a virtual viewport that short swallows the clicks it is meant to forward. */
-    readonly geneVirtualScrollFrom = 200;
+    protected controls: ISpatialControls | null;
+    protected dataset: SpatialDataset | null;
+    protected view: SpatialViewState;
     /**
      * Gene picker: a filterable dropdown rather than a free-text typeahead, so the
      * options are visible before anything is typed and each keystroke narrows a list
-     * the user can see.
-     *
-     * `geneOptions` is the full name list when the dataset inlines it (a targeted
-     * panel: 8 for the ABC demo, 300–5,000 for Xenium/CosMx). A whole-transcriptome
-     * dataset does not ship its ~31k names, so there the list is what the port's last
-     * search returned and filtering is server-side — same control either way.
-     */
-    geneOptions: {
-        label: string;
-        value: string;
-    }[];
-    /**
-     * Every gene the dataset inlined, whether or not it is currently an option.
-     *
-     * Held as plain strings and searched per keystroke. A whole-transcriptome dataset
-     * inlines ~18k names — cheap to keep, ruinous to hand a dropdown all at once — so
-     * {@link geneOptions} is only ever the best few hundred of these.
-     */
-    private geneNames;
-    selectedGene: string | null;
-    /** True when the options come from the port per keystroke rather than a resident
-     *  list, which changes what an empty list means (nothing matched *yet*). */
-    genesAreRemote: boolean;
-    geneSearchFailed: boolean;
+     * the user can see. One model feeds every gene dropdown of the panel.
+     */
+    protected readonly genes: GenePickerModel;
+    /** The gene dropdowns' options. */
+    get geneOptions(): PanelOption<string>[];
+    /** True when the options come from the port per keystroke rather than a resident list. */
+    get genesAreRemote(): boolean;
+    get geneSearchFailed(): boolean;
+    /** The key — legend or colour bar — for the active colouring. Kept here, not in
+     *  `<spatial-key>`: whether the colouring is categorical decides which knobs the rest of
+     *  the panel offers, whether or not the key is on screen. */
+    readonly key: SpatialKeyModel;
     /** Categorical key, or null when the active colouring is continuous. */
-    legend: SpatialLegendEntry[] | null;
+    protected get legend(): SpatialLegendEntry[] | null;
     /** CSS gradient for a continuous colouring, or null when categorical. */
-    colorBarCss: string | null;
+    protected get colorBarCss(): string | null;
     /** Current selection — drives the count, the Clear button and the muting. */
-    selection: SpatialSelectionMask;
+    protected selection: SpatialSelectionMask;
     /** The legend row whose category is currently selected, for highlighting. */
-    selectedCategory: number | null;
+    protected selectedCategory: number | null;
     /** An ROI selection that matched nothing, so the UI can say so rather than
      *  looking like the button did nothing. */
-    selectionMissed: boolean;
+    protected selectionMissed: boolean;
     /**
      * Whether the Distribution section is expanded. Collapsed by default: the
      * panel's primary job is the colour controls, and the chart roughly doubles
      * its height.
      */
-    chartsOpen: boolean;
+    protected chartsOpen: boolean;
     /** Per-instance id for the collapsible body, so `aria-controls` points at one
      *  element and expanding the second panel cannot scroll the first one's chart. */
-    readonly chartsBodyId: string;
-    /**
-     * The dataset's imaged section positions, or null when its z is continuous
-     * rather than sectioned. Read once per dataset — the scan walks the z of every
-     * observation, so it must not sit in a template getter.
-     */
-    sections: Float32Array | null;
-    /**
-     * Colormap tree for the continuous colour scale, and the node currently picked
-     * from it. The library's own `COLORMAP_OPTIONS`, shown with the same swatches
-     * the image's colormap picker uses — choosing a gradient is a visual decision,
-     * so a list of names would be the wrong control.
-     */
-    colormapOptions: ColormapNode[];
-    selectedColormapNode: ColormapNode | null;
+    protected readonly chartsBodyId: string;
+    /** Colormap tree for the continuous colour scale and the density map: the library's
+     *  own `COLORMAP_OPTIONS`. */
+    protected colormapOptions: ColormapNode[];
     private colormap;
     private reverse;
-    /** Guards the gene typeahead and the legend/colour-bar rebuild: both are async
-     *  and both are driven by input the user changes faster than they resolve. */
-    private geneSearchToken;
-    private keyToken;
-    private readonly subs;
+    private readonly destroyRef;
+    private readonly cdr;
     constructor(viz: IVisualizer, zone: NgZone);
     ngOnInit(): void;
-    ngOnDestroy(): void;
-    onVisibleChange(value: boolean): void;
-    /** Column dropdown. Choosing a column supersedes any gene selection. */
-    onColumn(name: string | null): void;
-    /**
-     * A keystroke in the gene dropdown's filter box.
-     *
-     * With the names resident the dropdown filters them itself and this only clears a
-     * stale failure. Without them there is nothing to filter, so the query goes to the
-     * port and its answer BECOMES the option list — the same control, filtering one
-     * hop further away.
-     */
+    /** Apply an async result inside the zone and re-render this OnPush dialog. */
+    private runAndMark;
+    protected onVisibleChange(value: boolean): void;
+    /** A keystroke in a gene dropdown's filter box — see {@link GenePickerModel.onFilter}. */
     onGeneFilter(query: string): Promise<void>;
-    /**
-     * Opening either gene dropdown — "Colour by gene" or the transcript genes. Both share
-     * one list and one search, so each opens on the head of the full list rather than on
-     * whatever the other was last filtered to.
-     *
-     * A whole-transcriptome dataset does not inline its ~30k names; they are fetched here,
-     * once, on first open — the list is then resident and every keystroke filters locally,
-     * exactly as for a targeted panel. Until it arrives the dropdown falls back to asking
-     * the server per keystroke.
-     */
+    /** A gene dropdown opened — see {@link GenePickerModel.ensureList}. */
     ensureGeneList(): Promise<void>;
-    /** Most names fetched for the lazy list — well above any panel, whole-transcriptome included. */
-    private static readonly GENE_LIST_MAX;
-    private geneListLoading;
-    /** Options for `names`, plus the genes already chosen (a multi-select shows a chip only
-     *  for a value it can find among its options). */
-    private withSelected;
-    /** A gene was picked; it supersedes any column selection. */
-    onGene(name: string | null): void;
     /** Select every observation inside the drawn regions (their union). */
-    selectFromRegions(): void;
+    protected selectFromRegions(): void;
     /** Legend click: select one category. Clicking the active row clears it, so a
      *  second click is an undo rather than a no-op. */
-    selectCategory(index: number): Promise<void>;
+    protected selectCategory(index: number): Promise<void>;
     /**
      * Expand or collapse the distribution section.
      *
@@ -187,356 +120,43 @@ export declare class SpatialControlsComponent implements OnInit, OnDestroy {
      * scroll is deferred a task so the chart's own deferred first draw has given the
      * body its height.
      */
-    toggleCharts(): void;
-    clearSelection(): void;
+    protected toggleCharts(): void;
+    protected clearSelection(): void;
     /** True while a selection is active — everything else renders muted. */
-    get hasSelection(): boolean;
-    onPointScale(value: number | undefined): void;
-    onOpacity(value: number | undefined): void;
-    onLogScale(on: boolean): void;
-    /**
-     * Set when the active categorical colouring has more categories than the 3D
-     * cloud can keep apart, so the points are drawing FLAT.
-     *
-     * Said in the panel rather than left to a console warning: `subclass` (338) is
-     * served precisely because the density volumes and the 2D view can render it, and
-     * a user who picks it in the cloud and sees one colour deserves to know both why
-     * and what to do instead.
-     */
-    get exceedsCloudPalette(): boolean;
-    /** The ceiling itself, for the message. */
-    readonly cloudPaletteLimit = 95;
-    onGeneMap(on: boolean): void;
-    /** 3D: smooth the per-section sheets along z into a continuous volume. */
-    onGeneMapVolume(on: boolean): void;
-    /** 3D: restrict the sheets to one imaged section. */
-    onGeneMapOneSection(on: boolean): void;
-    onGeneMapSection(value: number | undefined): void;
-    get geneMapOneSection(): boolean;
-    /** "12 of 53" for the gene map's own section, 1-based like the cloud's. */
-    get geneMapSectionLabel(): string;
-    onGeneMapSmoothing(value: number | undefined): void;
-    onGeneMapOpacity(value: number | undefined): void;
-    /**
-     * What the 3D gene map is currently showing, said plainly — the sheets are a
-     * measurement and the volume is an estimate, and the panel has to be the place
-     * that says which one is on screen.
-     */
-    get geneMapVolumeNote(): string;
-    /** True while a gene is the colour source — the only thing a gene map can map. */
-    get canMapGene(): boolean;
-    onShowVolume(on: boolean): void;
-    onVolumeOpacity(value: number | undefined): void;
-    onShowPoints(on: boolean): void;
-    /** The "one section at a time" switch: null restores the whole stack. */
-    onOneSection(on: boolean): void;
-    onPointSection(value: number | undefined): void;
-    /** True while the cloud is restricted to a single section. */
-    get oneSection(): boolean;
-    /** Highest section index the slider can reach. */
-    get lastSection(): number;
-    /** "12 of 53" — 1-based, because the sections are slides, not array slots. */
-    get sectionLabel(): string;
-    /** Whether this dataset has sections to pick from at all. */
-    get isSectioned(): boolean;
-    onDensityVolume(on: boolean): void;
-    onDensitySmoothing(value: number | undefined): void;
-    /** What the density volumes are actually showing, said plainly — an estimate is
-     *  only honest if the reader knows it is one, and which clusters are in view. */
-    get densityNote(): string;
-    /** Mirrors the renderer's cap, for the note only. */
-    private static readonly DENSITY_MAX_CLUSTERS;
-    onClip(value: [number, number]): void;
-    readonly cellDrawOptions: {
-        label: string;
-        value: string;
-    }[];
-    readonly transcriptColorOptions: {
-        label: string;
-        value: string;
-    }[];
-    readonly glyphOptions: {
-        label: string;
-        value: TranscriptGlyphName;
-        points: string;
-    }[];
-    readonly budgetOptions: {
-        label: string;
-        value: number;
-    }[];
+    protected get hasSelection(): boolean;
     /** Boundaries on offer: tiled (level-of-detail) or whole-dataset rings. */
-    get hasCells(): boolean;
-    get hasTranscripts(): boolean;
-    /** Whether outlines are on — the explicit choice, or automatically for data that has them. */
-    get cellsOn(): boolean;
-    get activeCellSet(): string | null;
-    /**
-     * Option lists for the cell/transcript controls. Built once per dataset rather than in
-     * getters: a getter returns a fresh array on every change-detection pass, and PrimeNG
-     * re-renders its buttons whenever the array identity changes — which made them
-     * impossible to click.
-     */
-    cellSetOptions: {
-        label: string;
-        value: string;
-    }[];
-    transcriptModeOptions: {
-        label: string;
-        value: SpatialViewState['transcriptMode'];
-    }[];
-    private buildTileOptions;
-    /** Cell colour modes on offer (Xenium Explorer's "Cell Color"). */
-    cellColorOptions: {
-        label: string;
-        value: SpatialViewState['cellColorMode'];
-    }[];
-    /**
-     * The group picker: categorical columns under their section heading, a family of
-     * variants (k-means at k = 2…10) listed once. Values are a column name, or
-     * `family:<id>` for a family.
-     */
-    groupOptions: {
-        label: string;
-        items: {
-            label: string;
-            value: string;
-        }[];
-    }[];
-    /** Variants of the active family (k = 2…10), when a family is active. */
-    groupVariantOptions: {
-        label: string;
-        value: string;
-    }[];
-    /** The last variant chosen per family, so switching away and back keeps k. */
-    private familyChoice;
-    private buildGroupOptions;
-    /** The picker's value for the active group column. */
-    get activeGroupEntry(): string | null;
-    private refreshVariants;
-    onGroupEntry(value: string): void;
-    onGroupVariant(name: string): void;
-    /** The active grouping's categories with colours and cell counts, largest first. */
-    groupRows: {
-        label: string;
-        color: string;
-        count: number;
-    }[];
-    groupTotal: number;
-    groupsExpanded: boolean;
-    private groupRowsFor;
-    groupImportError: string | null;
-    groupImporting: boolean;
-    private refreshGroups;
-    isGroupShown(label: string): boolean;
-    get allGroupsShown(): boolean;
-    onGroupShown(label: string, on: boolean): void;
-    onAllGroupsShown(on: boolean): void;
-    get canImportGroups(): boolean;
-    /** '+': a CSV/TSV of `cell_id` and group, named after the file. */
-    onImportGroupsFile(input: HTMLInputElement): Promise<void>;
-    get activeCellTypeColumn(): string | null;
-    onShowCells(on: boolean): void;
-    onCellSet(set: string): void;
-    onCellDraw(draw: SpatialViewState['cellDraw']): void;
-    onCellOpacity(value: number | undefined): void;
-    onCellTypeColumn(name: string | null): void;
-    onCellColorMode(mode: SpatialViewState['cellColorMode']): void;
-    onCellColorGene(gene: string | null): void;
-    onCellSingleColor(hex: string): void;
-    /** Fill opacity as a 0–100 number, for the box beside the slider. */
-    onCellOpacityPercent(v: number | null): void;
-    onShowImage(on: boolean): void;
-    onShowAnnotations(on: boolean): void;
+    protected get hasCells(): boolean;
+    /** Transcripts on offer: tiles to draw, or a density map. */
+    protected get hasTranscripts(): boolean;
+    protected onShowImage(on: boolean): void;
+    protected onShowAnnotations(on: boolean): void;
     /** Which collapsible sections are open. Per dialog instance, not persisted. */
-    open: Record<'images' | 'cells' | 'transcripts' | 'annotations' | 'observations', boolean>;
-    toggleSection(name: keyof SpatialControlsComponent['open']): void;
-    /** The mode the section header's switch turns back on. */
-    private lastTranscriptMode;
-    onTranscriptsOn(on: boolean): void;
+    protected open: Record<'images' | 'cells' | 'transcripts' | 'annotations' | 'observations', boolean>;
+    protected toggleSection(name: keyof SpatialControlsComponent['open']): void;
+    /** Expand or collapse a section — what a panel's header asks for. */
+    protected setOpen(name: keyof SpatialControlsComponent['open'], on: boolean): void;
     /** Estimated transcripts in view, against the budget — Explorer's points bar. */
-    estimate: {
+    protected estimate: {
         points: number;
         max: number;
     } | null;
     /** The density window in use and its densest bin, for the threshold control. */
-    densityStats: {
+    protected densityStats: {
         lo: number;
         hi: number;
         max: number;
     } | null;
-    get estimatePercent(): number;
-    get estimateOverMax(): boolean;
-    editingMax: boolean;
-    /** The selected genes as Explorer's tree: named groups, then the ungrouped ones. */
-    /** Rebuilt when the view changes — never per change-detection pass (see buildTileOptions). */
-    geneTree: {
-        name: string | null;
-        genes: string[];
-    }[];
-    geneMenu: {
-        label: string;
-        icon: string;
-        command: () => void;
-        disabled?: boolean;
-    }[];
-    private buildGeneTree;
-    /** Real genes in the panel — the tree's denominator. */
-    get geneTotal(): number;
-    collapsedGeneGroups: Set<string>;
-    geneTreeOpen: boolean;
-    toggleGeneGroup(name: string): void;
-    isGeneShown(gene: string): boolean;
-    areGenesShown(genes: string[]): boolean;
-    /** The eye toggle: hide or show genes without removing them from the selection. */
-    onGenesShown(genes: string[], on: boolean): void;
-    onGeneColor(gene: string, hex: string): void;
-    /** Swatches in the picker: the categorical palette genes are coloured from by default. */
-    readonly colorPresets: string[];
-    /** The gene the open picker edits. */
-    styleGene: string | null;
-    openGeneStyle(event: Event, gene: string, panel: {
-        toggle(e: Event): void;
-        hide(): void;
-    }): void;
-    /** The icon the open picker shows as chosen. */
-    get styleGlyph(): TranscriptGlyphName | null;
-    glyphPoints(glyph: TranscriptGlyphName): string;
-    /** A typed hex colour, accepted as `#rrggbb` or `rrggbb`; anything else is ignored. */
-    onGeneHex(gene: string, text: string): void;
-    /** Back to the gene's default icon and colour (by its position in the list). */
-    resetGeneStyle(gene: string): void;
-    /** '±': every gene, or back to the chosen list. */
-    onToggleAllGenes(): void;
-    /** '⋮' menu. */
-    private buildGeneMenu;
-    /** The hidden file input the menu's import opens. */
-    private geneGroupFileRef?;
-    private get geneGroupInput();
-    trackByLabel: (_i: number, row: {
-        label: string;
-    }) => string;
-    trackByNode: (_i: number, node: {
-        name: string | null;
-    }) => string;
-    trackByLabelString: (_i: number, s: string) => string;
-    get cellOpacityPercent(): number;
-    get densityOpacityPercent(): number;
-    geneGroupError: string | null;
     /** Transcripts of each selected gene in the current view, from the renderer. */
-    geneCounts: Record<string, number> | null;
-    geneCountOf(gene: string): number | null;
-    markersOpen: boolean;
-    markerColumn: string | null;
-    markerPerGroup: number;
-    readonly markerPerGroupOptions: {
-        label: string;
-        value: number;
-    }[];
-    markerClusters: string[];
-    markerClusterOptions: {
-        label: string;
-        value: string;
-    }[];
-    markerLoading: boolean;
-    markerError: string | null;
-    get canAddMarkers(): boolean;
-    /** Every categorical column but the segmentation method, which says nothing about genes. */
-    get markerColumnOptions(): {
-        label: string;
-        value: string;
-    }[];
-    openMarkers(): void;
-    onMarkerColumn(column: string): void;
-    /** The clusters of the chosen column, all picked to start with. */
-    private refreshMarkerClusters;
-    /**
-     * Add each picked cluster's top marker genes as a gene group named after it, and select
-     * them. A gene that marks several clusters goes to the one it is most specific to, so the
-     * tree lists it once.
-     */
-    addMarkerGenes(): Promise<void>;
-    onNewGeneGroup(): void;
-    /**
-     * Import gene groups: CSV/TSV with a group and a gene column (header optional), e.g.
-     * marker genes per cell type. The genes are added to the selection.
-     */
-    onImportGeneGroups(input: HTMLInputElement): Promise<void>;
-    readonly densityBins: number[];
-    get densityBinIndex(): number;
-    onDensityBinIndex(i: number | undefined): void;
-    onDensityOpacityPercent(v: number | null): void;
-    /**
-     * The threshold window shown: the one set, else the one derived. A stored array, not a
-     * getter: a range slider's `ngModel` given a fresh array every change-detection pass
-     * schedules another pass, forever — which hung the page the moment the density
-     * controls appeared.
-     */
-    densityWindow: [number, number];
-    densitySliderMax: number;
-    densityStep: number;
-    private refreshDensityWindow;
-    onDensityRange(range: [number, number] | number[] | undefined): void;
-    onDensityRangeEnd(which: 0 | 1, v: number | null): void;
-    onDensityAuto(): void;
-    selectedDensityColormapNode: ColormapNode | null;
-    onDensityColormap(node: ColormapNode | null): void;
-    get densityColorBarCss(): string;
-    onTranscriptMode(mode: SpatialViewState['transcriptMode']): void;
-    onTranscriptGenes(genes: string[] | null): void;
-    /** "All genes" needs the grouping pyramid, or at least tiles to draw individually. */
-    get canShowAllGenes(): boolean;
-    /** Why "All genes" is not offered yet, while the server builds its pyramid. */
-    get allGenesPreparing(): string | null;
-    get showingAllGenes(): boolean;
-    onTranscriptAllGenes(on: boolean): void;
-    onTranscriptBudget(n: number): void;
-    onTranscriptColorBy(by: SpatialViewState['transcriptColorBy']): void;
-    onTranscriptScale(value: number | undefined): void;
-    onTranscriptOpacity(value: number | undefined): void;
-    onTranscriptQuality(includeLow: boolean): void;
-    onDensityOpacity(value: number | undefined): void;
-    glyphOf(gene: string, slot: number): TranscriptGlyphName;
-    onGlyph(gene: string, glyph: TranscriptGlyphName): void;
-    /** The colour gene `slot` is drawn in when transcripts are coloured by gene. */
-    geneColor(slot: number): string;
-    /** Colours of the cells' groups, by name — what a cluster of the same name is drawn in. */
-    private cellGroupColors;
-    private cellGroupColorsFor;
-    private refreshCellGroupColors;
-    /** In Cluster colouring, a gene's swatch is its cluster's colour, as its markers are. */
-    geneSwatchOf(gene: string): string;
-    geneColorOf(gene: string): string;
-    reset(): void;
-    /**
-     * Description of the active column, when it has one. Surfaced because a
-     * DERIVED column (k-means clusters, QC totals computed at conversion) must not
-     * read as though it came with the data.
-     */
-    get activeDescription(): string | null;
-    /** Label for the current colouring, for the key's heading. */
-    get colorByLabel(): string;
+    protected geneCounts: Record<string, number> | null;
+    protected reset(): void;
+    /** Label for the current colouring, for the Distribution heading. */
+    protected get colorByLabel(): string;
     /** True when the active colouring is a categorical column (drives the key). */
     get isCategorical(): boolean;
     /** Whether log/clip apply — they are continuous-only knobs. */
     get isContinuous(): boolean;
-    private columnLabel;
     /** Rebuild the legend or colour bar for the current colouring. */
     private refreshKey;
-    /**
-     * The continuous colour scale's colormap. Clearing it goes back to following
-     * the image's, which is the default.
-     */
-    onContinuousColormap(node: ColormapNode | null): void;
-    /** The tree node holding a colormap value, so the picker shows what is in use. */
-    private colormapNodeFor;
-    /**
-     * `linear-gradient(...)` sampling the active colormap at 16 stops.
-     *
-     * Resolved exactly the way the renderer resolves it — the same override, the
-     * same grey fallback. Built from `lutFor` alone, this bar showed a black-to-white
-     * ramp while the canvas drew Viridis, which makes the key worse than no key.
-     */
-    private buildColorBar;
     static ɵfac: i0.ɵɵFactoryDeclaration<SpatialControlsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SpatialControlsComponent, "spatial-controls", never, { "visible": { "alias": "visible"; "required": false; }; "is3d": { "alias": "is3d"; "required": false; }; }, { "visibleChange": "visibleChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SpatialControlsComponent, "spatial-controls", never, { "visible": { "alias": "visible"; "required": false; }; "is3d": { "alias": "is3d"; "required": false; }; }, { "visibleChange": "visibleChange"; }, never, never, true, never>;
 }