@fusion.dev/helix-headless 0.53.2 → 0.53.3

package/custom-elements.json

@@ -156,7 +156,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -628,7 +628,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -9707,7 +9707,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "The slide in view, counted from zero.\n\nReading gives the real slide, in either mode. Writing sets it, the way a\nscript assigning to a native control does. Which mode the carousel is in is\nread once, at the first update, from whether anything had declared an\n`index` by then: declared, and the consumer owns it and the carousel only\nannounces where it would have gone; not declared, and the carousel owns it\nand `default-index` says where it starts.\n\nThe same contract the four mixins carry, written out here rather than\nextracted, because a slide is addressed by position and every one of those\nmixins is keyed by a name. One consumer is not a mixin: if a second numeric\nstate turns up, this is what it is extracted from.",
+              "description": "The slide in view, counted from zero.\n\nReading gives the real slide. Writing always applies, the way a script\nassigning to a native control does, and is a seed and a correction rather\nthan a claim of ownership: a consumer who wants the decision refuses the\n`helix-select`. `default-index` is where the carousel starts until\nsomething moves it.\n\nThe same contract the four mixins carry, written out here rather than\nextracted, because a slide is addressed by position and every one of those\nmixins is keyed by a name. One consumer is not a mixin: if a second numeric\nstate turns up, this is what it is extracted from.",
               "attribute": "index"
             },
             {
@@ -10522,7 +10522,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "The slide in view, counted from zero.\n\nReading gives the real slide, in either mode. Writing sets it, the way a\nscript assigning to a native control does. Which mode the carousel is in is\nread once, at the first update, from whether anything had declared an\n`index` by then: declared, and the consumer owns it and the carousel only\nannounces where it would have gone; not declared, and the carousel owns it\nand `default-index` says where it starts.\n\nThe same contract the four mixins carry, written out here rather than\nextracted, because a slide is addressed by position and every one of those\nmixins is keyed by a name. One consumer is not a mixin: if a second numeric\nstate turns up, this is what it is extracted from.",
+              "description": "The slide in view, counted from zero.\n\nReading gives the real slide. Writing always applies, the way a script\nassigning to a native control does, and is a seed and a correction rather\nthan a claim of ownership: a consumer who wants the decision refuses the\n`helix-select`. `default-index` is where the carousel starts until\nsomething moves it.\n\nThe same contract the four mixins carry, written out here rather than\nextracted, because a slide is addressed by position and every one of those\nmixins is keyed by a name. One consumer is not a mixin: if a second numeric\nstate turns up, this is what it is extracted from.",
               "fieldName": "index"
             },
             {
@@ -13574,7 +13574,7 @@
               "name": "handleToggle",
               "privacy": "private",
               "readonly": true,
-              "description": "Reads a box's requested change into `value`, and says so once.\n\nThe box is found from the event's target, which does two things. It tells\nthe group which box asked, where the detail carries only the shared name.\nAnd it ignores the group's own dispatch, which lands on this same listener\nbecause the group is what it is dispatched from: without the guard the\ngroup answers itself until the stack gives out.\n\nThe requested state comes from the event rather than from the box. Driving\nthe boxes from `value` makes them controlled, so a controlled box applies\nnothing on its own and reports what it was asked for. Reading `checked`\nhere would read the state it still holds and nothing would ever change."
+              "description": "Reads a box's requested change into `value`, and says so once.\n\nThe box is found from the event's target, which does two things. It tells\nthe group which box asked, where the detail carries only the shared name.\nAnd it ignores the group's own dispatch, which lands on this same listener\nbecause the group is what it is dispatched from: without the guard the\ngroup answers itself until the stack gives out.\n\nThe requested state comes from the event rather than from the box.\n`helix-before-toggle` is dispatched before the box applies, so reading\n`checked` here would read the state it still holds and nothing would ever\nchange."
             },
             {
               "kind": "field",
@@ -14674,7 +14674,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial checked state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it checked, which is where a reset returns to.",
               "attribute": "default-checked",
               "inheritedFrom": {
                 "name": "MixinControllerChecked",
@@ -15565,7 +15565,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial checked state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it checked, which is where a reset returns to.",
               "fieldName": "defaultChecked",
               "inheritedFrom": {
                 "name": "MixinControllerChecked",
@@ -17616,7 +17616,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -18698,7 +18698,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -21051,7 +21051,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -22373,7 +22373,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -22838,7 +22838,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -23338,7 +23338,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -24745,7 +24745,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "**The schema is markup and the data is a property.** Columns are declared as\n`TableColumn` children, because a schema is small and something a reader\nshould see in the HTML; rows are handed over as an array, because a table\nthat draws ten thousand elements cannot window them.\n\n```html\n<helix-headless-data-table .rows=${rows} sort=\"name:asc\" page-size=\"20\">\n  <helix-headless-table-column field=\"name\" sortable>Name</helix-headless-table-column>\n  <helix-headless-table-column field=\"size\" align=\"end\" sortable .cell=${bytes}>Size</helix-headless-table-column>\n</helix-headless-data-table>\n```\n\n`Table` takes rows as markup and is the right component for a table of twelve\nthings a person wrote out.\n\n**Sort and filter apply to the whole set, never the page.** Sorting the drawn\nwindow is correct on the first screen and wrong on every other one.\n\n**The cell values do not server-render.** The headings do, and the row\nelements do, but reading a cell needs the columns, and the columns are markup\nchildren Lit SSR does not hand this element. So a crawler sees a table of the\nright shape with nothing in it. That is the cost of the first paragraph: use\n`Table` where the served HTML has to carry the values.\n\n**`selectable` adds a column of checkboxes, keyed on `row-key`.** A row is\nselected by its identity rather than its position, so a selection survives a\nsort, a filter and a page. `selected` is the chosen keys, comma separated, the\nshape Listbox uses for a multiple choice, and like `sort` it is controlled\nwhen set and seeded by `default-selected`. The box in the heading selects every\nrow in the result, across pages, and shows a dash while only some are chosen.\nChoosing one of many, rather than several, is opening a row, and that is a\nlink or a button in a cell rather than a selection.\n\n**A reader can size and order the columns.** `resizable` on a column puts a\nseparator on its edge; `reorderable` on the table puts a grip on each heading\nthat has a `field`, moved by dragging or with the arrow keys. The order lands\nin `order` as fields, and the consumer's own markup is never rewritten: the\ntable assigns the headings to its header in that order instead.\n\n**`csv()` hands back the result as text**: every row the filter lets through,\nin the order on screen, in the columns on screen. Saving it is the page's\nbusiness, the same as any other file.\n\n**There is no `columns` attribute here, and Table has one.** The difference\nis what a column is in each: here it is the schema, so a table without one\nhas nothing to read a row with, and every column is a place to write a\n`width`. A Table holds cells a consumer wrote and can be written with no\ncolumn at all, so its `columns` is where such a table is sized from. Written\non this element the attribute is inert, which is the trap worth knowing when\nmoving between the two.",
+          "description": "**The schema is markup and the data is a property.** Columns are declared as\n`TableColumn` children, because a schema is small and something a reader\nshould see in the HTML; rows are handed over as an array, because a table\nthat draws ten thousand elements cannot window them.\n\n```html\n<helix-headless-data-table .rows=${rows} sort=\"name:asc\" page-size=\"20\">\n  <helix-headless-table-column field=\"name\" sortable>Name</helix-headless-table-column>\n  <helix-headless-table-column field=\"size\" align=\"end\" sortable .cell=${bytes}>Size</helix-headless-table-column>\n</helix-headless-data-table>\n```\n\n`Table` takes rows as markup and is the right component for a table of twelve\nthings a person wrote out.\n\n**Sort and filter apply to the whole set, never the page.** Sorting the drawn\nwindow is correct on the first screen and wrong on every other one.\n\n**The cell values do not server-render.** The headings do, and the row\nelements do, but reading a cell needs the columns, and the columns are markup\nchildren Lit SSR does not hand this element. So a crawler sees a table of the\nright shape with nothing in it. That is the cost of the first paragraph: use\n`Table` where the served HTML has to carry the values.\n\n**`selectable` adds a column of checkboxes, keyed on `row-key`.** A row is\nselected by its identity rather than its position, so a selection survives a\nsort, a filter and a page. `selected` is the chosen keys, comma separated, the\nshape Listbox uses for a multiple choice, and like `sort` writing it applies\nwhile `default-selected` is what the markup declared. The box in the heading\nselects every row in the result, across pages, and shows a dash while only\nsome are chosen.\nChoosing one of many, rather than several, is opening a row, and that is a\nlink or a button in a cell rather than a selection.\n\n**A reader can size and order the columns.** `resizable` on a column puts a\nseparator on its edge; `reorderable` on the table puts a grip on each heading\nthat has a `field`, moved by dragging or with the arrow keys. The order lands\nin `order` as fields, and the consumer's own markup is never rewritten: the\ntable assigns the headings to its header in that order instead.\n\n**`csv()` hands back the result as text**: every row the filter lets through,\nin the order on screen, in the columns on screen. Saving it is the page's\nbusiness, the same as any other file.\n\n**There is no `columns` attribute here, and Table has one.** The difference\nis what a column is in each: here it is the schema, so a table without one\nhas nothing to read a row with, and every column is a place to write a\n`width`. A Table holds cells a consumer wrote and can be written with no\ncolumn at all, so its `columns` is where such a table is sized from. Written\non this element the attribute is inert, which is the trap worth knowing when\nmoving between the two.",
           "name": "HelixHeadlessDataTable",
           "cssProperties": [
             {
@@ -27874,7 +27874,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -29199,7 +29199,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -32077,7 +32077,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -32567,7 +32567,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -33255,7 +33255,7 @@
               "type": {
                 "text": "'large' | 'none' | 'small' | undefined"
               },
-              "description": "How much is left open in the middle.\n\nAbsent is a ring with room for a total in it. `small` and `large` move the\nhole without moving the outer edge, so a chart keeps its footprint.\n\n**`none` is a pie**, and it is the same drawing rather than another one:\nthe radius follows the thickness, so the inner edge reaching the center is\nwhat closing the hole means. A pie reads less accurately than a ring, angle\nbeing harder to judge than length, but it is not *misleading* the way a bar\nmeasured from anything but zero is, which is why this is a value here and\nthe bar chart's baseline is not a property at all.\n\n**Geometry rather than a CSS hook.** The dash arithmetic needs the\ncircumference, which needs the radius, and reading a custom property means\n`getComputedStyle`, which is client-only: a server would draw a different\nring than the client. A plot's proportions are markup for the same reason\n`curve` is.\n\n**And so it does not reflect**, which is the same argument read forward. No\nselector on either tier asks about it and none can want to: everything the\nthickness decides is arithmetic done here and published as\n`--donut-chart-stroke`, which is a number a rule can do sums with where the\nword is not. Reflected, it wrote a value onto every host a script had set\nit on for nothing to read. `sweep` beside it is the converse and reflects,\nbecause three rules select on it.",
+              "description": "How much is left open in the middle.\n\nAbsent is a ring with room for a total in it. `small` and `large` move the\nhole without moving the outer edge, so a chart keeps its footprint.\n\n**`none` is a pie**, and it is the same drawing rather than another one:\nthe radius follows the thickness, so the inner edge reaching the center is\nwhat closing the hole means. A pie reads less accurately than a ring, angle\nbeing harder to judge than length, but it is not *misleading* the way a bar\nmeasured from anything but zero is, which is why this is a value here and\nthe bar chart's baseline is not a property at all.\n\n**Geometry rather than a CSS hook.** The dash arithmetic needs the\ncircumference, which needs the radius, and reading a custom property means\n`getComputedStyle`, which is client-only: a server would draw a different\nring than the client. A plot's proportions are markup for the same reason\n`curve` is.\n\n**And so it does not reflect**, which is the same argument read forward. No\nselector on either tier asks about it and none can want to: everything the\nthickness decides is arithmetic done here and published as\n`--donut-chart-stroke`, which is a number a rule can do sums with where the\nword is not. Reflected, it wrote a value onto every host a script had set\nit on for nothing to read. `sweep` beside it is the converse and reflects,\nbecause the styled sheet selects on it.",
               "attribute": "hole"
             },
             {
@@ -33879,7 +33879,7 @@
               "type": {
                 "text": "'large' | 'none' | 'small' | undefined"
               },
-              "description": "How much is left open in the middle.\n\nAbsent is a ring with room for a total in it. `small` and `large` move the\nhole without moving the outer edge, so a chart keeps its footprint.\n\n**`none` is a pie**, and it is the same drawing rather than another one:\nthe radius follows the thickness, so the inner edge reaching the center is\nwhat closing the hole means. A pie reads less accurately than a ring, angle\nbeing harder to judge than length, but it is not *misleading* the way a bar\nmeasured from anything but zero is, which is why this is a value here and\nthe bar chart's baseline is not a property at all.\n\n**Geometry rather than a CSS hook.** The dash arithmetic needs the\ncircumference, which needs the radius, and reading a custom property means\n`getComputedStyle`, which is client-only: a server would draw a different\nring than the client. A plot's proportions are markup for the same reason\n`curve` is.\n\n**And so it does not reflect**, which is the same argument read forward. No\nselector on either tier asks about it and none can want to: everything the\nthickness decides is arithmetic done here and published as\n`--donut-chart-stroke`, which is a number a rule can do sums with where the\nword is not. Reflected, it wrote a value onto every host a script had set\nit on for nothing to read. `sweep` beside it is the converse and reflects,\nbecause three rules select on it.",
+              "description": "How much is left open in the middle.\n\nAbsent is a ring with room for a total in it. `small` and `large` move the\nhole without moving the outer edge, so a chart keeps its footprint.\n\n**`none` is a pie**, and it is the same drawing rather than another one:\nthe radius follows the thickness, so the inner edge reaching the center is\nwhat closing the hole means. A pie reads less accurately than a ring, angle\nbeing harder to judge than length, but it is not *misleading* the way a bar\nmeasured from anything but zero is, which is why this is a value here and\nthe bar chart's baseline is not a property at all.\n\n**Geometry rather than a CSS hook.** The dash arithmetic needs the\ncircumference, which needs the radius, and reading a custom property means\n`getComputedStyle`, which is client-only: a server would draw a different\nring than the client. A plot's proportions are markup for the same reason\n`curve` is.\n\n**And so it does not reflect**, which is the same argument read forward. No\nselector on either tier asks about it and none can want to: everything the\nthickness decides is arithmetic done here and published as\n`--donut-chart-stroke`, which is a number a rule can do sums with where the\nword is not. Reflected, it wrote a value onto every host a script had set\nit on for nothing to read. `sweep` beside it is the converse and reflects,\nbecause the styled sheet selects on it.",
               "fieldName": "hole"
             },
             {
@@ -34149,7 +34149,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -34647,7 +34647,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -40179,7 +40179,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "**The tokens are the consumer's own elements, slotted.** What a filter narrows\nby belongs to the consumer's model rather than to this element: a facet with a\nprefix, a saved query, a range. So they are slotted rather than rendered from\na list of strings, and removing one is a request this element makes rather\nthan a change it applies. Combobox is the other way round, and that is the\ndifference between the two: its tokens are a view of a selection it owns,\ndrawn from options it was handed.\n\n**`value` is the text being typed, not the tokens**, which is what makes this\na field a consumer can listen to. Every keystroke announces `input` with the\ntext on the element, so a table narrows as the reader types. The tokens need\nno reporting back, being markup the consumer already holds.\n\nBackspace on an empty field asks the last token to go, through the same\n`helix-dismiss` its own remove control fires, so a consumer who handled the\npointer has already handled the keyboard.\n\n**It reads what was declared, and nothing that was not.** Write\n`FilterField`s (usually inside the `FilterMenu` slotted into `start`, so the\npicker and the text work off one set), and Enter reads the box against them:\n`disposition:refunded,settled` and `-disposition:refunded` announce\n`helix-facet`, exactly as ticking those values in the picker would, and the\ntext they were read from goes. Everything else stays where it was typed, so\n`refund tuesday disposition:settled` is a filter and a search at once.\n`grammar.ts` carries the whole rule and is worth reading before relying on it;\nthe short version is that Helix owns the punctuation and the consumer owns\nevery word in it. A field with no `FilterField` in it parses nothing, which is\nthe behavior this had before it could.\n\n**A field whose values cannot be listed belongs here rather than in the\npicker.** `assignee:ada` is a filter and nobody wants to enumerate every name\nin the company, but a menu page for it would have nothing on it to press.\nWritten directly inside this element it is read by the grammar and never\noffered as a page: unslotted, so nothing draws it, which is the same trick\n`FilterField` already plays on its own children.\n\n**It can suggest what to type next, and deciding what to suggest is still the\nconsumer's.** Slot options into `suggestions` and the field shows them, moves\nthrough them with the arrows, and lets Enter press one; the option fires its\nown `helix-select` and the consumer decides what choosing meant. Keys before\na colon and values after it are the same panel with different contents, and\n`readFilterText` is exported for a consumer narrowing that panel against what\na reader has half typed.\n\n**The panel opens when there is something in it and closes when there is\nnot**, rather than on a choice. A reader who picks a key wants its values\nnext, and closing on the choice would shut the panel between two renders. Use\n`selectionStart` and `setSelectionRange` to write a completion back and put\nthe caret after it, or the next parse reads the wrong term.\n\n**Three things here have three different owners, and only one of them is a\ncontrolled property.**\n\n`value` is the text, and it is uncontrolled by default: the reader types, the\nelement applies it, and `input` says so. **Writing `value` does not take that\nover.** It is a seed and a correction, so a consumer who sets it and then\nexpects the field to hold still will watch the next keystroke overwrite them.\nOwnership is taken by refusing `helix-before-change` and writing the value\nyou want, which is the same shape every field in this library uses and is\nworth saying out loud here because the property looks like React's.\n`default-value` seeds the field without claiming anything.\n\n`open` is the suggestions panel, and it is the ordinary controlled pair:\nrefuse `helix-before-open` or `helix-before-close` to take the decision, and\n`default-open` to seed it.\n\nThe tokens are neither, because they are not state. They are the consumer's\nown elements in a slot, so there is nothing for this to own and nothing to\nreport back: a token goes when the consumer removes it from their markup,\nhaving been asked by `helix-dismiss`. **A `FilterChip` naming a declared field\nis asked differently**, and it has to be: the picker holds what is ticked, so\na chip that removed itself without telling it left the value ticked in a list\nnobody could see was wrong. That dismissal is answered as the field being\nfiltered by nothing, so it arrives as `helix-facet` like every other change\nand the chip goes because the filter went.",
+          "description": "**The tokens are the consumer's own elements, slotted.** What a filter narrows\nby belongs to the consumer's model rather than to this element: a facet with a\nprefix, a saved query, a range. So they are slotted rather than rendered from\na list of strings, and removing one is a request this element makes rather\nthan a change it applies. Combobox is the other way round, and that is the\ndifference between the two: its tokens are a view of a selection it owns,\ndrawn from options it was handed.\n\n**`value` is the text being typed, not the tokens**, which is what makes this\na field a consumer can listen to. Every keystroke announces `input` with the\ntext on the element, so a table narrows as the reader types. The tokens need\nno reporting back, being markup the consumer already holds.\n\nBackspace on an empty field asks the last token to go, through the same\n`helix-dismiss` its own remove control fires, so a consumer who handled the\npointer has already handled the keyboard.\n\n**It reads what was declared, and nothing that was not.** Write\n`FilterField`s (usually inside the `FilterMenu` slotted into `start`, so the\npicker and the text work off one set), and Enter reads the box against them:\n`disposition:refunded,settled` and `-disposition:refunded` announce\n`helix-facet`, exactly as ticking those values in the picker would, and the\ntext they were read from goes. Everything else stays where it was typed, so\n`refund tuesday disposition:settled` is a filter and a search at once.\n`grammar.ts` carries the whole rule and is worth reading before relying on it;\nthe short version is that Helix owns the punctuation and the consumer owns\nevery word in it. A field with no `FilterField` in it parses nothing, which is\nthe behavior this had before it could.\n\n**A field whose values cannot be listed belongs here rather than in the\npicker.** `assignee:ada` is a filter and nobody wants to enumerate every name\nin the company, but a menu page for it would have nothing on it to press.\nWritten directly inside this element it is read by the grammar and never\noffered as a page: unslotted, so nothing draws it, which is the same trick\n`FilterField` already plays on its own children.\n\n**It can suggest what to type next, and deciding what to suggest is still the\nconsumer's.** Slot options into `suggestions` and the field shows them, moves\nthrough them with the arrows, and lets Enter press one; the option fires its\nown `helix-select` and the consumer decides what choosing meant. Keys before\na colon and values after it are the same panel with different contents, and\n`readFilterText` is exported for a consumer narrowing that panel against what\na reader has half typed.\n\n**The panel opens when there is something in it and closes when there is\nnot**, rather than on a choice. A reader who picks a key wants its values\nnext, and closing on the choice would shut the panel between two renders. Use\n`selectionStart` and `setSelectionRange` to write a completion back and put\nthe caret after it, or the next parse reads the wrong term.\n\n**Three things here have three different owners.**\n\n`value` is the text: the reader types, the element applies it, and `input`\nsays so. **Writing `value` does not take that over.** It is a seed and a\ncorrection, so a consumer who sets it and then expects the field to hold\nstill will watch the next keystroke overwrite them.\nOwnership is taken by refusing `helix-before-change` and writing the value\nyou want, which is the same shape every field in this library uses and is\nworth saying out loud here because the property looks like React's.\n`default-value` seeds the field without claiming anything.\n\n`open` is the suggestions panel, and it is the ordinary pair: refuse\n`helix-before-open` or `helix-before-close` to take the decision, and\n`default-open` to seed it.\n\nThe tokens are neither, because they are not state. They are the consumer's\nown elements in a slot, so there is nothing for this to own and nothing to\nreport back: a token goes when the consumer removes it from their markup,\nhaving been asked by `helix-dismiss`. **A `FilterChip` naming a declared field\nis asked differently**, and it has to be: the picker holds what is ticked, so\na chip that removed itself without telling it left the value ticked in a list\nnobody could see was wrong. That dismissal is answered as the field being\nfiltered by nothing, so it arrives as `helix-facet` like every other change\nand the chip goes because the filter went.",
           "name": "HelixHeadlessFilterInput",
           "cssParts": [
             {
@@ -40715,7 +40715,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -41958,7 +41958,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -54366,7 +54366,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -54857,7 +54857,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -56122,7 +56122,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -56661,7 +56661,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -58167,7 +58167,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -58641,7 +58641,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -62163,12 +62163,23 @@
               "default": "false",
               "description": "Set by a keyboard move, so the next render brings the active row into view."
             },
+            {
+              "kind": "field",
+              "name": "ESTIMATE",
+              "type": {
+                "text": "number"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "24",
+              "description": "How tall a row is taken to be before it has been drawn, in pixels.\n\nA constant rather than the property `VirtualList` and `DataTable` carry:\nevery row here is one line of the same text at this family's own leading,\nso there is nothing for a consumer to tell it. `reveal` falls back to this\nwhen a drawn row measures zero, and the two have to be the same number or a\nkeyboard move scrolls by a different row than the window counted with."
+            },
             {
               "kind": "field",
               "name": "virtualize",
               "privacy": "private",
               "readonly": true,
-              "default": "new VirtualizeController(this, { container: () => (this.windowed ? this.partNamed('tree') : null), count: () => this.rows.length, estimate: () => 24, measured: () => this.windowed, rows: () => [...(this.renderRoot?.querySelectorAll<HTMLElement>('[part~=\"row\"]') ?? [])].map( (element) => ({ element, index: Number(element.dataset.index) }), ), })"
+              "default": "new VirtualizeController(this, { container: () => (this.windowed ? this.partNamed('tree') : null), count: () => this.rows.length, estimate: () => HelixHeadlessObjectInspector.ESTIMATE, measured: () => this.windowed, rows: () => [...(this.renderRoot?.querySelectorAll<HTMLElement>('[part~=\"row\"]') ?? [])].map( (element) => ({ element, index: Number(element.dataset.index) }), ), })"
             },
             {
               "kind": "field",
@@ -63386,7 +63397,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "A second destination for this row, taken with the modifier held.\n\n**An attribute rather than a second row, which is the whole point.** A\npalette of eighty-eight components that offered each of them a reference\npage and a sandbox as separate entries would be a palette of a hundred and\nseventy-six, and one earns its keep by getting a reader to one thing in\nthree keystrokes. The row already carries the first destination, so the\nsecond belongs beside it.\n\nDeclared here and acted on by whatever owns the list, the same division\nselection already uses: an option says what it is and the listbox decides\nwhat happens. `Command` is the only owner that reads it today, because a\nselect has one destination by definition.\n\nAbsent is a row with one destination, which is nearly every row.",
+              "description": "A second destination for this row, taken with the modifier held.\n\n**An attribute rather than a second row, which is the whole point.** A\npalette that offered every component a reference page and a sandbox as\nseparate entries would be twice as long, and one earns its keep by getting\na reader to one thing in three keystrokes. The row already carries the\nfirst destination, so the second belongs beside it.\n\nDeclared here and acted on by whatever owns the list, the same division\nselection already uses: an option says what it is and the listbox decides\nwhat happens. `Command` is the only owner that reads it today, because a\nselect has one destination by definition.\n\nAbsent is a row with one destination, which is nearly every row.",
               "attribute": "alternate"
             },
             {
@@ -63830,7 +63841,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "A second destination for this row, taken with the modifier held.\n\n**An attribute rather than a second row, which is the whole point.** A\npalette of eighty-eight components that offered each of them a reference\npage and a sandbox as separate entries would be a palette of a hundred and\nseventy-six, and one earns its keep by getting a reader to one thing in\nthree keystrokes. The row already carries the first destination, so the\nsecond belongs beside it.\n\nDeclared here and acted on by whatever owns the list, the same division\nselection already uses: an option says what it is and the listbox decides\nwhat happens. `Command` is the only owner that reads it today, because a\nselect has one destination by definition.\n\nAbsent is a row with one destination, which is nearly every row.",
+              "description": "A second destination for this row, taken with the modifier held.\n\n**An attribute rather than a second row, which is the whole point.** A\npalette that offered every component a reference page and a sandbox as\nseparate entries would be twice as long, and one earns its keep by getting\na reader to one thing in three keystrokes. The row already carries the\nfirst destination, so the second belongs beside it.\n\nDeclared here and acted on by whatever owns the list, the same division\nselection already uses: an option says what it is and the listbox decides\nwhat happens. `Command` is the only owner that reads it today, because a\nselect has one destination by definition.\n\nAbsent is a row with one destination, which is nearly every row.",
               "fieldName": "alternate"
             },
             {
@@ -65737,7 +65748,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Its own element beside `Pagination` rather than a slot inside it, for the\nreason `Pagination.Summary` is: a footer's direction and order are the\nconsumer's, and a control that can only sit at one end of one row has taken\nthat decision for them.\n\n**`Select`, not a native `<select>`.** Two dropdowns identical closed and\ndifferent open meet each other in the same footer as a table's filters. The\ncaret is `Select`'s rather than a color literal baked into a data URI,\nbecause a background image cannot read `currentColor`, and the label is a\nreal `<label for>` against the trigger's own id.\n\n**The label sits on the row, not above it.** `Select`'s host is a column, and\nan outer-tree rule beats a `:host` rule, so turning it into a row needs no\nproperty on `Select` and nothing written into the consumer's markup.\n\n**An empty `sizes` renders nothing**, rather than falling back to the\nbuilt-in list, which would be a component overruling a consumer who said\n\"none\". Same rule as `Pagination` over a single page, and reported the same\nway, through `ElementInternals.states` rather than an attribute the server\nnever wrote.\n\n`value` is the controlled property and `default-value` seeds one this owns.\nChanging it announces `helix-before-change`; re-querying and moving back to\npage one is the consumer's, because only they know whether the reader's\nposition should survive it.",
+          "description": "Its own element beside `Pagination` rather than a slot inside it, for the\nreason `Pagination.Summary` is: a footer's direction and order are the\nconsumer's, and a control that can only sit at one end of one row has taken\nthat decision for them.\n\n**`Select`, not a native `<select>`.** Two dropdowns identical closed and\ndifferent open meet each other in the same footer as a table's filters. The\ncaret is `Select`'s rather than a color literal baked into a data URI,\nbecause a background image cannot read `currentColor`, and the label is a\nreal `<label for>` against the trigger's own id.\n\n**The label sits on the row, not above it.** `Select`'s host is a column, and\nan outer-tree rule beats a `:host` rule, so turning it into a row needs no\nproperty on `Select` and nothing written into the consumer's markup.\n\n**An empty `sizes` renders nothing**, rather than falling back to the\nbuilt-in list, which would be a component overruling a consumer who said\n\"none\". Same rule as `Pagination` over a single page, and reported the same\nway, through `ElementInternals.states` rather than an attribute the server\nnever wrote.\n\n`value` is the size the control holds and `default-value` is what the markup\ndeclared.\nChanging it announces `helix-before-change`; re-querying and moving back to\npage one is the consumer's, because only they know whether the reader's\nposition should survive it.",
           "name": "HelixHeadlessPaginationSize",
           "cssParts": [
             {
@@ -68525,7 +68536,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -69008,7 +69019,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -75689,7 +75700,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -76755,7 +76766,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -80573,7 +80584,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -81064,7 +81075,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -83299,7 +83310,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Initial item for uncontrolled use.\n\nIgnored once `active` is written.",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
               "attribute": "default-active",
               "inheritedFrom": {
                 "name": "MixinControllerActive",
@@ -83786,7 +83797,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Initial item for uncontrolled use.\n\nIgnored once `active` is written.",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
               "fieldName": "defaultActive",
               "inheritedFrom": {
                 "name": "MixinControllerActive",
@@ -84566,7 +84577,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial checked state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it checked, which is where a reset returns to.",
               "attribute": "default-checked",
               "inheritedFrom": {
                 "name": "MixinControllerChecked",
@@ -85448,7 +85459,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial checked state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it checked, which is where a reset returns to.",
               "fieldName": "defaultChecked",
               "inheritedFrom": {
                 "name": "MixinControllerChecked",
@@ -88642,7 +88653,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Initial item for uncontrolled use.\n\nIgnored once `active` is written.",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
               "attribute": "default-active",
               "inheritedFrom": {
                 "name": "MixinControllerActive",
@@ -89130,7 +89141,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Initial item for uncontrolled use.\n\nIgnored once `active` is written.",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
               "fieldName": "defaultActive",
               "inheritedFrom": {
                 "name": "MixinControllerActive",
@@ -92553,7 +92564,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -93850,7 +93861,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -100541,7 +100552,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -101078,7 +101089,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -102967,7 +102978,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "attribute": "default-open",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -103476,7 +103487,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Initial open state for uncontrolled use, where nothing declared one.",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
               "fieldName": "defaultOpen",
               "inheritedFrom": {
                 "name": "MixinControllerOpen",
@@ -103864,7 +103875,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Initial item for uncontrolled use.\n\nIgnored once `active` is written.",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
               "attribute": "default-active",
               "inheritedFrom": {
                 "name": "MixinControllerActive",
@@ -104382,7 +104393,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Initial item for uncontrolled use.\n\nIgnored once `active` is written.",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
               "fieldName": "defaultActive",
               "inheritedFrom": {
                 "name": "MixinControllerActive",
@@ -106214,7 +106225,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Initial item for uncontrolled use.\n\nIgnored once `active` is written.",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
               "attribute": "default-active",
               "inheritedFrom": {
                 "name": "MixinControllerActive",
@@ -106677,7 +106688,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Initial item for uncontrolled use.\n\nIgnored once `active` is written.",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
               "fieldName": "defaultActive",
               "inheritedFrom": {
                 "name": "MixinControllerActive",

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

@@ -69,12 +69,11 @@ export declare class HelixHeadlessCarousel extends HelixElement {
     /**
      * 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

package/dist/checkbox-group/root/checkbox-group-root.d.ts

@@ -87,10 +87,10 @@ export declare class HelixHeadlessCheckboxGroup extends HelixHeadlessCheckboxGro
      * because the group is what it is dispatched from: without the guard the
      * group answers itself until the stack gives out.
      *
-     * The requested state comes from the event rather than from the box. Driving
-     * the boxes from `value` makes them controlled, so a controlled box applies
-     * nothing on its own and reports what it was asked for. Reading `checked`
-     * here would read the state it still holds and nothing would ever change.
+     * The requested state comes from the event rather than from the box.
+     * `helix-before-toggle` is dispatched before the box applies, so reading
+     * `checked` here would read the state it still holds and nothing would ever
+     * change.
      */
     private readonly handleToggle;
     /**