@fusion.dev/helix-headless 0.58.1 → 0.59.0

package/custom-elements.json

@@ -2694,7 +2694,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -3171,7 +3171,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -5316,7 +5316,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -5791,7 +5791,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -7980,7 +7980,7 @@
                   "text": "HTMLElement | null"
                 }
               },
-              "description": "The element this button commands, or nothing.\n\nLooked up in the button's own root rather than in the document, so a button\ninside somebody else's shadow root finds a target in that same root and not\na coincidence in the page."
+              "description": "The element this button commands, or nothing."
             },
             {
               "kind": "method",
@@ -19205,7 +19205,7 @@
                 "text": "string[]"
               },
               "privacy": "private",
-              "description": "The presets, as written, with anything that is not a color dropped.",
+              "description": "The presets, as written, with anything that is not a color dropped.\n\nSplit on the commas between colors and never inside one, so\n`rgba(34,197,94,.5)` stays one swatch rather than four fragments none of\nwhich parses.",
               "readonly": true
             },
             {
@@ -23743,7 +23743,7 @@
                   "text": "HTMLElement | null"
                 }
               },
-              "description": "The element this button commands, or nothing.\n\nLooked up in the button's own root rather than in the document, so a button\ninside somebody else's shadow root finds a target in that same root and not\na coincidence in the page.",
+              "description": "The element this button commands, or nothing.",
               "inheritedFrom": {
                 "name": "HelixHeadlessButton",
                 "module": "src/button/root/button-root.ts"
@@ -33275,7 +33275,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -33734,7 +33734,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -42778,14 +42778,6 @@
             "module": "./root/buckets.js"
           }
         },
-        {
-          "kind": "js",
-          "name": "numbers",
-          "declaration": {
-            "name": "numbers",
-            "module": "./root/buckets.js"
-          }
-        },
         {
           "kind": "js",
           "name": "Reading",
@@ -42802,14 +42794,6 @@
             "module": "./root/buckets.js"
           }
         },
-        {
-          "kind": "js",
-          "name": "words",
-          "declaration": {
-            "name": "words",
-            "module": "./root/buckets.js"
-          }
-        },
         {
           "kind": "js",
           "name": "HelixHeadlessHeatmap",
@@ -42854,42 +42838,6 @@
           ],
           "description": "The tone for one reading, from its own `data-tone` or from the thresholds.\n\n**The cell's own tone wins**, and that ordering is the whole reason both\nexist. A status page already knows a day was degraded; making it encode that\nas a number so a component can decode it again is work for nothing, and the\nencoding would have to agree with the thresholds or the colors would drift\nfrom the truth. A contribution graph has only counts and wants the buckets.\n\nThresholds are read as lower bounds, in the order given, and the last one that\na value reaches wins. `thresholds=\"0,1,3,6\"` with `tones=\"muted,info,accent,success\"`\nputs 0 in `muted`, 1 and 2 in `info`, 3 to 5 in `accent`, and 6 upward in\n`success`. A value below the first bound gets no tone rather than the first\none: an empty cell in a contribution graph is a day with nothing in it, and\npainting it as the lowest bucket claims a reading that does not exist."
         },
