@fusion.dev/helix 0.44.0 → 0.46.0

package/custom-elements.json

@@ -14517,7 +14517,7 @@
               "type": {
                 "text": "HelixSelectEvent"
               },
-              "description": "Fired when the slide in view changes, with its index. Cancelable where the carousel is about to move: refusing a control or an indicator takes the decision and nothing moves. A drag has already moved the track, so that one announces after the fact and refusing it does nothing. See `handleScroll`.",
+              "description": "Fired before the slide in view changes, with the index being asked for. Cancelable: refusing it takes the decision and nothing moves, including a drag, which is put back on the slide the index still holds. See `handleScroll`.",
               "name": "helix-select",
               "reactProp": "onhelix-select",
               "inheritedFrom": {
@@ -15700,7 +15700,7 @@
               "type": {
                 "text": "'failed' | 'sending' | 'sent' | 'streaming' | undefined"
               },
-              "description": "What has happened to it.\n\nReflected, because every one of the four is a visual state and a stylesheet\nhas no other way to know. Absent is a settled message with nothing to\nreport, which is what most of a transcript is, and it is the absence of the\nattribute rather than a value of it: there is no initializer, so nothing is\nreflected until something happens.",
+              "description": "What has happened to it.\n\nReflected, because every one of the four is a visual state and a stylesheet\nhas no other way to know. Absent is a settled message with nothing to\nreport, which is what most of a transcript is, and it is the absence of the\nattribute rather than a value of it: there is no initializer, so nothing is\nreflected until something happens.\n\n**The turn writes this once, on a retry nobody refused**, and `handleRetry`\nholds the reason. Everything else that moves it is the consumer's.",
               "attribute": "state",
               "reflects": true,
               "inheritedFrom": {
@@ -15825,7 +15825,7 @@
               "name": "handleRetry",
               "privacy": "private",
               "readonly": true,
-              "description": "Retry is `helix-send` again, from the message rather than the composer.\n\n**Not an event of its own**, because a retry is the same request: the reader\nis offering what they wrote, and the only difference is which element is\noffering it. A listener that wants to tell them apart has `event.target`,\nwhich is the message on a retry and the composer on a first send, and that\nis a distinction the DOM already makes without a second name for it.",
+              "description": "Retry is `helix-send` again, from the message rather than the composer.\n\n**Not an event of its own**, because a retry is the same request: the reader\nis offering what they wrote, and the only difference is which element is\noffering it. A listener that wants to tell them apart has `event.target`,\nwhich is the message on a retry and the composer on a first send, and that\nis a distinction the DOM already makes without a second name for it.\n\n**Through `requestChange`, and the turn is what moves.** `helix-send` is\ncancelable because the composer clears only when nobody refused, and this\ndispatch had nothing behind it: the reader pressed the control, the turn sat\nat \"Not sent\" with the same control still on it, and `preventDefault()`\nrefused a decision nobody here was about to take. A retry that stands is a\nturn on its way, which is what `sending` means, so that is the default\naction and refusing it leaves the failure exactly where it was. A consumer\nwho wants something else refuses and assigns `state` themselves, which is\nhow control is taken from every other stateful element in the library.",
               "inheritedFrom": {
                 "name": "HelixHeadlessChatMessage",
                 "module": "src/chat/message/chat-message.ts"
@@ -16230,7 +16230,7 @@
               "type": {
                 "text": "'failed' | 'sending' | 'sent' | 'streaming' | undefined"
               },
-              "description": "What has happened to it.\n\nReflected, because every one of the four is a visual state and a stylesheet\nhas no other way to know. Absent is a settled message with nothing to\nreport, which is what most of a transcript is, and it is the absence of the\nattribute rather than a value of it: there is no initializer, so nothing is\nreflected until something happens.",
+              "description": "What has happened to it.\n\nReflected, because every one of the four is a visual state and a stylesheet\nhas no other way to know. Absent is a settled message with nothing to\nreport, which is what most of a transcript is, and it is the absence of the\nattribute rather than a value of it: there is no initializer, so nothing is\nreflected until something happens.\n\n**The turn writes this once, on a retry nobody refused**, and `handleRetry`\nholds the reason. Everything else that moves it is the consumer's.",
               "fieldName": "state",
               "inheritedFrom": {
                 "name": "HelixHeadlessChatMessage",
@@ -16259,7 +16259,7 @@
               "type": {
                 "text": "HelixSendEvent"
               },
-              "description": "Fired when the reader asks to send a failed message again, and cancelable.",
+              "description": "Fired when the reader asks to send a failed message again. Cancelable: a retry that stands puts the turn back on its way, and refusing it leaves the failure and the control offering it exactly where they were.",
               "name": "helix-send",
               "reactProp": "onhelix-send",
               "inheritedFrom": {
@@ -25070,6 +25070,21 @@
                 "module": "src/color-picker/root/color-picker-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "sync",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Reports the color to the form.\n\n**The one thing a form-associated element owes, and this element owed it\nfrom the start without paying.** It extends `HelixFormElement`, takes\n`MixinControllerValue` and carries `name`, so a consumer writing\n`<helix-color-picker name=\"brand\">` inside a form has every reason to\nexpect an entry, and the form carried none: no error, nothing in the\nmarkup to look at, and a field silently missing from the submission. Its\ntwo siblings in the same composition position, Color Input and Slider,\nboth report.\n\n`null` rather than an empty string where there is no color, which is the\ndifference between a control that submits nothing and one that submits a\nblank. There is no `setValidity` beside it: this element does not take\n`MixinField`, and every validity member of `ElementInternals` is the\nconsumer's to reach through the field that wraps it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessColorPicker",
+                "module": "src/color-picker/root/color-picker-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "focus",
@@ -45844,9 +45859,75 @@
                 "module": "src/file-input/root/file-input-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "committed",
+              "type": {
+                "text": "File[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "The files this element last stood behind, so a refusal has somewhere to go.\n\nThe picker and a drop both write the input before anything here runs, so\nthe list being replaced is gone by the time the request is announced.\nNothing else records it: `files` reads the control, which is already the\nnew answer.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFileInput",
+                "module": "src/file-input/root/file-input-root.ts"
+              }
+            },
             {
               "kind": "method",
-              "name": "announce",
+              "name": "commit",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "File[]"
+                  }
+                }
+              ],
+              "description": "Asks for a set of files, and puts them in unless a listener refuses.\n\n**The request was announced after the fact and nothing read it.** This\nelement dispatched `helix-before-change` from `announce`, after the input\nhad taken the files and after `setFormValue` had reported them, and\ndiscarded what the dispatch returned: an `@event` line promising that\nrefusing it left nothing moved, over a veto with no reader. The other\ndirection of that same fault is what `requestChange` exists to prevent, so\nthis goes through it like every other value control.\n\n**A refusal puts the input back rather than stopping an assignment**, which\nis the shape a file input forces. Two of the four paths in are the browser\nwriting `control.files` before this element hears anything, so there is no\nassignment left to skip and the honest answer is to restore the list the\nelement last stood behind.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFileInput",
+                "module": "src/file-input/root/file-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "put",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "control",
+                  "type": {
+                    "text": "HTMLInputElement"
+                  }
+                },
+                {
+                  "name": "files",
+                  "type": {
+                    "text": "File[]"
+                  }
+                }
+              ],
+              "description": "Writes a list onto the input, which is the only way a `FileList` is built.\n\n`value = ''` for the empty case rather than an empty `DataTransfer`,\nbecause emptying is the one write a control accepts everywhere and a\nharness without `DataTransfer` still has to be able to clear.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFileInput",
+                "module": "src/file-input/root/file-input-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "settle",
               "privacy": "private",
               "return": {
                 "type": {
@@ -45958,7 +46039,7 @@
                   "text": "void"
                 }
               },
