@fusion.dev/helix-headless 0.175.0 → 0.176.0

package/custom-elements.json

@@ -69284,14 +69284,6 @@
             "module": "src/filter-input/grammar.js"
           }
         },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "module": "src/filter-input/menu/filter-menu.js"
-          }
-        },
         {
           "kind": "js",
           "name": "*",
@@ -69316,7 +69308,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Reads the `FilterField` declarations inside it and renders a two-level menu:\nthe fields, and under each field its operators and values. The menu does not\ninterpret what a field means.\n\n```html\n<helix-headless-filter-menu label=\"Filter\">\n  <helix-headless-filter-field name=\"disposition\" label=\"Disposition\">\n    <helix-headless-option value=\"refunded\">Refunded</helix-headless-option>\n  </helix-headless-filter-field>\n</helix-headless-filter-menu>\n```\n\nThat field declares no operators, so it offers `is any of` and `is none of`,\nthe two the typed grammar supports. The menu and the typed text offer the\nsame filters because both read `FilterField.vocabulary`. Declare other\noperators on the field when you need them.\n\nTicking a value applies the filter immediately. There is no Apply button.\nEach tick fires `helix-facet` with the field's whole set of values, so\nresults narrow as the user works. Unticking the last value fires an empty\nset, which is your cue to remove the chip.\n\nThe operator is chosen in the menu. `helix-facet` carries an empty\n`operatorLabel` when the operator is the field's default, which is the value\na chip's `operator-label` expects, so the operator segment appears only for a\nnon-default choice. The menu decides this because it is the only element that\nreads both the field and its operators.\n\nAn operator's `arity` sets what appears under it:\n\n- `arity=\"none\"`, such as `is empty` or `is set`, offers no values and clears\n  any that were ticked. The operator is the whole filter.\n- `arity=\"one\"` offers the values as a single choice. Pressing another value\n  replaces the choice, and pressing the chosen value clears it.\n\n`helix-facet` includes `arity`, so you can tell an empty filter from no\nfilter.\n\nThe menu applies nothing. The chips are your markup and the rows are your\ndata, so the menu fires the event and leaves the change to you, as\n`Notification` does for a read. Call `preventDefault()` on `helix-facet` to\ncancel the change.",
+          "description": "Reads the `FilterField` declarations inside it and renders a two-level menu:\nthe fields, and under each field its operators and values. The menu does not\ninterpret what a field means.\n\n```html\n<helix-headless-filter-menu label=\"Filter\">\n  <helix-headless-filter-field name=\"disposition\" label=\"Disposition\">\n    <helix-headless-option value=\"refunded\">Refunded</helix-headless-option>\n  </helix-headless-filter-field>\n</helix-headless-filter-menu>\n```\n\nThat field declares no operators, so it offers `is any of` and `is none of`,\nthe two the typed grammar supports. The menu and the typed text offer the\nsame filters because both read `FilterField.vocabulary`. Declare other\noperators on the field when you need them.\n\nTicking a value applies the filter immediately. There is no Apply button.\nEach tick fires `helix-facet` with the field's whole set of values, so\nresults narrow as the user works. Unticking the last value fires an empty\nset, which is your cue to remove the chip.\n\nThe operator is chosen in the menu. `helix-facet` carries an empty\n`operatorLabel` when the operator is the field's default, which is the value\na chip's `operator-label` expects, so the operator segment appears only for a\nnon-default choice. The menu decides this because it is the only element that\nreads both the field and its operators.\n\nAn operator's `arity` sets what appears under it:\n\n- `arity=\"none\"`, such as `is empty` or `is set`, offers no values and clears\n  any that were ticked. The operator is the whole filter.\n- `arity=\"one\"` offers the values as a single choice. Pressing another value\n  replaces the choice, and pressing the chosen value clears it.\n\n`helix-facet` includes `arity`, so you can tell an empty filter from no\nfilter.\n\nThe menu applies nothing. The chips are your markup and the rows are your\ndata, so the menu fires the event and leaves the change to you, as\n`Notification` does for a read. Call `preventDefault()` on `helix-facet` to\ncancel the change.\n\nImported from its own entry, `@fusion.dev/helix-headless/filter-input/menu`, which registers\nit with the `Menu` it draws its pages with. The family's entry leaves it out,\nso a field without a picker does not carry `Menu`.",
           "name": "HelixHeadlessFilterMenu",
           "cssParts": [
             {
@@ -69999,6 +69991,21 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/filter-input/menu/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/filter-input/menu/filter-menu.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/filter-input/operator/filter-operator.ts",
@@ -70484,7 +70491,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Tokens are your own elements, slotted in. A filter can be a facet with a\nprefix, a saved query, or a range, and these belong to your model, so the\nelement does not render tokens from a list of strings. Removing a token is a\nrequest the element fires, and you apply it. Combobox works the other way:\nits tokens show a selection it owns, drawn from the options it was given.\n\n`value` is the typed text. Every keystroke fires `input` with the text on the\nelement, so a table can narrow as the user types. Backspace in an empty field\nfires `helix-dismiss` on the last token, the same event its remove control\nfires, so one handler covers the pointer and the keyboard.\n\n**What a form receives.** The text under `name`, and then one more entry\nunder `name` for each token, in the order the tokens stand:\n\n| Token | Entry |\n|---|---|\n| Any element with a `value` attribute | The value as written: `saved:mine` |\n| `FilterChip` with `name` and values | `status:open,pending` |\n| The same, with `operator=\"none\"` (what a typed `-status:` makes) | `-status:open,pending` |\n| The same, with any other `operator` except `any` | `created[after]:2024` |\n| A token with neither | Nothing |\n\nThe values are the chip's text outside its `field` and `operator` slots,\nwith the spaces around each comma removed. A server splits an entry at its\nfirst colon, reads a leading `-` as the negation, and reads a word in\nbrackets before the colon as the comparison.\n\n**Keyboard.** Focus stays in the text, which is the field's one tab stop. The\ntext names the highlighted suggestion as its `aria-activedescendant`, and the\narrow keys reach the tokens.\n\n| Key | What it does |\n|---|---|\n| Enter | Presses the highlighted suggestion. With none highlighted, reads the typed filters into chips, or submits the form when there are none. |\n| Down, Up | Moves the highlight through the suggestions, wrapping, and opens the panel. |\n| Home, End | Highlights the first or the last suggestion while the panel is open. |\n| Escape | Closes the panel and stops there, so a dialog around the field stays open. |\n| Backspace | In an empty field, asks the last token to go. |\n| Left | With the caret at the start of the text, moves to the last token's remove button. Right on a right-to-left page. |\n| Left, Right on a token | Move between the tokens, and past the last back to the text. |\n| Delete, Backspace on a token | Asks the token to go. |\n\n**Typed filters.** The field parses only the fields you declare. Write\n`FilterField` elements, usually inside the `FilterMenu` slotted into `start`,\nso the picker and the text share one set. On Enter, the field reads the text\nagainst them. `disposition:refunded,settled` and `-disposition:refunded` fire\n`helix-facet` exactly as ticking those values in the picker would, and the\nparsed text is removed. Everything else stays, so `refund tuesday\ndisposition:settled` is a filter and a search at once. Helix defines the\npunctuation and you define every word. `grammar.ts` has the full rule, so\nread it before you rely on it. A field with no `FilterField` in it parses\nnothing.\n\nA field whose values cannot be listed, such as `assignee:ada`, goes directly\ninside this element, outside the menu. It is not assigned to a slot, so\nnothing draws it and the menu has no page for it, and the grammar still reads\nit.\n\n**Suggestions.** Slot options into `suggestions` and the field shows them,\nmoves through them with the arrow keys, and presses one on Enter. The option\nfires its own `helix-select`, and you decide what choosing it means. Keys\nbefore a colon and values after it use the same panel with different\ncontents. `filter-suggestions` narrows the panel to the options whose words\nhold the term at the caret, after its colon, ignoring case and accents, and\nhides the rest. `readFilterText` is exported so you can narrow it yourself\nagainst partly typed text. While the panel is open, a reader hears how many\nsuggestions it offers. The panel opens when it has options and closes when it has\nnone, and a choice does not close it, so after picking a key you see its\nvalues next. Use `selectionStart` and `setSelectionRange` to write a\ncompletion back and put the caret after it, or the next parse reads the wrong\nterm.\n\n**State.** Three things have three different owners:\n\n- `value` is the text. The user types, the element applies it, and `input`\n  reports it. Setting `value` seeds or corrects the text, and the next\n  keystroke overwrites it, even in React. To control the value, cancel\n  `helix-before-change` and write the value you want, as with every field in\n  this library. `default-value` seeds the field.\n- `open` is the suggestions panel. Cancel `helix-before-open` or\n  `helix-before-close` to control it, and use `default-open` to seed it.\n- Tokens are your elements in a slot and hold no state. A token goes when you\n  remove it from your markup after `helix-dismiss`. A `FilterChip` naming a\n  declared field works differently, because the picker holds what is ticked\n  and removing the chip alone would leave its value ticked in the hidden\n  menu. Its dismissal is treated as the field being filtered by nothing, so\n  it fires `helix-facet` like every other change, and the chip goes when the\n  filter goes. Set `chips` and the field adds, updates, and removes those\n  chips itself, from every `helix-facet` you do not cancel.",
+          "description": "Tokens are your own elements, slotted in. A filter can be a facet with a\nprefix, a saved query, or a range, and these belong to your model, so the\nelement does not render tokens from a list of strings. Removing a token is a\nrequest the element fires, and you apply it. Combobox works the other way:\nits tokens show a selection it owns, drawn from the options it was given.\n\n`value` is the typed text. Every keystroke fires `input` with the text on the\nelement, so a table can narrow as the user types. Backspace in an empty field\nfires `helix-dismiss` on the last token, the same event its remove control\nfires, so one handler covers the pointer and the keyboard.\n\n**What a form receives.** The text under `name`, and then one more entry\nunder `name` for each token, in the order the tokens stand:\n\n| Token | Entry |\n|---|---|\n| Any element with a `value` attribute | The value as written: `saved:mine` |\n| `FilterChip` with `name` and values | `status:open,pending` |\n| The same, with `operator=\"none\"` (what a typed `-status:` makes) | `-status:open,pending` |\n| The same, with any other `operator` except `any` | `created[after]:2024` |\n| A token with neither | Nothing |\n\nThe values are the chip's text outside its `field` and `operator` slots,\nwith the spaces around each comma removed. A server splits an entry at its\nfirst colon, reads a leading `-` as the negation, and reads a word in\nbrackets before the colon as the comparison.\n\n**Keyboard.** Focus stays in the text, which is the field's one tab stop. The\ntext names the highlighted suggestion as its `aria-activedescendant`, and the\narrow keys reach the tokens.\n\n| Key | What it does |\n|---|---|\n| Enter | Presses the highlighted suggestion. With none highlighted, reads the typed filters into chips, or submits the form when there are none. |\n| Down, Up | Moves the highlight through the suggestions, wrapping, and opens the panel. |\n| Home, End | Highlights the first or the last suggestion while the panel is open. |\n| Escape | Closes the panel and stops there, so a dialog around the field stays open. With the panel closed, empties the text. In an empty field, does nothing, so the page hears it. |\n| Backspace | In an empty field, asks the last token to go. |\n| Left | With the caret at the start of the text, moves to the last token's remove button. Right on a right-to-left page. |\n| Left, Right on a token | Move between the tokens, and past the last back to the text. |\n| Delete, Backspace on a token | Asks the token to go. |\n\n**Typed filters.** The field parses only the fields you declare. Write\n`FilterField` elements, usually inside the `FilterMenu` slotted into `start`,\nso the picker and the text share one set. On Enter, the field reads the text\nagainst them, and a paste is read the same way as soon as it lands.\n`disposition:refunded,settled` and `-disposition:refunded` fire\n`helix-facet` exactly as ticking those values in the picker would, and the\nparsed text is removed. Everything else stays, so `refund tuesday\ndisposition:settled` is a filter and a search at once. Helix defines the\npunctuation and you define every word. `grammar.ts` has the full rule, so\nread it before you rely on it. A field with no `FilterField` in it parses\nnothing.\n\nA field whose values cannot be listed, such as `assignee:ada`, goes directly\ninside this element, outside the menu. It is not assigned to a slot, so\nnothing draws it and the menu has no page for it, and the grammar still reads\nit.\n\n**The picker has an entry of its own.** `FilterMenu` draws its pages with\n`Menu`, which a field without a picker does not need, so this family's entry\nleaves it out. A page that writes one imports\n`@fusion.dev/helix/filter-input/menu` as well, and a picker written without it\nis reported once the page has loaded, with the entry to add.\n\n**Suggestions.** Slot options into `suggestions` and the field shows them,\nmoves through them with the arrow keys, and presses one on Enter. The option\nfires its own `helix-select`, and you decide what choosing it means. Keys\nbefore a colon and values after it use the same panel with different\ncontents. `filter-suggestions` narrows the panel to the options whose words\nhold the term at the caret, after its colon, ignoring case and accents, and\nhides the rest. `readFilterText` is exported so you can narrow it yourself\nagainst partly typed text. While the panel is open, a reader hears how many\nsuggestions it offers. The panel opens when it has options and closes when it has\nnone, and a choice does not close it, so after picking a key you see its\nvalues next. Use `selectionStart` and `setSelectionRange` to write a\ncompletion back and put the caret after it, or the next parse reads the wrong\nterm.\n\n**State.** Three things have three different owners:\n\n- `value` is the text. The user types, the element applies it, and `input`\n  reports it. Setting `value` seeds or corrects the text, and the next\n  keystroke overwrites it, even in React. To control the value, cancel\n  `helix-before-change` and write the value you want, as with every field in\n  this library. `default-value` seeds the field.\n- `open` is the suggestions panel. Cancel `helix-before-open` or\n  `helix-before-close` to control it, and use `default-open` to seed it.\n- Tokens are your elements in a slot and hold no state. A token goes when you\n  remove it from your markup after `helix-dismiss`. A `FilterChip` naming a\n  declared field works differently, because the picker holds what is ticked\n  and removing the chip alone would leave its value ticked in the hidden\n  menu. Its dismissal is treated as the field being filtered by nothing, so\n  it fires `helix-facet` like every other change, and the chip goes when the\n  filter goes. Set `chips` and the field adds, updates, and removes those\n  chips itself, from every `helix-facet` you do not cancel.",
           "name": "HelixHeadlessFilterInput",
           "cssParts": [
             {
@@ -71011,7 +71018,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "HelixHeadlessFilterMenu | null"
+                  "text": "FieldPicker | null"
                 }
               },
               "parameters": [
@@ -71074,7 +71081,7 @@
               "name": "handleDismiss",
               "privacy": "private",
               "readonly": true,
-              "description": "A chip asking to go, answered as the filter going.\n\n**Taken rather than passed on, and only for a chip naming a declared\nfield.** Left alone, a dismissed chip removed itself and told the picker\nnothing, so the menu went on showing the value ticked and the reader's next\npress on it read as *unticking*: they pressed `Refunded` and nothing came\nback. Turning the request into `apply(field, [])` puts it down the one road\nevery other filter takes, so the chip goes because the filter went. A\nconsumer refusing that `helix-facet` keeps both, which is the answer a\nrefusal should give.\n\nEverything else in the row is untouched: a plain `Tag`, or a chip for\nsomething no `FilterField` declares, is the consumer's to answer."
+              "description": "A chip asking to go, answered as the filter going.\n\n**Taken rather than passed on, and only for a chip naming a declared\nfield.** Left alone, a dismissed chip removed itself and told the picker\nnothing, so the menu went on showing the value ticked and the reader's next\npress on it read as *unticking*: they pressed `Refunded` and nothing came\nback. Turning the request into `apply(field, [])` puts it down the one road\nevery other filter takes, so the chip goes because the filter went. A\nconsumer refusing that `helix-facet` keeps both, which is the answer a\nrefusal should give.\n\nEverything else in the row is untouched: a plain `Tag`, or a chip for\nsomething no `FilterField` declares, is the consumer's to answer.\n\n**Heard on the way down, in the capture phase**, because the chip is a\nchild of this element and its request passes here before it reaches the\nchip's listeners or comes back up. Stopped there, no listener on the chip,\non this element or above it hears it. Heard on the way up, `stopPropagation`\nkept it from the ancestors and not from this element's other listeners, so a\nconsumer listening on the field heard `helix-dismiss` as well as the\n`helix-facet` that answered it."
             },
             {
               "kind": "method",
@@ -71216,6 +71223,17 @@
                 "module": "src/mixins/mixin-tokens/mixin-tokens.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "auditPicker",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Says so when a picker is written in the field and never registered.\n\nThe picker has an entry of its own, so a page that imports only the field\ngets an inert element there: a trigger that opens nothing. Asked once the\npage has loaded and painted, so an entry a later module imports is not\ntaken for a missing one."
+            },
             {
               "kind": "method",
               "name": "markActive",
@@ -81564,6 +81582,21 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/icon/all/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/icon/index.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/icon/fetch.ts",
@@ -81870,7 +81903,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The icons are Phosphor, drawn on a 256 box at stroke-width 16. Each glyph\nrenders its full inner markup, because most icons are several elements, each\nwith its own stroke and fill.\n\nThe markup is generated at build time from SVG files in this repository and\nnever comes from user input, so rendering it with `unsafeSVG` is safe.\n\nThe `<svg>` carries `fill=\"currentColor\"`. The generator keeps only the inner\nmarkup, and Phosphor sets its fill on the root tag that the generator\ndiscards. Without it, the 65 solid glyphs fall back to black and disappear on\na dark background. Shapes that set their own `fill` or `stroke` are\nunaffected.\n\n**A name is looked up in a registry.** The family's entry registers the\nwhole set, so any name in it draws. The element's own entry,\n`@fusion.dev/helix-headless/icon/root`, registers none: a page that imports\nit and calls `registerIcons` with the glyphs it names ships those and no\nothers. `registerIconLibrary` resolves names under a prefix of your own,\nsuch as `lucide:camera`, at once or later, and the element fires `load` when\na glyph that came later is drawn. A glyph registered after the element\nrendered is drawn then.\n\n**Or point `src` at an SVG file**, such as `src=\"/icons/rocket.svg\"`, and\nthe element fetches it and draws its shapes in `currentColor` where the file\ndoes not color them. A file is fetched once a page, however many icons name\nit, and `load` fires when it is drawn. Scripts, event handlers and\n`javascript:` links in the file are taken out before it is drawn. A server\nfetches nothing, so a served icon with a `src` is drawn once the script\nruns.\n\nA name with no match, or a `src` that is no SVG, renders nothing, and the\nelement fires `error`, so a typo in a name can be heard. It waits until the page has loaded and painted\nfirst, so a library a later module registers is not taken for a typo.\n\nAn icon is decorative by default and hidden from assistive technology. Set\n`label` only when the icon is the only carrier of meaning, such as in a\nbutton with no text. An `aria-label` on the element works too: the element\nis then an image with that name.\n\n**A decorative icon that is all a control holds is reported.** In a\ndevelopment build, a button or a link whose only content is an icon with no\n`label`, and which has no name of its own, warns `missing-name` once,\nthrough the runtime channel every Helix warning uses.",
+          "description": "The icons are Phosphor, drawn on a 256 box at stroke-width 16. Each glyph\nrenders its full inner markup, because most icons are several elements, each\nwith its own stroke and fill.\n\nThe markup is generated at build time from SVG files in this repository and\nnever comes from user input, so rendering it with `unsafeSVG` is safe.\n\nThe `<svg>` carries `fill=\"currentColor\"`. The generator keeps only the inner\nmarkup, and Phosphor sets its fill on the root tag that the generator\ndiscards. Without it, the 65 solid glyphs fall back to black and disappear on\na dark background. Shapes that set their own `fill` or `stroke` are\nunaffected.\n\n**A name is looked up in a registry.** The family's entry registers a small\nset: the four carets, `arrow-left`, `arrow-right`, `check`, `x`, `plus`,\n`minus`, `magnifying-glass`, `info` and `warning`. `icon/all` registers the\nwhole set, so any name in it draws, and a name that resolves to nothing\nsays to import it. The element's own entry,\n`@fusion.dev/helix-headless/icon/root`, registers none: a page that imports\nit and calls `registerIcons` with the glyphs it names ships those and no\nothers. `registerIconLibrary` resolves names under a prefix of your own,\nsuch as `lucide:camera`, at once or later, and the element fires `load` when\na glyph that came later is drawn. A glyph registered after the element\nrendered is drawn then.\n\n**Or point `src` at an SVG file**, such as `src=\"/icons/rocket.svg\"`, and\nthe element fetches it and draws its shapes in `currentColor` where the file\ndoes not color them. A file is fetched once a page, however many icons name\nit, and `load` fires when it is drawn. Scripts, event handlers and\n`javascript:` links in the file are taken out before it is drawn. A server\nfetches nothing, so a served icon with a `src` is drawn once the script\nruns.\n\nA name with no match, or a `src` that is no SVG, renders nothing, and the\nelement fires `error`, so a typo in a name can be heard. It waits until the page has loaded and painted\nfirst, so a library a later module registers is not taken for a typo.\n\nAn icon is decorative by default and hidden from assistive technology. Set\n`label` only when the icon is the only carrier of meaning, such as in a\nbutton with no text. An `aria-label` on the element works too: the element\nis then an image with that name.\n\n**A decorative icon that is all a control holds is reported.** In a\ndevelopment build, a button or a link whose only content is an icon with no\n`label`, and which has no name of its own, warns `missing-name` once,\nthrough the runtime channel every Helix warning uses.",
           "name": "HelixHeadlessIcon",
           "cssParts": [
             {
@@ -81914,7 +81947,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The name of the icon in the Helix set.\n\n**A lookup, and the reason both this and `icon` exist.** A name is a string,\nso it is what markup can carry, and resolving one means an index of the\nwhole set that no bundler can shake: 15 kB for a consumer who renders one\nmark. An attribute is the only thing an HTML author can write, and that is\nworth the index; a consumer who would rather not pay it imports the\nelement from `icon/root` and registers the glyphs it names, or hands over\nthe value instead.\n\nA name written `prefix:name` asks the library registered under that\nprefix.",
+              "description": "The name of the icon in the Helix set.\n\n**A lookup, and the reason both this and `icon` exist.** A name is a string,\nso it is what markup can carry, and resolving one means an index that no\nbundler can shake. The family's entry indexes a small set, `icon/all`\nindexes the whole set at 15 kB, and `icon/root` indexes nothing, for a\npage that registers the glyphs it names or hands over the value instead.\n\nA name written `prefix:name` asks the library registered under that\nprefix.",
               "attribute": "name"
             },
             {
@@ -82465,7 +82498,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The name of the icon in the Helix set.\n\n**A lookup, and the reason both this and `icon` exist.** A name is a string,\nso it is what markup can carry, and resolving one means an index of the\nwhole set that no bundler can shake: 15 kB for a consumer who renders one\nmark. An attribute is the only thing an HTML author can write, and that is\nworth the index; a consumer who would rather not pay it imports the\nelement from `icon/root` and registers the glyphs it names, or hands over\nthe value instead.\n\nA name written `prefix:name` asks the library registered under that\nprefix.",
+              "description": "The name of the icon in the Helix set.\n\n**A lookup, and the reason both this and `icon` exist.** A name is a string,\nso it is what markup can carry, and resolving one means an index that no\nbundler can shake. The family's entry indexes a small set, `icon/all`\nindexes the whole set at 15 kB, and `icon/root` indexes nothing, for a\npage that registers the glyphs it names or hands over the value instead.\n\nA name written `prefix:name` asks the library registered under that\nprefix.",
               "fieldName": "name"
             },
             {
@@ -83776,6 +83809,14 @@
             "module": "src/filter-input/index.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/filter-input/menu/index.js"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -83805,7 +83846,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "module": "src/icon/index.js"
+            "module": "src/icon/all/index.js"
           }
         },
         {
@@ -198274,6 +198315,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-headless",
-    "version": "0.175.0"
+    "version": "0.176.0"
   }
 }

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

@@ -1,6 +1,5 @@
 export * from './chip/filter-chip.js';
 export * from './field/filter-field.js';
 export * from './grammar.js';
-export * from './menu/filter-menu.js';
 export * from './operator/filter-operator.js';
 export * from './root/filter-input-root.js';

package/dist/filter-input/index.js

@@ -1,6 +1,5 @@
 export * from './chip/filter-chip.js';
 export * from './field/filter-field.js';
 export * from './grammar.js';
-export * from './menu/filter-menu.js';
 export * from './operator/filter-operator.js';
 export * from './root/filter-input-root.js';

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

@@ -51,6 +51,10 @@ import '../../menu/index.js';
  * `Notification` does for a read. Call `preventDefault()` on `helix-facet` to
  * cancel the change.
  *
+ * Imported from its own entry, `@fusion.dev/helix-headless/filter-input/menu`, which registers
+ * it with the `Menu` it draws its pages with. The family's entry leaves it out,
+ * so a field without a picker does not carry `Menu`.
+ *
  * @since 0.25.0
  * @status stable
  * @category forms

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

@@ -0,0 +1 @@
+export * from './filter-menu.js';

package/dist/filter-input/menu/index.js

@@ -0,0 +1 @@
+export * from './filter-menu.js';

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

@@ -42,7 +42,7 @@ declare const HelixHeadlessFilterInput_base: (new (...args: any[]) => import("@f
  * | Enter | Presses the highlighted suggestion. With none highlighted, reads the typed filters into chips, or submits the form when there are none. |
  * | Down, Up | Moves the highlight through the suggestions, wrapping, and opens the panel. |
  * | Home, End | Highlights the first or the last suggestion while the panel is open. |
- * | Escape | Closes the panel and stops there, so a dialog around the field stays open. |
+ * | Escape | Closes the panel and stops there, so a dialog around the field stays open. With the panel closed, empties the text. In an empty field, does nothing, so the page hears it. |
  * | Backspace | In an empty field, asks the last token to go. |
  * | Left | With the caret at the start of the text, moves to the last token's remove button. Right on a right-to-left page. |
  * | Left, Right on a token | Move between the tokens, and past the last back to the text. |
@@ -51,7 +51,8 @@ declare const HelixHeadlessFilterInput_base: (new (...args: any[]) => import("@f
  * **Typed filters.** The field parses only the fields you declare. Write
  * `FilterField` elements, usually inside the `FilterMenu` slotted into `start`,
  * so the picker and the text share one set. On Enter, the field reads the text
- * against them. `disposition:refunded,settled` and `-disposition:refunded` fire
+ * against them, and a paste is read the same way as soon as it lands.
+ * `disposition:refunded,settled` and `-disposition:refunded` fire
  * `helix-facet` exactly as ticking those values in the picker would, and the
  * parsed text is removed. Everything else stays, so `refund tuesday
  * disposition:settled` is a filter and a search at once. Helix defines the
@@ -64,6 +65,12 @@ declare const HelixHeadlessFilterInput_base: (new (...args: any[]) => import("@f
  * nothing draws it and the menu has no page for it, and the grammar still reads
  * it.
  *
+ * **The picker has an entry of its own.** `FilterMenu` draws its pages with
+ * `Menu`, which a field without a picker does not need, so this family's entry
+ * leaves it out. A page that writes one imports
+ * `@fusion.dev/helix/filter-input/menu` as well, and a picker written without it
+ * is reported once the page has loaded, with the entry to add.
+ *
  * **Suggestions.** Slot options into `suggestions` and the field shows them,
  * moves through them with the arrow keys, and presses one on Enter. The option
  * fires its own `helix-select`, and you decide what choosing it means. Keys
@@ -408,6 +415,14 @@ export declare class HelixHeadlessFilterInput extends HelixHeadlessFilterInput_b
      *
      * Everything else in the row is untouched: a plain `Tag`, or a chip for
      * something no `FilterField` declares, is the consumer's to answer.
+     *
+     * **Heard on the way down, in the capture phase**, because the chip is a
+     * child of this element and its request passes here before it reaches the
+     * chip's listeners or comes back up. Stopped there, no listener on the chip,
+     * on this element or above it hears it. Heard on the way up, `stopPropagation`
+     * kept it from the ancestors and not from this element's other listeners, so a
+     * consumer listening on the field heard `helix-dismiss` as well as the
+     * `helix-facet` that answered it.
      */
     private readonly handleDismiss;
     /**
@@ -512,6 +527,15 @@ export declare class HelixHeadlessFilterInput extends HelixHeadlessFilterInput_b
     disconnectedCallback(): void;
     protected willUpdate(changed: PropertyValues): void;
     protected firstUpdated(changed: PropertyValues): void;
+    /**
+     * Says so when a picker is written in the field and never registered.
+     *
+     * The picker has an entry of its own, so a page that imports only the field
+     * gets an inert element there: a trigger that opens nothing. Asked once the
+     * page has loaded and painted, so an entry a later module imports is not
+     * taken for a missing one.
+     */
+    private auditPicker;
     protected updated(changed: PropertyValues): void;
     /**
      * Marks the highlighted suggestion, and tells the control which one it is.

package/dist/filter-input/root/filter-input-root.js

@@ -4,14 +4,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { AriaForwardController, countLabel, customElement, drawIcon, drawStatus, formatWords, HelixFacetEvent, HelixFormElement, holdCaret, MixinControllerOpen, MixinControllerValue, MixinField, MixinTokens, PopoverController, restoreValue, StatusController, scrollItemIntoView, words, wordsLocale, } from '@fusion.dev/helix-core';
+import { AriaForwardController, countLabel, customElement, drawIcon, drawStatus, formatWords, HelixFacetEvent, HelixFormElement, holdCaret, MixinControllerOpen, MixinControllerValue, MixinField, MixinTokens, PopoverController, reportRuntime, restoreValue, StatusController, scrollItemIntoView, words, wordsLocale, } from '@fusion.dev/helix-core';
 import { x } from '@fusion.dev/helix-icons';
 import { html, nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
 import { HelixHeadlessFilterField } from '../field/filter-field.js';
 import { readFilterText } from '../grammar.js';
-import { HelixHeadlessFilterMenu } from '../menu/filter-menu.js';
 import { currentTerm, suggests, tokenEntry } from '../suggest.js';
+const picks = (element) => typeof element.apply === 'function' &&
+    Array.isArray(element.fields);
 const asksToGo = (node) => typeof node?.dismiss === 'function';
 const isOption = (node) => 'active' in node && 'value' in node;
 let HelixHeadlessFilterInput = class HelixHeadlessFilterInput extends MixinControllerOpen(MixinTokens(MixinControllerValue(MixinField(HelixFormElement)))) {
@@ -58,6 +59,9 @@ let HelixHeadlessFilterInput = class HelixHeadlessFilterInput extends MixinContr
             restoreValue(control, this.value);
             this.dismissed = false;
             this.settleOpen();
+            if (event.inputType === 'insertFromPaste') {
+                this.readFilters();
+            }
         };
         this.handleChange = (event) => {
             event.stopPropagation();
@@ -111,6 +115,12 @@ let HelixHeadlessFilterInput = class HelixHeadlessFilterInput extends MixinContr
                 }
                 return;
             }
+            if (event.key === 'Escape' && !this.open && this.value !== '') {
+                event.preventDefault();
+                event.stopPropagation();
+                this.handleClear();
+                return;
+            }
             if (!this.suggesting) {
                 return;
             }
@@ -281,7 +291,7 @@ let HelixHeadlessFilterInput = class HelixHeadlessFilterInput extends MixinContr
     }
     menuFor(field) {
         for (const menu of this.querySelectorAll('*')) {
-            if (!(menu instanceof HelixHeadlessFilterMenu)) {
+            if (!picks(menu)) {
                 continue;
             }
             if (menu.fields.some((declared) => (declared.name ?? '') === field)) {
@@ -387,12 +397,12 @@ let HelixHeadlessFilterInput = class HelixHeadlessFilterInput extends MixinContr
     }
     connectedCallback() {
         super.connectedCallback();
-        this.addEventListener('helix-dismiss', this.handleDismiss);
+        this.addEventListener('helix-dismiss', this.handleDismiss, { capture: true });
         this.addEventListener(HelixFacetEvent.eventName, this.handleFacet);
     }
     disconnectedCallback() {
         super.disconnectedCallback();
-        this.removeEventListener('helix-dismiss', this.handleDismiss);
+        this.removeEventListener('helix-dismiss', this.handleDismiss, { capture: true });
         this.removeEventListener(HelixFacetEvent.eventName, this.handleFacet);
     }
     willUpdate(changed) {
@@ -418,6 +428,30 @@ let HelixHeadlessFilterInput = class HelixHeadlessFilterInput extends MixinContr
         this.finishHydration();
         this.handleTokens();
         this.refreshSuggesting();
+        this.auditPicker();
+    }
+    auditPicker() {
+        const { tier } = this.constructor;
+        const tag = `${tier}filter-menu`;
+        const check = () => {
+            if (this.isConnected && this.querySelector(tag) && !customElements.get(tag)) {
+                const entry = tier === 'helix-' ? '@fusion.dev/helix' : '@fusion.dev/helix-headless';
+                reportRuntime({
+                    kind: 'unregistered-part',
+                    message: `<${tag}> in <${this.localName}> is not registered, so its trigger opens nothing. Import '${entry}/filter-input/menu'.`,
+                    tag: this.localName,
+                });
+            }
+        };
+        const frame = () => {
+            requestAnimationFrame(check);
+        };
+        if (document.readyState === 'complete') {
+            frame();
+        }
+        else {
+            window.addEventListener('load', frame, { once: true });
+        }
     }
     updated(changed) {
         super.updated(changed);

package/dist/icon/all/index.d.ts

@@ -0,0 +1 @@
+export * from '../index.js';

package/dist/icon/all/index.js

@@ -0,0 +1,4 @@
+import { icons } from '@fusion.dev/helix-icons';
+import { registerIcons } from '../registry.js';
+registerIcons(icons);
+export * from '../index.js';

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

@@ -18,8 +18,11 @@ import { nothing, type PropertyValues, type TemplateResult } from 'lit';
  * a dark background. Shapes that set their own `fill` or `stroke` are
  * unaffected.
  *
- * **A name is looked up in a registry.** The family's entry registers the
- * whole set, so any name in it draws. The element's own entry,
+ * **A name is looked up in a registry.** The family's entry registers a small
+ * set: the four carets, `arrow-left`, `arrow-right`, `check`, `x`, `plus`,
+ * `minus`, `magnifying-glass`, `info` and `warning`. `icon/all` registers the
+ * whole set, so any name in it draws, and a name that resolves to nothing
+ * says to import it. The element's own entry,
  * `@fusion.dev/helix-headless/icon/root`, registers none: a page that imports
  * it and calls `registerIcons` with the glyphs it names ships those and no
  * others. `registerIconLibrary` resolves names under a prefix of your own,
@@ -94,12 +97,10 @@ export declare class HelixHeadlessIcon extends HelixElement {
      * The name of the icon in the Helix set.
      *
      * **A lookup, and the reason both this and `icon` exist.** A name is a string,
-     * so it is what markup can carry, and resolving one means an index of the
-     * whole set that no bundler can shake: 15 kB for a consumer who renders one
-     * mark. An attribute is the only thing an HTML author can write, and that is
-     * worth the index; a consumer who would rather not pay it imports the
-     * element from `icon/root` and registers the glyphs it names, or hands over
-     * the value instead.
+     * so it is what markup can carry, and resolving one means an index that no
+     * bundler can shake. The family's entry indexes a small set, `icon/all`
+     * indexes the whole set at 15 kB, and `icon/root` indexes nothing, for a
+     * page that registers the glyphs it names or hands over the value instead.
      *
      * A name written `prefix:name` asks the library registered under that
      * prefix.

package/dist/icon/root/icon-root.js

@@ -131,8 +131,10 @@ let HelixHeadlessIcon = class HelixHeadlessIcon extends HelixElement {
             kind: 'unknown-icon',
             message: this.src === ''
                 ? `<${this.localName} name="${asked}"> names no registered icon, so it draws ` +
-                    'nothing. Check the name, register the glyph with `registerIcons`, or import it ' +
-                    'and pass it as `icon`.'
+                    `nothing. For a glyph of the Helix set, import '${this.localName.startsWith('helix-headless-')
+                        ? '@fusion.dev/helix-headless'
+                        : '@fusion.dev/helix'}/icon/all', which registers every one. Otherwise check the name, or register ` +
+                    'the glyph with `registerIcons`.'
                 : `<${this.localName} src="${asked}"> could not be fetched as an SVG file, so it ` +
                     'draws nothing. Check the URL, and that the file is an `<svg>`.',
             tag: this.localName,

package/dist/icon/set.js

@@ -1,3 +1,17 @@
-import { icons } from '@fusion.dev/helix-icons';
+import { arrowLeft, arrowRight, caretDown, caretLeft, caretRight, caretUp, check, info, magnifyingGlass, minus, plus, warning, x, } from '@fusion.dev/helix-icons';
 import { registerIcons } from './registry.js';
-registerIcons(icons);
+registerIcons([
+    arrowLeft,
+    arrowRight,
+    caretDown,
+    caretLeft,
+    caretRight,
+    caretUp,
+    check,
+    info,
+    magnifyingGlass,
+    minus,
+    plus,
+    warning,
+    x,
+]);

package/dist/index.d.ts

@@ -46,10 +46,11 @@ export * from './drilldown/index.js';
 export * from './empty/index.js';
 export * from './file-input/index.js';
 export * from './filter-input/index.js';
+export * from './filter-input/menu/index.js';
 export * from './format-date/index.js';
 export * from './graph/index.js';
 export * from './heatmap/index.js';
-export * from './icon/index.js';
+export * from './icon/all/index.js';
 export * from './icon-button/index.js';
 export * from './image/index.js';
 export * from './input/index.js';

package/dist/index.js

@@ -37,10 +37,11 @@ export * from './drilldown/index.js';
 export * from './empty/index.js';
 export * from './file-input/index.js';
 export * from './filter-input/index.js';
+export * from './filter-input/menu/index.js';
 export * from './format-date/index.js';
 export * from './graph/index.js';
 export * from './heatmap/index.js';
-export * from './icon/index.js';
+export * from './icon/all/index.js';
 export * from './icon-button/index.js';
 export * from './image/index.js';
 export * from './input/index.js';