@fusion.dev/helix 0.58.0 → 0.59.0

package/custom-elements.json

@@ -2782,7 +2782,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -3656,7 +3656,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -4291,15 +4291,6 @@
               "default": "{ alpha: true, antialias: false, depth: false, powerPreference: 'low-power', stencil: false, }",
               "description": "What every context is asked for, here rather than at two call sites."
             },
-            {
-              "kind": "field",
-              "name": "frame",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0"
-            },
             {
               "kind": "field",
               "name": "elapsed",
@@ -4309,15 +4300,6 @@
               "privacy": "private",
               "default": "0"
             },
-            {
-              "kind": "field",
-              "name": "last",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0"
-            },
             {
               "kind": "field",
               "name": "width",
@@ -4393,29 +4375,11 @@
             },
             {
               "kind": "field",
-              "name": "motion",
-              "type": {
-                "text": "MediaQueryList | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "visible",
-              "type": {
-                "text": "IntersectionObserver | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "onScreen",
-              "type": {
-                "text": "boolean"
-              },
+              "name": "gate",
               "privacy": "private",
-              "default": "false",
-              "description": "What the intersection observer last said, kept because it says so only on\na change: every other path to `play` has to ask it."
+              "readonly": true,
+              "default": "new PaintGateController(this, { canRun: () => !!this.gl && !this.gl.isContextLost() && this.width > 0 && this.opened, onFrame: (delta) => { this.advance(delta) }, onMotion: (reduced) => { /* The still frame is drawn rather than assumed, because the canvas holds whatever was on it when the loop stopped and mid-drift is not the opening shape. `Orb` does the same, on the same two arms. */ if (reduced) { this.paintOnce() } }, onResize: () => { this.resized() }, })",
+              "description": "Whether anybody is looking, and the loop that draws for them.\n\n**Four reasons to refuse a frame that the gate cannot know**: a context it\nwas never given, one the browser has taken, a drawing buffer no measurement\nhas sized, and an opening frame still owed. The first two draw nothing at\nall and the last two draw at the wrong scale, which `measure` and `opened`\neach have their own note about."
             },
             {
               "kind": "field",
@@ -4427,15 +4391,6 @@
               "default": "{ height: 1, left: 0, top: 0, width: 1 }",
               "description": "The element's box, cached.\n\n**Never read per event.** `getBoundingClientRect` forces a synchronous\nlayout, and a pointer emits events far faster than the display refreshes: a\n1000Hz mouse flushed layout a thousand times a second to compute a number\nthat only changes when the page reflows. Refreshed from the resize observer\nand from scroll, both of which are exactly when it can go stale, and never\nfrom the handler that reads it."
             },
-            {
-              "kind": "field",
-              "name": "sized",
-              "type": {
-                "text": "ResizeObserver | undefined"
-              },
-              "privacy": "private",
-              "description": "Watches the element's own size, so no frame has to ask for it."
-            },
             {
               "kind": "field",
               "name": "opened",
@@ -4522,7 +4477,7 @@
               "name": "handleLost",
               "privacy": "private",
               "readonly": true,
-              "description": "Stops for a context the browser has taken, and asks for it back.\n\n**Taken on a GPU reset, and past the cap** of about sixteen, where the\nbrowser drops the oldest context for the newest while its aura is still on\nscreen. `tick` books its own next frame, so the loop went on at 30 frames a\nsecond against a context that draws nothing, and nothing made the program\nagain once the context came back: the aura never recovered.\n\n**The canvas is hidden until then, because a lost one is not reliably\ntransparent.** Measured 15 Sep 2026: headless Chromium painted a plain\ncanvas white with a broken-image glyph in its corner, force-lost and on a\ncrashed GPU process alike, while this one came out clear there and on\nMetal, and the landing page once held a spent one's last frame (`build`\nhas it). Hidden, it shows what a machine with no WebGL is shown, the host's\ngradient, whatever the engine does with a lost canvas.\n\n`preventDefault` is the asking: a browser restores only a context whose\nloss was canceled."
+              "description": "Stops for a context the browser has taken, and asks for it back.\n\n**Taken on a GPU reset, and past the cap** of about sixteen, where the\nbrowser drops the oldest context for the newest while its aura is still on\nscreen. Unstopped, the loop runs at 30 frames a second against a context\nthat draws nothing, and nothing makes the program again once the context\ncomes back: the aura never recovers.\n\n**The canvas is hidden until then, because a lost one is not reliably\ntransparent.** Measured 15 Sep 2026: headless Chromium painted a plain\ncanvas white with a broken-image glyph in its corner, force-lost and on a\ncrashed GPU process alike, while this one came out clear there and on\nMetal, and the landing page once held a spent one's last frame (`build`\nhas it). Hidden, it shows what a machine with no WebGL is shown, the host's\ngradient, whatever the engine does with a lost canvas.\n\n`preventDefault` is the asking: a browser restores only a context whose\nloss was canceled."
             },
             {
               "kind": "field",
@@ -4575,7 +4530,7 @@
                   "text": "boolean"
                 }
               },
-              "description": "Re-reads the box and resizes the drawing buffer to match.\n\n**Called from the observer, never from the frame.** `clientWidth` is a\nlayout read, and doing it in `tick` meant a forced synchronous layout on\nevery single frame to learn a number that changes when the box changes and\nat no other time. A `ResizeObserver` is told when that is.\n\nReturns whether the drawing buffer was resized, which is the same question\nas whether it was cleared, and so whether the caller owes it a frame."
+              "description": "Re-reads the box and resizes the drawing buffer to match.\n\n**Called from the observer, never from the frame.** `clientWidth` is a\nlayout read, and doing it per frame meant a forced synchronous layout on\nevery single frame to learn a number that changes when the box changes and\nat no other time. The gate's `ResizeObserver` is told when that is.\n\nReturns whether the drawing buffer was resized, which is the same question\nas whether it was cleared, and so whether the caller owes it a frame."
             },
             {
               "kind": "method",
@@ -4587,6 +4542,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "resized",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The box changed, which is the one moment the buffer is re-measured.\n\n**A resize repaints unconditionally rather than asking.** `measure` clears\nthe drawing buffer whenever it resizes it, because assigning `canvas.width`\nis a reset and not a hint. `paintOnce` declines while the loop holds a\nframe, which is right for a property change the loop is about to draw\nanyway and wrong here: the canvas is already transparent by the time it\ndeclines, so the fallback gradient underneath showed through until the next\nframe landed. One frame, on every reflow that changed the box."
+            },
             {
               "kind": "method",
               "name": "open",
@@ -4615,34 +4581,35 @@
               "privacy": "private",
               "static": true,
               "readonly": true,
-              "description": "The shortest gap between two painted frames, for a field nobody points at.\n\n**A drifting field does not need the display's rate and a pointer does.**\n`tick` advances on `(now - this.last) / 1000`, so motion is wall-clock: at\nhalf the frames the field moves the same distance in the same time, sampled\nmore coarsely. `delta` is already clamped at 0.05, which is a floor of 20\nframes a second, and 30 sits inside that with room. A cap at 15 would land\non the clamp and the field would genuinely drag, which is the failure that\nwould be misdiagnosed as choppiness.\n\n**`interactive` is the exception and it is the whole exception.** The\nelement eases `presence` toward the pointer on a 50ms rise constant, so at\n33ms a frame the entire response is one or two samples and the follow reads\nas a lag rather than a lightness. Every field on the landing page leaves\n`interactive` unset; the only one that sets it is the lab on\n`/helix/aura`, where it is a toggle a reader chose. So the cap applies where\nnothing is being followed and lifts where something is.\n\n**The cost scales with the count.** Three fields run on the landing page,\none per transparent run, and with the frame limiter off they drew 2,654\ntimes in three seconds against 1,276 for one: each instance draws once per\ncallback. Capping the two that nobody points at is most of that back."
+              "description": "The shortest gap between two painted frames, in seconds, for a field nobody\npoints at.\n\n**A drifting field does not need the display's rate and a pointer does.**\nThe field advances on the gate's own step, so motion is wall-clock: at half\nthe frames it moves the same distance in the same time, sampled more\ncoarsely. That step is clamped at `MAX_FRAME_STEP`, which is a floor of 20\nframes a second, and 30 sits inside that with room. A cap at 15 would land\non the clamp and the field would genuinely drag, which is the failure that\nwould be misdiagnosed as choppiness.\n\n**`interactive` is the exception and it is the whole exception.** The\nelement eases `presence` toward the pointer on a 50ms rise constant, so at\n33ms a frame the entire response is one or two samples and the follow reads\nas a lag rather than a lightness. Every field on the landing page leaves\n`interactive` unset; the only one that sets it is the lab on\n`/helix/aura`, where it is a toggle a reader chose. So the cap applies where\nnothing is being followed and lifts where something is.\n\n**The cost scales with the count.** Three fields run on the landing page,\none per transparent run, and with the frame limiter off they drew 2,654\ntimes in three seconds against 1,276 for one: each instance draws once per\ncallback. Capping the two that nobody points at is most of that back."
             },
             {
               "kind": "field",
-              "name": "tick",
+              "name": "held",
+              "type": {
+                "text": "number"
+              },
               "privacy": "private",
-              "readonly": true
+              "default": "0",
+              "description": "What the skipped frames were worth, in seconds, spent on the next one drawn.\n\nDropping it instead would make the field move at a fraction of wall-clock\nspeed, which is the thing the cap is written not to do: a capped frame is\nthe same motion sampled more coarsely and not less motion. Held rather than\nmeasured from a stamp, because the gate owns the clock."
             },
             {
               "kind": "method",
-              "name": "play",
+              "name": "advance",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "description": "Starts the loop, where it is wanted and can be ended.\n\n**Never while detached.** `tick` books its own next frame, so the only\nthing that ends the loop is `stop`, and a disconnection is the last time\n`stop` is called. Everything that plays is canceled or disconnected there,\nand this holds for whatever callback was already on its way.\n\n**Nor off screen, whoever asks.** The observer is the one caller that\nknows, and a tab coming back, a resize and a restored context all play\ntoo. An aura 2600 pixels below the fold booked no frame at rest and one on\nevery frame after its tab came back, until it had been scrolled in and out\nagain. Nor on a lost context, which draws nothing."
-            },
-            {
-              "kind": "method",
-              "name": "stop",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
+              "parameters": [
+                {
+                  "name": "delta",
+                  "type": {
+                    "text": "number"
+                  }
                 }
-              }
+              ]
             },
             {
               "kind": "field",
@@ -4726,19 +4693,6 @@
               "privacy": "private",
               "readonly": true
             },
-            {
-              "kind": "field",
-              "name": "handleMotion",
-              "privacy": "private",
-              "readonly": true,
-              "description": "Answers the preference changing, rather than only its value at setup.\n\n**The query was created and never listened to**, so the preference was read\nat `play` and at the pointer and nowhere else. `tick` books its own next\nframe with no check of its own, which means a reader who turned reduce-motion\non while the page was open kept a full-page shader running for the rest of\nit: the one reader the promise at the top of this file is about, and the one\nit was broken for. The other direction failed the quieter way, a field frozen\non its opening frame until a scroll or a tab switch happened to ask again.\n\nThe still frame is drawn rather than assumed, because the canvas holds\nwhatever was on it when the loop stopped and mid-drift is not the opening\nshape. `Orb` does the same, on the same two arms."
-            },
-            {
-              "kind": "field",
-              "name": "handleVisibility",
-              "privacy": "private",
-              "readonly": true
-            },
             {
               "kind": "field",
               "name": "handleScroll",
@@ -7404,7 +7358,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -8253,7 +8207,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -11252,7 +11206,7 @@
                   "text": "HTMLElement | null"
                 }
               },
-              "description": "The element this button commands, or nothing.\n\nLooked up in the button's own root rather than in the document, so a button\ninside somebody else's shadow root finds a target in that same root and not\na coincidence in the page.",
+              "description": "The element this button commands, or nothing.",
               "inheritedFrom": {
                 "name": "HelixHeadlessButton",
                 "module": "src/button/root/button-root.ts"
@@ -25208,7 +25162,7 @@
                 "text": "string[]"
               },
               "privacy": "private",
