@arcgis/map-components 5.2.0-next.87 → 5.2.0-next.89

package/dist/components/arcgis-catalog-layer-list-next/types.d.ts

@@ -1,6 +1,41 @@
-/**
- * * Describes the current state of the list items in the [CatalogLayerListViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/CatalogLayerListViewModel/).
- *
- * @since 5.2
- */
-export type CatalogLayerListState = "disabled" | "loading" | "ready";
+import type CatalogLayer from "@arcgis/core/layers/CatalogLayer.js";
+import type KnowledgeGraphLayer from "@arcgis/core/layers/KnowledgeGraphLayer.js";
+import type MapImageLayer from "@arcgis/core/layers/MapImageLayer.js";
+import type TileLayer from "@arcgis/core/layers/TileLayer.js";
+import type CatalogItemCollection from "@arcgis/core/layers/list/CatalogItemCollection.js";
+import type { useT9n } from "../../controllers/useT9n.js";
+import type { ArcgisTableList } from "../arcgis-table-list/customElement.js";
+import type { ArcgisCatalogLayerListNext } from "./customElement.js";
+
+/** @internal */
+export type CatalogLayerListMessageOverrides = ReturnType<typeof useT9n<{
+    componentLabel: string;
+    noItemsToDisplay: string;
+    layerInvisibleAtScale: string;
+    layerInvisibleAtTime: string;
+    layerError: string;
+    untitledLayer: string;
+    layerVisibility: string;
+    showLayer: string;
+    hideLayer: string;
+    layerIncompatible: string;
+    layerIncompatibleTooltip: string;
+    temporary: string;
+    tables: string;
+    catalogLayers: string;
+}>>["_overrides"];
+
+/** The properties used to configure the Catalog Layer List (next). */
+export type CatalogLayerListOptions = Partial<Pick<ArcgisCatalogLayerListNext, "filterPlaceholder" | "hideStatusIndicators" | "minFilterItems" | "selectionMode" | "showErrors" | "showFilter" | "showTemporaryLayerIndicators" | "visibilityAppearance">>
+  & {
+  listItemCreatedFunction?: CatalogItemCollection["listItemCreatedFunction"];
+};
+
+/** @internal */
+export type FlowLayer = CatalogLayer | SubtablesLayer;
+
+/** @internal */
+export type FlowList = ArcgisCatalogLayerListNext | ArcgisTableList;
+
+/** @internal */
+export type SubtablesLayer = KnowledgeGraphLayer | MapImageLayer | TileLayer;

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

@@ -20,6 +20,15 @@ export abstract class ArcgisCompass extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-compass auto-destroy-disabled></arcgis-compass>
+   * ```
+   *
+   * ```js
+   * compassElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-coordinate-conversion/customElement.d.ts

@@ -54,6 +54,15 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-coordinate-conversion auto-destroy-disabled></arcgis-coordinate-conversion>
+   * ```
+   *
+   * ```js
+   * coordinateConversionElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-coordinate-conversion-next/customElement.d.ts

@@ -61,6 +61,15 @@ export abstract class ArcgisCoordinateConversionNext extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-coordinate-conversion-next auto-destroy-disabled></arcgis-coordinate-conversion-next>
+   * ```
+   *
+   * ```js
+   * coordinateConversionNextElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -88,6 +88,15 @@ export abstract class ArcgisDaylight extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-daylight auto-destroy-disabled></arcgis-daylight>
+   * ```
+   *
+   * ```js
+   * daylightElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-direct-line-measurement-3d/customElement.d.ts

@@ -132,6 +132,15 @@ export abstract class ArcgisDirectLineMeasurement3d extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-direct-line-measurement-3d auto-destroy-disabled></arcgis-direct-line-measurement-3d>
+   * ```
+   *
+   * ```js
+   * directLineMeasurement-3dElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-directional-pad/customElement.d.ts

@@ -28,6 +28,15 @@ export abstract class ArcgisDirectionalPad extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-directional-pad auto-destroy-disabled></arcgis-directional-pad>
+   * ```
+   *
+   * ```js
+   * directionalPadElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -65,6 +65,15 @@ export abstract class ArcgisDirections extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-directions auto-destroy-disabled></arcgis-directions>
+   * ```
+   *
+   * ```js
+   * directionsElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-distance-measurement-2d/customElement.d.ts

