@arcgis/map-components 5.2.0-next.13 → 5.2.0-next.131

package/dist/components/arcgis-attachment-thumbnail/customElement.d.ts

@@ -0,0 +1,164 @@
+/// <reference path="../../index.d.ts" />
+import type AttachmentInfo from "@arcgis/core/rest/query/support/AttachmentInfo.js";
+import type AttachmentElementInput from "@arcgis/core/widgets/BatchAttributeForm/inputs/AttachmentElementInput.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+import type { Icon as Icon } from "@esri/calcite-components/components/calcite-icon";
+
+/**
+ * Displays a thumbnail of an attachment. If possible, an image preview
+ * is shown, otherwise falls back to a generic calcite icon appropriate
+ * for the attachment type.
+ *
+ * @internal
+ */
+export abstract class ArcgisAttachmentThumbnail extends LitElement {
+  /** @internal */
+  protected _messages: {
+      componentLabel: string;
+      components: { attachments: {
+          "attachment-validation-view": { validations: {
+              errorFileUnsupported: string;
+              maximumAudioLength: string;
+              maximumImageSize: string;
+              maximumFileSize: string;
+              maximumNumberOfFiles: string;
+              maximumVideoLength: string;
+              minimumNumberOfFiles: string;
+          }; };
+          "add-attachment-view": {
+              captureMethodNotSupported: string;
+              fileToBeReplaced: string;
+              heading: string;
+          };
+          thumbnail: { fileTypes: {
+              "file-cad": string;
+              "file-code": string;
+              "file-csv": string;
+              "file-excel": string;
+              "file-gpx": string;
+              "file-image": string;
+              "file-pdf": string;
+              "file-ppt": string;
+              "file-sound": string;
+              "file-text": string;
+              "file-video": string;
+              "file-word": string;
+              "file-zip": string;
+              file: string;
+          }; };
+      }; };
+      units: { bytes: {
+          B: string;
+          kB: string;
+          MB: string;
+          GB: string;
+          TB: string;
+      }; };
+      differentValuesPlaceholder: string;
+      empty: string;
+  } & T9nMeta<{
+      componentLabel: string;
+      components: { attachments: {
+          "attachment-validation-view": { validations: {
+              errorFileUnsupported: string;
+              maximumAudioLength: string;
+              maximumImageSize: string;
+              maximumFileSize: string;
+              maximumNumberOfFiles: string;
+              maximumVideoLength: string;
+              minimumNumberOfFiles: string;
+          }; };
+          "add-attachment-view": {
+              captureMethodNotSupported: string;
+              fileToBeReplaced: string;
+              heading: string;
+          };
+          thumbnail: { fileTypes: {
+              "file-cad": string;
+              "file-code": string;
+              "file-csv": string;
+              "file-excel": string;
+              "file-gpx": string;
+              "file-image": string;
+              "file-pdf": string;
+              "file-ppt": string;
+              "file-sound": string;
+              "file-text": string;
+              "file-video": string;
+              "file-word": string;
+              "file-zip": string;
+              file: string;
+          }; };
+      }; };
+      units: { bytes: {
+          B: string;
+          kB: string;
+          MB: string;
+          GB: string;
+          TB: string;
+      }; };
+      differentValuesPlaceholder: string;
+      empty: string;
+  }>;
+  accessor attachment: AttachmentInfo | undefined;
+  accessor input: AttachmentElementInputLike | undefined;
+  accessor messageOverrides: {
+      componentLabel?: string | undefined;
+      components?: { attachments?: {
+          "attachment-validation-view"?: { validations?: {
+              errorFileUnsupported?: string | undefined;
+              maximumAudioLength?: string | undefined;
+              maximumImageSize?: string | undefined;
+              maximumFileSize?: string | undefined;
+              maximumNumberOfFiles?: string | undefined;
+              maximumVideoLength?: string | undefined;
+              minimumNumberOfFiles?: string | undefined;
+          } | undefined; } | undefined;
+          "add-attachment-view"?: {
+              captureMethodNotSupported?: string | undefined;
+              fileToBeReplaced?: string | undefined;
+              heading?: string | undefined;
+          } | undefined;
+          thumbnail?: { fileTypes?: {
+              "file-cad"?: string | undefined;
+              "file-code"?: string | undefined;
+              "file-csv"?: string | undefined;
+              "file-excel"?: string | undefined;
+              "file-gpx"?: string | undefined;
+              "file-image"?: string | undefined;
+              "file-pdf"?: string | undefined;
+              "file-ppt"?: string | undefined;
+              "file-sound"?: string | undefined;
+              "file-text"?: string | undefined;
+              "file-video"?: string | undefined;
+              "file-word"?: string | undefined;
+              "file-zip"?: string | undefined;
+              file?: string | undefined;
+          } | undefined; } | undefined;
+      } | undefined; } | undefined;
+      units?: { bytes?: {
+          B?: string | undefined;
+          kB?: string | undefined;
+          MB?: string | undefined;
+          GB?: string | undefined;
+          TB?: string | undefined;
+      } | undefined; } | undefined;
+      differentValuesPlaceholder?: string | undefined;
+      empty?: string | undefined;
+  };
+  /**
+   * Indicates that the alt for the img element should be cleared. This should only be
+   * set if the thumbnail is shown in a context where filename is already visible.
+   *
+   * https://www.w3.org/WAI/tutorials/images/decorative/
+   *
+   * @default false
+   */
+  accessor skipFilenameAlt: boolean;
+  /** @default "m" */
+  accessor visualScale: Icon["scale"];
+}
+
+/** @internal */
+export type AttachmentElementInputLike = Pick<AttachmentElementInput, "displayFilename" | "getAttachmentPreviewUrl">;