-              "description": "The presets, as written, with anything that is not a color dropped.",
+              "description": "The presets, as written, with anything that is not a color dropped.\n\nSplit on the commas between colors and never inside one, so\n`rgba(34,197,94,.5)` stays one swatch rather than four fragments none of\nwhich parses.",
               "readonly": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessColorPicker",
@@ -30579,7 +30533,7 @@
                   "text": "HTMLElement | null"
                 }
               },
-              "description": "The element this button commands, or nothing.\n\nLooked up in the button's own root rather than in the document, so a button\ninside somebody else's shadow root finds a target in that same root and not\na coincidence in the page.",
+              "description": "The element this button commands, or nothing.",
               "inheritedFrom": {
                 "name": "HelixHeadlessButton",
                 "module": "src/button/root/button-root.ts"
@@ -41720,7 +41674,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -42371,7 +42325,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -54734,7 +54688,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -55003,7 +54957,7 @@
                 "text": "boolean"
               },
               "privacy": "private",
-              "description": "Whether this render can tell a table with no readings from one it has not\nresolved yet.\n\n**Unknown is not empty, which is what an empty state must never say.**\n`for` names an id and resolving an id wants a document, so a server has\nnone and a hydrating render must not look either. Without this the server\ndrew \"No readings\" over a table holding ninety days of them, a crawler read\nthat sentence, and the strip flipped to a full one on hydration: the fault\n`MixinCollection` names for a slotted collection, arriving through the one\nchannel that mixin cannot see.\n\nThe same shape as `childrenKnown`, asked of a document rather than of a\ntree. An id that resolves to nothing in a browser is still known, and still\nempty: a `for` naming no table should say so rather than sit blank.",
+              "description": "Whether this render can tell a table with no readings from one it has not\nresolved yet.\n\n**Unknown is not empty, which is what an empty state must never say.**\n`for` names an id and resolving an id wants a document, so a server has\nnone and a hydrating render must not look either. Without this the server\ndrew \"No readings\" over a table holding ninety days of them, a crawler read\nthat sentence, and the strip flipped to a full one on hydration: the fault\n`MixinCollection` names for a slotted collection, arriving through the one\nchannel that mixin cannot see.\n\nThe same shape as `childrenKnown`, asked of a tree that can answer about\nids rather than of one that holds children. An id that resolves to nothing\nin a browser is still known, and still empty: a `for` naming no table\nshould say so rather than sit blank, which is why this asks\n`searchableById` and not `elementById`.",
               "readonly": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessHeatmap",