@@ -95,6 +95,15 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-distance-measurement-2d auto-destroy-disabled></arcgis-distance-measurement-2d>
+   * ```
+   *
+   * ```js
+   * distanceMeasurement-2dElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -33,6 +33,15 @@ export abstract class ArcgisEditor extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-editor auto-destroy-disabled></arcgis-editor>
+   * ```
+   *
+   * ```js
+   * editorElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-elevation-profile/customElement.d.ts

@@ -234,6 +234,15 @@ export abstract class ArcgisElevationProfile extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-elevation-profile auto-destroy-disabled></arcgis-elevation-profile>
+   * ```
+   *
+   * ```js
+   * elevationProfileElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -39,6 +39,15 @@ export abstract class ArcgisExpand extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-expand auto-destroy-disabled></arcgis-expand>
+   * ```
+   *
+   * ```js
+   * expandElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -36,6 +36,15 @@ export abstract class ArcgisFeature extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature auto-destroy-disabled></arcgis-feature>
+   * ```
+   *
+   * ```js
+   * featureElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-feature-form/customElement.d.ts

@@ -19,6 +19,15 @@ export abstract class ArcgisFeatureForm extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature-form auto-destroy-disabled></arcgis-feature-form>
+   * ```
+   *
+   * ```js
+   * featureFormElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-feature-next/customElement.d.ts

