@fusion.dev/helix 0.174.0 → 0.176.0

package/custom-elements.json

@@ -68480,7 +68480,7 @@
                 "text": "Date"
               },
               "privacy": "private",
-              "description": "The date the tab stop sits on, which is where the arrows move from.\n\nIt has to be a date the grid actually renders, so the month is compared\nwith its year. Comparing the month alone puts the stop on the same date a\nyear away, which is rendered nowhere, and the grid is left with no tab stop\nat all and no way into it from the keyboard.\n\nEach candidate is tested in turn rather than the first one winning\noutright. Where the last date focused is in some other month, the selected\ndate still holds the stop, then today, as the APG date picker and React\nAria's calendar put it, and only with none of them in view does it fall\nto the first of the month. Measured before today was a candidate: a\ncalendar with no value opened on October 5 with its stop on \"Thursday,\nOctober 1\".",
+              "description": "The date the tab stop sits on, which is where the arrows move from.\n\nIt has to be a date the grid actually renders, so the month is compared\nwith its year. Comparing the month alone puts the stop on the same date a\nyear away, which is rendered nowhere, and the grid is left with no tab stop\nat all and no way into it from the keyboard.\n\nEach candidate is tested in turn rather than the first one winning\noutright. Where the last date focused is in some other month, the selected\ndate still holds the stop, then today, as the APG date picker and React\nAria's calendar put it, and only with none of them in view does it fall\nto the first of the month. Measured before today was a candidate: a\ncalendar with no value opened on October 5 with its stop on \"Thursday,\nOctober 1\".\n\nToday counts only where it can be chosen, and the fallback is the first\nday of the month that can, so a reader tabbing in lands on a date they can\npick. Measured before: with `min=\"2026-03-03\"`, the stop sat on \"Sunday,\nMarch 1, 2026\", unavailable. A month with nothing to choose keeps its\nfirst day, so the grid still has a way in.",
               "readonly": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessDatePicker",
@@ -72929,7 +72929,7 @@
               "name": "handleSubmit",
               "privacy": "private",
               "readonly": true,
-              "description": "A `<form method=\"dialog\">` slotted into the dialog, closed the way the\nplatform closes its own.\n\n**The platform cannot find this dialog from the form.** A submit with the\n`dialog` method closes the nearest `<dialog>` ancestor, and a slotted form's\nancestors are the light DOM, where there is none. So the submit is read\nhere, and the submitter's `value` is the `returnValue`, as it would be.",
+              "description": "A `<form method=\"dialog\">` slotted into the dialog closes it.",
               "inheritedFrom": {
                 "name": "HelixHeadlessDialog",
                 "module": "src/dialog/root/dialog-root.ts"
@@ -76947,6 +76947,17 @@
                 "module": "src/drawer/root/drawer-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "handleSubmit",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A `<form method=\"dialog\">` slotted into the drawer closes it, as in `Dialog`.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessDrawer",
+                "module": "src/drawer/root/drawer-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "renderDismissIcon",
@@ -84916,14 +84927,6 @@
             "module": "src/filter-input/field/filter-field.js"
           }
         },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "module": "src/filter-input/menu/filter-menu.js"
