@fusion.dev/helix-core 0.103.3 → 0.104.0

package/dist/utils/key-claimed/key-claimed.js

@@ -0,0 +1,14 @@
+const CARETLESS = new Set(['button', 'checkbox', 'color', 'file', 'image', 'reset', 'submit']);
+export const keyClaimed = (event) => {
+    if (event.defaultPrevented) {
+        return true;
+    }
+    const inner = event.composedPath()[0];
+    if (!(inner instanceof HTMLElement)) {
+        return false;
+    }
+    if (inner.isContentEditable || inner.localName === 'textarea' || inner.localName === 'select') {
+        return true;
+    }
+    return inner.localName === 'input' && !CARETLESS.has(inner.type);
+};

package/dist/utils/report-values/report-values.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Reports a control's answer to its form: one entry for each value, the way a
+ * native `<select multiple>` and a row of checkboxes send theirs.
+ *
+ * **Several answers are several entries, not one joined string.** A server
+ * reading `tags=a,b` has to know to split it on a convention this library
+ * chose, and one reading `tags=a&tags=b` reads it the way it reads every
+ * other multi-valued control on the platform. Listbox, Select and Combobox
+ * sent the first and Date Picker the second, so what a server received for the
+ * same answer depended on which control asked for it.
+ *
+ * **The joined string is the state**, which is what the browser hands back to
+ * `formStateRestoreCallback` and what `value` holds, so a restored control
+ * reads the shape it wrote.
+ *
+ * **Nothing without a `name`.** A plain string is skipped by the form when its
+ * control has no name, but `FormData` carries its own names and its entries
+ * are appended whatever the element is called, so an unnamed control would
+ * submit empty-named values.
+ */
+export declare const reportValues: (internals: ElementInternals, name: string, values: readonly string[]) => void;

package/dist/utils/report-values/report-values.js

@@ -0,0 +1,11 @@
+export const reportValues = (internals, name, values) => {
+    if (name === '' || values.length === 0) {
+        internals.setFormValue(null);
+        return;
+    }
+    const data = new FormData();
+    for (const value of values) {
+        data.append(name, value);
+    }
+    internals.setFormValue(data, values.join(','));
+};

package/dist/utils/slotted-words/slotted-words.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The words a host's children say in the named slots, `''` being the default
+ * one, in the order they are written.
+ *
+ * For a component that says what the page put in it, which is the page's own
+ * text and not anything this library wrote: an empty state's heading and
+ * message, a banner's message. Text nodes count toward the default slot, as
+ * they are assigned to it. Nothing on a server, whose element has no children
+ * to read.
+ */
+export declare const slottedWords: (host: Element, slots: readonly string[]) => string;

package/dist/utils/slotted-words/slotted-words.js

@@ -0,0 +1,5 @@
+export const slottedWords = (host, slots) => [...(host.childNodes ?? [])]
+    .filter((node) => (node instanceof Element ? slots.includes(node.slot) : slots.includes('')))
+    .map((node) => node.textContent?.replace(/\s+/g, ' ').trim() ?? '')
+    .filter(Boolean)
+    .join(' ');

package/dist/utils/tell-disclosure/tell-disclosure.d.ts

@@ -43,6 +43,8 @@
  * `<button slot="trigger">` has no shadow root to keep the state out of the
  * markup and no property to take it, and a consumer cannot mirror it themselves
  * because the open state belongs to the component. Saying so once is the same
- * answer `Tooltip` gives about the link it will not write for them.
+ * answer `Tooltip` gives about the link it will not write for them, and not at
+ * all to a trigger that already carries `aria-expanded`, which is a consumer
+ * mirroring the state from the component's `toggle` event.
  */
 export declare const tellDisclosure: (trigger: Element | null | undefined, open: boolean) => void;

package/dist/utils/tell-disclosure/tell-disclosure.js

@@ -8,7 +8,7 @@ export const tellDisclosure = (trigger, open) => {
         trigger.expanded = open;
         return;
     }
-    if (warned.has(trigger)) {
+    if (warned.has(trigger) || trigger.hasAttribute('aria-expanded')) {
         return;
     }
     warned.add(trigger);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.103.3",
+  "version": "0.104.0",
   "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.103.3"
+    "@fusion.dev/helix-icons": "0.104.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.103.3",
-    "@fusion.dev/helix-testing": "0.103.3",
+    "@fusion.dev/helix-cem": "0.104.0",
+    "@fusion.dev/helix-testing": "0.104.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },