@fusion.dev/helix-core 0.144.0 → 0.145.0

package/custom-elements.json

@@ -889,6 +889,161 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/countdown-controller/countdown-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A lifetime that pauses: a message that dismisses itself after a time, and\nholds that time while a reader is on it.\n\nToast's items and Announcement each dismiss themselves after `duration`,\nand each stops the clock while the pointer or focus is on the message, so a\nreader partway through is not cut off. Resuming continues from what was\nleft rather than starting over.\n\n**Holds are counted, not flagged.** Hover and focus stop the same clock and\nare independent: a pointer can leave while focus stays. Uncounted, a reader\nwho tabs into a message and then moves the pointer off it has the clock\nrestarted underneath them. Only the last one out starts it again.\n\n**Leaving the page pauses it**, keeping the time already spent, and drops\nthe holds, since a pointer or focus on a detached element never leaves it.\nComing back does not resume on its own: the host says whether it should,\nsuch as only while it is still showing. `DelayController` is the other wait\nin core, for a wait that starts over and forgets itself on leaving.",
+          "name": "CountdownController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "startedAt",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "description": "When the current run began, or nothing while the clock is stopped."
+            },
+            {
+              "kind": "field",
+              "name": "remaining",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "description": "What is left of the time, so resuming continues rather than restarts."
+            },
+            {
+              "kind": "field",
+              "name": "timer",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "holds",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "How many reasons there are to hold the clock."
+            },
+            {
+              "kind": "field",
+              "name": "running",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the clock is running now.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "hostConnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "start",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "ms",
+                  "type": {
+                    "text": "number | undefined"
+                  }
+                }
+              ],
+              "description": "Starts the clock at `ms`. Nothing, zero or less starts nothing."
+            },
+            {
+              "kind": "method",
+              "name": "pause",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Stops the clock and keeps the time that is left."
+            },
+            {
+              "kind": "method",
+              "name": "resume",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Runs the clock again from where it stopped."
+            },
+            {
+              "kind": "method",
+              "name": "cancel",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Stops the clock where it is, as a dismissal does."
+            },
+            {
+              "kind": "method",
+              "name": "hold",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "One more reason to hold the clock, such as a pointer arriving."
+            },
+            {
+              "kind": "method",
+              "name": "release",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "One reason fewer, and the clock runs again once none is left."
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CountdownController",
+          "declaration": {
+            "name": "CountdownController",
+            "module": "src/controllers/countdown-controller/countdown-controller.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/controllers/cue-controller/cue-controller.ts",
@@ -2406,13 +2561,12 @@
             },
             {
               "kind": "field",
-              "name": "origin",
+              "name": "originOf",
               "type": {
-                "text": "'focus' | 'selection'"
+                "text": "() => KeyboardOrigin"
               },
               "privacy": "private",
-              "readonly": true,
-              "default": "origin"
+              "readonly": true
             },
             {
               "kind": "field",
@@ -2461,6 +2615,16 @@
               "readonly": true,
               "default": "new Typeahead()"
             },
+            {
+              "kind": "field",
+              "name": "origin",
+              "type": {
+                "text": "'focus' | 'selection'"
+              },
+              "privacy": "private",
+              "description": "Where this press starts from, read again on every press.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "arrive",
@@ -4217,7 +4381,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Works out which slice of a long set is worth rendering.\n\n**A controller and not an element, which is the whole reason it is here.**\nTable, Listbox, Combobox and Tree each need windowing *inside* themselves,\nand an element would make each of them nest one in its own shadow root: a\nlistbox whose options are inside a `<helix-virtual-list>` is a listbox whose\noptions are no longer its children, so its own keyboard, its own selection\nand its own ARIA all have a stranger in the middle of them.\n\n**A windowed set still reports its true length, and each row its true\nposition.** This is the part virtualization usually gets wrong and the reason\nthe arithmetic lives somewhere shared. A reader on row 4,000 of 10,000 must\nhear \"4,000 of 10,000\", so `aria-setsize` is the count and `aria-posinset` is\nthe real index, never the position within the rendered slice. The window is a\nrendering decision and the set is a fact, and a component that lets the first\noverwrite the second has told a screen reader the list is twelve long.\n\n**The spacers are what make the scrollbar honest.** Rendering twelve rows in\na box that should scroll for ten thousand gives a thumb the size of the\ntrack, so the room the absent rows would have taken is left as padding before\nand after. A reader dragging that thumb is dragging against the real length.\n\n**What it does not do, and the reason is narrower than it first looks.** True\nvirtualization means never creating the rows that are not on screen, and that\nneeds the set as *data*. Two channels are shut: a consumer's items arrive as\nlight-DOM children, which exist by the time this could decide not to create\nthem, and an `items` property cannot survive React hydration, which skips\nevery property it would have to apply imperatively (see `bindReactHandler`,\nand the note in the rules that objects and functions have that bug and are\nnot fixed).\n\n**A third channel is open.** Data as *text*\nin the markup, a `<script type=\"application/json\">` child or an attribute, is\nneither a property nor a node per row: React's hydration bug cannot touch text\nit renders as a child, a server emits it, and the node count is one. The\ncharts already read data out of the document this way, `for=\"<id>\"` at a real\n`<table>`, so the pattern is in the library rather than being invented for\nthis.\n\nSo the thing actually blocked is the *row template*. Turning an item into\nmarkup wants either a render function, which is a function property and dies\non the same bug, or a `<template>` with named holes, which survives because it\nis markup and which no component here asks anyone to write. That is a decision\nabout what this library is willing to look like, not a platform limit, and it\nis open at #71.\n\nSo what this buys is the expensive half rather than all of it: the rows\noutside the window are not laid out and not painted, which is where the time\ngoes in a long list, and the node count stays. That is worth having and it is\nnot worth calling something it is not. An element that windows children it\nwas handed is not a virtual list, whatever it is named.\n\n**One estimate, not per-row measurement.** Measuring every row to place it is\nhow a virtual list ends up reading the layout it is trying to avoid, and it\nis what makes them jump: a row taller than its estimate shifts everything\nafter it at the moment it renders. A fixed estimate is a straight line\nbetween scroll offset and index, which never disagrees with itself. Rows of\ngenuinely different heights are a different component and a harder one.",
+          "description": "Works out which slice of a long set is worth rendering.\n\n**A controller and not an element, which is the whole reason it is here.**\nTable, Listbox, Combobox and Tree each need windowing *inside* themselves,\nand an element would make each of them nest one in its own shadow root: a\nlistbox whose options are inside a `<helix-virtual-list>` is a listbox whose\noptions are no longer its children, so its own keyboard, its own selection\nand its own ARIA all have a stranger in the middle of them.\n\n**A windowed set still reports its true length, and each row its true\nposition.** This is the part virtualization usually gets wrong and the reason\nthe arithmetic lives somewhere shared. A reader on row 4,000 of 10,000 must\nhear \"4,000 of 10,000\", so `aria-setsize` is the count and `aria-posinset` is\nthe real index, never the position within the rendered slice. The window is a\nrendering decision and the set is a fact, and a component that lets the first\noverwrite the second has told a screen reader the list is twelve long.\n\n**The spacers are what make the scrollbar honest.** Rendering twelve rows in\na box that should scroll for ten thousand gives a thumb the size of the\ntrack, so the room the absent rows would have taken is left as padding before\nand after. A reader dragging that thumb is dragging against the real length.\n\n**The set arrives as data**, which is what lets a host create only the rows\nin the window. A host takes it through a property (an `items` array, which\n`applyReactProperties` carries across React hydration with every other object\nproperty) or as text in the markup (a `<script type=\"application/json\">`\nnamed by `for`, which a server emits and which is one node whatever the\nrow count). A host that is handed its rows as light-DOM children still gets\nthe expensive half from this: the rows outside the window are not laid out\nand not painted, and the node count stays.\n\n**One estimate, not per-row measurement.** Measuring every row to place it is\nhow a virtual list ends up reading the layout it is trying to avoid, and it\nis what makes them jump: a row taller than its estimate shifts everything\nafter it at the moment it renders. A fixed estimate is a straight line\nbetween scroll offset and index, which never disagrees with itself. Rows of\ngenuinely different heights are a different component and a harder one.",
           "name": "VirtualizeController",
           "members": [
             {
@@ -4440,6 +4604,45 @@
               ],
               "description": "The measured version, which asks where each item starts rather than dividing.\n\nThe scan for `last` walks forward from `first` rather than searching,\nbecause it stops at the bottom of the viewport: it is bounded by what fits\non screen plus the overscan, whatever the set's length."
             },
+            {
+              "kind": "method",
+              "name": "visible",
+              "return": {
+                "type": {
+                  "text": "{ first: number; last: number }"
+                }
+              },
+              "description": "The items on screen, with no overscan: `first` is the item at the top of\nthe box and `last` is one past the item at its bottom, so\n`items.slice(first, last)` is what a reader sees.\n\nFor a host that reports what is visible, where `window` is what is drawn.\nAn empty span (`first === last`) while the box has no height or the set\nno items."
+            },
+            {
+              "kind": "method",
+              "name": "remaining",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "description": "How much of the set lies below the bottom of the box, in pixels.\n\nFor a host that asks for more items as a reader nears the end. Read from\nthe arithmetic and not from `scrollHeight`, which also counts whatever the\nhost draws around the rows."
+            },
+            {
+              "kind": "method",
+              "name": "spacers",
+              "return": {
+                "type": {
+                  "text": "{ after: number; before: number }"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "kept",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The two spacers' heights for the window, with item `kept` drawn too.\n\nFor a host that keeps an item outside the window drawn, the row holding\nfocus say. The item takes its own room out of the spacer on its side, so\nthe scrollbar still measures the set. Every host that keeps a focused row\nasks this, so the arithmetic is written once."
+            },
             {
               "kind": "method",
               "name": "hostUpdated",
@@ -4504,9 +4707,34 @@
                 {
                   "name": "inset",
                   "default": "0"
+                },
+                {
+                  "name": "{ align = 'nearest', behavior }",
+                  "default": "{}",
+                  "type": {
+                    "text": "RevealOptions"
+                  }
+                }
+              ],
+              "description": "Scrolls the box to show item `index`.\n\nBy default the least distance that shows it whole, for a host moving focus\nto an item outside the window, whose own element cannot be scrolled to\nbecause it is not drawn where it belongs. `inset` is how far into the box\nthe items start, for a heading that sticks at its top and covers that much\nof every item scrolled under it.\n\n`align` puts the item at the box's `start`, `center` or `end` instead, and\n`behavior` is the platform's, for a host whose consumer asked to be taken\nto an item. A smooth scroll moves the window through the box's own\n`scroll` events, the same as a reader scrolling."
+            },
+            {
+              "kind": "method",
+              "name": "offsetOf",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
                 }
               ],
-              "description": "Scrolls the box the least distance that shows item `index` whole.\n\nFor a host moving focus to an item outside the window, whose own element\ncannot be scrolled to because it is not drawn where it belongs. `inset` is\nhow far into the box the items start, for a heading that sticks at its\ntop and covers that much of every item scrolled under it."
+              "description": "Where item `index` starts along the scroll axis, in pixels from the top of\nthe set: what was measured above it, or the estimate."
             },
             {
               "kind": "method",
@@ -5534,8 +5762,8 @@
         },
         {
           "kind": "class",
-          "description": "A sandbox's panel is about to change height, and can be refused.\n\nThe sibling of `helix-before-split`, and named for the divider rather than for\nthe axis because a reader binding one of the two is choosing which divider they\ncare about. `value` is pixels here and a percentage there, which is what each\nproperty already publishes.",
-          "name": "HelixBeforePanelResizeEvent",
+          "description": "The divider between a sandbox's panes settled somewhere new.\n\nThe notification half of `helix-before-split`, sent once `split` has moved,\nwith the lead pane's new share. Not cancelable: the decision was the\nrequest's.",
+          "name": "HelixSplitEvent",
           "members": [
             {
               "kind": "field",
@@ -5545,7 +5773,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-panel-resize'"
+              "default": "'helix-split'"
             }
           ],
           "superclass": {
@@ -5556,8 +5784,8 @@
         },
         {
           "kind": "class",
-          "description": "A pane is about to collapse or reopen, and can be refused.",
-          "name": "HelixBeforeCollapseEvent",
+          "description": "A sandbox's panel is about to change height, and can be refused.\n\nThe sibling of `helix-before-split`, and named for the divider rather than for\nthe axis because a reader binding one of the two is choosing which divider they\ncare about. `value` is pixels here and a percentage there, which is what each\nproperty already publishes.",
+          "name": "HelixBeforePanelResizeEvent",
           "members": [
             {
               "kind": "field",
@@ -5567,7 +5795,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-collapse'"
+              "default": "'helix-before-panel-resize'"
             }
           ],
           "superclass": {
@@ -5578,8 +5806,8 @@
         },
         {
           "kind": "class",
-          "description": "A pane shut or reopened.\n\nThe notification half of `helix-before-collapse`, sent once `collapsed` has\nmoved. `detail.value` is the side that is shut, or empty where both panes\nare open. Not cancelable: the decision was the request's.",
-          "name": "HelixCollapseEvent",
+          "description": "A sandbox's panel settled at a new height.\n\nThe notification half of `helix-before-panel-resize`, sent once `panelSize`\nhas moved, with the height in pixels. Not cancelable: the decision was the\nrequest's.",
+          "name": "HelixPanelResizeEvent",
           "members": [
             {
               "kind": "field",
@@ -5589,7 +5817,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-collapse'"
+              "default": "'helix-panel-resize'"
             }
           ],
           "superclass": {
@@ -5600,8 +5828,8 @@
         },
         {
           "kind": "class",
-          "description": "Source is about to be edited, and can be refused.",
-          "name": "HelixBeforeEditEvent",
+          "description": "A pane is about to collapse or reopen, and can be refused.",
+          "name": "HelixBeforeCollapseEvent",
           "members": [
             {
               "kind": "field",
@@ -5611,7 +5839,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-edit'"
+              "default": "'helix-before-collapse'"
             }
           ],
           "superclass": {
@@ -5622,8 +5850,8 @@
         },
         {
           "kind": "class",
-          "description": "A value is about to change, and the change can be refused.\n\n**The request half of every value control.** It announces the value being\n*proposed*, before anything moves, so a listener calling `preventDefault()`\nrefuses it and the control stays where it was. That is how a consumer takes\none decision without declaring a mode, which is what 294 settled: the element\nalways owns and applies its state, and refusing is the way to take it over.\n\n**The notification is native and separate.** Once this has gone out and the\nvalue has moved, the control announces it again under the platform's own\nname, `input` while a reader is editing and `change` when they are done, so\n`onChange` in React and `onchange=` in HTML both reach it and\n`currentTarget.value` is correct by the time a handler reads it. This event\ncarries the detail because at the moment it fires the value is not on the\nelement yet.\n\n**`announcesInput` picks which native notification fires, not which name this\ncarries.** Granularity is the platform's own distinction, `input` against\n`change`; the request is always this one event.",
-          "name": "HelixBeforeChangeEvent",
+          "description": "A pane shut or reopened.\n\nThe notification half of `helix-before-collapse`, sent once `collapsed` has\nmoved. `detail.value` is the side that is shut, or empty where both panes\nare open. Not cancelable: the decision was the request's.",
+          "name": "HelixCollapseEvent",
           "members": [
             {
               "kind": "field",
@@ -5633,7 +5861,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-change'"
+              "default": "'helix-collapse'"
             }
           ],
           "superclass": {
@@ -5644,8 +5872,8 @@
         },
         {
           "kind": "class",
-          "description": "A checked state is about to change, and the change can be refused.\n\n**Its own event rather than a `helix-before-change` carrying a boolean.**\nThrough the value event the state arrives as `String(checked)`, so a consumer\nreceives the string `\"false\"`, which is truthy, and a test asserting the value\npasses on that bug. A control whose state is a boolean wants an event with a\ntyped boolean in it.\n\nThe notification is native, as it is for a value: the control relays `change`\nfrom the inner input and announces `input` beside it, so `onChange` reads\n`currentTarget.checked` and gets a boolean from the platform.\n\nIt also ends a collision: Checkbox Group listened for its boxes' change and\ndispatched its own under the same name from the same host, so it needed\n`stopImmediatePropagation` to keep a consumer from receiving one box's boolean\nalongside the whole set. Two names, two facts.",
-          "name": "HelixBeforeToggleEvent",
+          "description": "Source is about to be edited, and can be refused.",
+          "name": "HelixBeforeEditEvent",
           "members": [
             {
               "kind": "field",
@@ -5655,7 +5883,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-before-toggle'"
+              "default": "'helix-before-edit'"
             }
           ],
           "superclass": {
@@ -5666,8 +5894,8 @@
         },
         {
           "kind": "class",
-          "description": "The reader asked for something the list does not hold.\n\nCancelable, and announced before anything is applied, because the options are\nthe consumer's own light DOM and no component here writes into it. What the\ncontrol can do is say what was asked for and take the value; putting an\noption in the list, or a row in a database, is the consumer's, and a consumer\nwho validates first refuses this and adds nothing.\n\nThe detail carries the text as typed, not a slug of it. Trimming or lowering\nit here would be this element deciding what a name means, and a consumer who\nwants an identifier can make one from what they were given.",
-          "name": "HelixCreateEvent",
+          "description": "Source was edited.\n\nThe notification half of `helix-before-edit`, sent once the pane holds the\nnew source, with that source. Not cancelable: the decision was the\nrequest's.",
+          "name": "HelixEditEvent",
           "members": [
             {
               "kind": "field",
@@ -5677,7 +5905,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-create'"
+              "default": "'helix-edit'"
             }
           ],
           "superclass": {
@@ -5688,8 +5916,8 @@
         },
         {
           "kind": "class",
-          "description": "Something was copied to the clipboard.\n\nNot cancelable, and deliberately: it is announced after the write, because a\nclipboard write is a permission the platform may refuse and there is nothing\nuseful to report until it has either happened or not.",
-          "name": "HelixCopyEvent",
+          "description": "A value is about to change, and the change can be refused.\n\n**The request half of every value control.** It announces the value being\n*proposed*, before anything moves, so a listener calling `preventDefault()`\nrefuses it and the control stays where it was. That is how a consumer takes\none decision without declaring a mode, which is what 294 settled: the element\nalways owns and applies its state, and refusing is the way to take it over.\n\n**The notification is native and separate.** Once this has gone out and the\nvalue has moved, the control announces it again under the platform's own\nname, `input` while a reader is editing and `change` when they are done, so\n`onChange` in React and `onchange=` in HTML both reach it and\n`currentTarget.value` is correct by the time a handler reads it. This event\ncarries the detail because at the moment it fires the value is not on the\nelement yet.\n\n**`announcesInput` picks which native notification fires, not which name this\ncarries.** Granularity is the platform's own distinction, `input` against\n`change`; the request is always this one event.",
+          "name": "HelixBeforeChangeEvent",
           "members": [
             {
               "kind": "field",
@@ -5699,7 +5927,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-copy'"
+              "default": "'helix-before-change'"
             }
           ],
           "superclass": {
@@ -5710,8 +5938,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when something being previewed writes to the console.\n\nCarries text rather than the logged values. The preview is a separate\ndocument, so what arrives has crossed `postMessage` and been through\nstructured clone: a DOM node or a function does not survive that, and half a\nvalue is worse than a string of it.",
-          "name": "HelixConsoleEvent",
+          "description": "A checked state is about to change, and the change can be refused.\n\n**Its own event rather than a `helix-before-change` carrying a boolean.**\nThrough the value event the state arrives as `String(checked)`, so a consumer\nreceives the string `\"false\"`, which is truthy, and a test asserting the value\npasses on that bug. A control whose state is a boolean wants an event with a\ntyped boolean in it.\n\nThe notification is native, as it is for a value: the control relays `change`\nfrom the inner input and announces `input` beside it, so `onChange` reads\n`currentTarget.checked` and gets a boolean from the platform.\n\nIt also ends a collision: Checkbox Group listened for its boxes' change and\ndispatched its own under the same name from the same host, so it needed\n`stopImmediatePropagation` to keep a consumer from receiving one box's boolean\nalongside the whole set. Two names, two facts.",
+          "name": "HelixBeforeToggleEvent",
           "members": [
             {
               "kind": "field",
@@ -5721,7 +5949,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-console'"
+              "default": "'helix-before-toggle'"
             }
           ],
           "superclass": {
@@ -5732,8 +5960,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when something reports how much room its content actually needs.\n\n**A measurement crossing a boundary the measurer is on the far side of.** A\nsandboxed preview is its own document: nothing outside it can read the height\nof what it drew, because the frame is opaque and a box sized from the outside\nonly ever reports the box. So the document measures itself and says so, and\nthis is what it says it with.\n\nA number rather than a box, because the width is the container's to decide and\nonly the block size follows the content. A consumer that wants to act on it\nclamps it: what arrives is what was drawn, which for an empty example is\nnearly nothing and for a long one is more than a page.",
-          "name": "HelixResizeEvent",
+          "description": "The reader asked for something the list does not hold.\n\nCancelable, and announced before anything is applied, because the options are\nthe consumer's own light DOM and no component here writes into it. What the\ncontrol can do is say what was asked for and take the value; putting an\noption in the list, or a row in a database, is the consumer's, and a consumer\nwho validates first refuses this and adds nothing.\n\nThe detail carries the text as typed, not a slug of it. Trimming or lowering\nit here would be this element deciding what a name means, and a consumer who\nwants an identifier can make one from what they were given.",
+          "name": "HelixCreateEvent",
           "members": [
             {
               "kind": "field",
@@ -5743,7 +5971,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-resize'"
+              "default": "'helix-create'"
             }
           ],
           "superclass": {
@@ -5754,8 +5982,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when a header crosses the threshold between resting at the top of the\npage and floating over it.\n\n**The threshold lives in a custom state, and is announced rather than\nreflected.** A `data-scrolled` on the host is an attribute nobody rendered: a\nserver sends the element without it and the element adds it on upgrade, so a\nframework hydrating the page finds markup that no longer matches what it sent.\nA custom state is deliberately not in the DOM and therefore not something a\nhydration pass can disagree with.\n\nThat closes the observability an attribute would accidentally provide. A\n`MutationObserver` can watch an attribute and there is no equivalent for\n`ElementInternals.states`, so a component holding a boolean nothing can read\nis a component with a private opinion its consumers demonstrably need: the\nbar's own backdrop is drawn by the page around it, and the page has to know\nwhen to light it.\n\nNot cancelable. It reports where the page is rather than asking permission to\nbe there, and refusing it would leave the state and the announcement\ndisagreeing.\n\nThe hysteresis stays inside the header, which is the point of announcing at\nall: a consumer listening to `scroll` itself would be a second opinion on\nwhen the page counts as scrolled, and the two would part company at the eight\npixels of travel this waits for.",
-          "name": "HelixScrolledEvent",
+          "description": "An aura stopped drawing its shader and shows its gradient, and says why.\n\nSent each time it falls back, from the aura, which then matches\n`:state(fallback)` until it draws again. Not cancelable: there is nothing\nleft to refuse.",
+          "name": "HelixAuraFallbackEvent",
           "members": [
             {
               "kind": "field",
@@ -5765,7 +5993,7 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-scrolled'"
+              "default": "'helix-aura-fallback'"
             }
           ],
           "superclass": {
@@ -5776,8 +6004,8 @@
         },
         {
           "kind": "class",
-          "description": "Fired when the cursor moves in a text editor.\n\nNot cancelable, unlike everything else here. The others announce something\nabout to happen and a listener can refuse it; this one reports where the\ncaret already is, and there is nothing left to refuse.\n\nIt fires on every keystroke and every arrow press, which is why the status\nbar reads it from the DOM rather than through a framework's state: routing a\ncaret position through React would re-render the workbench on every cursor\nmove.",
-          "name": "HelixCaretEvent",
+          "description": "A reader cleared the value: an input's clear button emptied the field, or a\nclearable rating went back to unrated.\n\nSent after the value is cleared, and after the `input` and `change` the\nclear sends. Carries nothing, because the value is the cleared one.",
+          "name": "HelixClearEvent",
           "members": [
             {
               "kind": "field",
@@ -5787,7 +6015,315 @@
               },
               "static": true,
               "readonly": true,
-              "default": "'helix-caret'"
+              "default": "'helix-clear'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "A press put nothing on the clipboard: the browser did not allow the write,\nsuch as on a page without the clipboard permission, or there was nothing to\ncopy.",
+          "name": "HelixCopyErrorEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-copy-error'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "A reader asked for more items: a feed's or a table's `load-more` button, or\na list scrolled near its end. Append them, and set `loading` while they are\non their way.\n\nCarries nothing, because what comes next is the consumer's to know. Not\ncancelable: nothing is loaded until the consumer loads it.",
+          "name": "HelixLoadMoreEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-load-more'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "A lazy branch opened and asks for its children: a tree item with `lazy`.\nSent from the item, so `target` is the branch to fill.\n\nCarries nothing, because the children are the consumer's to fetch. Not\ncancelable: the branch is already open, and says it is busy until children\narrive.",
+          "name": "HelixLoadEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-load'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "The items on screen changed: a virtual list was scrolled or resized, or its\nitems changed. Carries the new range, which the list's `range` also holds.\nNot cancelable: the list has already moved.",
+          "name": "HelixRangeChangeEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-range-change'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Rows opened or closed in place: a data table's tree of rows. Carries every\nopen row's key, separated by commas, which the table's `expanded` also\nholds. Not cancelable: the rows have already moved.",
+          "name": "HelixExpandEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-expand'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "A sequence played to its last entry and stopped there: a video playlist\nwith no `repeat`. Carries nothing, because the playlist still holds the last\nentry. Not cancelable: playback has already ended.",
+          "name": "HelixEndEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-end'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "The user started or stopped writing: a chat composer, for a typing\nindicator on the other side. Carries which, as the composer's `typing` does.\nNot cancelable: it reports what the user did.",
+          "name": "HelixTypingEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-typing'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "A reader acted on a row: Enter on a list row, or a press in a list that\nselects nothing. Sent from the row, so `target` is the row acted on.\n\nCarries nothing, because the row is the whole of the answer. Not cancelable:\na row with a link follows it and sends nothing, so there is no default left\nto refuse.",
+          "name": "HelixActionEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-action'"
+            }
+          ],
+          "superclass": {
+            "name": "Event",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "A checked state changed after `helix-before-toggle` let it: a map layer\nshown or hidden from the layers menu. Sent from what changed, with the state\nit now holds.\n\n**Not the native `toggle`.** That one is a `ToggleEvent` saying a popover or\na `<details>` opened or closed, with `newState` of `open` or `closed`, and a\nlayer shown on a map is neither: it is the request's own verb without\n`before`, carrying the same `checked` the request did.",
+          "name": "HelixToggleEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-toggle'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Something was copied to the clipboard.\n\nNot cancelable, and deliberately: it is announced after the write, because a\nclipboard write is a permission the platform may refuse and there is nothing\nuseful to report until it has either happened or not.",
+          "name": "HelixCopyEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-copy'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when something being previewed writes to the console.\n\nCarries text rather than the logged values. The preview is a separate\ndocument, so what arrives has crossed `postMessage` and been through\nstructured clone: a DOM node or a function does not survive that, and half a\nvalue is worse than a string of it.",
+          "name": "HelixConsoleEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-console'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when something reports how much room its content actually needs.\n\n**A measurement crossing a boundary the measurer is on the far side of.** A\nsandboxed preview is its own document: nothing outside it can read the height\nof what it drew, because the frame is opaque and a box sized from the outside\nonly ever reports the box. So the document measures itself and says so, and\nthis is what it says it with.\n\nA number rather than a box, because the width is the container's to decide and\nonly the block size follows the content. A consumer that wants to act on it\nclamps it: what arrives is what was drawn, which for an empty example is\nnearly nothing and for a long one is more than a page.",
+          "name": "HelixResizeEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-resize'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when a header crosses the threshold between resting at the top of the\npage and floating over it.\n\n**The threshold lives in a custom state, and is announced rather than\nreflected.** A `data-scrolled` on the host is an attribute nobody rendered: a\nserver sends the element without it and the element adds it on upgrade, so a\nframework hydrating the page finds markup that no longer matches what it sent.\nA custom state is deliberately not in the DOM and therefore not something a\nhydration pass can disagree with.\n\nThat closes the observability an attribute would accidentally provide. A\n`MutationObserver` can watch an attribute and there is no equivalent for\n`ElementInternals.states`, so a component holding a boolean nothing can read\nis a component with a private opinion its consumers demonstrably need: the\nbar's own backdrop is drawn by the page around it, and the page has to know\nwhen to light it.\n\nNot cancelable. It reports where the page is rather than asking permission to\nbe there, and refusing it would leave the state and the announcement\ndisagreeing.\n\nThe hysteresis stays inside the header, which is the point of announcing at\nall: a consumer listening to `scroll` itself would be a second opinion on\nwhen the page counts as scrolled, and the two would part company at the eight\npixels of travel this waits for.",
+          "name": "HelixScrolledEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-scrolled'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "Fired when the cursor moves in a text editor.\n\nNot cancelable, unlike everything else here. The others announce something\nabout to happen and a listener can refuse it; this one reports where the\ncaret already is, and there is nothing left to refuse.\n\nIt fires on every keystroke and every arrow press, which is why the status\nbar reads it from the DOM rather than through a framework's state: routing a\ncaret position through React would re-render the workbench on every cursor\nmove.",
+          "name": "HelixCaretEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-caret'"
             }
           ],
           "superclass": {
@@ -6339,193 +6875,305 @@
         },
         {
           "kind": "js",
-          "name": "HelixGraphPanEvent",
+          "name": "HelixGraphPanEvent",
+          "declaration": {
+            "name": "HelixGraphPanEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixGraphZoomEvent",
+          "declaration": {
+            "name": "HelixGraphZoomEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixGraphLayoutEvent",
+          "declaration": {
+            "name": "HelixGraphLayoutEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixGraphPartChangeEvent",
+          "declaration": {
+            "name": "HelixGraphPartChangeEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixGraphSignalEvent",
+          "declaration": {
+            "name": "HelixGraphSignalEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixGraphReadyEvent",
+          "declaration": {
+            "name": "HelixGraphReadyEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixGraphFilterEvent",
+          "declaration": {
+            "name": "HelixGraphFilterEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMapRotateEvent",
+          "declaration": {
+            "name": "HelixMapRotateEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMapTiltEvent",
+          "declaration": {
+            "name": "HelixMapTiltEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMapPartChangeEvent",
+          "declaration": {
+            "name": "HelixMapPartChangeEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMapClusterEvent",
+          "declaration": {
+            "name": "HelixMapClusterEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMapReadyEvent",
+          "declaration": {
+            "name": "HelixMapReadyEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixBeforePinEvent",
+          "declaration": {
+            "name": "HelixBeforePinEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixPinEvent",
+          "declaration": {
+            "name": "HelixPinEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixBeforeResizeEvent",
           "declaration": {
-            "name": "HelixGraphPanEvent",
+            "name": "HelixBeforeResizeEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixGraphZoomEvent",
+          "name": "HelixResizedEvent",
           "declaration": {
-            "name": "HelixGraphZoomEvent",
+            "name": "HelixResizedEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixGraphLayoutEvent",
+          "name": "HelixBeforeSplitEvent",
           "declaration": {
-            "name": "HelixGraphLayoutEvent",
+            "name": "HelixBeforeSplitEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixGraphPartChangeEvent",
+          "name": "HelixSplitEvent",
           "declaration": {
-            "name": "HelixGraphPartChangeEvent",
+            "name": "HelixSplitEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixGraphSignalEvent",
+          "name": "HelixBeforePanelResizeEvent",
           "declaration": {
-            "name": "HelixGraphSignalEvent",
+            "name": "HelixBeforePanelResizeEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixGraphReadyEvent",
+          "name": "HelixPanelResizeEvent",
           "declaration": {
-            "name": "HelixGraphReadyEvent",
+            "name": "HelixPanelResizeEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixGraphFilterEvent",
+          "name": "HelixBeforeCollapseEvent",
           "declaration": {
-            "name": "HelixGraphFilterEvent",
+            "name": "HelixBeforeCollapseEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixMapRotateEvent",
+          "name": "HelixCollapseEvent",
           "declaration": {
-            "name": "HelixMapRotateEvent",
+            "name": "HelixCollapseEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixMapTiltEvent",
+          "name": "HelixBeforeEditEvent",
           "declaration": {
-            "name": "HelixMapTiltEvent",
+            "name": "HelixBeforeEditEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixMapPartChangeEvent",
+          "name": "HelixEditEvent",
           "declaration": {
-            "name": "HelixMapPartChangeEvent",
+            "name": "HelixEditEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixMapClusterEvent",
+          "name": "HelixBeforeChangeEvent",
           "declaration": {
-            "name": "HelixMapClusterEvent",
+            "name": "HelixBeforeChangeEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixMapReadyEvent",
+          "name": "HelixBeforeToggleEvent",
           "declaration": {
-            "name": "HelixMapReadyEvent",
+            "name": "HelixBeforeToggleEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixBeforePinEvent",
+          "name": "HelixCreateEvent",
           "declaration": {
-            "name": "HelixBeforePinEvent",
+            "name": "HelixCreateEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixPinEvent",
+          "name": "HelixAuraFallbackEvent",
           "declaration": {
-            "name": "HelixPinEvent",
+            "name": "HelixAuraFallbackEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixBeforeResizeEvent",
+          "name": "HelixClearEvent",
           "declaration": {
-            "name": "HelixBeforeResizeEvent",
+            "name": "HelixClearEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixResizedEvent",
+          "name": "HelixCopyErrorEvent",
           "declaration": {
-            "name": "HelixResizedEvent",
+            "name": "HelixCopyErrorEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixBeforeSplitEvent",
+          "name": "HelixLoadMoreEvent",
           "declaration": {
-            "name": "HelixBeforeSplitEvent",
+            "name": "HelixLoadMoreEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixBeforePanelResizeEvent",
+          "name": "HelixLoadEvent",
           "declaration": {
-            "name": "HelixBeforePanelResizeEvent",
+            "name": "HelixLoadEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixBeforeCollapseEvent",
+          "name": "HelixRangeChangeEvent",
           "declaration": {
-            "name": "HelixBeforeCollapseEvent",
+            "name": "HelixRangeChangeEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixCollapseEvent",
+          "name": "HelixExpandEvent",
           "declaration": {
-            "name": "HelixCollapseEvent",
+            "name": "HelixExpandEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixBeforeEditEvent",
+          "name": "HelixEndEvent",
           "declaration": {
-            "name": "HelixBeforeEditEvent",
+            "name": "HelixEndEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixBeforeChangeEvent",
+          "name": "HelixTypingEvent",
           "declaration": {
-            "name": "HelixBeforeChangeEvent",
+            "name": "HelixTypingEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixBeforeToggleEvent",
+          "name": "HelixActionEvent",
           "declaration": {
-            "name": "HelixBeforeToggleEvent",
+            "name": "HelixActionEvent",
             "module": "src/events/events.ts"
           }
         },
         {
           "kind": "js",
-          "name": "HelixCreateEvent",
+          "name": "HelixToggleEvent",
           "declaration": {
-            "name": "HelixCreateEvent",
+            "name": "HelixToggleEvent",
             "module": "src/events/events.ts"
           }
         },
@@ -7098,7 +7746,25 @@
               }
             }
           ],
-          "description": "The prop React would be holding for this event, if it is holding one.\n\n**A relayed native event needs a different answer from one of ours, and\ngetting it wrong doubles every call.** Measured against React 19.2.8:\n\n```\nonhelix-before-change <- helix-before-change  REACHED (React binds it with addEventListener)\nonChange       <- change        REACHED    (React's delegated root listener)\nonLoad         <- load          not reached\nonError        <- error         not reached\nonEnded        <- ended         not reached\n```\n\nReact binds a hyphenated prop directly on the element, so our own events are\nreached by name and are safe to bind again: same type, same callback, same\ncapture flag is a no-op by specification. A native name is different. React\nrecognizes `onChange` and `onLoad` as its own registration names and attaches\nnothing to the element for either; it relies on a delegated listener at the\nroot, which sees an event only if it **bubbles**, and on a non-delegated list\nit sets up for `<video>`, `<audio>` and `<img>` and never for a custom\nelement.\n\nSo a bubbling relay already arrives and must not be bound again: React's\nlistener is at the root rather than on the element, so nothing deduplicates\nit and the consumer's handler runs twice. A non-bubbling relay arrives\nnowhere, and is the bug this exists to close: `<helix-avatar>` relays `load`\nand `error`, `<helix-video>` relays `ended`, `play` and `pause`, all of them\ndeclared public API and all of them otherwise silent in React.\n\nThe name is React's own casing, `onError` rather than `onerror`, because that\nis what a consumer writes and therefore what is in the props bag. Every\nnative we relay is a single word, so capitalising the first letter is the\nwhole of the rule; a two-word name like `loadeddata` would be `onLoadedData`\nand needs the list extending rather than the rule generalising."
+          "description": "The prop React would be holding for this event, if it is holding one.\n\n**A relayed native event needs a different answer from one of ours, and\ngetting it wrong doubles every call.** Measured against React 19.2.8:\n\n```\nonhelix-before-change <- helix-before-change  REACHED (React binds it with addEventListener)\nonChange       <- change        REACHED    (React's delegated root listener)\nonLoad         <- load          not reached\nonError        <- error         not reached\nonEnded        <- ended         not reached\n```\n\nReact binds a hyphenated prop directly on the element, so our own events are\nreached by name and are safe to bind again: same type, same callback, same\ncapture flag is a no-op by specification. A native name is different. React\nrecognizes `onChange` and `onLoad` as its own registration names and attaches\nnothing to the element for either; it relies on a delegated listener at the\nroot, which sees an event only if it **bubbles**, and on a non-delegated list\nit sets up for `<video>`, `<audio>` and `<img>` and never for a custom\nelement.\n\nSo a bubbling relay already arrives and must not be bound again: React's\nlistener is at the root rather than on the element, so nothing deduplicates\nit and the consumer's handler runs twice. A non-bubbling relay arrives\nnowhere, and is the bug this exists to close: `<helix-avatar>` relays `load`\nand `error`, `<helix-video>` relays `ended`, `play` and `pause`, all of them\ndeclared public API and all of them otherwise silent in React.\n\nThe name is React's own casing, `onError` rather than `onerror`, because that\nis what a consumer writes and therefore what is in the props bag. See\n`reactNativeProp`."
+        },
+        {
+          "kind": "function",
+          "name": "reactNativeProp",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "type",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The prop React reads for a native event: `onError` for `error`, and\n`onTimeUpdate` for `timeupdate`.\n\nThe JSX typings name the same props, so a consumer writes what this binds."
         },
         {
           "kind": "function",
@@ -7167,6 +7833,14 @@
             "module": "src/helix-element/react-bridge.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "reactNativeProp",
+          "declaration": {
+            "name": "reactNativeProp",
+            "module": "src/helix-element/react-bridge.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "bindReactHandler",
@@ -8100,6 +8774,22 @@
             "module": "./controllers/copy-controller/copy-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "CountdownController",
+          "declaration": {
+            "name": "CountdownController",
+            "module": "./controllers/countdown-controller/countdown-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CountdownOptions",
+          "declaration": {
+            "name": "CountdownOptions",
+            "module": "./controllers/countdown-controller/countdown-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "activeCue",
@@ -8332,6 +9022,14 @@
             "module": "./controllers/keyboard-navigation-controller/keyboard-navigation-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "KeyboardOrigin",
+          "declaration": {
+            "name": "KeyboardOrigin",
+            "module": "./controllers/keyboard-navigation-controller/keyboard-navigation-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "NavigableItem",
@@ -8596,6 +9294,14 @@
             "module": "./events/element-events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "AuraFallbackDetail",
+          "declaration": {
+            "name": "AuraFallbackDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "CanvasView",
@@ -8716,6 +9422,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixActionEvent",
+          "declaration": {
+            "name": "HelixActionEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixActivateEvent",
@@ -8724,6 +9438,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixAuraFallbackEvent",
+          "declaration": {
+            "name": "HelixAuraFallbackEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixBeforeActivateEvent",
@@ -8876,6 +9598,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixClearEvent",
+          "declaration": {
+            "name": "HelixClearEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixCollapseEvent",
@@ -8908,6 +9638,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixCopyErrorEvent",
+          "declaration": {
+            "name": "HelixCopyErrorEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixCopyEvent",
@@ -8932,6 +9670,30 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixEditEvent",
+          "declaration": {
+            "name": "HelixEditEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixEndEvent",
+          "declaration": {
+            "name": "HelixEndEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixExpandEvent",
+          "declaration": {
+            "name": "HelixExpandEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixFacetEvent",
@@ -9020,6 +9782,22 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixLoadEvent",
+          "declaration": {
+            "name": "HelixLoadEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixLoadMoreEvent",
+          "declaration": {
+            "name": "HelixLoadMoreEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixMapClusterEvent",
@@ -9100,6 +9878,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixPanelResizeEvent",
+          "declaration": {
+            "name": "HelixPanelResizeEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixPinEvent",
@@ -9116,6 +9902,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixRangeChangeEvent",
+          "declaration": {
+            "name": "HelixRangeChangeEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixReadEvent",
@@ -9260,6 +10054,22 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixSplitEvent",
+          "declaration": {
+            "name": "HelixSplitEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixToggleEvent",
+          "declaration": {
+            "name": "HelixToggleEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixTourAskEvent",
@@ -9268,6 +10078,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixTypingEvent",
+          "declaration": {
+            "name": "HelixTypingEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "MapClusterDetail",
@@ -9340,6 +10158,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "RangeDetail",
+          "declaration": {
+            "name": "RangeDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ReadDetail",
@@ -9460,6 +10286,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "TypingDetail",
+          "declaration": {
+            "name": "TypingDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ViewportPanDetail",
@@ -10596,6 +11430,14 @@
             "module": "./utils/platform/platform.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "rangeAdd",
+          "declaration": {
+            "name": "rangeAdd",
+            "module": "./utils/range-add/range-add.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ColorBytes",
@@ -19004,7 +19846,7 @@
               }
             }
           ],
-          "description": "Draws an icon that was imported by name, rather than looked up by string.\n\n**`<helix-icon name=\"play\">` indexes the whole icon set at runtime.** Its\nrender is `icons[this.name]`, and no bundler can shake a dynamic index, so\nevery consumer of any component that renders one ships all of the generated\npath data: measured at 50,814 bytes raw and 15,010 gzipped for 102 icons, and\ngrowing about 147 gzipped bytes per icon added. A named import ships one path\nand is checked when the package compiles rather than by a name lookup later.\n\nThat element still earns its place as *public* API, where a consumer writes a\nname in markup and a lookup is the only thing that can work. What it should\nnot be is how this library draws its own marks.\n\n**There is no `part` option, and there cannot be.** A part name behind an\ninterpolation is a part the manifest cannot see, so the component's own\nstylesheet matches nothing and the part stops being\nAPI. `Trend` needs one and therefore writes its `<svg>` out with a literal\n`part=\"icon\"`, which is the honest cost: a helper can carry everything except\nthe thing static analysis has to read.\n\n`data-glyph` rather than a class, because the sizing lives in\n`helix/styled/src/shared/glyph/glyph.css` and a component's own `--icon-size`\ndeclarations have to keep working untouched: the variable was read by\n`helix-icon`, and now it is read by the rule that sheet carries. Without it\nevery one of those declarations would go quietly dead and every mark in six\nfamilies would change size."
+          "description": "Draws an icon that was imported by name, rather than looked up by string.\n\n**`<helix-icon name=\"play\">` looks its glyph up in a registry at runtime.**\nThe registry holds the whole set once `@fusion.dev/helix-headless/icon`\nregisters it, and no bundler can shake a lookup by string, so every consumer\nof any component that renders one ships all of the generated path data: measured at 50,814 bytes raw and 15,010 gzipped for 102 icons, and\ngrowing about 147 gzipped bytes per icon added. A named import ships one path\nand is checked when the package compiles rather than by a name lookup later.\n\nThat element still earns its place as *public* API, where a consumer writes a\nname in markup and a lookup is the only thing that can work, and\n`@fusion.dev/helix-headless/icon/root` names glyphs without registering the\nset. What it should not be is how this library draws its own marks.\n\n**There is no `part` option, and there cannot be.** A part name behind an\ninterpolation is a part the manifest cannot see, so the component's own\nstylesheet matches nothing and the part stops being\nAPI. `Trend` needs one and therefore writes its `<svg>` out with a literal\n`part=\"icon\"`, which is the honest cost: a helper can carry everything except\nthe thing static analysis has to read.\n\n`data-glyph` rather than a class, because the sizing lives in\n`helix/styled/src/shared/glyph/glyph.css` and a component's own `--icon-size`\ndeclarations have to keep working untouched: the variable was read by\n`helix-icon`, and now it is read by the rule that sheet carries. Without it\nevery one of those declarations would go quietly dead and every mark in six\nfamilies would change size."
         }
       ],
       "exports": [
@@ -20078,6 +20920,58 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/range-add/range-add.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "rangeAdd",
+          "return": {
+            "type": {
+              "text": "string[] | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "values",
+              "type": {
+                "text": "readonly string[]"
+              }
+            },
+            {
+              "name": "shown",
+              "type": {
+                "text": "readonly string[]"
+              }
+            },
+            {
+              "name": "from",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "to",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "The selection after Shift with Home or End: every option shown from the\nhighlight to the end the key went to, added after what was selected, or\n`null` where nothing new is taken in.\n\n`from` is where the highlight was, as an index into `shown`, or `-1` for no\nhighlight, which takes in the end alone. `to` is the end the key went to.\nAPG's multiple-selection listbox, and the same rule over a data table's\nrows."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "rangeAdd",
+          "declaration": {
+            "name": "rangeAdd",
+            "module": "src/utils/range-add/range-add.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/read-color/read-color.ts",
@@ -20322,7 +21216,7 @@
               }
             }
           ],
-          "description": "Writes elements onto an ARIA element-reflection property of `target`, or\nclears it, and says whether the property is now this caller's.\n\nElement references, because the words are in the light DOM and the panel in\na shadow root, which an IDREF cannot cross. Nothing is written where the\nengine has no reflection, which keeps the fallback name, and the answer is\nthen `owned` as it was. **An empty list clears the property only where the\ncaller wrote it**, which `owned` says, so a name another hand wrote stays.\n\nDialog and Drawer name their panel by its header this way, Popover by its\nfirst heading, Dialog describes itself by its body, and a Tour stop names\nand describes its panel."
+          "description": "Writes elements onto an ARIA element-reflection property of `target`, or\nclears it, and says whether the property is now this caller's.\n\nElement references, because the words are in the light DOM and the panel in\na shadow root, which an IDREF cannot cross. Nothing is written where the\nengine has no reflection, which keeps the fallback name, and the answer is\nthen `owned` as it was. **An empty list clears the property only where the\ncaller wrote it**, which `owned` says, so a name another hand wrote stays.\n\nDialog and Drawer name their panel by its header this way, Popover by its\nfirst heading, Dialog describes itself by its body, a Tour stop names and\ndescribes its panel, and a Tab points its control at the panel it shows."
         },
         {
           "kind": "function",
@@ -22129,7 +23023,7 @@
               }
             }
           ],
-          "description": "A time written the way the reader's locale writes one.\n\n`Intl` decides between a twelve and a twenty-four hour clock, because that is\na property of the locale rather than of any component: `en-US` gets `2:30 PM`\nand `en-GB` gets `14:30` without either being configured. There is no flag to\nforce one, deliberately. A product that needs to override its reader's own\nconvention has a locale problem rather than a component one, and the value is\n24 hour regardless.\n\nA value this cannot read is handed back unchanged, so a field showing what is\nbeing typed shows the letters rather than blanking under the reader. Minute\nprecision, as `valueAsMinutes` reads: `writeClock` is the same writing to the\nsecond."
+          "description": "A time written the way the reader's locale writes one.\n\n`Intl` decides between a twelve and a twenty-four hour clock, because that is\na property of the locale rather than of any component: `en-US` gets `2:30 PM`\nand `en-GB` gets `14:30` without either being configured. This function takes\nno flag to force one. A family that offers the choice, such as Time Picker\nand Time Input with `hour-cycle`, passes it in the locale, as its `-u-hc-`\nextension (`en-US-u-hc-h23`). The value is 24 hour regardless.\n\nA value this cannot read is handed back unchanged, so a field showing what is\nbeing typed shows the letters rather than blanking under the reader. Minute\nprecision, as `valueAsMinutes` reads: `writeClock` is the same writing to the\nsecond."
         },
         {
           "kind": "function",
@@ -22314,7 +23208,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.144.0'",
+          "default": "'0.145.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."
         }
       ],
@@ -22332,6 +23226,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.144.0"
+    "version": "0.145.0"
   }
 }