package/dist/components/arcgis-attachment-thumbnail/customElement.js

@@ -0,0 +1,69 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as m } from "../../chunks/runtime.js";
+import { css as h, html as i } from "lit";
+import { LitElement as o, safeClassMap as u, nothing as s } from "@arcgis/lumina";
+import { u as g } from "../../chunks/useT9n.js";
+import { g as p, i as _ } from "../../chunks/attachment-utils.js";
+const d = h`:host{display:contents;--arcgis-internal-attachment-thumbnail-size: 32px}img{object-fit:contain;width:var(--arcgis-internal-attachment-thumbnail-size);height:var(--arcgis-internal-attachment-thumbnail-size)}.icon-xl{scale:2;translate:50%}.icon-xl:dir(rtl){translate:-50%}.container{box-sizing:border-box;display:flex;align-items:center;justify-items:center;border-radius:var(--calcite-corner-radius-xs);overflow:clip;width:var(--arcgis-internal-attachment-thumbnail-size);height:var(--arcgis-internal-attachment-thumbnail-size)}.scale-s{--arcgis-internal-attachment-thumbnail-size: 16px}.scale-m{--arcgis-internal-attachment-thumbnail-size: 32px}.scale-l{--arcgis-internal-attachment-thumbnail-size: 64px}`;
+class f extends o {
+  constructor() {
+    super(...arguments), this._messages = g({ blocking: !0, name: "feature-form-next" }), this._attachment = void 0, this._input = void 0, this._hasImageError = !1, this._resolvedImageUrl = void 0, this.skipFilenameAlt = !1, this.visualScale = "m";
+  }
+  static {
+    this.properties = { _hasImageError: 16, _resolvedImageUrl: 16, _iconName: 16, attachment: 0, input: 0, skipFilenameAlt: 5, messageOverrides: 0, visualScale: 1 };
+  }
+  static {
+    this.styles = d;
+  }
+  get _effectiveScale() {
+    return this.visualScale === "s" ? "s" : "l";
+  }
+  get _imageDimensions() {
+    switch (this.visualScale) {
+      case "l":
+        return 64;
+      case "s":
+        return 16;
+      default:
+        return 32;
+    }
+  }
+  get _altText() {
+    if (this.skipFilenameAlt)
+      return "";
+    const t = this._messages?.components?.attachments?.thumbnail?.fileTypes?.[this._iconName ?? "file"];
+    return this.input?.displayFilename !== !1 ? this.attachment?.name ?? t : t;
+  }
+  set attachment(t) {
+    this._attachment !== t && (this._attachment = t, this._reprocessThumbnail());
+  }
+  get attachment() {
+    return this._attachment;
+  }
+  set input(t) {
+    t !== this._input && (this._input = t, this._reprocessThumbnail());
+  }
+  get input() {
+    return this._input;
+  }
+  _reprocessThumbnail() {
+    this._hasImageError = !1;
+    const { _attachment: t, _input: e } = this;
+    if (!t || !e) {
+      this._resolvedImageUrl = void 0, this._iconName = void 0;
+      return;
+    }
+    this._iconName = p(t.contentType), _(t.contentType) ? this._resolvedImageUrl = this.input?.getAttachmentPreviewUrl(t, this._imageDimensions * 2) ?? void 0 : this._resolvedImageUrl = "";
+  }
+  _handleImageError(t) {
+    t.stopPropagation(), this._hasImageError = !0;
+  }
+  render() {
+    const { _hasImageError: t, _resolvedImageUrl: e, _altText: a, _iconName: r, visualScale: n, _effectiveScale: l } = this, c = t || !e;
+    return i`<div data-testid=thumbnail-container class=${`container scale-${n}`}>${c ? i`<calcite-icon class=${u({ "icon-xl": n === "l" })} data-testid=thumbnail-icon .icon=${r ?? "file"} .scale=${l} .textLabel=${a}></calcite-icon>` : i`<img alt=${a ?? s} title=${a ?? s} src=${e ?? s} @error=${this._handleImageError}>`}</div>`;
+  }
+}
+m("arcgis-attachment-thumbnail", f);
+export {
+  f as ArcgisAttachmentThumbnail
+};

package/dist/components/arcgis-attachment-thumbnail/index.js

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

package/dist/components/arcgis-attachment-validation-view/customElement.d.ts

@@ -0,0 +1,150 @@
+/// <reference path="../../index.d.ts" />
+import type AttachmentElementInput from "@arcgis/core/widgets/BatchAttributeForm/inputs/AttachmentElementInput.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * Displays validation criteria for an attachment input.
+ *
+ * @internal
+ */
+export abstract class ArcgisAttachmentValidationView extends LitElement {
+  /** @internal */
+  protected _messages: {
+      componentLabel: string;
+      components: { attachments: {
+          "attachment-validation-view": { validations: {
+              errorFileUnsupported: string;
+              maximumAudioLength: string;
+              maximumImageSize: string;
+              maximumFileSize: string;
+              maximumNumberOfFiles: string;
+              maximumVideoLength: string;
+              minimumNumberOfFiles: string;
+          }; };
+          "add-attachment-view": {
+              captureMethodNotSupported: string;
+              fileToBeReplaced: string;
+              heading: string;
+          };
+          thumbnail: { fileTypes: {
+              "file-cad": string;
+              "file-code": string;
+              "file-csv": string;
+              "file-excel": string;
+              "file-gpx": string;
+              "file-image": string;
+              "file-pdf": string;
+              "file-ppt": string;
+              "file-sound": string;
+              "file-text": string;
+              "file-video": string;
+              "file-word": string;
+              "file-zip": string;
+              file: string;
+          }; };
+      }; };
+      units: { bytes: {
+          B: string;
+          kB: string;
+          MB: string;
+          GB: string;
+          TB: string;
+      }; };
+      differentValuesPlaceholder: string;
+      empty: string;
+  } & T9nMeta<{
+      componentLabel: string;
+      components: { attachments: {
+          "attachment-validation-view": { validations: {
+              errorFileUnsupported: string;
+              maximumAudioLength: string;
+              maximumImageSize: string;
+              maximumFileSize: string;
+              maximumNumberOfFiles: string;
+              maximumVideoLength: string;
+              minimumNumberOfFiles: string;
+          }; };
+          "add-attachment-view": {
+              captureMethodNotSupported: string;
+              fileToBeReplaced: string;
+              heading: string;
+          };
+          thumbnail: { fileTypes: {
+              "file-cad": string;
+              "file-code": string;
+              "file-csv": string;
+              "file-excel": string;
+              "file-gpx": string;
+              "file-image": string;
+              "file-pdf": string;
+              "file-ppt": string;
+              "file-sound": string;
+              "file-text": string;
+              "file-video": string;
+              "file-word": string;
+              "file-zip": string;
+              file: string;
+          }; };
+      }; };
+      units: { bytes: {
+          B: string;
+          kB: string;
+          MB: string;
+          GB: string;
+          TB: string;
+      }; };
+      differentValuesPlaceholder: string;
+      empty: string;
+  }>;
+  /** @default false */
+  accessor includeCountCriteria: boolean;
+  accessor input: AttachmentElementInputLike | undefined;
+  accessor messageOverrides: {
+      componentLabel?: string | undefined;
+      components?: { attachments?: {
+          "attachment-validation-view"?: { validations?: {
+              errorFileUnsupported?: string | undefined;
+              maximumAudioLength?: string | undefined;
+              maximumImageSize?: string | undefined;
+              maximumFileSize?: string | undefined;
+              maximumNumberOfFiles?: string | undefined;
+              maximumVideoLength?: string | undefined;
+              minimumNumberOfFiles?: string | undefined;
+          } | undefined; } | undefined;
+          "add-attachment-view"?: {
+              captureMethodNotSupported?: string | undefined;
+              fileToBeReplaced?: string | undefined;
+              heading?: string | undefined;
+          } | undefined;
+          thumbnail?: { fileTypes?: {
+              "file-cad"?: string | undefined;
+              "file-code"?: string | undefined;
+              "file-csv"?: string | undefined;
+              "file-excel"?: string | undefined;
+              "file-gpx"?: string | undefined;
+              "file-image"?: string | undefined;
+              "file-pdf"?: string | undefined;
+              "file-ppt"?: string | undefined;
+              "file-sound"?: string | undefined;
+              "file-text"?: string | undefined;
+              "file-video"?: string | undefined;
+              "file-word"?: string | undefined;
+              "file-zip"?: string | undefined;
+              file?: string | undefined;
+          } | undefined; } | undefined;
+      } | undefined; } | undefined;
+      units?: { bytes?: {
+          B?: string | undefined;
+          kB?: string | undefined;
+          MB?: string | undefined;
+          GB?: string | undefined;
+          TB?: string | undefined;
+      } | undefined; } | undefined;
+      differentValuesPlaceholder?: string | undefined;
+      empty?: string | undefined;
+  };
+}
+
+/** @internal */
+export type AttachmentElementInputLike = Pick<AttachmentElementInput, "hasUnsupportedFileTypeValidationError" | "input" | "maxAttachmentCount" | "minAttachmentCount" | "validationCriterionStates">;

package/dist/components/arcgis-attachment-validation-view/customElement.js

@@ -0,0 +1,99 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as r } from "../../chunks/runtime.js";
+import { css as u, html as n } from "lit";
+import { LitElement as l } from "@arcgis/lumina";
+import { u as c } from "../../chunks/useT9n.js";
+import { formatNumber as f, formatDate as h } from "@arcgis/core/intl.js";
+import { f as d, S as g } from "../../chunks/formattingUtils.js";
+import { replace as p } from "@arcgis/core/applications/Components/stringUtils.js";
+function x(m, t = !0) {
+  const e = [];
+  if (!m)
+    return e;
+  const i = m.validationCriterionStates, s = m.input, o = s?.type === "attachment" ? s.inputTypes?.slice() ?? [] : s == null ? [] : [s];
+  m.hasUnsupportedFileTypeValidationError && e.push({
+    key: "errorFileUnsupported",
+    state: "danger"
+  });
+  for (const a of o)
+    a.type === "document" && a.maxFileSize != null && e.push({
+      key: "maximumFileSize",
+      messageDataValue: a.maxFileSize,
+      state: i.get("maximum-file-size") ?? "info"
+    }), a.type === "audio" && a.maxDuration != null && e.push({
+      key: "maximumAudioLength",
+      messageDataValue: a.maxDuration,
+      state: i.get("maximum-audio-length") ?? "info"
+    }), a.type === "video" && a.maxDuration != null && e.push({
+      key: "maximumVideoLength",
+      messageDataValue: a.maxDuration,
+      state: i.get("maximum-video-length") ?? "info"
+    }), a.type === "image" && a.maxImageSize != null && e.push({
+      key: "maximumImageSize",
+      messageDataValue: a.maxImageSize,
+      state: i.get("maximum-image-size") ?? "info"
+    });
+  return t && m.minAttachmentCount != null && m.minAttachmentCount > 0 && e.push({
+    key: "minimumNumberOfFiles",
+    messageDataValue: m.minAttachmentCount,
+    state: i.get("minimum-number-of-files") ?? "info"
+  }), t && m.maxAttachmentCount != null && e.push({
+    key: "maximumNumberOfFiles",
+    messageDataValue: m.maxAttachmentCount,
+    state: i.get("maximum-number-of-files") ?? "info"
+  }), e;
+}
+const y = u`.container{display:flex;flex-direction:column;gap:var(--calcite-space-sm)}`;
+class z extends l {
+  constructor() {
+    super(...arguments), this._messages = c({ blocking: !0, name: "feature-form-next" }), this.includeCountCriteria = !1;
+  }
+  static {
+    this.properties = { includeCountCriteria: 5, input: 0, messageOverrides: 0 };
+  }
+  static {
+    this.styles = y;
+  }
+  _localize(t) {
+    const e = this._messages?.components?.attachments?.["attachment-validation-view"]?.validations?.[t.key];
+    if (!e)
+      return "";
+    const i = this._formatValidationContent(t) ?? "";
+    return p(e, { value: i });
+  }
+  _formatValidationContent(t) {
+    const e = t.messageDataValue;
+    if (typeof e != "number")
+      return e;
+    switch (t.key) {
+      case "maximumFileSize":
+        return this._formatAttachmentSize(e);
+      case "maximumAudioLength":
+      case "maximumVideoLength":
+        return this._formatAttachmentDurationLimit(e);
+      case "maximumImageSize":
+        return f(e, { maximumFractionDigits: 0, minimumFractionDigits: 0, useGrouping: !1 });
+      default:
+        return `${e}`;
+    }
+  }
+  _formatAttachmentDurationLimit(t) {
+    return h(Math.round(t) * 1e3, {
+      ...t >= 3600 ? { hour: "2-digit", hourCycle: "h23" } : {},
+      minute: "2-digit",
+      second: "2-digit",
+      timeZone: "UTC"
+    });
+  }
+  _formatAttachmentSize(t) {
+    return d(this._messages.units, t * g.Megabytes);
+  }
+  render() {
+    const e = x(this.input, this.includeCountCriteria).map((i) => n`<calcite-notice appearance=outline-fill data-testid=${`notice-${i.key}`} icon .kind=${i.state} open scale=s width=full><div slot=message>${this._localize(i)}</div></calcite-notice>`);
+    return n`<div class="container" data-testid=root>${e}</div>`;
+  }
+}
+r("arcgis-attachment-validation-view", z);
+export {
+  z as ArcgisAttachmentValidationView
+};

package/dist/components/arcgis-attachment-validation-view/index.js

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

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

@@ -19,7 +19,7 @@ export abstract class ArcgisAttachments extends LitElement {
   /** An array of strings used to identify attachment(s). When attachments are displayed, this property is used to query attachments using an exact match on the keywords provided. */
   accessor attachmentKeywords: Array<string> | null | undefined;
   /** An array of strings representing MIME types. When attachments are displayed, this property is used to query attachments based on MIME type. Valid values: application, audio, image, model, text, and video. */
-  accessor attachmentTypes: Array<"image" | "model" | "text" | "video" | "application" | "audio"> | null | undefined;
+  accessor attachmentTypes: Array<"image" | "model" | "text" | "video" | "audio" | "application"> | 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
@@ -28,6 +28,15 @@ export abstract class ArcgisAttachments extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-attachments auto-destroy-disabled></arcgis-attachments>
+   * ```
+   *
+   * ```js
+   * attachmentsElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -41,7 +50,7 @@ export abstract class ArcgisAttachments extends LitElement {
    *
    * | Value    | Description |
    * | ------ | ----------- |
-   * | auto     | Default value. If a feature layer's capabilities supports [resizing attachments](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#capabilities), the popup will display attachments in `preview` mode.|
+   * | auto     | Default value. If a feature layer's capabilities support [resizing attachments](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#capabilities), the popup will display attachments in `preview` mode.|
    * | preview  | Shows a thumbnail image of the attachment.|
    * | list     | Shows a list of attachment links. |
    *
@@ -57,7 +66,7 @@ export abstract class ArcgisAttachments extends LitElement {
    */
   accessor hideAddButton: boolean | undefined;
   /**
-   * Indicates whether to hide the `add` button after selecting the attachment to add..
+   * Indicates whether to hide the `add` button after selecting the attachment to add.
    *
    * @default false
    */
@@ -93,7 +102,7 @@ export abstract class ArcgisAttachments extends LitElement {
    */
   accessor hideProgressBar: boolean | undefined;
   /**
-   * Indicates whether to hide an `update` button to allow updating on existing attachments.
+   * Indicates whether to hide an `update` button to allow updating of existing attachments.
    *
    * @default false
    */
@@ -140,7 +149,7 @@ export abstract class ArcgisAttachments extends LitElement {
   };
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "submitting" | "state" | "attachmentInfos"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisAttachments["arcgisPropertyChange"]["detail"];

package/dist/components/arcgis-basemap-gallery/customElement.d.ts

@@ -1,15 +1,14 @@
 /// <reference path="../../index.d.ts" />
-import type LocalBasemapsSource from "@arcgis/core/widgets/BasemapGallery/support/LocalBasemapsSource.js";
-import type PortalBasemapsSource from "@arcgis/core/widgets/BasemapGallery/support/PortalBasemapsSource.js";
+import type LocalBasemapsSource from "@arcgis/core/basemaps/LocalBasemapsSource.js";
+import type PortalBasemapsSource from "@arcgis/core/basemaps/PortalBasemapsSource.js";
+import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement, HeadingLevel } from "../types.js";
 import type { BasemapProperties } from "@arcgis/core/Basemap.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
-import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
-import type { BasemapGalleryViewModelState } from "@arcgis/core/widgets/BasemapGallery/BasemapGalleryViewModel.js";
 
 /**
- * The Basemap Gallery component displays a collection images representing basemaps from [ArcGIS.com](https://www.arcgis.com/index.html) or a user-defined set of map or image services. When a new basemap is selected from the Basemap Gallery, the map's basemap layers are removed and replaced with the basemap layers of the associated basemap selected in the gallery.
+ * The Basemap Gallery component displays a collection of images representing basemaps from [ArcGIS.com](https://www.arcgis.com/index.html) or a user-defined set of map or image services. When a new basemap is selected from the Basemap Gallery, the map's basemap layers are removed and replaced with the basemap layers of the associated basemap selected in the gallery.
  *
  * @since 4.28
  */
@@ -24,10 +23,19 @@ export abstract class ArcgisBasemapGallery extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-basemap-gallery auto-destroy-disabled></arcgis-basemap-gallery>
+   * ```
+   *
+   * ```js
+   * basemapGalleryElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * When true, the component is visually withdrawn and cannot receive user interaction.
+   * When true, the component is visually de-emphasized and does not accept user interaction.
    *
    * @default false
    */
@@ -62,6 +70,7 @@ export abstract class ArcgisBasemapGallery extends LitElement {
       componentLabel?: string | undefined;
       noBasemaps?: string | undefined;
       tagBeta?: string | undefined;
+      tagPreview?: string | undefined;
       tag3D?: string | undefined;
       unsupported?: string | undefined;
   };
@@ -70,12 +79,14 @@ export abstract class ArcgisBasemapGallery extends LitElement {
       componentLabel: string;
       noBasemaps: string;
       tagBeta: string;
+      tagPreview: string;
       tag3D: string;
       unsupported: string;
   }> & T9nMeta<{
       componentLabel: string;
       noBasemaps: string;
       tagBeta: string;
+      tagPreview: string;
       tag3D: string;
       unsupported: string;
   }>;
@@ -98,7 +109,7 @@ export abstract class ArcgisBasemapGallery extends LitElement {
    * <script type="module">
    *   const [Basemap, LocalBasemapsSource] = await $arcgis.import([
    *     "@arcgis/core/Basemap.js",
-   *     "@arcgis/core/widgets/BasemapGallery/support/LocalBasemapsSource.js",
+   *     "@arcgis/core/basemaps/LocalBasemapsSource.js",
    *   ]);
    *   // get the basemap gallery element
    *   const basemapGallery = document.querySelector("arcgis-basemap-gallery");
@@ -117,7 +128,7 @@ export abstract class ArcgisBasemapGallery extends LitElement {
    * </arcgis-map>
    *
    * <script type="module">
-   *   const PortalBasemapsSource = await $arcgis.import("@arcgis/core/widgets/BasemapGallery/support/PortalBasemapsSource.js");
+   *   const PortalBasemapsSource = await $arcgis.import("@arcgis/core/basemaps/PortalBasemapsSource.js");
    *   // get the basemap gallery element
    *   const basemapGallery = document.querySelector("arcgis-basemap-gallery");
    *
@@ -131,24 +142,26 @@ export abstract class ArcgisBasemapGallery extends LitElement {
    */
   accessor source: LocalBasemapsSource | PortalBasemapsSource;
   /**
-   * The current state of the component.
+   * The component's current state.
    *
    * @default "disabled"
    */
-  get state(): BasemapGalleryViewModelState;
+  get state(): BasemapGalleryState;
   /**
-   * 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-basemap-gallery 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-basemap-gallery component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapViewOrSceneView | null | undefined;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "activeBasemap" | "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisBasemapGallery["arcgisPropertyChange"]["detail"];
     arcgisReady: ArcgisBasemapGallery["arcgisReady"]["detail"];
   };
-}
+}
+
+export type BasemapGalleryState = "disabled" | "loading" | "ready" | "unsupported";