@fusion.dev/helix-core 0.188.0 → 0.190.0

package/custom-elements.json

@@ -8738,6 +8738,22 @@
             "module": "./details.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "PlotChangeDetail",
+          "declaration": {
+            "name": "PlotChangeDetail",
+            "module": "./details.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PlotTurnDetail",
+          "declaration": {
+            "name": "PlotTurnDetail",
+            "module": "./details.js"
+          }
+        },
         {
           "kind": "js",
           "name": "PressDetail",
@@ -9458,6 +9474,22 @@
             "module": "src/events/events.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixPlotChangeEvent",
+          "declaration": {
+            "name": "HelixPlotChangeEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixPlotTurnEvent",
+          "declaration": {
+            "name": "HelixPlotTurnEvent",
+            "module": "src/events/events.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixPressEvent",
@@ -10546,7 +10578,7 @@
           "type": {
             "text": "ReadonlySet<string>"
           },
-          "default": "new Set( ( 'action activate aura-fallback band before-activate before-change before-close ' + 'before-collapse before-edit before-move before-open before-panel-resize before-paste before-pin ' + 'before-reconnect before-relabel before-reorder before-resize before-split before-toggle ' + 'canvas-edit canvas-pan canvas-view canvas-zoom caret clear collapse complete ' + '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 ' + '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 ' + 'shortcut sort sorted split strands-fallback toggle tour-ask tour-status typing' ) .split(' ') .map((name) => `helix-${name}`), )",
+          "default": "new Set( ( 'action activate aura-fallback band before-activate before-change before-close ' + 'before-collapse before-edit before-move before-open before-panel-resize before-paste before-pin ' + 'before-reconnect before-relabel before-reorder before-resize before-split before-toggle ' + 'canvas-edit canvas-pan canvas-view canvas-zoom caret clear collapse complete ' + '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 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 ' + 'shortcut sort sorted split strands-fallback toggle tour-ask tour-status typing' ) .split(' ') .map((name) => `helix-${name}`), )",
           "description": "Every name this library dispatches.\n\nExported so a runtime check can ask whether a name is one of ours without\nkeeping a second list of them. `HelixElement` uses it to tell a consumer that\nthe handler prop they wrote is attached to nothing.\n\n**Written as strings, in a module of its own, and not read off the\nclasses in `registry`.** Every element carries this set through its React\nprop audit, and a set read off the classes kept every class alive in every\nbundle: a Badge shipped all eighty of them. As strings, a family ships the\nclasses it dispatches and no others. `events.pure.spec.ts` holds this list to\nthe classes, so a class added without its name here fails.\n\n**Without the shared `helix-`, and separated by spaces.** Every element carries this\nlist, and as quoted strings each paid its quotes, its comma and the prefix."
         }
       ],
@@ -10751,6 +10783,82 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/events/plot-change.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A plot's points or the point the keys rest on changed, which the connector\nhears and the renderer is told. It stays on the plot, being the family's\nown bookkeeping rather than news for a page.",
+          "name": "HelixPlotChangeEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-plot-change'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/plot-change.ts"
+          },
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixPlotChangeEvent",
+          "declaration": {
+            "name": "HelixPlotChangeEvent",
+            "module": "src/events/plot-change.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/events/plot-turn.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "The reader asked a 3D plot to turn by key: steps across and up, which the renderer turns by.",
+          "name": "HelixPlotTurnEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-plot-turn'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/plot-turn.ts"
+          },
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixPlotTurnEvent",
+          "declaration": {
+            "name": "HelixPlotTurnEvent",
+            "module": "src/events/plot-turn.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/events/press.ts",
@@ -15583,6 +15691,22 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixPlotChangeEvent",
+          "declaration": {
+            "name": "HelixPlotChangeEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixPlotTurnEvent",
+          "declaration": {
+            "name": "HelixPlotTurnEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixPressEvent",
@@ -15903,6 +16027,22 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "PlotChangeDetail",
+          "declaration": {
+            "name": "PlotChangeDetail",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PlotTurnDetail",
+          "declaration": {
+            "name": "PlotTurnDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "PressDetail",
@@ -17015,6 +17155,38 @@
             "module": "./utils/column-step/column-step.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "contextBudget",
+          "declaration": {
+            "name": "contextBudget",
+            "module": "./utils/context-budget/context-budget.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Holder",
+          "declaration": {
+            "name": "Holder",
+            "module": "./utils/context-budget/context-budget.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LIVE",
+          "declaration": {
+            "name": "LIVE",
+            "module": "./utils/context-budget/context-budget.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "pageBudget",
+          "declaration": {
+            "name": "pageBudget",
+            "module": "./utils/context-budget/context-budget.js"
+          }
+        },
         {
           "kind": "js",
           "name": "countLabel",
@@ -17847,6 +18019,110 @@
             "module": "./utils/press-type/press-type.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "Camera",
+          "declaration": {
+            "name": "Camera",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Drawn",
+          "declaration": {
+            "name": "Drawn",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "depthOrder",
+          "declaration": {
+            "name": "depthOrder",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Face",
+          "declaration": {
+            "name": "Face",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ISOMETRIC",
+          "declaration": {
+            "name": "ISOMETRIC",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LOWEST_TILT",
+          "declaration": {
+            "name": "LOWEST_TILT",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PagePoint",
+          "declaration": {
+            "name": "PagePoint",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Projection",
+          "declaration": {
+            "name": "Projection",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "pathData",
+          "declaration": {
+            "name": "pathData",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "projectionOf",
+          "declaration": {
+            "name": "projectionOf",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Solid",
+          "declaration": {
+            "name": "Solid",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "shortNumber",
+          "declaration": {
+            "name": "shortNumber",
+            "module": "./utils/projection/projection.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "solid",
+          "declaration": {
+            "name": "solid",
+            "module": "./utils/projection/projection.js"
+          }
+        },
         {
           "kind": "js",
           "name": "rangeAdd",
@@ -28102,6 +28378,71 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/context-budget/context-budget.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "LIVE",
+          "type": {
+            "text": "number"
+          },
+          "default": "6",
+          "description": "How many WebGL contexts Helix's three.js drivers keep live on one page.\n\n**A browser holds only so many, and drops the oldest without asking**:\nChrome about sixteen on a desktop and fewer on a phone. A page of 3D panels\npast that lost a graph it could not get back, and the maps, Aura, and\nStrands on the same page count against the same limit. Six leaves them\nroom."
+        },
+        {
+          "kind": "function",
+          "name": "contextBudget",
+          "parameters": [
+            {
+              "name": "cap",
+              "default": "LIVE",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Keeps the contexts a page's drawings hold under `cap`.\n\n**A drawing near the screen always keeps its context.** Past the cap, the\ndrawings off screen give theirs back, the one away longest first, and each\ntakes its context again as it comes near. So a page of any number of\ngraphs holds as many contexts as it shows at once, and never more than\n`cap` beyond that."
+        },
+        {
+          "kind": "function",
+          "name": "pageBudget",
+          "return": {
+            "type": {
+              "text": "Budget"
+            }
+          },
+          "description": "The budget every three.js driver on the page shares: the graph's and the\nplot's, whichever package and whichever copy of Helix each came from.\n\n**Kept on the page, under a registered symbol**, since a page can load two\ncopies of this module, one bundled with each driver, and two budgets of six\nwould let the page hold twelve."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LIVE",
+          "declaration": {
+            "name": "LIVE",
+            "module": "src/utils/context-budget/context-budget.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "contextBudget",
+          "declaration": {
+            "name": "contextBudget",
+            "module": "src/utils/context-budget/context-budget.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "pageBudget",
+          "declaration": {
+            "name": "pageBudget",
+            "module": "src/utils/context-budget/context-budget.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/count-label/count-label.ts",
@@ -31544,6 +31885,213 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/projection/projection.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "ISOMETRIC",
+          "type": {
+            "text": "Camera"
+          },
+          "default": "{ tilt: (Math.atan(Math.SQRT1_2) * 180) / Math.PI, turn: 45 }",
+          "description": "The isometric camera: from the front left corner, at the height where the\nfloor's two axes and the vertical are drawn the same length, 35.26 degrees."
+        },
+        {
+          "kind": "variable",
+          "name": "LOWEST_TILT",
+          "type": {
+            "text": "number"
+          },
+          "default": "15",
+          "description": "The lowest a camera may tilt, below which the floor folds to a line."
+        },
+        {
+          "kind": "function",
+          "name": "projectionOf",
+          "return": {
+            "type": {
+              "text": "Projection"
+            }
+          },
+          "parameters": [
+            {
+              "name": "camera",
+              "type": {
+                "text": "Camera"
+              }
+            }
+          ],
+          "description": "The view from `camera`, an orthographic one: the floor turned by `turn`\nand seen from `tilt` above it, with no perspective, so a cell is the same\nsize wherever it stands."
+        },
+        {
+          "kind": "function",
+          "name": "shortNumber",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "A number written short enough for path data, and never as `-0`."
+        },
+        {
+          "kind": "function",
+          "name": "pathData",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "points",
+              "type": {
+                "text": "readonly PagePoint[]"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "solid",
+          "return": {
+            "type": {
+              "text": "Drawn"
+            }
+          },
+          "parameters": [
+            {
+              "name": "projection",
+              "type": {
+                "text": "Projection"
+              }
+            },
+            {
+              "name": "kind",
+              "type": {
+                "text": "Solid"
+              }
+            },
+            {
+              "name": "x",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "y",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "width",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "height",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "A note as a solid, standing on the floor at `x` and `y`, `width` cells\nacross its footprint and `height` cells tall, as the camera sees it.\n\n**Each face is drawn only where it turns toward the camera**, so a block\nshows its top and the two sides that face the viewer from any turn, and a\nplan seen from straight above shows tops alone."
+        },
+        {
+          "kind": "function",
+          "name": "depthOrder",
+          "return": {
+            "type": {
+              "text": "T[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "projection",
+              "type": {
+                "text": "Projection"
+              }
+            },
+            {
+              "name": "notes",
+              "type": {
+                "text": "readonly T[]"
+              }
+            }
+          ],
+          "description": "The order to paint notes in, back to front: by how near the camera each\nstands on the floor, and the taller first where two stand level.\n\nExact for notes on whole cells, which do not overlap on the floor; two\nnotes placed inside one cell can still cross."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ISOMETRIC",
+          "declaration": {
+            "name": "ISOMETRIC",
+            "module": "src/utils/projection/projection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LOWEST_TILT",
+          "declaration": {
+            "name": "LOWEST_TILT",
+            "module": "src/utils/projection/projection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "projectionOf",
+          "declaration": {
+            "name": "projectionOf",
+            "module": "src/utils/projection/projection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "shortNumber",
+          "declaration": {
+            "name": "shortNumber",
+            "module": "src/utils/projection/projection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "pathData",
+          "declaration": {
+            "name": "pathData",
+            "module": "src/utils/projection/projection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "solid",
+          "declaration": {
+            "name": "solid",
+            "module": "src/utils/projection/projection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "depthOrder",
+          "declaration": {
+            "name": "depthOrder",
+            "module": "src/utils/projection/projection.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/range-add/range-add.ts",
@@ -35683,7 +36231,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.188.0'",
+          "default": "'0.190.0'",
           "description": "The version of the package this file ships in.\n\n**Written by `fusion/scripts/version.mjs`** wherever it writes the package's\n`package.json`, and stamped back into the repository beside it after a\nrelease, so the two never disagree; a spec beside this holds them to it.\nNothing else in the running code knows which release it is."
         }
       ],
@@ -36319,6 +36867,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.188.0"
+    "version": "0.190.0"
   }
 }

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/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/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.188.0";
+export declare const VERSION = "0.190.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.188.0';
+export const VERSION = '0.190.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.188.0",
+  "version": "0.190.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -74,12 +74,12 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.188.0",
+    "@fusion.dev/helix-icons": "0.190.0",
     "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.188.0",
-    "@fusion.dev/helix-testing": "0.188.0",
+    "@fusion.dev/helix-cem": "0.190.0",
+    "@fusion.dev/helix-testing": "0.190.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },