@esri/calcite-components 5.0.0-next.25 → 5.0.0-next.27

package/dist/docs/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-12-11T16:51:50",
+  "timestamp": "2025-12-15T17:52:59",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
     "version": "5.0.0-next.76",
@@ -789,10 +789,10 @@
         },
         {
           "name": "aria",
-          "type": "{\n    controlsElements?: Array<Element>;\n    describedByElements?: Array<Element>;\n    expanded?: boolean | \"true\" | \"false\";\n    hasPopup?: boolean | \"grid\" | \"tree\" | \"dialog\" | \"menu\" | \"true\" | \"false\" | \"listbox\";\n    labelledByElements?: Array<Element>;\n    ownsElements?: Array<Element>;\n    pressed?: boolean | \"true\" | \"false\" | \"mixed\";\n}",
+          "type": "{\n    checked?: boolean | \"true\" | \"false\" | \"mixed\";\n    controlsElements?: Array<Element>;\n    describedByElements?: Array<Element>;\n    expanded?: boolean | \"true\" | \"false\";\n    hasPopup?: boolean | \"grid\" | \"tree\" | \"dialog\" | \"menu\" | \"true\" | \"false\" | \"listbox\";\n    labelledByElements?: Array<Element>;\n    ownsElements?: Array<Element>;\n    pressed?: boolean | \"true\" | \"false\" | \"mixed\";\n    role?: \"grid\" | \"none\" | \"search\" | \"link\" | \"article\" | \"button\" | \"group\" | \"heading\" | \"list\" | \"presentation\" | \"separator\" | \"switch\" | \"table\" | \"timer\" | \"tree\" | \"meter\" | \"alert\" | \"application\" | \"log\" | \"main\" | \"figure\" | \"document\" | \"form\" | \"note\" | \"slider\" | \"row\" | \"tab\" | \"term\" | \"dialog\" | \"img\" | \"menu\" | \"option\" | \"math\" | \"marquee\" | \"menuitem\" | \"status\" | \"combobox\" | \"tooltip\" | \"checkbox\" | \"navigation\" | \"gridcell\" | \"menuitemcheckbox\" | \"menuitemradio\" | \"progressbar\" | \"radio\" | \"scrollbar\" | \"searchbox\" | \"spinbutton\" | \"tabpanel\" | \"textbox\" | \"treeitem\" | \"listbox\" | \"menubar\" | \"radiogroup\" | \"tablist\" | \"treegrid\" | \"cell\" | \"columnheader\" | \"definition\" | \"directory\" | \"feed\" | \"listitem\" | \"rowgroup\" | \"rowheader\" | \"toolbar\" | \"banner\" | \"complementary\" | \"contentinfo\" | \"region\" | \"alertdialog\";\n}",
           "complexType": {
-            "original": "{\n    controlsElements?: Array<Element>;\n    describedByElements?: Array<Element>;\n    expanded?: boolean | \"true\" | \"false\";\n    hasPopup?: boolean | \"grid\" | \"tree\" | \"dialog\" | \"menu\" | \"true\" | \"false\" | \"listbox\";\n    labelledByElements?: Array<Element>;\n    ownsElements?: Array<Element>;\n    pressed?: boolean | \"true\" | \"false\" | \"mixed\";\n}",
-            "resolved": "{\n    controlsElements?: Array<Element>;\n    describedByElements?: Array<Element>;\n    expanded?: boolean | \"true\" | \"false\";\n    hasPopup?: boolean | \"grid\" | \"tree\" | \"dialog\" | \"menu\" | \"true\" | \"false\" | \"listbox\";\n    labelledByElements?: Array<Element>;\n    ownsElements?: Array<Element>;\n    pressed?: boolean | \"true\" | \"false\" | \"mixed\";\n}",
+            "original": "{\n    checked?: boolean | \"true\" | \"false\" | \"mixed\";\n    controlsElements?: Array<Element>;\n    describedByElements?: Array<Element>;\n    expanded?: boolean | \"true\" | \"false\";\n    hasPopup?: boolean | \"grid\" | \"tree\" | \"dialog\" | \"menu\" | \"true\" | \"false\" | \"listbox\";\n    labelledByElements?: Array<Element>;\n    ownsElements?: Array<Element>;\n    pressed?: boolean | \"true\" | \"false\" | \"mixed\";\n    role?: \"grid\" | \"none\" | \"search\" | \"link\" | \"article\" | \"button\" | \"group\" | \"heading\" | \"list\" | \"presentation\" | \"separator\" | \"switch\" | \"table\" | \"timer\" | \"tree\" | \"meter\" | \"alert\" | \"application\" | \"log\" | \"main\" | \"figure\" | \"document\" | \"form\" | \"note\" | \"slider\" | \"row\" | \"tab\" | \"term\" | \"dialog\" | \"img\" | \"menu\" | \"option\" | \"math\" | \"marquee\" | \"menuitem\" | \"status\" | \"combobox\" | \"tooltip\" | \"checkbox\" | \"navigation\" | \"gridcell\" | \"menuitemcheckbox\" | \"menuitemradio\" | \"progressbar\" | \"radio\" | \"scrollbar\" | \"searchbox\" | \"spinbutton\" | \"tabpanel\" | \"textbox\" | \"treeitem\" | \"listbox\" | \"menubar\" | \"radiogroup\" | \"tablist\" | \"treegrid\" | \"cell\" | \"columnheader\" | \"definition\" | \"directory\" | \"feed\" | \"listitem\" | \"rowgroup\" | \"rowheader\" | \"toolbar\" | \"banner\" | \"complementary\" | \"contentinfo\" | \"region\" | \"alertdialog\";\n}",
+            "resolved": "{\n    checked?: boolean | \"true\" | \"false\" | \"mixed\";\n    controlsElements?: Array<Element>;\n    describedByElements?: Array<Element>;\n    expanded?: boolean | \"true\" | \"false\";\n    hasPopup?: boolean | \"grid\" | \"tree\" | \"dialog\" | \"menu\" | \"true\" | \"false\" | \"listbox\";\n    labelledByElements?: Array<Element>;\n    ownsElements?: Array<Element>;\n    pressed?: boolean | \"true\" | \"false\" | \"mixed\";\n    role?: \"grid\" | \"none\" | \"search\" | \"link\" | \"article\" | \"button\" | \"group\" | \"heading\" | \"list\" | \"presentation\" | \"separator\" | \"switch\" | \"table\" | \"timer\" | \"tree\" | \"meter\" | \"alert\" | \"application\" | \"log\" | \"main\" | \"figure\" | \"document\" | \"form\" | \"note\" | \"slider\" | \"row\" | \"tab\" | \"term\" | \"dialog\" | \"img\" | \"menu\" | \"option\" | \"math\" | \"marquee\" | \"menuitem\" | \"status\" | \"combobox\" | \"tooltip\" | \"checkbox\" | \"navigation\" | \"gridcell\" | \"menuitemcheckbox\" | \"menuitemradio\" | \"progressbar\" | \"radio\" | \"scrollbar\" | \"searchbox\" | \"spinbutton\" | \"tabpanel\" | \"textbox\" | \"treeitem\" | \"listbox\" | \"menubar\" | \"radiogroup\" | \"tablist\" | \"treegrid\" | \"cell\" | \"columnheader\" | \"definition\" | \"directory\" | \"feed\" | \"listitem\" | \"rowgroup\" | \"rowheader\" | \"toolbar\" | \"banner\" | \"complementary\" | \"contentinfo\" | \"region\" | \"alertdialog\";\n}",
             "references": {
               "Array": {
                 "location": "import",
@@ -2094,6 +2094,41 @@
           ],
           "optional": true,
           "required": false
+        },
+        {
+          "name": "selectionMode",
+          "type": "\"multiple\" | \"none\" | \"single\" | \"single-persist\"",
+          "complexType": {
+            "original": "\"multiple\" | \"none\" | \"single\" | \"single-persist\"",
+            "resolved": "\"multiple\" | \"none\" | \"single\" | \"single-persist\"",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "selection-mode",
+          "reflectToAttr": true,
+          "docs": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection, and\n\n`\"single-persist\"` allows one selection and prevents de-selection.\n\n`\"none\"` disables selection (default).",
+          "docsTags": [],
+          "default": "\"none\"",
+          "values": [
+            {
+              "value": "multiple",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            },
+            {
+              "value": "single",
+              "type": "string"
+            },
+            {
+              "value": "single-persist",
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
         }
       ],
       "methods": [
@@ -11828,6 +11863,109 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "placement",
+          "type": "\"auto\" | \"auto-end\" | \"auto-start\" | \"bottom\" | \"bottom-end\" | \"bottom-start\" | \"leading\" | \"leading-end\" | \"leading-start\" | \"left\" | \"left-end\" | \"left-start\" | \"right\" | \"right-end\" | \"right-start\" | \"top\" | \"top-end\" | \"top-start\" | \"trailing\" | \"trailing-end\" | \"trailing-start\"",
+          "complexType": {
+            "original": "\"auto\" | \"auto-end\" | \"auto-start\" | \"bottom\" | \"bottom-end\" | \"bottom-start\" | \"leading\" | \"leading-end\" | \"leading-start\" | \"left\" | \"left-end\" | \"left-start\" | \"right\" | \"right-end\" | \"right-start\" | \"top\" | \"top-end\" | \"top-start\" | \"trailing\" | \"trailing-end\" | \"trailing-start\"",
+            "resolved": "\"auto\" | \"auto-end\" | \"auto-start\" | \"bottom\" | \"bottom-end\" | \"bottom-start\" | \"leading\" | \"leading-end\" | \"leading-start\" | \"left\" | \"left-end\" | \"left-start\" | \"right\" | \"right-end\" | \"right-start\" | \"top\" | \"top-end\" | \"top-start\" | \"trailing\" | \"trailing-end\" | \"trailing-start\"",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "placement",
+          "reflectToAttr": true,
+          "docs": "Determines where the component will be positioned relative to the `referenceElement`.",
+          "docsTags": [],
+          "default": "\"bottom-start\"",
+          "values": [
+            {
+              "value": "auto",
+              "type": "string"
+            },
+            {
+              "value": "auto-end",
+              "type": "string"
+            },
+            {
+              "value": "auto-start",
+              "type": "string"
+            },
+            {
+              "value": "bottom",
+              "type": "string"
+            },
+            {
+              "value": "bottom-end",
+              "type": "string"
+            },
+            {
+              "value": "bottom-start",
+              "type": "string"
+            },
+            {
+              "value": "leading",
+              "type": "string"
+            },
+            {
+              "value": "leading-end",
+              "type": "string"
+            },
+            {
+              "value": "leading-start",
+              "type": "string"
+            },
+            {
+              "value": "left",
+              "type": "string"
+            },
+            {
+              "value": "left-end",
+              "type": "string"
+            },
+            {
+              "value": "left-start",
+              "type": "string"
+            },
+            {
+              "value": "right",
+              "type": "string"
+            },
+            {
+              "value": "right-end",
+              "type": "string"
+            },
+            {
+              "value": "right-start",
+              "type": "string"
+            },
+            {
+              "value": "top",
+              "type": "string"
+            },
+            {
+              "value": "top-end",
+              "type": "string"
+            },
+            {
+              "value": "top-start",
+              "type": "string"
+            },
+            {
+              "value": "trailing",
+              "type": "string"
+            },
+            {
+              "value": "trailing-end",
+              "type": "string"
+            },
+            {
+              "value": "trailing-start",
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "readOnly",
           "type": "boolean",
@@ -12761,8 +12899,8 @@
           },
           "mutable": true,
           "attr": "value",
-          "reflectToAttr": false,
-          "docs": "The component's value.",
+          "reflectToAttr": true,
+          "docs": "The component's value. Falls back to `heading` if not provided.",
           "docsTags": [],
           "values": [
             {
@@ -37406,6 +37544,41 @@
               "text": "{\"name\":\"LitElement\",\"package\":\"@arcgis/lumina\"}"
             }
           ]
+        },
+        {
+          "name": "updateSize",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "(size: { inline?: number | null; block?: number | null; }): Promise<void>",
+            "parameters": [
+              {
+                "name": "size",
+                "type": "{\n    inline?: number;\n    block?: number;\n}",
+                "docs": ""
+              }
+            ],
+            "return": "Promise<void>",
+            "references": {
+              "Promise": {
+                "location": "import",
+                "path": "typescript/lib/lib.es5.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "signature": "updateSize(size: { inline?: number | null; block?: number | null; }): Promise<void>",
+          "parameters": [
+            {
+              "name": "size",
+              "type": "{\n    inline?: number;\n    block?: number;\n}",
+              "docs": ""
+            }
+          ],
+          "docs": "",
+          "docsTags": []
         }
       ],
       "events": [

package/dist/docs/vscode.html-custom-data.json

@@ -519,6 +519,24 @@
               "name": "s"
             }
           ]
+        },
+        {
+          "name": "selection-mode",
+          "description": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection, and\n\n`\"single-persist\"` allows one selection and prevents de-selection.\n\n`\"none\"` disables selection (default).",
+          "values": [
+            {
+              "name": "multiple"
+            },
+            {
+              "name": "none"
+            },
+            {
+              "name": "single"
+            },
+            {
+              "name": "single-persist"
+            }
+          ]
         }
       ],
       "references": []
@@ -2435,6 +2453,75 @@
           "description": "When `true`, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
           "values": []
         },
+        {
+          "name": "placement",
+          "description": "Determines where the component will be positioned relative to the `referenceElement`.",
+          "values": [
+            {
+              "name": "auto"
+            },
+            {
+              "name": "auto-end"
+            },
+            {
+              "name": "auto-start"
+            },
+            {
+              "name": "bottom"
+            },
+            {
+              "name": "bottom-end"
+            },
+            {
+              "name": "bottom-start"
+            },
+            {
+              "name": "leading"
+            },
+            {
+              "name": "leading-end"
+            },
+            {
+              "name": "leading-start"
+            },
+            {
+              "name": "left"
+            },
+            {
+              "name": "left-end"
+            },
+            {
+              "name": "left-start"
+            },
+            {
+              "name": "right"
+            },
+            {
+              "name": "right-end"
+            },
+            {
+              "name": "right-start"
+            },
+            {
+              "name": "top"
+            },
+            {
+              "name": "top-end"
+            },
+            {
+              "name": "top-start"
+            },
+            {
+              "name": "trailing"
+            },
+            {
+              "name": "trailing-end"
+            },
+            {
+              "name": "trailing-start"
+            }
+          ]
+        },
         {
           "name": "read-only",
           "description": "When `true`, the component's value can be read, but controls are not accessible and the value cannot be modified.",
@@ -2592,7 +2679,7 @@
         },
         {
           "name": "value",
-          "description": "The component's value.",
+          "description": "The component's value. Falls back to `heading` if not provided.",
           "values": []
         }
       ],
@@ -7119,7 +7206,7 @@
     },
     {
       "name": "calcite-shell-panel",
-      "description": "### Events\n- **calciteShellPanelCollapse** - Fires when the component's content area is collapsed.\n- **calciteShellPanelExpand** - Fires when the component's content area is expanded.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n\n### Slots\n- _default_ - A slot for adding custom content.\n- **action-bar** - A slot for adding a `calcite-action-bar` to the component.\n\n### CSS Properties\n- **--calcite-shell-panel-background-color** - Specifies the background color of the component. \n- **--calcite-shell-panel-border-color** - When `displayMode` is `\"float-all\"`, specifies the component's border color. \n- **--calcite-shell-panel-corner-radius** - When `displayMode` is `\"float-all\"`, specifies the component's corner radius. \n- **--calcite-shell-panel-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float` or `float-all`, specifies the height of the component. \n- **--calcite-shell-panel-max-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the maximum height of the component. \n- **--calcite-shell-panel-max-width** - Specifies the maximum width of the component. \n- **--calcite-shell-panel-min-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the minimum height of the component. \n- **--calcite-shell-panel-min-width** - Specifies the minimum width of the component. \n- **--calcite-shell-panel-resize-background-color** - Specifies the background color of the resize handle. \n- **--calcite-shell-panel-resize-icon-color** - Specifies the text color of the resize handle. \n- **--calcite-shell-panel-shadow** - When `displayMode` is `\"float-all\"`, specifies the component's shadow. \n- **--calcite-shell-panel-text-color** - Specifies the text color of the component. \n- **--calcite-shell-panel-width** - Specifies the width of the component. \n- **--calcite-shell-panel-z-index** - Specifies the z-index value for the component. ",
+      "description": "### Events\n- **calciteShellPanelCollapse** - Fires when the component's content area is collapsed.\n- **calciteShellPanelExpand** - Fires when the component's content area is expanded.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `updateSize(size: { inline?: number | null; block?: number | null; }): Promise<void>`\n\n### Slots\n- _default_ - A slot for adding custom content.\n- **action-bar** - A slot for adding a `calcite-action-bar` to the component.\n\n### CSS Properties\n- **--calcite-shell-panel-background-color** - Specifies the background color of the component. \n- **--calcite-shell-panel-border-color** - When `displayMode` is `\"float-all\"`, specifies the component's border color. \n- **--calcite-shell-panel-corner-radius** - When `displayMode` is `\"float-all\"`, specifies the component's corner radius. \n- **--calcite-shell-panel-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float` or `float-all`, specifies the height of the component. \n- **--calcite-shell-panel-max-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the maximum height of the component. \n- **--calcite-shell-panel-max-width** - Specifies the maximum width of the component. \n- **--calcite-shell-panel-min-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the minimum height of the component. \n- **--calcite-shell-panel-min-width** - Specifies the minimum width of the component. \n- **--calcite-shell-panel-resize-background-color** - Specifies the background color of the resize handle. \n- **--calcite-shell-panel-resize-icon-color** - Specifies the text color of the resize handle. \n- **--calcite-shell-panel-shadow** - When `displayMode` is `\"float-all\"`, specifies the component's shadow. \n- **--calcite-shell-panel-text-color** - Specifies the text color of the component. \n- **--calcite-shell-panel-width** - Specifies the width of the component. \n- **--calcite-shell-panel-z-index** - Specifies the z-index value for the component. ",
       "attributes": [
         {
           "name": "collapsed",

package/dist/docs/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@esri/calcite-components",
-  "version": "5.0.0-next.25",
+  "version": "5.0.0-next.27",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -420,7 +420,7 @@
               {
                 "name": "aria",
                 "description": "Use this property to override or extend ARIA properties and attributes on the component's button.",
-                "type": "{\n    controlsElements?: Array<Element>;\n    describedByElements?: Array<Element>;\n    expanded?: boolean | \"true\" | \"false\";\n    hasPopup?: boolean | \"grid\" | \"tree\" | \"dialog\" | \"menu\" | \"true\" | \"false\" | \"listbox\";\n    labelledByElements?: Array<Element>;\n    ownsElements?: Array<Element>;\n    pressed?: boolean | \"true\" | \"false\" | \"mixed\";\n}"
+                "type": "{\n    checked?: boolean | \"true\" | \"false\" | \"mixed\";\n    controlsElements?: Array<Element>;\n    describedByElements?: Array<Element>;\n    expanded?: boolean | \"true\" | \"false\";\n    hasPopup?: boolean | \"grid\" | \"tree\" | \"dialog\" | \"menu\" | \"true\" | \"false\" | \"listbox\";\n    labelledByElements?: Array<Element>;\n    ownsElements?: Array<Element>;\n    pressed?: boolean | \"true\" | \"false\" | \"mixed\";\n    role?: \"grid\" | \"none\" | \"search\" | \"link\" | \"article\" | \"button\" | \"group\" | \"heading\" | \"list\" | \"presentation\" | \"separator\" | \"switch\" | \"table\" | \"timer\" | \"tree\" | \"meter\" | \"alert\" | \"application\" | \"log\" | \"main\" | \"figure\" | \"document\" | \"form\" | \"note\" | \"slider\" | \"row\" | \"tab\" | \"term\" | \"dialog\" | \"img\" | \"menu\" | \"option\" | \"math\" | \"marquee\" | \"menuitem\" | \"status\" | \"combobox\" | \"tooltip\" | \"checkbox\" | \"navigation\" | \"gridcell\" | \"menuitemcheckbox\" | \"menuitemradio\" | \"progressbar\" | \"radio\" | \"scrollbar\" | \"searchbox\" | \"spinbutton\" | \"tabpanel\" | \"textbox\" | \"treeitem\" | \"listbox\" | \"menubar\" | \"radiogroup\" | \"tablist\" | \"treegrid\" | \"cell\" | \"columnheader\" | \"definition\" | \"directory\" | \"feed\" | \"listitem\" | \"rowgroup\" | \"rowheader\" | \"toolbar\" | \"banner\" | \"complementary\" | \"contentinfo\" | \"region\" | \"alertdialog\";\n}"
               },
               {
                 "name": "compact",
@@ -803,6 +803,19 @@
                   "\"s\""
                 ]
               }
+            },
+            {
+              "name": "selection-mode",
+              "description": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection, and\n\n`\"single-persist\"` allows one selection and prevents de-selection.\n\n`\"none\"` disables selection (default).",
+              "default": "\"none\"",
+              "value": {
+                "type": [
+                  "\"multiple\"",
+                  "\"none\"",
+                  "\"single\"",
+                  "\"single-persist\""
+                ]
+              }
             }
           ],
           "slots": [
@@ -882,6 +895,11 @@
                 "name": "scale",
                 "description": "Specifies the size of the `calcite-action-menu`.",
                 "type": "\"l\" | \"m\" | \"s\""
+              },
+              {
+                "name": "selectionMode",
+                "description": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection, and\n\n`\"single-persist\"` allows one selection and prevents de-selection.\n\n`\"none\"` disables selection (default).",
+                "type": "\"multiple\" | \"none\" | \"single\" | \"single-persist\""
               }
             ],
             "events": [
@@ -4731,6 +4749,36 @@
                 "type": "boolean"
               }
             },
+            {
+              "name": "placement",
+              "description": "Determines where the component will be positioned relative to the `referenceElement`.",
+              "default": "\"bottom-start\"",
+              "value": {
+                "type": [
+                  "\"auto\"",
+                  "\"auto-end\"",
+                  "\"auto-start\"",
+                  "\"bottom\"",
+                  "\"bottom-end\"",
+                  "\"bottom-start\"",
+                  "\"leading\"",
+                  "\"leading-end\"",
+                  "\"leading-start\"",
+                  "\"left\"",
+                  "\"left-end\"",
+                  "\"left-start\"",
+                  "\"right\"",
+                  "\"right-end\"",
+                  "\"right-start\"",
+                  "\"top\"",
+                  "\"top-end\"",
+                  "\"top-start\"",
+                  "\"trailing\"",
+                  "\"trailing-end\"",
+                  "\"trailing-start\""
+                ]
+              }
+            },
             {
               "name": "read-only",
               "description": "When `true`, the component's value can be read, but controls are not accessible and the value cannot be modified.",
@@ -4965,6 +5013,11 @@
                 "description": "When `true`, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
                 "type": "boolean"
               },
+              {
+                "name": "placement",
+                "description": "Determines where the component will be positioned relative to the `referenceElement`.",
+                "type": "\"auto\" | \"auto-end\" | \"auto-start\" | \"bottom\" | \"bottom-end\" | \"bottom-start\" | \"leading\" | \"leading-end\" | \"leading-start\" | \"left\" | \"left-end\" | \"left-start\" | \"right\" | \"right-end\" | \"right-start\" | \"top\" | \"top-end\" | \"top-start\" | \"trailing\" | \"trailing-end\" | \"trailing-start\""
+              },
               {
                 "name": "readOnly",
                 "description": "When `true`, the component's value can be read, but controls are not accessible and the value cannot be modified.",
@@ -5151,7 +5204,7 @@
             },
             {
               "name": "value",
-              "description": "The component's value.",
+              "description": "The component's value. Falls back to `heading` if not provided.",
               "value": {
                 "type": "any"
               }
@@ -5247,7 +5300,7 @@
               },
               {
                 "name": "value",
-                "description": "The component's value.",
+                "description": "The component's value. Falls back to `heading` if not provided.",
                 "type": "any"
               }
             ],
