@mosaicajs/components 0.2.0 → 0.4.0

package/dist/field-card.d.ts

@@ -1,46 +1,114 @@
 import { nothing, type PropertyValues, type TemplateResult } from 'lit';
 import { type Store } from '@mosaicajs/client';
-import { MosaicaElement } from './base.js';
+import { MosaicaElement, type Called } from './base.js';
 import './filter.js';
 import './cluster-filter.js';
-/** A range dragged across the histogram, by bin, `from` where the drag began. */
+/**
+ * One step of a card's position: the cluster stepped into, what it is called and where that came
+ * from, its level, and how many children its row said it has.
+ */
+type Step = {
+    id: bigint;
+    name: string;
+    from: Called['from'];
+    rung: number;
+    children: number | null;
+};
+/** A range being dragged across the histogram, by bin, `from` where the drag began. */
 type Brush = {
     from: number;
     to: number;
-    open: boolean;
+};
+/**
+ * One end of the range box: what its field holds, the value that stands for (`null` leaves the end
+ * open, `undefined` is text that is no value), and whether a mistake in it is shown.
+ */
+type End = {
+    text: string;
+    value: number | null | undefined;
+    checked: boolean;
+};
+/** The range box's two ends. */
+type RangeEntry = {
+    from: End;
+    to: End;
 };
 /**
  * Use a field card on its own when you want one field's chart in a place of your choosing.
  * `<mosaica-filter-panel>` shows one for each field. Set `field` to a column `meta.filterOperands`
  * lists, or to `cluster:<layer>` for a layer's clusters.
  *
- * The solid bars count the items in view that the filters match, or the highlighted items while
- * there is a highlight. The pale bars count every item the filters match. Neither count applies the
- * card's own filter, so a value the viewer has filtered out keeps its count.
+ * On a column's card and a flat layer's, the solid bars count the items in view that the filters
+ * match, or the highlighted items while there is a highlight. The pale bars count every item the
+ * filters match. Neither count applies the card's own filter, so a value the viewer has filtered
+ * out keeps its count.
  *
  * What the card shows depends on the kind of field:
  *
- * - A category or cluster card lists the values with most items in view, each with Highlight and
- *   Filter buttons.
- * - A number or date card draws a histogram, and the viewer drags across it to pick a range to
- *   filter or highlight by. From the keyboard, they press Shift and the arrow keys on the focused
- *   plot, then Enter. Counts over about 100,000 items come from a sample, so they are marked "≈".
+ * - A category card, and the card of a `flat` layer, lists the values with most items in view,
+ *   each with its counts. A row's Highlight and Filter buttons take the counts' place while the
+ *   pointer is over the row or the keyboard's focus is in it, and are always drawn on a screen with
+ *   no pointer that hovers. A button is filled, and its icon solid, while its value is highlighted
+ *   or filtered to, and before the counts a tick marks a value the filter keeps and a pen one that
+ *   is highlighted. A screen reader is given each count with what it counts.
+ * - The card of a `tiered`, `nested` or `dag` layer walks the layer by its parent edges, and
+ *   walking it leaves the map's filter as it is. A breadcrumb above the rows holds the card's
+ *   position, from All, the layer's top level, down to the cluster whose children are listed. Each
+ *   crumb is a button that steps back to it, and a tick marks a crumb whose cluster the filter is
+ *   on. The rows are the served children of the position, in the server's order, a page at a time:
+ *   More loads the next page. Each row counts the items that match every filter, this layer's
+ *   clauses among them, beside every item of it the viewer may see, so a row whose count is 0 is
+ *   still listed, and each count is what filtering to the row would leave. A row with children
+ *   ends in a button with their number, which steps into the row. Filtering to a row adds a
+ *   clause, and a layer's clauses combine with AND. The rows of a `tiered` layer stand under the
+ *   titles of their levels, and a row of a `dag` layer names its other served parents. Once every
+ *   child of the position has loaded, a last row counts the items of the position that match every
+ *   filter and are in none of its children.
+ * - The card of a `stacked` layer lists the clusters with most items in view, under every filter,
+ *   this layer's clauses among them, at the chosen level or at the level the map draws. A row at a
+ *   level with a finer level after it ends in a button that steps into it, and the card then lists
+ *   the clusters of that finer level by their items inside the row, under a heading that says so.
+ * - On the card of a `tiered`, `nested`, `dag` or `stacked` layer, the layer's filter and highlight
+ *   clauses stand in a line of their own under the breadcrumb, each with a × that removes it, so a
+ *   clause set by another control is shown wherever the card's position is. Set `hide-chips` to
+ *   leave that line out where the clauses are shown already, as `<mosaica-filter-panel>` does on
+ *   the cards it shows while it shows the clauses as chips of its own. The ticks on the crumbs and
+ *   the rows stay.
+ * - A number or date card draws a histogram of up to 20 bins, and the viewer presses a bin or drags
+ *   across several to pick a range to filter or highlight by. From the keyboard, they press Shift
+ *   and the arrow keys on the focused plot, then Enter. Either opens a box under the range with its
+ *   two ends in fields that take a typed number or date. A field left empty leaves that end open.
+ *   The box closes on Escape, on a press outside it and as focus leaves it.
+ *   A field that holds no number or date, or a lower end above the upper, is not applied, and the
+ *   box says what to type. Set range, a button drawn only while the keyboard has it, opens the
+ *   same box with nothing chosen. A screen reader is given the range each of the filter and the
+ *   highlight holds, and the bins' counts in a table. Counts over about 100,000 items come from a
+ *   sample, so they are marked "≈".
+ * - A bool card lists yes and no as a category card lists values. Its counts are taken as a
+ *   histogram's, so those over about 100,000 items are marked "≈".
  * - A text or keyword field's card is a search box, `<mosaica-filter>`.
  *
  * While the paint button colours the map by the field, clicking a value's colour opens a picker
  * that changes the colour on the map.
  *
+ * A cluster with no name is called by its key, drawn in the secondary ink and the identifiers'
+ * font, and a clause on it carries the key as its label. A cluster with neither is called Unnamed.
+ *
+ * A long name is one line, cut with an ellipsis. Where `--mosaica-long-text` is `normal`, as in the
+ * explorer's narrow form, the card's name, what it notes and its rows' names wrap.
+ *
  * @summary A card that charts one field's values and filters or highlights by them.
  * @tagname mosaica-field-card
  * @category Elements
  * @fires {CustomEvent<MosaicaEventDetails['mosaica-filterchange']>} mosaica-filterchange - A row's
  *   Highlight or Filter, or the range box, changed the field's clause.
  * @fires {CustomEvent<MosaicaEventDetails['mosaica-clausechange']>} mosaica-clausechange - A cluster
- *   row, its Highlight or its Filter put a `member_of` clause on or took it off.
+ *   row, its Highlight or its Filter, or a clause's × put a `member_of` clause on or took it off.
  * @fires {CustomEvent<MosaicaEventDetails['mosaica-colourchange']>} mosaica-colourchange - The paint
  *   button changed what the map is coloured by.
  * @fires {CustomEvent<MosaicaEventDetails['mosaica-levelchange']>} mosaica-levelchange - The Level
- *   choice of a levelled layer's card changed.
+ *   choice of a levelled layer's card changed. The detail names the card's layer, and a `level` of
+ *   `null` for Follow zoom.
  * @fires {CustomEvent<MosaicaEventDetails['mosaica-valuecolour']>} mosaica-valuecolour - A category
  *   value's colour was chosen or reset in the colour picker.
  * @fires {CustomEvent<MosaicaEventDetails['mosaica-clustercolour']>} mosaica-clustercolour - A
@@ -48,34 +116,71 @@ type Brush = {
  * @fires {CustomEvent<MosaicaEventDetails['mosaica-fold']>} mosaica-fold - The fold button folded or
  *   opened the card.
  * @csspart head - The heading: the name, what it notes, and the buttons.
- * @csspart title - The field's name.
+ * @csspart title - The field's name, a heading that names the card.
  * @csspart sub - What the heading notes: the field's figures, or the Level choice.
- * @csspart level-select - The Level choice, on a levelled layer's card.
+ * @csspart level-select - The Level choice, on a levelled layer's card. Where no level declares a
+ *   zoom range, its first option is Follow zoom.
  * @csspart spark - The small chart of a folded card.
  * @csspart paint - The paint button, with `aria-pressed`.
  * @csspart fold - The fold button, with `aria-expanded`.
- * @csspart rows - A category or cluster card's rows.
+ * @csspart crumbs - The breadcrumb of a layer's card that steps: a navigation landmark named by
+ *   the layer, holding a list of the card's position from All down.
+ * @csspart crumb - One crumb, with `data-id`, which is empty for All, and `data-filtered` while the
+ *   layer's filter is on its cluster.
+ * @csspart crumb-name - A crumb's button, which steps back to it, with `aria-current` on the
+ *   deepest. A tick before the name marks a cluster the filter is on, and the name carries
+ *   `data-key-name` where it is the cluster's key.
+ * @csspart chips - The layer's filter and highlight clauses on a card that steps, a list, while it
+ *   has any and `hide-chips` is not set.
+ * @csspart chip - One clause, with `data-id` and `data-verb` (`filter` or `highlight`).
+ * @csspart chip-name - A clause's cluster, after a tick for a filter or a pen for a highlight. The
+ *   name carries `data-key-name` where it is the cluster's key.
+ * @csspart chip-remove - The × that removes a clause.
+ * @csspart level - A heading over a list of rows: a level's title on a `tiered` layer's card, or
+ *   what a `stacked` layer's card lists inside its position.
+ * @csspart rows - A category or cluster card's rows, one list for each level on a `tiered` layer's
+ *   card.
  * @csspart row - One row, with `data-key` and `data-state`: `in` if the field's filter keeps the
  *   value, `out` if it leaves it out, `lit` if it is highlighted, otherwise empty.
- * @csspart swatch - A row's colour button, while the map is coloured by the field. It opens the
- *   colour picker. It carries `data-unmet`, and is drawn as an outline, for a value the map has not
- *   drawn yet and so has not given a colour.
- * @csspart name - A row's name, with `data-unnamed` for a cluster that has none.
- * @csspart path - A cluster row's parents.
+ * @csspart swatch - A row's colour button, while the map is coloured by the field: a 24 px target
+ *   with the colour, set as `--c`, in a 10 px square at its middle. It opens the colour picker. It
+ *   carries `data-unmet`, and the square is drawn as an outline, for a value the map has not drawn
+ *   yet and so has not given a colour.
+ * @csspart name - A row's name, with the whole name as its `title`. Where a cluster has none it is
+ *   the cluster's key, with `data-key-name`, and where it has no key either it is the word Unnamed,
+ *   with `data-unnamed`.
+ * @csspart step - A row's button that steps into it, with the number of its children on a layer
+ *   with parent edges.
+ * @csspart also - The other served parents a `dag` row of a layer's card is under, each with
+ *   `data-key-name` where it is called by its key.
+ * @csspart remainder - The last row of the last list, which counts the position's items in none of
+ *   its children.
+ * @csspart refusal - The words "Clusters unavailable", with `data-code`, where the rows were
+ *   refused.
  * @csspart bar-match - A row's or a bin's pale bar, its share of the whole match.
  * @csspart bar-subject - A row's or a bin's solid bar, its share of the subject.
- * @csspart count - A row's counts.
- * @csspart verbs - A row's Highlight and Filter buttons.
+ * @csspart count - A row's counts as they are drawn, after its tick and its pen, with what they
+ *   count as its `title`. A screen reader is given them beside it, each with what it counts.
+ * @csspart verbs - A row's Highlight and Filter buttons, in its counts' place.
  * @csspart highlight - A row's Highlight button, with `aria-pressed`.
  * @csspart filter - A row's Filter button, with `aria-pressed`.
- * @csspart more - The "N more" button.
+ * @csspart more - The "N more" button. On a layer's card walked by its parent edges it loads the
+ *   next page and moves focus to the first row it added; elsewhere it shows more rows, or fewer. Its
+ *   accessible name says what it shows.
  * @csspart plot - The histogram, a focusable group.
  * @csspart bin - One bin, with `data-index`.
  * @csspart band - An outlined range on the histogram, with `data-verb` (`filter`, `highlight`, or
- *   `brush` while one is being chosen).
+ *   `brush` while one is being chosen). The highlight's is hatched.
  * @csspart axis - The values under the histogram.
  * @csspart ramp - The colour ramp under the histogram, while the map is coloured by the field.
- * @csspart brush - The box a dragged range opens.
+ * @csspart range - The Set range button, with `aria-expanded`, drawn over the start of the axis
+ *   while it has the keyboard's focus.
+ * @csspart brush - The range box, which a chosen range or Set range opens over what is under the
+ *   histogram.
+ * @csspart brush-from - The field for its lower end, with `aria-invalid` while what it holds is not
+ *   applied.
+ * @csspart brush-to - The field for its upper end, with `aria-invalid` while what it holds is not
+ *   applied.
  * @csspart brush-filter - Its Filter button.
  * @csspart brush-highlight - Its Highlight button.
  * @csspart colour-popover - The colour picker, while it is open.
@@ -95,29 +200,58 @@ export declare class MosaicaFieldCard extends MosaicaElement {
     accessor folded: boolean;
     /** Draws a folded card in the compact style the explorer uses in narrow containers. */
     accessor compact: boolean;
-    /** The level a card for a layer with levels counts at. `null` is the coarsest level. */
+    /** Leaves out the layer's clauses as chips, for a card placed where they are shown already. */
+    accessor hideChips: boolean;
+    /**
+     * The level a card for a layer with levels counts at. `null` is the level the map draws: where no
+     * level declares a zoom range, the finest that is not crowded in view, else the coarsest served.
+     */
     accessor level: number | null;
     /** Whether "N more" was pressed. @internal */
     accessor expanded: boolean;
-    /** The row whose verbs a press showed, on a screen without hover. @internal */
-    accessor shownRow: string | null;
+    /**
+     * Where a cluster card that steps stands in its layer: the clusters stepped into, the deepest
+     * last, and none for the top level. @internal
+     */
+    accessor position: readonly Step[];
+    /** What the card says loaded after the last step. @internal */
+    accessor said: string;
     /** A range being chosen on the histogram. @internal */
     accessor brush: Brush | null;
+    /** The range box's two fields, while it is open. @internal */
+    accessor entry: RangeEntry | null;
+    /** The part that opened the range box, which takes focus as it closes. */
+    private entryOpener;
+    /** The ends of the last range the box could apply, as shares of the plot's width, which place the box. */
+    private boxAt;
+    /** The control in the card that held focus as a render began, and the row it was in. */
+    private focusedBefore;
+    /**
+     * A step whose rows have not landed: the cluster stepped out of, whose row then takes focus, or
+     * `null` for a step in, after which the first row does. `fresh` until the render after the step.
+     */
+    private landing;
     private readonly subjectCounts;
     private readonly matchCounts;
     private readonly figures;
     /** The whole match's counts of the values in view its commonest do not list. */
     private readonly outsideCounts;
     private unwatchChoices;
