@fusion.dev/helix-core 0.139.0 → 0.140.0

package/custom-elements.json

@@ -5358,6 +5358,17 @@
                 }
               ],
               "description": "Prepends the shadow-root reset to every subclass's styles, so no component\nhas to remember to include it."
+            },
+            {
+              "kind": "method",
+              "name": "performUpdate",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The first update, timed where a page asked to measure what the components\ncost, and a property read where it did not: see `reportRender`."
             }
           ],
           "events": [],
@@ -6032,6 +6043,21 @@
                 "name": "HelixElement",
                 "module": "src/helix-element/helix-element.ts"
               }
+            },
+            {
+              "kind": "method",
+              "name": "performUpdate",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The first update, timed where a page asked to measure what the components\ncost, and a property read where it did not: see `reportRender`.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
             }
           ],
           "events": [],
@@ -8078,6 +8104,70 @@
             "module": "./utils/relative-time/relative-time.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "measuring",
+          "declaration": {
+            "name": "measuring",
+            "module": "./utils/report-render/report-render.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RENDER_SLOT",
+          "declaration": {
+            "name": "RENDER_SLOT",
+            "module": "./utils/report-render/report-render.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "reportRender",
+          "declaration": {
+            "name": "reportRender",
+            "module": "./utils/report-render/report-render.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RUNTIME_LOG",
+          "declaration": {
+            "name": "RUNTIME_LOG",
+            "module": "./utils/report-runtime/report-runtime.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RUNTIME_SLOT",
+          "declaration": {
+            "name": "RUNTIME_SLOT",
+            "module": "./utils/report-runtime/report-runtime.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RuntimeEvent",
+          "declaration": {
+            "name": "RuntimeEvent",
+            "module": "./utils/report-runtime/report-runtime.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RuntimeKind",
+          "declaration": {
+            "name": "RuntimeKind",
+            "module": "./utils/report-runtime/report-runtime.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "reportRuntime",
+          "declaration": {
+            "name": "reportRuntime",
+            "module": "./utils/report-runtime/report-runtime.js"
+          }
+        },
         {
           "kind": "js",
           "name": "noteVersion",
@@ -14352,6 +14442,143 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/report-render/report-render.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "RENDER_SLOT",
+          "description": "The key the listener is kept under. `@fusion.dev/helix-diagnostics` names the same string."
+        },
+        {
+          "kind": "function",
+          "name": "measuring",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "description": "Whether anything is measuring, read before each first update."
+        },
+        {
+          "kind": "function",
+          "name": "reportRender",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "start",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "duration",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Tells the listener, where there is one, how long `element`'s first update\ntook: from `start`, on the `performance.now()` clock, for `duration`\nmilliseconds.\n\n**A listener that throws never breaks the element.** The error is printed\nonce."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RENDER_SLOT",
+          "declaration": {
+            "name": "RENDER_SLOT",
+            "module": "src/utils/report-render/report-render.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "measuring",
+          "declaration": {
+            "name": "measuring",
+            "module": "src/utils/report-render/report-render.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "reportRender",
+          "declaration": {
+            "name": "reportRender",
+            "module": "src/utils/report-render/report-render.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/report-runtime/report-runtime.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "RUNTIME_SLOT",
+          "description": "The key the listener is kept under. `@fusion.dev/helix-diagnostics` names\nthe same string.\n\nThe listener returns `true` when it prints the event in its own place, and\nthen the console line here is not printed."
+        },
+        {
+          "kind": "variable",
+          "name": "RUNTIME_LOG",
+          "description": "The key the events reported so far are kept under, for a listener that starts late."
+        },
+        {
+          "kind": "function",
+          "name": "reportRuntime",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "RuntimeEvent"
+              }
+            }
+          ],
+          "description": "Reports one event: to the log, to the listener where there is one, and to\nthe console unless the listener prints it itself.\n\n**A listener that throws never stops the report.** The error is printed\nonce, and the event is printed as if nothing listened."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RUNTIME_SLOT",
+          "declaration": {
+            "name": "RUNTIME_SLOT",
+            "module": "src/utils/report-runtime/report-runtime.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RUNTIME_LOG",
+          "declaration": {
+            "name": "RUNTIME_LOG",
+            "module": "src/utils/report-runtime/report-runtime.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "reportRuntime",
+          "declaration": {
+            "name": "reportRuntime",
+            "module": "src/utils/report-runtime/report-runtime.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/report-usage/report-usage.ts",
@@ -15455,7 +15682,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.139.0'",
+          "default": "'0.140.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."
         }
       ],
@@ -15473,6 +15700,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.139.0"
+    "version": "0.140.0"
   }
 }

package/dist/controllers/fullscreen-controller/fullscreen-controller.js

@@ -1,3 +1,4 @@
+import { reportRuntime } from '../../utils/report-runtime/report-runtime.js';
 export class FullscreenController {
     constructor(host, report) {
         this.host = host;
@@ -16,7 +17,12 @@ export class FullscreenController {
             await this.host.requestFullscreen();
         }
         catch (error) {
-            console.warn(`<${this.host.localName}> could not enter fullscreen. If it is inside an iframe, that frame needs allow="fullscreen".`, error);
+            reportRuntime({
+                detail: error,
+                kind: 'fullscreen-refused',
+                message: `<${this.host.localName}> could not enter fullscreen. If it is inside an iframe, that frame needs allow="fullscreen".`,
+                tag: this.host.localName,
+            });
         }
     }
     hostConnected() {

package/dist/controllers/virtualize-controller/virtualize-controller.js

@@ -1,3 +1,4 @@
+import { reportRuntime } from '../../utils/report-runtime/report-runtime.js';
 import { Heights } from './heights.js';
 const UNSTABLE = 10;
 export class VirtualizeController {
@@ -153,10 +154,15 @@ export class VirtualizeController {
             return;
         }
         this.warned = true;
-        console.warn(`VirtualizeController: the window did not settle in ${UNSTABLE} passes, so it is holding ` +
-            'the last one. That happens when the scrolling box has no height of its own: its ' +
-            '`clientHeight` is then a function of the rows just drawn, so measuring moves what is ' +
-            'being measured and the two never agree. Give the container a block size and an ' +
-            'overflow, which is what the styled tier does and what a headless consumer has to.');
+        const host = this.host;
+        reportRuntime({
+            kind: 'unsettled-window',
+            message: `VirtualizeController: the window did not settle in ${UNSTABLE} passes, so it is holding ` +
+                'the last one. That happens when the scrolling box has no height of its own: its ' +
+                '`clientHeight` is then a function of the rows just drawn, so measuring moves what is ' +
+                'being measured and the two never agree. Give the container a block size and an ' +
+                'overflow, which is what the styled tier does and what a headless consumer has to.',
+            tag: typeof host.localName === 'string' ? host.localName : undefined,
+        });
     }
 }

package/dist/helix-element/helix-element.d.ts

@@ -274,6 +274,11 @@ export declare class HelixElement extends LitElement {
      * has to remember to include it.
      */
     protected static finalizeStyles(styles?: CSSResultOrNative | CSSResultOrNative[]): CSSResultOrNative[];
+    /**
+     * The first update, timed where a page asked to measure what the components
+     * cost, and a property read where it did not: see `reportRender`.
+     */
+    protected performUpdate(): void;
     /**
      * Marks the component's first style resolution as done, so `SETTLED` stops
      * suppressing transitions.

package/dist/helix-element/helix-element.js

@@ -1,5 +1,6 @@
 import { css, LitElement } from 'lit';
 import { unsafeStatic } from 'lit/static-html.js';
+import { measuring, reportRender } from '../utils/report-render/report-render.js';
 import { noteVersion, reportUsage } from '../utils/report-usage/report-usage.js';
 import { applyReactProperties, auditReactProps, bindReactHandler, reactPropsOf, } from './react-bridge.js';
 const BOX_SIZING = css `
@@ -113,6 +114,17 @@ export class HelixElement extends LitElement {
     static finalizeStyles(styles) {
         return [BOX_SIZING, HIDDEN, SCROLLER, MIRROR, SETTLED, ...LitElement.finalizeStyles(styles)];
     }
+    performUpdate() {
+        if (this.hasUpdated || !measuring()) {
+            super.performUpdate();
+            return;
+        }
+        const start = performance.now();
+        super.performUpdate();
+        if (this.hasUpdated) {
+            reportRender(this, start, performance.now() - start);
+        }
+    }
     firstUpdated(changed) {
         super.firstUpdated(changed);
         reportUsage(this);

package/dist/helix-element/react-bridge.js

@@ -1,5 +1,6 @@
 import { eventsForTag } from '../events/element-events.js';
 import { helixEventNames } from '../events/events.js';
+import { reportRuntime } from '../utils/report-runtime/report-runtime.js';
 const REACT_PROPS = '__reactProps$';
 let reactPropsKey;
 export const reactPropsOf = (node) => {
@@ -22,15 +23,24 @@ export const auditReactProps = (host, props) => {
     }
     audited.add(host);
     const tag = host instanceof Element ? `<${host.localName}>` : 'A Helix element';
+    const element = host instanceof Element ? host.localName : undefined;
     for (const key of Object.keys(props)) {
         if (key.startsWith('on:')) {
-            console.warn(`${tag} was given \`${key}\`, which is Solid's syntax. React binds the name after \`on\` ` +
-                `verbatim, so this listens for an event called \`${key.slice(2)}\`. Write \`on${key.slice(3)}\`.`);
+            reportRuntime({
+                kind: 'solid-handler-syntax',
+                message: `${tag} was given \`${key}\`, which is Solid's syntax. React binds the name after \`on\` ` +
+                    `verbatim, so this listens for an event called \`${key.slice(2)}\`. Write \`on${key.slice(3)}\`.`,
+                tag: element,
+            });
             continue;
         }
         if (REMOVED.has(key)) {
-            console.warn(`${tag} was given \`${key}\`, which was removed. It never worked from JSX, because React ` +
-                `binds any \`on\` prop as an event of that name. Listen for the element's change event instead.`);
+            reportRuntime({
+                kind: 'removed-callback',
+                message: `${tag} was given \`${key}\`, which was removed. It never worked from JSX, because React ` +
+                    `binds any \`on\` prop as an event of that name. Listen for the element's change event instead.`,
+                tag: element,
+            });
             continue;
         }
         if (!key.startsWith('on') || !key.includes('-')) {
@@ -38,15 +48,23 @@ export const auditReactProps = (host, props) => {
         }
         const name = key.slice(2);
         if (!helixEventNames.has(name)) {
-            console.warn(`${tag} was given \`${key}\`, and nothing dispatches \`${name}\`. TypeScript cannot ` +
-                `check a hyphenated JSX prop, so this is the only place it shows up.`);
+            reportRuntime({
+                kind: 'unknown-event',
+                message: `${tag} was given \`${key}\`, and nothing dispatches \`${name}\`. TypeScript cannot ` +
+                    `check a hyphenated JSX prop, so this is the only place it shows up.`,
+                tag: element,
+            });
             continue;
         }
         const mine = host instanceof Element ? eventsForTag(host.localName) : undefined;
         if (mine && !mine.has(name)) {
-            console.warn(`${tag} was given \`${key}\`, but it dispatches ${[...mine].map((one) => `\`${one}\``).join(', ')}. ` +
-                `\`${name}\` is sent by a different element, and React only wires an \`on\` prop on the ` +
-                'element that dispatches, so this handler will never run. Put it on that element.');
+            reportRuntime({
+                kind: 'misplaced-handler',
+                message: `${tag} was given \`${key}\`, but it dispatches ${[...mine].map((one) => `\`${one}\``).join(', ')}. ` +
+                    `\`${name}\` is sent by a different element, and React only wires an \`on\` prop on the ` +
+                    'element that dispatches, so this handler will never run. Put it on that element.',
+                tag: element,
+            });
         }
     }
 };

package/dist/index.d.ts

@@ -63,6 +63,8 @@ export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
 export { type ColorBytes, readColor } from './utils/read-color/read-color.js';
 export { type Row, type RowCell, readRows, readSeries, type Series, type SeriesPoint, } from './utils/read-series/read-series.js';
 export { type Relative, relativeTime, } from './utils/relative-time/relative-time.js';
+export { measuring, RENDER_SLOT, reportRender } from './utils/report-render/report-render.js';
+export { RUNTIME_LOG, RUNTIME_SLOT, type RuntimeEvent, type RuntimeKind, reportRuntime, } from './utils/report-runtime/report-runtime.js';
 export { noteVersion, reportUsage, USAGE_SLOT, VERSIONS_SLOT, } from './utils/report-usage/report-usage.js';
 export { reportValues } from './utils/report-values/report-values.js';
 export { type ChangeRequestOptions, requestChange, } from './utils/request-change/request-change.js';

package/dist/index.js

@@ -63,6 +63,8 @@ export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
 export { readColor } from './utils/read-color/read-color.js';
 export { readRows, readSeries, } from './utils/read-series/read-series.js';
 export { relativeTime, } from './utils/relative-time/relative-time.js';
+export { measuring, RENDER_SLOT, reportRender } from './utils/report-render/report-render.js';
+export { RUNTIME_LOG, RUNTIME_SLOT, reportRuntime, } from './utils/report-runtime/report-runtime.js';
 export { noteVersion, reportUsage, USAGE_SLOT, VERSIONS_SLOT, } from './utils/report-usage/report-usage.js';
 export { reportValues } from './utils/report-values/report-values.js';
 export { requestChange, } from './utils/request-change/request-change.js';

package/dist/utils/custom-element/custom-element.js

@@ -1,3 +1,4 @@
+import { reportRuntime } from '../report-runtime/report-runtime.js';
 const reported = new Set();
 const duplicates = new Set();
 export const duplicateRegistrations = () => [...duplicates];
@@ -9,11 +10,15 @@ const warnDuplicate = (tagName) => {
     }
     reported.add(tagName);
     duplicates.add(tagName);
-    console.warn(`<${tagName}> is already registered by a different class, so this page holds two copies of ` +
-        'Helix. The first one keeps the tag: every element of this name is built from it, whatever ' +
-        'the second copy exports, so `instanceof` against the second copy is false and its fixes are ' +
-        'not in the DOM. Two dependencies asking for different versions is the usual cause, and a ' +
-        'bundler shipping the same version twice is the other. Deduplicate the dependency.');
+    reportRuntime({
+        kind: 'duplicate-registration',
+        message: `<${tagName}> is already registered by a different class, so this page holds two copies of ` +
+            'Helix. The first one keeps the tag: every element of this name is built from it, whatever ' +
+            'the second copy exports, so `instanceof` against the second copy is false and its fixes are ' +
+            'not in the DOM. Two dependencies asking for different versions is the usual cause, and a ' +
+            'bundler shipping the same version twice is the other. Deduplicate the dependency.',
+        tag: tagName,
+    });
 };
 export const customElement = (tagName) => (target) => {
     if (typeof customElements === 'undefined') {

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

@@ -0,0 +1,28 @@
+/**
+ * Where an element's first update is timed, for whoever is measuring what the
+ * components cost.
+ *
+ * **One slot on `globalThis`, under a registered symbol, and empty by
+ * default**, as for usage: `@fusion.dev/helix-diagnostics` fills it where a
+ * project asked for performance. With nothing in the slot, an element pays one
+ * property read before its first update, and takes no time.
+ *
+ * **The element's own update, from the start of its first update to the end
+ * of it**: `willUpdate`, the render, the commit to the DOM, and the hooks
+ * after. Timed from its connection, a measure would also count the time it
+ * waited behind every element connected before it, so the last of a hundred
+ * elements on a page would read as the slowest.
+ */
+/** The key the listener is kept under. `@fusion.dev/helix-diagnostics` names the same string. */
+export declare const RENDER_SLOT: unique symbol;
+/** Whether anything is measuring, read before each first update. */
+export declare const measuring: () => boolean;
+/**
+ * Tells the listener, where there is one, how long `element`'s first update
+ * took: from `start`, on the `performance.now()` clock, for `duration`
+ * milliseconds.
+ *
+ * **A listener that throws never breaks the element.** The error is printed
+ * once.
+ */
+export declare const reportRender: (element: HTMLElement, start: number, duration: number) => void;

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

@@ -0,0 +1,18 @@
+export const RENDER_SLOT = Symbol.for('fusion.dev/helix/render');
+export const measuring = () => typeof globalThis[RENDER_SLOT] === 'function';
+let told = false;
+export const reportRender = (element, start, duration) => {
+    const listener = globalThis[RENDER_SLOT];
+    if (typeof listener !== 'function') {
+        return;
+    }
+    try {
+        listener(element, { duration, start });
+    }
+    catch (error) {
+        if (!told) {
+            told = true;
+            console.error('helix: a render listener threw, and the element rendered as usual. Later failures are not printed.', error);
+        }
+    }
+};

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

@@ -0,0 +1,97 @@
+/**
+ * Where the library says, as it runs, that it was used wrong or could not do
+ * what it was asked: one channel for every such warning, in every package.
+ *
+ * **Each warning is an event with a kind**, stable across versions, so
+ * `@fusion.dev/helix-diagnostics` counts it by kind and tag, lists it beside
+ * the findings, and sends it where a project's settings say. The sentence
+ * prints in the console as it always did, unless the listener prints it in its
+ * own place, which a project asks for with `core.warnings: false`.
+ *
+ * **The same kind of slot on `globalThis` as usage**, under a registered
+ * symbol, so every copy of Helix on a page reports to one listener, and
+ * diagnostics needs nothing imported from here.
+ *
+ * **Kept from the start of the page, a few hundred at most**, since the first
+ * events happen as the modules load: a tag registered twice is reported before
+ * any diagnostics can have started.
+ */
+/** What went wrong, stable across versions, so it can be counted. */
+export type RuntimeKind = 
+/** Another class asked for a tag that is already registered: two copies of Helix. */
+'duplicate-registration'
+/** The browser refused fullscreen, usually for a frame without the permission. */
+ | 'fullscreen-refused'
+/** An Avatar Group's `max` is past the number the fold is written for. */
+ | 'max-past-fold'
+/** A rating's `min` is no score between 0 and its `max`. */
+ | 'min-out-of-range'
+/** A React handler prop names an event the element never dispatches itself. */
+ | 'misplaced-handler'
+/** The three.js driver could not load its layout, so the notes stay where they started. */
+ | 'missing-layout'
+/** A selectable Data Table has no `row-key`, so it knows each row by its place. */
+ | 'missing-row-key'
+/** A stencil names parts the shape does not have. */
+ | 'missing-stencil-parts'
+/** A tooltip's `for` names no element in its own tree. */
+ | 'missing-trigger'
+/** An area chart was handed a negative number, which it draws as none. */
+ | 'negative-value'
+/** A Graph connector was handed an element that is no Graph frame. */
+ | 'not-a-graph'
+/** The browser refused picture in picture. */
+ | 'picture-in-picture-refused'
+/** A React handler prop is a removed callback, which never ran from JSX. */
+ | 'removed-callback'
+/** A React handler prop uses Solid's `on:`, which React reads as another event's name. */
+ | 'solid-handler-syntax'
+/** A stencil's regions went unused: no named parts, or parts too small. */
+ | 'stencil-regions-unused'
+/** A stencil has no inside to place the notes in. */
+ | 'stencil-without-inside'
+/** A Data Table is drawing more rows at once than it stays responsive to. */
+ | 'too-many-rows'
+/** A filter field marks more than one operator as its default. */
+ | 'two-default-operators'
+/** A React handler prop names an event nothing dispatches. */
+ | 'unknown-event'
+/** A tooltip's trigger does not name it in `aria-describedby`, so it is not read out. */
+ | 'unlinked-trigger'
+/** A virtualized list's box has no height of its own, so its window never settles. */
+ | 'unsettled-window'
+/** A slotted trigger is a plain element, which cannot be told it opens something. */
+ | 'untold-trigger'
+/** A tooltip wraps its trigger, so its text reaches no screen reader. */
+ | 'wrapped-trigger';
+/** One event: what went wrong, where, and the sentence that says what to do. */
+export interface RuntimeEvent {
+    /** What went wrong. */
+    readonly kind: RuntimeKind;
+    /** Printed with `console.error` where `error`, and with `console.warn` otherwise. */
+    readonly level?: 'error' | 'warn';
+    /** The sentence the console prints, which says what to do. */
+    readonly message: string;
+    /** The tag of the element it happened on, where there is one. */
+    readonly tag?: string | undefined;
+    /** What else the console line carries, such as the error a platform call threw. */
+    readonly detail?: unknown;
+}
+/**
+ * The key the listener is kept under. `@fusion.dev/helix-diagnostics` names
+ * the same string.
+ *
+ * The listener returns `true` when it prints the event in its own place, and
+ * then the console line here is not printed.
+ */
+export declare const RUNTIME_SLOT: unique symbol;
+/** The key the events reported so far are kept under, for a listener that starts late. */
+export declare const RUNTIME_LOG: unique symbol;
+/**
+ * Reports one event: to the log, to the listener where there is one, and to
+ * the console unless the listener prints it itself.
+ *
+ * **A listener that throws never stops the report.** The error is printed
+ * once, and the event is printed as if nothing listened.
+ */
+export declare const reportRuntime: (event: RuntimeEvent) => void;

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

@@ -0,0 +1,35 @@
+export const RUNTIME_SLOT = Symbol.for('fusion.dev/helix/runtime');
+export const RUNTIME_LOG = Symbol.for('fusion.dev/helix/runtime-log');
+const KEPT = 200;
+let told = false;
+export const reportRuntime = (event) => {
+    const store = globalThis;
+    const log = Array.isArray(store[RUNTIME_LOG]) ? store[RUNTIME_LOG] : [];
+    if (log.length < KEPT) {
+        log.push(event);
+    }
+    store[RUNTIME_LOG] = log;
+    let quiet = false;
+    const listener = store[RUNTIME_SLOT];
+    if (typeof listener === 'function') {
+        try {
+            quiet = listener(event) === true;
+        }
+        catch (error) {
+            if (!told) {
+                told = true;
+                console.error('helix: a runtime listener threw, and the warning is printed here. Later failures are not printed.', error);
+            }
+        }
+    }
+    if (quiet) {
+        return;
+    }
+    const print = event.level === 'error' ? console.error : console.warn;
+    if (event.detail === undefined) {
+        print(event.message);
+    }
+    else {
+        print(event.message, event.detail);
+    }
+};

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

@@ -1,3 +1,4 @@
+import { reportRuntime } from '../report-runtime/report-runtime.js';
 const warned = new WeakSet();
 export const tellDisclosure = (trigger, open, popup) => {
     if (!trigger) {
@@ -16,9 +17,13 @@ export const tellDisclosure = (trigger, open, popup) => {
         return;
     }
     warned.add(trigger);
-    console.warn(`<${trigger.localName}> is slotted as a trigger and cannot be told that it opens something. ` +
-        'The state would have to be written onto your markup as `aria-expanded`, which a React ' +
-        "consumer's hydration reports and does not patch up, so it is not written. Slot a " +
-        '`helix-button` or `helix-icon-button`, which carry it inside their own shadow root, or ' +
-        'add `aria-haspopup` and your own `aria-expanded` to this element.');
+    reportRuntime({
+        kind: 'untold-trigger',
+        message: `<${trigger.localName}> is slotted as a trigger and cannot be told that it opens something. ` +
+            'The state would have to be written onto your markup as `aria-expanded`, which a React ' +
+            "consumer's hydration reports and does not patch up, so it is not written. Slot a " +
+            '`helix-button` or `helix-icon-button`, which carry it inside their own shadow root, or ' +
+            'add `aria-haspopup` and your own `aria-expanded` to this element.',
+        tag: trigger.localName,
+    });
 };

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

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.139.0';
+export const VERSION = '0.140.0';

package/package.json

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