-        {
-          "kind": "function",
-          "name": "numbers",
-          "return": {
-            "type": {
-              "text": "number[]"
-            }
-          },
-          "parameters": [
-            {
-              "name": "source",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "A consumer's list of numbers, in the order written, with the rest dropped."
-        },
-        {
-          "kind": "function",
-          "name": "words",
-          "return": {
-            "type": {
-              "text": "string[]"
-            }
-          },
-          "parameters": [
-            {
-              "name": "source",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "A consumer's list of names, in the order written."
-        },
         {
           "kind": "function",
           "name": "fits",
@@ -42940,22 +42888,6 @@
             "module": "src/heatmap/root/buckets.ts"
           }
         },
-        {
-          "kind": "js",
-          "name": "numbers",
-          "declaration": {
-            "name": "numbers",
-            "module": "src/heatmap/root/buckets.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "words",
-          "declaration": {
-            "name": "words",
-            "module": "src/heatmap/root/buckets.ts"
-          }
-        },
         {
           "kind": "js",
           "name": "fits",
@@ -43275,7 +43207,7 @@
                 "text": "boolean"
               },
               "privacy": "private",
-              "description": "Whether this render can tell a table with no readings from one it has not\nresolved yet.\n\n**Unknown is not empty, which is what an empty state must never say.**\n`for` names an id and resolving an id wants a document, so a server has\nnone and a hydrating render must not look either. Without this the server\ndrew \"No readings\" over a table holding ninety days of them, a crawler read\nthat sentence, and the strip flipped to a full one on hydration: the fault\n`MixinCollection` names for a slotted collection, arriving through the one\nchannel that mixin cannot see.\n\nThe same shape as `childrenKnown`, asked of a document rather than of a\ntree. An id that resolves to nothing in a browser is still known, and still\nempty: a `for` naming no table should say so rather than sit blank.",
+              "description": "Whether this render can tell a table with no readings from one it has not\nresolved yet.\n\n**Unknown is not empty, which is what an empty state must never say.**\n`for` names an id and resolving an id wants a document, so a server has\nnone and a hydrating render must not look either. Without this the server\ndrew \"No readings\" over a table holding ninety days of them, a crawler read\nthat sentence, and the strip flipped to a full one on hydration: the fault\n`MixinCollection` names for a slotted collection, arriving through the one\nchannel that mixin cannot see.\n\nThe same shape as `childrenKnown`, asked of a tree that can answer about\nids rather than of one that holds children. An id that resolves to nothing\nin a browser is still known, and still empty: a `for` naming no table\nshould say so rather than sit blank, which is why this asks\n`searchableById` and not `elementById`.",
               "readonly": true
             },
             {
@@ -43404,7 +43336,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -43911,7 +43843,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -44520,7 +44452,7 @@
                   "text": "HTMLElement | null"
                 }
               },
-              "description": "The element this button commands, or nothing.\n\nLooked up in the button's own root rather than in the document, so a button\ninside somebody else's shadow root finds a target in that same root and not\na coincidence in the page.",
+              "description": "The element this button commands, or nothing.",
               "inheritedFrom": {
                 "name": "HelixHeadlessButton",
                 "module": "src/button/root/button-root.ts"
@@ -49176,7 +49108,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to take the names from.\n\nResolved through `getRootNode()`, so a legend inside another component's\nshadow root names a table in that root rather than in the document.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to take the names from.\n\nNames a table in the same tree, so a legend inside another component's\nshadow root reads a table in that root rather than one in the document.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for"
             },
             {
@@ -49537,7 +49469,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to take the names from.\n\nResolved through `getRootNode()`, so a legend inside another component's\nshadow root names a table in that root rather than in the document.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to take the names from.\n\nNames a table in the same tree, so a legend inside another component's\nshadow root reads a table in that root rather than one in the document.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for"
             }
           ],
@@ -50095,7 +50027,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -50580,7 +50512,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -63925,7 +63857,7 @@
                 "text": "{ link: HTMLAnchorElement; target: Element }[]"
               },
               "privacy": "private",
