@arcgis/map-components 5.0.0-next.7 → 5.0.0-next.71

package/dist/chunks/useArcgisViewReadyError.js

@@ -1,86 +1,116 @@
-import { html as l } from "lit";
-import { GenericController as c, useDirection as u, makeGenericController as n } from "@arcgis/lumina/controllers";
-import { getSlotAssignedElements as h } from "@arcgis/toolkit/dom";
-import { a as d } from "./slots.js";
-import { watch as p } from "@arcgis/core/core/reactiveUtils.js";
-import { createEvent as a } from "@arcgis/lumina";
+import { html as u } from "lit";
+import { watch as n, when as m } from "@arcgis/core/core/reactiveUtils.js";
+import { GenericController as d, useDirection as f, makeGenericController as a } from "@arcgis/lumina/controllers";
+import { getSlotAssignedElements as g } from "@arcgis/toolkit/dom";
+import { a as b } from "./slots.js";
+import { createEvent 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.7 */
-class R extends c {
+v5.0.0-next.71 */
+class C extends d {
   //#endregion
   //#region Lifecycle
-  constructor(o) {
-    super(o), this.direction = u(), this.component.listen("arcgisViewClick", (r) => {
-      this._handleOpenPopup(r.detail);
-    }), this.component.listenOn(globalThis, "unhandledrejection", (r) => {
-      if (r.reason?.name === "webgl:required") {
-        const { name: e } = r.reason;
+  constructor(t) {
+    super(t), this.direction = f(), this.attributionHeight = 0, this.component.listen("arcgisViewClick", (o) => {
+      this._handleOpenPopup(o.detail);
+    }), this.component.listenOn(globalThis, "unhandledrejection", (o) => {
+      if (o.reason?.name === "webgl:required") {
+        const { name: e } = o.reason;
         this.webGLError = { name: e };
       }
     });
   }
   //#endregion
   //#region Private Methods
-  openPopup(o) {
-    this.popupRef?.open(o);
+  hostLifecycle() {
+    let t;
+    return [
+      n(() => this.component.view?.ready, () => {
+        const e = this.component.view, r = e.container?.querySelector(".esri-attribution");
+        !r || !e || (t?.disconnect(), t = new ResizeObserver(() => {
+          const i = r.clientHeight;
+          if (i === this.attributionHeight)
+            return;
+          const p = i - this.attributionHeight;
+          if (p !== 0) {
+            if (!this.component.el.shadowRoot)
+              return;
+            const c = getComputedStyle(this.component.el.shadowRoot.host).getPropertyValue("--arcgis-layout-overlay-space-bottom").trim(), h = Number.parseInt(c) + p;
+            this.component.el.style.setProperty("--arcgis-layout-overlay-space-bottom", `${h}px`);
+          }
+          this.attributionHeight = i;
+        }), t.observe(r));
+      }, { once: !0 }),
+      // Close component popup when view popup is opened
+      m(() => this.component.view.popup?.visible, () => {
+        this.popupRef?.visible && (this.popupRef.visible = !1);
+      }),
+      {
+        remove: () => {
+          t?.disconnect();
+        }
+      }
+    ];
+  }
+  openPopup(t) {
+    this.popupRef ? this.popupRef.open(t) : this.component.view.openPopup(t);
   }
   closePopup() {
-    this.popupRef && (this.popupRef.visible = !1);
+    this.popupRef ? this.popupRef.visible = !1 : this.component.view.closePopup();
   }
-  async _handleOpenPopup(o) {
-    if (this.component.popupDisabled && this.popupRef) {
-      o.stopPropagation();
-      const { location: r, promises: e } = await this.popupRef?.handleViewClick(o);
-      e?.length && this.popupRef?.open({ location: r, promises: e });
+  async _handleOpenPopup(t) {
+    if (this.popupRef && !this.component.popupDisabled) {
+      t.stopPropagation();
+      const { location: o, promises: e } = await this.popupRef?.handleViewClick(t);
+      e?.length && (this.component.view.closePopup(), this.popupRef?.open({ location: o, promises: e }));
     }
   }
-  _handlePopupSlotChange(o) {
-    const r = h(o.target, "arcgis-popup");
-    !this.popupRef && r.length ? this.popupRef = r[0] : r.length || (this.popupRef = void 0);
+  _handlePopupSlotChange(t) {
+    const o = g(t.target, "arcgis-popup");
+    !this.popupRef && o.length ? this.popupRef = o[0] : o.length || (this.popupRef = void 0);
   }
   _webGLErrorAlert() {
-    return this.webGLError ? l`<calcite-alert icon=x-octagon kind=danger open .label=${this.webGLError.name}><div slot=title>Unable to display map. WebGL2 support is required.</div><div slot=message>Ensure that your browser and hardware meet the minimum requirements.</div><calcite-link slot=link href=https://esriurl.com/webgl-faq>https://esriurl.com/webgl-faq</calcite-link></calcite-alert>` : null;
+    return this.webGLError ? u`<calcite-alert icon=x-octagon kind=danger open .label=${this.webGLError.name}><div slot=title>Unable to display map. WebGL2 support is required.</div><div slot=message>Ensure that your browser and hardware meet the minimum requirements.</div><calcite-link slot=link href=https://esriurl.com/webgl-faq>https://esriurl.com/webgl-faq</calcite-link></calcite-alert>` : null;
   }
   //#endregion
   //#region Rendering
   render() {
-    return d(this.direction, (o) => this._handlePopupSlotChange(o), this._webGLErrorAlert());
+    return b(this.direction, (t) => this._handlePopupSlotChange(t), this._webGLErrorAlert());
   }
 }
-const L = n((t, o) => {
-  const r = a();
-  return o.onLifecycle(
-    () => p(
+const G = a((s, t) => {
+  const o = l();
+  return t.onLifecycle(
+    () => n(
       () => {
-        const { map: e } = t;
+        const { map: e } = s;
         if (!e || e.destroyed)
           return [];
-        const i = [];
-        return e.loadError && i.push(e), e.basemap?.loadError && i.push(e.basemap), e.ground.loadError && i.push(e.ground), [...e.allLayers, ...e.allTables].forEach((s) => {
-          s.loadError && i.push(s);
-        }), i;
+        const r = [];
+        return e.loadError && r.push(e), e.basemap?.loadError && r.push(e.basemap), e.ground.loadError && r.push(e.ground), [...e.allLayers, ...e.allTables].forEach((i) => {
+          i.loadError && r.push(i);
+        }), r;
       },
       (e) => {
-        e.length && (t.loadErrorSources = e, r.emit());
+        e.length && (s.loadErrorSources = e, o.emit());
       }
     )
-  ), r;
-}), y = n(
-  (t, o) => {
-    const r = a();
-    return o.onLifecycle(
-      () => p(
-        () => t.view?.readyState,
+  ), o;
+}), k = a(
+  (s, t) => {
+    const o = l();
+    return t.onLifecycle(
+      () => n(
+        () => s.view?.readyState,
         (e) => {
-          (e === "map-content-error" || e === "rendering-error") && r.emit();
+          (e === "map-content-error" || e === "rendering-error") && o.emit();
         }
       )
-    ), r;
+    ), o;
   }
 );
 export {
-  R as U,
-  y as a,
-  L as u
+  C as U,
+  k as a,
+  G as u
 };

package/dist/chunks/useHandles.js

@@ -1,7 +1,7 @@
 import { toFunction as i, Controller as n } from "@arcgis/lumina/controllers";
 /*! 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.7 */
+v5.0.0-next.71 */
 class o {
   constructor() {
     this._groups = /* @__PURE__ */ new Map();

package/dist/chunks/useT9n.js

@@ -2,7 +2,7 @@ import { makeT9nController as o } from "@arcgis/lumina/controllers";
 import { g as t } from "./runtime.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.7 */
+v5.0.0-next.71 */
 const s = o(t);
 export {
   s as u

package/dist/chunks/useView.js

@@ -3,7 +3,7 @@ import { a as t } from "./component-utils.js";
 import * as r 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.7 */
+v5.0.0-next.71 */
 const p = (o) => l(o);
 class c extends s {
   #e;

package/dist/chunks/useViewModel.js

@@ -5,7 +5,7 @@ import { V as m } from "./useView.js";
 import { watch as p } 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.7 */
+v5.0.0-next.71 */
 const v = (t, o) => (e) => a(e, t);
 class r extends i {
   #o = void 0;

package/dist/chunks/useWidget.js

@@ -5,7 +5,7 @@ import { V as g } from "./useView.js";
 import { watch as m } 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.7 */
+v5.0.0-next.71 */
 const I = (d, e) => (t) => C(t, d);
 class p extends b {
   #o = /* @__PURE__ */ new Map();

package/dist/chunks/utils.js

@@ -1,7 +1,7 @@
-import { formatNumber as r } from "@arcgis/core/intl.js";
+import { formatNumber as i } from "@arcgis/core/intl.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.7 */
+v5.0.0-next.71 */
 const p = /* @__PURE__ */ new Map([
   ["a3-landscape", "a3-landscape"],
   ["a3-portrait", "a3-portrait"],
@@ -19,11 +19,11 @@ function f(a) {
   if (!t)
     return;
   const [e, n] = t.pageSize;
-  return `${r(e)} × ${r(n)} ${a.pageUnits}`;
+  return `${i(e)} × ${i(n)} ${a.pageUnits}`;
 }
 function d(a, t) {
-  const { label: e, layout: n, layoutItem: i, type: o } = a;
-  return o === "print-service-template" && t[n] ? t[n] : (e ?? n ?? i?.id)?.replaceAll("_", " ") ?? t.untitled;
+  const { label: e, layout: n, layoutItem: o } = a, r = n && !o && t[n] ? t[n] : null;
+  return r || ((e ?? n ?? o?.id)?.replaceAll("_", " ") ?? t.untitled);
 }
 function g(a) {
   return p.get(a);

package/dist/chunks/utils2.js

@@ -2,7 +2,7 @@ import { substitute as o, formatNumber as l } from "@arcgis/core/intl.js";
 import { stripHTML as s } from "@arcgis/core/applications/Components/stringUtils.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.7 */
+v5.0.0-next.71 */
 function d(r, t) {
   return t;
 }

package/dist/chunks/visible-element.js

@@ -0,0 +1,9 @@
+/*! 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.71 */
+function n(e) {
+  return e.hidden ? null : e.children;
+}
+export {
+  n as V
+};

package/dist/components/arcgis-area-measurement-2d/AreaMeasurement2dViewModel.d.ts

@@ -0,0 +1,40 @@
+import { default as AreaMeasurementAnalysis } from '@arcgis/core/analysis/AreaMeasurementAnalysis.js';
+import { default as MapView } from '@arcgis/core/views/MapView.js';
+import { AnalysisViewModel } from '../../support/AnalysisViewModel';
+import { Area, Length, MeasurementState, MeasurementValue, SystemOrAreaUnit } from '../../support/measurementUtils';
+import { MeasurementMode } from '@arcgis/core/views/analysis/types';
+export interface Measurement {
+    readonly mode: MeasurementMode;
+    readonly area: MeasurementValue<Area>;
+    readonly perimeter: MeasurementValue<Length>;
+}
+export type State = Exclude<MeasurementState, "unsupported">;
+export default class AreaMeasurement2dViewModel extends AnalysisViewModel<MapView, AreaMeasurementAnalysis> {
+    initialize(): void;
+    get state(): MeasurementState;
+    /**
+     * The current measurement.
+     */
+    get measurement(): Measurement;
+    /**
+     * List of unit systems (imperial, metric) and specific units for displaying the distance values.
+     */
+    get unitOptions(): SystemOrAreaUnit[];
+    set unitOptions(units: SystemOrAreaUnit[] | undefined);
+    private _userUnitOptions?;
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the distance values.
+     */
+    get unit(): SystemOrAreaUnit;
+    set unit(unit: SystemOrAreaUnit | undefined);
+    private _userUnit?;
+    private get _defaultUnit();
+    place(options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    protected clearAnalysis(): void;
+    protected readonly supportedViewType = "2d";
+    protected readonly unsupportedErrorMessage = "The Area Measurement 2D component is only supported in 2D views.";
+    protected constructAnalysis(): AreaMeasurementAnalysis;
+    protected shouldForceInteractive: boolean;
+}

package/dist/components/arcgis-area-measurement-2d/customElement.d.ts

@@ -1,37 +1,20 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference path="../../index.d.ts" />
-import { default as AreaMeasurement2D } from '@arcgis/core/widgets/AreaMeasurement2D.js';
-import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { default as AreaMeasurement2dViewModel } from './AreaMeasurement2dViewModel';
 
-declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeasurement2D & {
-    viewModel: __esri.Accessor;
-}, "label" | "viewModel" | "icon" | "snappingOptions" | "unit" | "unitOptions"> & {
-    state?: unknown;
-    viewModel?: (__esri.AreaMeasurement2DViewModel & __esri.Accessor) | undefined;
-    closed?: boolean;
-    icon: import('@arcgis/toolkit/type').nil | string;
-    label: import('@arcgis/toolkit/type').nil | string;
-    referenceElement?: ArcgisReferenceElement | string;
-    position?: __esri.UIPosition;
-    arcgisReady: import('@arcgis/lumina').EventEmitter;
-    arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
-        name: string;
-    }> | undefined;
-    el: HTMLElement & {
-        childElem?: HTMLElement & {
-            ownedBy?: HTMLElement;
-        };
-        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView | nullish;
-    };
-    autoDestroyDisabled: boolean;
-    destroy: () => Promise<void>;
-}) => AreaMeasurement2D & {
-    viewModel: __esri.Accessor;
-};
+declare const useViewModel: (component: LitElement & Pick<AreaMeasurement2dViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<AreaMeasurement2dViewModel>) => AreaMeasurement2dViewModel;
 /**
- * The Area Measurement 2D component calculates and displays the area and perimeter of a polygon only in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html).
+ * The Area Measurement 2D component can be added to a [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)
+ * component to calculate and display the area and perimeter of a polygon.
+ *
+ * How areas and perimeters are computed depends on the map's spatial reference.
+ *
+ * In **geographic coordinate systems** (GCS), and in **Web Mercator**, areas and perimeters are computed geodetically, taking into consideration the curvature of the planet.
+ *
+ * In **projected coordinate systems** (PCS), apart from Web Mercator, areas and perimeters are computed in a Euclidean manner (in their respective PCS).
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-2d/)
  *
@@ -40,9 +23,50 @@ declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeas
 export declare class ArcgisAreaMeasurement2d 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 ArcgisAreaMeasurement2d component will be associated with a map or scene component rather than using the `view` property.
+     *   > **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 Area Measurement 2D component will be associated with a map or scene component rather than using the `view` property.
+     */
+    view?: __esri.MapView | undefined;
+    /**
+     * The [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)
+     * created or modified by the component.
+     *
+     * When connecting the Area Measurement 2D component to the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)
+     * component, it automatically creates an empty analysis and adds it to the Map's
+     * [analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#analyses) collection.
+     * Whenever the component is destroyed, the analysis is automatically removed from the collection.
+     *
+     * Alternatively, a programmatically created analysis can be provided to the component.
+     * Then, the application itself needs to add it to and later remove it from the Map's analyses collection.
+     *
+     * ```js
+     * // Create the analysis.
+     * const areaMeasurementAnalysis = new AreaMeasurementAnalysis({
+     *   geometry: new Polygon({
+     *     rings: [
+     *       [
+     *         [-80.208889, 25.775278], // Maimi, Florida
+     *         [-64.782, 32.293],       // Hamilton, Bermuda
+     *         [-66.063889, 18.406389], // San Juan, Puerto Rico
+     *         [-80.208889, 25.775278], // Maimi, Florida
+     *       ],
+     *     ],
+     *  }),
+     * });
+     *
+     * // Get the Map and measurement component and wait until they are ready.
+     * const viewElement = document.querySelector("arcgis-map");
+     * await viewElement.viewOnReady();
+     * const areaMeasurement2d = document.querySelector("arcgis-area-measurement-2d");
+     * await areaMeasurement2d.componentOnReady();
+     *
+     * // Add the analysis to the Map component.
+     * viewElement.analyses.add(areaMeasurementAnalysis);
+     *
+     * // Connect the analysis to the measurement component:
+     * areaMeasurement2d.analysis = areaMeasurementAnalysis;
+     * ```
      */
-    view?: __esri.MapView | nullish;
+    analysis: __esri.AreaMeasurementAnalysis;
     /**
      * 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
@@ -57,17 +81,13 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "measure-area"
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
-    icon: string;
-    /**
-     * The widget's default label.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#label)
-     */
-    label: string;
-    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    icon?: HTMLCalciteIconElement["icon"];
+    /** The component's default label. */
+    label?: string;
+    /** @deprecated since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead. */
     position?: __esri.UIPosition;
     /**
      * 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.
@@ -76,30 +96,26 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
      */
     referenceElement?: ArcgisReferenceElement | string;
     /**
-     * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html) for sketching.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#snappingOptions)
-     */
-    snappingOptions: __esri.SnappingOptions;
-    /**
-     * The current state of the component.
+     * The component's state. The values mean the following:
      *
-     * @default "disabled"
+     * * `disabled` -  not ready yet
+     * * `ready` - ready for measuring
+     * * `measuring` - currently measuring
+     * * `measured` - measuring has finished
      */
-    readonly state: "ready" | "disabled" | "measuring" | "measured";
+    readonly state: import('../../support/measurementUtils').MeasurementState;
     /**
-     * Unit system (imperial, metric) or specific unit used for displaying the area values.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#unit)
+     * Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in
+     * [unitOptions](#unitOptions).
      */
     unit: __esri.SystemOrAreaUnit;
     /**
-     * List of available units and unit systems (imperial, metric) for displaying the area values.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#unitOptions)
+     * List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.
+     * By default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.
+     * Possible [unit](#unit) values can only be a subset of this list.
      */
     unitOptions: __esri.SystemOrAreaUnit[];
-    /** Clear the current measurement. */
+    /** Clears the current measurement. */
     clear(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
@@ -107,7 +123,7 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
     start(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
-        name: "state";
+        name: "analysis" | "state";
     }>;
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;