@fusion.dev/helix-core 0.187.0 → 0.189.0

package/custom-elements.json

@@ -1758,7 +1758,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Pushes a group's `disabled` onto its members, on every update, unasked.\n\n**The cascade itself is `inheritDisabled`, and this is what makes it\nautomatic.** Called by hand it runs only when whichever method holds the call\nruns, so a group whose items changed by some other path leaves them holding\nthe last answer, and a group that forgets the call gets no cascade at all\nwith nothing to say so: the property exists, the attribute reflects, and the\nmembers simply ignore it. That is invisible in review and shows up only when\nsomeone disables a set.\n\nIt adds no API. A group already has `disabled`, from `HelixFormElement` or\nfrom the consumer; nothing here introduces a property or a method for anyone\nto call. By this repo's own rule that makes it a controller and not a mixin:\nit reacts to a lifecycle and nothing else.\n\nSo a group states its members once, at construction, and never thinks about\nit again:\n\n    new DisabledCascadeController(this, { items: () => this.items })\n\n**Runs after every render, and on every `slotchange`.** The second half is\nnot an extra: a member arriving in the light DOM changes no property, so Lit\nschedules nothing, and a render-only cascade leaves a member slotted into an\nalready-disabled group enabled. Measured before it was added, on a radio\ngroup holding two disabled members with a third inserted: `110`, and the\nthird was live in a set nobody could use.\n\nThe listener is on the render root rather than on the host, because\n`slotchange` bubbles but is not composed: it reaches the shadow root that\nowns the slot and stops there. On the host it would never fire at all.\n\nAfter render rather than before, because the items are read from the DOM and\na newly slotted member is not there until the render that assigns it.\n\nIdempotent, so running on every update costs a comparison per member and\nnothing else: `inheritDisabled` writes only where the answer changed and\nremembers what each member said for itself, which is what lets a group be\nre-enabled without freeing a member that was disabled on its own.",
+          "description": "Pushes a group's `disabled` onto its members, on every update, unasked.\n\n**The cascade itself is `inheritDisabled`, and this is what makes it\nautomatic.** Called by hand it runs only when whichever method holds the call\nruns, so a group whose items changed by some other path leaves them holding\nthe last answer, and a group that forgets the call gets no cascade at all\nwith nothing to say so: the property exists, the attribute reflects, and the\nmembers simply ignore it. That is invisible in review and shows up only when\nsomeone disables a set.\n\nIt adds no API. A group already has `disabled`, from `HelixFormElement` or\nfrom the consumer; nothing here introduces a property or a method for anyone\nto call. Adding no API is what makes it a controller and not a mixin: it\nreacts to a lifecycle and nothing else.\n\nSo a group states its members once, at construction, and never thinks about\nit again:\n\n    new DisabledCascadeController(this, { items: () => this.items })\n\n**Runs after every render, and on every `slotchange`.** The second half is\nnot an extra: a member arriving in the light DOM changes no property, so Lit\nschedules nothing, and a render-only cascade leaves a member slotted into an\nalready-disabled group enabled. Measured before it was added, on a radio\ngroup holding two disabled members with a third inserted: `110`, and the\nthird was live in a set nobody could use.\n\nThe listener is on the render root rather than on the host, because\n`slotchange` bubbles but is not composed: it reaches the shadow root that\nowns the slot and stops there. On the host it would never fire at all.\n\nAfter render rather than before, because the items are read from the DOM and\na newly slotted member is not there until the render that assigns it.\n\nIdempotent, so running on every update costs a comparison per member and\nnothing else: `inheritDisabled` writes only where the answer changed and\nremembers what each member said for itself, which is what lets a group be\nre-enabled without freeing a member that was disabled on its own.",
           "name": "DisabledCascadeController",
           "members": [
             {
@@ -5524,7 +5524,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Reads a design token as the sRGB triple a shader or a 2D canvas can take, and\ntells the host when the palette underneath it moves.\n\n**Two hops, and both are load-bearing.** A custom property's own value is the\nunevaluated function text, so `getComputedStyle` on a probe is the only way\nto see what it resolves to. The second hop is `readColor`, which is shared\nwith every other caller that has a resolved color and needs channels: what it\nresolves to is not `rgb()`, the\npalette derives from an `oklch()` seed, and Chrome answers `lab(100 0 0)` for\nwhite. Parsing that with a regular expression for numbers reads the three\nchannels as 100, 0 and 0, which divided by 255 is a dark red.\n\nA screenshot cannot catch that: a warm cast on a saturated gradient is also\nwhat chroma subsampling produces, so the picture agrees with the bug.\n\nThe conversion is therefore the browser's own: fill a pixel and read it back.\nThat holds for `lab()`, `oklch()`, `color-mix()` and whatever a token is\nwritten in next, which is the property worth having in a design system whose\npalette is derived rather than listed.\n\n**A controller and not a mixin**, by this repository's own line: it adds no\nproperty or method a consumer sets. It reacts to lifecycle, holding a probe\nthat has to be created after the host connects and removed when it leaves,\nand it watches for the color mode changing so the host can repaint.\n\n**Client only, and that is the contract rather than a limitation.** There is\nno computed style on a server and no canvas to convert with, so `read`\nanswers the fallback there. Every caller is drawing into a canvas, which does\nnot exist on a server either.",
+          "description": "Reads a design token as the sRGB triple a shader or a 2D canvas can take, and\ntells the host when the palette underneath it moves.\n\n**Two hops, and both are load-bearing.** A custom property's own value is the\nunevaluated function text, so `getComputedStyle` on a probe is the only way\nto see what it resolves to. The second hop is `readColor`, which is shared\nwith every other caller that has a resolved color and needs channels: what it\nresolves to is not `rgb()`, the\npalette derives from an `oklch()` seed, and Chrome answers `lab(100 0 0)` for\nwhite. Parsing that with a regular expression for numbers reads the three\nchannels as 100, 0 and 0, which divided by 255 is a dark red.\n\nA screenshot cannot catch that: a warm cast on a saturated gradient is also\nwhat chroma subsampling produces, so the picture agrees with the bug.\n\nThe conversion is therefore the browser's own: fill a pixel and read it back.\nThat holds for `lab()`, `oklch()`, `color-mix()` and whatever a token is\nwritten in next, which is the property worth having in a design system whose\npalette is derived rather than listed.\n\n**A controller and not a mixin**, because it adds no property or method a\nconsumer sets. It reacts to lifecycle, holding a probe\nthat has to be created after the host connects and removed when it leaves,\nand it watches for the color mode changing so the host can repaint.\n\n**Client only, and that is the contract rather than a limitation.** There is\nno computed style on a server and no canvas to convert with, so `read`\nanswers the fallback there. Every caller is drawing into a canvas, which does\nnot exist on a server either.",
           "name": "TokenColorController",
           "members": [
             {
@@ -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",
@@ -25062,7 +25338,7 @@
         },
         {
           "kind": "mixin",
-          "description": "Grafts a pan-and-zoom surface: its controls, its keys, and the way out.\n\n**Nothing here is geographic, which is why it is here.** `Map` was written\nfirst and its frame turned out to be a surface a reader can move, fill the\nscreen with, and stop touching: a canvas of notes and a graph of nodes want\nthe same four hundred lines, and the only thing that made them Map's was\nbeing written there. Extracted before the second consumer rather than after,\nwhich is the opposite of what [#383](queue.md) had to conclude about a\ncontroller promoted ahead of one.\n\n**Nothing here moves anything, either.** Both controls ask, through an event\na family names, and the answer is the consumer's: the surface a reader is\nlooking at belongs to them, whether it is a tile renderer, a canvas or a\nforce layout. A mixin that moved the view would have to know what the view\nwas.\n\n**The controls are buttons, and that is a decision against arrow keys.** They\nwork too, but what a screen reader does with them is not ours to decide:\nmacOS passes them through, Windows readers hold them for their own reading\nmode unless a page takes `role=\"application\"`, which costs the reader their\nnormal way of reading everything else. A button is findable and operable in\nevery screen reader on every platform without that bargain.\n\n**What stays in the family is `render()`, its slots and its part\ndocumentation**, because a part named through an interpolation is one the\nmanifest cannot see: a loop over the four pan buttons would publish `pan-`\nand a consumer's `::part(pan-up)` would match nothing.",
+          "description": "Grafts a pan-and-zoom surface: its controls, its keys, and the way out.\n\n**Nothing here is geographic, which is why it is here.** `Map` was written\nfirst and its frame turned out to be a surface a reader can move, fill the\nscreen with, and stop touching: a canvas of notes and a graph of nodes want\nthe same four hundred lines, and the only thing that made them Map's was\nbeing written there. Extracted before the second consumer arrived.\n\n**Nothing here moves anything, either.** Both controls ask, through an event\na family names, and the answer is the consumer's: the surface a reader is\nlooking at belongs to them, whether it is a tile renderer, a canvas or a\nforce layout. A mixin that moved the view would have to know what the view\nwas.\n\n**The controls are buttons, and that is a decision against arrow keys.** They\nwork too, but what a screen reader does with them is not ours to decide:\nmacOS passes them through, Windows readers hold them for their own reading\nmode unless a page takes `role=\"application\"`, which costs the reader their\nnormal way of reading everything else. A button is findable and operable in\nevery screen reader on every platform without that bargain.\n\n**What stays in the family is `render()`, its slots and its part\ndocumentation**, because a part named through an interpolation is one the\nmanifest cannot see: a loop over the four pan buttons would publish `pan-`\nand a consumer's `::part(pan-up)` would match nothing.",
           "name": "MixinViewport",
           "members": [
             {
@@ -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",
@@ -28172,7 +28513,7 @@
               }
             }
           ],
-          "description": "Builds a stylesheet from CSS authored in a `.css` file.\n\nComponent styles live in real `.css` files rather than `css` tagged\ntemplates, so they get CSS tooling: syntax highlighting, formatters, the\ntoken linter, and a diff that reads as CSS. `turbo run styles` compiles each\none into a sibling `.css.ts` that calls this.\n\nThe `unsafe` in `unsafeCSS` warns about interpolating untrusted input into a\nstylesheet. That is not what happens here: the argument is a build-time\nconstant read from a file in this repo, never a runtime value. Wrapping it\nkeeps the warning where it belongs, on `unsafeCSS` itself, and gives one seam\nto change if constructable stylesheets become the better primitive."
+          "description": "Builds a stylesheet from CSS authored in a `.css` file.\n\nComponent styles live in real `.css` files rather than `css` tagged\ntemplates, so they get CSS tooling: syntax highlighting, formatters, the\ntoken linter, and a diff that reads as CSS. `turbo run styles` compiles each\none into a sibling `.css.ts` that calls this.\n\nThe `unsafe` in `unsafeCSS` warns about interpolating untrusted input into a\nstylesheet. That is not what happens here: the argument is a build-time\nconstant read from a file in the package, never a runtime value. Wrapping it\nkeeps the warning where it belongs, on `unsafeCSS` itself, and gives one seam\nto change if constructable stylesheets become the better primitive."
         }
       ],
       "exports": [
@@ -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.187.0'",
+          "default": "'0.189.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.187.0"
+    "version": "0.189.0"
   }
 }