@arcgis/map-components 4.34.0-next.2 → 4.34.0-next.20

package/dist/components/arcgis-locate/customElement.js

@@ -27,7 +27,7 @@ import { project as te } from "@arcgis/core/rest/geometryService.js";
 import oe from "@arcgis/core/rest/support/ProjectParameters.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const ie = K`@layer{arcgis-locate{display:block}}`;
 let M = !1;
 const re = {

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

@@ -6,7 +6,7 @@ import { default as MapView } from '@arcgis/core/views/MapView.js';
 import { default as WebMap } from '@arcgis/core/WebMap.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 
-declare const useWebMap: (component: LitElement & Omit<Pick<WebMap, "basemap" | "ground" | "ipsInfo" | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks"> & {
+declare const useWebMap: (component: LitElement & Omit<Pick<WebMap, "basemap" | "focusAreas" | "ground" | "ipsInfo" | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => WebMap;
@@ -15,7 +15,7 @@ declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container
     destroy: () => Promise<void>;
 }) => MapView;
 /**
- * The ArcGIS Map Component is used to add 2D maps to web applications. For 3D maps, use the
+ * The ArcGIS Map component is used to add 2D maps to web applications. For 3D maps, use the
  * [ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
  *
  * The Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and loads a WebMap from either [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).
@@ -127,17 +127,25 @@ export declare class ArcgisMap extends LitElement {
      * It can filter the map display on floor-aware layers by zero or more level IDs.
      */
     floors: __esri.Collection<string>;
+    /**
+     * A container of all [focus areas](https://developers.arcgis.com/javascript/latest/api-reference/esri-effects-FocusAreas.html) present in the map.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#focusAreas)
+     */
+    get focusAreas(): __esri.FocusAreas;
+    set focusAreas(newValue: __esri.FocusAreas);
     /** Gamepad input specific configuration settings. */
     get gamepad(): __esri.GamepadSettings;
     /**
      * Allows for adding graphics directly to the default graphics in the View.
-     * Example:
-     * ```
+     *
+     * @example
+     * ```js
      * // Adds a graphic to the View
      * graphics.add(pointGraphic);
      * ```
-     * Example:
-     * ```
+     * @example
+     * ```js
      * // Removes a graphic from the View
      * graphics.remove(pointGraphic);
      * ```
@@ -184,7 +192,7 @@ export declare class ArcgisMap extends LitElement {
     /** The magnifier allows for showing a portion of the view as a magnifier image on top of the view. */
     readonly magnifier: __esri.Magnifier;
     /** An instance of a esri/Map object to display in the view. */
-    map: __esri.Map;
+    map: __esri.Map | nullish;
     /**
      * Indication whether the view is being navigated (for example when panning).
      *

package/dist/components/arcgis-map/customElement.js

@@ -8,8 +8,8 @@ import { c as v, i as l } from "../../chunks/component-utils.js";
 import { css as m } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
-const d = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, g = r(
+v4.34.0-next.20 */
+const g = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, d = r(
   w,
   /**
    * Since omitProps is only needed for typing, not runtime, `{} as { ... }` is
@@ -20,21 +20,21 @@ const d = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;w
    * in an externalized package.
    */
   {}
-), y = r(o, {});
-class u extends p {
+), u = r(o, {});
+class y extends p {
   constructor() {
-    super(), this._map = g(this), this.view = y(this), this.allLayerViews = this.view.allLayerViews, this.autoDestroyDisabled = !1, this.background = this.view.background, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.fatalError = this.view.fatalError, this.floors = this.view.floors, this.graphics = this.view.graphics, this.ground = this._map.ground, this.highlights = this.view.highlights, this.highlightOptions = this.view.highlightOptions, this.ipsInfo = this._map.ipsInfo, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.ready = this.view.ready, this.resizeAlign = this.view.resizeAlign, this.resolution = this.view.resolution, this.rotation = this.view.rotation, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.timeZone = this.view.timeZone, this.updating = this.view.updating, this.visibleArea = this.view.visibleArea, this.arcgisViewChange = a(), this.arcgisViewClick = e(() => this.view, "click"), this.arcgisViewDoubleClick = e(() => this.view, "double-click"), this.arcgisViewDrag = e(() => this.view, "drag"), this.arcgisViewHold = e(() => this.view, "hold"), this.arcgisViewImmediateClick = e(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = e(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = e(() => this.view, "key-down"), this.arcgisViewKeyUp = e(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = e(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = e(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = e(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = e(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = e(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = e(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = e(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = e(() => this.view, "pointer-move"), this.arcgisViewPointerUp = e(() => this.view, "pointer-up"), this.arcgisViewReadyChange = a(), this.view.ui = {
+    super(), this._map = d(this), this.view = u(this), this.allLayerViews = this.view.allLayerViews, this.autoDestroyDisabled = !1, this.background = this.view.background, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.fatalError = this.view.fatalError, this.floors = this.view.floors, this.graphics = this.view.graphics, this.ground = this._map.ground, this.highlights = this.view.highlights, this.highlightOptions = this.view.highlightOptions, this.ipsInfo = this._map.ipsInfo, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.ready = this.view.ready, this.resizeAlign = this.view.resizeAlign, this.resolution = this.view.resolution, this.rotation = this.view.rotation, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.timeZone = this.view.timeZone, this.updating = this.view.updating, this.visibleArea = this.view.visibleArea, this.arcgisViewChange = a(), this.arcgisViewClick = e(() => this.view, "click"), this.arcgisViewDoubleClick = e(() => this.view, "double-click"), this.arcgisViewDrag = e(() => this.view, "drag"), this.arcgisViewHold = e(() => this.view, "hold"), this.arcgisViewImmediateClick = e(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = e(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = e(() => this.view, "key-down"), this.arcgisViewKeyUp = e(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = e(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = e(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = e(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = e(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = e(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = e(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = e(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = e(() => this.view, "pointer-move"), this.arcgisViewPointerUp = e(() => this.view, "pointer-up"), this.arcgisViewReadyChange = a(), this.view.ui = {
       components: ["attribution"]
     };
   }
   static {
-    this.properties = { _map: 16, view: 32, allLayerViews: 0, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, floors: 0, gamepad: 32, graphics: 0, ground: 1, highlights: 0, highlightOptions: 0, interacting: 32, ipsInfo: 0, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupDisabled: 5, ready: 4, resizeAlign: 1, resolution: 8, rotation: 9, scale: 9, spatialReference: 0, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, timeZone: 1, updating: 4, viewpoint: 0, visibleArea: 0, zoom: 9 };
+    this.properties = { _map: 16, view: 32, allLayerViews: 0, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, highlights: 0, highlightOptions: 0, interacting: 32, ipsInfo: 0, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupDisabled: 5, ready: 4, resizeAlign: 1, resolution: 8, rotation: 9, scale: 9, spatialReference: 0, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, timeZone: 1, updating: 4, viewpoint: 0, visibleArea: 0, zoom: 9 };
   }
   static {
     this.shadowRootOptions = c;
   }
   static {
-    this.styles = d;
+    this.styles = g;
   }
   get center() {
     return this.view.center;
@@ -49,6 +49,15 @@ class u extends p {
   set extent(i) {
     i && !this.extent?.equals(i) && (this.view.extent = i);
   }
+  get focusAreas() {
+    return this.map ? this.map.focusAreas : {
+      areas: [],
+      style: "bright"
+    };
+  }
+  set focusAreas(i) {
+    this.map && (this.map.focusAreas = i);
+  }
   get gamepad() {
     return this.view.input.gamepad;
   }
@@ -86,16 +95,16 @@ class u extends p {
     this.view.zoom = i;
   }
   async addLayer(i, t) {
-    this.map.add(i, t);
+    this.map?.add(i, t);
   }
   async addLayers(i, t) {
-    this.map.addMany(i, t);
+    this.map?.addMany(i, t);
   }
   async addTable(i) {
-    this.map.tables.add(i);
+    this.map?.tables.add(i);
   }
   async addTables(i, t) {
-    this.map.tables.addMany(i, t);
+    this.map?.tables.addMany(i, t);
   }
   async closePopup() {
     this.view.closePopup();
@@ -136,13 +145,15 @@ class u extends p {
   }
   loaded() {
     this.map ||= this._map, this.manager.onLifecycle(() => [
-      s(() => this.map, () => this._map = this.map, { initial: !0, sync: !0 }),
+      s(() => this.map, (i) => {
+        i && (this._map = i);
+      }, { initial: !0, sync: !0 }),
       s(() => this.view.stationary, () => this.arcgisViewChange.emit(), { initial: !0 }),
       s(() => this.view.ready, () => this.arcgisViewReadyChange.emit(), { initial: this.view.ready })
     ]);
   }
 }
-h("arcgis-map", u);
+h("arcgis-map", y);
 export {
-  u as ArcgisMap
+  y as ArcgisMap
 };

package/dist/components/arcgis-measurement/customElement.js

@@ -6,7 +6,7 @@ import { m as r } from "../../chunks/useWidget.js";
 import { css as n } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const c = n`@layer{arcgis-measurement{display:block}}`, l = r(i);
 class h extends s {
   constructor() {

package/dist/components/arcgis-measurement-content/customElement.js

@@ -6,7 +6,7 @@ import { f as l } from "../../chunks/measurementUtils.js";
 import { css as m } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const u = m`:host,.hint,.error,.section,.actions,.item{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);animation:esri-fade-in .25s ease-in-out}.error{color:var(--calcite-color-status-danger)}.error,.hint{overflow:hidden;p{margin:0;padding:0}}.item-disabled{color:var(--calcite-color-text-1);opacity:var(--calcite-opacity-light)}.item-value{font-weight:var(--calcite-font-weight-semibold)}.actions{justify-content:center}`, e = {
   error: "error",
   hint: "hint",

package/dist/components/arcgis-navigation-toggle/customElement.d.ts

@@ -36,7 +36,11 @@ export declare class ArcgisNavigationToggle extends LitElement {
      * @default "vertical"
      */
     layout: LayoutMode;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this._messages._overrides;
     /**
      * The navigation mode of the view. See the table below for a list of

package/dist/components/arcgis-navigation-toggle/customElement.js

@@ -9,7 +9,7 @@ import { g as b } from "../../chunks/globalCss.js";
 import { css as M } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const $ = "arcgis-navigation-toggle", w = {
   base: $
 }, x = M`@layer{.arcgis-navigation-toggle{display:flex;box-shadow:0 1px 2px #0000004d;inline-size:fit-content;block-size:fit-content}}`, e = { pan: "move", rotate: "rotate" };

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

@@ -7,7 +7,7 @@ import { m as l } from "../../chunks/useWidget.js";
 import { css as g } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const h = g`@layer{arcgis-oriented-imagery-viewer{display:block}}`, m = l(r);
 class y extends o {
   constructor() {

package/dist/components/arcgis-placement/customElement.js

@@ -4,7 +4,7 @@ import { LitElement as l, createEvent as a, noShadowRoot as c } from "@arcgis/lu
 import { css as h } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const d = h`@layer{arcgis-placement{display:flex;pointer-events:auto;box-shadow:none}.arcgis-placement__container{display:block}}`;
 class m extends l {
   constructor() {

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

@@ -9,27 +9,25 @@ import { Formats } from './interfaces';
 
 declare const usePrintViewModel: (component: LitElement & Pick<PrintViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<PrintViewModel>) => PrintViewModel;
 /**
- * The Print widget connects your application with a [printing service](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-the-portal-to-print-maps.htm) to allow the map to be printed.
+ * The Print component connects your application with a [printing service](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-the-portal-to-print-maps.htm) to allow the map to be printed.
  * It takes advantage of server-side, high-quality, full cartographic print functionality using the ExportWebMap service of ArcGIS,
  * which can be configured with custom layout templates. One is provided that shows the map only, while another provides a layout with legend, etc.
- * The Print widget works with the [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) which generates a printer-ready version of the map.
+ * The Print component works with the [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) module, which generates a printer-ready version of the map.
  *
- * The Print widget has two required properties: [view](#view) (reference to the MapView)
- * and [printServiceUrl](#printServiceUrl) (URL of the REST endpoint of the Export Web Map Task).
- * The widget can preserve map scale or map extent in the printout. By default, the map extent is
- * preserved. Use [TemplateOptions.scaleEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-TemplateOptions.html#scaleEnabled) to preserve scale
- * instead.
+ * The Print component uses the ArcGIS Online print service by default, but it can be configured to use a custom print service with the [printServiceUrl](#printServiceUrl) property.
+ * The component can preserve map scale or map extent in the printout. By default, the map extent is preserved. Use
+ * [TemplateOptions.scaleEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-TemplateOptions.html#scaleEnabled) to preserve scale instead.
  *
- * The Print widget prints a localized date for all [layouts](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#layout)
+ * The Print component prints a localized date for all [layouts](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#layout)
  * except `map-only`. If using a custom print service, then `customTextElements` are supported for each print
- * template. Values found there will be populated in the Print widget under `Advanced options`. These values can
- * be overwritten in the Print widget UI, or programmatically using the
+ * template. Values found there will be populated in the Print component under `Advanced options`. These values can
+ * be overwritten in the Print component UI, or programmatically using the
  * [templateCustomTextElements](#templateCustomTextElements) property.
  *
  * For more information about printing with the `MAP_ONLY` layout, please see
  * [exportOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#exportOptions).
  *
- * **Known Limitations**
+ * **Known limitations**
  *
  * See [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) for a detailed list of known limitations.
  *
@@ -44,9 +42,9 @@ declare const usePrintViewModel: (component: LitElement & Pick<PrintViewModel, n
  * const components = document.querySelectorAll("arcgis-print");
  *
  * const portal = new Portal({
- *  url: "https://zara.mapsdevext.arcgis.com/sharing",
+ *  url: "https://user.maps.arcgis.com/sharing",
  *  authMode: "immediate",
- *  authorizedCrossOriginDomains: ["https://zara.mapsdevext.arcgis.com"],
+ *  authorizedCrossOriginDomains: ["https://user.maps.arcgis.com"],
  * });
  *
  * components.forEach((component) => {
@@ -57,10 +55,24 @@ declare const usePrintViewModel: (component: LitElement & Pick<PrintViewModel, n
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-print/)
  */
 export declare class ArcgisPrint extends LitElement {
-    /** @default false */
+    /**
+     * Indicates whether the component's header is hidden.
+     *
+     * @default false
+     */
     hideHeader: boolean;
+    /**
+     * By passing the `id` of the Map or Scene component into this property, you can position components from the `@arcgis/map-components`
+     * package anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * See [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component).
+     */
     referenceElement?: ArcgisReferenceElement | string;
-    /** @default "top-left" */
+    /**
+     * The UI position of a component.
+     *
+     * @default "top-left"
+     */
     position: __esri.UIPosition;
     /**
      * Icon which represents the component.
@@ -92,16 +104,21 @@ export declare class ArcgisPrint extends LitElement {
      * @default "all"
      */
     allowedLayouts: string | string[];
+    /** @internal */
     browseTemplateButtonOnClick?: () => void;
+    /**
+     * Specifies the print output file format(s) that the user can select when saving the exported map printout.
+     * This property can take a string value or an array of string values.
+     */
     allowedFormatsForSaving?: Formats;
-    /** The collection of links exported from the Print widget. */
+    /** The collection of links exported from the Print component. */
     exportedLinks: __esri.Collection<__esri.FileLink>;
     /** This option allows passing extra parameters (in addition to [templateOptions](#templateOptions)) to the print (export webmap) requests. */
     extraParameters: any;
     /**
      * Indicates the heading level to use for the "Exported files" text where users can
      * access the exported map printout. By default, this text is rendered
-     * as a level 3 heading (e.g. `<h3>Exported files</h3>`). Depending on the widget's placement
+     * as a level 3 heading (e.g. `<h3>Exported files</h3>`). 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.
      *
@@ -120,23 +137,18 @@ export declare class ArcgisPrint extends LitElement {
      * @default false
      */
     excludeOrganizationTemplates: boolean;
-    /**
-     * The [spatial reference](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-SpatialReference.html) used to render
-     * the printed map on the server.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-PrintViewModel.html#outSpatialReference)
-     */
+    /** The [spatial reference](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-SpatialReference.html) used to render the printed map on the server. */
     outSpatialReference: nullish | __esri.SpatialReference;
     /**
      * It is possible to search a specified portal instance's [locator services](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-portal-to-geocode-addresses.htm).
      * Use this property to set this [ArcGIS Portal](https://enterprise.arcgis.com/en/portal/) instance to search.
-     * This is especially helpful when working with a [custom](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-CustomTemplate.html).
+     * This is especially helpful when working with a [custom template](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-CustomTemplate.html).
      *
      * If this property is set, it is not necessary to set the [printServiceUrl](#printServiceUrl) property.
      */
     portal: __esri.Portal;
     /**
-     * The initial state of the print area toggle in the Print widget UI.
+     * The initial state of the print area toggle in the Print component UI.
      * When set to `true`, the print area toggle is enabled by default.
      * When set to `false`, the print area toggle is disabled by default.
      *
@@ -145,28 +157,30 @@ export declare class ArcgisPrint extends LitElement {
     showPrintAreaEnabled: boolean;
     /**
      * The URL of the REST endpoint of the Export Web Map Task.
-     * If the [portal](#portal) property is set, it is not necessary to set this property.
+     * Defaults to the ArcGIS Online print service if this property is not specified.
+     * If the [portal](#portal) property is set, this property will use the portal's print service URL.
      */
     printServiceUrl: string | nullish;
+    /** @internal */
     saveAsButtonCallback?: (exportedLink: __esri.FileLink) => Promise<__esri.PortalItem>;
     /**
      * An object containing an array of `customTextElements` name-value pair objects
      * for each print template in a custom print service. Use this property to update
      * the text for custom text elements on the page layout.
      *
-     * The Print widget calls the `Get Layout Templates Info` task on the GPServer
+     * The Print component calls the `Get Layout Templates Info` task on the GPServer
      * to discover possible `customTextElements` values for each template. The name of
      * the task must match `Get Layout Templates Info`, templates must be published
      * with `customTextElements`, and values must be strings. Values found there will be
-     * populated in the Print widget under `Advanced options`. These values can be
-     * overwritten in the Print widget UI, or programmatically using this property.
+     * populated in the Print component under `Advanced options`. These values can be
+     * overwritten in the Print component UI, or programmatically using this property.
      * To list all print templates available on the print service to see
      * see which templates were published with `customTextElements`, use the
      * [effectiveTemplateCustomTextElements](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-PrintViewModel.html#effectiveTemplateCustomTextElements)
      * property.
      */
     templateCustomTextElements: nullish | HashMap<HashMap<string>[]>;
-    /** Defines the layout template options used by the [Print](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print.html) widget to generate the print page. */
+    /** Defines the layout template options used by the Print component to generate the print page. */
     templateOptions: __esri.TemplateOptions;
     /**
      * If true, the component will not be destroyed automatically when it is
@@ -178,14 +192,16 @@ export declare class ArcgisPrint extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** The component's default label. */
     label?: string;
     /**
-     * The view model's state.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-PrintViewModel.html#state)
+     * The state of the Print component.
      *
      * @default "disabled"
      */
@@ -198,9 +214,11 @@ export declare class ArcgisPrint extends LitElement {
     }>;
     /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
+    /** Emitted when the component is complete. */
     readonly arcgisComplete: TargetedEvent<this, {
         link: __esri.FileLink;
     }>;
+    /** Emitted when the component is submitted. */
     readonly arcgisSubmit: TargetedEvent<this, {
         link: __esri.FileLink;
     }>;

package/dist/components/arcgis-print/customElement.js

@@ -10,7 +10,7 @@ import { g as o } from "../../chunks/globalCss.js";
 import { css as v } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const u = v`@layer{:root{--panel-min-height--large: 240px;--side-spacing: var(--calcite-spacing-lg);--cap-spacing: var(--calcite-spacing-md)}.arcgis-print{display:flex;position:relative;flex-grow:1;padding:0;min-height:var(--panel-min-height--large)!important;overflow-y:auto}.arcgis-print section[aria-hidden=true]{display:none}.arcgis-print__panel-items--centered{display:flex;align-items:center}.arcgis-print__container{display:flex;flex-direction:column;flex-grow:1}.arcgis-print__header-title{margin:0 auto 0 0;padding:var(--calcite-spacing-md) var(--calcite-spacing-lg);font-size:var(--calcite-font-size-0);font-weight:var(--calcite-font-weight-bold)}.arcgis-print__panel--error{color:var(--calcite-color-status-danger)}arcgis-print-template-selector{overflow-y:hidden;display:flex}}`, i = "arcgis-print", s = {
   base: i,
   headerTitle: `${i}__header-title`,

package/dist/components/arcgis-print-custom-text-elements/customElement.js

@@ -4,7 +4,7 @@ import { watch as c } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as u, noShadowRoot as p } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 class d extends u {
   static {
     this.properties = { viewModel: 0 };

package/dist/components/arcgis-print-dpi-input/customElement.js

@@ -4,7 +4,7 @@ import { watch as p } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as d, noShadowRoot as c } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 function l(s, i, t, e) {
   if (t == null || e == null)
     return { height: 0, width: 0 };

package/dist/components/arcgis-print-export-button/customElement.js

@@ -3,7 +3,7 @@ import { html as r } from "lit-html";
 import { LitElement as l, noShadowRoot as n } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 class c extends l {
   static {
     this.properties = { viewModel: 0, messages: 0, fileName: 1, selectExportsTab: 0, arcgisSubmit: 0, arcgisComplete: 0 };

package/dist/components/arcgis-print-exported-link/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as $, noShadowRoot as b, nothing as u, safeClassMap as c } f
 import { css as w } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const x = w`@layer{.arcgis-print__exported-file{display:flex;align-items:center;justify-content:space-between}.arcgis-print__exported-file-link-title,.arcgis-print__exported-file-link-description{word-wrap:break-word;word-break:break-all;overflow:hidden;text-overflow:ellipsis;display:-webkit-box;-webkit-line-clamp:2;line-clamp:2;-webkit-box-orient:vertical}}`, d = "arcgis-print", m = {
   exportedFile: `${d}__exported-file`,
   exportedFileLinkTitle: `${d}__exported-file-link-title`,

package/dist/components/arcgis-print-exports-panel/customElement.js

@@ -5,7 +5,7 @@ import { LitElement as c, safeClassMap as o } from "@arcgis/lumina";
 import { css as p } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const d = p`.arcgis-print__export-section--centered{text-align:center}.esri-print__panel-container{display:flex;flex:1 0;flex-direction:column;gap:var(--calcite-spacing-sm)}.arcgis-print__exported-files-empty{display:flex;flex-direction:column;align-items:center;padding:var(--calcite-spacing-lg) var(--calcite-spacing-sm);font-size:small}.arcgis-print__export-title{font-weight:700;font-size:var(--calcite-font-size)}`, e = "arcgis-print", t = {
   exportSection: `${e}__export-section`,
   panelContainer: `${e}__panel-container`,

package/dist/components/arcgis-print-format-select/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as n, noShadowRoot as p } from "@arcgis/lumina";
 import { f as c } from "../../chunks/utils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 class d extends n {
   constructor() {
     super(...arguments), this._formats = [];

package/dist/components/arcgis-print-layout-advanced-options/customElement.js

@@ -7,7 +7,7 @@ import { css as r } from "@lit/reactive-element/css-tag.js";
 import { u as l } from "../../chunks/useHandles.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const c = r`.arcgis-print__advanced-options-container{padding:var(--calcite-spacing-xxs);display:flex;flex-direction:column;gap:var(--calcite-spacing-xs)}`, h = "arcgis-print", p = {
   advancedOptionsContainer: `${h}__advanced-options-container`
 };

package/dist/components/arcgis-print-layout-panel/customElement.js

@@ -7,7 +7,7 @@ import { css as d } from "@lit/reactive-element/css-tag.js";
 import { u as m } from "../../chunks/useHandles.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const h = d`.arcgis-print__advanced-options-section{border:1px solid var(--calcite-color-border-1);margin-bottom:var(--calcite-spacing-sm)}.arcgis-print__layout-section{padding:var(--calcite-spacing-sm) var(--calcite-spacing-sm)}.arcgis-print__panel-container{display:flex;flex:1 0;flex-direction:column;gap:var(--calcite-spacing-sm)}`, a = "arcgis-print", s = {
   advancedOptionsSection: `${a}__advanced-options-section`,
   layoutSection: `${a}__layout-section`,

package/dist/components/arcgis-print-main-panel/customElement.js

@@ -7,7 +7,7 @@ import { u as c } from "../../chunks/useHandles.js";
 import { watch as r } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const p = o`calcite-tab{--calcite-tab-content-block-padding: 0}calcite-loader{margin-right:var(--calcite-spacing-xxs)}`;
 class n extends i {
   constructor() {

package/dist/components/arcgis-print-map-only-advanced-options/customElement.js

@@ -4,7 +4,7 @@ import { LitElement as s, safeClassMap as n } from "@arcgis/lumina";
 import { css as a } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const r = a`.arcgis-print__advanced-options-container{padding:var(--calcite-spacing-xxs);display:flex;flex-direction:column;gap:var(--calcite-spacing-xs)}`, c = "arcgis-print", o = {
   advancedOptionsContainer: `${c}__advanced-options-container`
 };

package/dist/components/arcgis-print-map-only-panel/customElement.js

@@ -5,7 +5,7 @@ import { LitElement as o, safeClassMap as a } from "@arcgis/lumina";
 import { css as p } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const d = p`.arcgis-print__advanced-options-section{border:1px solid var(--calcite-color-border-1);margin-bottom:var(--calcite-spacing-sm)}.arcgis-print__map-only-section{padding:var(--calcite-spacing-sm) var(--calcite-spacing-sm)}.arcgis-print__panel-container{display:flex;flex:1 0;flex-direction:column;gap:var(--calcite-spacing-sm)}.arcgis-print__size-container{--button-width: 32px;display:inline-grid;grid-template-columns:1fr 1fr var(--button-width);column-gap:var(--calcite-spacing-xs);width:100%}.arcgis-print__swap-button{flex:1 0 auto;border:none;color:var(--calcite-color-border-input);align-self:flex-end;margin-bottom:var(--calcite-spacing-md)}.arcgis-print__swap-button calcite-button{width:var(--button-width);height:var(--button-width)}`, s = "arcgis-print", t = {
   advancedOptionsSection: `${s}__advanced-options-section`,
   mapOnlySection: `${s}__map-only-section`,

package/dist/components/arcgis-print-out-spatial-reference-input/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as d, safeClassMap as n } from "@arcgis/lumina";
 import { css as f } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const m = f`.arcgis-print__sr-label{display:flex;gap:var(--calcite-spacing-xs)}.arcgis-print__invalid-wkid-text{color:var(--calcite-color-status-danger);font-size:var(--calcite-font-size--0)}`, l = "arcgis-print", s = {
   srLabel: `${l}__sr-label`,
   invalidWkidText: `${l}__invalid-wkid-text`

package/dist/components/arcgis-print-preview-input/customElement.js

@@ -4,7 +4,7 @@ import { watch as r } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as s, noShadowRoot as a } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 class n extends s {
   constructor() {
     super(...arguments), this._showPrintAreaEnabled = !1;

package/dist/components/arcgis-print-scale-section/customElement.js

@@ -5,7 +5,7 @@ import { LitElement as p, safeClassMap as i } from "@arcgis/lumina";
 import { css as d } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const u = d`.arcgis-print__scale-input-container{display:flex;align-items:center;padding-bottom:var(--calcite-spacing-md)}.arcgis-print__scale-input-container .arcgis-print__scale-input{flex-grow:1}`, l = "arcgis-print", c = {
   scaleInfoContainer: `${l}__scale-info-container`,
   scaleInputContainer: `${l}__scale-input-container`,

package/dist/components/arcgis-print-template-select/customElement.js

@@ -8,7 +8,7 @@ import { g as p, a as d, b as h, c as _ } from "../../chunks/utils.js";
 import { css as g } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const u = g`.arcgis-print__template-select-container{border:1px solid var(--calcite-color-border-1);cursor:pointer}.arcgis-print__template-select-container .arcgis-print__template-select-error,.arcgis-print__template-select-container .arcgis-print__template-select-arrow{display:flex;align-self:center;margin-right:var(--calcite-spacing-md)}`, s = "arcgis-print", c = {
   templateSelectContainer: `${s}__template-select-container`,
   templateSelectError: `${s}__template-select-error`,

package/dist/components/arcgis-print-template-selector/customElement.js

@@ -8,7 +8,7 @@ import { css as y } from "@lit/reactive-element/css-tag.js";
 import { u as L } from "../../chunks/useHandles.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.20 */
 const S = y`.arcgis-print__template-select-flow-item-container{display:flex;flex-direction:column;justify-content:space-between;overflow-y:hidden;flex-grow:1}.arcgis-print__template-select-flow-item-container .arcgis-print__template-select-flow-item-content{display:flex;flex-direction:column;overflow-y:auto;flex:1 0}.arcgis-print__template-select-flow-item-container .arcgis-print__template-select-flow-item-content .arcgis-print__template-select-flow-item-list-heading{display:flex;gap:var(--calcite-spacing-xs);align-items:center;padding:var(--calcite-spacing-md) var(--calcite-spacing-lg);background-color:var(--calcite-color-foreground-2);border-bottom:1px solid var(--calcite-color-border-3);font-weight:var(--calcite-font-weight-semibold)}.arcgis-print__template-button-container{padding:var(--calcite-spacing-md)}.arcgis-print__template-done-button{width:100%}`, o = "arcgis-print", a = {
   templateSelectError: `${o}__template-select-error`,
   templateButtonContainer: `${o}__template-button-container`,