-              "description": "What each link points at, paired with the link, skipping anything missing.",
+              "description": "What each link points at, paired with the link, skipping anything missing.\n\nThe fragment is decoded first because these are `href`s and not ids. The\nlookup is the tree's alone: this intercepts no press, so it has no\nnavigation to agree with, and a section it cannot see is one it is not\ndescribing.",
               "readonly": true
             },
             {
@@ -74138,7 +74070,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "attribute": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -74582,7 +74514,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the table to read.\n\nResolved through `getRootNode()`, so a chart inside another component's\nshadow root names a table in that root rather than in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
+              "description": "The id of the table to read.\n\nNames a table in the same tree, so a chart inside another component's\nshadow root reads a table in that root rather than one in the document. A\n`<table>` or anything built from grid roles, including `helix-table`.\n\n**In React this arrives as a property and not as an attribute**, the way\n`Tooltip.for` does, so it does not reflect and nothing styles on it.",
               "fieldName": "for",
               "inheritedFrom": {
                 "name": "MixinChartSource",
@@ -77279,7 +77211,7 @@
                 "text": "HTMLElement | null"
               },
               "privacy": "private",
-              "description": "The element `href` names, looked up in the tree this link sits in.",
+              "description": "The element `href` names, looked up the way the browser would.\n\n`orDocument`, which no other caller of `elementById` passes and which that\noption is written for: a press handled here has to land where following the\nanchor would, and the platform resolves a fragment against the document\nwhatever tree the anchor is in. A skip link inside an app shell's shadow\nroot pointing at the page's `#main` is the arrangement that needs it.\n\nThe fragment is decoded first because this is an `href` and not an id.",
               "readonly": true
             },
             {
@@ -93955,85 +93887,6 @@
       "kind": "javascript-module",
       "path": "src/time-picker/root/time-picker-root.ts",
       "declarations": [
-        {
-          "kind": "function",
-          "name": "isTime",
-          "return": {
-            "type": {
-              "text": "boolean"
-            }
-          },
-          "parameters": [
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Whether a string is a time the rest of this component can reason about.\n\n**Narrower than core's `valueAsTime` on purpose, and the difference is\nseconds.** That one takes them because `<input type=\"time\">` does, at a step\nbelow a minute. This library has no such step: `step` here is minutes and is\nfloored at one, so nothing it offers or writes ever carries a second, and\n`toMinutes` below would drop one silently if this let it through. Widening\nthis to the platform's shape would let a value in that the rest of the family\ncannot hold."
-        },
-        {
-          "kind": "function",
-          "name": "toMinutes",
-          "return": {
-            "type": {
-              "text": "number | null"
-            }
-          },
-          "parameters": [
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Minutes since midnight, or `null` where it is not a time."
-        },
-        {
-          "kind": "function",
-          "name": "fromMinutes",
-          "return": {
-            "type": {
-              "text": "string"
-            }
-          },
-          "parameters": [
-            {
-              "name": "minutes",
-              "type": {
-                "text": "number"
-              }
-            }
-          ],
-          "description": "Minutes since midnight back to `HH:mm`, which is the value shape throughout."
-        },
-        {
-          "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 this component: `en-US` gets\n`2:30 PM` and `en-GB` gets `14:30` without either being configured. There is\nno flag to force one, deliberately. A product that needs to override its\nreader's own convention has a locale problem rather than a component one, and\nthe value is 24 hour regardless."
-        },
         {
           "kind": "class",
           "description": "**A list rather than three wheels**, and the reason is what a list already\nis. `Listbox` brings the keyboard, the typeahead, the scroll into view and\nthe announcement of a set of options, and a time at a step is a set of\noptions. Three little wheels for hours, minutes and a meridiem are three\ncontrols to build, three to test, and a tab stop each for something a reader\nanswers once.\n\n**A step is what makes it a list at all.** Fifteen minutes is ninety-six rows,\nwhich a reader scrolls or types into; one minute is one thousand four hundred\nand forty, which is a listbox in name only. So the list is for the times a\nproduct actually offers, and arbitrary times are the field's job in Input\nTime, the same division Date Input draws between typing a date and using the\ncalendar.\n\n**The value is `HH:mm` on a twenty-four hour clock, always.** That is what a\nform submits and what `min` and `max` compare against, and it sorts as a\nstring, which is the whole reason the shape is that one. What each row *says*\nis the reader's own convention, from `Intl`.\n\n**The chosen row is marked in the markup, not worked out on upgrade.** The\nlistbox is handed the answer as `.value`, and lit-ssr serializes no property\nbinding, so a served `value=\"09:30\"` shipped ninety-six rows with nothing on\nany of them saying which one it was: the mark arrived when the listbox\nupgraded and ran `place`. So each option is given `selected` as well, which\nis an attribute binding and does serve, and which the listbox then agrees\nwith rather than fights, `place` writing the same answer from the same value.\n`selected` is the declaration a consumer writes on `Option` anywhere else in\nthe library, and Date Picker expresses its own choice as markup for the same\nreason: a picker whose answer is invisible until a script runs is a picker\nwhose answer is not served at all. Both readings do it, the list and the\nwheels, a wheel being a listbox like the list is.",
@@ -95441,38 +95294,6 @@
         }
       ],
       "exports": [
-        {
-          "kind": "js",
-          "name": "isTime",
-          "declaration": {
-            "name": "isTime",
-            "module": "src/time-picker/root/time-picker-root.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "toMinutes",
-          "declaration": {
-            "name": "toMinutes",
-            "module": "src/time-picker/root/time-picker-root.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "fromMinutes",
-          "declaration": {
-            "name": "fromMinutes",
-            "module": "src/time-picker/root/time-picker-root.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "writeTime",
-          "declaration": {
-            "name": "writeTime",
-            "module": "src/time-picker/root/time-picker-root.ts"
-          }
-        },
         {
           "kind": "js",
           "name": "HelixHeadlessTimePicker",
@@ -100065,7 +99886,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the element this describes, in this tooltip's own tree.\n\nSet it and the tooltip stops wrapping: it renders no trigger, listens on\nthe element it names, and points its bubble there. Leave it unset and the\ndefault slot is the trigger, which is the older form.\n\nResolved through `getRootNode()`, so a tooltip inside another component's\nshadow root names an element in that root rather than in the document.\n\n**In React this arrives as a property and not as an attribute**, which is\nworth knowing before someone reads the DOM and thinks it did not take.\nMeasured against React 19.2.8: `for` exists on the prototype, so React sets\n`element.for = 'save'` and writes nothing to the markup, where `content`\nand `placement`, which are not properties on the class at that moment, come\nthrough as attributes. Both paths reach the same place through Lit, so\nnothing is broken by it; a `[for]` selector would find nothing, which is\nwhy this does not reflect and nothing styles on it.",
+              "description": "The id of the element this describes, in this tooltip's own tree.\n\nSet it and the tooltip stops wrapping: it renders no trigger, listens on\nthe element it names, and points its bubble there. Leave it unset and the\ndefault slot is the trigger, which is the older form.\n\nNames an element in the same tree, so a tooltip inside another component's\nshadow root points at one in that root rather than one in the document.\n\n**In React this arrives as a property and not as an attribute**, which is\nworth knowing before someone reads the DOM and thinks it did not take.\nMeasured against React 19.2.8: `for` exists on the prototype, so React sets\n`element.for = 'save'` and writes nothing to the markup, where `content`\nand `placement`, which are not properties on the class at that moment, come\nthrough as attributes. Both paths reach the same place through Lit, so\nnothing is broken by it; a `[for]` selector would find nothing, which is\nwhy this does not reflect and nothing styles on it.",
               "attribute": "for"
             },
             {
@@ -100164,7 +99985,7 @@
                 "text": "HTMLElement | null"
               },
               "privacy": "private",
-              "description": "The element `for` names, or null.\n\n`getRootNode()` rather than `document`, which is what makes this work inside\nanother component: an id is unique to a tree, and a tooltip in a shadow root\nnames an element in that root. Client only, since the server has no tree to\nsearch.",
+              "description": "The element `for` names, or null.",
               "readonly": true
             },
             {
@@ -100842,7 +100663,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The id of the element this describes, in this tooltip's own tree.\n\nSet it and the tooltip stops wrapping: it renders no trigger, listens on\nthe element it names, and points its bubble there. Leave it unset and the\ndefault slot is the trigger, which is the older form.\n\nResolved through `getRootNode()`, so a tooltip inside another component's\nshadow root names an element in that root rather than in the document.\n\n**In React this arrives as a property and not as an attribute**, which is\nworth knowing before someone reads the DOM and thinks it did not take.\nMeasured against React 19.2.8: `for` exists on the prototype, so React sets\n`element.for = 'save'` and writes nothing to the markup, where `content`\nand `placement`, which are not properties on the class at that moment, come\nthrough as attributes. Both paths reach the same place through Lit, so\nnothing is broken by it; a `[for]` selector would find nothing, which is\nwhy this does not reflect and nothing styles on it.",
+              "description": "The id of the element this describes, in this tooltip's own tree.\n\nSet it and the tooltip stops wrapping: it renders no trigger, listens on\nthe element it names, and points its bubble there. Leave it unset and the\ndefault slot is the trigger, which is the older form.\n\nNames an element in the same tree, so a tooltip inside another component's\nshadow root points at one in that root rather than one in the document.\n\n**In React this arrives as a property and not as an attribute**, which is\nworth knowing before someone reads the DOM and thinks it did not take.\nMeasured against React 19.2.8: `for` exists on the prototype, so React sets\n`element.for = 'save'` and writes nothing to the markup, where `content`\nand `placement`, which are not properties on the class at that moment, come\nthrough as attributes. Both paths reach the same place through Lit, so\nnothing is broken by it; a `[for]` selector would find nothing, which is\nwhy this does not reflect and nothing styles on it.",
               "fieldName": "for"
             },
             {

package/dist/button/root/button-root.d.ts

@@ -209,13 +209,7 @@ export declare class HelixHeadlessButton extends HelixFormElement {
      * The same asymmetry the listbox relies on for `aria-activedescendant`.
      */
     private linkCommand;
-    /**
-     * The element this button commands, or nothing.
-     *
-     * Looked up in the button's own root rather than in the document, so a button
-     * inside somebody else's shadow root finds a target in that same root and not
-     * a coincidence in the page.
-     */
+    /** The element this button commands, or nothing. */
     private commandTarget;
     /**
      * Sends the `command` event where the browser will not.

package/dist/button/root/button-root.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { AriaForwardController, customElement, HelixFallbackCommandEvent, HelixFormElement, supportsInvokers, } from '@fusion.dev/helix-core';
+import { AriaForwardController, customElement, elementById, HelixFallbackCommandEvent, HelixFormElement, supportsInvokers, } from '@fusion.dev/helix-core';
 import { html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';
 let HelixHeadlessButton = class HelixHeadlessButton extends HelixFormElement {
@@ -104,8 +104,7 @@ let HelixHeadlessButton = class HelixHeadlessButton extends HelixFormElement {
             this.commandTarget();
     }
     commandTarget() {
-        const root = this.getRootNode();
-        return this.commandFor ? (root.getElementById?.(this.commandFor) ?? null) : null;
+        return this.commandFor ? elementById(this, this.commandFor) : null;
     }
     sendCommand() {
         if (!this.command || supportsInvokers()) {

package/dist/carousel/root/carousel-root.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { customElement, HelixElement, HelixSelectEvent, hostAria, inlineStep, requestChange, } from '@fusion.dev/helix-core';
+import { customElement, HelixElement, HelixSelectEvent, hostAria, inlineStep, isRtl, requestChange, } from '@fusion.dev/helix-core';
 import { caretLeft, caretRight, play, stop } from '@fusion.dev/helix-icons';
 import { html, nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
@@ -199,7 +199,7 @@ let HelixHeadlessCarousel = class HelixHeadlessCarousel extends HelixElement {
         if (this.orientation === 'vertical') {
             return slide.offsetTop - track.offsetTop - bleed;
         }
-        if (getComputedStyle(track).direction === 'rtl') {
+        if (isRtl(track)) {
             return slide.offsetLeft + slide.offsetWidth - (track.offsetLeft + track.offsetWidth) + bleed;
         }
         return slide.offsetLeft - track.offsetLeft - bleed;

package/dist/color-picker/root/color-picker-root.d.ts

@@ -222,7 +222,13 @@ export declare class HelixHeadlessColorPicker extends HelixHeadlessColorPicker_b
      * padding with nothing in it.
      */
     private get tools();
-    /** The presets, as written, with anything that is not a color dropped. */
+    /**
+     * The presets, as written, with anything that is not a color dropped.
+     *
+     * Split on the commas between colors and never inside one, so
+     * `rgba(34,197,94,.5)` stays one swatch rather than four fragments none of
+     * which parses.
+     */
     private get presets();
     /**
      * The last value that was a color.

package/dist/color-picker/root/color-picker-root.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { CopyController, capturePointer, customElement, drawIcon, formatColor, HelixFormElement, HelixSampleEndEvent, HelixSampleStartEvent, MixinControllerValue, parseColor, splitColors, toCss, } from '@fusion.dev/helix-core';
+import { CopyController, capturePointer, customElement, drawIcon, formatColor, HelixFormElement, HelixSampleEndEvent, HelixSampleStartEvent, isRtl, MixinControllerValue, parseColor, splitValues, toCss, } from '@fusion.dev/helix-core';
 import { eyedropper } from '@fusion.dev/helix-icons';
 import { nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
@@ -101,7 +101,7 @@ let HelixHeadlessColorPicker = class HelixHeadlessColorPicker extends MixinContr
                 return;
             }
             const fromLeft = Math.min(1, Math.max(0, (event.clientX - box.left) / box.width));
-            const across = getComputedStyle(grid).direction === 'rtl' ? 1 - fromLeft : fromLeft;
+            const across = isRtl(grid) ? 1 - fromLeft : fromLeft;
             const down = Math.min(1, Math.max(0, (event.clientY - box.top) / box.height));
             this.move({ brightness: Math.round((1 - down) * 100), saturation: Math.round(across * 100) });
         };
@@ -113,7 +113,7 @@ let HelixHeadlessColorPicker = class HelixHeadlessColorPicker extends MixinContr
         return (this.sampling && !this.noEyedropper) || !this.noFormat;
     }
     get presets() {
-        return splitColors(this.swatches).filter((one) => parseColor(one) !== null);
+        return splitValues(this.swatches, ',').filter((one) => parseColor(one) !== null);
     }
     requestValue(next) {
         if (this.readOnly) {

package/dist/data-table/root/data-table-root.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 var HelixHeadlessDataTable_1;
-import { customElement, HelixElement, HelixFilterEvent, HelixNavigateEvent, HelixReorderEvent, HelixSelectEvent, HelixSortEvent, hostAria, inlineStep, MixinCollection, markRegion, requestChange, VirtualizeController, writtenList, } from '@fusion.dev/helix-core';
+import { customElement, HelixElement, HelixFilterEvent, HelixNavigateEvent, HelixReorderEvent, HelixSelectEvent, HelixSortEvent, hostAria, inlineStep, isRtl, MixinCollection, markRegion, requestChange, VirtualizeController, writtenList, } from '@fusion.dev/helix-core';
 import { nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
 import { repeat } from 'lit/directives/repeat.js';
@@ -124,7 +124,7 @@ let HelixHeadlessDataTable = class HelixHeadlessDataTable extends MixinCollectio
             if (!dragging || event.pointerId !== dragging.pointer || !this.dragOrder) {
                 return;
             }
-            const rtl = getComputedStyle(this).direction === 'rtl';
+            const rtl = isRtl(this);
             const others = this.shownColumns.filter((column) => column.field !== '' && column.field !== dragging.field);
             const place = others.filter((column) => {
                 const box = column.shadowRoot?.querySelector('[part="column"]')?.getBoundingClientRect();

package/dist/heatmap/index.d.ts

@@ -1,2 +1,2 @@
-export { fits, numbers, type Reading, toneOf, words } from './root/buckets.js';
+export { fits, type Reading, toneOf } from './root/buckets.js';
 export { HelixHeadlessHeatmap } from './root/heatmap-root.js';

package/dist/heatmap/index.js

@@ -1,2 +1,2 @@
-export { fits, numbers, toneOf, words } from './root/buckets.js';
+export { fits, toneOf } from './root/buckets.js';
 export { HelixHeadlessHeatmap } from './root/heatmap-root.js';

package/dist/heatmap/root/buckets.d.ts

@@ -29,10 +29,6 @@ export interface Reading {
  * painting it as the lowest bucket claims a reading that does not exist.
  */
 export declare const toneOf: (reading: Reading, thresholds: readonly number[], tones: readonly string[]) => string | undefined;
-/** A consumer's list of numbers, in the order written, with the rest dropped. */
-export declare const numbers: (source: string) => number[];
-/** A consumer's list of names, in the order written. */
-export declare const words: (source: string) => string[];
 /**
  * How many readings fit across a given width, and which ones they are.
  *

package/dist/heatmap/root/buckets.js

@@ -1,4 +1,3 @@
-import { writtenList } from '@fusion.dev/helix-core';
 export const toneOf = (reading, thresholds, tones) => {
     if (reading.tone) {
         return reading.tone;
@@ -14,10 +13,6 @@ export const toneOf = (reading, thresholds, tones) => {
     }
     return chosen;
 };
-export const numbers = (source) => writtenList(source)
-    .map(Number)
-    .filter((one) => Number.isFinite(one));
-export const words = (source) => writtenList(source);
 export const fits = (total, width, minimum, gap, rows = 1) => {
     if (!Number.isFinite(width) || width <= 0 || minimum <= 0) {
         return total;

package/dist/heatmap/root/heatmap-root.d.ts

@@ -211,9 +211,11 @@ export declare class HelixHeadlessHeatmap extends HelixHeadlessHeatmap_base {
      * `MixinCollection` names for a slotted collection, arriving through the one
      * channel that mixin cannot see.
      *
-     * The same shape as `childrenKnown`, asked of a document rather than of a
-     * tree. An id that resolves to nothing in a browser is still known, and still
-     * empty: a `for` naming no table should say so rather than sit blank.
+     * The same shape as `childrenKnown`, asked of a tree that can answer about
+     * ids rather than of one that holds children. An id that resolves to nothing
+     * in a browser is still known, and still empty: a `for` naming no table
+     * should say so rather than sit blank, which is why this asks
+     * `searchableById` and not `elementById`.
      */
     private get sourceKnown();
     /**