@fusion.dev/helix-headless 0.53.2 → 0.53.4

package/types/vue.d.ts

@@ -270,9 +270,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessAccordionItem["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessAccordionItem["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessAccordionItem["defaultOpen"]) | undefined;
 };
 
@@ -922,12 +922,11 @@ export type HelixHeadlessCarouselVueProps = {
   autoplay?: (HelixHeadlessCarousel["autoplay"]) | undefined;
   /** The slide in view, counted from zero.
 
-Reading gives the real slide, in either mode. Writing sets it, the way a
-script assigning to a native control does. Which mode the carousel is in is
-read once, at the first update, from whether anything had declared an
-`index` by then: declared, and the consumer owns it and the carousel only
-announces where it would have gone; not declared, and the carousel owns it
-and `default-index` says where it starts.
+Reading gives the real slide. Writing always applies, the way a script
+assigning to a native control does, and is a seed and a correction rather
+than a claim of ownership: a consumer who wants the decision refuses the
+`helix-select`. `default-index` is where the carousel starts until
+something moves it.
 
 The same contract the four mixins carry, written out here rather than
 extracted, because a slide is addressed by position and every one of those
@@ -1383,9 +1382,9 @@ Not reflected: the attribute is the consumer's input and stays as they
 wrote it, and `:state(checked)` carries the resolved state for
 stylesheets. */
   checked?: (HelixHeadlessCheckbox["checked"]) | undefined;
-  /** Initial checked state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it checked, which is where a reset returns to. */
   "default-checked"?: (HelixHeadlessCheckbox["defaultChecked"]) | undefined;
-  /** Initial checked state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it checked, which is where a reset returns to. */
   defaultChecked?: (HelixHeadlessCheckbox["defaultChecked"]) | undefined;
   /** What is wrong, in the reader's words rather than the browser's. */
   feedback?: (HelixHeadlessCheckbox["feedback"]) | undefined;
@@ -1573,9 +1572,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessColorInput["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessColorInput["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessColorInput["defaultOpen"]) | undefined;
   /** The value the markup declared, which is where a reset returns to. */
   "default-value"?: (HelixHeadlessColorInput["defaultValue"]) | undefined;
@@ -1947,9 +1946,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessCombobox["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessCombobox["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessCombobox["defaultOpen"]) | undefined;
   /** What the control is called once everything is showing. */
   "collapse-label"?: (HelixHeadlessCombobox["collapseLabel"]) | undefined;
@@ -2081,9 +2080,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessCommand["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessCommand["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessCommand["defaultOpen"]) | undefined;
 };
 
@@ -2649,9 +2648,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessDateInput["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessDateInput["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessDateInput["defaultOpen"]) | undefined;
   /** What the control is called once everything is showing. */
   "collapse-label"?: (HelixHeadlessDateInput["collapseLabel"]) | undefined;
@@ -3004,9 +3003,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessDialog["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessDialog["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessDialog["defaultOpen"]) | undefined;
   /** What the dialog closed with, the way `<dialog>` reports it.
 
@@ -3077,7 +3076,7 @@ thickness decides is arithmetic done here and published as
 `--donut-chart-stroke`, which is a number a rule can do sums with where the
 word is not. Reflected, it wrote a value onto every host a script had set
 it on for nothing to read. `sweep` beside it is the converse and reflects,
-because three rules select on it. */
+because the styled sheet selects on it. */
   hole?: (HelixHeadlessDonutChart["hole"]) | undefined;
   /** How much of the circle the whole occupies.
 
@@ -3188,9 +3187,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessDrawer["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessDrawer["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessDrawer["defaultOpen"]) | undefined;
   /** What the dialog closed with, the way `<dialog>` reports it.
 
@@ -3606,9 +3605,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessFilterInput["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessFilterInput["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessFilterInput["defaultOpen"]) | undefined;
   /** What the control is called once everything is showing. */
   "collapse-label"?: (HelixHeadlessFilterInput["collapseLabel"]) | undefined;
@@ -4763,9 +4762,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessMegamenu["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessMegamenu["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessMegamenu["defaultOpen"]) | undefined;
 };
 
