@arcgis/map-components 5.0.0-next.8 → 5.0.0-next.81

package/dist/components/arcgis-layer-list/customElement.d.ts

@@ -5,9 +5,9 @@ import { default as LayerList } from '@arcgis/core/widgets/LayerList.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useLayerListWidget: (component: LitElement & Pick<LayerList, "label" | "viewModel" | "icon" | "headingLevel" | "collapsed" | "dragEnabled" | "filterPlaceholder" | "filterPredicate" | "filterText" | "selectionMode" | "catalogOptions" | "minFilterItems" | "selectedItems" | "visibilityAppearance" | "listItemCreatedFunction" | "knowledgeGraphOptions" | "minDragEnabledItems"> & {
+declare const useLayerListWidget: (component: LitElement & Pick<LayerList, "label" | "viewModel" | "icon" | "headingLevel" | "collapsed" | "dragEnabled" | "filterPlaceholder" | "filterPredicate" | "filterText" | "selectionMode" | "catalogOptions" | "minFilterItems" | "selectedItems" | "visibilityAppearance" | "listItemCreatedFunction" | "knowledgeGraphOptions" | "minDragEnabledItems" | "operationalItems"> & {
     state?: unknown;
-    viewModel?: __esri.LayerListViewModel | undefined;
+    viewModel?: import('@arcgis/core/widgets/LayerList/LayerListViewModel').default | undefined;
     closed?: boolean;
     icon: import('@arcgis/toolkit/type').nil | string;
     label: import('@arcgis/toolkit/type').nil | string;
@@ -42,11 +42,9 @@ export declare class ArcgisLayerList extends LitElement {
     readonly arcgisClose: TargetedEvent<this>;
     /**
      * The view associated with the component.
-     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisLayerList component will be associated with a map or scene component rather than using the `view` property.
-     *
-     * @default null
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Layer List component will be associated with a map or scene component rather than using the `view` property.
      */
-    view?: __esri.MapView | __esri.SceneView | nullish;
+    view?: import('@arcgis/core/views/MapViewOrSceneView').MapViewOrSceneView | null | undefined;
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
@@ -61,109 +59,257 @@ export declare class ArcgisLayerList extends LitElement {
     get catalogLayerList(): __esri.CatalogLayerList | nullish;
     /**
      * [CatalogLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html) specific properties.
+     * Catalog layers will display their [CatalogLayer#dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html#dynamicGroupLayer) as an expandable [catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#catalogLayerList) in the LayerList widget.
+     * This list item will only be displayed when catalog layers with dynamic group layers are loaded in the map.
+     * These are the properties that are used to configure the [catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#catalogLayerList).
      *
-     * @default null
+     * @since 4.30
+     * @see [catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#catalogLayerList)
+     * @example
+     * const layerList = new LayerList({
+     *   catalogOptions: {
+     *     listItemCreatedFunction: (event) => {
+     *       const { item } = event;
+     *       item.actionsSections = [
+     *         [
+     *           {
+     *             title: "Add layer to map",
+     *             icon: "add-layer",
+     *             id: "add-layer"
+     *           }
+     *         ]
+     *       ];
+     *     },
+     *     selectionMode: "single",
+     *     visibleElements: {
+     *       filter: true
+     *     }
+     *   },
+     *   view,
+     * });
      */
-    catalogOptions: nullish | __esri.LayerListCatalogOptions;
+    catalogOptions: import('@arcgis/core/widgets/CatalogLayerList').CatalogLayerListProperties | null | undefined;
     /**
      * Indicates whether a component is closed. When `true`, the component will be hidden.
      *
-     * @since 4.33
      * @default false
+     * @since 4.33
      */
     closed: boolean;
     /**
      * Indicates whether the widget is collapsed.
+     * When collapsed, only the collapse button and heading are displayed.
      *
      * @default false
+     * @since 4.29
+     * @see [visibleElements.collapseButton](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#visibleElements)
+     * @example layerList.collapsed = true;
      */
     collapsed: boolean;
     /**
      * Indicates whether [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html) may be reordered within the list by dragging and dropping.
+     * MapImageLayer [MapImageLayer#sublayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapImageLayer.html#sublayers) can be reordered only within their parent MapImageLayer and can not be dragged out as a separate layer.
+     * Drag won't be enabled until the number of list items is equal to or greater than than the value set set in [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#minDragEnabledItems).
      *
      * @default false
+     * @since 4.29
+     * @see [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#minDragEnabledItems)
+     * @example layerList.dragEnabled = true;
      */
     dragEnabled: boolean;
     /**
      * Placeholder text used in the filter input if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#visibleElements) is true.
      *
      * @default ""
+     * @since 4.29
+     * @see [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#visibleElements)
+     * @example layerList.filterPlaceholder = "Filter layers";
      */
     filterPlaceholder: string;
     /**
      * Specifies a function to handle filtering [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html).
      *
-     * @default null
+     * @since 4.32
+     * @example layerList.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
      */
-    filterPredicate: nullish | __esri.LayerListFilterPredicate;
+    filterPredicate: import('@arcgis/core/widgets/LayerList/types').FilterPredicate | null | undefined;
     /**
      * The value of the filter input if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#visibleElements) is true.
      *
      * @default ""
+     * @since 4.29
+     * @see [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#visibleElements)
+     * @example
+     * reactiveUtils.watch(
+     *   () => layerList.filterText,
+     *   (filterText) => console.log(filterText)
+     * );
      */
     filterText: string;
     /**
      * Indicates the heading level to use for the heading of the widget.
+     * By default, the heading is rendered as a level 2 heading (e.g., `<h2>Layer List</h2>`).
+     * Depending on the widget's placement in your app, you may need to adjust this heading for proper semantics.
+     * This is important for meeting accessibility standards.
      *
      * @default 2
+     * @since 4.29
+     * @see [visibleElements.heading](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#visibleElements)
+     * @example layerList.headingLevel = 3;
+     */
+    headingLevel: import('@arcgis/core/widgets/support/types').HeadingLevel;
+    /**
+     * **Since 4.30** Indicates whether to display the [LayerList#catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#catalogLayerList).
+     *
+     * @default true
      */
-    headingLevel: number;
-    /** @default false */
     hideCatalogLayerList: boolean;
-    /** @default false */
+    /**
+     * **Since 4.29** Determines whether the widget should be shown within its built-in [flow component](https://developers.arcgis.com/calcite-design-system/components/flow/) or if the flow component should be excluded. The widget will be displayed within its original flow component if set to `true`. The flow component will be omitted from the widget if set to `false`. To place the widget into an existing Calcite flow component, set this property to `false`.
+     *
+     * @default true
+     */
     hideFlow: boolean;
-    /** @default false */
+    /**
+     * Indicates whether the status indicators will be displayed.
+     *
+     * @default true
+     */
     hideStatusIndicators: boolean;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "layers"
+     * @since 4.27
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
     icon: string;
     /**
      * [KnowledgeGraphLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-KnowledgeGraphLayer.html) specific properties.
+     * Knowledge graph layers will display sublayer [KnowledgeGraphLayer#tables](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-KnowledgeGraphLayer.html#tables)
+     * as an expandable [tableList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#tableList) in the LayerList widget.
+     * This tables list item will only be displayed when knowledge graph layers with tables are loaded in the map.
+     * These are the properties that are used to configure the [tableList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#tableList).
      *
-     * @default null
+     * @since 4.30
+     * @see [tableList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#tableList)
+     * @example
+     * layerList.knowledgeGraphOptions = {
+     *   filterPlaceholder: "Filter tables",
+     *   listItemCreatedFunction: (event) => {
+     *     const { item } = event;
+     *     item.actionsSections = [
+     *       [
+     *         {
+     *           icon: "table",
+     *           id: "open-table",
+     *           title: "Show table"
+     *         },
+     *         {
+     *           icon: "information",
+     *           id: "information",
+     *           title: "Show information"
+     *         }
+     *       ]
+     *     ];
+     *   },
+     *   minFilterItems: 1,
+     *   visibleElements: {
+     *     errors: true,
+     *     filter: true,
+     *     statusIndicators: true
+     *   }
+     * }
      */
-    knowledgeGraphOptions: nullish | __esri.LayerListKnowledgeGraphOptions;
+    knowledgeGraphOptions: import('@arcgis/core/widgets/TableList').TableListProperties | null | undefined;
     /**
      * The widget's default label.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#label)
+     * @since 4.7
      */
     label: string;
     /**
      * A function that executes each time a [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html) is created.
+     * Use this function to add actions and panels to list items, and to override
+     * the default settings of a list item. Actions can be added to list items
+     * using the [ListItem#actionsSections](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html#actionsSections)
+     * property of the ListItem.
+     *
+     * @since 4.4
+     * @see [Sample - LayerList widget with actions](https://developers.arcgis.com/javascript/latest/sample-code/widgets-layerlist-actions/)
+     * @example
+     * let layerList = new LayerList({
+     *   view: view,
+     *   // executes for each ListItem in the LayerList
+     *   listItemCreatedFunction: async function (event) {
+     *
+     *     // The event object contains properties of the
+     *     // layer in the LayerList widget.
+     *
+     *     let item = event.item;
+     *
+     *     // Wait for the layer to load and the item title to become available
+     *     await item.layer.when();
      *
-     * @default null
+     *     if (item.title === "US Demographics") {
+     *       // open the list item in the LayerList
+     *       item.open = true;
+     *       // change the title to something more descriptive
+     *       item.title = "Population by county";
+     *       // set an action for zooming to the full extent of the layer
+     *       item.actionsSections = [[{
+     *         title: "Go to full extent",
+     *         className: "esri-icon-zoom-out-fixed",
+     *         id: "full-extent"
+     *       }]];
+     *     }
+     *   }
+     * });
      */
-    listItemCreatedFunction: nullish | __esri.LayerListListItemCreatedHandler;
+    listItemCreatedFunction: import('@arcgis/core/widgets/LayerList/types').ListItemModifier | null | undefined;
     /**
      * The minimum number of list items required to enable drag and drop reordering with [dragEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#dragEnabled).
      *
      * @default 2
+     * @since 4.29
+     * @see [dragEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#dragEnabled)
+     * @example
+     * layerList.dragEnabled = true;
+     * layerList.minDragEnabledItems = 5;
      */
     minDragEnabledItems: number;
     /**
-     * The minimum number of list items required to display the visibleElements.filter input box.
+     * The minimum number of list items required to display the [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-LayerListVisibleElements.html) input box.
      *
      * @default 10
+     * @since 4.29
+     * @see [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-LayerListVisibleElements.html)
+     * @example
+     * layerList.visibleElements.filter = true;
+     * layerList.minFilterItems = 5;
      */
     minFilterItems: number;
     /**
      * A collection of [Layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html)s that are opened
      * in a [catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#catalogLayerList) or [tableList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#tableList) flow item.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#openedLayers)
+     * This property is useful for backing out of the catalog layer list or table list
+     * programmatically to the parent layer list.
      *
      * @default []
+     * @since 4.31
+     * @see [catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#catalogLayerList)
+     * @see [tableList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#tableList)
+     * @example
+     * // back out of the catalog layer list to the main layer list
+     * layerList.openedLayers.pop();
      */
-    readonly openedLayers: __esri.Collection<__esri.Layer>;
+    openedLayers: import('@arcgis/core/core/Collection').default<import('@arcgis/core/widgets/LayerList.js').FlowLayer>;
     /** A collection of ListItems representing operational layers. */
     get operationalItems(): __esri.Collection<__esri.ListItem>;
-    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    /** @deprecated since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead. */
     position?: __esri.UIPosition;
     /**
      * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
@@ -175,43 +321,89 @@ export declare class ArcgisLayerList extends LitElement {
      * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html)s representing operational layers
      * selected by the user.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#selectedItems)
+     * @see [selectionMode](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#selectionMode)
      */
-    selectedItems: __esri.Collection<__esri.ListItem>;
+    selectedItems: import('@arcgis/core/core/Collection').default<import('@arcgis/core/widgets/LayerList/ListItem').default>;
     /**
      * Specifies the selection mode.
+     * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#selectedItems) property.
+     *
+     * | Value | Description |
+     * | ----- | ----------- |
+     * | multiple | Allows any number of items to be selected at once. This is useful when you want to apply an operation to multiple items at the same time. |
+     * | none | Disables selection. Use this when you want to prevent selecting items. |
+     * | single | Allows only one item to be selected at a time. If another item is selected, the previous selection is cleared. This is useful when you want to ensure that a maximum of one item is selected at a time. |
+     * | single-persist | Allows only one item to be selected at a time and prevents de-selection. Once an item is selected, it remains selected until another item is selected. This is useful when you want to ensure that there is always exactly one selected item. |
      *
      * @default "none"
+     * @since 4.29
+     * @see [selectedItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#selectedItems)
+     * @example layerList.selectionMode = "multiple";
      */
     selectionMode: "multiple" | "single" | "none" | "single-persist";
-    /** @default false */
+    /**
+     * **Since 4.29** Indicates whether to display a close button in the header.
+     *
+     * @default false
+     */
     showCloseButton: boolean;
-    /** @default false */
+    /**
+     * **Since 4.29** Indicates whether to display a collapse button in the header.
+     *
+     * @default false
+     */
     showCollapseButton: boolean;
-    /** @default false */
+    /**
+     * **Since 4.25** Indicates whether to display layers with load errors.
+     *
+     * @default false
+     */
     showErrors: boolean;
-    /** @default false */
+    /**
+     * **Since 4.29** Indicates whether to display a filter input box when then number of list items is equal to or greater than the value set in [LayerList#minFilterItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#minFilterItems), allowing users to filter layers by their title.
+     *
+     * @default false
+     */
     showFilter: boolean;
-    /** @default false */
+    /**
+     * **Since 4.29** Indicates whether to display the widget heading. The heading text is "Layer List". The heading level can be set with the [LayerList#headingLevel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#headingLevel).
+     *
+     * @default false
+     */
     showHeading: boolean;
-    /** @default false */
+    /**
+     * **Since 4.29** Indicates whether temporary layer indicators will be displayed for layers with [Layer#persistenceEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html#persistenceEnabled) set to `false`. A [temporary icon](https://developers.arcgis.com/calcite-design-system/icons/?icon=temporary&library=Calcite%20UI&query=temporary) will be displayed on the near side of the layer title.
+     *
+     * @default false
+     */
     showTemporaryLayerIndicators: boolean;
     /**
      * The current state of the component.
      *
      * @default "disabled"
      */
-    readonly state: "ready" | "loading" | "disabled";
+    state: import('@arcgis/core/widgets/LayerList/types').State;
     /** The TableList that displays the tables associated with a KnowledgeGraphLayer. */
     get tableList(): __esri.TableList | nullish;
     /**
      * Determines the icons used to indicate visibility.
      *
+     * | Value | Description | Example |
+     * | ----- | ----------- | ------- |
+     * | default | Displays view icons on the far side. Icons are hidden except on hover or if they have keyboard focus. See [view-visible](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-visible&library=Calcite%20UI&query=view) and [view-hide](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-hide&library=Calcite%20UI&query=view) calcite icons. | ![visibilityAppearance-default](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/layer-list/visibilityAppearance-default.png) |
+     * | checkbox | Displays checkbox icons on the near side. See [check-square-f](https://developers.arcgis.com/calcite-design-system/icons/?icon=check-square-f&library=Calcite%20UI&query=check) and [square](https://developers.arcgis.com/calcite-design-system/icons/?icon=square&library=Calcite%20UI&query=square) calcite icons. | ![visibilityAppearance-checkbox](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/layer-list/visibilityAppearance-checkbox.png) |
+     *
      * @default "default"
+     * @since 4.29
+     * @example layerList.visibilityAppearance = "checkbox";
      */
-    visibilityAppearance: "default" | "checkbox";
+    visibilityAppearance: import('@arcgis/core/widgets/LayerList/types').VisibilityAppearance;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /**
+     * @param action
+     * @param item
+     */
     triggerAction(action: __esri.ActionButton | __esri.ActionToggle, item: __esri.ListItem): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
@@ -220,6 +412,6 @@ export declare class ArcgisLayerList extends LitElement {
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     /** Emitted when an action is triggered on the component. */
-    readonly arcgisTriggerAction: TargetedEvent<this, __esri.LayerListTriggerActionEvent>;
+    readonly arcgisTriggerAction: TargetedEvent<this, import('@arcgis/core/widgets/LayerList/LayerListViewModel').LayerListViewModelTriggerActionEvent>;
 }
 export {};

package/dist/components/arcgis-layer-list/customElement.js

@@ -8,7 +8,7 @@ import { s as d } from "../../chunks/layer-list.js";
 import { c as n } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.8 */
+v5.0.0-next.81 */
 const g = h(r);
 class c extends o {
   constructor() {

package/dist/components/arcgis-layer-list-item/customElement.js

@@ -10,7 +10,7 @@ import { s as E } from "../../chunks/layer-list.js";
 import { u as x } from "../../chunks/useT9n.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.8 */
+v5.0.0-next.81 */
 const D = {
   hideChildren: "hide-children"
 };

package/dist/components/arcgis-legend/customElement.d.ts

@@ -70,6 +70,15 @@ declare const useLegendViewModel: (component: LitElement & Pick<LegendViewModel,
  *
  * [![Relationship](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-relationship.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-sm-relationship/)
  *
+ *
+ * ## Legend labels
+ *
+ * Legend text is directly controlled through the [layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html) and [renderer](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-Renderer.html) properties. For example, `layer.title` is directly used by the legend to present a layer's symbology to the end user. To override this text, you can directly update `layer.title`.
+ *
+ * Furthermore, you can control date and number formatting in Legend by using the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FieldConfiguration.html) formatting options on the layer. As an alternative to this, you can override Legend text via the renderer's properties. For example, the renderer may have a [legendOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-ClassBreaksRenderer.html#legendOptions) property (or a label property in the case of visual variable stops or UniqueValueInfos) that can be used to override default legend text describing the renderer element in question. The [Update legend text sample](https://developers.arcgis.com/javascript/latest/sample-code/legend-update/) provides an example of overriding legend text via the renderer.
+ *
+ * Note that when you override legend text, all formatting and localization that would otherwise be dynamically applied to labels will no longer apply.
+ *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/)
  *
  * @see [Sample - Legend component](https://developers.arcgis.com/javascript/latest/sample-code/legend/)
@@ -81,23 +90,23 @@ declare const useLegendViewModel: (component: LitElement & Pick<LegendViewModel,
 export declare class ArcgisLegend extends LitElement {
     /**
      * The view associated with the component.
-     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisLegend component will be associated with a map or scene component rather than using the `view` property.
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Legend component will be associated with a map or scene component rather than using the `view` property.
      */
-    view?: __esri.MapView | __esri.SceneView | nullish;
+    view?: import('@arcgis/core/views/MapViewOrSceneView').MapViewOrSceneView | import('@arcgis/core/views/LinkChartView').default | null | undefined;
     /**
      * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
      *
      * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
      */
     referenceElement?: ArcgisReferenceElement | string;
-    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    /** @deprecated since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead. */
     position?: __esri.UIPosition;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "legend"
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
     icon?: string;
     /**
@@ -107,11 +116,12 @@ export declare class ArcgisLegend extends LitElement {
      *
      * @autocast { "value": "Object[]", "typedCollection": true }
      */
-    activeLayerInfos: __esri.Collection<__esri.ActiveLayerInfo>;
+    activeLayerInfos: import('@arcgis/core/core/Collection').default<import('@arcgis/core/widgets/Legend/support/ActiveLayerInfo').default>;
     /**
      * Indicates whether to show the [Basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html) layers in the Legend. If you set this property to
      * `true` and specify [layerInfos](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#layerInfos) that include the basemap layers, the basemap will be displayed in the legend.
      *
+     * @default false
      * @example
      * Show basemap layers in the legend
      *
@@ -122,13 +132,14 @@ export declare class ArcgisLegend extends LitElement {
      * legend.layerInfos = [{ layer: basemapLayer }];
      * legend.basemapLegendVisible = true;
      * ```
-     * @default false
+     * @example legend.viewModel.basemapLegendVisible = true;
      */
     basemapLegendVisible: boolean;
     /**
      * Indicates the heading level to use for the legend title. By default, legend titles are rendered as level 3 headings (e.g. `<h3>Legend title</h3>`). Depending on the legend placement
      * in your app, you may need to adjust this heading for proper semantics. This is important for meeting accessibility standards.
      *
+     * @default 3
      * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
      * @example
      * Legend title will render as an `<h2>`
@@ -140,7 +151,6 @@ export declare class ArcgisLegend extends LitElement {
      * ```js
      * document.querySelector("arcgis-legend").headingLevel = 2;
      * ```
-     * @default 3
      */
     headingLevel: HeadingLevel;
     /**
@@ -150,6 +160,7 @@ export declare class ArcgisLegend extends LitElement {
      *
      * To hide layers completely from the legend, you should set the `legendEnabled` property of the layer to `false`.
      *
+     * @default false
      * @see [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility)
      * @example
      * Layers not displayed in the current map extent will not be shown in the legend
@@ -161,7 +172,12 @@ export declare class ArcgisLegend extends LitElement {
      * ```js
      * document.querySelector("arcgis-legend").hideLayersNotInCurrentView = true;
      * ```
-     * @default false
+     * @since 4.21
+     * @see [respectLayerVisibility](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Legend-LegendViewModel.html#respectLayerVisibility)
+     * @example
+     * // layers not displayed in the view
+     * // will not be shown in the legend
+     * legend.viewModel.hideLayersNotInCurrentView = true;
      */
     hideLayersNotInCurrentView: boolean;
     /**
@@ -169,6 +185,7 @@ export declare class ArcgisLegend extends LitElement {
      * [definition](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#definitionExpression)
      * will be displayed in the legend when set to true.
      *
+     * @default false
      * @since 4.30
      * @see [definitionExpression](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#definitionExpression)
      * @example
@@ -181,7 +198,7 @@ export declare class ArcgisLegend extends LitElement {
      * ```js
      * document.querySelector("arcgis-legend").respectLayerDefinitionExpression = true;
      * ```
-     * @default false
+     * @see [FeatureLayer#definitionExpression](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#definitionExpression)
      */
     respectLayerDefinitionExpression: boolean;
     /**
@@ -198,6 +215,7 @@ export declare class ArcgisLegend extends LitElement {
      * layer in the map will always display, thus disregarding the `minScale`, `maxScale`,
      * and `legendEnabled` properties for each layer in the map.
      *
+     * @default false
      * @since 4.34
      * @see [hideLayersNotInCurrentView](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#hideLayersNotInCurrentView)
      * @example
@@ -210,7 +228,6 @@ export declare class ArcgisLegend extends LitElement {
      * ```js
      * document.querySelector("arcgis-legend").ignoreLayerVisibility = true;
      * ```
-     * @default false
      */
     get ignoreLayerVisibility(): boolean;
     set ignoreLayerVisibility(value: boolean);
@@ -228,6 +245,8 @@ export declare class ArcgisLegend extends LitElement {
      * layer in the map will always display, thus disregarding the `minScale`, `maxScale`,
      * and `legendEnabled` properties for each layer in the map.
      *
+     * @deprecated since 4.34 use [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility) instead.
+     * @default false
      * @see [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility)
      * @example
      * Always displays legend elements for the map's layers regardless of their minScale, maxScale, and legendEnabled properties.
@@ -239,8 +258,6 @@ export declare class ArcgisLegend extends LitElement {
      * ```js
      * document.querySelector("arcgis-legend").respectLayerVisibilityDisabled = true;
      * ```
-     * @deprecated since 4.34 use [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility) instead.
-     * @default false
      */
     get respectLayerVisibilityDisabled(): boolean;
     set respectLayerVisibilityDisabled(value: boolean);
@@ -265,12 +282,12 @@ export declare class ArcgisLegend extends LitElement {
      * });
      * ```
      */
-    layerInfos: __esri.LegendViewModelLayerInfo[];
+    layerInfos: import('@arcgis/core/widgets/types').LayerInfo[];
     /**
      * Indicates whether the legend is currently loading.
      *
-     * @since 4.34
      * @default false
+     * @since 4.34
      */
     readonly loading: boolean;
     /**
@@ -301,6 +318,7 @@ export declare class ArcgisLegend extends LitElement {
      *
      * [![legend-style](https://developers.arcgis.com/javascript/latest/assets/img/components/legend/legend-style.png)](https://developers.arcgis.com/javascript/latest/sample-code/legend-card/)
      *
+     * @default "classic"
      * @see [cardStyleLayout](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#cardStyleLayout)
      * @example
      * Renders the legend in the card style with a stack layout
@@ -311,7 +329,6 @@ export declare class ArcgisLegend extends LitElement {
      *   layout: "stack"
      * };
      * ```
-     * @default "classic"
      */
     legendStyle: "card" | "classic" | {
         type: "card" | "classic";
@@ -327,7 +344,13 @@ export declare class ArcgisLegend extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
-    /** Overwrite localized strings for this component */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     *
+     * @since 4.34
+     */
     messageOverrides?: typeof this.messages._overrides;
     /**
      * The component's default label.
@@ -340,7 +363,7 @@ export declare class ArcgisLegend extends LitElement {
      *
      * @default "disabled"
      */
-    readonly state: "ready" | "disabled";
+    state: import('@arcgis/core/widgets/Legend/LegendViewModel.js').LegendViewModelState;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */