@fusion.dev/helix-core 0.178.0 → 0.180.0

package/custom-elements.json

@@ -378,6 +378,15 @@
               "default": "'inline'",
               "description": "Which axis the readings are laid out along.\n\n**An axis and not a boolean, because two of the four charts do not use x.**\nA horizontal bar chart runs its categories *down* the box, so resolving\nevery reading from the pointer's x leaves a move from the first row to the\nlast never changing the answer: measured on four rows, all four reported\nthe third, which is the slot the middle of the box falls in. It looks like\na tooltip that will not follow and is a tooltip reading the wrong axis.\n\n`none` is the ring. Its slices are real elements at every angle, so the\nreading under the pointer is the one the pointer is over, and arithmetic on\neither axis would answer with whichever slice shared a coordinate: at three\no'clock and at nine o'clock, x alone gives the same slice for opposite\nsides. The slices call `set` and this only holds the answer."
             },
+            {
+              "kind": "field",
+              "name": "drawnLtr",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the plot is drawn left to right on every page, as Scatter Chart's\nplane is, so the arrows follow the drawing rather than the page's\ndirection. Off, the arrow pointing along the line of text moves on."
+            },
             {
               "kind": "field",
               "name": "onReading",
@@ -12852,6 +12861,14 @@
       "path": "src/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "auditChildren",
+          "declaration": {
+            "name": "auditChildren",
+            "package": "#audit-children"
+          }
+        },
         {
           "kind": "js",
           "name": "auditName",
@@ -15876,6 +15893,14 @@
             "module": "./utils/draw-tooltip/draw-tooltip.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "spokenReading",
+          "declaration": {
+            "name": "spokenReading",
+            "module": "./utils/draw-tooltip/spoken-reading.js"
+          }
+        },
         {
           "kind": "js",
           "name": "drawValueAxis",
@@ -24579,6 +24604,86 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/audit-children/audit-children-off.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "auditChildren",
+          "description": "The unregistered-child warning in a production build: nothing.\n\n`#audit-children` resolves here unless the bundler or runtime asks for the\n`development` condition, so a production build carries none of the audit's\ncode. The signature is the audit's, so a call site reads the same in both\nbuilds. See `audit-children.ts`.",
+          "type": {
+            "text": "typeof audit"
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "auditChildren",
+          "declaration": {
+            "name": "auditChildren",
+            "module": "src/utils/audit-children/audit-children-off.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/audit-children/audit-children.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "auditChildren",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "host",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "part",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "entry",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "consequence",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "drawn",
+              "default": "false"
+            }
+          ],
+          "description": "Reports a child from another family that a container holds and nobody\nregistered, naming the entry to import.\n\n**A container does not register another family's children.** An option\nbelongs to the Option family, and a page writing one inside a Select imports\n`@fusion.dev/helix/option` itself, as it imports the Select. Left out, the\noption is an unknown element: the list reads no choices and nothing throws.\nThis says so, once for each container tag and child tag on the page, with\nthe line to add.\n\nAsked once the page has loaded and painted, so an entry a later module\nimports is not taken for a missing one.\n\n**In a development build only**, as `missing-name` is: every container would\npay for a sentence meant for the person writing the page. Core imports it as\n`#audit-children`, which `package.json` resolves here under the\n`development` condition and to `audit-children-off.ts`, which does nothing,\neverywhere else.\n\n`part` is the child's tag after the tier, such as `option`, and `entry` its\nfamily's entry, such as `option`; the host's `tier` gives the rest of both.\n`consequence` says what the missing child costs, after \"so\". `drawn` is for\nchildren the host draws from data, such as the options of Listbox's `items`:\nthe page wrote none, so an undefined tag is reported without one in the\nhost's light DOM."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "auditChildren",
+          "declaration": {
+            "name": "auditChildren",
+            "module": "src/utils/audit-children/audit-children.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/audit-name/audit-name-off.ts",
@@ -30384,7 +30489,7 @@
               }
             }
           ],
-          "description": "Adds `by` to the elements that describe `target`, where that is safe, and\nsays whether `target` is now described by it.\n\nThrough element reflection, and only where no framework is watching:\n\n- **Inside a shadow root**, such as the `<button>` a Helix button draws, it\n  is always safe. That markup is the component's own, and no server sent it.\n- **In the light DOM**, the element is the consumer's, and reflection writes\n  an empty `aria-describedby` onto it. So it is written only when `light` is\n  set, which a caller does once a reader has acted on the page, after any\n  hydration, and never where the consumer wrote `aria-describedby` or\n  `aria-labelledby` themselves, which are theirs to keep.\n\nExisting references are kept, so a field's hint still describes it. Tooltip\ndescribes its trigger this way."
+          "description": "Adds `by` to the elements that describe `target`, where that is safe, and\nsays whether it wrote the link, which is then the caller's to take back with\n`unlinkDescription`. A `target` described by `by` already is left alone and\nanswers false.\n\nThrough element reflection, and only where no framework is watching:\n\n- **Inside a shadow root**, such as the `<button>` a Helix button draws, it\n  is always safe. That markup is the component's own, and no server sent it.\n- **In the light DOM**, the element is the consumer's, and reflection writes\n  an empty `aria-describedby` onto it. So it is written only when `light` is\n  set, which a caller does once a reader has acted on the page, after any\n  hydration, and never where the consumer wrote `aria-describedby` or\n  `aria-labelledby` themselves, which are theirs to keep.\n\nExisting references are kept, so a field's hint still describes it. Tooltip\ndescribes its trigger this way."
         },
         {
           "kind": "function",
@@ -33979,7 +34084,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.178.0'",
+          "default": "'0.180.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."
         }
       ],
