@fusion.dev/helix-headless 0.13.0 → 0.13.2

package/custom-elements.json

@@ -15231,6 +15231,14 @@
               "name": "helix-create",
               "reactProp": "onhelix-create"
             },
+            {
+              "type": {
+                "text": "HelixFilterEvent"
+              },
+              "description": "Fired as the reader types, carrying the text the list is being narrowed to. Cancelable: refusing it leaves the list whole, and is how a consumer takes the filtering for themselves.",
+              "name": "helix-filter",
+              "reactProp": "onhelix-filter"
+            },
             {
               "name": "input",
               "type": {

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

@@ -49,6 +49,7 @@ declare const HelixHeadlessCombobox_base: (new (...args: any[]) => import("@fusi
  * @event {HelixBeforeCloseEvent} helix-before-close - Fired before it closes. Cancelable: refusing it takes the decision and nothing moves.
  * @event {HelixBeforeOpenEvent} helix-before-open - Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves.
  * @event {HelixCreateEvent} helix-create - Fired when the reader asks for something the list does not hold, and cancelable.
+ * @event {HelixFilterEvent} helix-filter - Fired as the reader types, carrying the text the list is being narrowed to. Cancelable: refusing it leaves the list whole, and is how a consumer takes the filtering for themselves.
  * @event {Event} input - Announced once the value has moved.
  * @event {Event} toggle - Says the state moved, carrying `newState` and `oldState`.
  *

package/dist/combobox/root/combobox-root.js

@@ -4,7 +4,7 @@ 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, customElement, HelixCreateEvent, HelixFormElement, MixinControllerOpen, MixinControllerValue, MixinField, MixinTokens, PopoverController, } from '@fusion.dev/helix-core';
+import { AriaForwardController, customElement, HelixCreateEvent, HelixFilterEvent, HelixFormElement, MixinControllerOpen, MixinControllerValue, MixinField, MixinTokens, PopoverController, } from '@fusion.dev/helix-core';
 import { caretDown } from '@fusion.dev/helix-icons';
 import { nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
@@ -47,7 +47,10 @@ let HelixHeadlessCombobox = class HelixHeadlessCombobox extends MixinControllerO
             event.stopPropagation();
             const typed = event.target.value;
             this.typed = typed;
-            this.listbox?.requestFilter(typed);
+            const narrowing = new HelixFilterEvent({ value: typed });
+            if (this.dispatchEvent(narrowing)) {
+                this.listbox?.requestFilter(typed);
+            }
             this.suggestion = this.suggest && isInsertion(event) ? this.completionFor(typed) : '';
             if (!this.open) {
                 this.requestOpen(true);
@@ -251,6 +254,7 @@ let HelixHeadlessCombobox = class HelixHeadlessCombobox extends MixinControllerO
       .value=${this.value}
       @helix-before-change=${this.handleChange}
       @change=${this.stopInner}
+      @helix-filter=${this.stopInner}
       @input=${this.stopInner}
     >
       <!-- The field's words are read off the options, and on the first

package/dist/element-events.generated.js

@@ -32,6 +32,7 @@ registerElementEvents({
         'helix-before-close',
         'helix-before-open',
         'helix-create',
+        'helix-filter',
         'input',
         'toggle',
     ],

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-headless",
   "description": "Headless component tier. Structure, accessibility, state, and form participation. No styling.",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -45,14 +45,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.13.0",
-    "@fusion.dev/helix-icons": "0.13.0",
+    "@fusion.dev/helix-core": "0.13.2",
+    "@fusion.dev/helix-icons": "0.13.2",
     "uqr": "^0.1.3"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.13.0",
-    "@fusion.dev/helix-testing": "0.13.0",
+    "@fusion.dev/helix-cem": "0.13.2",
+    "@fusion.dev/helix-testing": "0.13.2",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^3.3.0",

package/types/jsx.d.ts

@@ -2986,6 +2986,9 @@ export type HelixHeadlessComboboxHelixBeforeOpenElementEvent =
 /** `helix-create` event type */
 export type HelixHeadlessComboboxHelixCreateElementEvent =
   HelixHeadlessComboboxElementEvent<HelixCreateEvent>;
+/** `helix-filter` event type */
+export type HelixHeadlessComboboxHelixFilterElementEvent =
+  HelixHeadlessComboboxElementEvent<HelixFilterEvent>;
 
 export type HelixHeadlessComboboxProps = {
   /** What the browser may autofill in the text field, as a platform token.
@@ -3135,6 +3138,8 @@ differently: they are one chooser to a consumer. */
   ) => void) | undefined;
   /** Fired when the reader asks for something the list does not hold, and cancelable. */
   "onhelix-create"?: ((e: HelixHeadlessComboboxHelixCreateElementEvent) => void) | undefined;
+  /** Fired as the reader types, carrying the text the list is being narrowed to. Cancelable: refusing it leaves the list whole, and is how a consumer takes the filtering for themselves. */
+  "onhelix-filter"?: ((e: HelixHeadlessComboboxHelixFilterElementEvent) => void) | undefined;
   /** Announced once the value has moved. */
   oninput?: ((e: HelixHeadlessComboboxElementEvent) => void) | undefined;
   /** Says the state moved, carrying `newState` and `oldState`. */
@@ -3288,6 +3293,8 @@ differently: they are one chooser to a consumer. */
   ) => void) | undefined;
   /** Fired when the reader asks for something the list does not hold, and cancelable. */
   "on:helix-create"?: ((e: HelixHeadlessComboboxHelixCreateElementEvent) => void) | undefined;
+  /** Fired as the reader types, carrying the text the list is being narrowed to. Cancelable: refusing it leaves the list whole, and is how a consumer takes the filtering for themselves. */
+  "on:helix-filter"?: ((e: HelixHeadlessComboboxHelixFilterElementEvent) => void) | undefined;
   /** Announced once the value has moved. */
   "on:input"?: ((e: HelixHeadlessComboboxElementEvent) => void) | undefined;
   /** Says the state moved, carrying `newState` and `oldState`. */
@@ -18440,6 +18447,7 @@ export type CustomElements = {
    * - `helix-before-close`: Fired before it closes. Cancelable: refusing it takes the decision and nothing moves.
    * - `helix-before-open`: Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves.
    * - `helix-create`: Fired when the reader asks for something the list does not hold, and cancelable.
+   * - `helix-filter`: Fired as the reader types, carrying the text the list is being narrowed to. Cancelable: refusing it leaves the list whole, and is how a consumer takes the filtering for themselves.
    * - `input`: Announced once the value has moved.
    * - `toggle`: Says the state moved, carrying `newState` and `oldState`.
    *
@@ -32839,6 +32847,7 @@ export type CustomElementsSolidJs = {
    * - `helix-before-close`: Fired before it closes. Cancelable: refusing it takes the decision and nothing moves.
    * - `helix-before-open`: Fired before the panel opens. Cancelable: refusing it takes the decision and nothing moves.
    * - `helix-create`: Fired when the reader asks for something the list does not hold, and cancelable.
+   * - `helix-filter`: Fired as the reader types, carrying the text the list is being narrowed to. Cancelable: refusing it leaves the list whole, and is how a consumer takes the filtering for themselves.
    * - `input`: Announced once the value has moved.
    * - `toggle`: Says the state moved, carrying `newState` and `oldState`.
    *

package/types/vue.d.ts

@@ -1541,6 +1541,9 @@ export type HelixHeadlessComboboxHelixBeforeOpenElementEvent =
 /** `helix-create` event type */
 export type HelixHeadlessComboboxHelixCreateElementEvent =
   HelixHeadlessComboboxElementEvent<HelixCreateEvent>;
+/** `helix-filter` event type */
+export type HelixHeadlessComboboxHelixFilterElementEvent =
+  HelixHeadlessComboboxElementEvent<HelixFilterEvent>;
 
 export type HelixHeadlessComboboxVueProps = {
   /** What the browser may autofill in the text field, as a platform token.
@@ -1686,6 +1689,8 @@ export type HelixHeadlessComboboxVueEvents = {
   "helix-before-open": HelixHeadlessComboboxHelixBeforeOpenElementEvent;
   /** Fired when the reader asks for something the list does not hold, and cancelable. */
   "helix-create": HelixHeadlessComboboxHelixCreateElementEvent;
+  /** Fired as the reader types, carrying the text the list is being narrowed to. Cancelable: refusing it leaves the list whole, and is how a consumer takes the filtering for themselves. */
+  "helix-filter": HelixHeadlessComboboxHelixFilterElementEvent;
   /** Announced once the value has moved. */
   input: HelixHeadlessComboboxElementEvent;
   /** Says the state moved, carrying `newState` and `oldState`. */