@fusion.dev/helix-docs 0.114.0 → 0.115.0

package/content/maps.mdx

@@ -325,6 +325,29 @@ service such as OSRM or Valhalla.
 - `distancesAlong(points)` measures a route the same way the connector does, so
   something you move along the route and the lighter part stay in step.
 
+An area is a shape, such as a delivery zone or a search sector. Set `caption` to
+write a few words on the map with it:
+
+```html
+<helix-map-area
+  caption="A"
+  label="Sector A"
+  points="30.2693,-97.7745 30.2693,-97.7700 30.2655,-97.7700 30.2655,-97.7745"
+  tone="success"
+></helix-map-area>
+```
+
+The caption stands inside the area, at the point furthest from its edges. Set
+`caption-placement="outside"` to stand it above the area's northernmost point
+instead, clear of what the area holds. It is drawn in the area's color, brought
+toward the theme's text color until it reaches a 4.5:1 contrast ratio against
+the map, with a halo of the map's land around it. A caption is drawn, not
+focusable, so it adds nothing to the tab order. A screen reader hears the area's
+`label` in the frame's list of layers.
+
+On Leaflet, pass `L`, as `leafletDriver(map, L)`, and the caption is drawn as a
+marker that nobody can press or reach with the keyboard.
+
 ### Live positions
 
 ```html

package/content/metrics.mdx

@@ -58,10 +58,10 @@ either barrel. The per-component tables show what your page pays.
 | Package | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
 | `@fusion.dev/helix-core` | 177,240 | 56,685 | 48,188 | The element base class, mixins, decorators, and floating positioning. |
-| `@fusion.dev/helix-headless` | 726,527 | 188,207 | 146,254 | Every headless family. The barrel entry includes all of them. |
+| `@fusion.dev/helix-headless` | 726,678 | 188,232 | 146,411 | Every headless family. The barrel entry includes all of them. |
 | `@fusion.dev/helix-icons` | 55,565 | 17,727 | 14,864 | The whole glyph set. |
 | `@fusion.dev/helix-theme` | 3,626 | 1,597 | 1,384 | The derivation engine. Most sites run it at build time, and a theme switcher runs it in the browser. |
-| `@fusion.dev/helix` | 1,259,455 | 294,753 | 216,500 | Every styled family. |
+| `@fusion.dev/helix` | 1,259,606 | 294,810 | 216,375 | Every styled family. |
 | `lit` | 15,394 | 6,118 | 5,460 | Lit itself, listed so you can subtract it from every row above. |
 
 ## Stylesheets
@@ -84,9 +84,9 @@ shows the whole cost of using the base layer on its own.
 
 **Most of your first component is the shared runtime.** The median styled family is 20,629 bytes gzipped alone, and it adds 2,221 to a page that already has Helix. The shared runtime is 89 percent of the first component, and the component itself is 11 percent. Ten typical components cost the first number once, plus nine of the added number. The two columns in the tables below let you work that out for your own components.
 
-Across the 103 styled components, the smallest is `code` at 9,802 bytes gzipped alone, and the largest is `data-table` at 63,637. Every family together is 294,753.
+Across the 103 styled components, the smallest is `code` at 9,802 bytes gzipped alone, and the largest is `data-table` at 63,637. Every family together is 294,810.
 
-No family imports a barrel. The `barrels` rule in `fusion workspace` enforces that. `@fusion.dev/helix-headless` marks every module in `dist` as having side effects, which is true of a file that calls `customElements.define`. A bundler can remove none of it. One `import { HelixHeadlessButton } from '@fusion.dev/helix-headless'` costs 188,207 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 103 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets `sideEffects`, whatever its name.
+No family imports a barrel. The `barrels` rule in `fusion workspace` enforces that. `@fusion.dev/helix-headless` marks every module in `dist` as having side effects, which is true of a file that calls `customElements.define`. A bundler can remove none of it. One `import { HelixHeadlessButton } from '@fusion.dev/helix-headless'` costs 188,232 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 103 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets `sideEffects`, whatever its name.
 
 The headless tier never had the problem, so it serves as the control. `@fusion.dev/helix-core` is `sideEffects: false`, and the median headless family is 21,082 bytes gzipped alone.
 
@@ -230,7 +230,7 @@ Structure, accessibility, state, and form participation. It has no presentation
 | `list` | 32,717 | 10,112 | 8,882 | 1,726 | 351 | 261 |
 | `listbox` | 107,105 | 34,377 | 27,998 | 11,262 | 3,083 | 2,411 |
 | `loader` | 31,901 | 10,048 | 8,837 | 900 | 227 | 50 |
-| `map` | 127,184 | 38,398 | 31,806 | 32,551 | 7,567 | 6,138 |
+| `map` | 127,334 | 38,435 | 31,828 | 32,702 | 7,603 | 6,264 |
 | `megamenu` | 62,159 | 20,749 | 18,373 | 4,941 | 1,351 | 966 |
 | `menu` | 125,881 | 41,816 | 35,009 | 8,855 | 2,228 | 1,664 |
 | `meter` | 35,091 | 10,894 | 9,614 | 4,099 | 1,059 | 815 |
@@ -337,7 +337,7 @@ The headless tier plus presentation. `bun add @fusion.dev/helix` installs this t
 | `list` | 36,783 | 11,064 | 9,720 | 5,782 | 1,298 | 1,049 |
 | `listbox` | 111,622 | 35,424 | 28,887 | 15,768 | 4,115 | 3,277 |
 | `loader` | 35,067 | 10,812 | 9,512 | 4,051 | 995 | 760 |
-| `map` | 162,545 | 43,764 | 36,429 | 67,896 | 13,040 | 10,771 |
+| `map` | 162,694 | 43,806 | 36,410 | 68,047 | 13,080 | 10,800 |
 | `megamenu` | 67,040 | 21,815 | 19,332 | 9,805 | 2,410 | 1,905 |
 | `menu` | 133,408 | 43,467 | 36,434 | 16,362 | 3,837 | 3,129 |
 | `meter` | 40,489 | 12,037 | 10,612 | 9,479 | 2,219 | 1,827 |
@@ -399,11 +399,11 @@ stripped column shows the bytes we removed.
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
 | `@fusion.dev/helix-core` | 1,145,832 | 169 | 254,745 | `@floating-ui/dom`, `@fusion.dev/helix-icons` |
-| `@fusion.dev/helix-headless` | 13,176,137 | 504 | 1,051,621 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
+| `@fusion.dev/helix-headless` | 13,183,914 | 504 | 1,051,839 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
 | `@fusion.dev/helix-icons` | 150,162 | 21 | 50,346 | `svgo` |
 | `@fusion.dev/helix-styles` | 102,108 | 6 | 0 | none |
 | `@fusion.dev/helix-theme` | 500,416 | 8 | 5,191 | none |
-| `@fusion.dev/helix` | 14,313,272 | 870 | 371,466 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
+| `@fusion.dev/helix` | 14,319,594 | 870 | 371,466 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
 
 ## Not measured yet
 

package/dist/sources.generated.js

@@ -2604,6 +2604,29 @@ service such as OSRM or Valhalla.
 - \`distancesAlong(points)\` measures a route the same way the connector does, so
   something you move along the route and the lighter part stay in step.
 
+An area is a shape, such as a delivery zone or a search sector. Set \`caption\` to
+write a few words on the map with it:
+
+\`\`\`html
+<helix-map-area
+  caption="A"
+  label="Sector A"
+  points="30.2693,-97.7745 30.2693,-97.7700 30.2655,-97.7700 30.2655,-97.7745"
+  tone="success"
+></helix-map-area>
+\`\`\`
+
+The caption stands inside the area, at the point furthest from its edges. Set
+\`caption-placement="outside"\` to stand it above the area's northernmost point
+instead, clear of what the area holds. It is drawn in the area's color, brought
+toward the theme's text color until it reaches a 4.5:1 contrast ratio against
+the map, with a halo of the map's land around it. A caption is drawn, not
+focusable, so it adds nothing to the tab order. A screen reader hears the area's
+\`label\` in the frame's list of layers.
+
+On Leaflet, pass \`L\`, as \`leafletDriver(map, L)\`, and the caption is drawn as a
+marker that nobody can press or reach with the keyboard.
+
 ### Live positions
 
 \`\`\`html
@@ -2906,10 +2929,10 @@ either barrel. The per-component tables show what your page pays.
 | Package | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
 | \`@fusion.dev/helix-core\` | 177,240 | 56,685 | 48,188 | The element base class, mixins, decorators, and floating positioning. |
-| \`@fusion.dev/helix-headless\` | 726,527 | 188,207 | 146,254 | Every headless family. The barrel entry includes all of them. |
+| \`@fusion.dev/helix-headless\` | 726,678 | 188,232 | 146,411 | Every headless family. The barrel entry includes all of them. |
 | \`@fusion.dev/helix-icons\` | 55,565 | 17,727 | 14,864 | The whole glyph set. |
 | \`@fusion.dev/helix-theme\` | 3,626 | 1,597 | 1,384 | The derivation engine. Most sites run it at build time, and a theme switcher runs it in the browser. |
-| \`@fusion.dev/helix\` | 1,259,455 | 294,753 | 216,500 | Every styled family. |
+| \`@fusion.dev/helix\` | 1,259,606 | 294,810 | 216,375 | Every styled family. |
 | \`lit\` | 15,394 | 6,118 | 5,460 | Lit itself, listed so you can subtract it from every row above. |
 
 ## Stylesheets
@@ -2932,9 +2955,9 @@ shows the whole cost of using the base layer on its own.
 
 **Most of your first component is the shared runtime.** The median styled family is 20,629 bytes gzipped alone, and it adds 2,221 to a page that already has Helix. The shared runtime is 89 percent of the first component, and the component itself is 11 percent. Ten typical components cost the first number once, plus nine of the added number. The two columns in the tables below let you work that out for your own components.
 
-Across the 103 styled components, the smallest is \`code\` at 9,802 bytes gzipped alone, and the largest is \`data-table\` at 63,637. Every family together is 294,753.
+Across the 103 styled components, the smallest is \`code\` at 9,802 bytes gzipped alone, and the largest is \`data-table\` at 63,637. Every family together is 294,810.
 
-No family imports a barrel. The \`barrels\` rule in \`fusion workspace\` enforces that. \`@fusion.dev/helix-headless\` marks every module in \`dist\` as having side effects, which is true of a file that calls \`customElements.define\`. A bundler can remove none of it. One \`import { HelixHeadlessButton } from '@fusion.dev/helix-headless'\` costs 188,207 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 103 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets \`sideEffects\`, whatever its name.
+No family imports a barrel. The \`barrels\` rule in \`fusion workspace\` enforces that. \`@fusion.dev/helix-headless\` marks every module in \`dist\` as having side effects, which is true of a file that calls \`customElements.define\`. A bundler can remove none of it. One \`import { HelixHeadlessButton } from '@fusion.dev/helix-headless'\` costs 188,232 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 103 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets \`sideEffects\`, whatever its name.
 
 The headless tier never had the problem, so it serves as the control. \`@fusion.dev/helix-core\` is \`sideEffects: false\`, and the median headless family is 21,082 bytes gzipped alone.
 
@@ -3078,7 +3101,7 @@ Structure, accessibility, state, and form participation. It has no presentation
 | \`list\` | 32,717 | 10,112 | 8,882 | 1,726 | 351 | 261 |
 | \`listbox\` | 107,105 | 34,377 | 27,998 | 11,262 | 3,083 | 2,411 |
 | \`loader\` | 31,901 | 10,048 | 8,837 | 900 | 227 | 50 |
-| \`map\` | 127,184 | 38,398 | 31,806 | 32,551 | 7,567 | 6,138 |
+| \`map\` | 127,334 | 38,435 | 31,828 | 32,702 | 7,603 | 6,264 |
 | \`megamenu\` | 62,159 | 20,749 | 18,373 | 4,941 | 1,351 | 966 |
 | \`menu\` | 125,881 | 41,816 | 35,009 | 8,855 | 2,228 | 1,664 |
 | \`meter\` | 35,091 | 10,894 | 9,614 | 4,099 | 1,059 | 815 |
@@ -3185,7 +3208,7 @@ The headless tier plus presentation. \`bun add @fusion.dev/helix\` installs this
 | \`list\` | 36,783 | 11,064 | 9,720 | 5,782 | 1,298 | 1,049 |
 | \`listbox\` | 111,622 | 35,424 | 28,887 | 15,768 | 4,115 | 3,277 |
 | \`loader\` | 35,067 | 10,812 | 9,512 | 4,051 | 995 | 760 |
-| \`map\` | 162,545 | 43,764 | 36,429 | 67,896 | 13,040 | 10,771 |
+| \`map\` | 162,694 | 43,806 | 36,410 | 68,047 | 13,080 | 10,800 |
 | \`megamenu\` | 67,040 | 21,815 | 19,332 | 9,805 | 2,410 | 1,905 |
 | \`menu\` | 133,408 | 43,467 | 36,434 | 16,362 | 3,837 | 3,129 |
 | \`meter\` | 40,489 | 12,037 | 10,612 | 9,479 | 2,219 | 1,827 |
@@ -3247,11 +3270,11 @@ stripped column shows the bytes we removed.
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
 | \`@fusion.dev/helix-core\` | 1,145,832 | 169 | 254,745 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\` |
-| \`@fusion.dev/helix-headless\` | 13,176,137 | 504 | 1,051,621 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
+| \`@fusion.dev/helix-headless\` | 13,183,914 | 504 | 1,051,839 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
 | \`@fusion.dev/helix-icons\` | 150,162 | 21 | 50,346 | \`svgo\` |
 | \`@fusion.dev/helix-styles\` | 102,108 | 6 | 0 | none |
 | \`@fusion.dev/helix-theme\` | 500,416 | 8 | 5,191 | none |
-| \`@fusion.dev/helix\` | 14,313,272 | 870 | 371,466 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
+| \`@fusion.dev/helix\` | 14,319,594 | 870 | 371,466 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
 
 ## Not measured yet
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-docs",
   "description": "Versioned documentation content and registry for Helix.",
-  "version": "0.114.0",
+  "version": "0.115.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -36,14 +36,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "devDependencies": {
-    "@fusion.dev/helix": "0.114.0",
-    "@fusion.dev/helix-cem": "0.114.0",
-    "@fusion.dev/helix-headless": "0.114.0",
-    "@fusion.dev/helix-icons": "0.114.0",
-    "@fusion.dev/helix-map": "0.114.0",
-    "@fusion.dev/helix-styles": "0.114.0",
-    "@fusion.dev/helix-testing": "0.114.0",
-    "@fusion.dev/helix-theme": "0.114.0",
+    "@fusion.dev/helix": "0.115.0",
+    "@fusion.dev/helix-cem": "0.115.0",
+    "@fusion.dev/helix-headless": "0.115.0",
+    "@fusion.dev/helix-icons": "0.115.0",
+    "@fusion.dev/helix-map": "0.115.0",
+    "@fusion.dev/helix-styles": "0.115.0",
+    "@fusion.dev/helix-testing": "0.115.0",
+    "@fusion.dev/helix-theme": "0.115.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "lit": "^3.2.1",
     "playwright": "^1.62.1"