@fusion.dev/helix-core 0.157.0 → 0.159.0

package/custom-elements.json

@@ -14857,6 +14857,14 @@
             "module": "./utils/chord/key-names.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "chosenValues",
+          "declaration": {
+            "name": "chosenValues",
+            "module": "./utils/chosen-values/chosen-values.js"
+          }
+        },
         {
           "kind": "js",
           "name": "clamp",
@@ -19459,7 +19467,7 @@
                   "text": "HTMLElement | undefined"
                 }
               },
-              "description": "The tab stop after this element on the page, or the one before it at the\nend, for a lone element whose removal would drop focus to the body.\n\n**A lone Callout or Announcement had nowhere to hand focus**, so a\nkeyboard reader who dismissed one started again from the top of the\npage. React Aria's Toast hands focus on the same way. Read before the\nevent, in the order Tab reaches the stops, while this element's own are\nstill among them."
+              "description": "The tab stop after this element on the page, or the one before it at the\nend, for an element whose removal would drop focus to the body because\nno neighbor of its kind has a control to take it.\n\n**A lone Callout or Announcement had nowhere to hand focus**, so a\nkeyboard reader who dismissed one started again from the top of the\npage. React Aria's Toast hands focus on the same way. Read before the\nevent, in the order Tab reaches the stops, while this element's own are\nstill among them."
             },
             {
               "kind": "method",
@@ -23632,7 +23640,7 @@
             {
               "name": "control",
               "type": {
-                "text": "() => HTMLElement | null"
+                "text": "() => HTMLElement | null | undefined"
               }
             },
             {
@@ -23656,7 +23664,7 @@
               }
             }
           ],
-          "description": "Warns once, through the runtime channel, when a control has no accessible\nname: none on the host, and none on the control inside it.\n\n**Read a task after the control first renders**, so a label that arrives in\nthe same pass counts: slotted, written by a framework beside the control, or\nforwarded from a `<label for>`. One timer serves every control that asked in\nthat task, and an element is read once in its life, so a name taken away\nlater is not reported.\n\n**In a development build only.** Every field and Button calls it, so in\nproduction it would cost each of them about 450 bytes gzip for a sentence\nmeant for the person writing the page. Core imports it as `#audit-name`,\nwhich `package.json` resolves here under the `development` condition (Vite\nand webpack in development, `bun --conditions development`,\n`node --conditions=development`) and to `audit-name-off.ts`, which does\nnothing, everywhere else. Like every runtime warning it reports through the\none channel, and a project that wants the console quiet tells\n`@fusion.dev/helix-diagnostics` with `core.warnings: false`.\n\n`also` answers for a name the component gave through its internals, which no\nattribute shows. `fix` is the sentence that says how to name it. `shown` is\nthe part where the control shows its value or its placeholder, whose words\nare no name."
+          "description": "Warns once, through the runtime channel, when a control has no accessible\nname: none on the host, and none on the control inside it.\n\n**Read a task after the control first renders**, so a label that arrives in\nthe same pass counts: slotted, written by a framework beside the control, or\nforwarded from a `<label for>`. One timer serves every control that asked in\nthat task, and an element is read once in its life, so a name taken away\nlater is not reported.\n\n**In a development build only.** Every field and Button calls it, so in\nproduction it would cost each of them about 450 bytes gzip for a sentence\nmeant for the person writing the page. Core imports it as `#audit-name`,\nwhich `package.json` resolves here under the `development` condition (Vite\nand webpack in development, `bun --conditions development`,\n`node --conditions=development`) and to `audit-name-off.ts`, which does\nnothing, everywhere else. Like every runtime warning it reports through the\none channel, and a project that wants the console quiet tells\n`@fusion.dev/helix-diagnostics` with `core.warnings: false`.\n\n`control` returns the control inside the host, `null` where the host is the\ncontrol, or `undefined` where the control is not drawn at the moment of the\nread: the host is then read again the next time it asks.\n\n`also` answers for a name the component gave through its internals, which no\nattribute shows. `fix` is the sentence that says how to name it. `shown` is\nthe part where the control shows its value or its placeholder, whose words\nare no name."
         }
       ],
       "exports": [
@@ -24675,6 +24683,52 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/chosen-values/chosen-values.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "chosenValues",
+          "return": {
+            "type": {
+              "text": "string[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "known",
+              "type": {
+                "text": "ReadonlySet<string>"
+              }
+            },
+            {
+              "name": "multiple",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "description": "The values a chooser's `value` holds, read against the values of its\noptions.\n\n**One chosen value is the whole string.** A single select whose option is\n`x,y` holds `x,y`, and splitting it found no option of either half, so the\ntrigger showed the placeholder while the form sent `x,y`.\n\n**Several are joined with commas, and an option's own comma is kept.** The\nstring is split on its commas, and fragments next to each other are read as\none value where they join into the value of an option, the longest first.\nA fragment that matches no option is kept as it is, so a value set ahead of\noptions that load later is not lost. Where an option's value is also two\nother options' values joined, such as `x`, `y` and `x,y`, the longer one is\nread."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "chosenValues",
+          "declaration": {
+            "name": "chosenValues",
+            "module": "src/utils/chosen-values/chosen-values.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/clamp/clamp.ts",
@@ -32420,7 +32474,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.157.0'",
+          "default": "'0.159.0'",
           "description": "The version of the package this file ships in.\n\n**Written by `fusion/scripts/version.mjs`** wherever it writes the package's\n`package.json`, and stamped back into the repository beside it after a\nrelease, so the two never disagree; a spec beside this holds them to it.\nNothing else in the running code knows which release it is."
         }
       ],
@@ -32980,6 +33034,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.157.0"
+    "version": "0.159.0"
   }
 }

package/dist/index.d.ts

@@ -61,6 +61,7 @@ export { capturePointer } from './utils/capture-pointer/capture-pointer.js';
 export { centerInView } from './utils/center-in-view/center-in-view.js';
 export { ariaChord, type ChordPress, chordParts, matchesChord, printableChord, selectsAll, } from './utils/chord/chord.js';
 export { type KeyNames, keyNames } from './utils/chord/key-names.js';
+export { chosenValues } from './utils/chosen-values/chosen-values.js';
 export { clamp } from './utils/clamp/clamp.js';
 export { clockLocale, dayPeriod, type HourCycle, isTwelveHour, nearestTime, offeredTimes, type TimeFault, type TimeRules, timeBarred, timeFault, wheelParts, wholeHour, } from './utils/clock/clock.js';
 export { closestInstance } from './utils/closest-instance/closest-instance.js';

package/dist/index.js

@@ -61,6 +61,7 @@ export { capturePointer } from './utils/capture-pointer/capture-pointer.js';
 export { centerInView } from './utils/center-in-view/center-in-view.js';
 export { ariaChord, chordParts, matchesChord, printableChord, selectsAll, } from './utils/chord/chord.js';
 export { keyNames } from './utils/chord/key-names.js';
+export { chosenValues } from './utils/chosen-values/chosen-values.js';
 export { clamp } from './utils/clamp/clamp.js';
 export { clockLocale, dayPeriod, isTwelveHour, nearestTime, offeredTimes, timeBarred, timeFault, wheelParts, wholeHour, } from './utils/clock/clock.js';
 export { closestInstance } from './utils/closest-instance/closest-instance.js';

package/dist/mixins/mixin-dismissible/mixin-dismissible.js

