@fusion.dev/helix 0.114.0 → 0.115.0

package/custom-elements.json

@@ -77453,6 +77453,33 @@
               "attribute": "tone",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "caption",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Words drawn on the map with the area, such as `A` for a search sector.\nUnset, nothing is drawn. Keep it short: it is a caption on a map, and the\narea's `label` is what a screen reader hears.",
+              "attribute": "caption",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapArea",
+                "module": "src/map/area/map-area.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "captionPlacement",
+              "type": {
+                "text": "'inside' | 'outside'"
+              },
+              "default": "'inside'",
+              "description": "Where the caption stands. `inside`, the default, at the point of the area\nfurthest from its edges. `outside`, just above the area's northernmost\npoint, clear of the shape, for an area whose caption would cover what is\nin it.",
+              "attribute": "caption-placement",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapArea",
+                "module": "src/map/area/map-area.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "description",
@@ -77854,6 +77881,31 @@
               "description": "The area's color. Uses your primary color unless set.",
               "fieldName": "tone"
             },
+            {
+              "name": "caption",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Words drawn on the map with the area, such as `A` for a search sector.\nUnset, nothing is drawn. Keep it short: it is a caption on a map, and the\narea's `label` is what a screen reader hears.",
+              "fieldName": "caption",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapArea",
+                "module": "src/map/area/map-area.ts"
+              }
+            },
+            {
+              "name": "caption-placement",
+              "type": {
+                "text": "'inside' | 'outside'"
+              },
+              "default": "'inside'",
+              "description": "Where the caption stands. `inside`, the default, at the point of the area\nfurthest from its edges. `outside`, just above the area's northernmost\npoint, clear of the shape, for an area whose caption would cover what is\nin it.",
+              "fieldName": "captionPlacement",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapArea",
+                "module": "src/map/area/map-area.ts"
+              }
+            },
             {
               "name": "description",
               "type": {
@@ -85608,6 +85660,10 @@
                 "description": "A frame around a map, with pan and zoom buttons and the map credit.",
                 "slug": "preview"
               },
+              {
+                "description": "Search sectors, each named on the map by its caption: two inside their sector and one above it, clear of what it holds.",
+                "slug": "areas"
+              },
               {
                 "description": "A map behind a page's own words, filling a hero whose words decide its height, with its credit in a corner and no landmarks.",
                 "slug": "behind-content"

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.114.0",
+  "version": "0.115.0",
   "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.114.0",
-    "@fusion.dev/helix-headless": "0.114.0",
-    "@fusion.dev/helix-styles": "0.114.0"
+    "@fusion.dev/helix-core": "0.115.0",
+    "@fusion.dev/helix-headless": "0.115.0",
+    "@fusion.dev/helix-styles": "0.115.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.114.0",
-    "@fusion.dev/helix-testing": "0.114.0",
+    "@fusion.dev/helix-cem": "0.115.0",
+    "@fusion.dev/helix-testing": "0.115.0",
     "@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

@@ -13627,6 +13627,20 @@ export type HelixMapAreaHelixMapPartChangeElementEvent =
 export type HelixMapAreaProps = {
   /** The area's color. Uses your primary color unless set. */
   tone?: (HelixMapArea["tone"]) | undefined;
+  /** Words drawn on the map with the area, such as `A` for a search sector.
+Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+area's `label` is what a screen reader hears. */
+  caption?: (HelixMapArea["caption"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  "caption-placement"?: (HelixMapArea["captionPlacement"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  captionPlacement?: (HelixMapArea["captionPlacement"]) | undefined;
   /** More about the area. Read after its label in the frame's list. */
   description?: (HelixMapArea["description"]) | undefined;
   /** A name this layer shares with other layers, such as a route and its
@@ -13649,6 +13663,20 @@ first. */
 export type HelixMapAreaSolidJsProps = {
   /** The area's color. Uses your primary color unless set. */
   "prop:tone"?: (HelixMapArea["tone"]) | undefined;
+  /** Words drawn on the map with the area, such as `A` for a search sector.
+Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+area's `label` is what a screen reader hears. */
+  "prop:caption"?: (HelixMapArea["caption"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  "attr:caption-placement"?: (HelixMapArea["captionPlacement"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  "prop:captionPlacement"?: (HelixMapArea["captionPlacement"]) | undefined;
   /** More about the area. Read after its label in the frame's list. */
   "prop:description"?: (HelixMapArea["description"]) | undefined;
   /** A name this layer shares with other layers, such as a route and its
@@ -37015,6 +37043,13 @@ export type CustomElements = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `tone`: The area's color. Uses your primary color unless set.
+   * - `caption`: Words drawn on the map with the area, such as `A` for a search sector.
+   * Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+   * area's `label` is what a screen reader hears.
+   * - `caption-placement`/`captionPlacement`: Where the caption stands. `inside`, the default, at the point of the area
+   * furthest from its edges. `outside`, just above the area's northernmost
+   * point, clear of the shape, for an area whose caption would cover what is
+   * in it.
    * - `description`: More about the area. Read after its label in the frame's list.
    * - `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,
@@ -59017,6 +59052,13 @@ export type CustomElementsSolidJs = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `tone`: The area's color. Uses your primary color unless set.
+   * - `caption`: Words drawn on the map with the area, such as `A` for a search sector.
+   * Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+   * area's `label` is what a screen reader hears.
+   * - `caption-placement`/`captionPlacement`: Where the caption stands. `inside`, the default, at the point of the area
+   * furthest from its edges. `outside`, just above the area's northernmost
+   * point, clear of the shape, for an area whose caption would cover what is
+   * in it.
    * - `description`: More about the area. Read after its label in the frame's list.
    * - `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,

package/types/vue.d.ts

@@ -6969,6 +6969,20 @@ export type HelixMapAreaHelixMapPartChangeElementEvent =
 export type HelixMapAreaVueProps = {
   /** The area's color. Uses your primary color unless set. */
   tone?: (HelixMapArea["tone"]) | undefined;
+  /** Words drawn on the map with the area, such as `A` for a search sector.
+Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+area's `label` is what a screen reader hears. */
+  caption?: (HelixMapArea["caption"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  "caption-placement"?: (HelixMapArea["captionPlacement"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  captionPlacement?: (HelixMapArea["captionPlacement"]) | undefined;
   /** More about the area. Read after its label in the frame's list. */
   description?: (HelixMapArea["description"]) | undefined;
   /** A name this layer shares with other layers, such as a route and its