@@ -36,6 +36,15 @@ export abstract class ArcgisFeatureNext extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature-next auto-destroy-disabled></arcgis-feature-next>
+   * ```
+   *
+   * ```js
+   * featureNextElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -92,9 +101,19 @@ export abstract class ArcgisFeatureNext extends LitElement {
    */
   get heading(): string;
   /**
-   * Indicates the heading level to use for the headings in the component.
+   * Indicates the heading level to use for the heading of the component. By default, the heading is rendered as a `<h2>`. Depending on the component's placement in your app, you may need to adjust this heading for proper semantics. This is important for meeting accessibility standards.
    *
    * @default 2
+   * @see [HTML heading elements](https://developer.mozilla.org/docs/Web/HTML/Element/Heading_Elements)
+   * @example
+   * ```html
+   * <arcgis-feature-next heading-level="2"></arcgis-feature-next>
+   * ```
+   *
+   * ```js
+   * featureNextElement.headingLevel = 2;
+   * ```
+   * 
    */
   accessor headingLevel: HeadingLevel;
   /**
@@ -131,6 +150,15 @@ export abstract class ArcgisFeatureNext extends LitElement {
    * Indicates whether to hide the component's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-next/#heading).
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature-next hide-heading></arcgis-feature-next>
+   * ```
+   *
+   * ```js
+   * featureNextElement.hideHeading = true;
+   * ```
+   * 
    */
   accessor hideHeading: boolean;
   /**

package/dist/components/arcgis-feature-table/customElement.d.ts

@@ -141,6 +141,15 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature-table auto-destroy-disabled></arcgis-feature-table>
+   * ```
+   *
+   * ```js
+   * featureTableElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-feature-templates/customElement.d.ts

@@ -73,6 +73,15 @@ export abstract class ArcgisFeatureTemplates extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature-templates auto-destroy-disabled></arcgis-feature-templates>
+   * ```
+   *
+   * ```js
+   * featureTemplatesElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

package/dist/components/arcgis-feature-templates-legacy/customElement.d.ts

@@ -31,6 +31,15 @@ export abstract class ArcgisFeatureTemplatesLegacy extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature-templates-legacy auto-destroy-disabled></arcgis-feature-templates-legacy>
+   * ```
+   *
+   * ```js
+   * featureTemplatesLegacyElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -67,6 +67,15 @@ export abstract class ArcgisFeatures extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-features auto-destroy-disabled></arcgis-features>
+   * ```
+   *
+   * ```js
+   * featuresElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -297,6 +306,15 @@ export abstract class ArcgisFeatures extends LitElement {
    * Indicates whether to hide the component's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading).
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-features hide-heading></arcgis-features>
+   * ```
+   *
+   * ```js
+   * featuresElement.hideHeading = true;
+   * ```
+   * 
    */
   accessor hideHeading: boolean;
   /**

package/dist/components/arcgis-features-next/customElement.d.ts

@@ -67,6 +67,15 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-features-next auto-destroy-disabled></arcgis-features-next>
+   * ```
+   *
+   * ```js
+   * featuresNextElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -211,9 +220,19 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor heading: string | null | undefined;
   /**
-   * Indicates the heading level to use for the headings in the component.
+   * Indicates the heading level to use for the heading of the component. By default, the heading is rendered as a `<h2>`. Depending on the component's placement in your app, you may need to adjust this heading for proper semantics. This is important for meeting accessibility standards.
    *
    * @default 2
+   * @see [HTML heading elements](https://developer.mozilla.org/docs/Web/HTML/Element/Heading_Elements)
+   * @example
+   * ```html
+   * <arcgis-features-next heading-level="2"></arcgis-features-next>
+   * ```
+   *
+   * ```js
+   * featuresNextElement.headingLevel = 2;
+   * ```
+   * 
    */
   accessor headingLevel: HeadingLevel;
   /**
@@ -280,6 +299,15 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * Indicates whether to hide the component's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#heading).
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-features-next hide-heading></arcgis-features-next>
+   * ```
+   *
+   * ```js
+   * featuresNextElement.hideHeading = true;
+   * ```
+   * 
    */
   accessor hideHeading: boolean;
   /**

package/dist/components/arcgis-features-next/customElement.js

@@ -388,7 +388,7 @@ class ae extends z {
     const A = !r;
     return o`<calcite-flow-item .focusTrapEnabled=${this.focusTrapEnabled} class=${x(y({
       "flow-item-collapsed": c
-    }))} .closable=${s === "list" && !t} .closed=${!F} .collapsed=${s === "list" && c} .collapseDirection=${this.collapseDirection ?? (g ? "down" : "up")} .collapsible=${s === "list" && l} .messageOverrides=${{ collapse: this.messages.collapse, expand: this.messages.expand, back: C }} .description=${this.hideFeatureMenuHeading ? void 0 : d(i.total ?? "", {
+    }))} .closable=${!t} .closed=${!F} .collapsed=${s === "list" && c} .collapseDirection=${this.collapseDirection ?? (g ? "down" : "up")} .collapsible=${s === "list" && l} .messageOverrides=${{ collapse: this.messages.collapse, expand: this.messages.expand, back: C }} .description=${this.hideFeatureMenuHeading ? void 0 : d(i.total ?? "", {
       total: p.length
     })} .heading=${this.hideFeatureMenuHeading ? void 0 : M} .headingLevel=${m} .loading=${e.waitingForContents} .selected=${A} @calciteFlowItemBack=${(R) => {
       R.preventDefault(), this._handleFeatureMenuBack();

package/dist/components/arcgis-floor-filter/customElement.d.ts

@@ -50,6 +50,15 @@ export abstract class ArcgisFloorFilter extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-floor-filter auto-destroy-disabled></arcgis-floor-filter>
+   * ```
+   *
+   * ```js
+   * floorFilterElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /** The currently selected facility. */

package/dist/components/arcgis-grid-controls/customElement.d.ts

@@ -96,6 +96,15 @@ export abstract class ArcgisGridControls extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-grid-controls auto-destroy-disabled></arcgis-grid-controls>
+   * ```
+   *
+   * ```js
+   * gridControlsElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /** The custom color used for drawing the grid, if any. */

package/dist/components/arcgis-histogram-range-slider/customElement.d.ts

@@ -20,6 +20,15 @@ export abstract class ArcgisHistogramRangeSlider extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-histogram-range-slider auto-destroy-disabled></arcgis-histogram-range-slider>
+   * ```
+   *
+   * ```js
+   * histogramRangeSliderElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -34,6 +34,15 @@ export abstract class ArcgisHome extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-home auto-destroy-disabled></arcgis-home>
+   * ```
+   *
+   * ```js
+   * homeElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -46,6 +46,15 @@ export abstract class ArcgisLayerList extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list auto-destroy-disabled></arcgis-layer-list>
+   * ```
+   *
+   * ```js
+   * layerListElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /** The CatalogLayerList that displays a catalog layer's dynamic group layer. */
@@ -86,6 +95,15 @@ export abstract class ArcgisLayerList extends LitElement {
    *
    * @default false
    * @since 4.33
+   * @example
+   * ```html
+   * <arcgis-layer-list closed></arcgis-layer-list>
+   * ```
+   *
+   * ```js
+   * layerListElement.closed = true;
+   * ```
+   * 
    */
   accessor closed: boolean;
   /**