@arcgis/map-components 5.2.0-next.11 → 5.2.0-next.110

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer/index.js

@@ -0,0 +1,5 @@
+import "@esri/calcite-components/components/calcite-panel";
+import "../arcgis-scene/index.js";
+import "../arcgis-oriented-imagery-viewer-panoramic-viewer-zoom/index.js";
+import "../arcgis-oriented-imagery-viewer-video-controls/index.js";
+export * from "./customElement.js";

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer/support/PanoramicMedia.d.ts

@@ -0,0 +1,49 @@
+import type Accessor from "@arcgis/core/core/Accessor.js";
+import type Mesh from "@arcgis/core/geometry/Mesh.js";
+import type PanoramicTileSource from "./PanoramicTileSource.js";
+import type { AbortOptions } from "../../../utils/async-utils.js";
+
+export interface PanoramicMediaProperties extends Partial<Pick<PanoramicMedia, "autoLoad" | "cameraHeading" | "extension" | "id" | "matrix" | "type" | "uiStrings" | "url">> {}
+
+export default class PanoramicMedia extends Accessor {
+  /** @param value */
+  static isPanoramicMedia(value: unknown): value is PanoramicMedia;
+  constructor(properties: PanoramicMediaProperties);
+  /** @default false */
+  accessor autoLoad: boolean;
+  accessor cameraHeading: number | undefined;
+  get element(): HTMLImageElement | HTMLVideoElement | undefined;
+  accessor extension: string | undefined;
+  get horizonPitch(): number;
+  get horizonRoll(): number;
+  get horizonYaw(): number;
+  accessor id: number | undefined;
+  accessor matrix: [number, number, number, number, number, number, number, number, number] | undefined;
+  get panoramicTileSource(): PanoramicTileSource | undefined;
+  get size(): [number, number];
+  /** @default "image" */
+  accessor type: "image" | "video";
+  accessor uiStrings: Record<string, string>;
+  accessor url: string;
+  destroy(): void;
+  /** @param options */
+  load(options?: AbortOptions): Promise<{
+      mesh: Mesh;
+      size: [number, number];
+  }>;
+  /** @param options */
+  protected loadImageMesh(options?: AbortOptions): Promise<{
+      mesh: Mesh;
+      size: [number, number];
+  }>;
+  /** @param options */
+  protected loadOptimizedImageMesh(options?: AbortOptions): Promise<{
+      mesh: Mesh;
+      size: [number, number];
+  }>;
+  /** @param options */
+  protected loadVideoMesh(options?: AbortOptions): Promise<{
+      mesh: Mesh;
+      size: [number, number];
+  }>;
+}

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer/support/PanoramicTilePlanner.d.ts

@@ -0,0 +1,18 @@
+export type TileKey = `${number}/${number}/${number}`;
+
+export type RequestUpdateProperties = {
+  heading: number;
+  pitch: number;
+  hfov: number;
+  vfov: number;
+  imageSize: [number, number];
+  viewportSize: [number, number];
+};
+
+export type TileUpdatePlan = {
+  stableLevel: number;
+  desiredKeySet: Set<TileKey>;
+  toFetch: TileKey[];
+  toKeep: TileKey[];
+  toDrop: TileKey[];
+};

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer/support/PanoramicTileSource.d.ts

