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

package/dist/components/interfaces.d.ts

@@ -2,6 +2,7 @@ import { LuminaJsx } from '@arcgis/lumina';
 import { CamelCase, ReadonlyTuple } from 'type-fest';
 export type Alignment = "start" | "center" | "end";
 export type Appearance = "solid" | "outline" | "outline-fill" | "transparent";
+export type Axis = "inline" | "block";
 export interface Dimensions {
     width: number;
     height: number;

package/dist/controllers/useSizeOverride.d.ts

@@ -0,0 +1,44 @@
+interface AxisBounds {
+    min: number | null;
+    max: number | null;
+}
+interface SizeOverrideContext {
+    /**
+     * Returns both min and max allowed sizes (pixels) for the axis "inline" and "block". Use null for no bound.
+     */
+    readonly getBounds?: () => {
+        inline: AxisBounds;
+        block: AxisBounds;
+    };
+    /**
+     * Callback invoked after an override is applied or cleared so the host can sync internal state.
+     * The value will be a rounded pixel number or null if cleared.
+     */
+    readonly targetElement: {
+        value?: HTMLElement | null;
+    };
+}
+export interface UseSizeOverride {
+    /**
+     * Applies (or clears) an inline/block size override in one call.
+     * Pass `null` to clear size overrides.
+     *
+     * Use when the component needs to set inline styles
+     * to override sizing from user resizing via drag or keyboard.
+     *
+     * Min/max define the allowed range. Any requested size outside that range gets clamped.
+     *
+     */
+    resize: (sizes: {
+        inline?: number | null;
+        block?: number | null;
+    }) => {
+        inline?: number | null;
+        block?: number | null;
+    };
+}
+/**
+ * Creates a controller that manages size overrides on a host element.
+ */
+export declare const useSizeOverride: (context: SizeOverrideContext) => UseSizeOverride;
+export {};

package/dist/docs/api.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",
@@ -904,35 +904,35 @@
               "name": "aria",
               "description": "Use this property to override or extend ARIA properties and attributes on the component's button.",
               "type": {
-                "text": "{\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}",
+                "text": "{\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": [
                   {
                     "name": "Array",
                     "package": "typescript",
                     "module": "lib/lib.es5.d.ts",
-                    "start": 25,
-                    "end": 30
+                    "start": 77,
+                    "end": 82
                   },
                   {
                     "name": "Array",
                     "package": "typescript",
                     "module": "lib/lib.es5.d.ts",
-                    "start": 67,
-                    "end": 72
+                    "start": 119,
+                    "end": 124
                   },
                   {
                     "name": "Array",
                     "package": "typescript",
                     "module": "lib/lib.es5.d.ts",
-                    "start": 244,
-                    "end": 249
+                    "start": 296,
+                    "end": 301
                   },
                   {
                     "name": "Array",
                     "package": "typescript",
                     "module": "lib/lib.es5.d.ts",
-                    "start": 279,
-                    "end": 284
+                    "start": 331,
+                    "end": 336
                   }
                 ]
               },
@@ -2430,6 +2430,35 @@
               "attribute": "scale",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "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": {
+                "text": "\"multiple\" | \"none\" | \"single\" | \"single-persist\"",
+                "values": [
+                  {
+                    "value": "multiple",
+                    "type": "string"
+                  },
+                  {
+                    "value": "none",
+                    "type": "string"
+                  },
+                  {
+                    "value": "single",
+                    "type": "string"
+                  },
+                  {
+                    "value": "single-persist",
+                    "type": "string"
+                  }
+                ]
+              },
+              "default": "\"none\"",
+              "attribute": "selection-mode",
+              "reflects": true
+            },
             {
               "kind": "method",
               "name": "setFocus",
@@ -2713,6 +2742,33 @@
               },
               "default": "\"m\"",
               "fieldName": "scale"
+            },
+            {
+              "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).",
+              "type": {
+                "text": "\"multiple\" | \"none\" | \"single\" | \"single-persist\"",
+                "values": [
+                  {
+                    "value": "multiple",
+                    "type": "string"
+                  },
+                  {
+                    "value": "none",
+                    "type": "string"
+                  },
+                  {
+                    "value": "single",
+                    "type": "string"
+                  },
+                  {
+                    "value": "single-persist",
+                    "type": "string"
+                  }
+                ]
+              },
+              "default": "\"none\"",
+              "fieldName": "selectionMode"
             }
           ],
           "events": [
@@ -14044,6 +14100,103 @@
               "attribute": "placeholder-icon-flip-rtl",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "placement",
+              "description": "Determines where the component will be positioned relative to the `referenceElement`.",
+              "type": {
+                "text": "\"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\"",
+                "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"
+                  }
+                ]
+              },
+              "default": "\"bottom-start\"",
+              "attribute": "placement",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "readOnly",
@@ -14594,6 +14747,101 @@
               "default": "false",
               "fieldName": "placeholderIconFlipRtl"
             },
+            {
+              "name": "placement",
+              "description": "Determines where the component will be positioned relative to the `referenceElement`.",
+              "type": {
+                "text": "\"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\"",
+                "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"
+                  }
+                ]
+              },
+              "default": "\"bottom-start\"",
+              "fieldName": "placement"
+            },
             {
               "name": "read-only",
               "description": "When `true`, the component's value can be read, but controls are not accessible and the value cannot be modified.",
@@ -15147,7 +15395,7 @@
             {
               "kind": "field",
               "name": "value",
-              "description": "The component's value.",
+              "description": "The component's value. Falls back to `heading` if not provided.",
               "type": {
                 "text": "any",
                 "values": [
@@ -15156,7 +15404,8 @@
                   }
                 ]
               },
-              "attribute": "value"
+              "attribute": "value",
+              "reflects": true
             }
           ],
           "attributes": [
@@ -15313,7 +15562,7 @@
             },
             {
               "name": "value",
-              "description": "The component's value.",
+              "description": "The component's value. Falls back to `heading` if not provided.",
               "type": {
                 "text": "any",
                 "values": [
@@ -44119,6 +44368,33 @@
               "attribute": "resizable",
               "reflects": true
             },
+            {
+              "kind": "method",
+              "name": "updateSize",
+              "parameters": [
+                {
+                  "name": "size",
+                  "type": {
+                    "text": "{\n    inline?: number;\n    block?: number;\n}"
+                  }
+                }
+              ],
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "typescript",
+                      "module": "lib/lib.es5.d.ts",
+                      "start": 0,
+                      "end": 7
+                    }
+                  ]
+                }
+              },
+              "signature": "(size: { inline?: number | null; block?: number | null; }): Promise<void>"
+            },
             {
               "kind": "field",
               "name": "width",