@arcgis/map-components 5.0.0-next.74 → 5.0.0-next.76

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

@@ -8,7 +8,6 @@ import { Alignment, DockOptions, PopupPositionResult, PopupPositionStyle, FetchF
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { nil } from '@arcgis/toolkit/type';
 import { ArcgisFeature } from '../arcgis-feature/customElement.js';
-import { default as ActionButton } from '@arcgis/core/support/actions/ActionButton.js';
 declare const useFeaturesViewModel: (component: LitElement & Pick<FeaturesViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<FeaturesViewModel>) => FeaturesViewModel;
 
 /**
@@ -122,8 +121,26 @@ export declare class ArcgisPopup extends LitElement {
      * // Adds the custom action to the popup.
      * popupComponent.actions.push(zoomOutAction);
      * ```
+     * @see [@trigger-action](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#event-trigger-action)
+     * @see [Sample - Popup actions](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
+     * @example
+     * // Defines an action button to zoom out from the selected feature
+     * const zoomOutAction = {
+     *   type: "button",
+     *   // This text is displayed as a tooltip
+     *   title: "Zoom out",
+     *   // The ID by which to reference the action in the event handler
+     *   id: "zoom-out",
+     *   // Sets the icon used to style the action button
+     *   icon: "magnifying-glass-minus"
+     * };
+     * // Adds the custom action to the popup.
+     * view.popup.viewModel.actions.push(zoomOutAction);
+     *
+     * // Adds the custom action to the Features widget
+     * featuresWidget.viewModel.actions.push(zoomOutAction);
      */
-    actions: __esri.Collection<ActionButton | __esri.ActionToggle>;
+    actions: import('@arcgis/core/core/Collection').default<import('@arcgis/core/widgets/Popup/interfaces').PopupAction>;
     /**
      * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup-PopupViewModel.html#waitingForResult).
      *
@@ -179,8 +196,17 @@ export declare class ArcgisPopup extends LitElement {
      * // unless it is overridden by a PopupTemplate
      * popupComponent.content = "Click a feature on the map to view its attributes";
      * ```
+     * @see [Sample - Popup Docking](https://developers.arcgis.com/javascript/latest/sample-code/popup-docking-position/)
+     * @example
+     * // This sets generic instructions in the popup that will always be displayed
+     * // unless it is overridden by a PopupTemplate.
+     * // This can be set on the Features widget view model
+     * featuresWidget.viewModel.content = "Click a feature on the map to view its attributes";
+     *
+     * // Or set on the Popup widget view model.
+     * view.popup.viewModel.content = "Click a feature on the map to view its attributes";
      */
-    content: string | nullish | HTMLElement | __esri.Widget;
+    content: string | HTMLElement | import('@arcgis/core/widgets/Widget').default<any> | null | undefined;
     /** Dock position in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) component. */
     get currentDockPosition(): nil | PopupPositionResult;
     /**
@@ -271,6 +297,7 @@ export declare class ArcgisPopup extends LitElement {
      * This value will only be honored if [`initialDisplayMode`](#initialDisplayMode) is set to "feature".
      *
      * @default false
+     * @since 4.32
      */
     featureMenuOpen: boolean;
     /**
@@ -303,8 +330,23 @@ export declare class ArcgisPopup extends LitElement {
      * let graphics = [g1, g2, g3, g4, g5];
      * popupComponent.features = graphics;
      * ```
+     * @example
+     * // When setting the features property, the graphics pushed to this property
+     * // must have a PopupTemplate set.
+     * let g1 = new Graphic();
+     * g1.popupTemplate = new PopupTemplate({
+     *   title: "Results title",
+     *   content: "Results: {ATTRIBUTE_NAME}"
+     * });
+     * // Create an array of graphics and set this to the features property. The content and title of
+     * // will be set depending on the PopupTemplate of the graphics.
+     * // Each graphic may share the same PopupTemplate or have a unique PopupTemplate.
+     * let graphics = [g1, g2, g3, g4, g5];
+     * // This value can be set on the popup  or Features view model.
+     * view.popup.viewModel.features = graphics;
+     * featuresWidget.viewModel.features = graphics;
      */
-    features: __esri.Graphic[];
+    features: import('@arcgis/core/Graphic').default[];
     /**
      * This function provides the ability to override either the [arcgis-map.goTo](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#goTo) or [arcgis-scene.goTo](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) methods.
      *
@@ -317,8 +359,20 @@ export declare class ArcgisPopup extends LitElement {
      *   return viewElement.goTo(goToParams.target, goToParams.options);
      * };
      * ```
+     * @since 4.8
+     * @see [MapView#goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo)
+     * @see [SceneView#goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo)
+     * @example
+     * // The following snippet uses Search but can be applied to any
+     * // widgets that support the goToOverride property.
+     * search.goToOverride = function(view, goToParams) {
+     *   goToParams.options = {
+     *     duration: updatedDuration
+     *   };
+     *   return view.goTo(goToParams.target, goToParams.options);
+     * };
      */
-    goToOverride: nullish | __esri.GoToOverride;
+    goToOverride: import('@arcgis/core/widgets/support/goToUtils').GoToOverride | null | undefined;
     /**
      * The title of the popup. This can be set generically on the popup no
      * matter the features that are selected. If the [selected feature](#selectedFeature)
@@ -338,8 +392,12 @@ export declare class ArcgisPopup extends LitElement {
      * // PopupTemplate overrides it
      * popupComponent.title = "Population by zip codes in Southern California";
      * ```
+     * @example
+     * // This title will display in the popup unless a selected feature's
+     * // PopupTemplate overrides it.
+     * view.popup.viewModel.title = "Population by zip codes in Southern California";
      */
-    heading: string | nullish;
+    heading: string | null | undefined;
     /**
      * Indicates the heading level to use for the [heading](#heading) of the popup.
      * By default, the heading is rendered
@@ -424,7 +482,7 @@ export declare class ArcgisPopup extends LitElement {
      *
      * @default "feature"
      */
-    initialDisplayMode: "list" | "feature";
+    initialDisplayMode: import('@arcgis/core/widgets/Popup/interfaces').InitialDisplayOptions;
     /** The component's default label. */
     label?: string;
     /**
@@ -456,8 +514,20 @@ export declare class ArcgisPopup extends LitElement {
      *   popupComponent.visible = true;
      * });
      * ```
+     * @see [Get started with popups](https://developers.arcgis.com/javascript/latest/sample-code/intro-popup/)
+     * @example
+     * // Sets the location of the popup to the center of the view
+     * view.popup.viewModel.location = view.center;
+     * // Displays the popup
+     * view.popup.visible =  true;
+     * @example
+     * // Display a popup when and where the user clicks the view.
+     * reactiveUtils.on(()=>view, "click", ({ mapPoint })=>{
+     *   view.popup.viewModel.location = mapPoint;
+     *   view.popup.visible = true;
+     * });
      */
-    location: __esri.Point | nullish;
+    location: import('@arcgis/core/geometry/Point').default | null | undefined;
     /** Overwrite localized strings for this component */
     messageOverrides?: typeof this.messages._overrides;
     /**
@@ -466,7 +536,7 @@ export declare class ArcgisPopup extends LitElement {
      * resolved they are removed from this array and the features they return
      * are pushed into the [features](#features) array.
      */
-    promises: Promise<__esri.Graphic[]>[];
+    promises: Promise<import('@arcgis/core/Graphic').default[]>[];
     /**
      * 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.
      *
@@ -483,7 +553,7 @@ export declare class ArcgisPopup extends LitElement {
      * determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) assigned to
      * this feature.
      */
-    readonly selectedFeature: __esri.Graphic | nullish;
+    readonly selectedFeature: import('@arcgis/core/Graphic').default | null;
     /**
      * Returns a reference to the current [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature/) that the Popup is using.
      * This is useful if needing to get a reference to the component in order to make any changes to it.
@@ -499,12 +569,12 @@ export declare class ArcgisPopup extends LitElement {
      *
      * @default "disabled"
      */
-    readonly state: "ready" | "disabled";
+    state: import('@arcgis/core/widgets/Popup/interfaces').State;
     /**
      * 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 Popup component will be associated with a map or scene component rather than using the `view` property.
      */
-    view?: nullish | __esri.MapView | __esri.SceneView;
+    view?: import('@arcgis/core/views/MapViewOrSceneView').MapViewOrSceneView | null | undefined;
     /**
      * Indicates whether the popup is visible. This property is `true` when the popup is querying for results, even if it is not open.
      * Use the property to check if the popup is visible.
@@ -512,6 +582,7 @@ export declare class ArcgisPopup extends LitElement {
      * @default false
      * @name visible
      * @type {boolean}
+     * @see [active](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#active)
      */
     visible: boolean;
     /**
@@ -631,7 +702,7 @@ export declare class ArcgisPopup extends LitElement {
      */
     triggerAction(action: __esri.ActionButton | __esri.ActionToggle): Promise<void>;
     readonly arcgisPropertyChange: TargetedEvent<this, {
-        name: "active" | "visible" | "state" | "collapsed" | "featureCount" | "selectedFeature" | "featureMenuOpen" | "features" | "promises" | "selectedFeatureIndex" | "selectedDrillInFeature" | "selectedFeatureComponent" | "currentAlignment" | "dockEnabled";
+        name: "active" | "visible" | "state" | "collapsed" | "features" | "promises" | "featureCount" | "selectedFeature" | "featureMenuOpen" | "selectedFeatureIndex" | "selectedDrillInFeature" | "selectedFeatureComponent" | "currentAlignment" | "dockEnabled";
     }>;
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
@@ -680,7 +751,7 @@ export declare class ArcgisPopup extends LitElement {
      * });
      * ```
      */
-    readonly arcgisTriggerAction: TargetedEvent<this, __esri.PopupTriggerActionEvent>;
+    readonly arcgisTriggerAction: TargetedEvent<this, import('@arcgis/core/widgets/Popup/interfaces').ActionEvent>;
     private messages;
 }
 export {};

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

@@ -15,7 +15,7 @@ import { t as I } from "../../chunks/screenLocation.js";
 import "../arcgis-search-result-renderer/customElement.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.74 */
+v5.0.0-next.76 */
 const p = "arcgis-popup", u = `${p}--is-docked`, a = {
   base: p,
   baseHidden: `${p}--hidden`,

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

@@ -49,6 +49,7 @@ export declare class ArcgisPresentation extends LitElement {
      * @default false
      */
     keyboardNavigationEnabled: boolean;
+    /** Permanently destroy the component */
     destroy(): Promise<void>;
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;

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

@@ -5,25 +5,25 @@ import { LitElement as u, createEvent as m, nothing as h } from "@arcgis/lumina"
 import { u as S } from "../../chunks/useT9n.js";
 import { m as w } from "../../chunks/useViewModel.js";
 import { property as d, subclass as b } from "@arcgis/core/core/accessorSupport/decorators.js";
-import x from "@arcgis/core/core/Collection.js";
-import f from "@arcgis/core/core/Accessor.js";
+import f from "@arcgis/core/core/Collection.js";
+import x from "@arcgis/core/core/Accessor.js";
 import { watch as y } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.74 */
+v5.0.0-next.76 */
 const I = g`:host{width:100%;height:100%;padding:var(--calcite-spacing-none);margin:var(--calcite-spacing-none);display:flex}p{padding:0;margin:0}.navigation{--internal-attribution-height: 16px;pointer-events:auto;display:flex;align-items:center;gap:var(--calcite-spacing-sm);background-color:var(--calcite-color-foreground-1);box-shadow:var(--arcgis-internal-box-shadow);align-self:flex-end;margin-block:auto calc(var(--calcite-spacing-fixed-xl) + var(--internal-attribution-height));margin-inline-start:var(--calcite-spacing-fixed-xl)}.slide-counter-text{display:flex;align-items:center;justify-content:center;gap:var(--calcite-spacing-base);min-width:64px}.slide-counter-text-element{box-sizing:border-box;max-width:28px;margin:0;padding:0;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;font-variant-numeric:tabular-nums}`;
-var _ = Object.defineProperty, M = Object.getOwnPropertyDescriptor, l = (t, e, i, r) => {
-  for (var n = r > 1 ? void 0 : r ? M(e, i) : e, a = t.length - 1, o; a >= 0; a--)
-    (o = t[a]) && (n = (r ? o(e, i, n) : o(n)) || n);
-  return r && n && _(e, i, n), n;
+var _ = Object.defineProperty, M = Object.getOwnPropertyDescriptor, l = (e, t, i, r) => {
+  for (var n = r > 1 ? void 0 : r ? M(t, i) : t, o = e.length - 1, a; o >= 0; o--)
+    (a = e[o]) && (n = (r ? a(t, i, n) : a(n)) || n);
+  return r && n && _(t, i, n), n;
 };
-let s = class extends f {
+let s = class extends x {
   //#region Lifecycle
-  constructor(t) {
-    super(t), this.keyboardNavigationEnabled = !1;
+  constructor(e) {
+    super(e), this.keyboardNavigationEnabled = !1;
   }
   get visibleSlides() {
-    return this.view?.map?.presentation?.slides?.filter((t) => !t.hidden) ?? new x();
+    return this.view?.map?.presentation?.slides?.filter((e) => !e.hidden) ?? new f();
   }
   get lastSlideSelected() {
     return this.getSlideIndexBySlideId(this.slideId) === this.visibleSlides.length - 1;
@@ -40,12 +40,12 @@ let s = class extends f {
   get slideIndex() {
     return this.getSlideIndexBySlideId(this.slideId);
   }
-  getSlideIndexBySlideId(t) {
-    let e = -1;
-    return t && (e = this.visibleSlides.findIndex((i) => i.id === t)), e;
+  getSlideIndexBySlideId(e) {
+    let t = -1;
+    return e && (t = this.visibleSlides.findIndex((i) => i.id === e)), t;
   }
-  navigateInPresentation(t) {
-    const e = this.slideIndex + t, i = this._getSlideBySlideIndex(e);
+  navigateInPresentation(e) {
+    const t = this.slideIndex + e, i = this._getSlideBySlideIndex(t);
     if (i)
       this.slideId = i.id;
     else {
@@ -53,18 +53,18 @@ let s = class extends f {
       r && (this.slideId = r.id);
     }
   }
-  captureArrowKeysForNavigation(t, e) {
+  captureArrowKeysForNavigation(e, t) {
     const i = ["ArrowLeft", "ArrowRight", "PageUp", "PageDown"];
-    if (document.activeElement?.nodeName.toLowerCase() === "arcgis-scene" || !i.includes(t.code))
+    if (document.activeElement?.nodeName.toLowerCase() === "arcgis-scene" || !i.includes(e.code))
       return;
-    const n = e === "rtl" ? "ArrowRight" : "ArrowLeft", a = e === "rtl" ? "PageDown" : "PageUp", o = t.code === n || t.code === a ? -1 : 1;
-    this.navigateInPresentation(o);
+    const n = t === "rtl" ? "ArrowRight" : "ArrowLeft", a = e.code === n || e.code === "PageUp" ? -1 : 1;
+    this.navigateInPresentation(a);
   }
   //#endregion
   //#region Private Methods
-  _getSlideBySlideIndex(t) {
-    if (t != null && t >= 0 && t < this.visibleSlides.length)
-      return this.visibleSlides.getItemAt(t);
+  _getSlideBySlideIndex(e) {
+    if (e != null && e >= 0 && e < this.visibleSlides.length)
+      return this.visibleSlides.getItemAt(e);
   }
   //#endregion
 };
@@ -101,8 +101,8 @@ s = l([
 const $ = w(s);
 class P extends u {
   constructor() {
-    super(...arguments), this._messages = S(), this.viewModel = $(this), this._direction = v(), this._captureArrowKeysForNavigation = (e) => {
-      this.viewModel.captureArrowKeysForNavigation(e, this._direction);
+    super(...arguments), this._messages = S(), this.viewModel = $(this), this._direction = v(), this._captureArrowKeysForNavigation = (t) => {
+      this.viewModel.captureArrowKeysForNavigation(t, this._direction);
     }, this.autoDestroyDisabled = !1, this.view = this.viewModel.view, this.scale = "m", this.keyboardNavigationEnabled = !1, this.arcgisReady = m();
   }
   static {
@@ -114,24 +114,26 @@ class P extends u {
   get slideId() {
     return this.viewModel.slideId;
   }
-  set slideId(e) {
-    this.viewModel.slideId = e;
+  set slideId(t) {
+    this.viewModel.slideId = t;
   }
   async destroy() {
-    document.removeEventListener("keydown", this._captureArrowKeysForNavigation), await this.manager.destroy();
+    await this.manager.destroy();
   }
-  load() {
-    y(() => this.keyboardNavigationEnabled, (e) => {
-      document.removeEventListener("keydown", this._captureArrowKeysForNavigation), e && document.addEventListener("keydown", this._captureArrowKeysForNavigation);
-    }, { initial: !0 });
+  loaded() {
+    this.manager.onLifecycle(() => y(() => this.keyboardNavigationEnabled, (i) => {
+      document.removeEventListener("keydown", this._captureArrowKeysForNavigation), i && document.addEventListener("keydown", this._captureArrowKeysForNavigation);
+    }, { initial: !0 })), this.manager.onDisconnected(() => {
+      document.removeEventListener("keydown", this._captureArrowKeysForNavigation);
+    });
   }
   render() {
-    const e = this.viewModel.lastSlideSelected && !this.viewModel.hasOnlyOneSlide, i = this._direction === "rtl", r = i ? "chevron-right" : "chevron-left", n = i ? "chevron-left" : "chevron-right";
-    return this.viewModel.visibleSlides.length === 0 ? c`<div></div>` : c`<div class="navigation"><calcite-button appearance=transparent icon-start=${r} kind=neutral .scale=${this.scale} .disabled=${this.viewModel.firstSlideSelected || !this.viewModel.slideSelected} .label=${this._messages.previous} title=${this._messages.previous ?? h} @click=${() => this.viewModel.navigateInPresentation(-1)}></calcite-button><div class="slide-counter-text">${this._renderSlideCounter()}</div><calcite-button appearance=transparent icon-start=${e ? "reset" : n} kind=neutral .scale=${this.scale} .label=${e ? this._messages.restart : this._messages.next} title=${(e ? this._messages.restart : this._messages.next) ?? h} @click=${() => this.viewModel.navigateInPresentation(1)}></calcite-button></div>`;
+    const t = this.viewModel.lastSlideSelected && !this.viewModel.hasOnlyOneSlide, i = this._direction === "rtl", r = i ? "chevron-right" : "chevron-left", n = i ? "chevron-left" : "chevron-right";
+    return this.viewModel.visibleSlides.length === 0 ? c`<div></div>` : c`<div class="navigation"><calcite-button appearance=transparent icon-start=${r} kind=neutral .scale=${this.scale} .disabled=${this.viewModel.firstSlideSelected || !this.viewModel.slideSelected} .label=${this._messages.previous} title=${this._messages.previous ?? h} @click=${() => this.viewModel.navigateInPresentation(-1)}></calcite-button><div class="slide-counter-text">${this._renderSlideCounter()}</div><calcite-button appearance=transparent icon-start=${t ? "reset" : n} kind=neutral .scale=${this.scale} .label=${t ? this._messages.restart : this._messages.next} title=${(t ? this._messages.restart : this._messages.next) ?? h} @click=${() => this.viewModel.navigateInPresentation(1)}></calcite-button></div>`;
   }
   _renderSlideCounter() {
-    const e = this.viewModel.slideIndex + 1, i = this._messages?.slideNavAriaText?.replace("${index}", e.toString()).replace("${numberOfSlides}", this.viewModel.visibleSlides.length.toString());
-    return this.viewModel.slideSelected ? c`<p role=banner aria-label=${i ?? h} aria-live=polite><div class="slide-counter-text-element" data-testId=arcgis-map-presentation-slideIndex>${e}</div><div class="slide-counter-text-element">/</div><p class="slide-counter-text-element" data-testId=arcgis-map-presentation-numberOfSlides>${this.viewModel.visibleSlides.length}</p></p>` : c`<p role=banner data-testId=arcgis-map-presentation-numberOfSlides>${this.viewModel.visibleSlides?.length} ${this._messages?.slides}</p>`;
+    const t = this.viewModel.slideIndex + 1, i = this._messages?.slideNavAriaText?.replace("${index}", t.toString()).replace("${numberOfSlides}", this.viewModel.visibleSlides.length.toString());
+    return this.viewModel.slideSelected ? c`<p role=banner aria-label=${i ?? h} aria-live=polite><div class="slide-counter-text-element" data-testId=arcgis-map-presentation-slideIndex>${t}</div><div class="slide-counter-text-element">/</div><p class="slide-counter-text-element" data-testId=arcgis-map-presentation-numberOfSlides>${this.viewModel.visibleSlides.length}</p></p>` : c`<p role=banner data-testId=arcgis-map-presentation-numberOfSlides>${this.viewModel.visibleSlides?.length} ${this._messages?.slides}</p>`;
   }
 }
 p("arcgis-presentation", P);

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

@@ -61,7 +61,7 @@ export declare class ArcgisPrint extends LitElement {
      * 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 Print component will be associated with a map or scene component rather than using the `view` property.
      */
-    view?: nullish | __esri.MapView;
+    view?: import('@arcgis/core/views/MapView').default | null | undefined;
     /**
      * Indicates whether the component's header is hidden.
      *
@@ -100,8 +100,19 @@ export declare class ArcgisPrint extends LitElement {
      * If none of the input string values match those available from the print service, `allowedFormats` will fallback to default behavior.
      *
      * @default "all"
+     * @since 4.15
+     * @see [TemplateOptions#format](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-TemplateOptions.html#format)
+     * @example
+     * const print = new Print({
+     *   view: view,
+     *   printServiceUrl: url
+     * });
+     *
+     * print.viewModel.allowedFormats = ["jpg", "png8", "png32"];
+     *
+     * view.ui.add(print, {position: "top-right"});
      */
-    allowedFormats: string | string[];
+    allowedFormats: import('@arcgis/core/widgets/Print/interfaces').Formats;
     /**
      * Specify the print output layout(s) that the user can select based on the options available from the print service.
      * This property can take a string value or an array of string values.
@@ -111,8 +122,19 @@ export declare class ArcgisPrint extends LitElement {
      * If none of the input string values match those available from the print service, `allowedLayouts` will fallback to default behavior.
      *
      * @default "all"
+     * @since 4.15
+     * @see [TemplateOptions.layout](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-TemplateOptions.html#format)
+     * @example
+     * const print = new Print({
+     *   view: view,
+     *   printServiceUrl: url
+     * });
+     *
+     * print.viewModel.allowedLayouts = ["a3-landscape", "a3-portrait"];
+     *
+     * view.ui.add(print, {position: "top-right"});
      */
-    allowedLayouts: string | string[];
+    allowedLayouts: import('@arcgis/core/widgets/Print/interfaces').Layouts;
     /**
      * Indicates whether to automatically populate the author field in the print layout advanced options
      * with the username of the current portal user.
@@ -127,10 +149,18 @@ export declare class ArcgisPrint extends LitElement {
      * This property can take a string value or an array of string values.
      */
     allowedFormatsForSaving?: Formats;
-    /** 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;
+    /**
+     * The collection of links exported from the Print component.
+     *
+     * @since 4.33
+     */
+    exportedLinks: import('@arcgis/core/core/Collection').default<import('@arcgis/core/widgets/Print/FileLink').default>;
+    /**
+     * This option allows passing extra parameters (in addition to [templateOptions](#templateOptions)) to the print (export webmap) requests.
+     *
+     * @since 4.20
+     */
+    extraParameters: Record<string, any> | null | undefined;
     /**
      * 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
@@ -153,22 +183,31 @@ 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. */
-    outSpatialReference: nullish | __esri.SpatialReference;
+    /**
+     * The [spatial reference](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-SpatialReference.html) used to render the printed map on the server.
+     *
+     * @since 4.33
+     */
+    outSpatialReference: import('@arcgis/core/geometry/SpatialReference').default | null | undefined;
     /**
      * 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 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.
+     *
+     * @since 4.18
+     * @see [CustomTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-CustomTemplate.html)
      */
-    portal: __esri.Portal;
+    portal: import('@arcgis/core/portal/Portal').default;
     /**
      * 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.
      *
      * @default false
+     * @since 4.30
+     * @see [Print component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-print/)
      */
     showPrintAreaEnabled: boolean;
     /**
@@ -176,7 +215,7 @@ export declare class ArcgisPrint extends LitElement {
      * 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;
+    printServiceUrl: string | null | undefined;
     /**
      * Indicates whether to show the "Save As" option in the Print component UI.
      *
@@ -199,9 +238,34 @@ export declare class ArcgisPrint extends LitElement {
      * 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.
+     *
+     * @since 4.22
+     * @example
+     * const printViewModel = new PrintViewModel({
+     *    view: view,
+     *    // specify your custom print service
+     *    printServiceUrl: "",
+     *    // `customTextElements` are defined per print template
+     *    // this example has one template with `customTextElements`
+     *    templateCustomTextElements: {
+     *       // if there were more applicable templates, then we would
+     *       // create another object with the template name containing
+     *       // an array of more name-value pairs
+     *       "Portrait_TextElements": [
+     *           // the possible values are defined in the print service
+     *           { "headquarters": "Tampa, Florida" },
+     *           { "division": "NFC South" },
+     *           { "founded": "1976" }
+     *       ]
+     *    }
+     *  });
+     */
+    templateCustomTextElements: import('@arcgis/core/widgets/Print/interfaces').TemplateCustomTextElements | null | undefined;
+    /**
+     * Defines the layout template options used by the Print component to generate the print page.
+     *
+     * @since 4.33
      */
-    templateCustomTextElements: nullish | HashMap<HashMap<string>[]>;
-    /** Defines the layout template options used by the Print component to generate the print page. */
     get templateOptions(): typeof this.viewModel.templateOptions;
     set templateOptions(value: Partial<__esri.TemplateOptions>);
     /**
@@ -227,7 +291,7 @@ export declare class ArcgisPrint extends LitElement {
      *
      * @default "disabled"
      */
-    readonly state: "ready" | "disabled" | "error" | "initializing";
+    state: import('@arcgis/core/widgets/Print/interfaces').State;
     /**
      * Adds a portal item to a collection of browse templates available in the Print component UI.
      *
@@ -239,7 +303,7 @@ export declare class ArcgisPrint extends LitElement {
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /** Emitted when the component is complete. */
-    readonly arcgisComplete: TargetedEvent<this, __esri.PrintCompleteEvent>;
+    readonly arcgisComplete: TargetedEvent<this, import('@arcgis/core/widgets/Print/PrintViewModel.js').CompleteEvent>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
@@ -247,11 +311,11 @@ export declare class ArcgisPrint extends LitElement {
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     /** Emitted when the component is submitted. */
-    readonly arcgisSubmit: TargetedEvent<this, __esri.PrintSubmitEvent>;
+    readonly arcgisSubmit: TargetedEvent<this, import('@arcgis/core/widgets/Print/PrintViewModel.js').SubmitEvent>;
     /** Emitted when the collection of browse templates changes. */
-    readonly arcgisBrowseTemplatesChange: TargetedEvent<this, __esri.CollectionChangeEvent<__esri.CustomTemplate>>;
+    readonly arcgisBrowseTemplatesChange: TargetedEvent<this, import('@arcgis/core/core/interfaces').CollectionChangeEvent<import('@arcgis/core/widgets/Print/CustomTemplate').default>>;
     /** Emitted when the user saves an exported map printout. */
-    readonly arcgisSaveAs: TargetedEvent<this, __esri.FileLink>;
+    readonly arcgisSaveAs: TargetedEvent<this, import('@arcgis/core/widgets/Print/FileLink').default>;
     private messages: {
         componentLabel: string;
         title: string;

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

@@ -11,7 +11,7 @@ import { g } from "../../chunks/globalCss.js";
 import { watch as d } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.74 */
+v5.0.0-next.76 */
 const b = m`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}:host{--panel-min-height--large: 240px;display:flex;flex-direction:column;flex-grow:1}.arcgis-print{display:flex;position:relative;flex-grow:1;min-height:var(--panel-min-height--large)}.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)}`, a = "arcgis-print", s = {
   base: a,
   headerTitle: `${a}__header-title`,
@@ -29,7 +29,7 @@ class M extends v {
     super(...arguments), this.messages = f({ blocking: !0 }), this.viewModel = y(this), this.error = null, this._showTemplates = !1, this.view = this.viewModel.view, this.hideHeader = !1, this.icon = "print", this.hideAdvancedOptions = !1, this.allowedFormats = this.viewModel.allowedFormats, this.allowedLayouts = this.viewModel.allowedLayouts, this.autoPopulateAuthor = !1, this.exportedLinks = this.viewModel.exportedLinks, this.extraParameters = this.viewModel.extraParameters, this.headingLevel = 3, this.excludeDefaultTemplates = !this.viewModel.includeDefaultTemplates, this.excludeOrganizationTemplates = !1, this.outSpatialReference = this.viewModel.outSpatialReference, this.portal = this.viewModel.portal, this.showPrintAreaEnabled = this.viewModel.showPrintAreaEnabled, this.printServiceUrl = this.viewModel.printServiceUrl, this.templateCustomTextElements = this.viewModel.templateCustomTextElements, this.templateOptions = this.viewModel.templateOptions, this.autoDestroyDisabled = !1, this.state = this.viewModel.state, this.arcgisComplete = c(() => this.viewModel, "complete"), this.arcgisPropertyChange = _()("state"), this.arcgisReady = n(), this.arcgisSubmit = c(() => this.viewModel, "submit"), this.arcgisBrowseTemplatesChange = n(), this.arcgisSaveAs = n();
   }
   static {
-    this.properties = { error: 16, _showTemplates: 16, view: 0, hideHeader: 5, referenceElement: 1, position: 3, icon: 1, hideAdvancedOptions: 5, allowedFormats: [1, { type: String, converter: p }], allowedLayouts: [1, { type: String, converter: p }], autoPopulateAuthor: 5, allowedFormatsForSaving: 1, exportedLinks: 0, extraParameters: 1, headingLevel: 9, excludeDefaultTemplates: 5, excludeOrganizationTemplates: 5, outSpatialReference: 0, portal: 0, showPrintAreaEnabled: 5, printServiceUrl: 1, showSaveAs: 5, templateCustomTextElements: 0, templateOptions: 0, autoDestroyDisabled: 5, messageOverrides: 0, label: 1, state: 3 };
+    this.properties = { error: 16, _showTemplates: 16, view: 0, hideHeader: 5, referenceElement: 1, position: 3, icon: 1, hideAdvancedOptions: 5, allowedFormats: [1, { type: String, converter: p }], allowedLayouts: [1, { type: String, converter: p }], autoPopulateAuthor: 5, allowedFormatsForSaving: 1, exportedLinks: 0, extraParameters: 0, headingLevel: 9, excludeDefaultTemplates: 5, excludeOrganizationTemplates: 5, outSpatialReference: 0, portal: 0, showPrintAreaEnabled: 5, printServiceUrl: 1, showSaveAs: 5, templateCustomTextElements: 0, templateOptions: 0, autoDestroyDisabled: 5, messageOverrides: 0, label: 1, state: 3 };
   }
   static {
     this.styles = b;

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

@@ -6,6 +6,6 @@ export declare const reArcGISOnlineDomain: RegExp;
 export declare function getPageSizeLabel(template: __esri.CustomTemplate | nil): string | undefined;
 export declare function getTemplateLabel(template: __esri.CustomTemplate, messages: ArcgisPrint["messages"]): string;
 export declare function getLayoutIcon(layout: string): string | undefined;
-export declare const formatJsonMap: Map<FileFormatJSON, "eps" | "svg" | "jpg" | "png8" | "png32" | "pdf" | "gif" | "svgz" | "aix" | "tiff">;
+export declare const formatJsonMap: Map<FileFormatJSON, "eps" | "jpg" | "svg" | "png8" | "png32" | "pdf" | "gif" | "svgz" | "aix" | "tiff">;
 export declare const layoutKebabDict: Map<LayoutTemplateJSON, LayoutTemplate>;
 export declare function isMapOnlyLayout(layout: nil | string): boolean;

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

@@ -4,7 +4,7 @@ import { watch as a } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as u } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.74 */
+v5.0.0-next.76 */
 class p extends u {
   static {
     this.properties = { viewModel: 0 };

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

@@ -4,7 +4,7 @@ import { watch as n } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as s } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.74 */
+v5.0.0-next.76 */
 class p extends s {
   constructor() {
     super(...arguments), this._dpi = 1;

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

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