@fusion.dev/helix 0.110.1 → 0.110.3

package/custom-elements.json

@@ -77340,9 +77340,10 @@
               "kind": "field",
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The area's name, used in the frame's list.",
+              "default": "'Area'",
+              "description": "The area's name, used in the frame's list and its tile in the layers\nmenu. Defaults to \"Area\", so neither is ever a control with no name.",
               "attribute": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapArea",
@@ -77723,9 +77724,10 @@
             {
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The area's name, used in the frame's list.",
+              "default": "'Area'",
+              "description": "The area's name, used in the frame's list and its tile in the layers\nmenu. Defaults to \"Area\", so neither is ever a control with no name.",
               "fieldName": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapArea",
@@ -79813,6 +79815,20 @@
                 "module": "src/map/marker/map-marker.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "handingOver",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether focus is on this marker as it is gathered, and so has to move on.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapMarker",
+                "module": "src/map/marker/map-marker.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "extent",
@@ -80607,9 +80623,10 @@
               "kind": "field",
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The layer's name, used in the frame's list.",
+              "default": "'Places'",
+              "description": "The layer's name, used in the frame's list, its tile in the layers menu,\nand the group of places the keyboard walks. Defaults to \"Places\".",
               "attribute": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapPoints",
@@ -81178,9 +81195,10 @@
             {
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The layer's name, used in the frame's list.",
+              "default": "'Places'",
+              "description": "The layer's name, used in the frame's list, its tile in the layers menu,\nand the group of places the keyboard walks. Defaults to \"Places\".",
               "fieldName": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapPoints",
@@ -81489,9 +81507,10 @@
               "kind": "field",
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "What it is, such as \"Van 12\". Read by screen readers.",
+              "default": "'Live position'",
+              "description": "What it is, such as \"Van 12\". Read by screen readers. Defaults to \"Live position\".",
               "attribute": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapPosition",
@@ -81978,9 +81997,10 @@
             {
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "What it is, such as \"Van 12\". Read by screen readers.",
+              "default": "'Live position'",
+              "description": "What it is, such as \"Van 12\". Read by screen readers. Defaults to \"Live position\".",
               "fieldName": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapPosition",
@@ -82279,9 +82299,10 @@
               "kind": "field",
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The layer's name in the frame's list.",
+              "default": "'Overlay'",
+              "description": "The layer's name in the frame's list and its tile in the layers menu.\nDefaults to \"Overlay\", so neither is ever a control with no name.",
               "attribute": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapRaster",
@@ -82820,9 +82841,10 @@
             {
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The layer's name in the frame's list.",
+              "default": "'Overlay'",
+              "description": "The layer's name in the frame's list and its tile in the layers menu.\nDefaults to \"Overlay\", so neither is ever a control with no name.",
               "fieldName": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapRaster",
@@ -83919,7 +83941,7 @@
                   "text": "void"
                 }
               },
-              "description": "Says the map has moved, where a reader asked it to.\n\n**Called by whatever moves the map**, as `connectMap` does on every frame\nthe view moves. The frame's keys and buttons only ask, and nothing moves\nuntil something answers, so the frame says nothing until it is told the\nview moved: an announcement for a move that never happened is worse than\nnone. A page moving its own map in answer to `helix-map-pan` calls this\nonce it has.\n\nWhat is said waits for the view to settle, so a held key or a long\nanimation is one sentence, and it is the view's state where there is one:\nthe zoom level, the way the map faces, its tilt. A pan has no state to\nsay, so it says which way the map moved.",
+              "description": "Says the map has moved, where a reader asked it to.\n\n**Called by whatever moves the map**, as `connectMap` does on every frame\nthe view moves. The frame's keys and buttons only ask, and nothing moves\nuntil something answers, so the frame says nothing until it is told the\nview moved: an announcement for a move that never happened is worse than\nnone. A page moving its own map in answer to `helix-map-pan` sets\n`zoomLevel`, `bearing` and `pitch` to where the map now is and then calls\nthis, since those are what is said.\n\nWhat is said waits for the view to settle, so a held key or a long\nanimation is one sentence, and it is the view's state where there is one:\nthe zoom level, the way the map faces, its tilt. A pan has no state to\nsay, so it says which way the map moved.",
               "type": {
                 "text": "moved() => void"
               },
@@ -84048,6 +84070,29 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "shown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "layer",
+                  "type": {
+                    "text": "MapLayer"
+                  }
+                }
+              ],
+              "description": "Whether a layer is drawn: not hidden, and, for imagery of the ground, while\na map type shows imagery.\n\n**The map type decides imagery without writing onto it.** It set `hidden`\non the consumer's own `<helix-map-raster ground>`, before anyone had asked,\nwhich is an attribute their server never sent: the hydration mismatch the\narea rules record. `connectMap` asks the same question.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "nameOf",
@@ -84158,7 +84203,7 @@
               "name": "keys",
               "privacy": "protected",
               "readonly": true,