@@ -55511,7 +55465,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -56075,7 +56029,7 @@
                   "text": "HTMLElement | null"
                 }
               },
-              "description": "The element this button commands, or nothing.\n\nLooked up in the button's own root rather than in the document, so a button\ninside somebody else's shadow root finds a target in that same root and not\na coincidence in the page.",
+              "description": "The element this button commands, or nothing.",
               "inheritedFrom": {
                 "name": "HelixHeadlessButton",
                 "module": "src/button/root/button-root.ts"
@@ -61747,7 +61701,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to take the names from.\n\nResolved through `getRootNode()`, so a legend inside another component's\nshadow root names a table in that root rather than in the document.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to take the names from.\n\nNames a table in the same tree, so a legend inside another component's\nshadow root reads a table in that root rather than one in the document.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "HelixHeadlessLegend",
@@ -62172,7 +62126,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to take the names from.\n\nResolved through `getRootNode()`, so a legend inside another component's\nshadow root names a table in that root rather than in the document.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to take the names from.\n\nNames a table in the same tree, so a legend inside another component's\nshadow root reads a table in that root rather than one in the document.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "HelixHeadlessLegend",
@@ -62444,7 +62398,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -63276,7 +63230,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -79826,54 +79780,11 @@
             },
             {
               "kind": "field",
-              "name": "motion",
-              "type": {
-                "text": "MediaQueryList | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "visible",
-              "type": {
-                "text": "IntersectionObserver | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "sized",
-              "type": {
-                "text": "ResizeObserver | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "frame",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0"
-            },
-            {
-              "kind": "field",
-              "name": "running",
-              "type": {
-                "text": "boolean"
-              },
+              "name": "gate",
               "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "onScreen",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
+              "readonly": true,
+              "default": "new PaintGateController(this, { canRun: () => !!this.context && !this.lost, onFrame: (delta) => { this.paint(delta) }, onMotion: (reduced) => { if (reduced) { this.phase = STILL_PHASE this.morphAt = 0 this.paint(0) } }, onResize: () => { this.measure() this.paint(0) }, })",
+              "description": "Whether anybody is looking, and the loop that draws for them.\n\nA context it has not been given and one the browser has taken are both\nreasons to draw nothing that the gate cannot see, so they are said here.\n\nEvery frame paints: a settled orb has movement of its own in every state,\nand only the gate's own three answers stop it."
             },
             {
               "kind": "field",
@@ -79933,15 +79844,6 @@
                 "text": "number"
               }
             },
-            {
-              "kind": "field",
-              "name": "last",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0"
-            },
             {
               "kind": "method",
               "name": "start",
@@ -80004,38 +79906,6 @@
                 }
               }
             },
