@fusion.dev/helix-core 0.161.0 → 0.162.1

package/custom-elements.json

@@ -5501,6 +5501,117 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/upgrade-controller/upgrade-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Calls back when a child that had not upgraded is defined.\n\n**A host that knows its children by their class does not know a child that\nhas not upgraded.** `instanceof` is false for it and a marker its class sets,\nsuch as `isNotification`, is missing. An upgrade changes no child list and no\nslot assignment, so neither a `MutationObserver` nor `slotchange` reports it,\nand the host keeps the answer it read before. Measured on the notification\nfeed: a row added while its definition was still loading was drawn nowhere,\nand the feed showed its empty line over it. A listbox did not select an\noption its `default-value` named, and a tree gave a late item no level.\n\nThis happens wherever a child's definition loads after the host's: a page\nthat adds children before its scripts finish, or a bundle that defines the\nhost first.\n\nIt looks when the host connects and at each child added after, and waits on\n`customElements.whenDefined` once for each name. `define` upgrades the\nelements in the document before that promise resolves, so the children have\ntheir class by the time the callback runs. The callback is the host's own\nresync, such as its `slotchange` handler, and is `requestUpdate` unless given\nsomething else to do. Watches from connection to disconnection.",
+          "name": "UpgradeController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "watcher",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "waiting",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<string>()",
+              "description": "The names already waited on, so each is waited on once."
+            },
+            {
+              "kind": "field",
+              "name": "subtree",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "hostConnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "look",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "Element"
+                  }
+                },
+                {
+                  "name": "added",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Waits on `element`, where it was added, and on what it holds where the subtree counts."
+            },
+            {
+              "kind": "method",
+              "name": "wait",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ]
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "UpgradeController",
+          "declaration": {
+            "name": "UpgradeController",
+            "module": "src/controllers/upgrade-controller/upgrade-controller.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/controllers/virtualize-controller/heights.ts",
@@ -8137,6 +8248,14 @@
             "module": "./details.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "StrandsFallbackDetail",
+          "declaration": {
+            "name": "StrandsFallbackDetail",
+            "module": "./details.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ToggleDetail",
@@ -8881,6 +9000,14 @@
             "module": "src/events/events.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixStrandsFallbackEvent",
+          "declaration": {
+            "name": "HelixStrandsFallbackEvent",
+            "module": "src/events/events.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixToggleEvent",
@@ -9761,7 +9888,7 @@
           "type": {
             "text": "ReadonlySet<string>"
           },
-          "default": "new Set( ( 'action activate aura-fallback band before-activate before-change before-close ' + 'before-collapse before-edit before-move before-open before-panel-resize before-pin ' + 'before-reconnect before-relabel before-reorder before-resize before-split before-toggle ' + 'canvas-edit canvas-pan canvas-view canvas-zoom caret clear collapse complete ' + 'connect console copy copy-error create dismiss edit end expand facet filter ' + 'filtered graph-filter graph-layout graph-pan graph-part-change graph-ready ' + 'graph-signal graph-zoom history load load-more map-cluster map-pan map-part-change ' + 'map-ready map-rotate map-tilt map-zoom move navigate next panel-resize pin press ' + 'preview previous range-change read reading-change reading-press reconnect reject ' + 'relabel remove reorder ' + 'reordered resize resized sample-end sample-start scrolled select selected send ' + 'shortcut sort sorted split toggle tour-ask tour-status typing' ) .split(' ') .map((name) => `helix-${name}`), )",
+          "default": "new Set( ( 'action activate aura-fallback band before-activate before-change before-close ' + 'before-collapse before-edit before-move before-open before-panel-resize before-pin ' + 'before-reconnect before-relabel before-reorder before-resize before-split before-toggle ' + 'canvas-edit canvas-pan canvas-view canvas-zoom caret clear collapse complete ' + 'connect console copy copy-error create dismiss edit end expand facet filter ' + 'filtered graph-filter graph-layout graph-pan graph-part-change graph-ready ' + 'graph-signal graph-zoom history load load-more map-cluster map-pan map-part-change ' + 'map-ready map-rotate map-tilt map-zoom move navigate next panel-resize pin press ' + 'preview previous range-change read reading-change reading-press reconnect reject ' + 'relabel remove reorder ' + 'reordered resize resized sample-end sample-start scrolled select selected send ' + 'shortcut sort sorted split strands-fallback toggle tour-ask tour-status typing' ) .split(' ') .map((name) => `helix-${name}`), )",
           "description": "Every name this library dispatches.\n\nExported so a runtime check can ask whether a name is one of ours without\nkeeping a second list of them. `HelixElement` uses it to tell a consumer that\nthe handler prop they wrote is attached to nothing.\n\n**Written as strings, in a module of its own, and not read off the\nclasses in `registry`.** Every element carries this set through its React\nprop audit, and a set read off the classes kept every class alive in every\nbundle: a Badge shipped all eighty of them. As strings, a family ships the\nclasses it dispatches and no others. `events.pure.spec.ts` holds this list to\nthe classes, so a class added without its name here fails.\n\n**Without the shared `helix-`, and separated by spaces.** Every element carries this\nlist, and as quoted strings each paid its quotes, its comma and the prefix."
         }
       ],
@@ -10878,6 +11005,44 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/events/strands-fallback.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A strands element stopped drawing its ribbon and shows its gradient, and\nsays why.\n\nSent each time it falls back, from the element, which then matches\n`:state(fallback)` until it draws again. Not cancelable: there is nothing\nleft to refuse.",
+          "name": "HelixStrandsFallbackEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-strands-fallback'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/strands-fallback.ts"
+          },
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixStrandsFallbackEvent",
+          "declaration": {
+            "name": "HelixStrandsFallbackEvent",
+            "module": "src/events/strands-fallback.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/events/toggle.ts",
@@ -13007,6 +13172,22 @@
             "module": "./controllers/token-color-controller/token-color-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "UpgradeController",
+          "declaration": {
+            "name": "UpgradeController",
+            "module": "./controllers/upgrade-controller/upgrade-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "UpgradeOptions",
+          "declaration": {
+            "name": "UpgradeOptions",
+            "module": "./controllers/upgrade-controller/upgrade-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "Rendered",
@@ -13887,6 +14068,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixStrandsFallbackEvent",
+          "declaration": {
+            "name": "HelixStrandsFallbackEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixToggleEvent",
@@ -14143,6 +14332,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "StrandsFallbackDetail",
+          "declaration": {
+            "name": "StrandsFallbackDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ToggleDetail",
@@ -15295,6 +15492,14 @@
             "module": "./utils/draw-value-axis/draw-value-axis.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "drawsInSoftware",
+          "declaration": {
+            "name": "drawsInSoftware",
+            "module": "./utils/draws-in-software/draws-in-software.js"
+          }
+        },
         {
           "kind": "js",
           "name": "elapsedTime",
@@ -26984,6 +27189,41 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/draws-in-software/draws-in-software.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "drawsInSoftware",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "attributes",
+              "type": {
+                "text": "WebGLContextAttributes"
+              },
+              "description": "What the caller's drawing context asks for."
+            }
+          ],
+          "description": "Whether WebGL here is drawn on the CPU, asked before one is drawn into.\n\nShared by the elements that draw a decorative field with WebGL, `Aura` and\n`Strands`, which take their gradient on a software renderer rather than pay\nfor a shader nobody can see at speed.\n\n**The shader costs what a GPU makes it cheap to ask for.** Measured on Aura,\n15 Sep 2026: on Metal the browser shares the compiled program and each aura\nafter the first draws its opening frame in about 2ms, while under SwiftShader\nnothing is shared and each one compiles the pipeline again for about 450ms.\nOn a page of 720 pixel auras the worst frame gap went 568ms to 50ms with one\naura, 1626ms to 34ms with three and 3200ms to 42ms with six once this check\nwas in place, and a page of three or six ran at 13 frames a second before and\nat the display's own rate after.\n\n**The unmasked name is the only one that answers.** `gl.RENDERER` is masked\nto `WebKit WebGL` on Chromium, the same string on SwiftShader and on Metal,\nand `WEBGL_debug_renderer_info` is what lifts the mask.\n\n**An unreadable renderer draws**, which is the safe direction and not the\ntidy one. The extension is optional and is withheld deliberately: Firefox's\n`privacy.resistFingerprinting` and Safari's equivalent both drop it, and a\nbrowser may drop it at any time, since a GPU name is a fingerprinting\nsurface. Treating \"we cannot tell\" as software would take the shader away\nfrom every reader on a machine that hides its hardware, which is a real GPU\nfar more often than not.\n\n**A probe context of its own, and given straight back.** Asking the caller's\nown canvas would spend it, and the probe has to release what it took or a\npage of fields runs the browser into its cap of about sixteen contexts. One\npixel by one, and released through `WEBGL_lose_context`.\n\n**The same attributes the real context asks for**, because they are part of\nthe question: `powerPreference` can select a different adapter, so a probe\nasking for a high-performance context would name a GPU the drawing one is\nnever given.\n\n**Asked per context rather than once for the page.** The answer is not fixed:\na GPU process that crashes takes the page down to SwiftShader for the rest of\nits life, and a field rebuilding after that should get the current answer. It\ncosts a context creation and two calls, about 2ms, once per context."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "drawsInSoftware",
+          "declaration": {
+            "name": "drawsInSoftware",
+            "module": "src/utils/draws-in-software/draws-in-software.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/elapsed-time/elapsed-time.ts",
@@ -32903,7 +33143,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.161.0'",
+          "default": "'0.162.1'",
           "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."
         }
       ],
@@ -33463,6 +33703,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.161.0"
+    "version": "0.162.1"
   }
 }

package/dist/controllers/upgrade-controller/upgrade-controller.d.ts

@@ -0,0 +1,47 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/** Where an `UpgradeController` looks for children that have not upgraded. */
+export interface UpgradeOptions {
+    /**
+     * Whether to look through every descendant. Off, it looks at the host's own
+     * children. Turn it on for a host that finds its items inside wrappers, as a
+     * radio group does.
+     */
+    subtree?: boolean;
+}
+/**
+ * Calls back when a child that had not upgraded is defined.
+ *
+ * **A host that knows its children by their class does not know a child that
+ * has not upgraded.** `instanceof` is false for it and a marker its class sets,
+ * such as `isNotification`, is missing. An upgrade changes no child list and no
+ * slot assignment, so neither a `MutationObserver` nor `slotchange` reports it,
+ * and the host keeps the answer it read before. Measured on the notification
+ * feed: a row added while its definition was still loading was drawn nowhere,
+ * and the feed showed its empty line over it. A listbox did not select an
+ * option its `default-value` named, and a tree gave a late item no level.
+ *
+ * This happens wherever a child's definition loads after the host's: a page
+ * that adds children before its scripts finish, or a bundle that defines the
+ * host first.
+ *
+ * It looks when the host connects and at each child added after, and waits on
+ * `customElements.whenDefined` once for each name. `define` upgrades the
+ * elements in the document before that promise resolves, so the children have
+ * their class by the time the callback runs. The callback is the host's own
+ * resync, such as its `slotchange` handler, and is `requestUpdate` unless given
+ * something else to do. Watches from connection to disconnection.
+ */
+export declare class UpgradeController implements ReactiveController {
+    private readonly host;
+    private readonly upgraded;
+    private watcher;
+    /** The names already waited on, so each is waited on once. */
+    private readonly waiting;
+    private readonly subtree;
+    constructor(host: ReactiveControllerHost & Element, upgraded?: () => void, options?: UpgradeOptions);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /** Waits on `element`, where it was added, and on what it holds where the subtree counts. */
+    private look;
+    private wait;
+}

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