@@ -32,7 +32,7 @@ export const MixinDismissible = (Base) => {
         dismiss() {
             const inside = deepContains(this, deepActiveElement());
             const neighbors = inside ? this.neighbors() : [];
-            const beside = inside && neighbors.length === 0 ? this.stopBeside() : undefined;
+            const beside = inside ? this.stopBeside() : undefined;
             const event = this.dismissEvent();
             this.dispatchEvent(event);
             if ((neighbors.length > 0 || beside) && !event.defaultPrevented) {

package/dist/utils/audit-name/audit-name.d.ts

@@ -38,9 +38,13 @@ export declare const hasName: (element: HTMLElement, shown?: Element | null) =>
  * one channel, and a project that wants the console quiet tells
  * `@fusion.dev/helix-diagnostics` with `core.warnings: false`.
  *
+ * `control` returns the control inside the host, `null` where the host is the
+ * control, or `undefined` where the control is not drawn at the moment of the
+ * read: the host is then read again the next time it asks.
+ *
  * `also` answers for a name the component gave through its internals, which no
  * attribute shows. `fix` is the sentence that says how to name it. `shown` is
  * the part where the control shows its value or its placeholder, whose words
  * are no name.
  */
-export declare const auditName: (host: HTMLElement, control: () => HTMLElement | null, fix: string, also?: () => boolean, shown?: () => Element | null) => void;
+export declare const auditName: (host: HTMLElement, control: () => HTMLElement | null | undefined, fix: string, also?: () => boolean, shown?: () => Element | null) => void;

package/dist/utils/audit-name/audit-name.js

@@ -69,8 +69,11 @@ export const auditName = (host, control, fix, also, shown) => {
         if (!host.isConnected) {
             return;
         }
-        audited.add(host);
         const inner = control();
+        if (inner === undefined) {
+            return;
+        }
+        audited.add(host);
         const value = shown?.();
         if (also?.() || hasName(host) || (inner !== null && hasName(inner, value))) {
             return;

package/dist/utils/autofill-select/autofill-select.js

@@ -1,10 +1,11 @@
 import { html, nothing } from 'lit';
+import { chosenValues } from '../chosen-values/chosen-values.js';
 const HIDDEN = 'position:fixed;top:0;left:0;width:1px;height:1px;opacity:0;pointer-events:none';
 export const drawAutofill = ({ autocomplete, disabled, multiple, onFill, options, value, }) => {
     if (autocomplete === '') {
         return nothing;
     }
-    const chosen = value.split(',');
+    const chosen = chosenValues(value, new Set(options.map((option) => option.value)), multiple);
     const fill = (event) => onFill([...event.currentTarget.selectedOptions]
         .map((option) => option.value)
         .filter(Boolean)

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

@@ -0,0 +1,17 @@
+/**
+ * The values a chooser's `value` holds, read against the values of its
+ * options.
+ *
+ * **One chosen value is the whole string.** A single select whose option is
+ * `x,y` holds `x,y`, and splitting it found no option of either half, so the
+ * trigger showed the placeholder while the form sent `x,y`.
+ *
+ * **Several are joined with commas, and an option's own comma is kept.** The
+ * string is split on its commas, and fragments next to each other are read as
+ * one value where they join into the value of an option, the longest first.
+ * A fragment that matches no option is kept as it is, so a value set ahead of
+ * options that load later is not lost. Where an option's value is also two
+ * other options' values joined, such as `x`, `y` and `x,y`, the longer one is
+ * read.
+ */
+export declare const chosenValues: (value: string, known: ReadonlySet<string>, multiple: boolean) => string[];

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

@@ -0,0 +1,19 @@
+export const chosenValues = (value, known, multiple) => {
+    if (value === '') {
+        return [];
+    }
+    if (!multiple || known.has(value)) {
+        return [value];
+    }
+    const fragments = value.split(',');
+    const values = [];
+    for (let from = 0; from < fragments.length;) {
+        let to = fragments.length;
+        while (to > from + 1 && !known.has(fragments.slice(from, to).join(','))) {
+            to -= 1;
+        }
+        values.push(fragments.slice(from, to).join(','));
+        from = to;
+    }
+    return values;
+};

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  * release, so the two never disagree; a spec beside this holds them to it.
  * Nothing else in the running code knows which release it is.
  */
-export declare const VERSION = "0.157.0";
+export declare const VERSION = "0.159.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.157.0';
+export const VERSION = '0.159.0';

package/package.json

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