-              "default": "new KeyboardNavigationController(this, { items: () => this.markers.map( (marker, at): NavigableItem => ({ /* The marker itself, as a browser retargets a press from its shadow root to it, or a node inside that root, as an engine that does not retarget reports it. */ contains: (node) => node !== null && (marker.contains(node) || marker.shadowRoot?.contains(node) === true), /* Hidden inside a cluster, which the walk reaches instead. */ disabled: marker.gatheredBy !== undefined, /* The stop moves with the walk rather than waiting to hear focus arrive: a focus event from inside a marker's own shadow root is one an engine can fail to carry out to the frame, and the stop is the walk's to keep. */ focusItem: () => { this.stop = at marker.focus() }, select: () => {}, selected: false, }), ), origin: 'focus', selects: () => false, })",
+              "default": "new KeyboardNavigationController(this, { items: () => this.markers.map( (marker, at): NavigableItem => ({ /* The marker itself, as a browser retargets a press from its shadow root to it, or a node inside that root, as an engine that does not retarget reports it. */ contains: (node) => node !== null && (marker.contains(node) || marker.shadowRoot?.contains(node) === true), /* Hidden inside a cluster, which the walk reaches instead, or with no place to stand, which a stylesheet cannot show: a walk that stopped there moved the stop to a marker nothing could focus. */ disabled: marker.gatheredBy !== undefined || !placed(marker), /* The stop moves with the walk rather than waiting to hear focus arrive: a focus event from inside a marker's own shadow root is one an engine can fail to carry out to the frame, and the stop is the walk's to keep. */ focusItem: () => { this.stop = at marker.focus() }, select: () => {}, selected: false, }), ), origin: 'focus', selects: () => false, })",
               "inheritedFrom": {
                 "name": "HelixHeadlessMap",
                 "module": "src/map/root/map-root.ts"
@@ -85861,9 +85906,10 @@
               "kind": "field",
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The route's name, used in the frame's list.",
+              "default": "'Route'",
+              "description": "The route's name, used in the frame's list and its tile in the layers\nmenu. Defaults to \"Route\", so neither is ever a control with no name.",
               "attribute": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapRoute",
@@ -86265,9 +86311,10 @@
             {
               "name": "label",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "The route's name, used in the frame's list.",
+              "default": "'Route'",
+              "description": "The route's name, used in the frame's list and its tile in the layers\nmenu. Defaults to \"Route\", so neither is ever a control with no name.",
               "fieldName": "label",
               "inheritedFrom": {
                 "name": "HelixHeadlessMapRoute",

package/dist/map/position/map-position.css.js

@@ -27,7 +27,7 @@ position: absolute;
 z-index: var(--helix-layer-raised);
 }
 
-:host(:not([style*="--_map-position-x"])) {
+:host(:not([style*="--_map-position-x"])) [part="position"] {
 visibility: hidden;
 }
 

package/dist/map/root/map-root.css.js

@@ -180,6 +180,9 @@ gap: var(--helix-space-sm);
 inline-size: min(calc(var(--helix-size-control-lg) * 6), 70vw);
 inset-block-start: 0;
 inset-inline-end: calc(100% + var(--helix-space-2xs));
+
+max-block-size: calc(var(--map-block-size, 24rem) - var(--helix-space-sm) * 2);
+overflow-y: auto;
 padding: var(--helix-space-sm);
 position: absolute;
 }
@@ -297,4 +300,18 @@ border-color: var(--helix-color-primary-surface);
 [part="layer-choice"]:focus-visible [part="layer-icon"] {
 outline: var(--helix-size-focus-ring) solid var(--helix-color-focus-ring);
 outline-offset: var(--helix-size-focus-offset);
+}
+
+@media (forced-colors: active) {
+[part="tilt"][aria-pressed="true"] {
+background-color: Highlight;
+color: HighlightText;
+forced-color-adjust: none;
+}
+
+[part="map-type"]:has(input:checked),
+[part="layers-menu"] [part="layer-choice"][aria-pressed="true"] {
+outline: var(--helix-border-thick) solid Highlight;
+outline-offset: var(--helix-space-2xs);
+}
 }`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix",
   "description": "Styled component tier. Extends the headless tier with token-driven presentation.",
-  "version": "0.110.1",
+  "version": "0.110.3",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -51,13 +51,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.110.1",
-    "@fusion.dev/helix-headless": "0.110.1",
-    "@fusion.dev/helix-styles": "0.110.1"
+    "@fusion.dev/helix-core": "0.110.3",
+    "@fusion.dev/helix-headless": "0.110.3",
+    "@fusion.dev/helix-styles": "0.110.3"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.110.1",
-    "@fusion.dev/helix-testing": "0.110.1",
+    "@fusion.dev/helix-cem": "0.110.3",
+    "@fusion.dev/helix-testing": "0.110.3",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -13596,7 +13596,8 @@ export type HelixMapAreaProps = {
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   group?: (HelixMapArea["group"]) | undefined;
-  /** The area's name, used in the frame's list. */
+  /** The area's name, used in the frame's list and its tile in the layers
+menu. Defaults to "Area", so neither is ever a control with no name. */
   label?: (HelixMapArea["label"]) | undefined;
   /** The corners of the shape, in order. The last point connects back to the
 first. */
@@ -13617,7 +13618,8 @@ export type HelixMapAreaSolidJsProps = {
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   "prop:group"?: (HelixMapArea["group"]) | undefined;
-  /** The area's name, used in the frame's list. */
+  /** The area's name, used in the frame's list and its tile in the layers
+menu. Defaults to "Area", so neither is ever a control with no name. */
   "prop:label"?: (HelixMapArea["label"]) | undefined;
   /** The corners of the shape, in order. The last point connects back to the
 first. */
@@ -13927,7 +13929,8 @@ the frame's list. */
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   group?: (HelixMapPoints["group"]) | undefined;
-  /** The layer's name, used in the frame's list. */
+  /** The layer's name, used in the frame's list, its tile in the layers menu,
+and the group of places the keyboard walks. Defaults to "Places". */
   label?: (HelixMapPoints["label"]) | undefined;
   /** The GeoJSON property each point is named by. Defaults to `name`. */
   "name-key"?: (HelixMapPoints["nameKey"]) | undefined;
@@ -13969,7 +13972,8 @@ the frame's list. */
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   "prop:group"?: (HelixMapPoints["group"]) | undefined;
-  /** The layer's name, used in the frame's list. */
+  /** The layer's name, used in the frame's list, its tile in the layers menu,
+and the group of places the keyboard walks. Defaults to "Places". */
   "prop:label"?: (HelixMapPoints["label"]) | undefined;
   /** The GeoJSON property each point is named by. Defaults to `name`. */
   "attr:name-key"?: (HelixMapPoints["nameKey"]) | undefined;
@@ -14028,7 +14032,7 @@ wait is announced when the wait ends. */
   description?: (HelixMapPosition["description"]) | undefined;
   /** The direction it faces, in degrees clockwise from north. Shows an arrow. */
   heading?: (HelixMapPosition["heading"]) | undefined;
-  /** What it is, such as "Van 12". Read by screen readers. */
+  /** What it is, such as "Van 12". Read by screen readers. Defaults to "Live position". */
   label?: (HelixMapPosition["label"]) | undefined;
   /** Latitude, in degrees. */
   lat?: (HelixMapPosition["lat"]) | undefined;
@@ -14063,7 +14067,7 @@ wait is announced when the wait ends. */
   "prop:description"?: (HelixMapPosition["description"]) | undefined;
   /** The direction it faces, in degrees clockwise from north. Shows an arrow. */
   "prop:heading"?: (HelixMapPosition["heading"]) | undefined;
-  /** What it is, such as "Van 12". Read by screen readers. */
+  /** What it is, such as "Van 12". Read by screen readers. Defaults to "Live position". */
   "prop:label"?: (HelixMapPosition["label"]) | undefined;
   /** Latitude, in degrees. */
   "prop:lat"?: (HelixMapPosition["lat"]) | undefined;
@@ -14107,7 +14111,8 @@ named by the first of them, and its checkbox shows or hides them all. */
   group?: (HelixMapRaster["group"]) | undefined;
   /** How long each frame shows while `playing`, in milliseconds. */
   interval?: (HelixMapRaster["interval"]) | undefined;
-  /** The layer's name in the frame's list. */
+  /** The layer's name in the frame's list and its tile in the layers menu.
+Defaults to "Overlay", so neither is ever a control with no name. */
   label?: (HelixMapRaster["label"]) | undefined;
   /** The deepest zoom the provider has tiles for. The map enlarges those tiles
 at deeper zooms, where it would otherwise ask for tiles that do not exist. */
@@ -14146,7 +14151,8 @@ named by the first of them, and its checkbox shows or hides them all. */
   "prop:group"?: (HelixMapRaster["group"]) | undefined;
   /** How long each frame shows while `playing`, in milliseconds. */
   "prop:interval"?: (HelixMapRaster["interval"]) | undefined;
-  /** The layer's name in the frame's list. */
+  /** The layer's name in the frame's list and its tile in the layers menu.
+Defaults to "Overlay", so neither is ever a control with no name. */
   "prop:label"?: (HelixMapRaster["label"]) | undefined;
   /** The deepest zoom the provider has tiles for. The map enlarges those tiles
 at deeper zooms, where it would otherwise ask for tiles that do not exist. */
@@ -14727,7 +14733,8 @@ in the frame's list. */
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   group?: (HelixMapRoute["group"]) | undefined;
-  /** The route's name, used in the frame's list. */
+  /** The route's name, used in the frame's list and its tile in the layers
+menu. Defaults to "Route", so neither is ever a control with no name. */
   label?: (HelixMapRoute["label"]) | undefined;
   /** The points the line passes through, in order. Write the attribute as
 `lat,lng` pairs separated by spaces, or set the property to an array of `{
@@ -14755,7 +14762,8 @@ in the frame's list. */
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   "prop:group"?: (HelixMapRoute["group"]) | undefined;
-  /** The route's name, used in the frame's list. */
+  /** The route's name, used in the frame's list and its tile in the layers
+menu. Defaults to "Route", so neither is ever a control with no name. */
   "prop:label"?: (HelixMapRoute["label"]) | undefined;
   /** The points the line passes through, in order. Write the attribute as
 `lat,lng` pairs separated by spaces, or set the property to an array of `{
@@ -36902,7 +36910,8 @@ export type CustomElements = {
    * - `group`: A name this layer shares with other layers, such as a route and its
    * dotted legs. The layers menu shows layers in the same group as one entry,
    * named by the first of them, and its checkbox shows or hides them all.
-   * - `label`: The area's name, used in the frame's list.
+   * - `label`: The area's name, used in the frame's list and its tile in the layers
+   * menu. Defaults to "Area", so neither is ever a control with no name.
    * - `points`: The corners of the shape, in order. The last point connects back to the
    * first.
    * - `isMapLayer`: Marks this as a layer for the frame and the connector, whatever its tag. (property only) (readonly)
@@ -37253,7 +37262,8 @@ export type CustomElements = {
    * - `group`: A name this layer shares with other layers, such as a route and its
    * dotted legs. The layers menu shows layers in the same group as one entry,
    * named by the first of them, and its checkbox shows or hides them all.
-   * - `label`: The layer's name, used in the frame's list.
+   * - `label`: The layer's name, used in the frame's list, its tile in the layers menu,
+   * and the group of places the keyboard walks. Defaults to "Places".
    * - `name-key`/`nameKey`: The GeoJSON property each point is named by. Defaults to `name`.
    * - `src`: A GeoJSON file of points to load. Ignored when `data` is set.
    * - `data`: The points, as a GeoJSON collection or a list of `{ lat, lng, label, id }`
@@ -37334,7 +37344,7 @@ export type CustomElements = {
    * wait is announced when the wait ends.
    * - `description`: What screen readers announce when it changes, such as "Two stops away".
    * - `heading`: The direction it faces, in degrees clockwise from north. Shows an arrow.
-   * - `label`: What it is, such as "Van 12". Read by screen readers.
+   * - `label`: What it is, such as "Van 12". Read by screen readers. Defaults to "Live position".
    * - `lat`: Latitude, in degrees.
    * - `lng`: Longitude, in degrees.
    * - `isMapPosition`: Marks this as a position for the connector, whatever its tag. (property only) (readonly)
@@ -37414,7 +37424,8 @@ export type CustomElements = {
    * dotted legs. The layers menu shows layers in the same group as one entry,
    * named by the first of them, and its checkbox shows or hides them all.
    * - `interval`: How long each frame shows while `playing`, in milliseconds.
-   * - `label`: The layer's name in the frame's list.
+   * - `label`: The layer's name in the frame's list and its tile in the layers menu.
+   * Defaults to "Overlay", so neither is ever a control with no name.
    * - `max-zoom`/`maxZoom`: The deepest zoom the provider has tiles for. The map enlarges those tiles
    * at deeper zooms, where it would otherwise ask for tiles that do not exist.
    * - `opacity`: How opaque the tiles are, from `0` to `1`.
@@ -37621,8 +37632,9 @@ export type CustomElements = {
    * the view moves. The frame's keys and buttons only ask, and nothing moves
    * until something answers, so the frame says nothing until it is told the
    * view moved: an announcement for a move that never happened is worse than
-   * none. A page moving its own map in answer to `helix-map-pan` calls this
-   * once it has.
+   * none. A page moving its own map in answer to `helix-map-pan` sets
+   * `zoomLevel`, `bearing` and `pitch` to where the map now is and then calls
+   * this, since those are what is said.
    *
    * What is said waits for the view to settle, so a held key or a long
    * animation is one sentence, and it is the view's state where there is one:
@@ -37706,7 +37718,8 @@ export type CustomElements = {
    * - `group`: A name this layer shares with other layers, such as a route and its
    * dotted legs. The layers menu shows layers in the same group as one entry,
    * named by the first of them, and its checkbox shows or hides them all.
-   * - `label`: The route's name, used in the frame's list.
+   * - `label`: The route's name, used in the frame's list and its tile in the layers
+   * menu. Defaults to "Route", so neither is ever a control with no name.
    * - `points`: The points the line passes through, in order. Write the attribute as
    * `lat,lng` pairs separated by spaces, or set the property to an array of `{
    * lat, lng }`.
@@ -58843,7 +58856,8 @@ export type CustomElementsSolidJs = {
    * - `group`: A name this layer shares with other layers, such as a route and its
    * dotted legs. The layers menu shows layers in the same group as one entry,
    * named by the first of them, and its checkbox shows or hides them all.
-   * - `label`: The area's name, used in the frame's list.
+   * - `label`: The area's name, used in the frame's list and its tile in the layers
+   * menu. Defaults to "Area", so neither is ever a control with no name.
    * - `points`: The corners of the shape, in order. The last point connects back to the
    * first.
    * - `isMapLayer`: Marks this as a layer for the frame and the connector, whatever its tag. (property only) (readonly)
@@ -59209,7 +59223,8 @@ export type CustomElementsSolidJs = {
    * - `group`: A name this layer shares with other layers, such as a route and its
    * dotted legs. The layers menu shows layers in the same group as one entry,
    * named by the first of them, and its checkbox shows or hides them all.
-   * - `label`: The layer's name, used in the frame's list.
+   * - `label`: The layer's name, used in the frame's list, its tile in the layers menu,
+   * and the group of places the keyboard walks. Defaults to "Places".
    * - `name-key`/`nameKey`: The GeoJSON property each point is named by. Defaults to `name`.
    * - `src`: A GeoJSON file of points to load. Ignored when `data` is set.
    * - `data`: The points, as a GeoJSON collection or a list of `{ lat, lng, label, id }`
@@ -59293,7 +59308,7 @@ export type CustomElementsSolidJs = {
    * wait is announced when the wait ends.
    * - `description`: What screen readers announce when it changes, such as "Two stops away".
    * - `heading`: The direction it faces, in degrees clockwise from north. Shows an arrow.
-   * - `label`: What it is, such as "Van 12". Read by screen readers.
+   * - `label`: What it is, such as "Van 12". Read by screen readers. Defaults to "Live position".
    * - `lat`: Latitude, in degrees.
    * - `lng`: Longitude, in degrees.
    * - `isMapPosition`: Marks this as a position for the connector, whatever its tag. (property only) (readonly)
@@ -59376,7 +59391,8 @@ export type CustomElementsSolidJs = {
    * dotted legs. The layers menu shows layers in the same group as one entry,
    * named by the first of them, and its checkbox shows or hides them all.
    * - `interval`: How long each frame shows while `playing`, in milliseconds.
-   * - `label`: The layer's name in the frame's list.
+   * - `label`: The layer's name in the frame's list and its tile in the layers menu.
+   * Defaults to "Overlay", so neither is ever a control with no name.
    * - `max-zoom`/`maxZoom`: The deepest zoom the provider has tiles for. The map enlarges those tiles
    * at deeper zooms, where it would otherwise ask for tiles that do not exist.
    * - `opacity`: How opaque the tiles are, from `0` to `1`.
@@ -59586,8 +59602,9 @@ export type CustomElementsSolidJs = {
    * the view moves. The frame's keys and buttons only ask, and nothing moves
    * until something answers, so the frame says nothing until it is told the
    * view moved: an announcement for a move that never happened is worse than
-   * none. A page moving its own map in answer to `helix-map-pan` calls this
-   * once it has.
+   * none. A page moving its own map in answer to `helix-map-pan` sets
+   * `zoomLevel`, `bearing` and `pitch` to where the map now is and then calls
+   * this, since those are what is said.
    *
    * What is said waits for the view to settle, so a held key or a long
    * animation is one sentence, and it is the view's state where there is one:
@@ -59673,7 +59690,8 @@ export type CustomElementsSolidJs = {
    * - `group`: A name this layer shares with other layers, such as a route and its
    * dotted legs. The layers menu shows layers in the same group as one entry,
    * named by the first of them, and its checkbox shows or hides them all.
-   * - `label`: The route's name, used in the frame's list.
+   * - `label`: The route's name, used in the frame's list and its tile in the layers
+   * menu. Defaults to "Route", so neither is ever a control with no name.
    * - `points`: The points the line passes through, in order. Write the attribute as
    * `lat,lng` pairs separated by spaces, or set the property to an array of `{
    * lat, lng }`.

package/types/vue.d.ts

@@ -6956,7 +6956,8 @@ export type HelixMapAreaVueProps = {
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   group?: (HelixMapArea["group"]) | undefined;
-  /** The area's name, used in the frame's list. */
+  /** The area's name, used in the frame's list and its tile in the layers
+menu. Defaults to "Area", so neither is ever a control with no name. */
   label?: (HelixMapArea["label"]) | undefined;
   /** The corners of the shape, in order. The last point connects back to the
 first. */
@@ -7141,7 +7142,8 @@ the frame's list. */
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   group?: (HelixMapPoints["group"]) | undefined;
-  /** The layer's name, used in the frame's list. */
+  /** The layer's name, used in the frame's list, its tile in the layers menu,
+and the group of places the keyboard walks. Defaults to "Places". */
   label?: (HelixMapPoints["label"]) | undefined;
   /** The GeoJSON property each point is named by. Defaults to `name`. */
   "name-key"?: (HelixMapPoints["nameKey"]) | undefined;
@@ -7194,7 +7196,7 @@ wait is announced when the wait ends. */
   description?: (HelixMapPosition["description"]) | undefined;
   /** The direction it faces, in degrees clockwise from north. Shows an arrow. */
   heading?: (HelixMapPosition["heading"]) | undefined;
-  /** What it is, such as "Van 12". Read by screen readers. */
+  /** What it is, such as "Van 12". Read by screen readers. Defaults to "Live position". */
   label?: (HelixMapPosition["label"]) | undefined;
   /** Latitude, in degrees. */
   lat?: (HelixMapPosition["lat"]) | undefined;
@@ -7234,7 +7236,8 @@ named by the first of them, and its checkbox shows or hides them all. */
   group?: (HelixMapRaster["group"]) | undefined;
   /** How long each frame shows while `playing`, in milliseconds. */
   interval?: (HelixMapRaster["interval"]) | undefined;
-  /** The layer's name in the frame's list. */
+  /** The layer's name in the frame's list and its tile in the layers menu.
+Defaults to "Overlay", so neither is ever a control with no name. */
   label?: (HelixMapRaster["label"]) | undefined;
   /** The deepest zoom the provider has tiles for. The map enlarges those tiles
 at deeper zooms, where it would otherwise ask for tiles that do not exist. */
@@ -7552,7 +7555,8 @@ in the frame's list. */
 dotted legs. The layers menu shows layers in the same group as one entry,
 named by the first of them, and its checkbox shows or hides them all. */
   group?: (HelixMapRoute["group"]) | undefined;
-  /** The route's name, used in the frame's list. */
+  /** The route's name, used in the frame's list and its tile in the layers
+menu. Defaults to "Route", so neither is ever a control with no name. */
   label?: (HelixMapRoute["label"]) | undefined;
   /** The points the line passes through, in order. Write the attribute as
 `lat,lng` pairs separated by spaces, or set the property to an array of `{