@@ -0,0 +1,53 @@
+export class UpgradeController {
+    constructor(host, upgraded = () => host.requestUpdate(), options = {}) {
+        this.host = host;
+        this.upgraded = upgraded;
+        this.watcher = undefined;
+        this.waiting = new Set();
+        this.subtree = options.subtree ?? false;
+        host.addController(this);
+    }
+    hostConnected() {
+        if (typeof MutationObserver === 'undefined' || typeof customElements === 'undefined') {
+            return;
+        }
+        this.look(this.host, false);
+        this.watcher ??= new MutationObserver((records) => {
+            for (const record of records) {
+                for (const node of record.addedNodes) {
+                    if (node.nodeType === Node.ELEMENT_NODE) {
+                        this.look(node, true);
+                    }
+                }
+            }
+        });
+        this.watcher.observe(this.host, { childList: true, subtree: this.subtree });
+    }
+    hostDisconnected() {
+        this.watcher?.disconnect();
+    }
+    look(element, added) {
+        if (added) {
+            this.wait(element);
+        }
+        const inside = this.subtree
+            ? element.querySelectorAll('*')
+            : element === this.host
+                ? element.children
+                : [];
+        for (const child of inside) {
+            this.wait(child);
+        }
+    }
+    wait(element) {
+        const name = element.localName;
+        if (!name.includes('-') || this.waiting.has(name) || customElements.get(name) !== undefined) {
+            return;
+        }
+        this.waiting.add(name);
+        void customElements.whenDefined(name).then(() => {
+            this.waiting.delete(name);
+            this.upgraded();
+        });
+    }
+}