@@ -34615,6 +34720,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.178.0"
+    "version": "0.180.0"
   }
 }

package/dist/controllers/chart-pointer-controller/chart-pointer-controller.d.ts

@@ -162,6 +162,12 @@ export declare class ChartPointerController implements ReactiveController {
      * sides. The slices call `set` and this only holds the answer.
      */
     axis: 'block' | 'inline' | 'none';
+    /**
+     * Whether the plot is drawn left to right on every page, as Scatter Chart's
+     * plane is, so the arrows follow the drawing rather than the page's
+     * direction. Off, the arrow pointing along the line of text moves on.
+     */
+    drawnLtr: boolean;
     /**
      * Hears the reading: `change` each time it moves or is put away, and
      * `press` when it is clicked, tapped, or pressed with Enter or Space.

package/dist/controllers/chart-pointer-controller/chart-pointer-controller.js

@@ -10,6 +10,7 @@ export class ChartPointerController {
         this.keyed = false;
         this.series = -1;
         this.axis = 'inline';
+        this.drawnLtr = false;
         this.by = 'mouse';
         this.said = { at: -1, series: -1 };
         this.tapped = false;
@@ -87,7 +88,7 @@ export class ChartPointerController {
                 count,
                 grid: this.grid,
                 page: this.page(count),
-                rtl: isRtl(this.host),
+                rtl: !this.drawnLtr && isRtl(this.host),
                 series: this.columns().length,
             });
             if (next === undefined) {

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { auditChildren } from '@fusion.dev/helix-core/audits/children';
 export { auditName } from '@fusion.dev/helix-core/audits/name';
 export { auditNesting } from '@fusion.dev/helix-core/audits/nesting';
 export { auditServed } from '@fusion.dev/helix-core/audits/served';
@@ -79,6 +80,7 @@ export { readWrittenDate, readWrittenTime, segmentName, } from './utils/date-seg
 export { type DrawDismissOptions, drawDismiss, drawDismissGlyph, } from './utils/draw-dismiss/draw-dismiss.js';
 export { type DrawIconOptions, drawIcon } from './utils/draw-icon/draw-icon.js';
 export { CHART_PLOT, drawTooltip, type ReadingCursor } from './utils/draw-tooltip/draw-tooltip.js';
+export { spokenReading } from './utils/draw-tooltip/spoken-reading.js';
 export { drawValueAxis } from './utils/draw-value-axis/draw-value-axis.js';
 export { drawsInSoftware } from './utils/draws-in-software/draws-in-software.js';
 export { elapsedTime } from './utils/elapsed-time/elapsed-time.js';

package/dist/index.js

@@ -1,3 +1,4 @@
+export { auditChildren } from '@fusion.dev/helix-core/audits/children';
 export { auditName } from '@fusion.dev/helix-core/audits/name';
 export { auditNesting } from '@fusion.dev/helix-core/audits/nesting';
 export { auditServed } from '@fusion.dev/helix-core/audits/served';
@@ -79,6 +80,7 @@ export { readWrittenDate, readWrittenTime, segmentName, } from './utils/date-seg
 export { drawDismiss, drawDismissGlyph, } from './utils/draw-dismiss/draw-dismiss.js';
 export { drawIcon } from './utils/draw-icon/draw-icon.js';
 export { CHART_PLOT, drawTooltip } from './utils/draw-tooltip/draw-tooltip.js';
+export { spokenReading } from './utils/draw-tooltip/spoken-reading.js';
 export { drawValueAxis } from './utils/draw-value-axis/draw-value-axis.js';
 export { drawsInSoftware } from './utils/draws-in-software/draws-in-software.js';
 export { elapsedTime } from './utils/elapsed-time/elapsed-time.js';

package/dist/utils/audit-children/audit-children-off.d.ts

@@ -0,0 +1,10 @@
+import type { auditChildren as audit } from './audit-children.js';
+/**
+ * The unregistered-child warning in a production build: nothing.
+ *
+ * `#audit-children` resolves here unless the bundler or runtime asks for the
+ * `development` condition, so a production build carries none of the audit's
+ * code. The signature is the audit's, so a call site reads the same in both
+ * builds. See `audit-children.ts`.
+ */
+export declare const auditChildren: typeof audit;

package/dist/utils/audit-children/audit-children-off.js

@@ -0,0 +1 @@
+export const auditChildren = () => { };

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

@@ -0,0 +1,28 @@
+/**
+ * Reports a child from another family that a container holds and nobody
+ * registered, naming the entry to import.
+ *
+ * **A container does not register another family's children.** An option
+ * belongs to the Option family, and a page writing one inside a Select imports
+ * `@fusion.dev/helix/option` itself, as it imports the Select. Left out, the
+ * option is an unknown element: the list reads no choices and nothing throws.
+ * This says so, once for each container tag and child tag on the page, with
+ * the line to add.
+ *
+ * Asked once the page has loaded and painted, so an entry a later module
+ * imports is not taken for a missing one.
+ *
+ * **In a development build only**, as `missing-name` is: every container would
+ * pay for a sentence meant for the person writing the page. Core imports it as
+ * `#audit-children`, which `package.json` resolves here under the
+ * `development` condition and to `audit-children-off.ts`, which does nothing,
+ * everywhere else.
+ *
+ * `part` is the child's tag after the tier, such as `option`, and `entry` its
+ * family's entry, such as `option`; the host's `tier` gives the rest of both.
+ * `consequence` says what the missing child costs, after "so". `drawn` is for
+ * children the host draws from data, such as the options of Listbox's `items`:
+ * the page wrote none, so an undefined tag is reported without one in the
+ * host's light DOM.
+ */
+export declare const auditChildren: (host: HTMLElement, part: string, entry: string, consequence: string, drawn?: boolean) => void;

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

@@ -0,0 +1,37 @@
+import { reportRuntime } from '../report-runtime/report-runtime.js';
+const reported = new Set();
+export const auditChildren = (host, part, entry, consequence, drawn = false) => {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    const tier = host.constructor.tier ?? 'helix-headless-';
+    const tag = `${tier}${part}`;
+    const key = `${host.localName}>${tag}`;
+    if (reported.has(key)) {
+        return;
+    }
+    const check = () => {
+        if (reported.has(key) ||
+            !host.isConnected ||
+            customElements.get(tag) !== undefined ||
+            (!drawn && host.querySelector(tag) === null)) {
+            return;
+        }
+        reported.add(key);
+        const pkg = tier === 'helix-' ? '@fusion.dev/helix' : '@fusion.dev/helix-headless';
+        reportRuntime({
+            kind: 'unregistered-part',
+            message: `<${tag}> in <${host.localName}> is not registered, so ${consequence}. Import '${pkg}/${entry}'.`,
+            tag: host.localName,
+        });
+    };
+    const frame = () => {
+        requestAnimationFrame(check);
+    };
+    if (document.readyState === 'complete') {
+        frame();
+    }
+    else {
+        window.addEventListener('load', frame, { once: true });
+    }
+};

package/dist/utils/reflect-elements/reflect-elements.d.ts

@@ -17,7 +17,9 @@ export type ElementsProperty = 'ariaControlsElements' | 'ariaDescribedByElements
 export declare const reflectElements: (target: Element | null | undefined, property: ElementsProperty, elements: readonly Element[], owned: boolean) => boolean;
 /**
  * Adds `by` to the elements that describe `target`, where that is safe, and
- * says whether `target` is now described by it.
+ * says whether it wrote the link, which is then the caller's to take back with
+ * `unlinkDescription`. A `target` described by `by` already is left alone and
+ * answers false.
  *
  * Through element reflection, and only where no framework is watching:
  *

package/dist/utils/reflect-elements/reflect-elements.js

@@ -19,7 +19,7 @@ export const linkDescription = (target, by, light) => {
     }
     const current = element.ariaDescribedByElements ?? [];
     if (current.includes(by)) {
-        return true;
+        return false;
     }
     const shadowed = typeof ShadowRoot !== 'undefined' && target.getRootNode() instanceof ShadowRoot;
     if (!shadowed &&

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.178.0";
+export declare const VERSION = "0.180.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.178.0';
+export const VERSION = '0.180.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.178.0",
+  "version": "0.180.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -17,6 +17,12 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./audits/children": {
+      "types": "./dist/utils/audit-children/audit-children.d.ts",
+      "development": "./dist/utils/audit-children/audit-children.js",
+      "helix-development": "./dist/utils/audit-children/audit-children.js",
+      "default": "./dist/utils/audit-children/audit-children-off.js"
+    },
     "./audits/name": {
       "types": "./dist/utils/audit-name/audit-name.d.ts",
       "development": "./dist/utils/audit-name/audit-name.js",
@@ -68,16 +74,21 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.178.0"
+    "@fusion.dev/helix-icons": "0.180.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.178.0",
-    "@fusion.dev/helix-testing": "0.178.0",
+    "@fusion.dev/helix-cem": "0.180.0",
+    "@fusion.dev/helix-testing": "0.180.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },
   "homepage": "https://fusion.dev",
   "imports": {
+    "#audit-children": {
+      "development": "./src/utils/audit-children/audit-children.ts",
+      "helix-development": "./src/utils/audit-children/audit-children.ts",
+      "default": "./src/utils/audit-children/audit-children-off.ts"
+    },
     "#audit-name": {
       "development": "./src/utils/audit-name/audit-name.ts",
       "helix-development": "./src/utils/audit-name/audit-name.ts",