-            {
-              "kind": "method",
-              "name": "play",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "stop",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "tick",
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "handleVisibility",
-              "privacy": "private",
-              "readonly": true
-            },
             {
               "kind": "field",
               "name": "handleLost",
@@ -80050,12 +79920,6 @@
               "readonly": true,
               "description": "Draws again on the canvas the browser gave back.\n\n**Sized again, because it comes back in its default state.** Found 15 Sep\n2026 by crashing the GPU process under headless Chromium: the transform\n`measure` sets came back the identity, and `measure` sets it only when the\nbox changes. At twice the density that is an orb drawn at half its size in\nthe top left corner, for as long as the box holds still."
             },
-            {
-              "kind": "field",
-              "name": "handleMotion",
-              "privacy": "private",
-              "readonly": true
-            },
             {
               "kind": "method",
               "name": "paint",
@@ -81084,7 +80948,7 @@
                 "text": "{ link: HTMLAnchorElement; target: Element }[]"
               },
               "privacy": "private",
-              "description": "What each link points at, paired with the link, skipping anything missing.",
+              "description": "What each link points at, paired with the link, skipping anything missing.\n\nThe fragment is decoded first because these are `href`s and not ids. The\nlookup is the tree's alone: this intercepts no press, so it has no\nnavigation to agree with, and a section it cannot see is one it is not\ndescribing.",
               "readonly": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessOutline",
@@ -96798,7 +96662,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -97480,7 +97344,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -101264,7 +101128,7 @@
                 "text": "HTMLElement | null"
               },
               "privacy": "private",
-              "description": "The element `href` names, looked up in the tree this link sits in.",
+              "description": "The element `href` names, looked up the way the browser would.\n\n`orDocument`, which no other caller of `elementById` passes and which that\noption is written for: a press handled here has to land where following the\nanchor would, and the platform resolves a fragment against the document\nwhatever tree the anchor is in. A skip link inside an app shell's shadow\nroot pointing at the page's `#main` is the arrangement that needs it.\n\nThe fragment is decoded first because this is an `href` and not an id.",
               "readonly": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessSkipLink",
