@fusion.dev/helix 0.103.1 → 0.103.3

package/custom-elements.json

@@ -69367,12 +69367,12 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which of the controls this frame draws, as a list of what to keep.\n\n**A list rather than a switch, because the overlap is not symmetric.**\nEvery map library draws zoom controls and none of them draws pan buttons:\nMapLibre's navigation control is zoom and a compass, Leaflet's is zoom,\nGoogle's is zoom. So a consumer slotting one of those has our zoom twice\nover and our pan pad not at all, and a single switch would make them choose\nbetween a duplicate and nothing.\n\n`none` draws none of them, which is the right answer where the slotted map\nalready has controls a reader can find: what this family argues for is that\n*a* findable control exists, never that it is ours. The methods stay public\neither way, so a consumer drawing their own chrome can still drive the\nframe.\n\nAbsent is all three, which is this library's rule that a resting value is an\nattribute's absence, and it is what the stylesheet asks about: the layout\nrules are written against `[controls]:not([controls~=\"zoom\"])` rather than\nthe bare negation, or a frame that named no list at all would be laid out as\nthough it had dropped everything.",
+              "description": "Which of the controls this surface draws, as a list of what to keep.\n\n**A list rather than a switch, because the overlap is not symmetric.** A\nsurface a consumer brings often has zoom controls of its own and almost\nnever has pan buttons, so a single switch would make them choose between\na duplicate and nothing.\n\n`none` draws none of them, which is the right answer where what was\nslotted already has controls a reader can find: what this argues for is\nthat *a* findable control exists, never that it is ours. The methods stay\npublic either way, so a consumer drawing their own chrome can still drive\nthe surface.\n\nAbsent is all three, which is this library's rule that a resting value is\nan attribute's absence, and it is what the stylesheet asks about: the\nlayout rules are written against `[controls]:not([controls~=\"zoom\"])`\nrather than the bare negation, or a surface that named no list at all\nwould be laid out as though it had dropped everything.",
               "attribute": "controls",
               "reflects": true,
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69381,12 +69381,12 @@
               "type": {
                 "text": "'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | undefined"
               },
-              "description": "Which corner the controls sit in.\n\n**Configurable because there is no safe default**, and this is a collision\nrather than a taste: MapLibre puts its own controls at the top end, Leaflet\nand OpenLayers at the top start, Google's zoom at the bottom end. Whichever\ncorner this took would land on somebody's, which is why every one of those\nlibraries made it a setting too.\n\nLogical corners rather than left and right, so a right-to-left page moves\nthem without a consumer writing a second rule.\n\nAbsent is the top end, which is this library's rule that a resting value is\nan attribute's absence: a default that reflected would write an attribute\nonto every host that no server sent and nobody asked for.",
+              "description": "Which corner the controls sit in.\n\n**Configurable because there is no safe default**, which is a collision\nrather than a taste: whatever a consumer slots may put its own controls\nin any corner, and every library that draws some made this a setting for\nthe same reason.\n\nLogical corners rather than left and right, so a right-to-left page moves\nthem without a consumer writing a second rule. Absent is the top end, a\nresting value being an attribute's absence: a default that reflected\nwould write an attribute onto every host that no server sent.",
               "attribute": "controls-placement",
               "reflects": true,
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69399,8 +69399,8 @@
               "description": "What the control that fills the screen is called.",
               "attribute": "fullscreen-label",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69410,25 +69410,11 @@
                 "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 the default: a map's controls are how a keyboard\nreader operates it, and chrome that hides itself by default would be this\ncomponent undoing its own argument. Set it for a display map nobody drives.",
+              "description": "How long the reader may be still before the chrome hides, in milliseconds.\n\nZero keeps it up, which is the default: these controls are how a keyboard\nreader operates the surface, and chrome that hid itself by default would\nbe the component undoing its own argument. Set it for a display nobody\ndrives.",
               "attribute": "idle-delay",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Accessible name for the map, which is the one thing a consumer must write.\n\nThere is no sensible default. \"Map\" names the widget rather than the place,\nand a reader meeting three of them on a page learns nothing from hearing the\nsame word three times.",
-              "attribute": "label",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69438,11 +69424,11 @@
                 "text": "string"
               },
               "default": "'Pan {way}'",
-              "description": "What the controls are called, for a page not in English.",
+              "description": "What one pan control is called, with `{way}` filled in.",
               "attribute": "pan-label",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69452,11 +69438,11 @@
                 "text": "number"
               },
               "default": "0.25",
-              "description": "How far one press moves the map, as a fraction of what is on screen.\n\nA fraction rather than a distance, because this frame does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture at\nstreet level and at country level, and a consumer who wants metres can\nmultiply by their own.",
+              "description": "How far one press moves the view, as a fraction of what is on screen.\n\nA fraction rather than a distance, because this surface does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture\nat any zoom, and a consumer who wants their own units multiplies by them.",
               "attribute": "pan-step",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69466,11 +69452,11 @@
                 "text": "string"
               },
               "default": "'Zoom in'",
-              "description": "What the zoom controls are called.",
+              "description": "What the control that zooms in is called.",
               "attribute": "zoom-in-label",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69480,11 +69466,11 @@
                 "text": "string"
               },
               "default": "'Zoom out'",
-              "description": "What the zoom control that goes the other way is called.",
+              "description": "What the control that zooms out is called.",
               "attribute": "zoom-out-label",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69493,12 +69479,12 @@
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
+              "privacy": "protected",
               "default": "false",
               "description": "Whether the reader has been still long enough to hide the chrome.",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69507,74 +69493,94 @@
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
+              "privacy": "protected",
               "default": "false",
-              "description": "Whether the frame is filling the screen.",
+              "description": "Whether the surface is filling the screen.",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
               "name": "fullscreen",
-              "privacy": "private",
+              "privacy": "protected",
               "readonly": true,
               "default": "new FullscreenController(this, (full) => { this.filled = full })",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
               "name": "idle",
-              "privacy": "private",
+              "privacy": "protected",
               "readonly": true,
               "default": "new IdleController( this, () => this.idleDelay, (resting) => { this.resting = resting }, )",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "controlsLabel",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "description": "What the group of controls is called.\n\nA getter rather than a string in the template, so a family that is not a\nmap does not announce one. Not a property: what this group is called is a\nfact about the family rather than a choice a consumer makes per instance,\nand the labels a consumer does set are the ones on the controls\nthemselves.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "method",
-              "name": "draws",
-              "privacy": "private",
+              "name": "panEvent",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "Event"
                 }
               },
               "parameters": [
                 {
-                  "name": "group",
+                  "name": "detail",
                   "type": {
-                    "text": "'pan' | 'zoom' | 'fullscreen'"
+                    "text": "ViewportPanDetail"
                   }
                 }
               ],
-              "description": "Whether a named group of controls is one this frame draws.",
+              "description": "The pan event, built and not dispatched.\n\nA factory for the reason `MixinDismissible` has one: the surface is\nshared and the name is not. `Map` sends `helix-map-pan` because that is\nwhat a consumer of a map listens for, and the next family names its own.",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "method",
-              "name": "toggleFullscreen",
+              "name": "zoomEvent",
+              "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Event"
                 }
               },
-              "description": "Fills the screen with the frame, or comes back.",
-              "type": {
-                "text": "toggleFullscreen() => void"
-              },
+              "parameters": [
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "ViewportZoomDetail"
+                  }
+                }
+              ],
+              "description": "The zoom event, built and not dispatched, for the same reason.",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69589,17 +69595,17 @@
                 {
                   "name": "to",
                   "type": {
-                    "text": "Way"
+                    "text": "ViewportWay"
                   }
                 }
               ],
-              "description": "Asks for the map to move, which the consumer answers.",
-              "type": {
-                "text": "pan(to: Way) => void"
-              },
+              "description": "Asks for the view to move, which the consumer answers.",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              },
+              "type": {
+                "text": "pan(to: ViewportWay) => void"
               }
             },
             {
@@ -69618,24 +69624,53 @@
                   }
                 }
               ],
-              "description": "Asks for the map to zoom, `1` in and `-1` out.",
+              "description": "Asks for the view to zoom, `1` in and `-1` out.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              },
               "type": {
                 "text": "zoom(by: number) => void"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toggleFullscreen",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
+              "description": "Fills the screen with the surface, or comes back.",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              },
+              "type": {
+                "text": "toggleFullscreen() => void"
               }
             },
             {
-              "kind": "field",
-              "name": "handleKeydown",
+              "kind": "method",
+              "name": "draws",
               "privacy": "private",
-              "readonly": true,
-              "description": "The arrow keys, which are the second way rather than the only one.\n\n`inlineStep` rather than a test against `ArrowLeft`, so the reader on a\nright-to-left page gets `end` from the key that points the way their text\nruns, which is what the pan buttons say too.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "group",
+                  "type": {
+                    "text": "'pan' | 'zoom' | 'fullscreen'"
+                  }
+                }
+              ],
+              "description": "Whether a named group of controls is one this surface draws.",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
@@ -69651,26 +69686,51 @@
                 {
                   "name": "way",
                   "type": {
-                    "text": "Way"
+                    "text": "ViewportWay"
                   }
                 }
               ],
-              "description": "What one pan button is called, with the way it goes filled in.\n\nLeft and right rather than start and end, because the label is read aloud\nand a reader knows which way left is. The event keeps the reading-order\nname, which is the one a right-to-left page needs.",
+              "description": "What one pan control is called, with the way it goes filled in.\n\nLeft and right rather than start and end, because the label is read aloud\nand a reader knows which way left is. The event keeps the reading-order\nname, which is the one a right-to-left page needs.",
               "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleKeydown",
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The arrow keys, which are the second way rather than the only one.\n\n`inlineStep` rather than a test against `ArrowLeft`, so the reader on a\nright-to-left page moves the way their text runs, which is what the pan\ncontrols say too.\n\n**Only from the surface's own frame, and that is the difference between\none move and two.** What a consumer slots may answer the arrow keys\nitself, and a press relayed from inside it moves their view once on its\nown and once more on the event this would send. The rule is the region\nand the controls rather than the whole shadow root, because a family with\nits own focusable content in there, a list of notes beside a canvas,\nwould otherwise pan the surface out from under a reader arrowing through\nit.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "method",
               "name": "renderControls",
-              "privacy": "private",
+              "privacy": "protected",
               "return": {
                 "type": {
                   "text": "TemplateResult | typeof nothing"
                 }
               },
-              "description": "The controls, or nothing where a consumer kept none of them.\n\n**Written out rather than generated**, because a part name behind an\ninterpolation is a part the manifest cannot see: it would publish `pan-`\nand a consumer's `::part(pan-up)` would match nothing. The same cost\n`drawIcon` names for `Trend`.",
+              "description": "The controls, or nothing where a consumer kept none of them.\n\n**Written out rather than generated**, because a part name behind an\ninterpolation is a part the manifest cannot see: a loop would publish\n`pan-` and a consumer's `::part(pan-up)` would match nothing.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name for the map, which is the one thing a consumer must write.\n\nThere is no sensible default. \"Map\" names the widget rather than the place,\nand a reader meeting three of them on a page learns nothing from hearing the\nsame word three times.\n\n**The region is a tab stop**, so the keys are reachable however the controls\nare configured: the listener is on the region, and without a stop of its own\na frame at `controls=\"none\"` around a map with nothing focusable in it had\narrow keys no reader could ever press. `aria-keyshortcuts` says which keys\nrather than spelling them into the name, which would otherwise be read out\nat every encounter.",
+              "attribute": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMap",
                 "module": "src/map/root/map-root.ts"
@@ -70041,6 +70101,123 @@
           },
           "tagName": "helix-map",
           "customElement": true,
+          "attributes": [
+            {
+              "name": "controls",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Which of the controls this surface draws, as a list of what to keep.\n\n**A list rather than a switch, because the overlap is not symmetric.** A\nsurface a consumer brings often has zoom controls of its own and almost\nnever has pan buttons, so a single switch would make them choose between\na duplicate and nothing.\n\n`none` draws none of them, which is the right answer where what was\nslotted already has controls a reader can find: what this argues for is\nthat *a* findable control exists, never that it is ours. The methods stay\npublic either way, so a consumer drawing their own chrome can still drive\nthe surface.\n\nAbsent is all three, which is this library's rule that a resting value is\nan attribute's absence, and it is what the stylesheet asks about: the\nlayout rules are written against `[controls]:not([controls~=\"zoom\"])`\nrather than the bare negation, or a surface that named no list at all\nwould be laid out as though it had dropped everything.",
+              "fieldName": "controls",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "controls-placement",
+              "type": {
+                "text": "'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | undefined"
+              },
+              "description": "Which corner the controls sit in.\n\n**Configurable because there is no safe default**, which is a collision\nrather than a taste: whatever a consumer slots may put its own controls\nin any corner, and every library that draws some made this a setting for\nthe same reason.\n\nLogical corners rather than left and right, so a right-to-left page moves\nthem without a consumer writing a second rule. Absent is the top end, a\nresting value being an attribute's absence: a default that reflected\nwould write an attribute onto every host that no server sent.",
+              "fieldName": "controlsPlacement",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "fullscreen-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Fill the screen'",
+              "description": "What the control that fills the screen is called.",
+              "fieldName": "fullscreenLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.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 the default: these controls are how a keyboard\nreader operates the surface, and chrome that hid itself by default would\nbe the component undoing its own argument. Set it for a display nobody\ndrives.",
+              "fieldName": "idleDelay",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "pan-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pan {way}'",
+              "description": "What one pan control is called, with `{way}` filled in.",
+              "fieldName": "panLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "pan-step",
+              "type": {
+                "text": "number"
+              },
+              "default": "0.25",
+              "description": "How far one press moves the view, as a fraction of what is on screen.\n\nA fraction rather than a distance, because this surface does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture\nat any zoom, and a consumer who wants their own units multiplies by them.",
+              "fieldName": "panStep",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "zoom-in-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Zoom in'",
+              "description": "What the control that zooms in is called.",
+              "fieldName": "zoomInLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "zoom-out-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Zoom out'",
+              "description": "What the control that zooms out is called.",
+              "fieldName": "zoomOutLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name for the map, which is the one thing a consumer must write.\n\nThere is no sensible default. \"Map\" names the widget rather than the place,\nand a reader meeting three of them on a page learns nothing from hearing the\nsame word three times.\n\n**The region is a tab stop**, so the keys are reachable however the controls\nare configured: the listener is on the region, and without a stop of its own\na frame at `controls=\"none\"` around a map with nothing focusable in it had\narrow keys no reader could ever press. `aria-keyshortcuts` says which keys\nrather than spelling them into the name, which would otherwise be read out\nat every encounter.",
+              "fieldName": "label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            }
+          ],
           "slots": [
             {
               "description": "The map, which is the consumer's own.",
@@ -70181,123 +70358,6 @@
               }
             }
           ],