package/dist/events/details.d.ts

@@ -441,6 +441,16 @@ export interface AuraFallbackDetail {
      */
     reason: 'lost' | 'software' | 'unavailable';
 }
+/** Detail carried by `helix-strands-fallback`. */
+export interface StrandsFallbackDetail {
+    /**
+     * Why the gradient shows: `software` for a renderer that draws on the CPU,
+     * `unavailable` for no WebGL or a program the browser refused, and `lost`
+     * for a context the browser took back, on a GPU reset or past its limit of
+     * about sixteen.
+     */
+    reason: 'lost' | 'software' | 'unavailable';
+}
 /** Detail carried by `helix-range-change`. */
 export interface RangeDetail {
     /** The index of the first item on screen. */

package/dist/events/events.d.ts

@@ -114,13 +114,14 @@ import { HelixShortcutEvent } from './shortcut.js';
 import { HelixSortEvent } from './sort.js';
 import { HelixSortedEvent } from './sorted.js';
 import { HelixSplitEvent } from './split.js';
+import { HelixStrandsFallbackEvent } from './strands-fallback.js';
 import { HelixToggleEvent } from './toggle.js';
 import { HelixTourAskEvent } from './tour-ask.js';
 import { HelixTourStatusEvent } from './tour-status.js';
 import { HelixTypingEvent } from './typing.js';
-export type { ActivateDetail, AuraFallbackDetail, BandDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DismissDetail, FacetDetail, FilterDetail, GraphFilterDetail, GraphLayoutDetail, GraphPartChangeDetail, GraphSignalDetail, MapClusterDetail, MapPanDetail, MapPartChangeDetail, MapRotateDetail, MapTiltDetail, MapZoomDetail, MoveDetail, NavigateDetail, OpenDetail, PressDetail, PressPointerType, RangeDetail, ReadDetail, ReadingDetail, ReconnectDetail, Refusal, RefusedFile, RejectDetail, RelabelDetail, RemoveDetail, ReorderDetail, ResizeDetail, ScrolledDetail, SelectDetail, SendDetail, ShortcutDetail, SkipDetail, SortDetail, ToggleDetail, TourAskDetail, TourStatusDetail, TypingDetail, ViewportPanDetail, ViewportZoomDetail, } from './details.js';
+export type { ActivateDetail, AuraFallbackDetail, BandDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DismissDetail, FacetDetail, FilterDetail, GraphFilterDetail, GraphLayoutDetail, GraphPartChangeDetail, GraphSignalDetail, MapClusterDetail, MapPanDetail, MapPartChangeDetail, MapRotateDetail, MapTiltDetail, MapZoomDetail, MoveDetail, NavigateDetail, OpenDetail, PressDetail, PressPointerType, RangeDetail, ReadDetail, ReadingDetail, ReconnectDetail, Refusal, RefusedFile, RejectDetail, RelabelDetail, RemoveDetail, ReorderDetail, ResizeDetail, ScrolledDetail, SelectDetail, SendDetail, ShortcutDetail, SkipDetail, SortDetail, StrandsFallbackDetail, ToggleDetail, TourAskDetail, TourStatusDetail, TypingDetail, ViewportPanDetail, ViewportZoomDetail, } from './details.js';
 export { helixEventNames } from './names.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
 /**
  * Every event class, and the one place a new one is registered: a class in a
  * module of its own, imported above, and named here and in `names.ts`.
@@ -220,6 +221,7 @@ declare const registry: {
     readonly HelixSortEvent: typeof HelixSortEvent;
     readonly HelixSortedEvent: typeof HelixSortedEvent;
     readonly HelixSplitEvent: typeof HelixSplitEvent;
+    readonly HelixStrandsFallbackEvent: typeof HelixStrandsFallbackEvent;
     readonly HelixToggleEvent: typeof HelixToggleEvent;
     readonly HelixTourAskEvent: typeof HelixTourAskEvent;
     readonly HelixTourStatusEvent: typeof HelixTourStatusEvent;

package/dist/events/events.js

@@ -84,12 +84,13 @@ import { HelixShortcutEvent } from './shortcut.js';
 import { HelixSortEvent } from './sort.js';
 import { HelixSortedEvent } from './sorted.js';
 import { HelixSplitEvent } from './split.js';
+import { HelixStrandsFallbackEvent } from './strands-fallback.js';
 import { HelixToggleEvent } from './toggle.js';
 import { HelixTourAskEvent } from './tour-ask.js';
 import { HelixTourStatusEvent } from './tour-status.js';
 import { HelixTypingEvent } from './typing.js';
 export { helixEventNames } from './names.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
 const registry = {
     HelixActionEvent,
     HelixActivateEvent,
@@ -177,6 +178,7 @@ const registry = {
     HelixSortEvent,
     HelixSortedEvent,
     HelixSplitEvent,
+    HelixStrandsFallbackEvent,
     HelixToggleEvent,
     HelixTourAskEvent,
     HelixTourStatusEvent,

package/dist/events/names.js

@@ -9,6 +9,6 @@ export const helixEventNames = new Set(('action activate aura-fallback band befo
     'preview previous range-change read reading-change reading-press reconnect reject ' +
     'relabel remove reorder ' +
     'reordered resize resized sample-end sample-start scrolled select selected send ' +
-    'shortcut sort sorted split toggle tour-ask tour-status typing')
+    'shortcut sort sorted split strands-fallback toggle tour-ask tour-status typing')
     .split(' ')
     .map((name) => `helix-${name}`));

package/dist/events/strands-fallback.d.ts

@@ -0,0 +1,13 @@
+import type { StrandsFallbackDetail } from './details.js';
+/**
+ * A strands element stopped drawing its ribbon and shows its gradient, and
+ * says why.
+ *
+ * Sent each time it falls back, from the element, which then matches
+ * `:state(fallback)` until it draws again. Not cancelable: there is nothing
+ * left to refuse.
+ */
+export declare class HelixStrandsFallbackEvent extends CustomEvent<StrandsFallbackDetail> {
+    static readonly eventName = "helix-strands-fallback";
+    constructor(detail: StrandsFallbackDetail);
+}

package/dist/events/strands-fallback.js

@@ -0,0 +1,11 @@
+export class HelixStrandsFallbackEvent extends CustomEvent {
+    static { this.eventName = 'helix-strands-fallback'; }
+    constructor(detail) {
+        super(HelixStrandsFallbackEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}

package/dist/index.d.ts

@@ -31,9 +31,10 @@ export { SourceController, type SourceHost, } from './controllers/source-control
 export { drawStatus, type SayOptions, StatusController, } from './controllers/status-controller/status-controller.js';
 export { SwipeController, type SwipeOptions, } from './controllers/swipe-controller/swipe-controller.js';
 export { type TokenColor, TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
+export { UpgradeController, type UpgradeOptions, } from './controllers/upgrade-controller/upgrade-controller.js';
 export { type Rendered, VirtualizeController, type VirtualizeOptions, type Window as VirtualizeWindow, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { type ActivateDetail, type AuraFallbackDetail, type BandDetail, type CanvasView, type CaretDetail, type ChangeDetail, type CompleteDetail, type ConnectDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, type GraphFilterDetail, type GraphLayoutDetail, type GraphPartChangeDetail, type GraphSignalDetail, HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type PressDetail, type PressPointerType, type RangeDetail, type ReadDetail, type ReadingDetail, type ReconnectDetail, type Refusal, type RefusedFile, type RejectDetail, type RelabelDetail, type RemoveDetail, type ReorderDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type ToggleDetail, type TourStatusDetail, type TypingDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
+export { type ActivateDetail, type AuraFallbackDetail, type BandDetail, type CanvasView, type CaretDetail, type ChangeDetail, type CompleteDetail, type ConnectDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, type GraphFilterDetail, type GraphLayoutDetail, type GraphPartChangeDetail, type GraphSignalDetail, HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type PressDetail, type PressPointerType, type RangeDetail, type ReadDetail, type ReadingDetail, type ReconnectDetail, type Refusal, type RefusedFile, type RejectDetail, type RelabelDetail, type RemoveDetail, type ReorderDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type StrandsFallbackDetail, type ToggleDetail, type TourStatusDetail, type TypingDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { MixinChartSource, type MixinChartSourceInterface, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, POSITION_LABEL, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';
@@ -77,6 +78,7 @@ export { type DrawDismissOptions, drawDismiss, drawDismissGlyph, } from './utils
 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 { 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';
 export { type ElementByIdOptions, elementById, searchableById, } from './utils/element-by-id/element-by-id.js';
 export { exportParts } from './utils/export-parts/export-parts.js';

package/dist/index.js

@@ -31,9 +31,10 @@ export { SourceController, } from './controllers/source-controller/source-contro
 export { drawStatus, StatusController, } from './controllers/status-controller/status-controller.js';
 export { SwipeController, } from './controllers/swipe-controller/swipe-controller.js';
 export { TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
+export { UpgradeController, } from './controllers/upgrade-controller/upgrade-controller.js';
 export { VirtualizeController, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, } from './events/events.js';
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { MixinChartSource, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, POSITION_LABEL, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';
@@ -77,6 +78,7 @@ export { drawDismiss, drawDismissGlyph, } from './utils/draw-dismiss/draw-dismis
 export { drawIcon } from './utils/draw-icon/draw-icon.js';
 export { CHART_PLOT, drawTooltip } from './utils/draw-tooltip/draw-tooltip.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';
 export { elementById, searchableById, } from './utils/element-by-id/element-by-id.js';
 export { exportParts } from './utils/export-parts/export-parts.js';

package/dist/utils/draws-in-software/draws-in-software.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Whether WebGL here is drawn on the CPU, asked before one is drawn into.
+ *
+ * Shared by the elements that draw a decorative field with WebGL, `Aura` and
+ * `Strands`, which take their gradient on a software renderer rather than pay
+ * for a shader nobody can see at speed.
+ *
+ * **The shader costs what a GPU makes it cheap to ask for.** Measured on Aura,
+ * 15 Sep 2026: on Metal the browser shares the compiled program and each aura
+ * after the first draws its opening frame in about 2ms, while under SwiftShader
+ * nothing is shared and each one compiles the pipeline again for about 450ms.
+ * On a page of 720 pixel auras the worst frame gap went 568ms to 50ms with one
+ * aura, 1626ms to 34ms with three and 3200ms to 42ms with six once this check
+ * was in place, and a page of three or six ran at 13 frames a second before and
+ * at the display's own rate after.
+ *
+ * **The unmasked name is the only one that answers.** `gl.RENDERER` is masked
+ * to `WebKit WebGL` on Chromium, the same string on SwiftShader and on Metal,
+ * and `WEBGL_debug_renderer_info` is what lifts the mask.
+ *
+ * **An unreadable renderer draws**, which is the safe direction and not the
+ * tidy one. The extension is optional and is withheld deliberately: Firefox's
+ * `privacy.resistFingerprinting` and Safari's equivalent both drop it, and a
+ * browser may drop it at any time, since a GPU name is a fingerprinting
+ * surface. Treating "we cannot tell" as software would take the shader away
+ * from every reader on a machine that hides its hardware, which is a real GPU
+ * far more often than not.
+ *
+ * **A probe context of its own, and given straight back.** Asking the caller's
+ * own canvas would spend it, and the probe has to release what it took or a
+ * page of fields runs the browser into its cap of about sixteen contexts. One
+ * pixel by one, and released through `WEBGL_lose_context`.
+ *
+ * **The same attributes the real context asks for**, because they are part of
+ * the question: `powerPreference` can select a different adapter, so a probe
+ * asking for a high-performance context would name a GPU the drawing one is
+ * never given.
+ *
+ * **Asked per context rather than once for the page.** The answer is not fixed:
+ * a GPU process that crashes takes the page down to SwiftShader for the rest of
+ * its life, and a field rebuilding after that should get the current answer. It
+ * costs a context creation and two calls, about 2ms, once per context.
+ *
+ * @param attributes What the caller's drawing context asks for.
+ * @returns `true` only when the renderer names itself as one that draws on the
+ *   CPU. No WebGL at all, or a name it cannot read, answers `false`.
+ */
+export declare function drawsInSoftware(attributes: WebGLContextAttributes): boolean;

package/dist/utils/draws-in-software/draws-in-software.js

@@ -0,0 +1,14 @@
+const SOFTWARE_RENDERER = /swiftshader|llvmpipe|softpipe|software rasterizer|basic render/i;
+export function drawsInSoftware(attributes) {
+    const probe = document.createElement('canvas');
+    probe.width = 1;
+    probe.height = 1;
+    const gl = probe.getContext('webgl2', attributes);
+    if (!gl) {
+        return false;
+    }
+    const debug = gl.getExtension('WEBGL_debug_renderer_info');
+    const name = debug ? gl.getParameter(debug.UNMASKED_RENDERER_WEBGL) : null;
+    gl.getExtension('WEBGL_lose_context')?.loseContext();
+    return typeof name === 'string' && SOFTWARE_RENDERER.test(name);
+}

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

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.161.0';
+export const VERSION = '0.162.1';

package/package.json

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