@@ -4921,9 +4920,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessMenu["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessMenu["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessMenu["defaultOpen"]) | undefined;
 };
 
@@ -5084,9 +5083,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessNotificationGroup["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessNotificationGroup["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessNotificationGroup["defaultOpen"]) | undefined;
 };
 
@@ -5437,11 +5436,10 @@ Written by the listbox. */
   /** A second destination for this row, taken with the modifier held.
 
 **An attribute rather than a second row, which is the whole point.** A
-palette of eighty-eight components that offered each of them a reference
-page and a sandbox as separate entries would be a palette of a hundred and
-seventy-six, and one earns its keep by getting a reader to one thing in
-three keystrokes. The row already carries the first destination, so the
-second belongs beside it.
+palette that offered every component a reference page and a sandbox as
+separate entries would be twice as long, and one earns its keep by getting
+a reader to one thing in three keystrokes. The row already carries the
+first destination, so the second belongs beside it.
 
 Declared here and acted on by whatever owns the list, the same division
 selection already uses: an option says what it is and the listbox decides
@@ -5956,9 +5954,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessPopover["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessPopover["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessPopover["defaultOpen"]) | undefined;
 };
 
@@ -6495,9 +6493,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessSelect["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessSelect["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessSelect["defaultOpen"]) | undefined;
   /** The value the markup declared, which is where a reset returns to. */
   "default-value"?: (HelixHeadlessSelect["defaultValue"]) | undefined;
@@ -6842,9 +6840,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessSpeedDial["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessSpeedDial["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessSpeedDial["defaultOpen"]) | undefined;
 };
 
@@ -7061,11 +7059,11 @@ Writing always applies, so `<helix-tabs active="one">` starts on that
 tab, and `default-active` is how markup says where to start without
 naming the current one. */
   active?: (HelixHeadlessSteps["active"]) | undefined;
-  /** Initial item for uncontrolled use.
+  /** Which item the markup declared current.
 
 Ignored once `active` is written. */
   "default-active"?: (HelixHeadlessSteps["defaultActive"]) | undefined;
-  /** Initial item for uncontrolled use.
+  /** Which item the markup declared current.
 
 Ignored once `active` is written. */
   defaultActive?: (HelixHeadlessSteps["defaultActive"]) | undefined;
@@ -7126,9 +7124,9 @@ Not reflected: the attribute is the consumer's input and stays as they
 wrote it, and `:state(checked)` carries the resolved state for
 stylesheets. */
   checked?: (HelixHeadlessSwitch["checked"]) | undefined;
-  /** Initial checked state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it checked, which is where a reset returns to. */
   "default-checked"?: (HelixHeadlessSwitch["defaultChecked"]) | undefined;
-  /** Initial checked state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it checked, which is where a reset returns to. */
   defaultChecked?: (HelixHeadlessSwitch["defaultChecked"]) | undefined;
   /** What is wrong, in the reader's words rather than the browser's. */
   feedback?: (HelixHeadlessSwitch["feedback"]) | undefined;
@@ -7416,11 +7414,11 @@ Writing always applies, so `<helix-tabs active="one">` starts on that
 tab, and `default-active` is how markup says where to start without
 naming the current one. */
   active?: (HelixHeadlessTabs["active"]) | undefined;
-  /** Initial item for uncontrolled use.
+  /** Which item the markup declared current.
 
 Ignored once `active` is written. */
   "default-active"?: (HelixHeadlessTabs["defaultActive"]) | undefined;
-  /** Initial item for uncontrolled use.
+  /** Which item the markup declared current.
 
 Ignored once `active` is written. */
   defaultActive?: (HelixHeadlessTabs["defaultActive"]) | undefined;
@@ -7752,9 +7750,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessTimeInput["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessTimeInput["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessTimeInput["defaultOpen"]) | undefined;
   /** What the control is called once everything is showing. */
   "collapse-label"?: (HelixHeadlessTimeInput["collapseLabel"]) | undefined;
@@ -8405,9 +8403,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessTooltip["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessTooltip["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessTooltip["defaultOpen"]) | undefined;
 };
 
