@fusion.dev/helix-headless 0.180.0 → 0.180.1

package/custom-elements.json

@@ -29727,6 +29727,19 @@
               },
               "description": "Asks the slot, and records the answer as a state.\n\nCalled on `slotchange` and after every update, and the second is not\nbelt-and-braces: **`slotchange` does not fire when nothing is assigned.**\nWithout it a checkbox labeled only by its property, which is most of them,\nnever hears about its own label and renders without one.\n\n**`:state(has-label)` and not `data-has-label`.** The answer comes from\n`assignedNodes` and a server has no tree to ask, so an attribute would\nappear on every labeled checkbox the instant it upgraded and on none that\nany server sent. See `HelixElement.toggleState`."
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Ticks or clears the box, as `click()` does a native checkbox: passed to the control\ninside, so the one click a listener hears is the control's, after it has\nmoved. See `HostClickController`.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "checked",
@@ -137270,6 +137283,19 @@
               },
               "description": "Whether the radio holds the group's tab stop. Unset, the chosen radio\nholds it.\n\nThe stop rides on the selection, and an unanswered group has no selection,\nso without this every choice is `tabindex=\"-1\"` and the keyboard cannot\nenter the set at all. The group writes `true` for the chosen radio, or for\nthe first that can be chosen while nothing is, and `false` for every radio,\nthe chosen one too, while a toolbar the group sits in holds the stop.\n\n**Written by the group, with no attribute, and it reaches the control\nrather than the host.** A `tabindex` on the host is two faults at once: it\nis markup a consumer rendered and their server never sent, which React\nreports as a mismatch and does not patch up, and it puts the tab stop on\nthe element rather than on the `<button role=\"radio\">` inside it, so a\nscreen reader meets an unnamed box where a native group would have given\nthem an unchecked radio. `Toggle.Root` carries the same property for the\nsame reason."
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Chooses the radio, as `click()` does a native radio: passed to the control\ninside, so the one click a listener hears is the control's, after it has\nmoved. See `HostClickController`.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -157082,6 +157108,19 @@
               },
               "description": "The thumb, drawn inside the track after the input: nothing on this tier.\n\nA seam for a tier that draws the thumb as an element, so it can be a part\nand hold icons. An element here would be an empty child on every page that\nloads only this tier, which is the cost the `track` part notes."
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Turns the switch on or off, as `click()` does a native checkbox: passed to the control\ninside, so the one click a listener hears is the control's, after it has\nmoved. See `HostClickController`.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "checked",
@@ -182922,6 +182961,19 @@
                 "text": "select() => boolean"
               }
             },
+            {
+              "kind": "method",
+              "name": "click",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Presses the toggle, as `click()` does a native button: passed to the control\ninside, so the one click a listener hears is the control's, after it has\nmoved. See `HostClickController`.",
+              "type": {
+                "text": "click() => void"
+              }
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -199834,6 +199886,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-headless",
-    "version": "0.180.0"
+    "version": "0.180.1"
   }
 }

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

@@ -152,6 +152,12 @@ export declare class HelixHeadlessCheckbox extends HelixHeadlessCheckbox_base {
      * any server sent. See `HelixElement.toggleState`.
      */
     private syncLabelPresence;
+    /**
+     * Ticks or clears the box, as `click()` does a native checkbox: passed to the control
+     * inside, so the one click a listener hears is the control's, after it has
+     * moved. See `HostClickController`.
+     */
+    click(): void;
     protected render(): TemplateResult;
 }
 declare global {

package/dist/checkbox/root/checkbox-root.js

@@ -83,6 +83,11 @@ let HelixHeadlessCheckbox = class HelixHeadlessCheckbox extends MixinControllerC
         this.toggleState('has-label', filled && !hidden);
         this.partNamed('label')?.toggleAttribute('hidden', !filled);
     }
+    click() {
+        if (!this.clicks.click()) {
+            super.click();
+        }
+    }
     render() {
         const named = this.label === '' ? this.getAttribute('aria-label') : null;
         return html `<label part="field">

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

@@ -106,6 +106,12 @@ export declare class HelixHeadlessRadio extends HelixHeadlessRadio_base {
      * re-renders nothing.
      */
     protected firstUpdated(changed: PropertyValues): void;
+    /**
+     * Chooses the radio, as `click()` does a native radio: passed to the control
+     * inside, so the one click a listener hears is the control's, after it has
+     * moved. See `HostClickController`.
+     */
+    click(): void;
     protected render(): TemplateResult;
 }
 declare global {

package/dist/radio/root/radio-root.js

@@ -22,6 +22,11 @@ let HelixHeadlessRadio = class HelixHeadlessRadio extends MixinSelectableItem(He
         super.firstUpdated(changed);
         this.finishHydration();
     }
+    click() {
+        if (!this.clicks.click()) {
+            super.click();
+        }
+    }
     render() {
         return html `<button
       part="item"

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

@@ -101,6 +101,12 @@ export declare class HelixHeadlessSwitch extends HelixHeadlessSwitch_base {
      * loads only this tier, which is the cost the `track` part notes.
      */
     protected renderThumb(): TemplateResult | typeof nothing;
+    /**
+     * Turns the switch on or off, as `click()` does a native checkbox: passed to the control
+     * inside, so the one click a listener hears is the control's, after it has
+     * moved. See `HostClickController`.
+     */
+    click(): void;
     protected render(): TemplateResult;
 }
 declare global {

package/dist/switch/root/switch-root.js

@@ -48,6 +48,11 @@ let HelixHeadlessSwitch = class HelixHeadlessSwitch extends MixinControllerCheck
     renderThumb() {
         return nothing;
     }
+    click() {
+        if (!this.clicks.click()) {
+            super.click();
+        }
+    }
     render() {
         return html `<label part="field">
       <span part="track">

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

@@ -110,6 +110,12 @@ export declare class HelixHeadlessToggle extends HelixHeadlessToggle_base {
      * re-renders nothing.
      */
     protected firstUpdated(changed: PropertyValues): void;
+    /**
+     * Presses the toggle, as `click()` does a native button: passed to the control
+     * inside, so the one click a listener hears is the control's, after it has
+     * moved. See `HostClickController`.
+     */
+    click(): void;
     protected render(): TemplateResult;
 }
 declare global {

package/dist/toggle/root/toggle-root.js

@@ -41,6 +41,11 @@ let HelixHeadlessToggle = class HelixHeadlessToggle extends MixinSelectableItem(
         this.finishHydration();
         auditName(this, () => this.partNamed('item'), 'Give it words in its default slot, an `aria-label`, or a label on the icon it holds.');
     }
+    click() {
+        if (!this.clicks.click()) {
+            super.click();
+        }
+    }
     render() {
         const alone = this.alone;
         const radio = !alone && this.pressed === undefined;