@fusion.dev/helix-core 0.160.0 → 0.162.0

package/custom-elements.json

@@ -5977,6 +5977,25 @@
               },
               "description": "Whether the reader is scrolling: a finger is on the box, the box moved\nwithin the last 150 milliseconds, or it has moved and its `scroll` event\nhas not arrived yet.\n\nFor a host that holds its own reader: a write to the scroll offset while\nthis is true ends a fling on iOS, and a reader position noted before the\nlast move is out of date."
             },
+            {
+              "kind": "method",
+              "name": "noteClamp",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "box",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Takes the offset as the box's own where the box moved it up only because\nthe set below it got shorter, which the browser does to keep the offset\ninside the content, and answers where it was before.\n\n**Not a reader scrolling.** Rows at the end of the set measured shorter\nthan their estimates shrink the content, and the box pulls its offset back\nto the new bottom before any `scroll` event arrives. Read as a scroll, the\ndifference went into the spacer as drift and was then paid a second time:\nin Chromium, End on 2,000 rows of one to five lines left the window 292\npixels above the last item, which stayed drawn below the box as the row\nholding focus."
+            },
             {
               "kind": "field",
               "name": "rest",
@@ -6091,6 +6110,17 @@
               },
               "description": "How tall one item is on the straight line: the drawn rows' height once\nread, and `estimate` until then.\n\n**An estimate that is wrong on the straight line leaves the end of the\nset out of reach.** Rows of 21 pixels placed at 32 fill two thirds of the\nroom they are counted for, so the window stops short of the bottom of the\nbox and the spacer after it holds the rest: in Chromium, `scrollToIndex`\non the last of 5,000 such rows scrolled to the end and drew nothing there.\nReading the drawn rows once corrects the slope, and it is still a line."
             },
+            {
+              "kind": "method",
+              "name": "gap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "description": "The space the host draws between two items, which each item counts."
+            },
             {
               "kind": "method",
               "name": "sampleRows",
@@ -8107,6 +8137,14 @@
             "module": "./details.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "StrandsFallbackDetail",
+          "declaration": {
+            "name": "StrandsFallbackDetail",
+            "module": "./details.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ToggleDetail",
@@ -8851,6 +8889,14 @@
             "module": "src/events/events.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixStrandsFallbackEvent",
+          "declaration": {
+            "name": "HelixStrandsFallbackEvent",
+            "module": "src/events/events.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixToggleEvent",
@@ -9731,7 +9777,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."
         }
       ],
@@ -10848,6 +10894,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",
@@ -13857,6 +13941,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixStrandsFallbackEvent",
+          "declaration": {
+            "name": "HelixStrandsFallbackEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixToggleEvent",
@@ -14113,6 +14205,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "StrandsFallbackDetail",
+          "declaration": {
+            "name": "StrandsFallbackDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ToggleDetail",
@@ -15265,6 +15365,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",
@@ -18483,9 +18591,16 @@
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "cause",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ],
-              "description": "Requests a new current item, and returns whether the change was applied."
+              "description": "Requests a new current item, and returns whether the change was applied.\n`cause` says why, where the family names its causes, and reaches\n`helix-before-activate` as `detail.cause`."
             },
             {
               "kind": "method",
@@ -18557,9 +18672,16 @@
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "cause",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ],
-              "description": "Requests a new current item, and returns whether the change was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-activate` is\na refusal and nothing moves. Unlike a native control, nothing has moved\nby the time this runs, so refusing is simply not writing: there is\nnothing to put back. Nobody refusing means the set updates itself,\nwhether or not a consumer declared `active`, a declared property being a\nseed and a correction."
+              "description": "Requests a new current item, and returns whether the change was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-activate` is\na refusal and nothing moves. Unlike a native control, nothing has moved\nby the time this runs, so refusing is simply not writing: there is\nnothing to put back. Nobody refusing means the set updates itself,\nwhether or not a consumer declared `active`, a declared property being a\nseed and a correction. `cause` says why, where the family names its\ncauses, and reaches the event as `detail.cause`."
             },
             {
               "kind": "method",
@@ -26940,6 +27062,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",
@@ -32859,7 +33016,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.160.0'",
+          "default": "'0.162.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."
         }
       ],
@@ -33419,6 +33576,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.160.0"
+    "version": "0.162.0"
   }
 }

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