@@ -8596,9 +8594,9 @@ hydration, or diffed by a framework, it comes back holding whatever the
 last reader did rather than what the author wrote. `:state(open)` carries
 the resolved state for stylesheets, which is what the mirror is for. */
   open?: (HelixHeadlessTreeItem["open"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   "default-open"?: (HelixHeadlessTreeItem["defaultOpen"]) | undefined;
-  /** Initial open state for uncontrolled use, where nothing declared one. */
+  /** Whether the markup declared it open. Ignored once `open` is written. */
   defaultOpen?: (HelixHeadlessTreeItem["defaultOpen"]) | undefined;
   /** Depth from the root, counted by the tree so indentation needs no CSS nesting.
 
@@ -8708,11 +8706,11 @@ Writing always applies, so `<helix-tabs active="one">` starts on that
 tab, and `default-active` is how markup says where to start without
 naming the current one. */
   active?: (HelixHeadlessTree["active"]) | undefined;
-  /** Initial item for uncontrolled use.
+  /** Which item the markup declared current.
 
 Ignored once `active` is written. */
   "default-active"?: (HelixHeadlessTree["defaultActive"]) | undefined;
-  /** Initial item for uncontrolled use.
+  /** Which item the markup declared current.
 
 Ignored once `active` is written. */
   defaultActive?: (HelixHeadlessTree["defaultActive"]) | undefined;
@@ -8836,11 +8834,11 @@ Writing always applies, so `<helix-tabs active="one">` starts on that
 tab, and `default-active` is how markup says where to start without
 naming the current one. */
   active?: (HelixHeadlessVideoPlaylist["active"]) | undefined;
-  /** Initial item for uncontrolled use.
+  /** Which item the markup declared current.
 
 Ignored once `active` is written. */
   "default-active"?: (HelixHeadlessVideoPlaylist["defaultActive"]) | undefined;
-  /** Initial item for uncontrolled use.
+  /** Which item the markup declared current.
 
 Ignored once `active` is written. */
   defaultActive?: (HelixHeadlessVideoPlaylist["defaultActive"]) | undefined;
@@ -9437,7 +9435,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessCopyButtonVueProps,
     HelixHeadlessCopyButtonVueEvents
   >;
-  /** **The schema is markup and the data is a property.** Columns are declared as 'TableColumn' children, because a schema is small and something a reader should see in the HTML; rows are handed over as an array, because a table that draws ten thousand elements cannot window them.  '''html <helix-headless-data-table .rows=${rows} sort="name:asc" page-size="20">   <helix-headless-table-column field="name" sortable>Name</helix-headless-table-column>   <helix-headless-table-column field="size" align="end" sortable .cell=${bytes}>Size</helix-headless-table-column> </helix-headless-data-table> '''  'Table' takes rows as markup and is the right component for a table of twelve things a person wrote out.  **Sort and filter apply to the whole set, never the page.** Sorting the drawn window is correct on the first screen and wrong on every other one.  **The cell values do not server-render.** The headings do, and the row elements do, but reading a cell needs the columns, and the columns are markup children Lit SSR does not hand this element. So a crawler sees a table of the right shape with nothing in it. That is the cost of the first paragraph: use 'Table' where the served HTML has to carry the values.  **'selectable' adds a column of checkboxes, keyed on 'row-key'.** A row is selected by its identity rather than its position, so a selection survives a sort, a filter and a page. 'selected' is the chosen keys, comma separated, the shape Listbox uses for a multiple choice, and like 'sort' it is controlled when set and seeded by 'default-selected'. The box in the heading selects every row in the result, across pages, and shows a dash while only some are chosen. Choosing one of many, rather than several, is opening a row, and that is a link or a button in a cell rather than a selection.  **A reader can size and order the columns.** 'resizable' on a column puts a separator on its edge; 'reorderable' on the table puts a grip on each heading that has a 'field', moved by dragging or with the arrow keys. The order lands in 'order' as fields, and the consumer's own markup is never rewritten: the table assigns the headings to its header in that order instead.  **'csv()' hands back the result as text**: every row the filter lets through, in the order on screen, in the columns on screen. Saving it is the page's business, the same as any other file.  **There is no 'columns' attribute here, and Table has one.** The difference is what a column is in each: here it is the schema, so a table without one has nothing to read a row with, and every column is a place to write a 'width'. A Table holds cells a consumer wrote and can be written with no column at all, so its 'columns' is where such a table is sized from. Written on this element the attribute is inert, which is the trap worth knowing when moving between the two. */
+  /** **The schema is markup and the data is a property.** Columns are declared as 'TableColumn' children, because a schema is small and something a reader should see in the HTML; rows are handed over as an array, because a table that draws ten thousand elements cannot window them.  '''html <helix-headless-data-table .rows=${rows} sort="name:asc" page-size="20">   <helix-headless-table-column field="name" sortable>Name</helix-headless-table-column>   <helix-headless-table-column field="size" align="end" sortable .cell=${bytes}>Size</helix-headless-table-column> </helix-headless-data-table> '''  'Table' takes rows as markup and is the right component for a table of twelve things a person wrote out.  **Sort and filter apply to the whole set, never the page.** Sorting the drawn window is correct on the first screen and wrong on every other one.  **The cell values do not server-render.** The headings do, and the row elements do, but reading a cell needs the columns, and the columns are markup children Lit SSR does not hand this element. So a crawler sees a table of the right shape with nothing in it. That is the cost of the first paragraph: use 'Table' where the served HTML has to carry the values.  **'selectable' adds a column of checkboxes, keyed on 'row-key'.** A row is selected by its identity rather than its position, so a selection survives a sort, a filter and a page. 'selected' is the chosen keys, comma separated, the shape Listbox uses for a multiple choice, and like 'sort' writing it applies while 'default-selected' is what the markup declared. The box in the heading selects every row in the result, across pages, and shows a dash while only some are chosen. Choosing one of many, rather than several, is opening a row, and that is a link or a button in a cell rather than a selection.  **A reader can size and order the columns.** 'resizable' on a column puts a separator on its edge; 'reorderable' on the table puts a grip on each heading that has a 'field', moved by dragging or with the arrow keys. The order lands in 'order' as fields, and the consumer's own markup is never rewritten: the table assigns the headings to its header in that order instead.  **'csv()' hands back the result as text**: every row the filter lets through, in the order on screen, in the columns on screen. Saving it is the page's business, the same as any other file.  **There is no 'columns' attribute here, and Table has one.** The difference is what a column is in each: here it is the schema, so a table without one has nothing to read a row with, and every column is a place to write a 'width'. A Table holds cells a consumer wrote and can be written with no column at all, so its 'columns' is where such a table is sized from. Written on this element the attribute is inert, which is the trap worth knowing when moving between the two. */
   "helix-headless-data-table": DefineCustomElement<
     HelixHeadlessDataTable,
     HelixHeadlessDataTableVueProps,
@@ -9539,7 +9537,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessFilterOperatorVueProps,
     HelixHeadlessFilterOperatorVueEvents
   >;
-  /** **The tokens are the consumer's own elements, slotted.** What a filter narrows by belongs to the consumer's model rather than to this element: a facet with a prefix, a saved query, a range. So they are slotted rather than rendered from a list of strings, and removing one is a request this element makes rather than a change it applies. Combobox is the other way round, and that is the difference between the two: its tokens are a view of a selection it owns, drawn from options it was handed.  **'value' is the text being typed, not the tokens**, which is what makes this a field a consumer can listen to. Every keystroke announces 'input' with the text on the element, so a table narrows as the reader types. The tokens need no reporting back, being markup the consumer already holds.  Backspace on an empty field asks the last token to go, through the same 'helix-dismiss' its own remove control fires, so a consumer who handled the pointer has already handled the keyboard.  **It reads what was declared, and nothing that was not.** Write 'FilterField's (usually inside the 'FilterMenu' slotted into 'start', so the picker and the text work off one set), and Enter reads the box against them: 'disposition:refunded,settled' and '-disposition:refunded' announce 'helix-facet', exactly as ticking those values in the picker would, and the text they were read from goes. Everything else stays where it was typed, so 'refund tuesday disposition:settled' is a filter and a search at once. 'grammar.ts' carries the whole rule and is worth reading before relying on it; the short version is that Helix owns the punctuation and the consumer owns every word in it. A field with no 'FilterField' in it parses nothing, which is the behavior this had before it could.  **A field whose values cannot be listed belongs here rather than in the picker.** 'assignee:ada' is a filter and nobody wants to enumerate every name in the company, but a menu page for it would have nothing on it to press. Written directly inside this element it is read by the grammar and never offered as a page: unslotted, so nothing draws it, which is the same trick 'FilterField' already plays on its own children.  **It can suggest what to type next, and deciding what to suggest is still the consumer's.** Slot options into 'suggestions' and the field shows them, moves through them with the arrows, and lets Enter press one; the option fires its own 'helix-select' and the consumer decides what choosing meant. Keys before a colon and values after it are the same panel with different contents, and 'readFilterText' is exported for a consumer narrowing that panel against what a reader has half typed.  **The panel opens when there is something in it and closes when there is not**, rather than on a choice. A reader who picks a key wants its values next, and closing on the choice would shut the panel between two renders. Use 'selectionStart' and 'setSelectionRange' to write a completion back and put the caret after it, or the next parse reads the wrong term.  **Three things here have three different owners, and only one of them is a controlled property.**  'value' is the text, and it is uncontrolled by default: the reader types, the element applies it, and 'input' says so. **Writing 'value' does not take that over.** It is a seed and a correction, so a consumer who sets it and then expects the field to hold still will watch the next keystroke overwrite them. Ownership is taken by refusing 'helix-before-change' and writing the value you want, which is the same shape every field in this library uses and is worth saying out loud here because the property looks like React's. 'default-value' seeds the field without claiming anything.  'open' is the suggestions panel, and it is the ordinary controlled pair: refuse 'helix-before-open' or 'helix-before-close' to take the decision, and 'default-open' to seed it.  The tokens are neither, because they are not state. They are the consumer's own elements in a slot, so there is nothing for this to own and nothing to report back: a token goes when the consumer removes it from their markup, having been asked by 'helix-dismiss'. **A 'FilterChip' naming a declared field is asked differently**, and it has to be: the picker holds what is ticked, so a chip that removed itself without telling it left the value ticked in a list nobody could see was wrong. That dismissal is answered as the field being filtered by nothing, so it arrives as 'helix-facet' like every other change and the chip goes because the filter went. */
+  /** **The tokens are the consumer's own elements, slotted.** What a filter narrows by belongs to the consumer's model rather than to this element: a facet with a prefix, a saved query, a range. So they are slotted rather than rendered from a list of strings, and removing one is a request this element makes rather than a change it applies. Combobox is the other way round, and that is the difference between the two: its tokens are a view of a selection it owns, drawn from options it was handed.  **'value' is the text being typed, not the tokens**, which is what makes this a field a consumer can listen to. Every keystroke announces 'input' with the text on the element, so a table narrows as the reader types. The tokens need no reporting back, being markup the consumer already holds.  Backspace on an empty field asks the last token to go, through the same 'helix-dismiss' its own remove control fires, so a consumer who handled the pointer has already handled the keyboard.  **It reads what was declared, and nothing that was not.** Write 'FilterField's (usually inside the 'FilterMenu' slotted into 'start', so the picker and the text work off one set), and Enter reads the box against them: 'disposition:refunded,settled' and '-disposition:refunded' announce 'helix-facet', exactly as ticking those values in the picker would, and the text they were read from goes. Everything else stays where it was typed, so 'refund tuesday disposition:settled' is a filter and a search at once. 'grammar.ts' carries the whole rule and is worth reading before relying on it; the short version is that Helix owns the punctuation and the consumer owns every word in it. A field with no 'FilterField' in it parses nothing, which is the behavior this had before it could.  **A field whose values cannot be listed belongs here rather than in the picker.** 'assignee:ada' is a filter and nobody wants to enumerate every name in the company, but a menu page for it would have nothing on it to press. Written directly inside this element it is read by the grammar and never offered as a page: unslotted, so nothing draws it, which is the same trick 'FilterField' already plays on its own children.  **It can suggest what to type next, and deciding what to suggest is still the consumer's.** Slot options into 'suggestions' and the field shows them, moves through them with the arrows, and lets Enter press one; the option fires its own 'helix-select' and the consumer decides what choosing meant. Keys before a colon and values after it are the same panel with different contents, and 'readFilterText' is exported for a consumer narrowing that panel against what a reader has half typed.  **The panel opens when there is something in it and closes when there is not**, rather than on a choice. A reader who picks a key wants its values next, and closing on the choice would shut the panel between two renders. Use 'selectionStart' and 'setSelectionRange' to write a completion back and put the caret after it, or the next parse reads the wrong term.  **Three things here have three different owners.**  'value' is the text: the reader types, the element applies it, and 'input' says so. **Writing 'value' does not take that over.** It is a seed and a correction, so a consumer who sets it and then expects the field to hold still will watch the next keystroke overwrite them. Ownership is taken by refusing 'helix-before-change' and writing the value you want, which is the same shape every field in this library uses and is worth saying out loud here because the property looks like React's. 'default-value' seeds the field without claiming anything.  'open' is the suggestions panel, and it is the ordinary pair: refuse 'helix-before-open' or 'helix-before-close' to take the decision, and 'default-open' to seed it.  The tokens are neither, because they are not state. They are the consumer's own elements in a slot, so there is nothing for this to own and nothing to report back: a token goes when the consumer removes it from their markup, having been asked by 'helix-dismiss'. **A 'FilterChip' naming a declared field is asked differently**, and it has to be: the picker holds what is ticked, so a chip that removed itself without telling it left the value ticked in a list nobody could see was wrong. That dismissal is answered as the field being filtered by nothing, so it arrives as 'helix-facet' like every other change and the chip goes because the filter went. */
   "helix-headless-filter-input": DefineCustomElement<
     HelixHeadlessFilterInput,
     HelixHeadlessFilterInputVueProps,
@@ -9707,7 +9705,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessPaginationVueProps,
     HelixHeadlessPaginationVueEvents
   >;
-  /** Its own element beside 'Pagination' rather than a slot inside it, for the reason 'Pagination.Summary' is: a footer's direction and order are the consumer's, and a control that can only sit at one end of one row has taken that decision for them.  **'Select', not a native '<select>'.** Two dropdowns identical closed and different open meet each other in the same footer as a table's filters. The caret is 'Select''s rather than a color literal baked into a data URI, because a background image cannot read 'currentColor', and the label is a real '<label for>' against the trigger's own id.  **The label sits on the row, not above it.** 'Select''s host is a column, and an outer-tree rule beats a ':host' rule, so turning it into a row needs no property on 'Select' and nothing written into the consumer's markup.  **An empty 'sizes' renders nothing**, rather than falling back to the built-in list, which would be a component overruling a consumer who said "none". Same rule as 'Pagination' over a single page, and reported the same way, through 'ElementInternals.states' rather than an attribute the server never wrote.  'value' is the controlled property and 'default-value' seeds one this owns. Changing it announces 'helix-before-change'; re-querying and moving back to page one is the consumer's, because only they know whether the reader's position should survive it. */
+  /** Its own element beside 'Pagination' rather than a slot inside it, for the reason 'Pagination.Summary' is: a footer's direction and order are the consumer's, and a control that can only sit at one end of one row has taken that decision for them.  **'Select', not a native '<select>'.** Two dropdowns identical closed and different open meet each other in the same footer as a table's filters. The caret is 'Select''s rather than a color literal baked into a data URI, because a background image cannot read 'currentColor', and the label is a real '<label for>' against the trigger's own id.  **The label sits on the row, not above it.** 'Select''s host is a column, and an outer-tree rule beats a ':host' rule, so turning it into a row needs no property on 'Select' and nothing written into the consumer's markup.  **An empty 'sizes' renders nothing**, rather than falling back to the built-in list, which would be a component overruling a consumer who said "none". Same rule as 'Pagination' over a single page, and reported the same way, through 'ElementInternals.states' rather than an attribute the server never wrote.  'value' is the size the control holds and 'default-value' is what the markup declared. Changing it announces 'helix-before-change'; re-querying and moving back to page one is the consumer's, because only they know whether the reader's position should survive it. */
   "helix-headless-pagination-size": DefineCustomElement<
     HelixHeadlessPaginationSize,
     HelixHeadlessPaginationSizeVueProps,