@fusion.dev/helix-core 0.187.0 → 0.189.0

package/dist/controllers/disabled-cascade-controller/disabled-cascade-controller.d.ts

@@ -38,8 +38,8 @@ type DisableableHost = ReactiveControllerHost & HTMLElement & {
  *
  * It adds no API. A group already has `disabled`, from `HelixFormElement` or
  * from the consumer; nothing here introduces a property or a method for anyone
- * to call. By this repo's own rule that makes it a controller and not a mixin:
- * it reacts to a lifecycle and nothing else.
+ * to call. Adding no API is what makes it a controller and not a mixin: it
+ * reacts to a lifecycle and nothing else.
  *
  * So a group states its members once, at construction, and never thinks about
  * it again:

package/dist/controllers/token-color-controller/token-color-controller.d.ts

@@ -22,8 +22,8 @@ export type TokenColor = [number, number, number];
  * written in next, which is the property worth having in a design system whose
  * palette is derived rather than listed.
  *
- * **A controller and not a mixin**, by this repository's own line: it adds no
- * property or method a consumer sets. It reacts to lifecycle, holding a probe
+ * **A controller and not a mixin**, because it adds no property or method a
+ * consumer sets. It reacts to lifecycle, holding a probe
  * that has to be created after the host connects and removed when it leaves,
  * and it watches for the color mode changing so the host can repaint.
  *

package/dist/events/details.d.ts

@@ -363,6 +363,18 @@ export interface GraphPartChangeDetail {
      */
     kind: 'data' | 'focus' | 'gestures';
 }
+/** Detail carried by `helix-plot-change`. */
+export interface PlotChangeDetail {
+    /** `data` for the points or the axes, which are drawn again; `focus` for the point the keys rest on. */
+    kind: 'data' | 'focus';
+}
+/** Detail carried by `helix-plot-turn`. */
+export interface PlotTurnDetail {
+    /** Steps to turn about the vertical, positive to the right. */
+    across: number;
+    /** Steps to tilt, positive to look from higher. */
+    up: number;
+}
 /** One signal between two notes, as the frame's `signal()` sends it. */
 export interface GraphSignalDetail {
     /** The note the signal leaves, by its `id`. */

package/dist/events/events.d.ts

@@ -91,6 +91,8 @@ import { HelixNextEvent } from './next.js';
 import { HelixPanelResizeEvent } from './panel-resize.js';
 import { HelixPastedEvent } from './pasted.js';
 import { HelixPinEvent } from './pin.js';
+import { HelixPlotChangeEvent } from './plot-change.js';
+import { HelixPlotTurnEvent } from './plot-turn.js';
 import { HelixPressEvent } from './press.js';
 import { HelixPreviewEvent } from './preview.js';
 import { HelixPreviousEvent } from './previous.js';
@@ -121,9 +123,9 @@ import { HelixToggleEvent } from './toggle.js';
 import { HelixTourAskEvent } from './tour-ask.js';
 import { HelixTourStatusEvent } from './tour-status.js';
 import { HelixTypingEvent } from './typing.js';
-export type { ActivateDetail, AuraFallbackDetail, BandDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DismissDetail, FacetDetail, FilterDetail, GraphFilterDetail, GraphLayoutDetail, GraphPartChangeDetail, GraphSignalDetail, MapClusterDetail, MapPanDetail, MapPartChangeDetail, MapRotateDetail, MapTiltDetail, MapZoomDetail, MoveDetail, NavigateDetail, OpenDetail, PasteDetail, PressDetail, PressPointerType, RangeDetail, ReadDetail, ReadingDetail, ReconnectDetail, Refusal, RefusedFile, RejectDetail, RelabelDetail, RemoveDetail, ReorderDetail, ResizeDetail, ScrolledDetail, SelectDetail, SendDetail, ShortcutDetail, SkipDetail, SortDetail, StrandsFallbackDetail, ToggleDetail, TourAskDetail, TourStatusDetail, TypingDetail, ViewportPanDetail, ViewportZoomDetail, } from './details.js';
+export type { ActivateDetail, AuraFallbackDetail, BandDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DismissDetail, FacetDetail, FilterDetail, GraphFilterDetail, GraphLayoutDetail, GraphPartChangeDetail, GraphSignalDetail, MapClusterDetail, MapPanDetail, MapPartChangeDetail, MapRotateDetail, MapTiltDetail, MapZoomDetail, MoveDetail, NavigateDetail, OpenDetail, PasteDetail, PlotChangeDetail, PlotTurnDetail, PressDetail, PressPointerType, RangeDetail, ReadDetail, ReadingDetail, ReconnectDetail, Refusal, RefusedFile, RejectDetail, RelabelDetail, RemoveDetail, ReorderDetail, ResizeDetail, ScrolledDetail, SelectDetail, SendDetail, ShortcutDetail, SkipDetail, SortDetail, StrandsFallbackDetail, ToggleDetail, TourAskDetail, TourStatusDetail, TypingDetail, ViewportPanDetail, ViewportZoomDetail, } from './details.js';
 export { helixEventNames } from './names.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
 /**
  * Every event class, and the one place a new one is registered: a class in a
  * module of its own, imported above, and named here and in `names.ts`.
@@ -200,6 +202,8 @@ declare const registry: {
     readonly HelixPanelResizeEvent: typeof HelixPanelResizeEvent;
     readonly HelixPastedEvent: typeof HelixPastedEvent;
     readonly HelixPinEvent: typeof HelixPinEvent;
+    readonly HelixPlotChangeEvent: typeof HelixPlotChangeEvent;
+    readonly HelixPlotTurnEvent: typeof HelixPlotTurnEvent;
     readonly HelixPressEvent: typeof HelixPressEvent;
     readonly HelixPreviewEvent: typeof HelixPreviewEvent;
     readonly HelixPreviousEvent: typeof HelixPreviousEvent;

package/dist/events/events.js

@@ -61,6 +61,8 @@ import { HelixNextEvent } from './next.js';
 import { HelixPanelResizeEvent } from './panel-resize.js';
 import { HelixPastedEvent } from './pasted.js';
 import { HelixPinEvent } from './pin.js';
+import { HelixPlotChangeEvent } from './plot-change.js';
+import { HelixPlotTurnEvent } from './plot-turn.js';
 import { HelixPressEvent } from './press.js';
 import { HelixPreviewEvent } from './preview.js';
 import { HelixPreviousEvent } from './previous.js';
@@ -92,7 +94,7 @@ import { HelixTourAskEvent } from './tour-ask.js';
 import { HelixTourStatusEvent } from './tour-status.js';
 import { HelixTypingEvent } from './typing.js';
 export { helixEventNames } from './names.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
 const registry = {
     HelixActionEvent,
     HelixActivateEvent,
@@ -157,6 +159,8 @@ const registry = {
     HelixPanelResizeEvent,
     HelixPastedEvent,
     HelixPinEvent,
+    HelixPlotChangeEvent,
+    HelixPlotTurnEvent,
     HelixPressEvent,
     HelixPreviewEvent,
     HelixPreviousEvent,

package/dist/events/names.js

@@ -5,7 +5,8 @@ export const helixEventNames = new Set(('action activate aura-fallback band befo
     'connect console copy copy-error create dismiss edit end expand facet filter ' +
     'filtered graph-filter graph-layout graph-pan graph-part-change graph-ready ' +
     'graph-signal graph-zoom history load load-more map-cluster map-pan map-part-change ' +
-    'map-ready map-rotate map-tilt map-zoom move navigate next panel-resize pasted pin press ' +
+    'map-ready map-rotate map-tilt map-zoom move navigate next panel-resize pasted pin plot-change ' +
+    'plot-turn press ' +
     'preview previous range-change read reading-change reading-press reconnect reject ' +
     'relabel remove reorder ' +
     'reordered resize resized sample-end sample-start scrolled select selected send ' +

package/dist/events/plot-change.d.ts

@@ -0,0 +1,10 @@
+import type { PlotChangeDetail } from './details.js';
+/**
+ * A plot's points or the point the keys rest on changed, which the connector
+ * hears and the renderer is told. It stays on the plot, being the family's
+ * own bookkeeping rather than news for a page.
+ */
+export declare class HelixPlotChangeEvent extends CustomEvent<PlotChangeDetail> {
+    static readonly eventName = "helix-plot-change";
+    constructor(detail: PlotChangeDetail);
+}

package/dist/events/plot-change.js

@@ -0,0 +1,11 @@
+export class HelixPlotChangeEvent extends CustomEvent {
+    static { this.eventName = 'helix-plot-change'; }
+    constructor(detail) {
+        super(HelixPlotChangeEvent.eventName, {
+            bubbles: false,
+            cancelable: false,
+            composed: false,
+            detail,
+        });
+    }
+}

package/dist/events/plot-turn.d.ts

@@ -0,0 +1,6 @@
+import type { PlotTurnDetail } from './details.js';
+/** The reader asked a 3D plot to turn by key: steps across and up, which the renderer turns by. */
+export declare class HelixPlotTurnEvent extends CustomEvent<PlotTurnDetail> {
+    static readonly eventName = "helix-plot-turn";
+    constructor(detail: PlotTurnDetail);
+}

package/dist/events/plot-turn.js

@@ -0,0 +1,11 @@
+export class HelixPlotTurnEvent extends CustomEvent {
+    static { this.eventName = 'helix-plot-turn'; }
+    constructor(detail) {
+        super(HelixPlotTurnEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}

package/dist/index.d.ts

@@ -38,7 +38,7 @@ export { UpgradeController, type UpgradeOptions, } from './controllers/upgrade-c
 export { type Rendered, VirtualizeController, type VirtualizeOptions, type Window as VirtualizeWindow, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { Waterfall } from './controllers/virtualize-controller/waterfall.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { type ActivateDetail, type AuraFallbackDetail, type BandDetail, type CanvasView, type CaretDetail, type ChangeDetail, type CompleteDetail, type ConnectDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, type GraphFilterDetail, type GraphLayoutDetail, type GraphPartChangeDetail, type GraphSignalDetail, HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type PasteDetail, type PressDetail, type PressPointerType, type RangeDetail, type ReadDetail, type ReadingDetail, type ReconnectDetail, type Refusal, type RefusedFile, type RejectDetail, type RelabelDetail, type RemoveDetail, type ReorderDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type StrandsFallbackDetail, type ToggleDetail, type TourStatusDetail, type TypingDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
+export { type ActivateDetail, type AuraFallbackDetail, type BandDetail, type CanvasView, type CaretDetail, type ChangeDetail, type CompleteDetail, type ConnectDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, type GraphFilterDetail, type GraphLayoutDetail, type GraphPartChangeDetail, type GraphSignalDetail, HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type PasteDetail, type PlotChangeDetail, type PlotTurnDetail, type PressDetail, type PressPointerType, type RangeDetail, type ReadDetail, type ReadingDetail, type ReconnectDetail, type Refusal, type RefusedFile, type RejectDetail, type RelabelDetail, type RemoveDetail, type ReorderDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type StrandsFallbackDetail, type ToggleDetail, type TourStatusDetail, type TypingDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { MIRROR_RULE, SCROLLER_RULE, SPOKEN_RULE, VIRTUAL_RULE, } from './helix-element/mark-rules.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
@@ -74,6 +74,7 @@ export { clockLocale, dayPeriod, type HourCycle, isTwelveHour, nearestTime, offe
 export { closestInstance } from './utils/closest-instance/closest-instance.js';
 export { type ColorWords, colorName, hueName } from './utils/color-name/color-name.js';
 export { columnStep } from './utils/column-step/column-step.js';
+export { contextBudget, type Holder, LIVE, pageBudget, } from './utils/context-budget/context-budget.js';
 export { countLabel } from './utils/count-label/count-label.js';
 export { createSheet } from './utils/create-sheet/create-sheet.js';
 export { type Color, type ColorFormat, formatColor, parseColor, toCss, toHsl, toOklch, toRgb, } from './utils/css-color/css-color.js';
@@ -119,6 +120,7 @@ export { applyOwnRule, type OwnRule } from './utils/own-rule/own-rule.js';
 export { plainClick } from './utils/plain-click/plain-click.js';
 export { appleTouch, onAndroid, onApple, type Platform } from './utils/platform/platform.js';
 export { pressType, type RecentPress } from './utils/press-type/press-type.js';
+export { type Camera, type Drawn, depthOrder, type Face, ISOMETRIC, LOWEST_TILT, type PagePoint, type Projection, pathData, projectionOf, type Solid, shortNumber, solid, } from './utils/projection/projection.js';
 export { rangeAdd } from './utils/range-add/range-add.js';
 export { type ColorBytes, type ColorBytesAlpha, readColor, readColorAlpha, rgbOf, } from './utils/read-color/read-color.js';
 export { type ChartData, type ChartDatum, rowsFromData, seriesFromData, } from './utils/read-data/read-data.js';

package/dist/index.js

@@ -38,7 +38,7 @@ export { UpgradeController, } from './controllers/upgrade-controller/upgrade-con
 export { VirtualizeController, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { Waterfall } from './controllers/virtualize-controller/waterfall.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, } from './events/events.js';
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { MIRROR_RULE, SCROLLER_RULE, SPOKEN_RULE, VIRTUAL_RULE, } from './helix-element/mark-rules.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
@@ -74,6 +74,7 @@ export { clockLocale, dayPeriod, isTwelveHour, nearestTime, offeredTimes, timeBa
 export { closestInstance } from './utils/closest-instance/closest-instance.js';
 export { colorName, hueName } from './utils/color-name/color-name.js';
 export { columnStep } from './utils/column-step/column-step.js';
+export { contextBudget, LIVE, pageBudget, } from './utils/context-budget/context-budget.js';
 export { countLabel } from './utils/count-label/count-label.js';
 export { createSheet } from './utils/create-sheet/create-sheet.js';
 export { formatColor, parseColor, toCss, toHsl, toOklch, toRgb, } from './utils/css-color/css-color.js';
@@ -119,6 +120,7 @@ export { applyOwnRule } from './utils/own-rule/own-rule.js';
 export { plainClick } from './utils/plain-click/plain-click.js';
 export { appleTouch, onAndroid, onApple } from './utils/platform/platform.js';
 export { pressType } from './utils/press-type/press-type.js';
+export { depthOrder, ISOMETRIC, LOWEST_TILT, pathData, projectionOf, shortNumber, solid, } from './utils/projection/projection.js';
 export { rangeAdd } from './utils/range-add/range-add.js';
 export { readColor, readColorAlpha, rgbOf, } from './utils/read-color/read-color.js';
 export { rowsFromData, seriesFromData, } from './utils/read-data/read-data.js';

package/dist/mixins/mixin-viewport/mixin-viewport.d.ts

@@ -128,9 +128,7 @@ export declare class ViewportElement {
  * first and its frame turned out to be a surface a reader can move, fill the
  * screen with, and stop touching: a canvas of notes and a graph of nodes want
  * the same four hundred lines, and the only thing that made them Map's was
- * being written there. Extracted before the second consumer rather than after,
- * which is the opposite of what [#383](queue.md) had to conclude about a
- * controller promoted ahead of one.
+ * being written there. Extracted before the second consumer arrived.
  *
  * **Nothing here moves anything, either.** Both controls ask, through an event
  * a family names, and the answer is the consumer's: the surface a reader is

package/dist/utils/context-budget/context-budget.d.ts

@@ -0,0 +1,47 @@
+/**
+ * How many WebGL contexts Helix's three.js drivers keep live on one page.
+ *
+ * **A browser holds only so many, and drops the oldest without asking**:
+ * Chrome about sixteen on a desktop and fewer on a phone. A page of 3D panels
+ * past that lost a graph it could not get back, and the maps, Aura, and
+ * Strands on the same page count against the same limit. Six leaves them
+ * room.
+ */
+export declare const LIVE = 6;
+/** One drawing that holds a context: it gives the context back, and takes it again. */
+export interface Holder {
+    release(): void;
+    restore(): void;
+}
+/**
+ * Keeps the contexts a page's drawings hold under `cap`.
+ *
+ * **A drawing near the screen always keeps its context.** Past the cap, the
+ * drawings off screen give theirs back, the one away longest first, and each
+ * takes its context again as it comes near. So a page of any number of
+ * graphs holds as many contexts as it shows at once, and never more than
+ * `cap` beyond that.
+ */
+export declare const contextBudget: (cap?: number) => {
+    /** A drawing far from the screen, from `now`. */
+    far(holder: Holder, now: number): void;
+    /** How many drawings hold a context now. */
+    readonly holding: number;
+    /** A new drawing, which made a context to draw with. */
+    join(holder: Holder): void;
+    /** A drawing that ended and freed its context itself. */
+    leave(holder: Holder): void;
+    /** A drawing near the screen, which takes its context again where it gave it back. */
+    near(holder: Holder): void;
+};
+type Budget = ReturnType<typeof contextBudget>;
+/**
+ * The budget every three.js driver on the page shares: the graph's and the
+ * plot's, whichever package and whichever copy of Helix each came from.
+ *
+ * **Kept on the page, under a registered symbol**, since a page can load two
+ * copies of this module, one bundled with each driver, and two budgets of six
+ * would let the page hold twelve.
+ */
+export declare const pageBudget: () => Budget;
+export {};

package/dist/utils/context-budget/context-budget.js

@@ -0,0 +1,48 @@
+export const LIVE = 6;
+export const contextBudget = (cap = LIVE) => {
+    const holding = new Set();
+    const away = new Map();
+    const balance = () => {
+        const longest = [...away]
+            .filter(([holder]) => holding.has(holder))
+            .sort((one, other) => one[1] - other[1]);
+        for (const [holder] of longest) {
+            if (holding.size <= cap) {
+                return;
+            }
+            holding.delete(holder);
+            holder.release();
+        }
+    };
+    return {
+        far(holder, now) {
+            away.set(holder, now);
+            balance();
+        },
+        get holding() {
+            return holding.size;
+        },
+        join(holder) {
+            holding.add(holder);
+            balance();
+        },
+        leave(holder) {
+            holding.delete(holder);
+            away.delete(holder);
+        },
+        near(holder) {
+            away.delete(holder);
+            if (!holding.has(holder)) {
+                holding.add(holder);
+                holder.restore();
+            }
+            balance();
+        },
+    };
+};
+export const pageBudget = () => {
+    const key = Symbol.for('fusion.dev/helix/context-budget');
+    const page = globalThis;
+    page[key] ??= contextBudget();
+    return page[key];
+};

package/dist/utils/create-sheet/create-sheet.d.ts

@@ -9,7 +9,7 @@ import { type CSSResult } from 'lit';
  *
  * The `unsafe` in `unsafeCSS` warns about interpolating untrusted input into a
  * stylesheet. That is not what happens here: the argument is a build-time
- * constant read from a file in this repo, never a runtime value. Wrapping it
+ * constant read from a file in the package, never a runtime value. Wrapping it
  * keeps the warning where it belongs, on `unsafeCSS` itself, and gives one seam
  * to change if constructable stylesheets become the better primitive.
  */

package/dist/utils/projection/projection.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Where a drawing in three dimensions stands on the page, seen from a camera
+ * that can turn and tilt, with no perspective, as SVG path data. Shared by
+ * every spatial drawing Helix makes in SVG: the graph's isometric diagram,
+ * the spatial heatmap, and the spatial charts' own drawings.
+ *
+ * Pure, so the arithmetic a picture hides is held by a spec: a solid painted
+ * in the wrong order is covered by the one it should cover, and a face turned
+ * away is drawn over the faces in front of it.
+ *
+ * **The floor is measured in cells.** A place at `x: 2, y: 1` stands two
+ * cells across and one back, and a height is in the same unit. From the
+ * isometric camera, across runs down to the right on the page and back runs
+ * up to the right, as a plan is seen from its front left corner.
+ */
+/** A point on the page, in cells. */
+export interface PagePoint {
+    x: number;
+    y: number;
+}
+/**
+ * Where the diagram is seen from, in degrees: `turn`, the compass bearing
+ * the camera looks from, and `tilt`, its height above the floor, from a low
+ * angle to 90, a plan seen straight down.
+ */
+export interface Camera {
+    tilt: number;
+    turn: number;
+}
+/**
+ * The isometric camera: from the front left corner, at the height where the
+ * floor's two axes and the vertical are drawn the same length, 35.26 degrees.
+ */
+export declare const ISOMETRIC: Camera;
+/** The lowest a camera may tilt, below which the floor folds to a line. */
+export declare const LOWEST_TILT = 15;
+/** A camera's view of the floor. */
+export interface Projection {
+    /** A place on the floor and a height, on the page. */
+    at(x: number, y: number, z?: number): PagePoint;
+    /** How near the camera a place on the floor stands: the larger, the nearer. */
+    depth(x: number, y: number): number;
+    /** The place on the floor drawn at a point on the page. */
+    floorAt(point: PagePoint): PagePoint;
+    /** Toward the camera from the floor, a unit length: across, back, and up. */
+    toward: readonly [number, number, number];
+    /** Across the page, in floor directions: how far a step across or back goes to the right. */
+    across: readonly [number, number];
+}
+/**
+ * The view from `camera`, an orthographic one: the floor turned by `turn`
+ * and seen from `tilt` above it, with no perspective, so a cell is the same
+ * size wherever it stands.
+ */
+export declare const projectionOf: (camera: Camera) => Projection;
+/** The solids a note can be drawn as, a block, a cylinder, or a pyramid. */
+export type Solid = 'block' | 'cylinder' | 'pyramid';
+/** A number written short enough for path data, and never as `-0`. */
+export declare const shortNumber: (value: number) => string;
+export declare const pathData: (points: readonly PagePoint[]) => string;
+/** One face of a solid, as path data, and how far it is darkened toward black. */
+export interface Face {
+    d: string;
+    /** From 0, the note's own color, as a top facing the light takes it. */
+    darken: number;
+}
+/** One note drawn as a solid: the faces the camera sees, in the order to paint them. */
+export interface Drawn {
+    /** How high the solid reaches on the page: the top of its outline, which its name is drawn above. */
+    crown: number;
+    /** The faces the camera sees, the sides first and the top last. */
+    faces: Face[];
+    /** The outline of the whole solid, which a ring is drawn along. */
+    outline: string;
+    /** The middle of the solid's top, which its name is centered over. */
+    peak: PagePoint;
+}
+/**
+ * A note as a solid, standing on the floor at `x` and `y`, `width` cells
+ * across its footprint and `height` cells tall, as the camera sees it.
+ *
+ * **Each face is drawn only where it turns toward the camera**, so a block
+ * shows its top and the two sides that face the viewer from any turn, and a
+ * plan seen from straight above shows tops alone.
+ */
+export declare const solid: (projection: Projection, kind: Solid, x: number, y: number, width: number, height: number) => Drawn;
+/**
+ * The order to paint notes in, back to front: by how near the camera each
+ * stands on the floor, and the taller first where two stand level.
+ *
+ * Exact for notes on whole cells, which do not overlap on the floor; two
+ * notes placed inside one cell can still cross.
+ */
+export declare const depthOrder: <T extends {
+    height: number;
+    x: number;
+    y: number;
+}>(projection: Projection, notes: readonly T[]) => T[];

package/dist/utils/projection/projection.js

@@ -0,0 +1,144 @@
+export const ISOMETRIC = { tilt: (Math.atan(Math.SQRT1_2) * 180) / Math.PI, turn: 45 };
+export const LOWEST_TILT = 15;
+const SCALE = Math.sqrt(1.5);
+export const projectionOf = (camera) => {
+    const turn = (camera.turn * Math.PI) / 180;
+    const tilt = (Math.min(Math.max(camera.tilt, LOWEST_TILT), 90) * Math.PI) / 180;
+    const [cos, sin] = [Math.cos(turn), Math.sin(turn)];
+    const [rise, fall] = [Math.sin(tilt), Math.cos(tilt)];
+    return {
+        across: [cos, sin],
+        at: (x, y, z = 0) => ({
+            x: (x * cos + y * sin) * SCALE,
+            y: ((x * sin - y * cos) * rise - z * fall) * SCALE,
+        }),
+        depth: (x, y) => x * sin - y * cos,
+        floorAt: (point) => {
+            const u = point.x / SCALE;
+            const v = point.y / SCALE / rise;
+            return { x: u * cos + v * sin, y: u * sin - v * cos };
+        },
+        toward: [sin * fall, -cos * fall, rise],
+    };
+};
+export const shortNumber = (value) => String(Math.round(value * 1000) / 1000 || 0);
+export const pathData = (points) => `M${points.map((point) => `${shortNumber(point.x)} ${shortNumber(point.y)}`).join('L')}Z`;
+const hullOf = (points) => {
+    const sorted = [...points].sort((one, other) => one.x - other.x || one.y - other.y);
+    if (sorted.length < 3) {
+        return sorted;
+    }
+    const cross = (o, a, b) => (a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x);
+    const half = (list) => {
+        const kept = [];
+        for (const point of list) {
+            while (kept.length >= 2 &&
+                cross(kept.at(-2), kept.at(-1), point) <= 0) {
+                kept.pop();
+            }
+            kept.push(point);
+        }
+        kept.pop();
+        return kept;
+    };
+    return [...half(sorted), ...half([...sorted].reverse())];
+};
+const darkenOf = (normal, projection) => {
+    const [x, y, z] = normal;
+    const length = Math.hypot(x, y, z) || 1;
+    const level = Math.hypot(x, y) || 1;
+    const right = (x * projection.across[0] + y * projection.across[1]) / level;
+    return Math.max(0, 0.28 + 0.113 * right) * (1 - z / length);
+};
+const facing = (normal, projection) => normal[0] * projection.toward[0] +
+    normal[1] * projection.toward[1] +
+    normal[2] * projection.toward[2] >
+    1e-6;
+const ARC = 12;
+export const solid = (projection, kind, x, y, width, height) => {
+    const half = width / 2;
+    const tall = Math.max(0, height);
+    const on = (corner) => projection.at(corner[0], corner[1], corner[2]);
+    if (kind === 'cylinder') {
+        const turn = Math.atan2(projection.across[1], projection.across[0]);
+        const rim = (z, from, to) => Array.from({ length: ARC + 1 }, (_, step) => {
+            const angle = from + ((to - from) * step) / ARC;
+            return projection.at(x + Math.cos(angle) * half, y + Math.sin(angle) * half, z);
+        });
+        const near = rim(0, turn + Math.PI, turn + 2 * Math.PI);
+        const nearTop = rim(tall, turn + Math.PI, turn + 2 * Math.PI);
+        const farTop = rim(tall, turn, turn + Math.PI);
+        const top = rim(tall, 0, 2 * Math.PI).slice(0, -1);
+        const side = projection.toward[2] < 0.9999 && tall > 0;
+        const outline = hullOf([...farTop, ...nearTop, ...near]);
+        return {
+            crown: Math.min(...outline.map((point) => point.y)),
+            faces: [
+                ...(side ? [{ d: pathData([...nearTop, ...[...near].reverse()]), darken: 0.28 }] : []),
+                { d: pathData(top), darken: 0 },
+            ],
+            outline: pathData(outline),
+            peak: projection.at(x, y, tall),
+        };
+    }
+    const floor = [
+        [x - half, y - half, 0],
+        [x + half, y - half, 0],
+        [x + half, y + half, 0],
+        [x - half, y + half, 0],
+    ];
+    const outward = [
+        [0, -1, 0],
+        [1, 0, 0],
+        [0, 1, 0],
+        [-1, 0, 0],
+    ];
+    const faces = [];
+    let corners;
+    let peak;
+    if (kind === 'pyramid') {
+        const apex = [x, y, Math.max(tall, width)];
+        corners = [...floor, apex];
+        peak = on(apex);
+        floor.forEach((corner, at) => {
+            const next = floor[(at + 1) % 4];
+            const [ox, oy] = outward[at];
+            const normal = [ox * apex[2], oy * apex[2], half];
+            if (facing(normal, projection)) {
+                faces.push({
+                    d: pathData([on(corner), on(next), on(apex)]),
+                    darken: darkenOf(normal, projection),
+                });
+            }
+        });
+    }
+    else {
+        const up = (corner) => [corner[0], corner[1], tall];
+        corners = [...floor, ...floor.map(up)];
+        peak = projection.at(x, y, tall);
+        if (tall > 0) {
+            floor.forEach((corner, at) => {
+                const next = floor[(at + 1) % 4];
+                const normal = outward[at];
+                if (facing(normal, projection)) {
+                    faces.push({
+                        d: pathData([on(up(corner)), on(up(next)), on(next), on(corner)]),
+                        darken: darkenOf(normal, projection),
+                    });
+                }
+            });
+        }
+        faces.push({ d: pathData(floor.map(up).map(on)), darken: 0 });
+    }
+    const outline = hullOf(corners.map(on));
+    return {
+        crown: Math.min(...outline.map((point) => point.y)),
+        faces,
+        outline: pathData(outline),
+        peak,
+    };
+};
+export const depthOrder = (projection, notes) => [...notes].sort((one, other) => {
+    const nearer = projection.depth(one.x, one.y) - projection.depth(other.x, other.y);
+    return Math.abs(nearer) > 1e-9 ? nearer : other.height - one.height;
+});

package/dist/utils/report-runtime/report-runtime.d.ts

@@ -61,6 +61,8 @@ export type RuntimeKind =
  | 'negative-value'
 /** A Graph connector was handed an element that is no Graph frame. */
  | 'not-a-graph'
+/** A plot connector was handed an element that is not the spatial chart it connects. */
+ | 'not-a-plot'
 /** The browser refused picture in picture. */
  | 'picture-in-picture-refused'
 /** A Grid's `min` is no length it can write, so the grid lays out by its column count. */

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  * release, so the two never disagree; a spec beside this holds them to it.
  * Nothing else in the running code knows which release it is.
  */
-export declare const VERSION = "0.187.0";
+export declare const VERSION = "0.189.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.187.0';
+export const VERSION = '0.189.0';