@fusion.dev/helix 0.99.0 → 0.101.0

package/custom-elements.json

@@ -40797,7 +40797,6 @@
             "documentation": "https://fusion.dev/helix/components/dialog",
             "aliases": [
               "Modal",
-              "Lightbox",
               "Sheet"
             ],
             "tier": "styled",
@@ -58713,6 +58712,14 @@
             "module": "src/legend/index.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/lightbox/index.js"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -62248,6 +62255,1843 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/lightbox/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixLightboxItem",
+          "declaration": {
+            "name": "HelixLightboxItem",
+            "module": "./item/lightbox-item.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixLightbox",
+          "declaration": {
+            "name": "HelixLightbox",
+            "module": "./root/lightbox-root.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lightbox/item/lightbox-item.css.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "styles"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "styles",
+          "declaration": {
+            "name": "styles",
+            "module": "src/lightbox/item/lightbox-item.css.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lightbox/item/lightbox-item.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Presentation only: the box centers what it was given and holds it inside the\nviewport rather than sizing it, because what is in here is the consumer's and\nmay be a picture, a frame of video or a chart. Which item is shown, and the\narithmetic that decides, is the base class.",
+          "name": "HelixLightboxItem",
+          "cssProperties": [
+            {
+              "description": "Color of the line under the content.",
+              "name": "--lightbox-item-description-color"
+            },
+            {
+              "description": "Space between the content and the line under it.",
+              "name": "--lightbox-item-gap"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "current",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this is the one being shown.\n\nWritten by the root, which is the only thing that sees the set.",
+              "attribute": "current",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "What this item is called, for the reading that says where the reader is.",
+              "attribute": "label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "What names this item, and what `active` on the root is compared against.",
+              "attribute": "value",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tier",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "default": "'helix-headless-'",
+              "description": "The prefix this tier registers its elements under.\n\n**A component that renders another renders its own tier's version of it**,\nso `helix-headless-pagination-size` composes `helix-headless-select` and\n`helix-pagination-size` composes `helix-select`. One template says\n`${this.tag('select')}` and each tier answers with its own name.\n\n**The public tag may not be the composed one, in either tier.** Using it\ncosts three things: the name means two different things depending on what a\nconsumer imported, the headless tier composes an element it does not ship,\nand the composition cannot be tested there at all, because there is no\n`helix-select` on that tier to test it against.\n\n**A prefix rather than an override per composition**, which was the first\nplan and does not compile. An override re-renders the fragment from the\nsubclass, and the fragment reads members the base keeps private:\n`PaginationSize` alone would have had to widen `options`, `current` and\n`handleChange` to `protected` so a subclass could say the same thing again.\nSixteen families of that is a lot of encapsulation spent on saying one\nword differently.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "tag",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "StaticValue"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "One composed tag, as a static value a template can interpolate.\n\n`unsafeStatic` is safe by construction: the name is a literal in our own\nsource and the prefix is one of two strings this class defines. Called per\nrender and not cached, which costs nothing, because `static-html` keys its\ntemplate cache on the joined string rather than on the object.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "partNamed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "T | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "One of this element's own parts, by name, or null where it is not rendered.\n\nNot `part`, which every element already has: `Element.part` is the\n`DOMTokenList` of the names the element itself carries, and a method under\nthat name is a type error on every subclass.\n\n**One guard for every lookup.** Lit's server shim has no `querySelector`\non the render root, so a lookup reached during a server render, from a\ngetter a template reads or from `willUpdate`, throws there and nowhere\nelse. Four spellings of the same guard had grown across the library, and\na fifth site with none. Null on the server, which is what the rest of the\ncode already treats a part that has not rendered as.\n\n**`~=` and not `=`.** A part drawn in a state carries a second name while\nthe state holds, `part=\"page page-current\"`, and an exact match stops\nfinding it for exactly as long as it is the one that matters.\n\n`helix component`'s `selectors` reads these calls the way it reads a\n`querySelector('[part=\"x\"]')`, so a name nothing renders is a finding\nrather than a null an optional chain swallows.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The element's semantics, set without touching the DOM.\n\n`ElementInternals` sets the implicit role, which an author's own `role`\nattribute still overrides, and it writes no attribute. Setting `role` on the\nhost directly would: that is an attribute the element gives itself after it\nupgrades, which a React consumer's server markup never had, and hydration\nreports it as a mismatch.\n\nAvailable during server rendering. Lit's shim implements `attachInternals`,\nso nothing here needs a guard.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toggleState",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "on",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Records a boolean fact about this element as a custom state.\n\n**The host belongs to whoever rendered it, and a component's own\nbookkeeping may not be kept there.** An attribute written on the first\nupdate is markup a consumer's server never sent, so a React consumer\nhydrates a DOM that has gained attributes since and reports a mismatch it\nwill not patch up. A custom state is not in the DOM at all: it carries the\nfact to a stylesheet through `:state()` and leaves the markup alone, so the\nserver's output and the client's agree by construction.\n\n`SETTLED` carries the long version of that argument; `checked`, `open`,\n`invalid` and `has-label` are recorded the same way, each of them a state a\n`default-*` attribute resolves before React reaches the node.\n\n**Deferring the definitions is not a fix and could not be.** Importing them\nfrom an effect so the upgrades fall the other side of hydration works only\nwhile hydration is one pass: anything that splits it, a streamed segment or\na suspended boundary, puts an upgrade back inside the window. Timing cannot\nbe the guarantee when the fact is kept somewhere React reconciles.\n\nFeature-tested rather than assumed, the way `hostAria` tests element\nreferences. An engine without `CustomStateSet` records nothing and keeps\nwhatever the resting rule draws, which is the safe direction to fail.\n\n**The engines the test is for are browsers**: Safari below 17.4 and Firefox\nbelow 126, where the write is a `TypeError`, so a component bypassing this\nfails to render rather than rendering without whatever the state draws.\nLit's server shim sets `states`, so the guard passes there and records a\nstate nothing reads, which is harmless.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "whenSettled",
+              "type": {
+                "text": "Promise<void>"
+              },
+              "readonly": true,
+              "description": "Resolves a frame after the first update, when transitions are switched on.\n\n**Named `whenSettled` because `settled` is taken four times over**, by\nImage, Splitter and both color controls, none of them about transitions. A\nbase class takes the name every subclass then cannot use.\n\n**The state it reports cannot be watched, which is why this exists.** A\ncustom state is deliberately not in the DOM, so there is no\n`MutationObserver` equivalent for `ElementInternals.states`. Await this\ninstead.\n\nSeparate from `updateComplete`, which resolves in the microtask checkpoint\nthe suppression is still active in. That is the distinction `readyToMove`\nin `@fusion.dev/helix-testing` is written around.\n\nIt never resolves where `requestAnimationFrame` never fires, which is a\nserver, a hidden tab, and happy-dom. Callers that must not hang there race\nit against a timeout, as the happy-dom harness's `readyToMove` does. The\nbrowser harness's awaits it alone: a browser always runs the frame, and a\ntimer beside it was a bet on how long one takes, which a busy run lost.",
+              "default": "new Promise<void>((resolve) => { this.resolveSettled = resolve })",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resolveSettled",
+              "type": {
+                "text": "() => void"
+              },
+              "privacy": "private",
+              "description": "Resolves `whenSettled`, once, from the frame that records the state.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fromServer",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the shadow root was a server's, parsed from declarative shadow DOM.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hydrating",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this update is hydrating a server's markup, and so has to render\nexactly what the server rendered.\n\n**Lit hydrates by assuming the markup already shows the first render.** A\nvalue that differs is recorded and never written, so the page keeps the\nserver's, and a template that differs throws. The server has no children,\nso anything a component reads from its children waits for the update after\nhydration, which `finishHydration` asks for. Without a server's markup the\nfirst render reads them and there is one render.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "serverRendered",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this element hydrated a server's markup rather than rendering its own.\n\nFor what happened before hydration and cannot be heard after it: an image\nthe parser fetched fires `load` or `error` before any listener exists, so a\ncomponent asks the image instead, once, when this is true.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finishHydration",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks for the update a hydration put off, so the reads it skipped happen.\n\nCalled from `firstUpdated`, the end of the hydrating update. The render it\nschedules can only follow that one, which is the exception Lit's\nchange-in-update warning names, and it happens only on a page a server\nrendered.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "childrenKnown",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this render can know the children.\n\nA server cannot: its element shim carries attributes and no tree, so\n`children` is undefined there. A render hydrating what a server sent must\nnot, because it has to be the server's render. Anywhere else it can. A\ncomponent whose render depends on its children reads them through\n`knownChildren`, and treats \"not known\" as its own answer rather than as\n\"none\": a list that renders its empty state because nobody has looked yet is\nthe one thing an empty state must never do.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "knownChildren",
+              "type": {
+                "text": "Element[]"
+              },
+              "privacy": "protected",
+              "description": "The children a render may read: all of them where they are known, and none otherwise.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "assignsByName",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this element's slots route by name although it asked to assign them\nby hand.\n\n**A declarative shadow root is always the by-name kind.** HTML has no way to\nask for manual assignment, so a component that assigns by hand and hydrates\na server's root gets one where `slot.assign()` does nothing, and its\nchildren land wherever their `slot` attribute sends them. The way through is\nto write that attribute, which is what `route` does. Only there: on a root\nthis element made, assignment stays manual and the consumer's markup is\nnever touched, which is what a React consumer's hydration requires.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "route",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "child",
+                  "type": {
+                    "text": "Element"
+                  }
+                },
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                }
+              ],
+              "description": "Sends a child to a slot by name, on a root that routes by name.\n\n`undefined` is the default slot. Written only when it differs, so routing\nthe same child again on every update writes nothing.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "stopInner",
+              "privacy": "protected",
+              "readonly": true,
+              "description": "Stops an inner control's own announcement at this element's boundary.\n\n**A composed control is one control to a consumer, and the natives had no\nequivalent of the stop the prefixed events already get.** `<helix-select>`\nrenders a `<helix-listbox>`, and both announce: the listbox dispatches\n`input` and `change` from its own host, `input` is composed by\nspecification, and a consumer listening on the select therefore heard one\nchoice twice. Measured before this existed, on the styled tier, one choice\non the inner listbox: select `input` twice and `change` three times,\ncombobox, date input, time input and color input twice each. `Command` was\nthe only one that was right, because it happened to reach for\n`stopImmediatePropagation` for a different reason.\n\nBound on the child in the parent's template, so it runs while the event is\nstill at the child and before it can cross. The guard is for the case where\na component binds this on itself: an element must never stop its own\nannouncement, which is the one it exists to make.\n\nThis is the same job the `helix-before-*` handlers do with their own\n`stopPropagation`, and it is separate rather than folded into them because\na consumer may legitimately refuse a request without the notification ever\nhappening: the two travel at different times and one can be absent.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "relayNativeEvent",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                },
+                {
+                  "name": "init",
+                  "optional": true,
+                  "type": {
+                    "text": "EventInit"
+                  }
+                }
+              ],
+              "description": "Re-emits a native event from the host, under its own name.\n\nA native event fired by an inner `<input>` or `<textarea>` is not composed,\nso it stops at the shadow boundary and a consumer listening on\n`<helix-input>` hears nothing. Re-dispatching it from the host is what\nmakes the component behave like the control it wraps.\n\nThe relayed event keeps the native name deliberately. `change` is `change`,\nwhich is what a consumer already knows to listen for, and it is what\nreaches React: its synthetic system claims `onChange` and wires it to that\nname, so a prefixed one would never arrive.\n\n`composed` is not forced. It defaults to the original event's own value, so\na relayed `change` stops at the next shadow boundary exactly as a native\none would. Pass it explicitly only where escaping is the intent, and say so\nwhere you do.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finalizeStyles",
+              "privacy": "protected",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "CSSResultOrNative[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "styles",
+                  "optional": true,
+                  "type": {
+                    "text": "CSSResultOrNative | CSSResultOrNative[]"
+                  }
+                }
+              ],
+              "description": "Prepends the shadow-root reset to every subclass's styles, so no component\nhas to remember to include it.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
+          "superclass": {
+            "name": "HelixHeadlessLightboxItem",
+            "package": "@fusion.dev/helix-headless/lightbox"
+          },
+          "summary": "One thing a lightbox can show.",
+          "helix": {
+            "category": "media",
+            "since": "0.100.0",
+            "status": "stable",
+            "documentation": "https://fusion.dev/helix/components/lightbox",
+            "aliases": [
+              "LightboxSlide",
+              "GalleryItem"
+            ],
+            "tier": "styled",
+            "group": "Lightbox",
+            "part": "Item"
+          },
+          "tagName": "helix-lightbox-item",
+          "customElement": true,
+          "slots": [
+            {
+              "description": "What is being shown.",
+              "name": "",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            },
+            {
+              "description": "A line under it saying what it is.",
+              "name": "description",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The box the content is shown in.",
+              "name": "item",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "current",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this is the one being shown.\n\nWritten by the root, which is the only thing that sees the set.",
+              "fieldName": "current",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "What this item is called, for the reading that says where the reader is.",
+              "fieldName": "label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "What names this item, and what `active` on the root is compared against.",
+              "fieldName": "value",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            }
+          ],
+          "cssStates": [
+            {
+              "description": "While this is the item the lightbox is showing.",
+              "name": "current",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightboxItem",
+                "module": "src/lightbox/item/lightbox-item.ts"
+              }
+            },
+            {
+              "description": "Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.",
+              "name": "settled",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
+          "modulePath": "src/lightbox/item/lightbox-item.ts",
+          "definitionPath": "src/lightbox/item/lightbox-item.ts"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixLightboxItem",
+          "declaration": {
+            "name": "HelixLightboxItem",
+            "module": "src/lightbox/item/lightbox-item.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "helix-lightbox-item",
+          "declaration": {
+            "name": "HelixLightboxItem",
+            "module": "src/lightbox/item/lightbox-item.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lightbox/root/lightbox-root.css.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "styles"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "styles",
+          "declaration": {
+            "name": "styles",
+            "module": "src/lightbox/root/lightbox-root.css.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lightbox/root/lightbox-root.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "**A takeover rather than a panel, which is the whole difference from\n`Dialog`.** A dialog is a thing over the page and stops short of the edges to\nsay so; a lightbox is the page for as long as it is open. The scrim is heavier\nfor the same reason: what is behind it is not meant to be read.\n\n**A dark region that says so once**, with `color-scheme: dark` on the host,\nwhich is `Video`'s answer to the same problem: the chrome is the consumer's\nown components and they resolve their own tokens, so without a scheme on the\nregion they draw page-colored ink on a black room and disappear into it.\n\nThe chrome fades rather than leaves while the reader is still, because a bar\nthat is removed from the layout takes the picture's size with it and the\nreader watches it jump every time they stop moving.",
+          "name": "HelixLightbox",
+          "cssProperties": [
+            {
+              "description": "Color of the chrome drawn over the content.",
+              "name": "--lightbox-foreground"
+            },
+            {
+              "description": "Space between the chrome and the content.",
+              "name": "--lightbox-gap"
+            },
+            {
+              "description": "Inset from the edges of the screen.",
+              "name": "--lightbox-padding"
+            },
+            {
+              "description": "The wash over the page behind the viewer. Set on the host, where a token still resolves: a `var()` written inside `::backdrop` cannot see one.",
+              "name": "--lightbox-scrim"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "active",
+              "type": {
+                "text": "string"
+              },
+              "description": "Which item is current, by its `value`.\n\nNot `option.active`, which is the option the keyboard is on: that is a\ndifferent question from which one is chosen.\n\nWriting always applies, so `<helix-tabs active=\"one\">` starts on that\ntab, and `default-active` is how markup says where to start without\nnaming the current one.",
+              "attribute": "active",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "defaultActive",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
+              "attribute": "default-active",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "activeState",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "The state, whoever set it, and `undefined` until somebody has.\n\nOne field and not two. Writing always applies, the way a native control\ndoes when a script assigns to it.",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "requestActive",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Requests a new current item, and reports whether the request stood.\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.",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              },
+              "type": {
+                "text": "requestActive(next: string) => boolean"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "announceActivated",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Says the current child moved, once it has.\n\n`helix-activate` rather than a native word: nothing on the platform means\n\"a set chose a different member\", and borrowing `change` would be a lie\nabout what moved.\n\nA consumer who only wants to know which child is current cannot use\n`helix-before-activate` for it, that one firing *before* `apply`, so\n`currentTarget.active` is the previous value inside the handler and\n`detail.value` is a proposal another listener may refuse. `helix-select`\nis no substitute either: it fires when an item is *chosen* and not when\n`active` is assigned.\n\n**After `apply`, which is the whole reason it is a second event**, so the\nstate is on the element by the time a handler reads it. Not cancelable:\nthe decision was taken by the event before this one, and two refusable\nevents for one transition are two answers to one question.",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "resolveActive",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Item | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "items",
+                  "type": {
+                    "text": "Item[]"
+                  }
+                }
+              ],
+              "description": "Which item is current, given what there is to choose from.\n\nThe first enabled one when `active` names nothing, which is a set before\nits consumer has chosen and a set whose current item has just been\nremoved. Disabled items are skipped in the fallback but not in the match:\na consumer who names a disabled item meant it, and quietly moving to\nanother would be the component overruling them.",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the element is open.\n\nOne property, not two, so `dialog.open` answers the question anyone\nasking it meant. Writing always applies; `<helix-dialog open>` is the\nsame statement in markup.\n\n**Not reflected, and that is required rather than tidy.** Reflection\nwrites the resolved state back as an attribute, so an element that opened\nitself would put `open` on its own host: cloned, serialized for\nhydration, or diffed by a framework, it comes back holding whatever the\nlast reader did rather than what the author wrote. `:state(open)` carries\nthe resolved state for stylesheets, which is what the mirror is for.",
+              "attribute": "open",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
+              "attribute": "default-open",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "openState",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "The state, whoever set it, and `undefined` until somebody has.\n\nPrefixed, and it has to be. These mixins compose onto one prototype\nchain, `Select` takes this one and `MixinControllerValue` together, and\nTypeScript's `private` is a compile-time fiction: two mixins with a field\ncalled `state` share one property on the instance, and the second one\nsilently overwrites the first. Measured, as a select whose `value` came\nback holding its `open` boolean.\n\nOne field and not two. Writing always applies, the way a native control\ndoes when a script assigns to it.",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "requestOpen",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Requests an open-state change, and reports whether it was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-open` or\n`helix-before-close` is a refusal and nothing moves. Nobody refusing means the\nelement opens or closes itself, whether or not a consumer declared\n`open`: a declared property is a seed and a correction, and a consumer\nwho wants the decision for themselves refuses it and assigns their own.",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              },
+              "type": {
+                "text": "requestOpen(next: boolean) => boolean"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "announceToggle",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "open",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Says the state moved, under the platform's own name and in its shape.\n\n**A native `toggle` from inside a shadow root reaches nobody**, because\nit neither bubbles nor composes, so the ten families showing a\n`popover=\"manual\"` panel and the two rendering a real `<dialog>` announce\nnothing to a consumer. The disclosures have no native element to fire\nanything at all: `AccordionItem` and `TreeItem` are `aria-expanded` and\n`hidden` written by hand, which is `<details>`'s job done manually.\n\n**From here rather than from `PopoverController`.** The controller covers\neleven families and the mixin covers sixteen, so announcing from both\nwould announce twice on the ten they share. What `toggle` reports is the\n*state*, and the state is this mixin's; the controller is a way of\nputting a panel on the screen.\n\n**`newState` and `oldState`, because that is the platform's shape**, so a\nconsumer arriving from `<details>` reads the same two words. Not\ncancelable: the before events are the request, and a second cancelable\nevent for one transition is two answers to one question.",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toggleOpen",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Requests the opposite of the current state.",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              },
+              "type": {
+                "text": "toggleOpen() => boolean"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "idleDelay",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How long the reader may be still before the chrome hides, in milliseconds.\n\nZero keeps it up, which is what a viewer with a caption worth reading\nwants. The wait is only ever about idling: whether anything else should\nkeep the chrome up is the consumer's to decide with this.",
+              "attribute": "idle-delay",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name for the viewer.",
+              "attribute": "label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "loop",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether walking past the end comes back to the beginning.",
+              "attribute": "loop",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "statusLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{index} of {count}'",
+              "description": "The reading that says where in the set the reader is, with `{index}` and\n`{count}` filled in.\n\nAnnounced rather than only drawn, because the picture changing under a\nreader who cannot see it is otherwise silent. A consumer who has their own\ncounter in the chrome can empty this and say it themselves.",
+              "attribute": "status-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resting",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the reader has been still long enough to hide the chrome.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "filled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the viewer is filling the screen.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "announcement",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''",
+              "description": "What the live region is currently saying.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fullscreen",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new FullscreenController(this, (full) => { this.filled = full })",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "idle",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new IdleController( this, () => this.idleDelay, (resting) => { this.resting = resting }, )",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "commands",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new CommandController(this, { commands: { '--close': () => this.close(), '--fullscreen': () => this.toggleFullscreen(), '--next': () => this.next(), '--previous': () => this.previous(), '--show': () => this.show(), '--toggle': () => this.toggleOpen(), }, })",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "items",
+              "type": {
+                "text": "HelixHeadlessLightboxItem[]"
+              },
+              "privacy": "private",
+              "description": "The items, read from the host so the server has them too.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dialog",
+              "type": {
+                "text": "HTMLDialogElement | null"
+              },
+              "privacy": "private",
+              "description": "The native dialog, or nothing where there is no DOM to hold one.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "show",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Opens the viewer, which makes the rest of the page inert.",
+              "type": {
+                "text": "show() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks to close, which a consumer may refuse.",
+              "type": {
+                "text": "close() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "next",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Shows the next item, or the first where it is past the end and looping.",
+              "type": {
+                "text": "next() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "previous",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Shows the previous item, or the last where it is past the start and looping.",
+              "type": {
+                "text": "previous() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toggleFullscreen",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Fills the screen with the viewer, or comes back.",
+              "type": {
+                "text": "toggleFullscreen() => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "step",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "by",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Moves the shown item, through `requestActive` so a consumer can refuse.\n\nClamped rather than wrapped by default: a viewer that silently returns to\nthe first picture tells a reader they have seen everything only if they\nwere counting, and `loop` is how a consumer asks for the other reading.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleCancel",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Escape, intercepted so it is a request rather than an act.\n\nThe native `cancel` fires before the dialog closes, so preventing it leaves\nthe viewer open and lets `requestOpen` decide. Without this a reader\npressing Escape would close a viewer its consumer had said was open, and the\ntwo would disagree until something else moved.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleClose",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A close that happened anyway, reflected back and relayed.\n\n`close` on a `<dialog>` neither bubbles nor is composed, so the one the\nbrowser fires reaches nobody outside this shadow root.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleKeydown",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The arrow keys, which move the picture rather than the focus.\n\n`inlineStep` rather than a comparison against `ArrowLeft`, so the reader on\na right-to-left page gets the next picture from the key that points the way\ntheir set runs. Up and down are bound as well, the set having one axis and\na reader having no way to know which one this component thinks it is.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toEnd",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "at",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Home and End, which are an index rather than a step.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleBackdrop",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press on the backdrop, which lands on the dialog element itself.\n\nThe point is compared against the panel's box rather than trusting the\ntarget alone, for the reason `Dialog` gives: a modal `<dialog>` attributes\nbackdrop presses to itself, so any padding the styled tier gives the panel\nis a strip where a press on the panel looks like a press outside it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "mark",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Tells each item whether it is the one being shown.\n\n`resolveActiveItem` rather than a comparison, so a set whose `active` names\nnothing still shows something: every set before its consumer has chosen, and\nevery set whose current item has just been removed.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "say",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "changed",
+                  "type": {
+                    "text": "PropertyValues"
+                  }
+                }
+              ],
+              "description": "Says where the reader is, once the reader has moved.\n\nEmpty until then, because a live region populated as it enters the document\nannounces itself on arrival, which for a component that upgrades on load is\nevery page load.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tier",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "default": "'helix-headless-'",
+              "description": "The prefix this tier registers its elements under.\n\n**A component that renders another renders its own tier's version of it**,\nso `helix-headless-pagination-size` composes `helix-headless-select` and\n`helix-pagination-size` composes `helix-select`. One template says\n`${this.tag('select')}` and each tier answers with its own name.\n\n**The public tag may not be the composed one, in either tier.** Using it\ncosts three things: the name means two different things depending on what a\nconsumer imported, the headless tier composes an element it does not ship,\nand the composition cannot be tested there at all, because there is no\n`helix-select` on that tier to test it against.\n\n**A prefix rather than an override per composition**, which was the first\nplan and does not compile. An override re-renders the fragment from the\nsubclass, and the fragment reads members the base keeps private:\n`PaginationSize` alone would have had to widen `options`, `current` and\n`handleChange` to `protected` so a subclass could say the same thing again.\nSixteen families of that is a lot of encapsulation spent on saying one\nword differently.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "tag",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "StaticValue"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "One composed tag, as a static value a template can interpolate.\n\n`unsafeStatic` is safe by construction: the name is a literal in our own\nsource and the prefix is one of two strings this class defines. Called per\nrender and not cached, which costs nothing, because `static-html` keys its\ntemplate cache on the joined string rather than on the object.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "partNamed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "T | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "One of this element's own parts, by name, or null where it is not rendered.\n\nNot `part`, which every element already has: `Element.part` is the\n`DOMTokenList` of the names the element itself carries, and a method under\nthat name is a type error on every subclass.\n\n**One guard for every lookup.** Lit's server shim has no `querySelector`\non the render root, so a lookup reached during a server render, from a\ngetter a template reads or from `willUpdate`, throws there and nowhere\nelse. Four spellings of the same guard had grown across the library, and\na fifth site with none. Null on the server, which is what the rest of the\ncode already treats a part that has not rendered as.\n\n**`~=` and not `=`.** A part drawn in a state carries a second name while\nthe state holds, `part=\"page page-current\"`, and an exact match stops\nfinding it for exactly as long as it is the one that matters.\n\n`helix component`'s `selectors` reads these calls the way it reads a\n`querySelector('[part=\"x\"]')`, so a name nothing renders is a finding\nrather than a null an optional chain swallows.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The element's semantics, set without touching the DOM.\n\n`ElementInternals` sets the implicit role, which an author's own `role`\nattribute still overrides, and it writes no attribute. Setting `role` on the\nhost directly would: that is an attribute the element gives itself after it\nupgrades, which a React consumer's server markup never had, and hydration\nreports it as a mismatch.\n\nAvailable during server rendering. Lit's shim implements `attachInternals`,\nso nothing here needs a guard.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toggleState",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "on",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Records a boolean fact about this element as a custom state.\n\n**The host belongs to whoever rendered it, and a component's own\nbookkeeping may not be kept there.** An attribute written on the first\nupdate is markup a consumer's server never sent, so a React consumer\nhydrates a DOM that has gained attributes since and reports a mismatch it\nwill not patch up. A custom state is not in the DOM at all: it carries the\nfact to a stylesheet through `:state()` and leaves the markup alone, so the\nserver's output and the client's agree by construction.\n\n`SETTLED` carries the long version of that argument; `checked`, `open`,\n`invalid` and `has-label` are recorded the same way, each of them a state a\n`default-*` attribute resolves before React reaches the node.\n\n**Deferring the definitions is not a fix and could not be.** Importing them\nfrom an effect so the upgrades fall the other side of hydration works only\nwhile hydration is one pass: anything that splits it, a streamed segment or\na suspended boundary, puts an upgrade back inside the window. Timing cannot\nbe the guarantee when the fact is kept somewhere React reconciles.\n\nFeature-tested rather than assumed, the way `hostAria` tests element\nreferences. An engine without `CustomStateSet` records nothing and keeps\nwhatever the resting rule draws, which is the safe direction to fail.\n\n**The engines the test is for are browsers**: Safari below 17.4 and Firefox\nbelow 126, where the write is a `TypeError`, so a component bypassing this\nfails to render rather than rendering without whatever the state draws.\nLit's server shim sets `states`, so the guard passes there and records a\nstate nothing reads, which is harmless.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "whenSettled",
+              "type": {
+                "text": "Promise<void>"
+              },
+              "readonly": true,
+              "description": "Resolves a frame after the first update, when transitions are switched on.\n\n**Named `whenSettled` because `settled` is taken four times over**, by\nImage, Splitter and both color controls, none of them about transitions. A\nbase class takes the name every subclass then cannot use.\n\n**The state it reports cannot be watched, which is why this exists.** A\ncustom state is deliberately not in the DOM, so there is no\n`MutationObserver` equivalent for `ElementInternals.states`. Await this\ninstead.\n\nSeparate from `updateComplete`, which resolves in the microtask checkpoint\nthe suppression is still active in. That is the distinction `readyToMove`\nin `@fusion.dev/helix-testing` is written around.\n\nIt never resolves where `requestAnimationFrame` never fires, which is a\nserver, a hidden tab, and happy-dom. Callers that must not hang there race\nit against a timeout, as the happy-dom harness's `readyToMove` does. The\nbrowser harness's awaits it alone: a browser always runs the frame, and a\ntimer beside it was a bet on how long one takes, which a busy run lost.",
+              "default": "new Promise<void>((resolve) => { this.resolveSettled = resolve })",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resolveSettled",
+              "type": {
+                "text": "() => void"
+              },
+              "privacy": "private",
+              "description": "Resolves `whenSettled`, once, from the frame that records the state.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fromServer",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the shadow root was a server's, parsed from declarative shadow DOM.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hydrating",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this update is hydrating a server's markup, and so has to render\nexactly what the server rendered.\n\n**Lit hydrates by assuming the markup already shows the first render.** A\nvalue that differs is recorded and never written, so the page keeps the\nserver's, and a template that differs throws. The server has no children,\nso anything a component reads from its children waits for the update after\nhydration, which `finishHydration` asks for. Without a server's markup the\nfirst render reads them and there is one render.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "serverRendered",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this element hydrated a server's markup rather than rendering its own.\n\nFor what happened before hydration and cannot be heard after it: an image\nthe parser fetched fires `load` or `error` before any listener exists, so a\ncomponent asks the image instead, once, when this is true.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finishHydration",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks for the update a hydration put off, so the reads it skipped happen.\n\nCalled from `firstUpdated`, the end of the hydrating update. The render it\nschedules can only follow that one, which is the exception Lit's\nchange-in-update warning names, and it happens only on a page a server\nrendered.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "childrenKnown",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this render can know the children.\n\nA server cannot: its element shim carries attributes and no tree, so\n`children` is undefined there. A render hydrating what a server sent must\nnot, because it has to be the server's render. Anywhere else it can. A\ncomponent whose render depends on its children reads them through\n`knownChildren`, and treats \"not known\" as its own answer rather than as\n\"none\": a list that renders its empty state because nobody has looked yet is\nthe one thing an empty state must never do.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "knownChildren",
+              "type": {
+                "text": "Element[]"
+              },
+              "privacy": "protected",
+              "description": "The children a render may read: all of them where they are known, and none otherwise.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "assignsByName",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this element's slots route by name although it asked to assign them\nby hand.\n\n**A declarative shadow root is always the by-name kind.** HTML has no way to\nask for manual assignment, so a component that assigns by hand and hydrates\na server's root gets one where `slot.assign()` does nothing, and its\nchildren land wherever their `slot` attribute sends them. The way through is\nto write that attribute, which is what `route` does. Only there: on a root\nthis element made, assignment stays manual and the consumer's markup is\nnever touched, which is what a React consumer's hydration requires.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "route",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "child",
+                  "type": {
+                    "text": "Element"
+                  }
+                },
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                }
+              ],
+              "description": "Sends a child to a slot by name, on a root that routes by name.\n\n`undefined` is the default slot. Written only when it differs, so routing\nthe same child again on every update writes nothing.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "stopInner",
+              "privacy": "protected",
+              "readonly": true,
+              "description": "Stops an inner control's own announcement at this element's boundary.\n\n**A composed control is one control to a consumer, and the natives had no\nequivalent of the stop the prefixed events already get.** `<helix-select>`\nrenders a `<helix-listbox>`, and both announce: the listbox dispatches\n`input` and `change` from its own host, `input` is composed by\nspecification, and a consumer listening on the select therefore heard one\nchoice twice. Measured before this existed, on the styled tier, one choice\non the inner listbox: select `input` twice and `change` three times,\ncombobox, date input, time input and color input twice each. `Command` was\nthe only one that was right, because it happened to reach for\n`stopImmediatePropagation` for a different reason.\n\nBound on the child in the parent's template, so it runs while the event is\nstill at the child and before it can cross. The guard is for the case where\na component binds this on itself: an element must never stop its own\nannouncement, which is the one it exists to make.\n\nThis is the same job the `helix-before-*` handlers do with their own\n`stopPropagation`, and it is separate rather than folded into them because\na consumer may legitimately refuse a request without the notification ever\nhappening: the two travel at different times and one can be absent.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "relayNativeEvent",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                },
+                {
+                  "name": "init",
+                  "optional": true,
+                  "type": {
+                    "text": "EventInit"
+                  }
+                }
+              ],
+              "description": "Re-emits a native event from the host, under its own name.\n\nA native event fired by an inner `<input>` or `<textarea>` is not composed,\nso it stops at the shadow boundary and a consumer listening on\n`<helix-input>` hears nothing. Re-dispatching it from the host is what\nmakes the component behave like the control it wraps.\n\nThe relayed event keeps the native name deliberately. `change` is `change`,\nwhich is what a consumer already knows to listen for, and it is what\nreaches React: its synthetic system claims `onChange` and wires it to that\nname, so a prefixed one would never arrive.\n\n`composed` is not forced. It defaults to the original event's own value, so\na relayed `change` stops at the next shadow boundary exactly as a native\none would. Pass it explicitly only where escaping is the intent, and say so\nwhere you do.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finalizeStyles",
+              "privacy": "protected",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "CSSResultOrNative[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "styles",
+                  "optional": true,
+                  "type": {
+                    "text": "CSSResultOrNative | CSSResultOrNative[]"
+                  }
+                }
+              ],
+              "description": "Prepends the shadow-root reset to every subclass's styles, so no component\nhas to remember to include it.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "HelixActivateEvent"
+              },
+              "description": "Fired once the shown item has moved, so the element already holds it.",
+              "name": "helix-activate",
+              "reactProp": "onhelix-activate",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Relayed, because the platform's own does not escape.",
+              "name": "close",
+              "reactProp": "onclose",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeActivateEvent"
+              },
+              "description": "Fired before the shown item changes, and cancelable. The only way to refuse one.",
+              "name": "helix-before-activate",
+              "reactProp": "onhelix-before-activate",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeCloseEvent"
+              },
+              "description": "Fired before it closes, and cancelable.",
+              "name": "helix-before-close",
+              "reactProp": "onhelix-before-close",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeOpenEvent"
+              },
+              "description": "Fired before it opens, and cancelable.",
+              "name": "helix-before-open",
+              "reactProp": "onhelix-before-open",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Says the state moved, carrying `newState` and `oldState`.",
+              "name": "toggle",
+              "reactProp": "ontoggle",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            }
+          ],
+          "superclass": {
+            "name": "HelixHeadlessLightbox",
+            "package": "@fusion.dev/helix-headless/lightbox"
+          },
+          "summary": "A viewer that opens one thing over the page.",
+          "helix": {
+            "category": "media",
+            "since": "0.100.0",
+            "status": "stable",
+            "documentation": "https://fusion.dev/helix/components/lightbox",
+            "aliases": [
+              "Photo viewer",
+              "Image viewer",
+              "Gallery overlay"
+            ],
+            "tier": "styled",
+            "group": "Lightbox",
+            "part": "Root",
+            "examples": [
+              {
+                "description": "A set of pictures opened over the page, walked with the arrow keys.",
+                "slug": "gallery"
+              }
+            ],
+            "source": "helix/styled/src/lightbox"
+          },
+          "tagName": "helix-lightbox",
+          "customElement": true,
+          "attributes": [
+            {
+              "name": "active",
+              "type": {
+                "text": "string"
+              },
+              "description": "Which item is current, by its `value`.\n\nNot `option.active`, which is the option the keyboard is on: that is a\ndifferent question from which one is chosen.\n\nWriting always applies, so `<helix-tabs active=\"one\">` starts on that\ntab, and `default-active` is how markup says where to start without\nnaming the current one.",
+              "fieldName": "active",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "name": "default-active",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Which item the markup declared current.\n\nIgnored once `active` is written.",
+              "fieldName": "defaultActive",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the element is open.\n\nOne property, not two, so `dialog.open` answers the question anyone\nasking it meant. Writing always applies; `<helix-dialog open>` is the\nsame statement in markup.\n\n**Not reflected, and that is required rather than tidy.** Reflection\nwrites the resolved state back as an attribute, so an element that opened\nitself would put `open` on its own host: cloned, serialized for\nhydration, or diffed by a framework, it comes back holding whatever the\nlast reader did rather than what the author wrote. `:state(open)` carries\nthe resolved state for stylesheets, which is what the mirror is for.",
+              "fieldName": "open",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "name": "default-open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the markup declared it open. Ignored once `open` is written.",
+              "fieldName": "defaultOpen",
+              "inheritedFrom": {
+                "name": "MixinControllerOpen",
+                "module": "src/mixins/mixin-controller-open/mixin-controller-open.ts"
+              }
+            },
+            {
+              "name": "idle-delay",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How long the reader may be still before the chrome hides, in milliseconds.\n\nZero keeps it up, which is what a viewer with a caption worth reading\nwants. The wait is only ever about idling: whether anything else should\nkeep the chrome up is the consumer's to decide with this.",
+              "fieldName": "idleDelay",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name for the viewer.",
+              "fieldName": "label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "name": "loop",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether walking past the end comes back to the beginning.",
+              "fieldName": "loop",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "name": "status-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{index} of {count}'",
+              "description": "The reading that says where in the set the reader is, with `{index}` and\n`{count}` filled in.\n\nAnnounced rather than only drawn, because the picture changing under a\nreader who cannot see it is otherwise silent. A consumer who has their own\ncounter in the chrome can empty this and say it themselves.",
+              "fieldName": "statusLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "description": "The items, which are `<helix-headless-lightbox-item>` elements.",
+              "name": "",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "description": "Chrome below the item, such as a counter or a thumbnail strip.",
+              "name": "footer",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "description": "Chrome above the item, such as a title and a close button.",
+              "name": "header",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The native dialog element.",
+              "name": "dialog",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "description": "The region that says which item is shown.",
+              "name": "live",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "description": "The box the current item is shown in.",
+              "name": "viewport",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            }
+          ],
+          "cssStates": [
+            {
+              "description": "While the viewer fills the screen.",
+              "name": "fullscreen",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "description": "While the reader has been still long enough to hide the chrome.",
+              "name": "idle",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "description": "While the viewer is open.",
+              "name": "open",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLightbox",
+                "module": "src/lightbox/root/lightbox-root.ts"
+              }
+            },
+            {
+              "description": "Set a frame after the first render. Transitions are held off until it is, so an element never animates its own arrival.",
+              "name": "settled",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
+          "modulePath": "src/lightbox/root/lightbox-root.ts",
+          "definitionPath": "src/lightbox/root/lightbox-root.ts"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixLightbox",
+          "declaration": {
+            "name": "HelixLightbox",
+            "module": "src/lightbox/root/lightbox-root.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "helix-lightbox",
+          "declaration": {
+            "name": "HelixLightbox",
+            "module": "src/lightbox/root/lightbox-root.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/line-chart/index.ts",