@@ -14765,7 +14818,7 @@
         },
         {
           "name": "calcite-shell-panel",
-          "description": "### Events\n- **calciteShellPanelCollapse** - Fires when the component's content area is collapsed.\n- **calciteShellPanelExpand** - Fires when the component's content area is expanded.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n\n### Slots\n- _default_ - A slot for adding custom content.\n- **action-bar** - A slot for adding a `calcite-action-bar` to the component.\n\n### CSS Properties\n- **--calcite-shell-panel-background-color** - Specifies the background color of the component. \n- **--calcite-shell-panel-border-color** - When `displayMode` is `\"float-all\"`, specifies the component's border color. \n- **--calcite-shell-panel-corner-radius** - When `displayMode` is `\"float-all\"`, specifies the component's corner radius. \n- **--calcite-shell-panel-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float` or `float-all`, specifies the height of the component. \n- **--calcite-shell-panel-max-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the maximum height of the component. \n- **--calcite-shell-panel-max-width** - Specifies the maximum width of the component. \n- **--calcite-shell-panel-min-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the minimum height of the component. \n- **--calcite-shell-panel-min-width** - Specifies the minimum width of the component. \n- **--calcite-shell-panel-resize-background-color** - Specifies the background color of the resize handle. \n- **--calcite-shell-panel-resize-icon-color** - Specifies the text color of the resize handle. \n- **--calcite-shell-panel-shadow** - When `displayMode` is `\"float-all\"`, specifies the component's shadow. \n- **--calcite-shell-panel-text-color** - Specifies the text color of the component. \n- **--calcite-shell-panel-width** - Specifies the width of the component. \n- **--calcite-shell-panel-z-index** - Specifies the z-index value for the component. ",
+          "description": "### Events\n- **calciteShellPanelCollapse** - Fires when the component's content area is collapsed.\n- **calciteShellPanelExpand** - Fires when the component's content area is expanded.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `updateSize(size: { inline?: number | null; block?: number | null; }): Promise<void>`\n\n### Slots\n- _default_ - A slot for adding custom content.\n- **action-bar** - A slot for adding a `calcite-action-bar` to the component.\n\n### CSS Properties\n- **--calcite-shell-panel-background-color** - Specifies the background color of the component. \n- **--calcite-shell-panel-border-color** - When `displayMode` is `\"float-all\"`, specifies the component's border color. \n- **--calcite-shell-panel-corner-radius** - When `displayMode` is `\"float-all\"`, specifies the component's corner radius. \n- **--calcite-shell-panel-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float` or `float-all`, specifies the height of the component. \n- **--calcite-shell-panel-max-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the maximum height of the component. \n- **--calcite-shell-panel-max-width** - Specifies the maximum width of the component. \n- **--calcite-shell-panel-min-height** - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the minimum height of the component. \n- **--calcite-shell-panel-min-width** - Specifies the minimum width of the component. \n- **--calcite-shell-panel-resize-background-color** - Specifies the background color of the resize handle. \n- **--calcite-shell-panel-resize-icon-color** - Specifies the text color of the resize handle. \n- **--calcite-shell-panel-shadow** - When `displayMode` is `\"float-all\"`, specifies the component's shadow. \n- **--calcite-shell-panel-text-color** - Specifies the text color of the component. \n- **--calcite-shell-panel-width** - Specifies the width of the component. \n- **--calcite-shell-panel-z-index** - Specifies the z-index value for the component. ",
           "attributes": [
             {
               "name": "collapsed",

package/dist/index.js

@@ -1,6 +1,6 @@
 /*! All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.25 */
+v5.0.0-next.27 */
 import { s as setAssetPath$1 } from "./chunks/runtime.js";
 import { g } from "./chunks/runtime.js";
 let assetPathChanged = false;

package/dist/loader.js

@@ -1,6 +1,6 @@
 /*! All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.25 */
+v5.0.0-next.27 */
 import { r as runtime } from "./chunks/runtime.js";
 import { makeDefineCustomElements } from "@arcgis/lumina";
 const defineCustomElements = makeDefineCustomElements(runtime, {
@@ -8,7 +8,7 @@ const defineCustomElements = makeDefineCustomElements(runtime, {
   "calcite-accordion-item": [() => import("./components/calcite-accordion-item/customElement.js"), "accordionParent:,appearance,description,expanded,heading,headingLevel,iconEnd,iconFlipRtl,iconPosition,iconStart,iconType,messageOverrides:,scale;setFocus"],
   "calcite-action": [() => import("./components/calcite-action/customElement.js"), "active,activeDescendant,alignment,appearance,aria:,compact,disabled,dragHandle,form,icon,iconFlipRtl,indicator,label,loading,messageOverrides:,scale,selectionAppearance,text,textEnabled,type,width;setFocus"],
   "calcite-action-bar": [() => import("./components/calcite-action-bar/customElement.js"), "actionsEndGroupLabel,expandDisabled,expanded,floating,layout,messageOverrides:,overflowActionsDisabled,overlayPositioning,position,scale,selectionAppearance;overflowActions,setFocus"],
-  "calcite-action-group": [() => import("./components/calcite-action-group/customElement.js"), "columns,expanded,label,layout,menuFlipPlacements:,menuOpen,menuPlacement,messageOverrides:,overlayPositioning,scale;setFocus"],
+  "calcite-action-group": [() => import("./components/calcite-action-group/customElement.js"), "columns,expanded,label,layout,menuFlipPlacements:,menuOpen,menuPlacement,messageOverrides:,overlayPositioning,scale,selectionMode;setFocus"],
   "calcite-action-menu": [() => import("./components/calcite-action-menu/customElement.js"), "appearance,expanded,flipPlacements:,label,open,overlayPositioning,placement,scale;setFocus"],
   "calcite-action-pad": [() => import("./components/calcite-action-pad/customElement.js"), "actionsEndGroupLabel,expandDisabled,expanded,layout,messageOverrides:,overlayPositioning,position,scale,selectionAppearance;setFocus"],
   "calcite-alert": [() => import("./components/calcite-alert/customElement.js"), "active,autoClose,autoCloseDuration,embedded,icon,iconFlipRtl,kind,label,messageOverrides:,numberingSystem,open,openAlertCount,placement,queue,scale;setFocus"],
@@ -30,7 +30,7 @@ const defineCustomElements = makeDefineCustomElements(runtime, {
   "calcite-color-picker": [() => import("./components/calcite-color-picker/customElement.js"), "alphaChannel,channelsDisabled,clearable,color:,disabled,fieldDisabled,format,hexDisabled,messageOverrides:,numberingSystem,savedDisabled,scale,storageId,value;setFocus"],
   "calcite-color-picker-hex-input": [() => import("./components/calcite-color-picker-hex-input/customElement.js"), "allowEmpty,alphaChannel,hexLabel,messages:,numberingSystem,scale,value;setFocus"],
   "calcite-color-picker-swatch": [() => import("./components/calcite-color-picker-swatch/customElement.js"), "active,color,scale"],
-  "calcite-combobox": [() => import("./components/calcite-combobox/customElement.js"), "allowCustomValues,clearDisabled,disabled,filteredItems:,filterProps:,filterText,flipPlacements:,form,label,labelText,maxItems,messageOverrides:,name,open,overlayPositioning,placeholder,placeholderIcon,placeholderIconFlipRtl,readOnly,required,scale,selectAllEnabled,selectedItems:,selectionDisplay,selectionMode,status,validationIcon,validationMessage,validity:,value;reposition,setFocus"],
+  "calcite-combobox": [() => import("./components/calcite-combobox/customElement.js"), "allowCustomValues,clearDisabled,disabled,filteredItems:,filterProps:,filterText,flipPlacements:,form,label,labelText,maxItems,messageOverrides:,name,open,overlayPositioning,placeholder,placeholderIcon,placeholderIconFlipRtl,placement,readOnly,required,scale,selectAllEnabled,selectedItems:,selectionDisplay,selectionMode,status,validationIcon,validationMessage,validity:,value;reposition,setFocus"],
   "calcite-combobox-item": [() => import("./components/calcite-combobox-item/customElement.js"), "active,ancestors:,description,disabled,filterDisabled,filterTextMatchPattern:,guid,heading,icon,iconFlipRtl,indeterminate,itemHidden,label,metadata:,scale,selected,selectionMode,shortHeading,value;;toggleSelection"],
   "calcite-combobox-item-group": [() => import("./components/calcite-combobox-item-group/customElement.js"), "afterEmptyGroup,ancestors:,itemHidden,label,position,scale"],
   "calcite-date-picker": [() => import("./components/calcite-date-picker/customElement.js"), "activeDate:,activeRange,calendars,headingLevel,layout,max,maxAsDate:,messageOverrides:,min,minAsDate:,monthStyle,numberingSystem,proximitySelectionDisabled,range,scale,value,valueAsDate:;reset,setFocus"],
@@ -84,7 +84,7 @@ const defineCustomElements = makeDefineCustomElements(runtime, {
   "calcite-select": [() => import("./components/calcite-select/customElement.js"), "disabled,form,label,labelText,messageOverrides:,name,required,scale,selectedOption:,status,validationIcon,validationMessage,validity:,value,width;setFocus"],
   "calcite-sheet": [() => import("./components/calcite-sheet/customElement.js"), "beforeClose:,displayMode,embedded,escapeDisabled,focusTrapDisabled,focusTrapOptions:,height,heightScale,label,messageOverrides:,open,opened,outsideCloseDisabled,position,resizable,width,widthScale;setFocus,updateFocusTrapElements"],
   "calcite-shell": [() => import("./components/calcite-shell/customElement.js"), "contentBehind"],
-  "calcite-shell-panel": [() => import("./components/calcite-shell-panel/customElement.js"), "collapsed,displayMode,height,heightScale,layout,messageOverrides:,position,resizable,width,widthScale"],
+  "calcite-shell-panel": [() => import("./components/calcite-shell-panel/customElement.js"), "collapsed,displayMode,height,heightScale,layout,messageOverrides:,position,resizable,width,widthScale;updateSize"],
   "calcite-slider": [() => import("./components/calcite-slider/customElement.js"), "disabled,fillPlacement,form,groupSeparator,hasHistogram,histogram:,histogramStops:,labelFormatter:,labelHandles,labelText,labelTicks,max,maxLabel,maxValue,messageOverrides:,min,minLabel,minValue,mirrored,name,numberingSystem,pageStep,precise,required,scale,snap,status,step,ticks,validationIcon,validationMessage,validity:,value;setFocus"],
   "calcite-sort-handle": [() => import("./components/calcite-sort-handle/customElement.js"), "addToItems:,disabled,flipPlacements:,label,messageOverrides:,messages:,moveToItems:,open,overlayPositioning,placement,scale,setPosition,setSize,sortDisabled,widthScale;setFocus"],
   "calcite-sortable-list": [() => import("./components/calcite-sortable-list/customElement.js"), "canPull:,canPut:,disabled,dragSelector,group,handleSelector,layout,loading"],

package/dist/types/lumina.d.ts

@@ -124,7 +124,7 @@ interface LuminaCalciteActionBar extends Partial<Pick<ActionBar, 'actionsEndGrou
   oncalciteActionBarToggle?: EventHandler<HTMLCalciteActionBarElement["calciteActionBarToggle"]>;
 }
 
-interface LuminaCalciteActionGroup extends Partial<Pick<ActionGroup, 'columns' | 'expanded' | 'label' | 'layout' | 'menuFlipPlacements' | 'menuOpen' | 'menuPlacement' | 'messageOverrides' | 'overlayPositioning' | 'scale'>>, h.JSX.HTMLAttributes<HTMLCalciteActionGroupElement> {
+interface LuminaCalciteActionGroup extends Partial<Pick<ActionGroup, 'columns' | 'expanded' | 'label' | 'layout' | 'menuFlipPlacements' | 'menuOpen' | 'menuPlacement' | 'messageOverrides' | 'overlayPositioning' | 'scale' | 'selectionMode'>>, h.JSX.HTMLAttributes<HTMLCalciteActionGroupElement> {
   oncalciteActionGroupCollapse?: EventHandler<HTMLCalciteActionGroupElement["calciteActionGroupCollapse"]>;
   oncalciteActionGroupExpand?: EventHandler<HTMLCalciteActionGroupElement["calciteActionGroupExpand"]>;
 }
@@ -242,7 +242,7 @@ interface LuminaCalciteColorPickerHexInput extends Partial<Pick<ColorPickerHexIn
 interface LuminaCalciteColorPickerSwatch extends Partial<Pick<ColorPickerSwatch, 'active' | 'color' | 'scale'>>, h.JSX.HTMLAttributes<HTMLCalciteColorPickerSwatchElement> {
 }
 
-interface LuminaCalciteCombobox extends Required<Pick<Combobox, 'label'>>, Partial<Pick<Combobox, 'allowCustomValues' | 'clearDisabled' | 'disabled' | 'filterProps' | 'filterText' | 'flipPlacements' | 'form' | 'labelText' | 'maxItems' | 'messageOverrides' | 'name' | 'open' | 'overlayPositioning' | 'placeholder' | 'placeholderIcon' | 'placeholderIconFlipRtl' | 'readOnly' | 'required' | 'scale' | 'selectAllEnabled' | 'selectionDisplay' | 'selectionMode' | 'status' | 'validationIcon' | 'validationMessage' | 'value'>>, h.JSX.HTMLAttributes<HTMLCalciteComboboxElement> {
+interface LuminaCalciteCombobox extends Required<Pick<Combobox, 'label'>>, Partial<Pick<Combobox, 'allowCustomValues' | 'clearDisabled' | 'disabled' | 'filterProps' | 'filterText' | 'flipPlacements' | 'form' | 'labelText' | 'maxItems' | 'messageOverrides' | 'name' | 'open' | 'overlayPositioning' | 'placeholder' | 'placeholderIcon' | 'placeholderIconFlipRtl' | 'placement' | 'readOnly' | 'required' | 'scale' | 'selectAllEnabled' | 'selectionDisplay' | 'selectionMode' | 'status' | 'validationIcon' | 'validationMessage' | 'value'>>, h.JSX.HTMLAttributes<HTMLCalciteComboboxElement> {
   oncalciteComboboxBeforeClose?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxBeforeClose"]>;
   oncalciteComboboxBeforeOpen?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxBeforeOpen"]>;
   oncalciteComboboxChange?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxChange"]>;

package/dist/types/preact.d.ts

@@ -125,7 +125,7 @@ interface PreactCalciteActionBar extends Partial<Pick<ActionBar, 'actionsEndGrou
   oncalciteActionBarToggle?: EventHandler<HTMLCalciteActionBarElement["calciteActionBarToggle"]>;
 }
 
-interface PreactCalciteActionGroup extends Partial<Pick<ActionGroup, 'columns' | 'expanded' | 'label' | 'layout' | 'menuFlipPlacements' | 'menuOpen' | 'menuPlacement' | 'messageOverrides' | 'overlayPositioning' | 'scale'>>, HTMLAttributes<HTMLCalciteActionGroupElement> {
+interface PreactCalciteActionGroup extends Partial<Pick<ActionGroup, 'columns' | 'expanded' | 'label' | 'layout' | 'menuFlipPlacements' | 'menuOpen' | 'menuPlacement' | 'messageOverrides' | 'overlayPositioning' | 'scale' | 'selectionMode'>>, HTMLAttributes<HTMLCalciteActionGroupElement> {
   oncalciteActionGroupCollapse?: EventHandler<HTMLCalciteActionGroupElement["calciteActionGroupCollapse"]>;
   oncalciteActionGroupExpand?: EventHandler<HTMLCalciteActionGroupElement["calciteActionGroupExpand"]>;
 }
@@ -243,7 +243,7 @@ interface PreactCalciteColorPickerHexInput extends Partial<Pick<ColorPickerHexIn
 interface PreactCalciteColorPickerSwatch extends Partial<Pick<ColorPickerSwatch, 'active' | 'color' | 'scale'>>, HTMLAttributes<HTMLCalciteColorPickerSwatchElement> {
 }
 
-interface PreactCalciteCombobox extends Required<Pick<Combobox, 'label'>>, Partial<Pick<Combobox, 'allowCustomValues' | 'clearDisabled' | 'disabled' | 'filterProps' | 'filterText' | 'flipPlacements' | 'form' | 'labelText' | 'maxItems' | 'messageOverrides' | 'name' | 'open' | 'overlayPositioning' | 'placeholder' | 'placeholderIcon' | 'placeholderIconFlipRtl' | 'readOnly' | 'required' | 'scale' | 'selectAllEnabled' | 'selectionDisplay' | 'selectionMode' | 'status' | 'validationIcon' | 'validationMessage' | 'value'>>, HTMLAttributes<HTMLCalciteComboboxElement> {
+interface PreactCalciteCombobox extends Required<Pick<Combobox, 'label'>>, Partial<Pick<Combobox, 'allowCustomValues' | 'clearDisabled' | 'disabled' | 'filterProps' | 'filterText' | 'flipPlacements' | 'form' | 'labelText' | 'maxItems' | 'messageOverrides' | 'name' | 'open' | 'overlayPositioning' | 'placeholder' | 'placeholderIcon' | 'placeholderIconFlipRtl' | 'placement' | 'readOnly' | 'required' | 'scale' | 'selectAllEnabled' | 'selectionDisplay' | 'selectionMode' | 'status' | 'validationIcon' | 'validationMessage' | 'value'>>, HTMLAttributes<HTMLCalciteComboboxElement> {
   oncalciteComboboxBeforeClose?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxBeforeClose"]>;
   oncalciteComboboxBeforeOpen?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxBeforeOpen"]>;
   oncalciteComboboxChange?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxChange"]>;

package/dist/types/preact10.d.ts

@@ -130,7 +130,7 @@ interface PreactCalciteActionBar extends Partial<Pick<ActionBar, 'actionsEndGrou
 }
 
 /** @deprecated Update to Preact 10.27.2+ or 11+ and consume types/preact file over types/preact10 */
-interface PreactCalciteActionGroup extends Partial<Pick<ActionGroup, 'columns' | 'expanded' | 'label' | 'layout' | 'menuFlipPlacements' | 'menuOpen' | 'menuPlacement' | 'messageOverrides' | 'overlayPositioning' | 'scale'>>, PreactJsx.HTMLAttributes<HTMLCalciteActionGroupElement> {
+interface PreactCalciteActionGroup extends Partial<Pick<ActionGroup, 'columns' | 'expanded' | 'label' | 'layout' | 'menuFlipPlacements' | 'menuOpen' | 'menuPlacement' | 'messageOverrides' | 'overlayPositioning' | 'scale' | 'selectionMode'>>, PreactJsx.HTMLAttributes<HTMLCalciteActionGroupElement> {
   oncalciteActionGroupCollapse?: EventHandler<HTMLCalciteActionGroupElement["calciteActionGroupCollapse"]>;
   oncalciteActionGroupExpand?: EventHandler<HTMLCalciteActionGroupElement["calciteActionGroupExpand"]>;
 }
@@ -270,7 +270,7 @@ interface PreactCalciteColorPickerSwatch extends Partial<Pick<ColorPickerSwatch,
 }
 
 /** @deprecated Update to Preact 10.27.2+ or 11+ and consume types/preact file over types/preact10 */
-interface PreactCalciteCombobox extends Required<Pick<Combobox, 'label'>>, Partial<Pick<Combobox, 'allowCustomValues' | 'clearDisabled' | 'disabled' | 'filterProps' | 'filterText' | 'flipPlacements' | 'form' | 'labelText' | 'maxItems' | 'messageOverrides' | 'name' | 'open' | 'overlayPositioning' | 'placeholder' | 'placeholderIcon' | 'placeholderIconFlipRtl' | 'readOnly' | 'required' | 'scale' | 'selectAllEnabled' | 'selectionDisplay' | 'selectionMode' | 'status' | 'validationIcon' | 'validationMessage' | 'value'>>, PreactJsx.HTMLAttributes<HTMLCalciteComboboxElement> {
+interface PreactCalciteCombobox extends Required<Pick<Combobox, 'label'>>, Partial<Pick<Combobox, 'allowCustomValues' | 'clearDisabled' | 'disabled' | 'filterProps' | 'filterText' | 'flipPlacements' | 'form' | 'labelText' | 'maxItems' | 'messageOverrides' | 'name' | 'open' | 'overlayPositioning' | 'placeholder' | 'placeholderIcon' | 'placeholderIconFlipRtl' | 'placement' | 'readOnly' | 'required' | 'scale' | 'selectAllEnabled' | 'selectionDisplay' | 'selectionMode' | 'status' | 'validationIcon' | 'validationMessage' | 'value'>>, PreactJsx.HTMLAttributes<HTMLCalciteComboboxElement> {
   oncalciteComboboxBeforeClose?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxBeforeClose"]>;
   oncalciteComboboxBeforeOpen?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxBeforeOpen"]>;
   oncalciteComboboxChange?: EventHandler<HTMLCalciteComboboxElement["calciteComboboxChange"]>;