-          "attributes": [
-            {
-              "name": "controls",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Which of the controls this frame draws, as a list of what to keep.\n\n**A list rather than a switch, because the overlap is not symmetric.**\nEvery map library draws zoom controls and none of them draws pan buttons:\nMapLibre's navigation control is zoom and a compass, Leaflet's is zoom,\nGoogle's is zoom. So a consumer slotting one of those has our zoom twice\nover and our pan pad not at all, and a single switch would make them choose\nbetween a duplicate and nothing.\n\n`none` draws none of them, which is the right answer where the slotted map\nalready has controls a reader can find: what this family argues for is that\n*a* findable control exists, never that it is ours. The methods stay public\neither way, so a consumer drawing their own chrome can still drive the\nframe.\n\nAbsent is all three, which is this library's rule that a resting value is an\nattribute's absence, and it is what the stylesheet asks about: the layout\nrules are written against `[controls]:not([controls~=\"zoom\"])` rather than\nthe bare negation, or a frame that named no list at all would be laid out as\nthough it had dropped everything.",
-              "fieldName": "controls",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            },
-            {
-              "name": "controls-placement",
-              "type": {
-                "text": "'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | undefined"
-              },
-              "description": "Which corner the controls sit in.\n\n**Configurable because there is no safe default**, and this is a collision\nrather than a taste: MapLibre puts its own controls at the top end, Leaflet\nand OpenLayers at the top start, Google's zoom at the bottom end. Whichever\ncorner this took would land on somebody's, which is why every one of those\nlibraries made it a setting too.\n\nLogical corners rather than left and right, so a right-to-left page moves\nthem without a consumer writing a second rule.\n\nAbsent is the top end, which is this library's rule that a resting value is\nan attribute's absence: a default that reflected would write an attribute\nonto every host that no server sent and nobody asked for.",
-              "fieldName": "controlsPlacement",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            },
-            {
-              "name": "fullscreen-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Fill the screen'",
-              "description": "What the control that fills the screen is called.",
-              "fieldName": "fullscreenLabel",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.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 the default: a map's controls are how a keyboard\nreader operates it, and chrome that hides itself by default would be this\ncomponent undoing its own argument. Set it for a display map nobody drives.",
-              "fieldName": "idleDelay",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            },
-            {
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Accessible name for the map, which is the one thing a consumer must write.\n\nThere is no sensible default. \"Map\" names the widget rather than the place,\nand a reader meeting three of them on a page learns nothing from hearing the\nsame word three times.",
-              "fieldName": "label",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            },
-            {
-              "name": "pan-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Pan {way}'",
-              "description": "What the controls are called, for a page not in English.",
-              "fieldName": "panLabel",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            },
-            {
-              "name": "pan-step",
-              "type": {
-                "text": "number"
-              },
-              "default": "0.25",
-              "description": "How far one press moves the map, as a fraction of what is on screen.\n\nA fraction rather than a distance, because this frame does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture at\nstreet level and at country level, and a consumer who wants metres can\nmultiply by their own.",
-              "fieldName": "panStep",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            },
-            {
-              "name": "zoom-in-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Zoom in'",
-              "description": "What the zoom controls are called.",
-              "fieldName": "zoomInLabel",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            },
-            {
-              "name": "zoom-out-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Zoom out'",
-              "description": "What the zoom control that goes the other way is called.",
-              "fieldName": "zoomOutLabel",
-              "inheritedFrom": {
-                "name": "HelixHeadlessMap",
-                "module": "src/map/root/map-root.ts"
-              }
-            }
-          ],
           "events": [
             {
               "type": {