@@ -0,0 +1,36 @@
+import type Mesh from "@arcgis/core/geometry/Mesh.js";
+import type ImageryTileLayer from "@arcgis/core/layers/ImageryTileLayer.js";
+import type { RequestUpdateProperties, TileKey, TileUpdatePlan } from "./PanoramicTilePlanner.js";
+
+export default class PanoramicTileSource {
+  constructor(_layer: ImageryTileLayer);
+  get baseMesh(): Mesh;
+  get currentLevel(): number | undefined;
+  fetchTileImageData: (level: number, row: number, col: number, signal?: AbortSignal) => Promise<ImageData>;
+  get imageSize(): [number, number];
+  loadComponent: (level: number, row: number, col: number, imageData: ImageData) => void;
+  unloadComponent: (level: number, row: number, col: number) => void;
+  /** @param desiredKeySet */
+  cancelStaleInflight(desiredKeySet: Set<TileKey>): void;
+  destroy(): void;
+  /**
+   * @param level
+   * @param row
+   * @param col
+   */
+  getTileAnchor(level: number, row: number, col: number): [number, number, number];
+  load(): Promise<this>;
+  /** @param key */
+  markTileDropped(key: TileKey): void;
+  /**
+   * @param key
+   * @param controller
+   */
+  markTileInflight(key: TileKey, controller: AbortController): void;
+  /** @param key */
+  markTileInflightResolved(key: TileKey): void;
+  /** @param key */
+  markTileLoaded(key: TileKey): void;
+  /** @param input */
+  planTiles(input: RequestUpdateProperties): TileUpdatePlan;
+}

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer-zoom/customElement.d.ts

@@ -0,0 +1,100 @@
+/// <reference path="../../index.d.ts" />
+import type SceneView from "@arcgis/core/views/SceneView.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { Layout, State } from "../arcgis-zoom/types.js";
+import type { ArcgisReferenceElement } from "../types.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+import type { Button as Button } from "@esri/calcite-components/components/calcite-button";
+
+/** @internal */
+export abstract class ArcgisOrientedImageryViewerPanoramicViewerZoom extends LitElement {
+  /**
+   * 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
+   * component to a different place on the page, or temporarily hide it. If this
+   * is set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-oriented-imagery-viewer-panoramic-viewer-zoom/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   * @example
+   * ```html
+   * <arcgis-oriented-imagery-viewer-panoramic-viewer-zoom auto-destroy-disabled></arcgis-oriented-imagery-viewer-panoramic-viewer-zoom>
+   * ```
+   *
+   * ```js
+   * orientedImageryViewerPanoramicViewerZoomElement.autoDestroyDisabled = true;
+   * ```
+   * 
+   */
+  accessor autoDestroyDisabled: boolean;
+  get hfov(): number | undefined;
+  /**
+   * Icon which represents the component.
+   * Typically used when the component is controlled by another component (e.g. by the Expand component).
+   *
+   * @default "magnifying-glass-plus"
+   * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+   */
+  accessor icon: string | undefined;
+  /** The component's default label. */
+  accessor label: string | undefined;
+  /**
+   * Determines the layout/orientation of the Zoom component.
+   *
+   * @default "vertical"
+   */
+  accessor layout: Layout;
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: {
+      componentLabel?: string | undefined;
+      zoomIn?: string | undefined;
+      zoomOut?: string | undefined;
+  };
+  /** @internal */
+  protected messages: Partial<{
+      componentLabel: string;
+      zoomIn: string;
+      zoomOut: string;
+  }> & T9nMeta<{
+      componentLabel: string;
+      zoomIn: string;
+      zoomOut: string;
+  }>;
+  /**
+   * 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)
+   */
+  accessor referenceElement: ArcgisReferenceElement | string | undefined;
+  /** The current state of the component. */
+  get state(): State;
+  get vfov(): number | undefined;
+  /**
+   * 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 arcgis-oriented-imagery-viewer-panoramic-viewer-zoom component will be associated with a map or scene component rather than using the `view` property.
+   */
+  accessor view: SceneView | undefined;
+  /**
+   * Specifies the size of the component.
+   *
+   * @default "m"
+   * @since 5.0
+   */
+  accessor visualScale: Button["scale"];
+  get zoomLevel(): number | undefined;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  /** @param fov */
+  zoomFOV(fov: number): void;
+  zoomIn(): void;
+  zoomOut(): void;
+  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    arcgisReady: ArcgisOrientedImageryViewerPanoramicViewerZoom["arcgisReady"]["detail"];
+  };
+}

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer-zoom/customElement.js

@@ -0,0 +1,93 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import { c } from "../../chunks/runtime.js";
+import { html as h } from "lit";
+import { LitElement as l, createEvent as v, nothing as r, safeClassMap as u } from "@arcgis/lumina";
+import { g as f } from "../../chunks/globalCss.js";
+import { s as w, c as d, a as g } from "../../chunks/zoom.js";
+import { u as O } from "../../chunks/useT9n.js";
+import { u as V } from "../../chunks/useView.js";
+import { m as s, f as i, a as n, b as p, c as y, d as m } from "../../chunks/utils4.js";
+import { clamp as z } from "@arcgis/toolkit/number";
+class F extends l {
+  constructor() {
+    super(...arguments), this.messages = O({
+      name: "zoom"
+    }), this._state = "disabled", this.view = V(this), this.autoDestroyDisabled = !1, this.icon = "magnifying-glass-plus", this.layout = "vertical", this.visualScale = "m", this.arcgisReady = v();
+  }
+  static {
+    this.properties = { _state: 16, _canZoomIn: 16, _canZoomOut: 16, _maxFOV: 16, _minFOV: 16, zoomLevel: 32, view: 0, autoDestroyDisabled: 5, icon: 1, label: 1, layout: 3, messageOverrides: 0, referenceElement: 1, visualScale: 1, state: 32, hfov: 32, vfov: 32 };
+  }
+  static {
+    this.styles = w;
+  }
+  get _canZoomIn() {
+    return this.view?.ready ? this._minFOV === 0 ? !0 : this.view.camera.fov > this._minFOV : !1;
+  }
+  get _canZoomOut() {
+    return this.view?.ready ? this._maxFOV === 0 ? !0 : this.view.camera.fov < this._maxFOV : !1;
+  }
+  get _maxFOV() {
+    if (!this.view?.ready)
+      return s;
+    const t = this.view.width / this.view.height;
+    return i(s, t);
+  }
+  get _minFOV() {
+    if (!this.view?.ready)
+      return n;
+    const t = this.view.width / this.view.height;
+    return i(n, t);
+  }
+  get zoomLevel() {
+    if (!this.view?.ready)
+      return;
+    const { hfov: t } = this;
+    return Math.max(1, Math.log(s / t) / Math.log(2));
+  }
+  get state() {
+    return this._state;
+  }
+  get hfov() {
+    const { view: t } = this;
+    if (!t?.ready)
+      return;
+    const e = t.width / t.height;
+    return p(t.camera.fov, e);
+  }
+  get vfov() {
+    const { view: t } = this;
+    if (!t?.ready)
+      return;
+    const e = t.width / t.height;
+    return y(t.camera.fov, e);
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  zoomFOV(t) {
+    this.view?.ready && (this.view.camera.fov = z(t, this._minFOV, this._maxFOV), this.view.camera = this.view.camera.clone());
+  }
+  zoomIn() {
+    if (!this._canZoomIn || !this.view)
+      return;
+    const t = this.view.width / this.view.height;
+    this.zoomFOV(this.view.camera.fov - i(m, t));
+  }
+  zoomOut() {
+    if (!this._canZoomOut || !this.view)
+      return;
+    const t = this.view.width / this.view.height;
+    this.zoomFOV(this.view.camera.fov + i(m, t));
+  }
+  render() {
+    const t = d(this.view), e = g(this.view), { zoomIn: a, zoomOut: o } = this.messages;
+    return h`<div class=${u({
+      [f.arcgisButton]: !0,
+      horizontal: this.layout === "horizontal"
+    })}><calcite-button class="zoom-in" .disabled=${!t} icon-start=plus kind=neutral .label=${a} @click=${this.zoomIn} .scale=${this.visualScale} title=${a ?? r}></calcite-button><calcite-button class="zoom-out" .disabled=${!e} icon-start=minus kind=neutral .label=${o} @click=${this.zoomOut} .scale=${this.visualScale} title=${o ?? r}></calcite-button></div>`;
+  }
+}
+c("arcgis-oriented-imagery-viewer-panoramic-viewer-zoom", F);
+export {
+  F as ArcgisOrientedImageryViewerPanoramicViewerZoom
+};

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer-zoom/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-oriented-imagery-viewer-panoramic-viewer-zoom/index.js

@@ -0,0 +1,2 @@
+import "@esri/calcite-components/components/calcite-button";
+export * from "./customElement.js";

package/dist/components/arcgis-oriented-imagery-viewer-video-controls/customElement.d.ts

@@ -0,0 +1,34 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/** @internal */
+export abstract class ArcGISOrientedImageryViewerVideoControls extends LitElement {
+  /** @internal */
+  protected _messages: Partial<{
+      play: string;
+      pause: string;
+      rewind: string;
+      mute: string;
+      unmute: string;
+  }> & T9nMeta<{
+      play: string;
+      pause: string;
+      rewind: string;
+      mute: string;
+      unmute: string;
+  }>;
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: {
+      play?: string | undefined;
+      pause?: string | undefined;
+      rewind?: string | undefined;
+      mute?: string | undefined;
+      unmute?: string | undefined;
+  };
+  accessor videoRef: HTMLVideoElement | undefined;
+}

package/dist/components/arcgis-oriented-imagery-viewer-video-controls/customElement.js

@@ -0,0 +1,61 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import { c as t } from "../../chunks/runtime.js";
+import { css as s, html as a } from "lit";
+import { on as i, when as o } from "@arcgis/core/core/reactiveUtils.js";
+import { LitElement as r } from "@arcgis/lumina";
+import { log as l } from "@arcgis/toolkit/log";
+import { when as c } from "lit/directives/when.js";
+import { createRef as n, ref as h } from "lit/directives/ref.js";
+import { u as d } from "../../chunks/useT9n.js";
+const u = s`:host{position:absolute;align-self:center;inset-block-end:0;background-color:color-mix(in srgb,var(--calcite-color-surface-1) 80%,transparent);inline-size:80%}calcite-label{padding:0 .5rem;--calcite-label-margin-bottom: 0}calcite-slider{inline-size:100%}`;
+class m extends r {
+  constructor() {
+    super(...arguments), this.handlePlayPause = () => {
+      this._playing ? this.pause() : this.play();
+    }, this.handleSeek = () => {
+      const e = this.#e.value?.value;
+      typeof e != "number" || e < 0 || e > this._duration || this.seek(e);
+    }, this.play = async () => {
+      try {
+        await this.videoRef?.play();
+      } catch (e) {
+        l("error", this, "Error playing video", { detail: { error: { message: e.message } } });
+      }
+    }, this.pause = () => this.videoRef?.pause(), this.rewind = async () => await this.seek(0), this.seek = (e) => (this.pause(), this.videoRef && (this.videoRef.currentTime = e), this.play()), this.toggleMute = () => {
+      this.videoRef && (this.videoRef.muted = !this.videoRef.muted, this._audio = !this.videoRef.muted);
+    }, this.#e = n(), this._messages = d(), this._audio = !1, this._playing = !1, this._currentTime = 0, this._duration = 0, this.messageOverrides = this._messages._overrides;
+  }
+  static {
+    this.properties = { _audio: 16, _playing: 16, _currentTime: 16, _duration: 16, _videoReady: 16, messageOverrides: 0, videoRef: 0 };
+  }
+  static {
+    this.styles = u;
+  }
+  #e;
+  get _videoReady() {
+    return this.videoRef?.readyState !== void 0 && this.videoRef.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA;
+  }
+  loaded() {
+    this.manager.onLifecycle(() => [
+      i(() => this.videoRef, "play", () => {
+        this._playing = !0;
+      }),
+      i(() => this.videoRef, "pause", () => {
+        this._playing = !1;
+      }),
+      o(() => this._videoReady, () => {
+        this.videoRef && (this._duration = this.videoRef.duration, this._audio = !this.videoRef.muted, this._playing = !this.videoRef.paused);
+      }, { initial: !0, sync: !0 }),
+      i(() => this.videoRef, "timeupdate", () => {
+        this.videoRef && (this._currentTime = this.videoRef.currentTime);
+      })
+    ]);
+  }
+  render() {
+    return c(() => this._videoReady, () => a`<calcite-label scale=s layout=inline-space-between><calcite-action-group layout=horizontal scale=s><calcite-action scale=m @click=${this.handlePlayPause} .text=${this._playing ? this._messages.pause : this._messages.play} .icon=${this._playing ? "pause-f" : "play-f"}></calcite-action><calcite-action scale=m icon=reset .text=${this._messages.rewind} @click=${this.rewind}></calcite-action><calcite-action scale=m .text=${this._audio ? this._messages.mute : this._messages.unmute} .icon=${this._audio ? "sound" : "sound-off"} @click=${this.toggleMute}></calcite-action></calcite-action-group><calcite-slider scale=s .value=${Number(this._currentTime.toFixed(2)) ?? 0} label-handles label-ticks .max=${this._duration} .ticks=${this._duration} step=0.001 @calciteSliderChange=${this.handleSeek} @calciteSliderInput=${this.pause} ${h(this.#e)}></calcite-slider></calcite-label>`);
+  }
+}
+t("arcgis-oriented-imagery-viewer-video-controls", m);
+export {
+  m as ArcGISOrientedImageryViewerVideoControls
+};

package/dist/components/arcgis-oriented-imagery-viewer-video-controls/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-oriented-imagery-viewer-video-controls/index.js

@@ -0,0 +1,5 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-action-group";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-slider";
+export * from "./customElement.js";

package/dist/components/arcgis-paste/PasteViewModel.d.ts

@@ -18,7 +18,7 @@ import type { PasteCommand, PasteApplyError, PasteCommandApplyParameters } from
 import type { CustomPasteCommand } from "./commands/PasteCustomCommand.js";
 
 /** @internal */
-export interface PasteViewModelProperties extends Partial<Pick<PasteViewModel, "_activeFlowPage" | "activeCommand" | "activeFlowPage" | "alwaysShowFeatureForm" | "applying" | "bauActiveFeatureIndex" | "bauApplySet" | "bauFeatures" | "bauFormUpdating" | "bauFormValid" | "bauHasTooManyComplexFeatures" | "bauHasTooManyFeatures" | "bauHighlight" | "bauIndividualHighlight" | "bauInvalidFeatures" | "bauOriginalGraphics" | "beforeClipboard" | "beforeForm" | "clipboardGraphicsLayer" | "clipboardMover" | "closeOnApply" | "currentPasteOperation" | "customPasteCommands" | "formViewModelMap" | "hideErrorNotice" | "hideFooter" | "hideFooterCancelButton" | "hideHeaderCloseButton" | "hideTooltips" | "hideViewClipboard" | "highlightGroup" | "lastPasteError" | "layerPermissionsCheck" | "maximumFeatureCount" | "maximumFeatureCountWithComplexForms" | "pasteTemplate" | "pasteWithAttributes" | "pasteWithMultipleFeaturesEnabled" | "pasteWithMultipleLayersEnabled" | "selectedClipboardItemIndex" | "selectedFeature" | "showClipboardItems" | "supportedCommands" | "view">> {}
+export interface PasteViewModelProperties extends Partial<Pick<PasteViewModel, "_activeFlowPage" | "activeCommand" | "activeFlowPage" | "alwaysShowFeatureForm" | "applying" | "bauActiveFeatureIndex" | "bauApplySet" | "bauFeatures" | "bauFormUpdating" | "bauFormValid" | "bauHasTooManyComplexFeatures" | "bauHasTooManyFeatures" | "bauHighlight" | "bauIndividualHighlight" | "bauInvalidFeatures" | "bauOriginalGraphics" | "beforeClipboard" | "beforeForm" | "clipboardGraphicsLayer" | "clipboardMover" | "closeOnApply" | "currentPasteOperation" | "customPasteCommands" | "disableTemplatesMode" | "formViewModelMap" | "hideErrorNotice" | "hideFooter" | "hideFooterCancelButton" | "hideHeaderCloseButton" | "hideTooltips" | "hideViewClipboard" | "highlightGroup" | "lastPasteError" | "layerPermissionsCheck" | "maximumFeatureCount" | "maximumFeatureCountWithComplexForms" | "pasteTemplate" | "pasteWithAttributes" | "pasteWithMultipleFeaturesEnabled" | "pasteWithMultipleLayersEnabled" | "selectedClipboardItemIndex" | "selectedFeature" | "showClipboardItems" | "supportedCommands" | "view">> {}
 
 /**
  * The types of flow page that maybe being shown in the component
@@ -86,6 +86,8 @@ export default class PasteViewModel extends Accessor {
   /** @default "" */
   accessor currentPasteOperation: "" | "paste-as" | "paste-merge";
   accessor customPasteCommands: Collection<CustomPasteCommand>;
+  /** @default "never" */
+  accessor disableTemplatesMode: "never" | "scale" | "visible";
   accessor formViewModelMap: Map<FeatureLayer | SubtypeSublayer, BatchAttributeFormViewModel>;
   get hasClipboardItemMatchingTemplate(): boolean;
   get hasPasteCommandsPage(): boolean;

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

@@ -14,13 +14,33 @@ import type { PasteExecuteResult } from "./commands/PasteCommand.js";
 import type { CustomPasteCommand } from "./commands/PasteCustomCommand.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
+declare module "@arcgis/lumina" {
+export interface DeclareCssProperties {
+  /**
+   * Specifies the height of the component.
+   *
+   * @internal
+   */
+  "--arcgis-paste-height": "*";
+  /**
+   * Specifies the width of the component.
+   *
+   * @internal
+   */
+  "--arcgis-paste-width": "*";
+  /**
+   * Specifies the padding for elements within the component.
+   *
+   * @internal
+   */
+  "--arcgis-paste-blocks-padding": "*";
+}
+}
+
 /**
  * The Paste component provides a UX for working with a Clipboard and
  * copy and pasting features and/or geometries.
  *
- * @cssproperty [--arcgis-paste-height] - Specifies the height of the component.
- * @cssproperty [--arcgis-paste-width] - Specifies the width of the component.
- * @cssproperty [--arcgis-paste-blocks-padding] - Specifies the padding for elements within the component.
  * @slot [home-header-actions-start] - Slot for adding actions to the start of the header on the entry page.
  * @slot [header-actions-end] - Slot for adding actions to the end of the header.
  * @slot [gallery-page-message] - Slot for adding content to the template gallery page.
@@ -158,9 +178,18 @@ export abstract class ArcgisPaste extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-paste auto-destroy-disabled></arcgis-paste>
+   * ```
+   *
+   * ```js
+   * pasteElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
-  /** Called before the the paste is applied. */
+  /** Called before the paste is applied. */
   accessor beforeApply: (() => Promise<void>) | undefined;
   /** Access the application clipboard */
   get clipboard(): EsriClipboard;
@@ -176,6 +205,12 @@ export abstract class ArcgisPaste extends LitElement {
    * @default false
    */
   accessor closeOnApply: boolean;
+  /**
+   * Decide if templates should be disabled when the layer is not visible, or not visible at the current scale.
+   *
+   * @default "never"
+   */
+  accessor disableTemplatesMode: "scale" | "never" | "visible";
   /**
    * Determines if the component should show error notices
    *
@@ -224,14 +259,14 @@ export abstract class ArcgisPaste extends LitElement {
       canCreate: (layer: FeatureLayer | SubtypeGroupLayer) => boolean;
   };
   /**
-   * The maximum number of features that created by a paste operation.
+   * The maximum number of features that can be created by a paste operation.
    *
    * @default 2000
    * @name maximumFeatureCount
    */
   accessor maximumFeatureCount: number;
   /**
-   * The maximum number of features that can created by a paste operation,
+   * The maximum number of features that can be created by a paste operation.
    * when there are complex Arcade expressions that must be executed.
    *
    * @default 50
@@ -267,8 +302,8 @@ export abstract class ArcgisPaste extends LitElement {
   /** The list of supported paste operations. New types of operations can be registered using the 'registerPasteOperation' */
   accessor supportedCommands: SupportedPasteCommand | SupportedPasteCommand[];
   /**
-   * 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 arcgis-paste component will be associated with a map or scene component rather than using the `view` property.
+   * 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 arcgis-paste component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | SceneView | undefined;
   /** Cancels any running Clipboard Move Interaction */