@fusion.dev/helix-core 0.58.1 → 0.59.0

package/custom-elements.json

@@ -205,7 +205,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the drawing is turned to run right to left, which it is on a\nright-to-left page.\n\n`HelixElement` mirrors a drawing marked `data-mirror` there, so a reading\ndrawn at 10% of the plot's width stands 10% in from its right edge. What is\nread against the drawing has to be read the same way: the pointer from the\nplot's right, and a bubble beside a bar's far end on its left. Asked of the\nhost's computed `direction`, which is what the table and the splitter read\nfor their own arrow keys.\n\nOn the controller because it is what reads the pointer against the drawing,\nand a chart deciding which side a bubble goes asks here rather than\nrepeating the question. Asked when needed rather than held, since a page\ncan change its direction without the chart updating.",
+              "description": "Whether the drawing is turned to run right to left, which it is on a\nright-to-left page.\n\n`HelixElement` mirrors a drawing marked `data-mirror` there, so a reading\ndrawn at 10% of the plot's width stands 10% in from its right edge. What is\nread against the drawing has to be read the same way: the pointer from the\nplot's right, and a bubble beside a bar's far end on its left. Asked of the\nhost through `isRtl`, which is the one question the table and the splitter\nask for their own arrow keys.\n\nOn the controller because it is what reads the pointer against the drawing,\nand a chart deciding which side a bubble goes asks here rather than\nrepeating the question. Asked when needed rather than held, since a page\ncan change its direction without the chart updating.",
               "readonly": true
             },
             {
@@ -1686,6 +1686,216 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/paint-gate-controller/paint-gate-controller.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "MAX_FRAME_STEP",
+          "type": {
+            "text": "number"
+          },
+          "default": "0.05",
+          "description": "The longest step one frame is given, in seconds.\n\nA tab that was throttled and comes back hands the first frame a delta of\nseveral seconds. Integrated whole, an animated canvas teleports: the aura's\nfield lands wherever the pointer went while nobody was watching, and the\norb's wave jumps a shape. The ceiling is 20 frames a second of simulated\ntime, so a genuinely slow frame still advances and a resumed one does not\nskip ahead.\n\nExported because a host that collects several frames into one owes the same\nceiling on what it spends. `Aura` caps its own frame rate and would otherwise\nhand its shader exactly the step this number refuses."
+        },
+        {
+          "kind": "class",
+          "description": "Runs a canvas painter's frame loop, and stops it whenever nobody is looking.\n\nIt holds the five pieces every animated canvas needs and none of which is\nabout what is drawn: an `IntersectionObserver` for whether the host is on\nscreen, `visibilitychange` for whether the tab is in front,\n`prefers-reduced-motion` and its `change` listener for whether the reader\nasked for less, a `ResizeObserver` for the box, and the\n`requestAnimationFrame` loop that reports a clamped step. It says whether it\nis running, whether the reader asked for less motion, and whether the host is\non screen.\n\n**Separable because none of it reads a pixel.** `Aura` and `Orb` are the\nlibrary's two canvas painters and are otherwise nothing alike, one a WebGL\nshader over a full-screen triangle and the other a depth-sorted cloud of 2D\ndots. Everything above is the same question in both, which is when a frame is\nworth drawing, and the answer never mentions the drawing.\n\n**Every path to a frame is gated, not only the observer's.** The tab's own\nstate is asked in `play` rather than in the intersection callback, because a\nrestored context, a resize, a state change and a preference all play too, and\na check that lives in the observer covers exactly one of them.\n\n**The next frame is asked for rather than booked blind.** A loop that books\nits own next frame unconditionally ends only where something calls `stop`,\nwhich is how a detached element and a host whose context was taken both went\non drawing into nothing.\n\n**The device-pixel cap is not here.** The aura scales by\n`Math.min(devicePixelRatio || 1, 2) * 0.85` and the orb by\n`Math.min(2, devicePixelRatio || 1)`, and the difference between them is a\nmeasured fill cost, five octaves of noise per pixel against a disc fill.\nThose are decisions about a drawing, not the mechanism around it.\n\n**Nor is context loss.** The event names differ by context type,\n`webglcontextlost` against `contextlost`, and so does the contract: a 2D\ncontext comes back unless the loss is canceled and a WebGL one comes back\nonly if it is. The aura's deferred release is an argument about a browser's\nbudget of about sixteen live WebGL contexts, which is nothing a 2D canvas\nhas.\n\nClient only, and by contract rather than by a guard: every caller holds a\ndrawing context before it calls `watch`, and there is no context on a server\nor on a machine that refuses one.",
+          "name": "PaintGateController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "host",
+              "type": {
+                "text": "ReactiveControllerHost & HTMLElement"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "host"
+            },
+            {
+              "kind": "field",
+              "name": "options",
+              "type": {
+                "text": "PaintGateOptions"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "options"
+            },
+            {
+              "kind": "field",
+              "name": "frame",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "The booked frame, or `0`, which is also the whole of whether it runs."
+            },
+            {
+              "kind": "field",
+              "name": "last",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "When the last reported frame was, so the next one carries the gap."
+            },
+            {
+              "kind": "field",
+              "name": "intersecting",
+              "type": {
+                "text": "boolean"
+              },
+              "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."
+            },
+            {
+              "kind": "field",
+              "name": "motion",
+              "type": {
+                "text": "MediaQueryList | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "sized",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "visible",
+              "type": {
+                "text": "IntersectionObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onScreen",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the host is on screen, as the intersection observer last said.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "reduced",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the reader asked for less motion.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "running",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether a frame is booked.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "watch",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Installs everything that decides whether a frame is wanted.\n\nCalled from the host's own setup rather than from `hostConnected`, because\na host with nothing to draw with has nothing to gate: both painters ask for\na context first and return where there is none, which is a server, a\nmachine that refuses one, and a renderer the aura declines. Idempotent, so\na host whose setup runs on every connection calls it every time."
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "play",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Starts the loop, where it is wanted and can be ended."
+            },
+            {
+              "kind": "method",
+              "name": "stop",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Ends the loop.\n\n`last` goes with it, so a loop starting again measures no step against a\nstale stamp. What the host accumulated is the host's and is left alone."
+            },
+            {
+              "kind": "method",
+              "name": "wanted",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Whether anybody is looking, and whether the host can draw for them."
+            },
+            {
+              "kind": "field",
+              "name": "tick",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "handleMotion",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "handleVisibility",
+              "privacy": "private",
+              "readonly": true
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "MAX_FRAME_STEP",
+          "declaration": {
+            "name": "MAX_FRAME_STEP",
+            "module": "src/controllers/paint-gate-controller/paint-gate-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PaintGateController",
+          "declaration": {
+            "name": "PaintGateController",
+            "module": "src/controllers/paint-gate-controller/paint-gate-controller.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/controllers/popover-controller/popover-controller.ts",
@@ -5127,6 +5337,30 @@
             "module": "./controllers/media-session-controller/media-session-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "MAX_FRAME_STEP",
+          "declaration": {
+            "name": "MAX_FRAME_STEP",
+            "module": "./controllers/paint-gate-controller/paint-gate-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PaintGateController",
+          "declaration": {
+            "name": "PaintGateController",
+            "module": "./controllers/paint-gate-controller/paint-gate-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PaintGateOptions",
+          "declaration": {
+            "name": "PaintGateOptions",
+            "module": "./controllers/paint-gate-controller/paint-gate-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "PopoverController",
@@ -5999,14 +6233,6 @@
             "module": "./utils/css-color/css-color.js"
           }
         },
-        {
-          "kind": "js",
-          "name": "splitColors",
-          "declaration": {
-            "name": "splitColors",
-            "module": "./utils/css-color/css-color.js"
-          }
-        },
         {
           "kind": "js",
           "name": "toCss",
@@ -6079,6 +6305,30 @@
             "module": "./utils/elapsed-time/elapsed-time.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ElementByIdOptions",
+          "declaration": {
+            "name": "ElementByIdOptions",
+            "module": "./utils/element-by-id/element-by-id.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "elementById",
+          "declaration": {
+            "name": "elementById",
+            "module": "./utils/element-by-id/element-by-id.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "searchableById",
+          "declaration": {
+            "name": "searchableById",
+            "module": "./utils/element-by-id/element-by-id.js"
+          }
+        },
         {
           "kind": "js",
           "name": "deepActiveElement",
@@ -6159,6 +6409,14 @@
             "module": "./utils/inline-step/inline-step.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "isRtl",
+          "declaration": {
+            "name": "isRtl",
+            "module": "./utils/is-rtl/is-rtl.js"
+          }
+        },
         {
           "kind": "js",
           "name": "Curve",
@@ -6415,6 +6673,14 @@
             "module": "./utils/slot-filled/slot-filled.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "splitValues",
+          "declaration": {
+            "name": "splitValues",
+            "module": "./utils/split-values/split-values.js"
+          }
+        },
         {
           "kind": "js",
           "name": "tellDisclosure",
@@ -6479,6 +6745,22 @@
             "module": "./utils/value-as/value-as.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "isTimeValue",
+          "declaration": {
+            "name": "isTimeValue",
+            "module": "./utils/value-as/value-as.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "minutesAsValue",
+          "declaration": {
+            "name": "minutesAsValue",
+            "module": "./utils/value-as/value-as.js"
+          }
+        },
         {
           "kind": "js",
           "name": "numberAsValue",
@@ -6503,6 +6785,14 @@
             "module": "./utils/value-as/value-as.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "valueAsMinutes",
+          "declaration": {
+            "name": "valueAsMinutes",
+            "module": "./utils/value-as/value-as.js"
+          }
+        },
         {
           "kind": "js",
           "name": "valueAsNumber",
@@ -6519,6 +6809,14 @@
             "module": "./utils/value-as/value-as.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "writeTime",
+          "declaration": {
+            "name": "writeTime",
+            "module": "./utils/write-time/write-time.js"
+          }
+        },
         {
           "kind": "js",
           "name": "writtenList",
@@ -6526,6 +6824,14 @@
             "name": "writtenList",
             "module": "./utils/written-list/written-list.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "writtenNumbers",
+          "declaration": {
+            "name": "writtenNumbers",
+            "module": "./utils/written-list/written-list.js"
+          }
         }
       ]
     },
@@ -6709,7 +7015,7 @@
               "type": {
                 "text": "string"
               },
-              "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."
             },
             {
               "kind": "field",
@@ -6820,7 +7126,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"
             },
             {
@@ -6904,7 +7210,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"
             },
             {
@@ -9869,24 +10175,6 @@
       "kind": "javascript-module",
       "path": "src/utils/css-color/css-color.ts",
       "declarations": [
-        {
-          "kind": "function",
-          "name": "splitColors",
-          "return": {
-            "type": {
-              "text": "string[]"
-            }
-          },
-          "parameters": [
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Splits a comma-separated list of colors, ignoring the commas inside them.\n\nA plain `split(',')` cannot hold the legacy syntaxes:\n`#ef4444, rgb(249 115 22), rgba(34,197,94,.5)` comes apart into six fragments,\nfour of them not colors, and the row quietly renders three swatches instead of\nfour. The modern space-separated forms survive it, which is what makes such a\nlist look like it works.\n\nDepth rather than a regular expression, because the thing that matters is\nwhether a comma is inside a function call and that is exactly what a counter\nanswers. No color syntax nests, so a single counter is enough."
-        },
         {
           "kind": "function",
           "name": "parseColor",
@@ -9955,14 +10243,6 @@
         }
       ],
       "exports": [
-        {
-          "kind": "js",
-          "name": "splitColors",
-          "declaration": {
-            "name": "splitColors",
-            "module": "src/utils/css-color/css-color.ts"
-          }
-        },
         {
           "kind": "js",
           "name": "parseColor",
@@ -10113,7 +10393,7 @@
             "text": "string"
           },
           "default": "'helix-chart-plot'",
-          "description": "The id every chart puts on its plot, and the boundary a bubble is kept inside.\n\n**A name six templates and this file have to agree on is a name that will\nstop agreeing**, which is `PALETTE`'s argument and it holds harder here: the\nfailure is silent. `within` resolves through `getElementById`, so a plot\nrenamed on one side returns null, the boundary falls back to the viewport,\nand the bubble goes back to hanging past the drawing with nothing reported\nanywhere.\n\nFixed rather than generated, for the reason the mark's id below gives: it is\nscoped to one chart's shadow root, where it is the only one."
+          "description": "The id every chart puts on its plot, and the boundary a bubble is kept inside.\n\n**A name six templates and this file have to agree on is a name that will\nstop agreeing**, which is `PALETTE`'s argument and it holds harder here: the\nfailure is silent. `within` resolves by id, so a plot renamed on one side\nreturns null, the boundary falls back to the viewport,\nand the bubble goes back to hanging past the drawing with nothing reported\nanywhere.\n\nFixed rather than generated, for the reason the mark's id below gives: it is\nscoped to one chart's shadow root, where it is the only one."
         },
         {
           "kind": "function",
@@ -10157,7 +10437,7 @@
               }
             }
           ],
-          "description": "What a pointer resting on a reading shows, as `Tooltip` pointed at a mark.\n\n**A chart does not draw its own tooltip, and the top layer is why.** `Tooltip`\nrenders `popover=\"manual\"` through `PopoverController`, so it clears every\nstacking context and every `overflow` on the page. A box drawn by the chart is\n`position: absolute` inside the plot and is confined to the chart's own\ncontext, so it is clipped by, or layered under, whatever sits beside the\nchart. Escaping that means reimplementing `PopoverController`, which is\n`Tooltip` with extra steps and a second copy of the hard part.\n\n**`for` was already the anchor and needed nothing added.** It resolves through\n`getRootNode().getElementById()`, and a chart's shadow root *is* a\n`ShadowRoot`, so a chart names an element inside itself and `Tooltip` finds\nit. What the chart provides is an invisible mark at the reading's point.\n\n**An HTML mark rather than the `<rect>` or `<circle>` already there.**\n`FloatingController` types its anchor as `HTMLElement` and an SVG element is\nnot one; and a slice's `<circle>` has the bounding box of the whole ring\nrather than of its arc, so anchoring to it would point at the ring's center\nfor every slice.\n\n**And the arrow now follows from placement rather than from a compass.** The\nchart says which side it prefers and `FloatingController` moves it if that\nside does not fit, which is how a slice at any bearing gets a bubble that\npoints at it. Four hard-coded sides could not express a bearing, which is what\nmade the donut's arrow miss its own ring.\n\n**It shows the table's text and not the chart's numbers.** `$128k` is what the\ncell says and `128000` is what the drawing measured. Every cell of the row is\nhere, including columns nothing was plotted from, because a note beside the\nfigures is most of the reason to want a tooltip.\n\n**Hidden from assistive technology, on purpose.** The table is the accessible\nrepresentation and the drawing is `aria-hidden`; a reader on a keyboard gets\nthe table, which they can reach, rather than a tooltip which they cannot."
+          "description": "What a pointer resting on a reading shows, as `Tooltip` pointed at a mark.\n\n**A chart does not draw its own tooltip, and the top layer is why.** `Tooltip`\nrenders `popover=\"manual\"` through `PopoverController`, so it clears every\nstacking context and every `overflow` on the page. A box drawn by the chart is\n`position: absolute` inside the plot and is confined to the chart's own\ncontext, so it is clipped by, or layered under, whatever sits beside the\nchart. Escaping that means reimplementing `PopoverController`, which is\n`Tooltip` with extra steps and a second copy of the hard part.\n\n**`for` was already the anchor and needed nothing added.** It resolves in the\ntree the tooltip sits in, and the mark is in the same shadow root, so a chart\nnames an element inside itself and `Tooltip` finds it. What the chart\nprovides is an invisible mark at the reading's point.\n\n**An HTML mark rather than the `<rect>` or `<circle>` already there.**\n`FloatingController` types its anchor as `HTMLElement` and an SVG element is\nnot one; and a slice's `<circle>` has the bounding box of the whole ring\nrather than of its arc, so anchoring to it would point at the ring's center\nfor every slice.\n\n**And the arrow now follows from placement rather than from a compass.** The\nchart says which side it prefers and `FloatingController` moves it if that\nside does not fit, which is how a slice at any bearing gets a bubble that\npoints at it. Four hard-coded sides could not express a bearing, which is what\nmade the donut's arrow miss its own ring.\n\n**It shows the table's text and not the chart's numbers.** `$128k` is what the\ncell says and `128000` is what the drawing measured. Every cell of the row is\nhere, including columns nothing was plotted from, because a note beside the\nfigures is most of the reason to want a tooltip.\n\n**Hidden from assistive technology, on purpose.** The table is the accessible\nrepresentation and the drawing is `aria-hidden`; a reader on a keyboard gets\nthe table, which they can reach, rather than a tooltip which they cannot."
         }
       ],
       "exports": [
@@ -10213,6 +10493,79 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/element-by-id/element-by-id.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "elementById",
+          "return": {
+            "type": {
+              "text": "HTMLElement | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "from",
+              "type": {
+                "text": "Node"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "options",
+              "optional": true,
+              "type": {
+                "text": "ElementByIdOptions"
+              }
+            }
+          ],
+          "description": "The element an id names, looked up in the tree the node sits in.\n\n**`getRootNode()` rather than `document`, which is what makes a component\ncomposable.** An id is unique to a tree and not to a page, so a component\ninside another component's shadow root names an element in that root. Asking\nthe document finds nothing there, and on a page where the name is taken it\nfinds an element in somebody else's tree.\n\n**What `getRootNode()` returns need not be able to answer, and that guard is\nload-bearing in both environments this library runs in.** Measured 18 Sep\n2026, and held by the two specs beside this file. Under Lit SSR's DOM shim\n`getRootNode()` returns a `Document` carrying no `getElementById` at all, so\nan unguarded call is a `TypeError` rather than a miss and takes the whole\nserver render down the first time a component resolves `for`. In Chromium and\nin happy-dom alike an element that is not connected is its own root, and an\n`HTMLElement` has no lookup either, which is the reading every caller here is\none detached element away from.\n\nA `DocumentFragment` is not a case, which is worth saying because it looks\nlike the obvious one: `getElementById` comes from `NonElementParentNode`, so a\nbare fragment and a `<template>`'s content both carry it.\n\n**Decoding stays at the call site.** `SkipLink` and `Outline` take an `href`\nand owe it a `decodeURIComponent`; the callers that take an id property do\nnot, and a utility that decoded would corrupt a literal `%` in one of theirs."
+        },
+        {
+          "kind": "function",
+          "name": "searchableById",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "from",
+              "type": {
+                "text": "Node"
+              }
+            }
+          ],
+          "description": "Whether ids resolve at all in the tree this node sits in.\n\nThe same platform fact as `elementById`'s guard, asked as a question, for a\ncomponent that has to tell \"no such element\" from \"no tree to look in\".\n`Heatmap` is the case and its note gives the cost: an empty state served\nbecause a server could not resolve `for` is a crawler reading \"No readings\"\nover ninety days of them."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "elementById",
+          "declaration": {
+            "name": "elementById",
+            "module": "src/utils/element-by-id/element-by-id.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "searchableById",
+          "declaration": {
+            "name": "searchableById",
+            "module": "src/utils/element-by-id/element-by-id.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/focusable-elements/focusable-elements.ts",
@@ -10476,6 +10829,40 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/is-rtl/is-rtl.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "isRtl",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "Element"
+              }
+            }
+          ],
+          "description": "Whether the line of text an element sits on runs right to left.\n\n**The computed `direction`, not `:dir()` and not the `dir` attribute.** The\nthree part only where a sheet sets `direction` without an attribute, and\nthere the row on screen is laid out by `direction`: a flex row and a grid\nboth follow it. `inlineStep` makes that argument in full, and it is the same\nquestion in every caller here, which is why there is one answer to it.\n\n**Guarded, because a server shim need not have `getComputedStyle`.** Most\ncallers reach this from a pointer handler and so only ever in a browser, but\n`ScatterChart` asks inside `renderTooltip`, one early return from the render\npath. Without the function there is no layout to read, so the answer is the\ndirection a document has before anything says otherwise.\n\nAsked at the moment it is needed rather than held, so a page that changes its\ndirection is answered in the new one without anything having to watch it."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "isRtl",
+          "declaration": {
+            "name": "isRtl",
+            "module": "src/utils/is-rtl/is-rtl.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/line-path/line-path.ts",
@@ -11105,6 +11492,46 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/split-values/split-values.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "splitValues",
+          "return": {
+            "type": {
+              "text": "string[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "separator",
+              "type": {
+                "text": "',' | ' '"
+              }
+            }
+          ],
+          "description": "One CSS value list split into its values, never inside a function or a\nbracket.\n\nThe separator is the one the property uses: a comma for a list of colors, a\nspace for a list of grid tracks. Whichever it is, the trap is the same one\nfrom opposite sides. `split(',')` turns\n`#ef4444, rgb(249 115 22), rgba(34,197,94,.5)` into six fragments, four of\nthem not colors, and a row of swatches quietly draws three instead of four.\n`split(/\\s+/)` turns `minmax(0, 1fr)` into two tracks, and a grid given a\ntrack it cannot read draws one column. Both spellings look like they work,\nbecause the modern space-separated color forms and the single-keyword tracks\nsurvive them.\n\nDepth rather than a regular expression, because what matters is whether the\nseparator is inside a call and that is exactly what a counter answers.\nBrackets count with parentheses, since a grid's line names are written in\nthem. Nesting is counted rather than assumed away: `minmax(0, calc(1px + 1%))`\nis one value.\n\nEmpty values are dropped, so a leading, doubled or trailing separator leaves\nnothing behind to be parsed as a value nobody wrote."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "splitValues",
+          "declaration": {
+            "name": "splitValues",
+            "module": "src/utils/split-values/split-values.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/tell-disclosure/tell-disclosure.ts",
@@ -11356,6 +11783,60 @@
           ],
           "description": "The `HH:mm` value for a time, or the empty string.\n\nSeconds are written only where there are any, because `HH:mm` is what this\nlibrary's time controls hold and a trailing `:00` on every value would be a\nformat change dressed as a conversion."
         },
+        {
+          "kind": "function",
+          "name": "valueAsMinutes",
+          "return": {
+            "type": {
+              "text": "number | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The minutes since midnight an `HH:mm` value names, or `null`.\n\n**Minute precision, which is narrower than `valueAsTime` above and is meant\nto be.** That one takes seconds because `<input type=\"time\">` does at a step\nbelow a minute. This library's time controls have no such step: theirs is in\nminutes and floored at one, so nothing they offer or write ever carries a\nsecond, and a value that did would lose it here silently. Two readings of one\nstring, and a control picks the one it can hold."
+        },
+        {
+          "kind": "function",
+          "name": "minutesAsValue",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "minutes",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Minutes since midnight as `HH:mm`, wrapping rather than running off the day.\n\nA step past midnight is the next morning, which is what a list of offered\ntimes does at its end and what an arrow key does at either."
+        },
+        {
+          "kind": "function",
+          "name": "isTimeValue",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Whether a value is a time these controls can hold, which is minute precision."
+        },
         {
           "kind": "function",
           "name": "valueAsNumber",
@@ -11434,6 +11915,30 @@
             "module": "src/utils/value-as/value-as.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "valueAsMinutes",
+          "declaration": {
+            "name": "valueAsMinutes",
+            "module": "src/utils/value-as/value-as.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "minutesAsValue",
+          "declaration": {
+            "name": "minutesAsValue",
+            "module": "src/utils/value-as/value-as.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isTimeValue",
+          "declaration": {
+            "name": "isTimeValue",
+            "module": "src/utils/value-as/value-as.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "valueAsNumber",
@@ -11452,6 +11957,47 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/write-time/write-time.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "writeTime",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "locale",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "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."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "writeTime",
+          "declaration": {
+            "name": "writeTime",
+            "module": "src/utils/write-time/write-time.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/written-list/written-list.ts",
@@ -11473,6 +12019,24 @@
             }
           ],
           "description": "A list a consumer wrote into an attribute, split the way they write one.\n\n**Whitespace or commas, because a reader listing words puts commas between\nthem.** A split on whitespace alone turns `extra-controls=\"speed, pip\"` into\n`speed,` and `pip`, and `speed,` is not a control name: the control is\ndropped, nothing is logged, and the docblock on the property says\nunrecognized values are skipped, so the behavior looks like the documented\none. That is the undebuggable case `gridlines` names in its own docblock,\narrived at from the other direction, and it is why the widest spelling is the\none every consumer-written list takes.\n\n**Not for a value.** A payload is comma separated and nothing else, because a\nvalue may hold a space: splitting `value=\"New York,Paris\"` on whitespace\nwould submit a city that does not exist. Select, Listbox, Combobox and\nCheckbox Group each split their own value on a comma and trim, which is the\nother rule and not a lesser version of this one.\n\n**Nor for an IDREF list**, which is the platform's own format: `aria-*` and\n`for` take whitespace and only whitespace, and accepting a comma there would\nresolve an id nobody can write."
+        },
+        {
+          "kind": "function",
+          "name": "writtenNumbers",
+          "return": {
+            "type": {
+              "text": "number[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "source",
+              "type": {
+                "text": "string | undefined"
+              }
+            }
+          ],
+          "description": "The same list read as numbers, with everything that is not one dropped.\n\n**A stray entry leaves rather than becoming `NaN`.** A comparison against\n`NaN` is false in both directions and a `NaN` drawn is nothing at all, so one\nmistyped bound in `thresholds=\"0, 1, x, 6\"` would color cells by a rule no\nreader can see. Dropped, the rest of the list still means what it says.\n\n**Which numbers count is the caller's question.** Finiteness is all this can\nanswer, because a number that makes sense here is a bound, a reading and a\nplayback rate, and only the caller knows that a rate of zero is not a rate."
         }
       ],
       "exports": [
@@ -11483,6 +12047,14 @@
             "name": "writtenList",
             "module": "src/utils/written-list/written-list.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "writtenNumbers",
+          "declaration": {
+            "name": "writtenNumbers",
+            "module": "src/utils/written-list/written-list.ts"
+          }
         }
       ]
     }