-          }
-        },
         {
           "kind": "js",
           "name": "*",
@@ -84968,7 +84971,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Draws nothing of its own. The trigger is yours, and the pages are `Menu`'s,\nwhose reserved tick column keeps ticked and unticked values aligned. The\nelement's stylesheet has one rule: `display: contents`.\n\nThe headless element documents the model, including why a tick applies a\nfilter immediately and why the menu decides the operator.",
+          "description": "Draws nothing of its own. The trigger is yours, and the pages are `Menu`'s,\nwhose reserved tick column keeps ticked and unticked values aligned. The\nelement's stylesheet has one rule: `display: contents`.\n\nThe headless element documents the model, including why a tick applies a\nfilter immediately and why the menu decides the operator.\n\nImported from its own entry, `@fusion.dev/helix/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": "HelixFilterMenu",
           "members": [
             {
@@ -85528,7 +85531,7 @@
           ],
           "superclass": {
             "name": "HelixHeadlessFilterMenu",
-            "package": "@fusion.dev/helix-headless/filter-input"
+            "package": "@fusion.dev/helix-headless/filter-input/menu"
           },
           "summary": "A menu for building a filter by picking a field and checking its values.",
           "helix": {
@@ -85798,6 +85801,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.css.ts",
@@ -87921,7 +87939,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "HelixHeadlessFilterMenu | null"
+                  "text": "FieldPicker | null"
                 }
               },
               "parameters": [
@@ -88000,7 +88018,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.",
               "inheritedFrom": {
                 "name": "HelixHeadlessFilterInput",
                 "module": "src/filter-input/root/filter-input-root.ts"
@@ -88164,6 +88182,21 @@
                 "module": "src/filter-input/root/filter-input-root.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.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessFilterInput",
+                "module": "src/filter-input/root/filter-input-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "markActive",
@@ -100137,6 +100170,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/index.ts",
@@ -100218,7 +100266,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Draws in `currentColor` and sizes from `--icon-size`, so an icon takes the\ncolor of the text around it and a container can resize it without a property.\nInside a button, `--icon-size` is set in `em`, so the icon scales with the\nbutton.\n\n**The glyph turns, flips and moves inside its own box**, so the line around\nit keeps its place: `rotate` turns it by a quarter, a half or three\nquarters, `--icon-rotate` by any angle, `flip` mirrors it across either\naxis, and `animation` spins, pulses or beats it, as Web Awesome's icon does.\nReduced motion stills every animation. `auto-width` gives the box the\nglyph's own proportions, for a mark wider than it is tall.",
+          "description": "Draws in `currentColor` and sizes from `--icon-size`, so an icon takes the\ncolor of the text around it and a container can resize it without a property.\nInside a button, `--icon-size` is set in `em`, so the icon scales with the\nbutton.\n\n**The glyph turns, flips and moves inside its own box**, so the line around\nit keeps its place: `rotate` turns it by a quarter, a half or three\nquarters, `--icon-rotate` by any angle, `flip` mirrors it across either\naxis, and `animation` spins, pulses or beats it, as Web Awesome's icon does.\nReduced motion stills every animation. `auto-width` gives the box the\nglyph's own proportions, for a mark wider than it is tall.\n\n**`@fusion.dev/helix/icon` registers thirteen glyphs by name**, the ones a\ncontrol most often needs, and `@fusion.dev/helix/icon/all` registers the\nwhole set. The headless element lists the thirteen and says how a name is\nresolved.",
           "name": "HelixIcon",
           "cssProperties": [
             {
@@ -100333,7 +100381,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",
               "inheritedFrom": {
                 "name": "HelixHeadlessIcon",
@@ -100967,7 +101015,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",
               "inheritedFrom": {
                 "name": "HelixHeadlessIcon",
@@ -102564,6 +102612,14 @@
             "module": "src/filter-input/index.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/filter-input/menu/index.js"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -102609,7 +102665,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "module": "src/icon/index.js"
+            "module": "src/icon/all/index.js"
           }
         },
         {
@@ -107775,7 +107831,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The item's identifier. The root compares its `active` value against it.",
+              "description": "The item's identifier. The root compares its `active` value against it.\nWithout one, the item is named by its place in the set, counted from 1.",
               "attribute": "value",
               "inheritedFrom": {
                 "name": "HelixHeadlessLightboxItem",
@@ -108228,7 +108284,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The item's identifier. The root compares its `active` value against it.",
+              "description": "The item's identifier. The root compares its `active` value against it.\nWithout one, the item is named by its place in the set, counted from 1.",
               "fieldName": "value",
               "inheritedFrom": {
                 "name": "HelixHeadlessLightboxItem",
@@ -109022,6 +109078,20 @@
                 "module": "src/lightbox/root/lightbox-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "zoomStep",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the zoom is changing by one discrete step, a key or a control, which is said at once.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "sayZoom",
@@ -109031,7 +109101,7 @@
                   "text": "void"
                 }
               },
-              "description": "Says the new scale in the live region, a moment after the last change.",
+              "description": "Says the new scale in the live region: a moment after the last change of\na pinch, a drag or the wheel, and at once for a key or a zoom control,\nwhich is one change a reader is waiting to hear. Said only after the\npause, a reader pressing `+` heard nothing until it ended.",
               "inheritedFrom": {
                 "name": "HelixHeadlessLightbox",
                 "module": "src/lightbox/root/lightbox-root.ts"
@@ -109380,6 +109450,29 @@
                 "module": "src/lightbox/root/lightbox-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "stepZoom",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "change",
+                  "type": {
+                    "text": "() => void"
+                  }
+                }
+              ],
+              "description": "Changes the zoom by one discrete step, which `sayZoom` says at once.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "toEnd",
@@ -109420,6 +109513,9 @@
             {
               "kind": "field",
               "name": "shown",
+              "type": {
+                "text": "HelixHeadlessLightboxItem | undefined"
+              },
               "privacy": "private",
               "description": "The item on screen: the one `active` names, or the first where it names none.",
               "readonly": true,
@@ -109428,6 +109524,29 @@
                 "module": "src/lightbox/root/lightbox-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "named",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HelixHeadlessLightboxItem | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "items",
+                  "type": {
+                    "text": "HelixHeadlessLightboxItem[]"
+                  }
+                }
+              ],
+              "description": "The item `active` names, by `value` or by place, or the first where it names none.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleBackdrop",
@@ -249276,6 +249395,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix",
-    "version": "0.174.0"
+    "version": "0.176.0"
   }
 }

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

@@ -1,5 +1,4 @@
 export * from './chip/filter-chip.js';
 export * from './field/filter-field.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,5 +1,4 @@
 export * from './chip/filter-chip.js';
 export * from './field/filter-field.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

@@ -1,4 +1,4 @@
-import { HelixHeadlessFilterMenu } from '@fusion.dev/helix-headless/filter-input';
+import { HelixHeadlessFilterMenu } from '@fusion.dev/helix-headless/filter-input/menu';
 import type { CSSResultGroup } from 'lit';
 import '../../divider/index.js';
 import '../../menu/index.js';
@@ -13,6 +13,10 @@ import '../../menu/index.js';
  * The headless element documents the model, including why a tick applies a
  * filter immediately and why the menu decides the operator.
  *
+ * Imported from its own entry, `@fusion.dev/helix/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/filter-menu.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { customElement } from '@fusion.dev/helix-core';
-import { HelixHeadlessFilterMenu } from '@fusion.dev/helix-headless/filter-input';
+import { HelixHeadlessFilterMenu } from '@fusion.dev/helix-headless/filter-input/menu';
 import { styles } from './filter-menu.css.js';
 import '../../divider/index.js';
 import '../../menu/index.js';

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/icon/all/index.d.ts

@@ -0,0 +1,2 @@
+import '@fusion.dev/helix-headless/icon/all';
+export * from '../index.js';

package/dist/icon/all/index.js

@@ -0,0 +1,2 @@
+import '@fusion.dev/helix-headless/icon/all';
+export * from '../index.js';

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

@@ -16,6 +16,11 @@ import type { CSSResultGroup } from 'lit';
  * Reduced motion stills every animation. `auto-width` gives the box the
  * glyph's own proportions, for a mark wider than it is tall.
  *
+ * **`@fusion.dev/helix/icon` registers thirteen glyphs by name**, the ones a
+ * control most often needs, and `@fusion.dev/helix/icon/all` registers the
+ * whole set. The headless element lists the thirteen and says how a name is
+ * resolved.
+ *
  * @since 0.1.0
  * @status stable
  * @category media

package/dist/index.d.ts

@@ -43,12 +43,13 @@ 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 './flex/index.js';
 export * from './format-date/index.js';
 export * from './graph/index.js';
 export * from './grid/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

@@ -38,12 +38,13 @@ 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 './flex/index.js';
 export * from './format-date/index.js';
 export * from './graph/index.js';
 export * from './grid/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';