@fusion.dev/helix 0.103.0 → 0.103.2

package/custom-elements.json

@@ -69424,7 +69424,7 @@
                 "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.",
+              "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",
@@ -69632,7 +69632,7 @@
               "name": "handleKeydown",
               "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.",
+              "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.\n\n**Only from this frame's own chrome, and that is the difference between one\nmove and two.** MapLibre and Leaflet both answer the arrow keys themselves,\nso a press inside a slotted map moves it once on its own and once more on\nthe event this would have sent: every press moving twice, and the consumer\nwith no way to tell which half to turn off. A press that started in the\nshadow root is this frame's to relay; anything from the map belongs to the\nmap.",
               "inheritedFrom": {
                 "name": "HelixHeadlessMap",
                 "module": "src/map/root/map-root.ts"
@@ -70021,8 +70021,20 @@
             "part": "Root",
             "examples": [
               {
-                "description": "A map the consumer brings, keeping the pan pad their own library does not draw and dropping the zoom it does.",
+                "description": "The frame at rest: a named region, the controls it draws, and the credit the tiles require.",
                 "slug": "framed"
+              },
+              {
+                "description": "No controls at all, for a map whose own are already findable: what is left is the name, the chrome and the credit.",
+                "slug": "quiet"
+              },
+              {
+                "description": "Keeping the pan pad a map library does not draw and dropping the zoom it does, in the corner theirs is not in.",
+                "slug": "tailored"
+              },
+              {
+                "description": "Answering the frame: it asks with `helix-map-pan` and `helix-map-zoom`, and your map does the moving.",
+                "slug": "wired"
               }
             ],
             "source": "helix/styled/src/map"
@@ -70064,6 +70076,14 @@
             }
           ],
           "cssParts": [
+            {
+              "description": "The strip the credit sits in, under the map.",
+              "name": "attribution",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "description": "The group the pan and zoom buttons sit in.",
               "name": "controls",
@@ -70072,6 +70092,14 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "description": "The strip below the map, for what a consumer slots there.",
+              "name": "footer",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "description": "The button that fills the screen.",
               "name": "fullscreen",
@@ -70080,6 +70108,14 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "description": "The strip above the map, for what a consumer slots there.",
+              "name": "header",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "description": "The button that moves the map down.",
               "name": "pan-down",
@@ -70202,7 +70238,7 @@
                 "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.",
+              "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",

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

@@ -15,11 +15,6 @@ overflow: hidden;
 position: relative;
 }
 
-[part="region"]:focus-within {
-outline: var(--helix-size-focus-ring) solid var(--helix-color-focus-ring);
-outline-offset: calc(var(--helix-size-focus-offset) * -1);
-}
-
 [part="viewport"] {
 min-block-size: 0;
 overflow: hidden;
@@ -118,6 +113,11 @@ justify-content: center;
 padding: 0;
 }
 
+[part="controls"] button:focus-visible {
+outline: var(--helix-size-focus-ring) solid var(--helix-color-focus-ring);
+outline-offset: var(--helix-size-focus-offset);
+}
+
 [part="controls"] button:hover {
 background-color: var(--helix-color-surface-raised);
 }
@@ -129,6 +129,8 @@ transition: opacity var(--helix-duration-fast) var(--helix-easing-standard);
 }
 
 ::slotted([slot="attribution"]) {
+
+border-block-start: var(--helix-border-thin) solid var(--helix-color-border);
 color: var(--helix-color-foreground-subtle);
 font-size: var(--helix-text-xs);
 padding: var(--helix-space-2xs) var(--helix-space-xs);

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.103.0",
+  "version": "0.103.2",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -47,13 +47,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.103.0",
-    "@fusion.dev/helix-headless": "0.103.0",
-    "@fusion.dev/helix-styles": "0.103.0"
+    "@fusion.dev/helix-core": "0.103.2",
+    "@fusion.dev/helix-headless": "0.103.2",
+    "@fusion.dev/helix-styles": "0.103.2"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.103.0",
-    "@fusion.dev/helix-testing": "0.103.0",
+    "@fusion.dev/helix-cem": "0.103.2",
+    "@fusion.dev/helix-testing": "0.103.2",
     "@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

@@ -11581,7 +11581,14 @@ component undoing its own argument. Set it for a display map nobody drives. */
 
 There is no sensible default. "Map" names the widget rather than the place,
 and a reader meeting three of them on a page learns nothing from hearing the
-same word three times. */
+same word three times.
+
+**The region is a tab stop**, so the keys are reachable however the controls
+are configured: the listener is on the region, and without a stop of its own
+a frame at `controls="none"` around a map with nothing focusable in it had
+arrow keys no reader could ever press. `aria-keyshortcuts` says which keys
+rather than spelling them into the name, which would otherwise be read out
+at every encounter. */
   label?: (HelixMap["label"]) | undefined;
   /** What the controls are called, for a page not in English. */
   "pan-label"?: (HelixMap["panLabel"]) | undefined;
@@ -11688,7 +11695,14 @@ component undoing its own argument. Set it for a display map nobody drives. */
 
 There is no sensible default. "Map" names the widget rather than the place,
 and a reader meeting three of them on a page learns nothing from hearing the
-same word three times. */
+same word three times.
+
+**The region is a tab stop**, so the keys are reachable however the controls
+are configured: the listener is on the region, and without a stop of its own
+a frame at `controls="none"` around a map with nothing focusable in it had
+arrow keys no reader could ever press. `aria-keyshortcuts` says which keys
+rather than spelling them into the name, which would otherwise be read out
+at every encounter. */
   "prop:label"?: (HelixMap["label"]) | undefined;
   /** What the controls are called, for a page not in English. */
   "attr:pan-label"?: (HelixMap["panLabel"]) | undefined;
@@ -31918,6 +31932,13 @@ export type CustomElements = {
    * There is no sensible default. "Map" names the widget rather than the place,
    * and a reader meeting three of them on a page learns nothing from hearing the
    * same word three times.
+   *
+   * **The region is a tab stop**, so the keys are reachable however the controls
+   * are configured: the listener is on the region, and without a stop of its own
+   * a frame at `controls="none"` around a map with nothing focusable in it had
+   * arrow keys no reader could ever press. `aria-keyshortcuts` says which keys
+   * rather than spelling them into the name, which would otherwise be read out
+   * at every encounter.
    * - `pan-label`/`panLabel`: What the controls are called, for a page not in English.
    * - `pan-step`/`panStep`: How far one press moves the map, as a fraction of what is on screen.
    *
@@ -31985,8 +32006,11 @@ export type CustomElements = {
    *
    * Custom selectors for styling elements within the component.
    *
+   * - `attribution`: The strip the credit sits in, under the map.
    * - `controls`: The group the pan and zoom buttons sit in.
+   * - `footer`: The strip below the map, for what a consumer slots there.
    * - `fullscreen`: The button that fills the screen.
+   * - `header`: The strip above the map, for what a consumer slots there.
    * - `pan-down`: The button that moves the map down.
    * - `pan-end`: The button that moves the map the way the text ends, which is right on an English page.
    * - `pan-start`: The button that moves the map the way the text starts, which is left on an English page.
@@ -52151,6 +52175,13 @@ export type CustomElementsSolidJs = {
    * There is no sensible default. "Map" names the widget rather than the place,
    * and a reader meeting three of them on a page learns nothing from hearing the
    * same word three times.
+   *
+   * **The region is a tab stop**, so the keys are reachable however the controls
+   * are configured: the listener is on the region, and without a stop of its own
+   * a frame at `controls="none"` around a map with nothing focusable in it had
+   * arrow keys no reader could ever press. `aria-keyshortcuts` says which keys
+   * rather than spelling them into the name, which would otherwise be read out
+   * at every encounter.
    * - `pan-label`/`panLabel`: What the controls are called, for a page not in English.
    * - `pan-step`/`panStep`: How far one press moves the map, as a fraction of what is on screen.
    *
@@ -52218,8 +52249,11 @@ export type CustomElementsSolidJs = {
    *
    * Custom selectors for styling elements within the component.
    *
+   * - `attribution`: The strip the credit sits in, under the map.
    * - `controls`: The group the pan and zoom buttons sit in.
+   * - `footer`: The strip below the map, for what a consumer slots there.
    * - `fullscreen`: The button that fills the screen.
+   * - `header`: The strip above the map, for what a consumer slots there.
    * - `pan-down`: The button that moves the map down.
    * - `pan-end`: The button that moves the map the way the text ends, which is right on an English page.
    * - `pan-start`: The button that moves the map the way the text starts, which is left on an English page.

package/types/vue.d.ts

@@ -5951,7 +5951,14 @@ component undoing its own argument. Set it for a display map nobody drives. */
 
 There is no sensible default. "Map" names the widget rather than the place,
 and a reader meeting three of them on a page learns nothing from hearing the
-same word three times. */
+same word three times.
+
+**The region is a tab stop**, so the keys are reachable however the controls
+are configured: the listener is on the region, and without a stop of its own
+a frame at `controls="none"` around a map with nothing focusable in it had
+arrow keys no reader could ever press. `aria-keyshortcuts` says which keys
+rather than spelling them into the name, which would otherwise be read out
+at every encounter. */
   label?: (HelixMap["label"]) | undefined;
   /** What the controls are called, for a page not in English. */
   "pan-label"?: (HelixMap["panLabel"]) | undefined;