-              "description": "Empties it, which is what a form reset means for a file input.",
+              "description": "Empties it, which is what a form reset means for a file input.\n\nNot through `commit`, and that is the point of the split: a reset is the\nform's decision and there is nothing here for a listener to refuse. What it\nowes is the report and the platform's own announcement, which is what\n`settle` is.",
               "type": {
                 "text": "formResetCallback() => void"
               },
@@ -46868,7 +46949,7 @@
               "type": {
                 "text": "HelixBeforeChangeEvent"
               },
-              "description": "Fired before the chosen files change, with their names. Cancelable: refusing it takes the decision and nothing moves.",
+              "description": "Fired before the chosen files change, with their names. Cancelable: refusing it takes the decision and the field keeps the files it had, a pick the browser has already written included.",
               "name": "helix-before-change",
               "reactProp": "onhelix-before-change",
               "inheritedFrom": {
@@ -47423,7 +47504,7 @@
           "helix": {
             "category": "forms",
             "since": "0.23.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/filter-input",
             "aliases": [
               "FilterToken",
@@ -48070,7 +48151,7 @@
           "helix": {
             "category": "forms",
             "since": "0.23.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/filter-input",
             "aliases": [
               "Facet",
@@ -48748,7 +48829,7 @@
           "helix": {
             "category": "forms",
             "since": "0.25.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/filter-input",
             "aliases": [
               "FacetPicker",
@@ -49367,7 +49448,7 @@
           "helix": {
             "category": "forms",
             "since": "0.23.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/filter-input",
             "aliases": [
               "Comparator",
@@ -51285,7 +51366,7 @@
           "helix": {
             "category": "forms",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/filter-input",
             "aliases": [
               "SearchField",
@@ -77987,6 +78068,21 @@
                 "module": "src/option/group/option-group.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "nameFromHeading",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Names the run after the heading it drew, whatever the heading is made of.\n\n**The string alone was not the name of the heading, it was the name of one\nway of writing it.** `label` reached `ariaLabel` and the slot reached the\nscreen, so a consumer who took the documented `label` slot for a heading\nricher than a string got a `role=\"group\"` with no accessible name at all,\nand the words they wrote were the one thing a reader could not hear: the\nheading carries `aria-hidden`, because the name was supposed to be on the\nhost already. Set both and they disagreed, the host saying the string and\nthe panel showing the slot.\n\nSo the host points at the heading, which is the one thing that is always\nwhat a reader sees. `ElementInternals` and not an IDREF, because the host\nis in the light DOM and the heading is in this shadow root, which is the\nboundary `aria-labelledby` cannot cross. `MixinField.linkHost` does the\nsame for a field's label and records the measurement.\n\nClient only. Element references need the nodes to exist, and the server has\nthe string.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessOptionGroup",
+                "module": "src/option/group/option-group.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "tier",
@@ -78319,7 +78415,7 @@
           "summary": "A named run of options inside a listbox.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/option",
             "aliases": [
               "OptGroup",
@@ -78973,7 +79069,7 @@
           "helix": {
             "category": "forms",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/option",
             "aliases": [
               "Item",
@@ -89083,7 +89179,7 @@
               "name": "handleSelection",
               "privacy": "private",
               "readonly": true,
-              "description": "Announces before it applies, so a listener can refuse the change.\n\nThe item has not moved by the time this runs, unlike a native input, so\nrefusing is simply not writing the value: there is nothing to put back.",
+              "description": "Announces before it applies, so a listener can refuse the change.\n\nThe item has not moved by the time this runs, unlike a native input, so\nrefusing is simply not writing the value: there is nothing to put back.\n\n**The radio's own `helix-select` is a request, and the argument that it was\na notification is the one this settles.** That argument ran: the group's\nveto is `helix-before-change` a step later, so the item could be read as\nannouncing a choice the group then decides about. What it leaves out is who\ncan reach which event. `helix-before-change` is dispatched on the group, so\nrefusing it needs a listener on the group, and a consumer ruling out one\nanswer binds to that answer. Two gates in two positions is the shape, and\nthe item's is the one that was doing nothing.",
               "inheritedFrom": {
                 "name": "HelixHeadlessRadioGroup",
                 "module": "src/radio/group/radio-group.ts"
@@ -89607,7 +89703,7 @@
           "summary": "A set of choices where exactly one is the answer.",
           "helix": {
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/radio",
             "aliases": [
               "RadioButtons",
@@ -90021,6 +90117,19 @@
                 "module": "src/radio/root/radio-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "focusable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this choice holds the group's tab stop while nothing is chosen.\n\nThe stop rides on the selection, and an unanswered group has no selection,\nso without this every choice is `tabindex=\"-1\"` and the keyboard cannot\nenter the set at all.\n\n**Written by the group, with no attribute, and it reaches the control\nrather than the host.** A `tabindex` on the host is two faults at once: it\nis markup a consumer rendered and their server never sent, which React\nreports as a mismatch and does not patch up, and it puts the tab stop on\nthe element rather than on the `<button role=\"radio\">` inside it, so a\nscreen reader meets an unnamed box where a native group would have given\nthem an unchecked radio. `Toggle.Root` carries the same property for the\nsame reason.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessRadio",
+                "module": "src/radio/root/radio-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "selected",
@@ -90474,7 +90583,7 @@
           "helix": {
             "category": "forms",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/radio",
             "aliases": [
               "Option",
@@ -92466,9 +92575,8 @@
               "type": {
                 "text": "'rtl' | undefined"
               },
-              "description": "Writing direction inside the frame.",
-              "attribute": "direction",
-              "reflects": true
+              "description": "Writing direction inside the frame.\n\nNot reflected. It is payload for the render message and nothing selects on\nit, here or anywhere: a frame is a document of its own and what is written\non this host reaches nothing inside it, which is the same reason\n`colorMode` has to be sent rather than set.",
+              "attribute": "direction"
             },
             {
               "kind": "field",
@@ -92486,9 +92594,8 @@
               "type": {
                 "text": "'padded' | 'centered' | 'fullscreen' | 'hug' | undefined"
               },
-              "description": "How the example is placed in the frame.",
-              "attribute": "layout",
-              "reflects": true
+              "description": "How the example is placed in the frame.\n\n`padded` insets it and leaves it at the top, which is the resting case and\nwhat an absent value sends. `centered` gives it a measure and centers that\nbox in the frame. `hug` shrinks the example to its own content and centers\nwhat is left, which is the difference that matters for a component whose\nroot is a full-width block. `fullscreen` is the whole frame with no inset.\n\nNot reflected, for `direction`'s reason: the placement is applied by the\ndocument inside the frame, against its own root, so no rule on this side\ncould read it.",
+              "attribute": "layout"
             },
             {
               "kind": "field",
@@ -92956,7 +93063,7 @@
               "type": {
                 "text": "'rtl' | undefined"
               },
-              "description": "Writing direction inside the frame.",
+              "description": "Writing direction inside the frame.\n\nNot reflected. It is payload for the render message and nothing selects on\nit, here or anywhere: a frame is a document of its own and what is written\non this host reaches nothing inside it, which is the same reason\n`colorMode` has to be sent rather than set.",
               "fieldName": "direction"
             },
             {
@@ -92973,7 +93080,7 @@
               "type": {
                 "text": "'padded' | 'centered' | 'fullscreen' | 'hug' | undefined"
               },
-              "description": "How the example is placed in the frame.",
+              "description": "How the example is placed in the frame.\n\n`padded` insets it and leaves it at the top, which is the resting case and\nwhat an absent value sends. `centered` gives it a measure and centers that\nbox in the frame. `hug` shrinks the example to its own content and centers\nwhat is left, which is the difference that matters for a component whose\nroot is a full-width block. `fullscreen` is the whole frame with no inset.\n\nNot reflected, for `direction`'s reason: the placement is applied by the\ndocument inside the frame, against its own root, so no rule on this side\ncould read it.",
               "fieldName": "layout"
             },
             {
@@ -93193,9 +93300,8 @@
               "type": {
                 "text": "'horizontal' | 'vertical' | undefined"
               },
-              "description": "Whether the panes sit side by side or stacked.",
-              "attribute": "orientation",
-              "reflects": true
+              "description": "Whether the panes sit side by side or stacked.\n\nNot reflected, for `lead`'s reason above: no rule selects on it. The axis\nreaches the stylesheet as the inner splitter's own `orientation`, which is\nwhere the panes are laid out, and this element's sheet names no host\nattribute at all.",
+              "attribute": "orientation"
             },
             {
               "kind": "field",
@@ -93412,32 +93518,48 @@
             },
             {
               "kind": "method",
-              "name": "splitSettled",
+              "name": "requestSplit",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
-              "description": "Says the panes' divider has settled, so a consumer can keep it.\n\nWhen it settles, not while it moves. A drag is a stream of positions and\nonly the one it ends at is a preference; announcing each would ask whoever\nis listening to write to storage a hundred times to record one decision.\n\nThe sandbox does not keep it. Where a preference lives, and whether it\nshould be kept at all, is the consumer's to decide, and a component that\nwrote to storage on its own would be deciding for all of them under a key\nit chose.\n\n**A verb each, rather than one `helix-before-resize` naming which of the two\nmoved.** Both dividers are this element's, so `composedPath()[0]` is the same\nhost for either and the event name is the only thing that can separate them."
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Asks for the panes' divider to settle here, and moves it unless refused.\n\nWhen it settles, not while it moves. A drag is a stream of positions and\nonly the one it ends at is a preference; announcing each would ask whoever\nis listening to write to storage a hundred times to record one decision.\n\nThe sandbox does not keep it. Where a preference lives, and whether it\nshould be kept at all, is the consumer's to decide, and a component that\nwrote to storage on its own would be deciding for all of them under a key\nit chose.\n\n**Through `requestChange`, and never the other way round.** Both of these\nfired after `split` and `panelSize` had already been written, with the\nanswer dropped, so a consumer calling `preventDefault()` on an event whose\nown line says refusing it takes the decision changed nothing whatever: the\ndivider stayed where the drag left it and their handler read a value they\nhad just declined. `SandboxSource.edit` two files away already carries the\nargument, that assigning first turns a `before` event into one that has\nalready happened, and `Splitter`, whose `helix-before-resize` these two were\nsplit out of, has always announced through the audited path. Refusing one\nnow leaves `.position` bound to the value this element still holds, so the\ndivider goes back where it was.\n\n**A verb each, rather than one `helix-before-resize` naming which of the two\nmoved.** Both dividers are this element's, so `composedPath()[0]` is the same\nhost for either and the event name is the only thing that can separate them."
             },
             {
               "kind": "method",
-              "name": "panelSettled",
+              "name": "requestPanelSize",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
-              "description": "As `splitSettled`, for the panel, whose value is pixels rather than a share."
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "As `requestSplit`, for the panel, whose value is pixels rather than a share."
             },
             {
               "kind": "field",
               "name": "handlePanesChange",
               "privacy": "private",
               "readonly": true,
-              "description": "Answers a divider that has asked to move.\n\nBoth splitters are controlled from here, so neither applies anything on its\nown: each announces where it wants to go and this decides. That is what\nkeeps `split` and `panelSize` the truth about the arrangement rather than a\nstale copy of it.\n\n`target` against `currentTarget`, because a source pane's own change bubbles\nup through these same elements on its way to the host. Only a splitter\nspeaking for itself is one of ours, and only those are stopped: the sandbox\nannounces `helix-before-split` and `helix-before-panel-resize` in their\nplace, and a consumer never sees the two splitters inside it."
+              "description": "Answers a divider that has asked to move.\n\nBoth splitters are controlled from here, so neither applies anything on its\nown: each announces where it wants to go and this decides. That is what\nkeeps `split` and `panelSize` the truth about the arrangement rather than a\nstale copy of it.\n\n`target` against `currentTarget`, because a source pane's own change bubbles\nup through these same elements on its way to the host. Only a splitter\nspeaking for itself is one of ours, and only those are stopped: the sandbox\nannounces `helix-before-split` and `helix-before-panel-resize` in their\nplace, and a consumer never sees the two splitters inside it.\n\n**Refused as well as stopped, which is what \"controlled from here\" costs.**\nA splitter nobody refuses applies the move itself and says so in its own\ndocblock, so the sentence above was true only while nothing downstream ever\ndeclined: refusing `helix-before-split` left `split` at fifty and the\ndivider drawn at fifty-two, one element holding the arrangement and the\nother showing it. Refusing the inner request first makes this element the\nsingle answer.\n\n**And the divider is written back, because a refusal writes nothing.** A\nsplitter draws itself from where the gesture reached until its `position` is\nassigned, which is the setter's stated job, and a bound property Lit did not\nchange is a property Lit does not write. So the answer is assigned either\nway, which for an accepted move is the number the binding is about to carry\nanyway."
             },
             {
               "kind": "field",
@@ -93445,6 +93567,31 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "answer",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "divider",
+                  "type": {
+                    "text": "EventTarget | null"
+                  }
+                },
+                {
+                  "name": "position",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Puts a divider where this element says it is.\n\nTyped by what is used rather than by the class, which is the whole of the\ncoupling: a splitter this does not import is one that can be replaced."
+            },
             {
               "kind": "method",
               "name": "watchBody",
@@ -93874,7 +94021,7 @@
               "type": {
                 "text": "'horizontal' | 'vertical' | undefined"
               },
-              "description": "Whether the panes sit side by side or stacked.",
+              "description": "Whether the panes sit side by side or stacked.\n\nNot reflected, for `lead`'s reason above: no rule selects on it. The axis\nreaches the stylesheet as the inner splitter's own `orientation`, which is\nwhere the panes are laid out, and this element's sheet names no host\nattribute at all.",
               "fieldName": "orientation"
             },
             {
@@ -100958,8 +101105,12 @@
           "helix": {
             "category": "navigation",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/skip-link",
+            "aliases": [
+              "Skip navigation",
+              "Skip to content"
+            ],
             "tier": "styled",
             "group": "SkipLink",
             "part": "Root",
@@ -116054,7 +116205,7 @@
           "helix": {
             "category": "typography",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/text",
             "aliases": [
               "Paragraph",

package/dist/filter-input/chip/filter-chip.d.ts

@@ -13,7 +13,7 @@ import type { CSSResultGroup } from 'lit';
  * common chip free of jargon. See the headless note, which records the rule.
  *
  * @since 0.23.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases FilterToken, FacetChip
  * @documentation https://fusion.dev/helix/components/filter-input

package/dist/filter-input/field/filter-field.d.ts

@@ -14,7 +14,7 @@ import type { CSSResultGroup } from 'lit';
  * away from its neighbors.
  *
  * @since 0.23.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases Facet, Dimension
  * @documentation https://fusion.dev/helix/components/filter-input

package/dist/filter-input/menu/filter-menu.d.ts

@@ -15,7 +15,7 @@ import '../../menu/index.js';
  * immediately and why the operator is decided here rather than on the chip.
  *
  * @since 0.25.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases FacetPicker, FilterBuilder
  * @documentation https://fusion.dev/helix/components/filter-input

package/dist/filter-input/operator/filter-operator.d.ts

@@ -12,7 +12,7 @@ import type { CSSResultGroup } from 'lit';
  * reason `FilterField`'s note gives.
  *
  * @since 0.23.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases Comparator, Predicate
  * @documentation https://fusion.dev/helix/components/filter-input

package/dist/filter-input/root/filter-input-root.d.ts

@@ -26,7 +26,7 @@ import '../../option/index.js';
  * whatever holds it, not a `size` here.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases SearchField, FacetInput, TokenInput
  * @documentation https://fusion.dev/helix/components/filter-input

package/dist/option/group/option-group.d.ts

@@ -9,7 +9,7 @@ import type { CSSResultGroup } from 'lit';
  * tells you which list, not something to read on its own.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases OptGroup, Section
  * @documentation https://fusion.dev/helix/components/option
  */

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

@@ -10,7 +10,7 @@ import type { CSSResultGroup } from 'lit';
  * picked from what they are looking at.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases Item, Choice
  * @documentation https://fusion.dev/helix/components/option

package/dist/radio/group/radio-group.d.ts

@@ -10,7 +10,7 @@ import type { CSSResultGroup } from 'lit';
  * group keeps its question above the row rather than beside the first choice.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @aliases RadioButtons, Choice group
  * @documentation https://fusion.dev/helix/components/radio
  *

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

@@ -14,7 +14,7 @@ import type { CSSResultGroup } from 'lit';
  * and being chosen is an answer rather than a state.
  *
  * @since 0.1.0
- * @status experimental
+ * @status stable
  * @category forms
  * @aliases Option, Choice
  * @documentation https://fusion.dev/helix/components/radio

package/dist/sandbox/preview/sandbox-preview.d.ts

@@ -87,6 +87,11 @@ export declare class HelixSandboxPreview extends HelixElement {
     colorMode?: 'dark' | 'light';
     /**
      * Writing direction inside the frame.
+     *
+     * Not reflected. It is payload for the render message and nothing selects on
+     * it, here or anywhere: a frame is a document of its own and what is written
+     * on this host reaches nothing inside it, which is the same reason
+     * `colorMode` has to be sent rather than set.
      */
     direction?: 'rtl';
     /**
@@ -95,6 +100,16 @@ export declare class HelixSandboxPreview extends HelixElement {
     label: string;
     /**
      * How the example is placed in the frame.
+     *
+     * `padded` insets it and leaves it at the top, which is the resting case and
+     * what an absent value sends. `centered` gives it a measure and centers that
+     * box in the frame. `hug` shrinks the example to its own content and centers
+     * what is left, which is the difference that matters for a component whose
+     * root is a full-width block. `fullscreen` is the whole frame with no inset.
+     *
+     * Not reflected, for `direction`'s reason: the placement is applied by the
+     * document inside the frame, against its own root, so no rule on this side
+     * could read it.
      */
     layout?: 'padded' | 'centered' | 'fullscreen' | 'hug';
     /**

package/dist/sandbox/preview/sandbox-preview.js

@@ -114,13 +114,13 @@ __decorate([
     property({ attribute: 'color-mode' })
 ], HelixSandboxPreview.prototype, "colorMode", void 0);
 __decorate([
-    property({ reflect: true })
+    property()
 ], HelixSandboxPreview.prototype, "direction", void 0);
 __decorate([
     property()
 ], HelixSandboxPreview.prototype, "label", void 0);
 __decorate([
-    property({ reflect: true })
+    property()
 ], HelixSandboxPreview.prototype, "layout", void 0);
 __decorate([
     property()