@@ -128415,7 +128279,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the element this describes, in this tooltip's own tree.\n\nSet it and the tooltip stops wrapping: it renders no trigger, listens on\nthe element it names, and points its bubble there. Leave it unset and the\ndefault slot is the trigger, which is the older form.\n\nResolved through `getRootNode()`, so a tooltip inside another component's\nshadow root names an element in that root rather than in the document.\n\n**In React this arrives as a property and not as an attribute**, which is\nworth knowing before someone reads the DOM and thinks it did not take.\nMeasured against React 19.2.8: `for` exists on the prototype, so React sets\n`element.for = 'save'` and writes nothing to the markup, where `content`\nand `placement`, which are not properties on the class at that moment, come\nthrough as attributes. Both paths reach the same place through Lit, so\nnothing is broken by it; a `[for]` selector would find nothing, which is\nwhy this does not reflect and nothing styles on it.",
+              "description": "The id of the element this describes, in this tooltip's own tree.\n\nSet it and the tooltip stops wrapping: it renders no trigger, listens on\nthe element it names, and points its bubble there. Leave it unset and the\ndefault slot is the trigger, which is the older form.\n\nNames an element in the same tree, so a tooltip inside another component's\nshadow root points at one in that root rather than one in the document.\n\n**In React this arrives as a property and not as an attribute**, which is\nworth knowing before someone reads the DOM and thinks it did not take.\nMeasured against React 19.2.8: `for` exists on the prototype, so React sets\n`element.for = 'save'` and writes nothing to the markup, where `content`\nand `placement`, which are not properties on the class at that moment, come\nthrough as attributes. Both paths reach the same place through Lit, so\nnothing is broken by it; a `[for]` selector would find nothing, which is\nwhy this does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "HelixHeadlessTooltip",
@@ -128554,7 +128418,7 @@
                 "text": "HTMLElement | null"
               },
               "privacy": "private",
-              "description": "The element `for` names, or null.\n\n`getRootNode()` rather than `document`, which is what makes this work inside\nanother component: an id is unique to a tree, and a tooltip in a shadow root\nnames an element in that root. Client only, since the server has no tree to\nsearch.",
+              "description": "The element `for` names, or null.",
               "readonly": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessTooltip",
@@ -129229,7 +129093,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the element this describes, in this tooltip's own tree.\n\nSet it and the tooltip stops wrapping: it renders no trigger, listens on\nthe element it names, and points its bubble there. Leave it unset and the\ndefault slot is the trigger, which is the older form.\n\nResolved through `getRootNode()`, so a tooltip inside another component's\nshadow root names an element in that root rather than in the document.\n\n**In React this arrives as a property and not as an attribute**, which is\nworth knowing before someone reads the DOM and thinks it did not take.\nMeasured against React 19.2.8: `for` exists on the prototype, so React sets\n`element.for = 'save'` and writes nothing to the markup, where `content`\nand `placement`, which are not properties on the class at that moment, come\nthrough as attributes. Both paths reach the same place through Lit, so\nnothing is broken by it; a `[for]` selector would find nothing, which is\nwhy this does not reflect and nothing styles on it.",
+              "description": "The id of the element this describes, in this tooltip's own tree.\n\nSet it and the tooltip stops wrapping: it renders no trigger, listens on\nthe element it names, and points its bubble there. Leave it unset and the\ndefault slot is the trigger, which is the older form.\n\nNames an element in the same tree, so a tooltip inside another component's\nshadow root points at one in that root rather than one in the document.\n\n**In React this arrives as a property and not as an attribute**, which is\nworth knowing before someone reads the DOM and thinks it did not take.\nMeasured against React 19.2.8: `for` exists on the prototype, so React sets\n`element.for = 'save'` and writes nothing to the markup, where `content`\nand `placement`, which are not properties on the class at that moment, come\nthrough as attributes. Both paths reach the same place through Lit, so\nnothing is broken by it; a `[for]` selector would find nothing, which is\nwhy this does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "HelixHeadlessTooltip",