@fusion.dev/helix-core 0.150.0 → 0.152.0

package/custom-elements.json

@@ -304,7 +304,7 @@
         },
         {
           "kind": "class",
-          "description": "Which reading a pointer is nearest, for a chart that draws no markers.\n\n**The anchor is a position and not an element, and that is the whole reason\nthis exists.** A bar and a donut slice are elements a tooltip could be hung\non; a line is one `<path>` for a whole series, because\n`preserveAspectRatio=\"none\"` turns a circle into an ellipse and there is no\nvector-effect that answers for a shape, so `LineChart` deliberately draws no\nper-reading marker. Anchoring per datum works for two charts of four and\ncannot be extended to the third, so the resolution is arithmetic instead.\n\n**It maps along one axis only.** The nearest reading to a pointer is decided\nby x alone in a vertical chart, whatever y is doing, because a reader moving\nacross a chart is asking about a column of it rather than about a point. A\ntrue nearest-point search would make a two-series chart answer differently\ndepending on which line the pointer drifted toward, which is a tooltip that\nchanges its mind while the reader holds still.\n\n**Coarse pointers get nothing.** A touch has no hover, so a tooltip driven by\none appears where a finger already covers it and stays after the finger\nlifts. The table underneath is the readable version and is what a phone\nshould be given, so this listens for `pointermove` and ignores anything whose\n`pointerType` is not fine.\n\n**The keyboard moves the same reading, which is what makes it the reading\nand not the pointer's.** A chart's plot takes focus (`tabindex=\"0\"` on the\nelement carrying `CHART_PLOT`), and while it has it the arrow keys walk the\nreadings, Home and End go to the first and the last, PageUp and PageDown\nmove a page of readings, and the other pair of arrows walks the series\nwithin a reading. Escape puts the bubble away, as it\ndoes a tooltip. The tooltip follows because it already follows `at`, and the\nchart's readout, a polite live region `drawTooltip` renders, says the\nreading in words. It speaks only for a key: a pointer crossing a chart is a\nsighted reader looking, and a region speaking on every slot it crossed would\ntalk over everything else on the page.\n\nNo peer charting library ships this, which is the reason it is spelled out\nrather than assumed: the table beside the chart has every number, and this\nis for a reader who wants the picture's own order, a reading at a time.",
+          "description": "Which reading a pointer is nearest, for a chart that draws no markers.\n\n**The anchor is a position and not an element, and that is the whole reason\nthis exists.** A bar and a donut slice are elements a tooltip could be hung\non; a line is one `<path>` for a whole series, because\n`preserveAspectRatio=\"none\"` turns a circle into an ellipse and there is no\nvector-effect that answers for a shape, so `LineChart` deliberately draws no\nper-reading marker. Anchoring per datum works for two charts of four and\ncannot be extended to the third, so the resolution is arithmetic instead.\n\n**It maps along one axis only.** The nearest reading to a pointer is decided\nby x alone in a vertical chart, whatever y is doing, because a reader moving\nacross a chart is asking about a column of it rather than about a point. A\ntrue nearest-point search would make a two-series chart answer differently\ndepending on which line the pointer drifted toward, which is a tooltip that\nchanges its mind while the reader holds still.\n\n**A touch has no hover, so it moves nothing by passing over.** A tooltip\ndriven by a finger dragging across would appear under the finger. So this\nlistens for `pointermove` and ignores anything whose `pointerType` is not\nfine. **A tap is the touch reader's hover**, for a chart that hears its\nreadings through `onReading`: it shows the reading tapped, as Chart.js does,\nand keeps it until a tap lands elsewhere, outside the chart or on another\nreading. A drag that scrolls the page is no tap and shows nothing.\n\n**The keyboard moves the same reading, which is what makes it the reading\nand not the pointer's.** A chart's plot takes focus (`tabindex=\"0\"` on the\nelement carrying `CHART_PLOT`), and while it has it the arrow keys walk the\nreadings, Home and End go to the first and the last, PageUp and PageDown\nmove a page of readings, and the other pair of arrows walks the series\nwithin a reading. Escape puts the bubble away, as it\ndoes a tooltip. The tooltip follows because it already follows `at`, and the\nchart's readout, a polite live region `drawTooltip` renders, says the\nreading in words. It speaks only for a key: a pointer crossing a chart is a\nsighted reader looking, and a region speaking on every slot it crossed would\ntalk over everything else on the page.\n\nNo peer charting library ships this, which is the reason it is spelled out\nrather than assumed: the table beside the chart has every number, and this\nis for a reader who wants the picture's own order, a reading at a time.",
           "name": "ChartPointerController",
           "members": [
             {
@@ -378,6 +378,44 @@
               "default": "'inline'",
               "description": "Which axis the readings are laid out along.\n\n**An axis and not a boolean, because two of the four charts do not use x.**\nA horizontal bar chart runs its categories *down* the box, so resolving\nevery reading from the pointer's x leaves a move from the first row to the\nlast never changing the answer: measured on four rows, all four reported\nthe third, which is the slot the middle of the box falls in. It looks like\na tooltip that will not follow and is a tooltip reading the wrong axis.\n\n`none` is the ring. Its slices are real elements at every angle, so the\nreading under the pointer is the one the pointer is over, and arithmetic on\neither axis would answer with whichever slice shared a coordinate: at three\no'clock and at nine o'clock, x alone gives the same slice for opposite\nsides. The slices call `set` and this only holds the answer."
             },
+            {
+              "kind": "field",
+              "name": "onReading",
+              "type": {
+                "text": "((heard: ReadingHeard, detail: ReadingDetail) => void) | undefined"
+              },
+              "description": "Hears the reading: `change` each time it moves or is put away, and\n`press` when it is clicked, tapped, or pressed with Enter or Space.\n\nSet by a chart that sends `helix-reading-change` and\n`helix-reading-press`, which it does from here so the event classes are\nconstructed in the chart that declares them. A chart that hears its\nreadings also shows one on a tap."
+            },
+            {
+              "kind": "field",
+              "name": "by",
+              "type": {
+                "text": "ReadingDetail['pointerType']"
+              },
+              "privacy": "private",
+              "default": "'mouse'",
+              "description": "What last moved the reading, which `onReading` is told."
+            },
+            {
+              "kind": "field",
+              "name": "said",
+              "type": {
+                "text": "object"
+              },
+              "privacy": "private",
+              "default": "{ at: -1, series: -1 }",
+              "description": "The reading and the series `onReading` was last told of."
+            },
+            {
+              "kind": "field",
+              "name": "tapped",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether a tap shows the reading, which stays until a tap lands elsewhere."
+            },
             {
               "kind": "method",
               "name": "hostConnected",
@@ -483,6 +521,77 @@
               },
               "description": "Tells the tooltip its anchor moved, which nothing else would.\n\nThe mark the tooltip is hung on is one element the chart walks from reading\nto reading with an inline style, and Floating UI's `autoUpdate` watches\nscrolling, resizing and layout shift. Moving an absolutely positioned\nelement by writing `inset` is none of the three, so the bubble is placed\nonce on open and then stays where the first reading was while the mark\ntravels out from under it.\n\nHere rather than in the chart because the reading is this controller's, and\nafter the update rather than in `set` because the mark is still at the old\nposition until the render that follows."
             },
+            {
+              "kind": "method",
+              "name": "announce",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Tells `onReading` the reading moved, once for each move.\n\nAfter the update, from `hostUpdated`, so a listener reading the chart\nfinds it already showing the reading it was told of."
+            },
+            {
+              "kind": "method",
+              "name": "detail",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ReadingDetail"
+                }
+              },
+              "description": "The reading as `onReading` is told it."
+            },
+            {
+              "kind": "method",
+              "name": "tapTo",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "at",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Shows the reading at `at` for a tap, and keeps it until a tap lands\noutside the chart. Public for a chart that finds the reading under a\nfinger itself, a scatter's nearest point."
+            },
+            {
+              "kind": "method",
+              "name": "untap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Stops waiting for a tap elsewhere."
+            },
+            {
+              "kind": "field",
+              "name": "away",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press outside the chart puts a tapped reading away."
+            },
+            {
+              "kind": "field",
+              "name": "tap",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "press",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Tells `onReading` a reading was clicked or tapped, where the press landed\non the plot and a reading is shown."
+            },
             {
               "kind": "method",
               "name": "box",
@@ -588,6 +697,25 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "resolve",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "PointerEvent"
+                  }
+                }
+              ],
+              "description": "The reading a pointer is over, by the slot it is in along `axis`, or\n`undefined` with nothing to measure."
+            },
             {
               "kind": "field",
               "name": "move",
@@ -7830,6 +7958,14 @@
             "module": "./details.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadingDetail",
+          "declaration": {
+            "name": "ReadingDetail",
+            "module": "./details.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ReconnectDetail",
@@ -8526,6 +8662,22 @@
             "module": "src/events/events.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixReadingChangeEvent",
+          "declaration": {
+            "name": "HelixReadingChangeEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixReadingPressEvent",
+          "declaration": {
+            "name": "HelixReadingPressEvent",
+            "module": "src/events/events.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixReconnectEvent",
@@ -9550,7 +9702,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 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 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."
         }
       ],
@@ -9907,6 +10059,82 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/events/reading-change.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A chart moved to a reading, or put its reading away: a pointer crossed into\none, a tap or a key landed on one, or the pointer left. Chart.js's\n`onHover`.\n\nSent once for each change, never for a pointer moving within the reading it\nis already on. `index` is `-1` once no reading is shown. Not cancelable,\nsince the chart has already moved. Bubbles and is composed.",
+          "name": "HelixReadingChangeEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-reading-change'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/reading-change.ts"
+          },
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixReadingChangeEvent",
+          "declaration": {
+            "name": "HelixReadingChangeEvent",
+            "module": "src/events/reading-change.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/events/reading-press.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A reading of a chart was pressed: clicked, tapped, or Enter or Space on the\nplot while the keys rest on it. Chart.js's `onClick`.\n\nFor a page that opens what a reading stands for, such as the month behind a\ncolumn. Not cancelable, since a chart does nothing of its own on a press.\nBubbles and is composed.",
+          "name": "HelixReadingPressEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-reading-press'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/reading-press.ts"
+          },
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixReadingPressEvent",
+          "declaration": {
+            "name": "HelixReadingPressEvent",
+            "module": "src/events/reading-press.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/events/reconnect.ts",
@@ -12104,6 +12332,14 @@
             "module": "./controllers/chart-pointer-controller/chart-pointer-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadingHeard",
+          "declaration": {
+            "name": "ReadingHeard",
+            "module": "./controllers/chart-pointer-controller/chart-pointer-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ChildrenController",
@@ -13432,6 +13668,22 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixReadingChangeEvent",
+          "declaration": {
+            "name": "HelixReadingChangeEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixReadingPressEvent",
+          "declaration": {
+            "name": "HelixReadingPressEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixReconnectEvent",
@@ -13712,6 +13964,14 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadingDetail",
+          "declaration": {
+            "name": "ReadingDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ReconnectDetail",
@@ -14856,6 +15116,14 @@
             "module": "./utils/draw-tooltip/draw-tooltip.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "drawValueAxis",
+          "declaration": {
+            "name": "drawValueAxis",
+            "module": "./utils/draw-value-axis/draw-value-axis.js"
+          }
+        },
         {
           "kind": "js",
           "name": "elapsedTime",
@@ -15432,6 +15700,14 @@
             "module": "./utils/read-color/read-color.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ColorBytesAlpha",
+          "declaration": {
+            "name": "ColorBytesAlpha",
+            "module": "./utils/read-color/read-color.js"
+          }
+        },
         {
           "kind": "js",
           "name": "readColor",
@@ -15440,6 +15716,14 @@
             "module": "./utils/read-color/read-color.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "readColorAlpha",
+          "declaration": {
+            "name": "readColorAlpha",
+            "module": "./utils/read-color/read-color.js"
+          }
+        },
         {
           "kind": "js",
           "name": "rgbOf",
@@ -17498,6 +17782,15 @@
               "privacy": "protected",
               "description": "News the component has for the live region while there are rows and nothing is loading."
             },
+            {
+              "kind": "field",
+              "name": "statusSlots",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether the status line is an `empty` or `loading` slot, with the text as\nits fallback. A family that turns it on documents the two slots."
+            },
             {
               "kind": "method",
               "name": "countRows",
@@ -17704,6 +17997,16 @@
               "privacy": "protected",
               "default": "''",
               "description": "What the region says while there are rows and nothing is loading, which\nis nothing unless the component has news of its own.\n\n**One region, so two messages never talk over each other.** Data Table\nsays a sort and a selection here; a second `role=\"status\"` beside this\none would be heard in whichever order the reader happens to queue them.\nLoading and empty win, being the larger news. Set before the render that\nshows it, in `willUpdate`, and not reactive: it changes only when\nsomething else already asked for a render."
+            },
+            {
+              "kind": "field",
+              "name": "statusSlots",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "default": "false",
+              "description": "Whether the status line is an `empty` or `loading` slot, with\n`empty-text` or `loading-text` as its fallback.\n\n**Off unless a family turns it on**, because a slot is published API:\neach family that renders one documents it in its own manifest. The live\nregion keeps saying the text either way, because a slotted picture has no\nwords to say."
             }
           ],
           "attributes": [
@@ -23913,7 +24216,7 @@
               }
             }
           ],
-          "description": "The labels of a chord's keys on a platform, with `own` labels in place of\nthe platform's, and what goes between two keys.\n\n`parts` are the chord's names as `chordParts` splits them. A name `own`\nholds takes that label, a name the platform knows takes its glyph or word,\nand any other single character is shown in capitals.\n\n**On an Apple keyboard glyphs run together and words are joined with a\nhyphen**, as Apple writes `Command-K`. A label of more than one character\nfrom `own` is a word, so `{\"mod\": \"Command\"}` shows `Command-K` there, where\nnothing between the two ran them into `CommandK`. The platform's own `Esc`\nand `Space` keep running on from a glyph, as `⌘Esc` always has. Everywhere\nelse keys are joined with `+`."
+          "description": "The labels of a chord's keys on a platform, with `own` labels in place of\nthe platform's, and what goes between two keys.\n\n`parts` are the chord's names as `chordParts` splits them. A name `own`\nholds takes that label, a name the platform knows takes its glyph or word,\nand any other single character is shown in capitals. **Modifiers come first,\nin the platform's order**, so one `keys` value is right on every platform:\n`mod+shift+p` is `⇧⌘P` on an Apple keyboard and `Ctrl+Shift+P` elsewhere.\n\n**On an Apple keyboard glyphs run together and words are joined with a\nhyphen**, as Apple writes `Command-K`. A label of more than one character\nfrom `own` is a word, so `{\"mod\": \"Command\"}` shows `Command-K` there, where\nnothing between the two ran them into `CommandK`. The platform's own `Esc`\nand `Space` keep running on from a glyph, as `⌘Esc` always has. Everywhere\nelse keys are joined with `+`.\n\n`spoken` says the chord in words where a label is one of the platform's\nglyphs, such as `⌘` or `↑`, which a screen reader reads as a symbol or\nskips. A label from `own` is taken as words already."
         }
       ],
       "exports": [
@@ -25671,6 +25974,62 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/draw-value-axis/draw-value-axis.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "drawValueAxis",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "domain",
+              "type": {
+                "text": "readonly [number, number]"
+              },
+              "description": "The scale's lowest and highest values."
+            },
+            {
+              "name": "place",
+              "type": {
+                "text": "(value: number) => number"
+              },
+              "description": "Where a value sits down the plot, from 0 at the top to 100 at the bottom."
+            },
+            {
+              "name": "format",
+              "type": {
+                "text": "(value: number) => string"
+              },
+              "description": "How a value is written, such as a number in the chart's locale."
+            },
+            {
+              "name": "width",
+              "type": {
+                "text": "(widest: number) => string"
+              },
+              "description": "The style the axis carries, from the number of characters in its widest number."
+            }
+          ],
+          "description": "The numbers of a chart's value scale, beside its drawing: an `axis` part\nholding a `tick` part at each level `ticks` picks, which are the levels\n`gridlines` rules.\n\nHTML beside the plot, for the reason a chart's reading names are: text\ninside an `<svg>` that fills its box scales with the box. Each tick is placed\nwith `inset-block-start`, as a percentage of the axis, so a stylesheet that\nmakes the axis as tall as the plot puts each number on its level.\n\n`width` builds the axis's style from the number of characters in its widest\nnumber. The ticks are positioned absolutely and give the column no width of\ntheir own, so each family writes its own custom property there, such as\n`--line-chart-axis` in `ch`, and a stylesheet sizes the column from it."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "drawValueAxis",
+          "declaration": {
+            "name": "drawValueAxis",
+            "module": "src/utils/draw-value-axis/draw-value-axis.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/elapsed-time/elapsed-time.ts",
@@ -27610,6 +27969,49 @@
       "kind": "javascript-module",
       "path": "src/utils/read-color/read-color.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "paintedColor",
+          "return": {
+            "type": {
+              "text": "ColorBytesAlpha | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "context",
+              "type": {
+                "text": "CanvasRenderingContext2D"
+              }
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "`value` painted onto a clear pixel and read back, alpha and all, or nothing\nwhere the engine does not parse it."
+        },
+        {
+          "kind": "function",
+          "name": "readColorAlpha",
+          "return": {
+            "type": {
+              "text": "ColorBytesAlpha | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "A resolved color, as `getComputedStyle` reports one."
+            }
+          ],
+          "description": "A computed color as three sRGB bytes and its alpha, or nothing where it\ncannot be read.\n\n**Painting it is the only way to read it.** A color-typed property is\nresolved before it is reported, but resolved is not the same as converted:\nChrome hands back `lab(100 0 0)` for a token built through `oklab`, and\nscraping the first three numbers out of that and calling them red, green and\nblue made white arrive as `rgb(100, 0, 0)`. In light mode the near dots were\n`lab(0 0 0)`, which scrapes to black and looks right, so only dark mode\nshowed it: dark red mixed toward black, on a near-black ground.\n\n**A value the engine does not parse is refused**, so a caller chooses its\nown fallback rather than being handed a color nobody picked. A see-through\ncolor is read with its alpha: `rgb(255 0 0 / 50%)` is `[255, 0, 0, 0.5]`.\nIt was refused too, when the test for parsing was painting over black and\nover white, and Orb drew it gray.\n\nA readback is not free, so the answer is held against the string it came\nfrom, refusals included. The oldest goes when the store is full rather than\nall of them, or a page deriving colors on a slider pays for every frame\ntwice."
+        },
         {
           "kind": "function",
           "name": "readColor",
@@ -27627,7 +28029,7 @@
               "description": "A resolved color, as `getComputedStyle` reports one."
             }
           ],
-          "description": "A computed color as three sRGB bytes, or nothing where it cannot be read.\n\n**Painting it is the only way to read it.** A color-typed property is\nresolved before it is reported, but resolved is not the same as converted:\nChrome hands back `lab(100 0 0)` for a token built through `oklab`, and\nscraping the first three numbers out of that and calling them red, green and\nblue made white arrive as `rgb(100, 0, 0)`. In light mode the near dots were\n`lab(0 0 0)`, which scrapes to black and looks right, so only dark mode\nshowed it: dark red mixed toward black, on a near-black ground.\n\n**Painted twice, over two different grounds, which is what makes the refusal\nhonest.** Assigning a value the engine will not parse leaves `fillStyle`\nexactly where it was, so a single paint cannot tell a color apart from the\nground it failed to replace. Over black and over white, a value that parsed\ngives the same answer twice and one that did not gives two. A caller then\nchooses its own fallback rather than being handed a color nobody picked,\nwhich is the half both earlier copies of this had to guess at.\n\nA readback is not free, so the answer is held against the string it came\nfrom, refusals included. The oldest goes when the store is full rather than\nall of them, or a page deriving colors on a slider pays for every frame\ntwice."
+          "description": "A computed color as three sRGB bytes, or nothing where it cannot be read or\nis see-through.\n\n`readColorAlpha` is the reading, and this keeps an opaque color only, which\nis what a caller with no use for alpha can draw as it is."
         },
         {
           "kind": "function",
@@ -27650,6 +28052,22 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "paintedColor",
+          "declaration": {
+            "name": "paintedColor",
+            "module": "src/utils/read-color/read-color.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "readColorAlpha",
+          "declaration": {
+            "name": "readColorAlpha",
+            "module": "src/utils/read-color/read-color.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "readColor",
@@ -31463,7 +31881,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.150.0'",
+          "default": "'0.152.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."
         }
       ],
@@ -32023,6 +32441,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.150.0"
+    "version": "0.152.0"
   }
 }