@@ -7,6 +7,12 @@ export interface VirtualizeOptions {
     count: () => number;
     /** How tall one item is along the scroll axis, in pixels. */
     estimate: () => number;
+    /**
+     * The space between two items along the scroll axis, in pixels, which the
+     * host draws, such as a flex or grid `gap`. Each item counts it as part of
+     * its own size. Zero by default.
+     */
+    gap?: () => number;
     /**
      * Rows kept either side of what fits, so a scroll reveals something drawn
      * rather than something blank. Four by default.
@@ -213,6 +219,20 @@ export declare class VirtualizeController implements ReactiveController {
      * last move is out of date.
      */
     scrolling(): boolean;
+    /**
+     * Takes the offset as the box's own where the box moved it up only because
+     * the set below it got shorter, which the browser does to keep the offset
+     * inside the content, and answers where it was before.
+     *
+     * **Not a reader scrolling.** Rows at the end of the set measured shorter
+     * than their estimates shrink the content, and the box pulls its offset back
+     * to the new bottom before any `scroll` event arrives. Read as a scroll, the
+     * difference went into the spacer as drift and was then paid a second time:
+     * in Chromium, End on 2,000 rows of one to five lines left the window 292
+     * pixels above the last item, which stayed drawn below the box as the row
+     * holding focus.
+     */
+    private noteClamp;
     /** Squares the spacer and the scroll offset once the box is still. */
     private readonly rest;
     /**
@@ -264,6 +284,8 @@ export declare class VirtualizeController implements ReactiveController {
      * Reading the drawn rows once corrects the slope, and it is still a line.
      */
     private line;
+    /** The space the host draws between two items, which each item counts. */
+    private gap;
     /**
      * Reads the drawn rows' height once for the straight line, for a host that
      * offers `rows` and does not measure.

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

@@ -17,7 +17,11 @@ export class VirtualizeController {
         this.touching = false;
         this.uneven = false;
         this.handleScroll = () => {
-            const top = this.options.container()?.scrollTop ?? 0;
+            const box = this.options.container();
+            if (box) {
+                this.noteClamp(box);
+            }
+            const top = box?.scrollTop ?? 0;
             if (top !== this.lastTop) {
                 this.heading = top > this.lastTop ? 1 : -1;
                 this.lastTop = top;
@@ -95,6 +99,15 @@ export class VirtualizeController {
             this.resting !== undefined ||
             (this.options.container()?.scrollTop ?? this.lastTop) !== this.lastTop);
     }
+    noteClamp(box) {
+        const was = this.lastTop;
+        if (!this.touching &&
+            box.scrollTop < was &&
+            box.scrollTop >= box.scrollHeight - box.clientHeight - 1) {
+            this.lastTop = box.scrollTop;
+        }
+        return was;
+    }
     square() {
         const box = this.options.container();
         if (this.drift > 0 && box) {
@@ -161,7 +174,10 @@ export class VirtualizeController {
     }
     line() {
         const estimate = Math.max(1, this.options.estimate());
-        return this.sample?.estimate === estimate ? this.sample.size : estimate;
+        return this.sample?.estimate === estimate ? this.sample.size : estimate + this.gap();
+    }
+    gap() {
+        return Math.max(0, this.options.gap?.() ?? 0);
     }
     sampleRows() {
         const estimate = Math.max(1, this.options.estimate());
@@ -176,7 +192,7 @@ export class VirtualizeController {
         const uneven = Math.max(...seen) - Math.min(...seen) > 1;
         if (this.sample?.estimate !== estimate) {
             const was = this.line();
-            const size = Math.max(1, seen.reduce((sum, height) => sum + height, 0) / seen.length);
+            const size = Math.max(1, seen.reduce((sum, height) => sum + height, 0) / seen.length) + this.gap();
             this.sample = { estimate, size };
             if (Math.abs(size - was) >= 0.5) {
                 const box = this.options.container();
@@ -291,12 +307,13 @@ export class VirtualizeController {
         }
         const total = Math.max(0, this.options.count());
         const box = this.options.container();
+        const from = box ? this.noteClamp(box) : this.lastTop;
         const top = box ? this.offset(box) : 0;
         const anchor = this.target ?? this.heights.indexAt(top, total);
         const was = this.heights.before(anchor, total);
         let news = false;
         for (const { element, index } of rows) {
-            if (this.heights.record(index, element.getBoundingClientRect().height)) {
+            if (this.heights.record(index, element.getBoundingClientRect().height + this.gap())) {
                 news = true;
             }
         }
@@ -310,7 +327,7 @@ export class VirtualizeController {
                 this.drift -= moved;
             }
             else {
-                box.scrollTop += moved;
+                box.scrollTop = from + moved;
                 this.lastTop = box.scrollTop;
             }
         }

package/dist/events/details.d.ts

@@ -258,6 +258,12 @@ export interface TourAskDetail {
  * that `event.target` does not.
  */
 export interface ChangeDetail {
+    /**
+     * Why the change was asked for, where a family names its causes. Video
+     * Playlist sends `ended`, `next`, `press`, `previous`, and `removed` on
+     * `helix-before-activate`.
+     */
+    cause?: string;
     /** The value after the change. */
     value: string;
 }
@@ -435,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

@@ -33,7 +33,7 @@ export { SwipeController, type SwipeOptions, } from './controllers/swipe-control
 export { type TokenColor, TokenColorController, } from './controllers/token-color-controller/token-color-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 +77,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

@@ -33,7 +33,7 @@ export { SwipeController, } from './controllers/swipe-controller/swipe-controlle
 export { TokenColorController, } from './controllers/token-color-controller/token-color-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 +77,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/mixins/mixin-controller-active/mixin-controller-active.d.ts

@@ -21,8 +21,12 @@ export declare class MixinControllerActiveInterface {
      * is written.
      */
     defaultActive: string;
-    /** Requests a new current item, and returns whether the change was applied. */
-    requestActive(next: string): boolean;
+    /**
+     * Requests a new current item, and returns whether the change was applied.
+     * `cause` says why, where the family names its causes, and reaches
+     * `helix-before-activate` as `detail.cause`.
+     */
+    requestActive(next: string, cause?: string): boolean;
     /**
      * Which item is current, given what there is to choose from.
      *

package/dist/mixins/mixin-controller-active/mixin-controller-active.js

@@ -23,7 +23,7 @@ export const MixinControllerActive = (Base) => {
             this.activeState = next;
             this.requestUpdate('active', previous);
         }
-        requestActive(next) {
+        requestActive(next, cause) {
             if (next === this.active) {
                 return true;
             }
@@ -34,7 +34,7 @@ export const MixinControllerActive = (Base) => {
                     this.activeState = value;
                     this.requestUpdate('active', previous);
                 },
-                event: (value) => new HelixBeforeActivateEvent({ value }),
+                event: (value) => new HelixBeforeActivateEvent(cause === undefined ? { value } : { cause, value }),
                 host: this,
                 next,
             });

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

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.160.0';
+export const VERSION = '0.162.0';

package/package.json

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