@fusion.dev/helix-core 0.56.1 → 0.58.0

package/custom-elements.json

@@ -457,6 +457,210 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/cue-controller/cue-controller.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "captionTracks",
+          "return": {
+            "type": {
+              "text": "TextTrack[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "media",
+              "type": {
+                "text": "HTMLMediaElement | null"
+              }
+            }
+          ],
+          "description": "The tracks a reader could choose between, in the order they were written.\n\nFiltered by kind, because `textTracks` also carries `chapters`, `metadata`\nand `descriptions`, and a menu offering \"Chapters\" as a subtitle language\nwould be offering something that draws no words. Read off the media element\nrather than off the slot: a `<track>` added later is in one and not the\nother, and the element is the one that has resolved them."
+        },
+        {
+          "kind": "function",
+          "name": "showCaption",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "tracks",
+              "type": {
+                "text": "readonly TextTrack[]"
+              }
+            },
+            {
+              "name": "index",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Shows one track and disables every other, or shows none at `-1`.\n\nEvery other, rather than only the one that was on. Two tracks in `hidden`\nboth fire `cuechange`, so the rendered cue becomes whichever fired last and\na reader who switched language gets the two interleaved. Measured as two\nsubtitles alternating line by line.\n\n`hidden`, never `showing`. Hidden is the mode where a track still fires\n`cuechange` and still fills `activeCues`, and the browser draws nothing,\nwhich is exactly what is wanted when something else is doing the drawing."
+        },
+        {
+          "kind": "function",
+          "name": "adoptTrack",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "track",
+              "type": {
+                "text": "TextTrack"
+              }
+            }
+          ],
+          "description": "Whether a track the platform started showing is now ours to draw.\n\nA `<track default>` arrives `showing`, which is the browser drawing it.\nMoved to `hidden` so the cues keep coming and we draw them instead. What\ncomes back is whether captions are on, which is not always \"off\": a button\nthat began there reported the opposite of what was on screen."
+        },
+        {
+          "kind": "function",
+          "name": "captionsAmong",
+          "return": {
+            "type": {
+              "text": "Caption[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "media",
+              "type": {
+                "text": "readonly TrackCopy[]"
+              }
+            }
+          ],
+          "description": "The caption tracks among the copies, before the render that draws them.\n\nBy the platform's own reading of `kind`, which is what makes a `<track>` a\ncaption at all: missing is `subtitles` and anything it does not know is\n`metadata`. Read from the video's tracks after the render instead, the count\narrived a render late and asked for one more. Choosing one still goes\nthrough the video's tracks, which hold them in the same order."
+        },
+        {
+          "kind": "function",
+          "name": "activeCue",
+          "return": {
+            "type": {
+              "text": "DocumentFragment | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "track",
+              "type": {
+                "text": "TextTrack | undefined"
+              }
+            }
+          ],
+          "description": "The cue on screen now, as nodes, or nothing between cues.\n\nNodes rather than a string, because `VTTCue.text` is the cue's *source*:\nWebVTT carries markup, and a caption file in the wild is full of it. `<v\nHildy>` names who is speaking, `<b>` and `<i>` and `<u>` mark emphasis, and\n`<c.loud>` classes a line. Rendered as text every one of those arrives on\nscreen as visible angle brackets.\n\n`getCueAsHTML` is the platform parsing its own format, so nothing here has\nto know the grammar and no cue text is ever treated as HTML: what comes\nback is a fragment the browser built, not a string anybody interpolated."
+        },
+        {
+          "kind": "class",
+          "description": "Listens to one track's cues at a time, so the next one can take it off.\n\nTaken off whatever it was on before adding it here. `follow` runs from\n`loadedmetadata`, which fires again for every source a reader moves to, and\na consumer adding a `<track>` later gets another. Added without removing, a\nplaylist of six left six listeners on tracks that between them fire for\nevery cue in the video.",
+          "name": "CueController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "track",
+              "type": {
+                "text": "TextTrack | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "follow",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "track",
+                  "type": {
+                    "text": "TextTrack"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "stop",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "captionTracks",
+          "declaration": {
+            "name": "captionTracks",
+            "module": "src/controllers/cue-controller/cue-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "showCaption",
+          "declaration": {
+            "name": "showCaption",
+            "module": "src/controllers/cue-controller/cue-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "adoptTrack",
+          "declaration": {
+            "name": "adoptTrack",
+            "module": "src/controllers/cue-controller/cue-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "captionsAmong",
+          "declaration": {
+            "name": "captionsAmong",
+            "module": "src/controllers/cue-controller/cue-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "activeCue",
+          "declaration": {
+            "name": "activeCue",
+            "module": "src/controllers/cue-controller/cue-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CueController",
+          "declaration": {
+            "name": "CueController",
+            "module": "src/controllers/cue-controller/cue-controller.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/controllers/disabled-cascade-controller/disabled-cascade-controller.ts",
@@ -1016,73 +1220,90 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/controllers/focus-trap-controller/focus-trap-controller.ts",
+      "path": "src/controllers/fullscreen-controller/fullscreen-controller.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Keeps Tab inside a container while it is open, and gives focus back after.\n\nA dialog that does not trap focus is one a keyboard user tabs straight out\nof, into a page they cannot see and cannot get back from. Restoring focus on\nrelease matters just as much: without it, closing a drawer drops the reader\nat the top of the document.\n\nFinding the focusable elements is `focusableElements`, which is a utility\nrather than part of this, because that half is what roving tabindex and\narrow-key navigation need and neither of them traps anything.",
-          "name": "FocusTrapController",
+          "description": "Into fullscreen and back, and honest about where the element is.\n\nThe state follows `fullscreenchange` rather than the request, so a refused\nrequest leaves a button that correctly reports \"not fullscreen\".\n\nThe document, rather than the host, is what the event is read from: the\nplatform fires it at the document whichever element went full, so a host that\nasked and was overruled by another one still hears about it.",
+          "name": "FullscreenController",
           "members": [
             {
-              "kind": "field",
-              "name": "container",
-              "type": {
-                "text": "HTMLElement | null"
-              },
-              "privacy": "private",
-              "default": "null"
-            },
-            {
-              "kind": "field",
-              "name": "frame",
-              "type": {
-                "text": "number | undefined"
-              },
-              "privacy": "private",
-              "description": "The frame waiting to take focus, so a release can call it off."
-            },
-            {
-              "kind": "field",
-              "name": "previous",
-              "type": {
-                "text": "HTMLElement | null"
+              "kind": "method",
+              "name": "toggle",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
               },
-              "privacy": "private",
-              "default": "null"
-            },
-            {
-              "kind": "field",
-              "name": "handleKeydown",
-              "privacy": "private",
-              "readonly": true
+              "description": "Into fullscreen and back, and quiet about being refused.\n\n`requestFullscreen` rejects rather than returning false, and the two\nrefusals a consumer will actually meet are a Permissions Policy that does\nnot grant `fullscreen` to the frame the player is in, and a call without\nuser activation. Both are `TypeError: Permissions check failed`, which is\nthe same message for two different causes.\n\nCaught rather than `void`ed, or a refusal becomes an unhandled rejection\nnaming neither the element nor the reason."
             },
             {
               "kind": "method",
-              "name": "activate",
+              "name": "hostConnected",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              },
-              "parameters": [
-                {
-                  "name": "container",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Starts trapping, remembering where focus came from."
+              }
             },
             {
               "kind": "method",
-              "name": "deactivate",
+              "name": "hostDisconnected",
               "return": {
                 "type": {
                   "text": "void"
                 }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleChange",
+              "privacy": "private",
+              "readonly": true
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "FullscreenController",
+          "declaration": {
+            "name": "FullscreenController",
+            "module": "src/controllers/fullscreen-controller/fullscreen-controller.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/idle-controller/idle-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "How long the reader has been still, which is what an overlay hides itself on.\n\nA wait rather than leaving with the pointer, or a reader moving across a\nsurface to reach a control watches the control vanish under them. The wait is\nonly ever about *idling*: whether anything else keeps the overlay up, a\npaused player or an open menu, is the host's decision, and this only says\nwhen the reader stopped.\n\nThe delay is asked for on every restart rather than taken once, because it\nis a property the consumer can change while the video plays.",
+          "name": "IdleController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "timer",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
               },
-              "description": "Stops trapping and returns focus to wherever it was."
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "stir",
+              "readonly": true,
+              "description": "Restarts the wait, on anything that counts as the reader being here.\n\nPointer movement and focus both count, and both have to: a reader using the\nkeyboard never moves a pointer, and a bar that only answered the mouse\nwould leave them nothing to look at. Zero turns the wait off and the bar\ngoes immediately; a large number keeps it up for as long as anyone is\nlikely to look."
+            },
+            {
+              "kind": "field",
+              "name": "leave",
+              "readonly": true,
+              "description": "Leaving is the one case that does not wait: the reader has gone somewhere\nelse, and there is nothing to reach for."
             },
             {
               "kind": "method",
@@ -1100,10 +1321,10 @@
       "exports": [
         {
           "kind": "js",
-          "name": "FocusTrapController",
+          "name": "IdleController",
           "declaration": {
-            "name": "FocusTrapController",
-            "module": "src/controllers/focus-trap-controller/focus-trap-controller.ts"
+            "name": "IdleController",
+            "module": "src/controllers/idle-controller/idle-controller.ts"
           }
         }
       ]
@@ -1372,6 +1593,99 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/media-session-controller/media-session-controller.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "SKIP_SECONDS",
+          "type": {
+            "text": "number"
+          },
+          "default": "10",
+          "description": "How far a skip control moves, in seconds.\n\nTen, which is the number every player that has one uses, and the number the\nplatform names in `seekbackward` and `seekforward` when it hands over a\ndefault. A different length here would be correct only on this player."
+        },
+        {
+          "kind": "class",
+          "description": "Holds the page's media session for one player, and tells the platform what\nis playing.\n\nThe handlers are what make a headset's play, pause and skip work at all.\nWithout them a platform falls back to guessing which element was meant,\nwhich is right often enough to hide the fault and wrong exactly when there\nare two.",
+          "name": "MediaSessionController",
+          "members": [
+            {
+              "kind": "method",
+              "name": "claim",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "metadata",
+                  "type": {
+                    "text": "{ artwork: string; title: string }"
+                  }
+                },
+                {
+                  "name": "handlers",
+                  "type": {
+                    "text": "SessionHandlers"
+                  }
+                }
+              ],
+              "description": "Takes the session.\n\nOn play rather than on render, which is the ownership rule: a page with two\nplayers gives the session to whichever one the reader started, so a\nheadset's buttons land on what they are listening to rather than on\nwhichever came first in the markup."
+            },
+            {
+              "kind": "method",
+              "name": "report",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "playing",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Tells the platform whether the owner is playing, and nothing if it is not the owner."
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The page's one media session goes back to nobody, but only if this\nelement is the one holding it."
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SKIP_SECONDS",
+          "declaration": {
+            "name": "SKIP_SECONDS",
+            "module": "src/controllers/media-session-controller/media-session-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MediaSessionController",
+          "declaration": {
+            "name": "MediaSessionController",
+            "module": "src/controllers/media-session-controller/media-session-controller.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/controllers/popover-controller/popover-controller.ts",
@@ -1514,6 +1828,90 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/remote-playback-controller/remote-playback-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Watches for something to play the media on, and stops on the way out.\n\nThe Remote Playback API is the standard one, and it is what Safari\nimplements for AirPlay and Chrome for Cast: one call covers both, where the\nolder `webkitShowPlaybackTargetPicker` covers only the first. Firefox has\nneither, and `remote` simply being absent is what turns the control off\nthere.\n\n`watchAvailability` returns an id that has to be canceled, or the callback\noutlives the element that owns it: a callback holding a removed element is a\nleak with a `@state` write on the end.",
+          "name": "RemotePlaybackController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "media",
+              "type": {
+                "text": "HTMLMediaElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "watch",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "description": "Cancels the availability watch, since it outlives a single render."
+            },
+            {
+              "kind": "method",
+              "name": "attach",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "media",
+                  "type": {
+                    "text": "HTMLMediaElement"
+                  }
+                }
+              ],
+              "description": "Starts watching the media element, once there is one."
+            },
+            {
+              "kind": "method",
+              "name": "prompt",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "description": "Opens the platform's own device picker. It has no list of its own."
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleState",
+              "privacy": "private",
+              "readonly": true
+            }
+          ],
+          "helix": {}
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RemotePlaybackController",
+          "declaration": {
+            "name": "RemotePlaybackController",
+            "module": "src/controllers/remote-playback-controller/remote-playback-controller.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/controllers/source-controller/source-controller.ts",
@@ -1697,19 +2095,9 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Reads a design token as the sRGB triple a shader or a 2D canvas can take, and\ntells the host when the palette underneath it moves.\n\n**Two hops, and both are load-bearing.** A custom property's own value is the\nunevaluated function text, so `getComputedStyle` on a probe is the only way\nto see what it resolves to. And what it resolves to is not `rgb()`: the\npalette derives from an `oklch()` seed, and Chrome answers `lab(100 0 0)` for\nwhite. Parsing that with a regular expression for numbers reads the three\nchannels as 100, 0 and 0, which divided by 255 is a dark red.\n\nA screenshot cannot catch that: a warm cast on a saturated gradient is also\nwhat chroma subsampling produces, so the picture agrees with the bug.\n\nThe conversion is therefore the browser's own: fill a pixel and read it back.\nThat holds for `lab()`, `oklch()`, `color-mix()` and whatever a token is\nwritten in next, which is the property worth having in a design system whose\npalette is derived rather than listed.\n\n**A controller and not a mixin**, by this repository's own line: it adds no\nproperty or method a consumer sets. It reacts to lifecycle, holding a probe\nthat has to be created after the host connects and removed when it leaves,\nand it watches for the color mode changing so the host can repaint.\n\n**Client only, and that is the contract rather than a limitation.** There is\nno computed style on a server and no canvas to convert with, so `read`\nanswers the fallback there. Every caller is drawing into a canvas, which does\nnot exist on a server either.",
+          "description": "Reads a design token as the sRGB triple a shader or a 2D canvas can take, and\ntells the host when the palette underneath it moves.\n\n**Two hops, and both are load-bearing.** A custom property's own value is the\nunevaluated function text, so `getComputedStyle` on a probe is the only way\nto see what it resolves to. The second hop is `readColor`, which is shared\nwith every other caller that has a resolved color and needs channels: what it\nresolves to is not `rgb()`, the\npalette derives from an `oklch()` seed, and Chrome answers `lab(100 0 0)` for\nwhite. Parsing that with a regular expression for numbers reads the three\nchannels as 100, 0 and 0, which divided by 255 is a dark red.\n\nA screenshot cannot catch that: a warm cast on a saturated gradient is also\nwhat chroma subsampling produces, so the picture agrees with the bug.\n\nThe conversion is therefore the browser's own: fill a pixel and read it back.\nThat holds for `lab()`, `oklch()`, `color-mix()` and whatever a token is\nwritten in next, which is the property worth having in a design system whose\npalette is derived rather than listed.\n\n**A controller and not a mixin**, by this repository's own line: it adds no\nproperty or method a consumer sets. It reacts to lifecycle, holding a probe\nthat has to be created after the host connects and removed when it leaves,\nand it watches for the color mode changing so the host can repaint.\n\n**Client only, and that is the contract rather than a limitation.** There is\nno computed style on a server and no canvas to convert with, so `read`\nanswers the fallback there. Every caller is drawing into a canvas, which does\nnot exist on a server either.",
           "name": "TokenColorController",
           "members": [
-            {
-              "kind": "field",
-              "name": "context",
-              "type": {
-                "text": "CanvasRenderingContext2D | null"
-              },
-              "privacy": "private",
-              "default": "null",
-              "description": "Where a resolved color is converted, one pixel at a time."
-            },
             {
               "kind": "field",
               "name": "modes",
@@ -4523,6 +4911,62 @@
             "module": "./controllers/copy-controller/copy-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "activeCue",
+          "declaration": {
+            "name": "activeCue",
+            "module": "./controllers/cue-controller/cue-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "adoptTrack",
+          "declaration": {
+            "name": "adoptTrack",
+            "module": "./controllers/cue-controller/cue-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Caption",
+          "declaration": {
+            "name": "Caption",
+            "module": "./controllers/cue-controller/cue-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CueController",
+          "declaration": {
+            "name": "CueController",
+            "module": "./controllers/cue-controller/cue-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "captionsAmong",
+          "declaration": {
+            "name": "captionsAmong",
+            "module": "./controllers/cue-controller/cue-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "captionTracks",
+          "declaration": {
+            "name": "captionTracks",
+            "module": "./controllers/cue-controller/cue-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "showCaption",
+          "declaration": {
+            "name": "showCaption",
+            "module": "./controllers/cue-controller/cue-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "DisabledCascadeController",
@@ -4605,10 +5049,18 @@
         },
         {
           "kind": "js",
-          "name": "FocusTrapController",
+          "name": "FullscreenController",
+          "declaration": {
+            "name": "FullscreenController",
+            "module": "./controllers/fullscreen-controller/fullscreen-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "IdleController",
           "declaration": {
-            "name": "FocusTrapController",
-            "module": "./controllers/focus-trap-controller/focus-trap-controller.js"
+            "name": "IdleController",
+            "module": "./controllers/idle-controller/idle-controller.js"
           }
         },
         {
@@ -4651,6 +5103,30 @@
             "module": "./controllers/keyboard-navigation-controller/keyboard-navigation-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "MediaSessionController",
+          "declaration": {
+            "name": "MediaSessionController",
+            "module": "./controllers/media-session-controller/media-session-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SessionHandlers",
+          "declaration": {
+            "name": "SessionHandlers",
+            "module": "./controllers/media-session-controller/media-session-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SKIP_SECONDS",
+          "declaration": {
+            "name": "SKIP_SECONDS",
+            "module": "./controllers/media-session-controller/media-session-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "PopoverController",
@@ -4667,6 +5143,22 @@
             "module": "./controllers/popover-controller/popover-controller.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "RemotePlaybackController",
+          "declaration": {
+            "name": "RemotePlaybackController",
+            "module": "./controllers/remote-playback-controller/remote-playback-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RemoteReport",
+          "declaration": {
+            "name": "RemoteReport",
+            "module": "./controllers/remote-playback-controller/remote-playback-controller.js"
+          }
+        },
         {
           "kind": "js",
           "name": "SourceController",
@@ -5475,6 +5967,54 @@
             "module": "./utils/create-sheet/create-sheet.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "Color",
+          "declaration": {
+            "name": "Color",
+            "module": "./utils/css-color/css-color.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ColorFormat",
+          "declaration": {
+            "name": "ColorFormat",
+            "module": "./utils/css-color/css-color.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatColor",
+          "declaration": {
+            "name": "formatColor",
+            "module": "./utils/css-color/css-color.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseColor",
+          "declaration": {
+            "name": "parseColor",
+            "module": "./utils/css-color/css-color.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "splitColors",
+          "declaration": {
+            "name": "splitColors",
+            "module": "./utils/css-color/css-color.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "toCss",
+          "declaration": {
+            "name": "toCss",
+            "module": "./utils/css-color/css-color.js"
+          }
+        },
         {
           "kind": "js",
           "name": "customElement",
@@ -5659,6 +6199,30 @@
             "module": "./utils/mark-region/mark-region.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "copiesOf",
+          "declaration": {
+            "name": "copiesOf",
+            "module": "./utils/media-copy/media-copy.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MediaCopy",
+          "declaration": {
+            "name": "MediaCopy",
+            "module": "./utils/media-copy/media-copy.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sameCopies",
+          "declaration": {
+            "name": "sameCopies",
+            "module": "./utils/media-copy/media-copy.js"
+          }
+        },
         {
           "kind": "js",
           "name": "onUnlessFalse",
@@ -5667,6 +6231,22 @@
             "module": "./utils/on-unless-false/on-unless-false.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ColorBytes",
+          "declaration": {
+            "name": "ColorBytes",
+            "module": "./utils/read-color/read-color.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "readColor",
+          "declaration": {
+            "name": "readColor",
+            "module": "./utils/read-color/read-color.js"
+          }
+        },
         {
           "kind": "js",
           "name": "Row",
@@ -9277,6 +9857,130 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/css-color/css-color.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "splitColors",
+          "return": {
+            "type": {
+              "text": "string[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Splits a comma-separated list of colors, ignoring the commas inside them.\n\nA plain `split(',')` cannot hold the legacy syntaxes:\n`#ef4444, rgb(249 115 22), rgba(34,197,94,.5)` comes apart into six fragments,\nfour of them not colors, and the row quietly renders three swatches instead of\nfour. The modern space-separated forms survive it, which is what makes such a\nlist look like it works.\n\nDepth rather than a regular expression, because the thing that matters is\nwhether a comma is inside a function call and that is exactly what a counter\nanswers. No color syntax nests, so a single counter is enough."
+        },
+        {
+          "kind": "function",
+          "name": "parseColor",
+          "return": {
+            "type": {
+              "text": "Color | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Any of the syntaxes to the working model, or `null` where it is not a color.\n\nNamed colors are not here. Resolving `rebeccapurple` means either shipping\nthe table of a hundred and forty or asking the browser, and the browser is not\npresent on the server: a field that accepted a name client-side and rejected\nit during a server render would be worse than one that never took it."
+        },
+        {
+          "kind": "function",
+          "name": "formatColor",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "color",
+              "type": {
+                "text": "Color"
+              }
+            },
+            {
+              "name": "format",
+              "type": {
+                "text": "ColorFormat"
+              }
+            },
+            {
+              "name": "withAlpha",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "description": "The working model back out, in the syntax asked for.\n\nThe alpha is written only where the component carries one. A consumer who did\nnot ask for transparency should not have to strip `ff` off every hex or read\npast a fourth argument they never wanted."
+        },
+        {
+          "kind": "function",
+          "name": "toCss",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "color",
+              "type": {
+                "text": "Color"
+              }
+            }
+          ],
+          "description": "The color as CSS, for the swatches and the tracks. Always with its alpha."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "splitColors",
+          "declaration": {
+            "name": "splitColors",
+            "module": "src/utils/css-color/css-color.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseColor",
+          "declaration": {
+            "name": "parseColor",
+            "module": "src/utils/css-color/css-color.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatColor",
+          "declaration": {
+            "name": "formatColor",
+            "module": "src/utils/css-color/css-color.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "toCss",
+          "declaration": {
+            "name": "toCss",
+            "module": "src/utils/css-color/css-color.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/custom-element/custom-element.ts",
@@ -9521,7 +10225,7 @@
               }
             }
           ],
-          "description": "Everything inside `root` the reader can reach with Tab, in document order.\n\nSeparate from the focus trap because finding is the half most callers want:\nroving tabindex, arrow-key navigation and \"focus the first thing\" all need\nthis list and none of them traps anything.\n\nVisibility is tested with `getClientRects()` rather than `offsetParent`,\nwhich is null for anything inside a `position: fixed` container. A drawer is\nexactly that, so the `offsetParent` test excluded every control in the thing\nbeing trapped."
+          "description": "Everything inside `root` the reader can reach with Tab, in document order.\n\nRoving tabindex, arrow-key navigation and \"focus the first thing\" all need\nthis list, which is why it is a utility rather than part of anything that\nasks for it.\n\nVisibility is tested with `getClientRects()` rather than `offsetParent`,\nwhich is null for anything inside a `position: fixed` container, so the\n`offsetParent` test excluded every control on a raised surface."
         },
         {
           "kind": "function",
@@ -9555,7 +10259,7 @@
               }
             }
           ],
-          "description": "Whether `node` sits inside `root`, following shadow boundaries upward.\n\n`Node.contains` walks `parentNode` and a shadow root's `parentNode` is null,\nso it answers false for anything inside a component. Paired with\n`deepActiveElement`, which returns exactly such a node, that pairing is a trap\nof its own: the two look like they belong together and one of them crosses.\n\n`contains(deepActiveElement())` is the shape to avoid: focus on a\n`helix-button` reports as the `<button>` in its shadow root, which is in no\nlight-DOM container anywhere, so a trap written that way reads every reader\nas already outside it.\n\n`host` is reached without naming `ShadowRoot`, which the server has no global\nfor. This runs from a keydown handler and would never execute there, but a\nbare reference is the kind that surfaces as a crash in Lit's result collector\nthe first time something calls it early."
+          "description": "Whether `node` sits inside `root`, following shadow boundaries upward.\n\n`Node.contains` walks `parentNode` and a shadow root's `parentNode` is null,\nso it answers false for anything inside a component. Paired with\n`deepActiveElement`, which returns exactly such a node, the pair is a hazard of\nits own: the two look like they belong together and one of them crosses.\n\n`contains(deepActiveElement())` is the shape to avoid: focus on a\n`helix-button` reports as the `<button>` in its shadow root, which is in no\nlight-DOM container anywhere, so a containment test written that way reads\nevery reader as already outside.\n\n`host` is reached without naming `ShadowRoot`, which the server has no global\nfor. This runs from a keydown handler and would never execute there, but a\nbare reference is the kind that surfaces as a crash in Lit's result collector\nthe first time something calls it early."
         }
       ],
       "exports": [
@@ -9857,6 +10561,72 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/media-copy/media-copy.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "copiesOf",
+          "return": {
+            "type": {
+              "text": "MediaCopy[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "elements",
+              "type": {
+                "text": "readonly Element[]"
+              }
+            }
+          ],
+          "description": "The copies to make of what the default slot is given."
+        },
+        {
+          "kind": "function",
+          "name": "sameCopies",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "one",
+              "type": {
+                "text": "readonly MediaCopy[]"
+              }
+            },
+            {
+              "name": "two",
+              "type": {
+                "text": "readonly MediaCopy[]"
+              }
+            }
+          ],
+          "description": "Whether two reads describe the same media.\n\nThe same set again is not a change. A video reloads for every new list, and\nthe first `slotchange` reports the children the element has already read."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "copiesOf",
+          "declaration": {
+            "name": "copiesOf",
+            "module": "src/utils/media-copy/media-copy.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sameCopies",
+          "declaration": {
+            "name": "sameCopies",
+            "module": "src/utils/media-copy/media-copy.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/on-unless-false/on-unless-false.ts",
@@ -9882,6 +10652,41 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/read-color/read-color.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "readColor",
+          "return": {
+            "type": {
+              "text": "ColorBytes | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "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."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "readColor",
+          "declaration": {
+            "name": "readColor",
+            "module": "src/utils/read-color/read-color.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/read-series/read-series.ts",