-    /** The names of the clusters' parents. */
-    private readonly paths;
+    /** A linked layer's rows: the children of the position, or the roots, a page at a time. */
+    private readonly lineage;
+    /** The items of the position in none of its children, once every child has loaded. */
+    private readonly remainder;
+    private remainderAsked;
+    /** The counts in view asked last. */
+    private subjectAsked;
     private readonly picker;
     /** What the card last drew from, so a publish that changes none of it draws nothing. */
     private drawnFrom;
     /**
-     * Draw again only when what the card reads changed: its counts, the clauses, the colouring, the
-     * view, or the palette and chosen colours a layer's clusters take. The store publishes as each
-     * frame arrives, which changes none of these.
+     * Draw again only when what the card reads changed: its counts, the clauses, the drawn region,
+     * the colouring, the view, the palette and chosen colours a layer's clusters take, or the level a
+     * levelled layer is drawn at. The store publishes as each frame arrives, which changes none of
+     * these.
      */
     protected onStoreChange(): void;
     protected onStoreAdopted(store: Store | null): void;
@@ -131,15 +265,44 @@ export declare class MosaicaFieldCard extends MosaicaElement {
     private isTimestamp;
     /** Whether the map can be coloured by this field. */
     private colourable;
-    /** The level a levelled layer's card counts and browses at: the one chosen, else the top level. */
+    /** The level a levelled layer's card counts and browses at: the one chosen, else the one the map draws. */
     private levelOf;
-    /** The keys of the field's clause in `verb`: a category's values, or a layer's clusters by id. */
+    /** How the card lists `layer`. */
+    private listing;
+    /** What the card calls a cluster no table names, from the label of its clause on this layer if it has one. */
+    private knownName;
+    /**
+     * What the card calls a cluster with a clause labelled `label`: the label, which is the cluster's
+     * key where a page served its row with a key and no name, else as a page served it, else Unnamed.
+     */
+    private clauseCalled;
+    /**
+     * The level a ranked list counts at. The overlap list counts at the level after its position's,
+     * and at the chosen or drawn level at the top.
+     */
+    private listLevel;
+    /**
+     * The rows a category or flat layer's card lists first, whatever their counts: those its clauses
+     * name. A card that steps shows its layer's clauses apart from its rows.
+     */
+    private pinned;
+    /** Point the browse pages at the position, with slots while the map is coloured by the layer, and fetch them where that moved. */
+    private browseIfStale;
+    /**
+     * The count of the position's items in none of its children, under every filter: a filter of its
+     * own holds the position's `member_of` and one `none_of` over the children. Asked only once every
+     * child has loaded.
+     */
+    private remainderSpec;
+    /** The filter that keeps an overlap list inside its position, where it has one. */
+    private within;
+    /** The keys of the field's clause in `verb`: a category's values, a bool's, or a layer's clusters by id. */
     private clauseKeys;
     /** The groupings a category or cluster card counts; the values its clauses name are always counted. */
     private rowGroupings;
-    /** The grouping ranking a layer's `top` clusters at the cut the map draws or the card's level; each row's slot colours its swatch. */
+    /** The grouping ranking a layer's `top` clusters at the cut the map draws or at {@link listLevel}; each row's slot colours its swatch. */
     private ranked;
-    /** The groupings counting `ids` of `layer` by name, leaving room for one more beside them. */
+    /** The groupings counting `ids` of `layer`, each at the level the list counts at, by name, leaving room for one more beside them. */
     private namedGroupings;
     /**
      * The values in view that the whole match's commonest values do not list, which a registration of
@@ -148,36 +311,114 @@ export declare class MosaicaFieldCard extends MosaicaElement {
      * answer is held for another store, as just after the card adopts a new one.
      */
     private outsideSpec;
-    /** The specs the card keeps registered: the subject's counts, the whole match's and a number's figures. */
+    /**
+     * The specs the card keeps registered: the subject's counts, the whole match's and a number's
+     * figures. They are read in a render as well, so the overlap list reads only the answers to what
+     * its position asks.
+     */
     private specs;
+    protected willUpdate(changed: PropertyValues<this>): void;
+    /** The deepest crumb's button. */
+    private deepestCrumb;
+    /**
+     * Give focus back where the render took it away. A row, crumb or chip that moved, as its value
+     * joined or left a clause, keeps it; for one that went, the same button of the row, crumb or chip
+     * now in its place takes it, else the one before's, else the search box, else the fold button of
+     * a card with none. Focus in the search box stays there. Just after a step, focus in the card
+     * goes to the deepest crumb until the rows land.
+     */
+    private keepFocus;
+    /**
+     * The keys of the rows a card that steps lists for its position, once they have landed; `null`
+     * while they are on their way.
+     */
+    private landed;
+    /**
+     * Once the rows of a step have landed, say what loaded, and once they are drawn move focus from
+     * the deepest crumb to the row stepped out of or, after a step in, to the first row. Focus that
+     * has gone elsewhere meanwhile stays there.
+     */
+    private land;
+    /** What a card that steps says has loaded: how many rows, of what. */
+    private loadedText;
     protected updated(changed: PropertyValues<this>): void;
-    /** A press outside an open range box closes it, as Escape does. */
+    /** A press outside an open range box closes it, as Escape does; Set range closes it itself. */
     private onPressOutsideBrush;
     /** Whether a highlight is set, in which case the subject is the highlighted items. */
     private highlighting;
     /** Put a category value in or out of the field's clause in `verb`. */
     private toggleValue;
+    /** Put a bool's value in or out of the field's clause in `verb`. */
+    private toggleBool;
     /** Replace the field's clause in `verb`, and report what that position composes. */
     private setClause;
     /** Put a cluster's `member_of` clause in `verb` on or off. */
     private toggleCluster;
+    /** Take one of this layer's clauses off. */
+    private removeClause;
+    /** Step into a cluster, so the card lists what is inside it. The filter is left as it is. */
+    private stepIn;
+    /** Step back to the crumb at `depth`, where 0 is All. */
+    private stepTo;
+    private stepped;
     /** Colour the map by this field, or by nothing where it already is. */
     private paint;
     private chooseLevel;
     private fold;
     render(): TemplateResult | typeof nothing;
-    /** A folded card's small chart: the subject's counts, largest first for values, in order for bins. */
+    /**
+     * A folded card's small chart: the subject's counts, largest first for values, in order for bins.
+     * A children list charts its first rows as it lists them.
+     */
     private spark;
     /**
-     * The rows of a category or cluster card: the values its clauses name, then the rest by their
-     * count in the subject, then in the whole match.
+     * The rows of a bool card, yes then no; or of a category or cluster card: the values its
+     * clauses name, then the rest by their count in the subject, then in the whole match.
      */
     private rows;
-    /** The name a cluster's clause carries, for a cluster no table lists. */
-    private clauseName;
+    /** Each row's count in `entry`: a bool's from its bins for false and true, else by each group's key. */
+    private counts;
     private valueCard;
+    /** The body of a category, bool or `flat` layer's card: the search box, the rows and More. */
+    private valueBody;
+    /**
+     * The body of a card that steps: the search box, the breadcrumb, the layer's clauses, the one
+     * status region, and the rows of the position with what follows them.
+     */
+    private clusterBody;
+    /** What an overlap list inside a position lists, which heads it; `null` at the top. */
+    private overlapTitle;
+    /**
+     * A list ranked by count: a category's or a bool's values, a flat layer's clusters, or the
+     * overlap; then what an empty answer says and the More that shows more rows. `values` is how
+     * many values or clusters the whole match has, where its answer says.
+     */
+    private rankedList;
+    /** The search box over a layer's clusters, which names how many there are where a count says. */
+    private clusterSearch;
+    /**
+     * One row of a category, bool or cluster card. `sub` and `all` are its two counts as drawn, or
+     * `drawn` alone in their place, and `said` gives them to a screen reader with what each counts.
+     * `step` is the button that steps into the row, `null` on a row of a card that steps with nothing
+     * to step into. A press on the row filters to its value or cluster, as its Filter button does;
+     * the keyboard reaches the buttons.
+     */
+    private rowTemplate;
+    /** The rows of a children list, in the server's order: each with its matched count over its masked one where a filter is set, else its masked count alone. */
+    private childRows;
+    /**
+     * The rows of a linked layer's position: its children, or the roots, grouped under their levels'
+     * headings on a `tiered` layer, with the remainder as the last list's last row; then More.
+     */
+    private childList;
+    /** The breadcrumb: All and then each step of the position, each a button that steps back to it. */
+    private crumbsTemplate;
+    /** The layer's clauses, in the order they were added, each with a × that removes it. */
+    private chipsTemplate;
+    /** Load the next page of children, and move focus from More to the first row it added, unless focus has gone elsewhere meanwhile. */
+    private moreChildren;
     private histogram;
-    /** Where the range's box stands: under the range, from its left end or, on the right half, its right, and never past the plot. */
+    /** Where the range box stands: under its range, from the range's left end or, on the right half, its right, and never past the plot. */
     private brushPlace;
     /** The figures in the heading: how many hold a value and their mean, or while folded their range. */
     private summaryText;
@@ -190,14 +431,29 @@ export declare class MosaicaFieldCard extends MosaicaElement {
      * value the viewer may see, so a range reaching the first or the last bin leaves that end open.
      */
     private brushRange;
-    private applyBrush;
+    /**
+     * Set the range box's range as the field's clause in `verb`. A field holding text that is no
+     * value, or a lower end above the upper, sets nothing: both fields show what is wrong with them,
+     * and the first that is wrong takes focus.
+     */
+    private applyRange;
+    /** Give focus back to the plot or to Set range, whichever opened the range box, unless the box is open again by then. */
+    private focusOpener;
     /** Which bin a pointer is over. */
     private binAt;
     private brushStart;
     private brushMove;
     private brushEnd;
-    /** The arrow keys move a one-bin range, Shift widens it, Enter opens its box and Escape drops it. */
+    /**
+     * The arrow keys move a one-bin range, Shift widens it and Escape drops it. Enter opens the range
+     * box, on that range or, with none chosen, on the range the field holds.
+     */
     private brushKey;
+    /**
+     * The box lies over what is under the plot, so it closes as focus goes on to that. Focus that
+     * goes to nothing has not left, and a box already taken off the page has nothing to close.
+     */
+    private onBrushLeft;
     private onBrushKey;
     /** Open the colour picker on a row's swatch: a category value's, or a cluster's. */
     private openPicker;