@arcgis/map-components 5.2.0-next.86 → 5.2.0-next.88

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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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 +102,20 @@ 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 +152,16 @@ 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-next/customElement.js

@@ -9,7 +9,7 @@ import { m as C } from "../../chunks/useViewModel.js";
 import { LitElement as b, createEvent as F, nothing as _, safeClassMap as L } from "@arcgis/lumina";
 import { substitute as T } from "@arcgis/core/intl.js";
 import { renderingSanitizer as A } from "@arcgis/core/applications/Components/sanitizerUtils.js";
-import { c as R, g as D, d as V, e as k, b as d, i as E, f as B } from "../../chunks/feature-utils.js";
+import { c as R, g as D, d as E, e as V, b as d, i as k, f as B } from "../../chunks/feature-utils.js";
 import N from "@arcgis/core/core/Collection.js";
 import { watch as H } from "@arcgis/core/core/reactiveUtils.js";
 import { stripHTML as P } from "@arcgis/core/applications/Components/stringUtils.js";
@@ -32,7 +32,7 @@ class S extends b {
     return D(this.graphic);
   }
   get fieldInfoMap() {
-    return V(k(this.popupTemplate), this.sourceLayer);
+    return E(V(this.popupTemplate), this.sourceLayer);
   }
   get values() {
     return this.graphic?.attributes ?? {};
@@ -121,7 +121,7 @@ class S extends b {
     return r`<arcgis-feature-content .creator=${e.creator} .destroyer=${e.destroyer ?? void 0} .graphic=${this.graphic ?? void 0} class="content-element"></arcgis-feature-content>`;
   }
   _renderFields(e, t) {
-    const i = this.viewModel.formattedAttributes, { values: a, fieldInfoMap: s, sourceLayer: o, popupTemplate: n, globalValues: l, graphic: c } = this, h = !!e?.fieldInfos, u = (e.fieldInfos ?? n?.fieldInfos ?? [])?.filter(({ fieldName: g }) => !!g && (E(g) || B(g) || g in a)), f = n?.expressionInfos, m = d({
+    const i = this.viewModel.formattedAttributes, { values: a, fieldInfoMap: s, sourceLayer: o, popupTemplate: n, globalValues: l, graphic: c } = this, h = !!e?.fieldInfos, u = (e.fieldInfos ?? n?.fieldInfos ?? [])?.filter(({ fieldName: g }) => !!g && (k(g) || B(g) || g in a)), f = n?.expressionInfos, m = d({
       values: a,
       fieldInfoMap: s,
       globalValues: l,
@@ -252,7 +252,7 @@ class S extends b {
   }
   _renderContentContainer() {
     const { flowItems: e, hideContent: t, internalFlowItems: i, headingLevel: a, state: s, messages: o, heading: n, hideHeading: l } = this, c = t ? null : r`<div class="main">${[this._renderContent(), this._renderLastEditInfo()]}</div>`, h = o.returnToInitialFeature ?? "";
-    return e ? c : r`<calcite-flow ${y(this._storeRootFlowNode)}><calcite-flow-item .loading=${s === "loading"} .headingLevel=${a} .heading=${l ? void 0 : P(n)} .selected=${!i.length}>${!l && n ? r`<div slot=heading><div .innerHTML=${A.sanitize(n ?? "") ?? ""}></div></div>` : null}${c}</calcite-flow-item>${i.toArray().map((p, u) => r`<calcite-flow-item @calciteFlowItemBack=${(f) => {
+    return e ? c : r`<calcite-flow ${y(this._storeRootFlowNode)}><calcite-flow-item .focusTrapEnabled=${this.focusTrapEnabled} .loading=${s === "loading"} .headingLevel=${a} .heading=${l ? void 0 : P(n)} .selected=${!i.length}>${!l && n ? r`<div slot=heading><div .innerHTML=${A.sanitize(n ?? "") ?? ""}></div></div>` : null}${c}</calcite-flow-item>${i.toArray().map((p, u) => r`<calcite-flow-item .focusTrapEnabled=${this.focusTrapEnabled} @calciteFlowItemBack=${(f) => {
       f.preventDefault(), this._handleDrillInBackClick();
     }} .loading=${s === "loading"} .headingLevel=${a} .selected=${u === i.length - 1}><calcite-action icon=move-up @click=${this._removeFlowItems} slot=header-actions-start .text=${h} title=${h ?? _}></calcite-action>${p}</calcite-flow-item>`)}</calcite-flow>`;
   }

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

@@ -141,6 +141,16 @@ 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,16 @@ 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,16 @@ 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,16 @@ 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 +307,16 @@ 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/customElement.js

@@ -359,7 +359,7 @@ class te extends z {
   }
   _renderPagination() {
     const { previous: e, next: t } = this.messages;
-    return a`<calcite-action-bar class="pagination-action-bar" expand-disabled layout=horizontal overflow-actions-disabled scale=s><calcite-action-group scale=s><calcite-action class="pagination-previous" icon=chevron-left icon-flip-rtl .label=${e ?? ""} @click=${this._previousFeature} .text=${e ?? ""} title=${e ?? "" ?? h}></calcite-action><calcite-action icon=chevron-right icon-flip-rtl .label=${t ?? ""} @click=${this._nextFeature} .text=${t ?? ""} title=${t ?? "" ?? h}></calcite-action></calcite-action-group></calcite-action-bar>`;
+    return a`<calcite-action-bar class="pagination-action-bar" expand-toggle-disabled layout=horizontal overflow-actions-disabled scale=s><calcite-action-group scale=s><calcite-action class="pagination-previous" icon=chevron-left icon-flip-rtl .label=${e ?? ""} @click=${this._previousFeature} .text=${e ?? ""} title=${e ?? "" ?? h}></calcite-action><calcite-action icon=chevron-right icon-flip-rtl .label=${t ?? ""} @click=${this._nextFeature} .text=${t ?? ""} title=${t ?? "" ?? h}></calcite-action></calcite-action-group></calcite-action-bar>`;
   }
   _renderFeatureMenuItem(e) {
     const { initialDisplayMode: t } = this, { selectedFeatureViewModel: s, featureViewModels: i } = this.viewModel, o = e === s, n = i.indexOf(e);
@@ -408,7 +408,7 @@ class te extends z {
     const { messages: s, hideCloseButton: i, hideSelectFeature: o, active: n, hideHeading: l } = this, c = "graphic" in e && "isFeatureFromTable" in e && !e.isFeatureFromTable, f = c && !o, v = e.flowType === "feature-association", g = s.returnToInitialFeature ?? "", p = s?.selectFeature, w = this._getActionTitle(M), d = !this.hideActionBar && v && c;
     return a`<calcite-flow-item .closable=${!i} .closed=${!n} .description=${k(this._getDrillInFlowItemDescription(e) ?? "")} .heading=${l ? void 0 : k(e.heading ?? "")} .selected=${t} @calciteFlowItemBack=${(F) => {
       F.preventDefault(), this._handleDrillInBackClick();
-    }} .loading=${!!this._openRelatedFeatureAbortController} @calciteFlowItemClose=${this._handleClose}>${l ? null : a`<div slot=heading><div .innerHTML=${_.sanitize(e.heading ?? "") ?? ""}></div></div>`}<div slot=description><div .innerHTML=${_.sanitize(this._getDrillInFlowItemDescription(e) ?? "") ?? ""}></div></div><calcite-action class="action-exit" icon=move-up @click=${this._removeFlowItems} slot=header-actions-start .text=${g ?? ""} title=${g ?? "" ?? h}></calcite-action>${f ? a`<calcite-action icon=zoom-to-object @click=${() => this._openRelatedFeature(e)} slot=header-actions-end .text=${p ?? ""} title=${p ?? h}></calcite-action>` : null}${d ? a`<calcite-action-bar expand-disabled expanded scale=s slot=action-bar><calcite-action-group overlay-positioning=fixed scale=s><calcite-action .disabled=${M.disabled} .icon=${M.icon ?? void 0} .loading=${M.active} scale=s text-enabled .text=${w} title=${w ?? h} @click=${() => K(this.viewModel, M, e)}></calcite-action></calcite-action-group></calcite-action-bar>` : null}<div class="container">${e}</div></calcite-flow-item>`;
+    }} .loading=${!!this._openRelatedFeatureAbortController} @calciteFlowItemClose=${this._handleClose}>${l ? null : a`<div slot=heading><div .innerHTML=${_.sanitize(e.heading ?? "") ?? ""}></div></div>`}<div slot=description><div .innerHTML=${_.sanitize(this._getDrillInFlowItemDescription(e) ?? "") ?? ""}></div></div><calcite-action class="action-exit" icon=move-up @click=${this._removeFlowItems} slot=header-actions-start .text=${g ?? ""} title=${g ?? "" ?? h}></calcite-action>${f ? a`<calcite-action icon=zoom-to-object @click=${() => this._openRelatedFeature(e)} slot=header-actions-end .text=${p ?? ""} title=${p ?? h}></calcite-action>` : null}${d ? a`<calcite-action-bar expand-toggle-disabled expanded scale=s slot=action-bar><calcite-action-group overlay-positioning=fixed scale=s><calcite-action .disabled=${M.disabled} .icon=${M.icon ?? void 0} .loading=${M.active} scale=s text-enabled .text=${w} title=${w ?? h} @click=${() => K(this.viewModel, M, e)}></calcite-action></calcite-action-group></calcite-action-bar>` : null}<div class="container">${e}</div></calcite-flow-item>`;
   }
   _renderContentContainer() {
     const e = this.flowItems?.toArray(), t = e?.map((i, o) => this._renderFlowItem(i, this._featureFlowItemSelected && o === e.length - 1)), s = this.initialDisplayMode === "list" ? [this._renderFeatureMenuContainer(), this._renderContentFeature(), t] : [this._renderContentFeature(), t, this._renderFeatureMenuContainer()];
@@ -416,7 +416,7 @@ class te extends z {
   }
   _renderActionBar() {
     const t = this.viewModel.selectedFeatureViewModel?.isFeatureFromTable && !this.location ? this.viewModel.allActions.filter((s) => s.id !== M.id) : this.viewModel.allActions;
-    return !this._isCollapsed && !this.hideActionBar && t.length ? a`<calcite-action-bar expand-disabled .expanded=${!this._hideActionText} scale=s slot=action-bar><calcite-action-group overlay-positioning=fixed scale=s ${m(this._actionBarMenuNode)}>${this._renderActions()}</calcite-action-group></calcite-action-bar>` : null;
+    return !this._isCollapsed && !this.hideActionBar && t.length ? a`<calcite-action-bar expand-toggle-disabled .expanded=${!this._hideActionText} scale=s slot=action-bar><calcite-action-group overlay-positioning=fixed scale=s ${m(this._actionBarMenuNode)}>${this._renderActions()}</calcite-action-group></calcite-action-bar>` : null;
   }
   _renderActions() {
     return this.viewModel.allActions.toArray().map((e) => {

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

@@ -67,6 +67,16 @@ 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 +221,20 @@ 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 +301,16 @@ 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;
   /**