@fusion.dev/helix-core 0.111.0 → 0.111.1

package/custom-elements.json

@@ -1358,6 +1358,54 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/host-click-controller/host-click-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Passes a click on the host itself to the control inside that answers clicks.\n\n**A click dispatched on the host reaches nothing that toggles.** A switch,\na checkbox or a radio renders its control in its shadow root, and only a\nclick that lands there moves it. `element.click()`, a test's or an\nautomation's, is dispatched on the host, and so is the click a `<label for>`\non the page sends the element it names: `helix-switch` left `checked` false\nunder `click()` while a pointer press on it turned it on. A native checkbox\ntoggles on both, and code written against one expects it.\n\n**Only a click that starts at the host**, whose path begins there. A press\ninside the shadow root reaches the host too, retargeted, and has already\ndone its work where it landed; the click this sends to the control reaches\nthe host the same way, and goes no further.",
+          "name": "HostClickController",
+          "members": [
+            {
+              "kind": "method",
+              "name": "hostConnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "forward",
+              "privacy": "private",
+              "readonly": true
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HostClickController",
+          "declaration": {
+            "name": "HostClickController",
+            "module": "src/controllers/host-click-controller/host-click-controller.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/controllers/idle-controller/idle-controller.ts",
@@ -6046,6 +6094,14 @@
             "module": "./controllers/fullscreen-controller/fullscreen-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HostClickController",
+          "declaration": {
+            "name": "HostClickController",
+            "module": "./controllers/host-click-controller/host-click-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "IdleController",

package/dist/controllers/host-click-controller/host-click-controller.d.ts

@@ -0,0 +1,25 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/**
+ * Passes a click on the host itself to the control inside that answers clicks.
+ *
+ * **A click dispatched on the host reaches nothing that toggles.** A switch,
+ * a checkbox or a radio renders its control in its shadow root, and only a
+ * click that lands there moves it. `element.click()`, a test's or an
+ * automation's, is dispatched on the host, and so is the click a `<label for>`
+ * on the page sends the element it names: `helix-switch` left `checked` false
+ * under `click()` while a pointer press on it turned it on. A native checkbox
+ * toggles on both, and code written against one expects it.
+ *
+ * **Only a click that starts at the host**, whose path begins there. A press
+ * inside the shadow root reaches the host too, retargeted, and has already
+ * done its work where it landed; the click this sends to the control reaches
+ * the host the same way, and goes no further.
+ */
+export declare class HostClickController implements ReactiveController {
+    private readonly host;
+    private readonly target;
+    constructor(host: ReactiveControllerHost & HTMLElement, target: () => HTMLElement | null | undefined);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private readonly forward;
+}

package/dist/controllers/host-click-controller/host-click-controller.js

@@ -0,0 +1,19 @@
+export class HostClickController {
+    constructor(host, target) {
+        this.host = host;
+        this.target = target;
+        this.forward = (event) => {
+            if (event.composedPath()[0] !== this.host) {
+                return;
+            }
+            this.target()?.click();
+        };
+        host.addController(this);
+    }
+    hostConnected() {
+        this.host.addEventListener('click', this.forward);
+    }
+    hostDisconnected() {
+        this.host.removeEventListener('click', this.forward);
+    }
+}

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { DismissController, type DismissOptions, } from './controllers/dismiss-c
 export { DrilldownController, type DrilldownOptions, } from './controllers/drilldown-controller/drilldown-controller.js';
 export { FloatingController, type FloatingOptions, type Placement, type Side, } from './controllers/floating-controller/floating-controller.js';
 export { FullscreenController } from './controllers/fullscreen-controller/fullscreen-controller.js';
+export { HostClickController } from './controllers/host-click-controller/host-click-controller.js';
 export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, type IndicatorOptions, } from './controllers/indicator-controller/indicator-controller.js';
 export { KeyboardNavigationController, type KeyboardNavigationOptions, type NavigableItem, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';

package/dist/index.js

@@ -9,6 +9,7 @@ export { DismissController, } from './controllers/dismiss-controller/dismiss-con
 export { DrilldownController, } from './controllers/drilldown-controller/drilldown-controller.js';
 export { FloatingController, } from './controllers/floating-controller/floating-controller.js';
 export { FullscreenController } from './controllers/fullscreen-controller/fullscreen-controller.js';
+export { HostClickController } from './controllers/host-click-controller/host-click-controller.js';
 export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, } from './controllers/indicator-controller/indicator-controller.js';
 export { KeyboardNavigationController, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.111.0",
+  "version": "0.111.1",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -34,11 +34,11 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.111.0"
+    "@fusion.dev/helix-icons": "0.111.1"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.111.0",
-    "@fusion.dev/helix-testing": "0.111.0",
+    "@fusion.dev/helix-cem": "0.111.1",
+    "@fusion.dev/helix-testing": "0.111.1",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },