@geoscene/map-components 4.33.20 → 5.0.19

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

@@ -1,16 +1,19 @@
-import { c as h } from "../../chunks/runtime.js";
-import { makeAccessorController as r, reEmitEvent as e, reCreateAccessor as n } from "@geoscene/lumina/controllers/accessor";
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.0/LICENSE.txt */
+import { c } from "../../chunks/runtime.js";
+import { html as a } from "lit";
 import { watch as s } from "@geoscene/core/core/reactiveUtils.js";
-import o from "@geoscene/core/views/MapView.js";
-import w from "@geoscene/core/WebMap.js";
-import { LitElement as p, createEvent as a, noShadowRoot as c } from "@geoscene/lumina";
-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 GeoScene, All Rights Reserved, unless otherwise specified.
-See https://js.geoscene.cn/4.33/geoscene/copyright.txt for details.
-v4.33.18 */
-const g = m`@layer{geoscene-map{display:block;height:100%;.geoscene-view{height:100%;width:100%}}}`, d = r(
-  w,
+import l from "@geoscene/core/views/MapView.js";
+import v from "@geoscene/core/WebMap.js";
+import { LitElement as m, createEvent as r, safeClassMap as n } from "@geoscene/lumina";
+import { makeAccessorController as p, reEmitEvent as e, reCreateAccessor as u } from "@geoscene/lumina/controllers/accessor";
+import { createRef as o, ref as h } from "lit/directives/ref.js";
+import { s as g } from "../../chunks/geoscene-main.js";
+import { s as d, C as w } from "../../chunks/slots.js";
+import { p as y, i as f } from "../../chunks/component-utils.js";
+import { U as b, u as V, a as C } from "../../chunks/useGeosceneViewReadyError.js";
+import E from "@geoscene/core/core/Collection.js";
+const A = p(
+  v,
   /**
    * Since omitProps is only needed for typing, not runtime, `{} as { ... }` is
    * a hack to remove them from the runtime code. This argument is not used at
@@ -20,27 +23,33 @@ const g = m`@layer{geoscene-map{display:block;height:100%;.geoscene-view{height:
    * in an externalized package.
    */
   {}
-), u = r(o, {});
-class y extends p {
+), _ = p(l, {});
+class R extends m {
   constructor() {
-    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.geosceneViewChange = a(), this.geosceneViewClick = e(() => this.view, "click"), this.geosceneViewDoubleClick = e(() => this.view, "double-click"), this.geosceneViewDrag = e(() => this.view, "drag"), this.geosceneViewHold = e(() => this.view, "hold"), this.geosceneViewImmediateClick = e(() => this.view, "immediate-click"), this.geosceneViewImmediateDoubleClick = e(() => this.view, "immediate-double-click"), this.geosceneViewKeyDown = e(() => this.view, "key-down"), this.geosceneViewKeyUp = e(() => this.view, "key-up"), this.geosceneViewLayerviewCreate = e(() => this.view, "layerview-create"), this.geosceneViewLayerviewCreateError = e(() => this.view, "layerview-create-error"), this.geosceneViewLayerviewDestroy = e(() => this.view, "layerview-destroy"), this.geosceneViewMouseWheel = e(() => this.view, "mouse-wheel"), this.geosceneViewPointerDown = e(() => this.view, "pointer-down"), this.geosceneViewPointerEnter = e(() => this.view, "pointer-enter"), this.geosceneViewPointerLeave = e(() => this.view, "pointer-leave"), this.geosceneViewPointerMove = e(() => this.view, "pointer-move"), this.geosceneViewPointerUp = e(() => this.view, "pointer-up"), this.geosceneViewReadyChange = a(), this.view.ui = {
-      components: ["attribution"]
+    super(), this._containerRef = o(), this._mapRef = o(), this._uiController = new b(this), this.extraContent = new E(), this.geosceneLoadError = V(this), this.geosceneViewReadyError = C(this), this._map = A(this), this.view = _(this), this.animationsDisabled = this.view.animationsEnabled, this.allLayerViews = this.view.allLayerViews, this.analyses = this.view.analyses, this.attributionMode = this.view.attributionMode, this.autoDestroyDisabled = !1, this.background = this.view.background, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.canZoomIn = this.view.canZoomIn, this.canZoomOut = this.view.canZoomOut, 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.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.popupComponentEnabled = !1, this.ready = this.view.ready, this.resizeAlign = this.view.resizeAlign, this.resolution = this.view.resolution, this.rotation = this.view.rotation, this.selectionManager = this.view.selectionManager, this.spatialReference = this.view.spatialReference, this.spatialReferenceLocked = this.view.spatialReferenceLocked, 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.geosceneViewAnalysisViewCreate = e(() => this.view, "analysis-view-create"), this.geosceneViewAnalysisViewCreateError = e(() => this.view, "analysis-view-create-error"), this.geosceneViewAnalysisViewDestroy = e(() => this.view, "analysis-view-destroy"), this.geosceneViewChange = r(), this.geosceneViewClick = e(() => this.view, "click"), this.geosceneViewDoubleClick = e(() => this.view, "double-click"), this.geosceneViewDoubleTapDrag = e(() => this.view, "double-tap-drag"), this.geosceneViewDrag = e(() => this.view, "drag"), this.geosceneViewHold = e(() => this.view, "hold"), this.geosceneViewImmediateClick = e(() => this.view, "immediate-click"), this.geosceneViewImmediateDoubleClick = e(() => this.view, "immediate-double-click"), this.geosceneViewKeyDown = e(() => this.view, "key-down"), this.geosceneViewKeyUp = e(() => this.view, "key-up"), this.geosceneViewLayerviewCreate = e(() => this.view, "layerview-create"), this.geosceneViewLayerviewCreateError = e(() => this.view, "layerview-create-error"), this.geosceneViewLayerviewDestroy = e(() => this.view, "layerview-destroy"), this.geosceneViewMouseWheel = e(() => this.view, "mouse-wheel"), this.geosceneViewPointerDown = e(() => this.view, "pointer-down"), this.geosceneViewPointerEnter = e(() => this.view, "pointer-enter"), this.geosceneViewPointerLeave = e(() => this.view, "pointer-leave"), this.geosceneViewPointerMove = e(() => this.view, "pointer-move"), this.geosceneViewPointerUp = e(() => this.view, "pointer-up"), this.geosceneViewReadyChange = r(), this.geosceneViewVerticalTwoFingerDrag = e(() => this.view, "vertical-two-finger-drag"), this.view.ui = {
+      components: []
     };
   }
   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, 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 };
+    this.properties = { _map: 16, view: 32, animationsDisabled: 5, aria: 0, allLayerViews: 32, analyses: 0, attributionItems: 32, attributionMode: 1, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, canZoomIn: 36, canZoomOut: 36, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, hideAttribution: 5, highlights: 0, interacting: 32, ipsInfo: 0, itemId: 3, layerViews: 32, magnifier: 32, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupElement: 32, popupDisabled: 5, popupComponentEnabled: 5, ready: 36, resizeAlign: 1, resolution: 40, rotation: 9, scale: 9, selectionManager: 32, spatialReference: 0, spatialReferenceLocked: 5, stationary: 32, suspended: 39, theme: 0, timeExtent: 0, timeZone: 1, updating: 36, viewpoint: 0, visibleArea: 32, zoom: 9, loadErrorSources: 0 };
   }
   static {
-    this.shadowRootOptions = c;
+    this.styles = [g, d];
   }
-  static {
-    this.styles = g;
+  get aria() {
+    return this.view?.aria;
+  }
+  set aria(i) {
+    this.view && (this.view.aria = i);
+  }
+  get attributionItems() {
+    return this.view?.attributionItems ?? [];
   }
   get center() {
     return this.view.center;
   }
   set center(i) {
-    const t = v(i, this.view);
+    const t = y(i, this.view);
     t && (this.view.center = t);
   }
   get extent() {
@@ -61,6 +70,12 @@ class y extends p {
   get gamepad() {
     return this.view.input.gamepad;
   }
+  get hideAttribution() {
+    return !this.view.attributionVisible;
+  }
+  set hideAttribution(i) {
+    this.view.attributionVisible = !i;
+  }
   get interacting() {
     return this.view.interacting;
   }
@@ -68,11 +83,14 @@ class y extends p {
     return this._map.portalItem?.id;
   }
   set itemId(i) {
-    n(this._map, this), this._map.portalItem = { id: i }, this.view.map = this._map;
+    u(this._map, this), this._map.portalItem = { id: i }, this.view.map = this._map;
   }
   get navigating() {
     return this.view.navigating;
   }
+  get popupElement() {
+    return this._uiController.popupElement || null;
+  }
   get scale() {
     return this.view.scale;
   }
@@ -86,7 +104,7 @@ class y extends p {
     return this.view.viewpoint;
   }
   set viewpoint(i) {
-    l(this.viewpoint, i) && (this.view.viewpoint = i);
+    f(this.viewpoint, i) && (this.view.viewpoint = i);
   }
   get zoom() {
     return this.view.zoom;
@@ -94,20 +112,8 @@ class y extends p {
   set zoom(i) {
     this.view.zoom = i;
   }
-  async addLayer(i, t) {
-    this.map?.add(i, t);
-  }
-  async addLayers(i, t) {
-    this.map?.addMany(i, t);
-  }
-  async addTable(i) {
-    this.map?.tables.add(i);
-  }
-  async addTables(i, t) {
-    this.map?.tables.addMany(i, t);
-  }
   async closePopup() {
-    this.view.closePopup();
+    this._uiController.closePopup();
   }
   async destroy() {
     await this.manager.destroy();
@@ -119,7 +125,7 @@ class y extends p {
     return await this.view.hitTest(i, t);
   }
   async openPopup(i) {
-    await this.view.openPopup(i);
+    this._uiController.openPopup(i);
   }
   async takeScreenshot(i) {
     return await this.view.takeScreenshot(i);
@@ -133,27 +139,42 @@ class y extends p {
   async tryFatalErrorRecovery() {
     this.view.tryFatalErrorRecovery();
   }
-  async whenLayerView(i) {
-    return await this.view.whenLayerView(i);
-  }
   async viewOnReady(i, t) {
     return await this.componentOnReady(), await this.view.whenReady().then(() => i?.()).catch(t);
   }
-  load() {
-    const i = this;
-    i.el.childElem = document.createElement("div"), i.el.append(i.el.childElem), this.view.container = i.el.childElem;
+  async whenAnalysisView(i) {
+    return await this.view.whenAnalysisView(i);
+  }
+  async whenLayerView(i) {
+    return await this.view?.whenLayerView(i);
+  }
+  async zoomIn() {
+    this.view.zoomIn();
+  }
+  async zoomOut() {
+    this.view.zoomOut();
   }
   loaded() {
-    this.map ||= this._map, this.manager.onLifecycle(() => [
-      s(() => this.map, (i) => {
-        i && (this._map = i);
+    const i = this;
+    i.el.childElem = this._mapRef.value, this.view.container ??= i.el.childElem, this.map ||= this._map, this.manager.onLifecycle(() => [
+      s(() => this.map, (t) => {
+        t && (this._map = t);
       }, { initial: !0, sync: !0 }),
       s(() => this.view.stationary, () => this.geosceneViewChange.emit(), { initial: !0 }),
-      s(() => this.view.ready, () => this.geosceneViewReadyChange.emit(), { initial: this.view.ready })
+      s(() => this.view.ready, () => this.geosceneViewReadyChange.emit(), { initial: this.view.ready }),
+      s(() => this.view.attributionHeight, (t) => {
+        this._uiController.handleAttributionHeightChange(t);
+      }, { initial: !0 })
     ]);
   }
+  renderMain() {
+    return a`<div class=${n(w.base)} ${h(this._mapRef)}></div>`;
+  }
+  render() {
+    return a`${this.renderMain()}<section class=${n(w.containerUI)} ${h(this._containerRef)}>${this._uiController.render()}${this.extraContent}</section>`;
+  }
 }
-h("geoscene-map", y);
+c("geoscene-map", R);
 export {
-  y as GeosceneMap
+  R as GeosceneMap
 };

package/dist/components/geoscene-map/index.js

@@ -1 +1,3 @@
+import "../geoscene-popup/index.js";
+import "../geoscene-webgl-error/index.js";
 export * from "./customElement.js";

package/dist/components/geoscene-measurement/customElement.d.ts

@@ -1,110 +1,203 @@
-/// <reference types="@geoscene/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
-import { Use } from '@geoscene/lumina/controllers';
-import { default as Measurement } from '@geoscene/core/widgets/Measurement.js';
-import { PublicLitElement as LitElement, TargetedEvent } from '@geoscene/lumina';
-import { GeosceneReferenceElement } from '../../utils/component-utils';
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@geoscene/lumina";
+import type { GeosceneReferenceElement, IconName } from "../types.js";
+import type { MapViewOrSceneView } from "@geoscene/core/views/MapViewOrSceneView.js";
+import type { MeasurementComponentType } from "@geoscene/core/widgets/Measurement/types.js";
+import type { MeasurementWidget } from "@geoscene/core/widgets/Measurement.js";
+import type { SystemOrAreaUnit, SystemOrLengthUnit } from "@geoscene/core/core/units.js";
+import type { Icon } from "@geoscene/calcite-components/components/calcite-icon";
+import type { MeasurementState } from "@geoscene/core/widgets/types.js";
 
-declare const useMeasurementWidget: (component: LitElement & Pick<Measurement, "icon" | "label" | "viewModel" | "activeTool" | "areaUnit" | "linearUnit"> & {
-    state?: unknown;
-    viewModel?: __geoscene.MeasurementViewModel | undefined;
-    closed?: boolean;
-    icon: import('@arcgis/components-utils').Nil | string;
-    label: import('@arcgis/components-utils').Nil | string;
-    referenceElement?: GeosceneReferenceElement | string;
-    position: __geoscene.UIPosition;
-    geosceneReady: import('@geoscene/lumina').EventEmitter;
-    geoscenePropertyChange: import('@geoscene/lumina').EventEmitter<{
-        name: string;
-    }> | undefined;
-    el: HTMLElement & {
-        childElem?: HTMLElement & {
-            ownedBy?: HTMLElement;
-        };
-        view?: __geoscene.LinkChartView | __geoscene.MapView | __geoscene.SceneView;
-    };
-    autoDestroyDisabled: boolean;
-    destroy: () => Promise<void>;
-}) => Measurement;
 /**
- * [Read more...](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-measurement/)
+ * The Measurement component groups and manages multiple measurement tools and allows you to easily switch between them using
+ * the [activeTool](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-measurement/#activeTool) property. The tools correspond to the measurement components for area and distance in 2D
+ * [geoscene-area-measurement-2d](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-area-measurement-2d/), [geoscene-distance-measurement-2d](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-distance-measurement-2d/) and in 3D
+ * [geoscene-area-measurement-3d](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-area-measurement-3d/), [geoscene-direct-line-measurement-3d](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-direct-line-measurement-3d/).
+ *
+ * This component follows a composite pattern that allows developers to configure the UI to best match their specific requirements.
+ * The measurement tools, placements, and icons can all be configured, which offers great flexibility to use with tabbed
+ * interfaces or other customized UI.
+ *
+ * How distances, areas, and perimeters are computed depends on the view type and its spatial reference.
+ *
+ * In 2D Maps:
+ * - In geographic coordinate systems (GCS) and in Web Mercator, they are computed geodetically.
+ * - In projected coordinate systems (PCS), apart from Web Mercator, they are computed
+ *   in a Euclidean manner (in their respective PCS).
+ *
+ * In 3D Scenes:
+ * - In geographic coordinate systems (GCS) and in Web Mercator:
+ *   - horizontal distance is computed geodetically;
+ *   - vertical distance is computed as a difference in z-values;
+ *   - direct distance is computed in a Euclidean manner;
+ *   - area and perimeter are computed:
+ *     - in a Euclidean manner if the perimeter is below 100km;
+ *     - geodetically if the perimeter is above 100km.
+ * - In projected coordinate systems (PCS), apart from Web Mercator:
+ *   - all three distances (direct, horizontal, and vertical), areas, and perimeters are computed in a Euclidean manner (in their respective PCS).
  *
  * @internal
+ * @since 5.0
+ * @example
+ * ```html
+ * <geoscene-map basemap="tianditu-image" center="-71.69,43.76" zoom="15">
+ *   <geoscene-measurement slot="top-right" active-tool="distance"></geoscene-measurement>
+ * </geoscene-map>
+ * <script type="module">
+ *   // Add the measurement component to the upper right hand corner
+ *   // with the distance tool active
+ *   const mapElement = document.querySelector("geoscene-map");
+ *   const measurementElement = document.querySelector("geoscene-measurement");
+ *
+ *   // Switch between area and distance measurement
+ *   function switchTool() {
+ *     const tool = measurementElement.activeTool === "distance" ? "area" : "distance";
+ *     measurementElement.activeTool = tool;
+ *   }
+ * </script>
+ * ```
  */
-export declare class GeosceneMeasurement extends LitElement {
-    /**
-     * Specifies the current measurement tool to display.
-     *
-     * @default null
-     */
-    activeTool: nullish | "area" | "distance" | "direct-line";
-    /**
-     * The measurement widget that is currently being used.
-     *
-     * [Read more...](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-widgets-Measurement.html#activeWidget)
-     *
-     * @default null
-     */
-    readonly activeWidget: nullish | __geoscene.DistanceMeasurement2D | __geoscene.AreaMeasurement2D | __geoscene.AreaMeasurement3D | __geoscene.DirectLineMeasurement3D;
-    /**
-     * Unit system (imperial, metric) or specific unit used for displaying the area values.
-     *
-     * [Read more...](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-widgets-Measurement.html#areaUnit)
-     */
-    areaUnit: __geoscene.SystemOrAreaUnit;
-    /**
-     * If true, the component will not be destroyed automatically when it is
-     * disconnected from the document. This is useful when you want to move the
-     * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the [destroy](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-measurement/#destroy) method when you are done to
-     * prevent memory leaks.
-     *
-     * @default false
-     */
-    autoDestroyDisabled: boolean;
-    /**
-     * 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://doc.geoscene.cn/calcite-design-system/icons/)
-     * @default "measure"
-     */
-    icon: string;
-    /**
-     * The widget's default label.
-     *
-     * [Read more...](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-widgets-Measurement.html#label)
-     */
-    label: string;
-    /**
-     * Unit system (imperial, metric) or specific unit used for displaying the distance values.
-     *
-     * [Read more...](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-widgets-Measurement.html#linearUnit)
-     */
-    linearUnit: __geoscene.SystemOrLengthUnit;
-    /** @default "bottom-left" */
-    position: __geoscene.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.
-     *
-     * @see [Associate components with a Map or Scene component](https://doc.geoscene.cn/javascript/4.33/programming-patterns/#associate-components-with-a-map-or-scene-component)
-     */
-    referenceElement?: GeosceneReferenceElement | string;
-    /**
-     * The current state of the component.
-     *
-     * @default "disabled"
-     */
-    readonly state: "ready" | "disabled" | "measuring" | "measured";
-    clear(): Promise<void>;
-    /** Permanently destroy the component. */
-    destroy(): Promise<void>;
-    startMeasurement(): Promise<void>;
-    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
-    readonly geoscenePropertyChange: TargetedEvent<this, {
-        name: "state" | "activeTool";
-    }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
-    readonly geosceneReady: TargetedEvent<this, void>;
-}
-export {};
+export abstract class GeosceneMeasurement extends LitElement {
+  /**
+   * Specifies the current measurement tool to display. Setting its value to `area` activates
+   * the area measurement tool and it works in both [geoscene-map](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-map/) and [geoscene-scene](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-scene/). To measure distance in an [geoscene-map](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-map/),
+   * set the property to `distance` and in an [geoscene-scene](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-scene/) set it to `direct-line`.
+   * If this property is not set, the component will not be displayed.
+   *
+   * @example
+   * ```js
+   * // To use the Measurement component with SceneView's direct-line tool active.
+   * const measurementElement = document.querySelector("geoscene-measurement");
+   * measurementElement.activeTool = "direct-line";
+   *
+   * // To switch between direct line and area measurement tools
+   * function switchTool() {
+   *   const tool = measurementElement.activeTool === "direct-line" ? "area" : "direct-line";
+   *   measurementElement.activeTool = tool;
+   * }
+   * ```
+   */
+  accessor activeTool: MeasurementComponentType | null | undefined;
+  /**
+   * The measurement component that is currently being used. Use this property to
+   * get access to the active component.
+   *
+   * @example
+   * ```js
+   * // Print the active widget to the console.
+   * const measurementElement = document.querySelector("geoscene-measurement");
+   * measurementElement.activeTool = "distance";
+   * console.log("Active Widget: ", measurementElement.activeWidget);
+   * ```
+   */
+  get activeWidget(): MeasurementWidget | null | undefined;
+  /**
+   * Unit system (imperial, metric) or specific unit used for displaying the area values.
+   *
+   * @example
+   * ```js
+   * // To use the Measurement component to display area in square US feet
+   * const measurementElement = document.querySelector("geoscene-measurement");
+   * measurementElement.activeTool = "area";
+   * measurementElement.areaUnit = "square-us-feet";
+   *
+   * // To display the current area measurement unit
+   * console.log("Current unit: ", measurement.areaUnit);
+   * ```
+   */
+  accessor areaUnit: SystemOrAreaUnit;
+  /**
+   * If true, the component will not be destroyed automatically when it is
+   * disconnected from the document. This is useful when you want to move the
+   * component to a different place on the page, or temporarily hide it. If this
+   * is set, make sure to call the [destroy()](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-measurement/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * Icon which represents the component.
+   * Typically used when the component is controlled by another component (e.g. by the Expand component).
+   *
+   * @default "measure"
+   * @see [Calcite Icons](https://doc.geoscene.cn/calcite-design-system/icons/)
+   */
+  get icon(): Icon["icon"];
+  set icon(value: IconName);
+  /** The component's default label. */
+  accessor label: string;
+  /**
+   * Unit system (imperial, metric) or specific unit used for displaying the distance values.
+   *
+   * @example
+   * ```js
+   * // To use the Measurement component to display distance in yards
+   * const measurementElement = document.querySelector("geoscene-measurement");
+   * measurementElement.activeTool = "distance";
+   * measurementElement.linearUnit = "yards";
+   *
+   * // To display the current linear measurement unit
+   * console.log("Current linear unit: ", measurementElement.linearUnit);
+   * ```
+   */
+  accessor linearUnit: SystemOrLengthUnit;
+  /**
+   * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+   *
+   * @see [Associate components with a Map or Scene component](https://doc.geoscene.cn/javascript/5.0/programming-patterns/#associate-components-with-a-map-or-scene-component)
+   */
+  accessor referenceElement: GeosceneReferenceElement | string | undefined;
+  /**
+   * The current state of the component.
+   *
+   * @default "disabled"
+   * @example
+   * ```js
+   * // To display the state of the AreaMeasurement2D component
+   * const measurementElement = document.querySelector("geoscene-measurement");
+   * measurementElement.activeTool = "area";
+   *
+   * measurementElement.addEventListener("geoscenePropertyChange", () => {
+   *   console.log("Current state: ", measurementElement.viewModel.state);
+   * });
+   * ```
+   */
+  get state(): MeasurementState;
+  /**
+   * 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 geoscene-measurement component will be associated with a map or scene component rather than using the `view` property.
+   */
+  accessor view: MapViewOrSceneView | null | undefined;
+  /** Removes all measurement widgets and associated graphics. */
+  clear(): Promise<void>;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  /**
+   * Starts a new measurement for the active measurement widget.
+   *
+   * @example
+   * ```js
+   * const measurementElement = document.querySelector("geoscene-measurement");
+   * measurementElement.activeTool = "distance";
+   *
+   * function measure() {
+   *   measurementElement.startMeasurement();
+   * }
+   *
+   * measure();
+   * ```
+   */
+  startMeasurement(): Promise<void>;
+  "@setterTypes": {
+    icon?: IconName;
+  };
+  /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
+  readonly geoscenePropertyChange: import("@geoscene/lumina").TargetedEvent<this, { name: "activeTool" | "state"; }>;
+  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  readonly geosceneReady: import("@geoscene/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    geoscenePropertyChange: GeosceneMeasurement["geoscenePropertyChange"]["detail"];
+    geosceneReady: GeosceneMeasurement["geosceneReady"]["detail"];
+  };
+}

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

@@ -1,25 +1,20 @@
-import { c as t } from "../../chunks/runtime.js";
-import { usePropertyChange as e } from "@geoscene/lumina/controllers";
-import i from "@geoscene/core/widgets/Measurement.js";
-import { LitElement as s, createEvent as a, noShadowRoot as o } from "@geoscene/lumina";
-import { m as r } from "../../chunks/useWidget.js";
-import { css as n } from "@lit/reactive-element/css-tag.js";
-/*! All material copyright GeoScene, All Rights Reserved, unless otherwise specified.
-See https://js.geoscene.cn/4.33/geoscene/copyright.txt for details.
-v4.33.18 */
-const c = n`@layer{geoscene-measurement{display:block}}`, l = r(i);
-class h extends s {
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.0/LICENSE.txt */
+import { c as e } from "../../chunks/runtime.js";
+import { usePropertyChange as i } from "@geoscene/lumina/controllers";
+import t from "@geoscene/core/widgets/Measurement.js";
+import { LitElement as r, createEvent as o } from "@geoscene/lumina";
+import { m as a } from "../../chunks/useWidget.js";
+import { css as n } from "lit";
+const s = n`.geoscene-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.geoscene-widget__heading{font-size:var(--calcite-font-size-xl)}h2.geoscene-widget__heading{font-size:var(--calcite-font-size-md)}h3.geoscene-widget__heading,h4.geoscene-widget__heading,h5.geoscene-widget__heading,h6.geoscene-widget__heading{font-size:var(--calcite-font-size)}.geoscene-widget{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)}.geoscene-widget *,.geoscene-widget :before,.geoscene-widget :after{box-sizing:inherit}.geoscene-widget.geoscene-widget--disabled>*{opacity:.4;pointer-events:none}.geoscene-widget.geoscene-widget--compact{--geoscene-widget-padding-y: 0;--geoscene-widget-padding-x: 0}.geoscene-widget__anchor{color:var(--calcite-color-text-2)}.geoscene-widget__anchor:hover{color:var(--calcite-color-text-3)}.geoscene-widget__anchor:hover,.geoscene-widget__anchor:focus{text-decoration:underline}.geoscene-widget__anchor--disabled{opacity:.4;pointer-events:none}.geoscene-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}.geoscene-widget__heading{word-break:break-word}.geoscene-widget__header .geoscene-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.geoscene-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}.geoscene-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.geoscene-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.geoscene-widget__footer-pagination-previous-button,.geoscene-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}.geoscene-widget__footer-pagination-previous-button:hover,.geoscene-widget__footer-pagination-previous-button:focus,.geoscene-widget__footer-pagination-next-button:hover,.geoscene-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.geoscene-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}.geoscene-menu .geoscene-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.geoscene-menu__list{margin:0;padding:0;list-style:none}.geoscene-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.geoscene-menu__list-item [class^=geoscene-icon-],.geoscene-menu__list-item [class*=" geoscene-icon-"]{padding-right:2.8px}.geoscene-menu__list-item:first-child{border-top:none}.geoscene-menu__list-item--focus,.geoscene-menu__list-item:hover,.geoscene-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.geoscene-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.geoscene-menu__list-item--active,.geoscene-menu__list-item--active:hover,.geoscene-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.geoscene-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.geoscene-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.geoscene-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.geoscene-widget__table tr a{color:var(--calcite-color-text-2)}.geoscene-widget__table tr a:hover,.geoscene-widget__table tr a:focus{color:var(--calcite-color-text-1)}.geoscene-widget__table tr td,.geoscene-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)}.geoscene-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.geoscene-widget__table tr td{width:50%}.geoscene-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.geoscene-input::-ms-clear{display:none}.geoscene-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.geoscene-input:placeholder-shown{text-overflow:ellipsis}.geoscene-input[type=text],.geoscene-input[type=password],.geoscene-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.geoscene-input{border:none}.geoscene-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.geoscene-widget__content--empty h1.geoscene-widget__heading,.geoscene-widget__content--empty h2.geoscene-widget__heading,.geoscene-widget__content--empty h3.geoscene-widget__heading,.geoscene-widget__content--empty h4.geoscene-widget__heading,.geoscene-widget__content--empty h5.geoscene-widget__heading{font-weight:var(--calcite-font-weight-regular)}.geoscene-widget__content-illustration--empty{width:128px;padding:1rem 0}.geoscene-widget__content-icon--empty{width:32px;padding:.5rem 0}.geoscene-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}.geoscene-select[disabled]{cursor:auto}.geoscene-select::-ms-expand{display:none}.geoscene-disabled a,.geoscene-disabled [role=menu],.geoscene-disabled [role=checkbox],.geoscene-disabled [class^=geoscene-icon-],.geoscene-disabled [class*=" geoscene-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .geoscene-widget:focus,.keynav-mode .geoscene-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.geoscene-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 geoscene-rotate;display:block;transform:translateZ(0)}:dir(rtl) .geoscene-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .geoscene-select{background-position:0}:dir(rtl) .geoscene-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .geoscene-menu__list-item [class^=geoscene-icon-],:dir(rtl) .geoscene-menu__list-item [class*=" geoscene-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .geoscene-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.geoscene-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.geoscene-rotating{animation:1.25s linear infinite geoscene-rotate;transform:translateZ(0)}.geoscene-clearfix:before,.geoscene-clearfix:after{content:" ";display:table}.geoscene-clearfix:after{clear:both}.geoscene-interactive{cursor:pointer}.geoscene-hidden{display:none!important}.geoscene-invisible{visibility:hidden!important}.geoscene-offscreen{position:absolute;top:-999em;left:-999em}.geoscene-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}.geoscene-unit-select{width:100%}.geoscene-unit-select__label{--calcite-label-margin-bottom: 0;width:100%}:host{display:block}.geoscene-measurement-widget-content{padding:var(--geoscene-internal-padding);flex-direction:column;gap:var(--calcite-spacing-xxl);display:flex;position:relative;overflow-y:auto}.geoscene-measurement-widget-content__error{color:var(--calcite-color-status-danger)}.geoscene-measurement-widget-content__error,.geoscene-measurement-widget-content__hint{overflow:hidden}.geoscene-measurement-widget-content__error p,.geoscene-measurement-widget-content__hint p{margin:0;padding:0}.geoscene-measurement-widget-content__hint,.geoscene-measurement-widget-content__error,.geoscene-measurement-widget-content__measurement,.geoscene-measurement-widget-content__measurement-item{flex-direction:column;gap:var(--calcite-spacing-md);animation:.25s ease-in-out geoscene-fade-in;display:flex}.geoscene-measurement-widget-content__measurement-item--disabled{color:var(--calcite-color-border-ghost)}.geoscene-measurement-widget-content__measurement-item__value{font-weight:var(--calcite-font-weight-semibold)}.geoscene-measurement-widget-content__actions{flex-direction:column;justify-content:center;gap:var(--calcite-spacing-xs);display:flex}:host{min-width:300px}`, c = a(t);
+class l extends r {
   constructor() {
-    super(...arguments), this.widget = l(this), this.viewModel = this.widget.viewModel, this.activeTool = this.widget.activeTool, this.activeWidget = this.widget.activeWidget, this.areaUnit = this.widget.areaUnit, this.autoDestroyDisabled = !1, this.icon = this.widget.icon, this.label = this.widget.label, this.linearUnit = this.widget.linearUnit, this.position = "bottom-left", this.state = this.viewModel.state, this.geoscenePropertyChange = e()("activeTool", "state"), this.geosceneReady = a();
+    super(...arguments), this.widget = c(this), this.viewModel = this.widget.viewModel, this.view = this.widget.view, this.activeTool = this.widget.activeTool, this.activeWidget = this.widget.activeWidget, this.areaUnit = this.widget.areaUnit, this.autoDestroyDisabled = !1, this.icon = this.widget.icon, this.label = this.widget.label, this.linearUnit = this.widget.linearUnit, this.state = this.viewModel.state, this.geoscenePropertyChange = i()("activeTool", "state"), this.geosceneReady = o();
   }
   static {
-    this.properties = { activeTool: 1, activeWidget: 0, areaUnit: 1, autoDestroyDisabled: 5, icon: 1, label: 1, linearUnit: 1, position: 1, referenceElement: 1, state: 3 };
+    this.properties = { view: 0, activeTool: 1, activeWidget: 32, areaUnit: 1, autoDestroyDisabled: 5, icon: 1, label: 1, linearUnit: 1, referenceElement: 1, state: 32 };
   }
   static {
-    this.shadowRootOptions = o;
-  }
-  static {
-    this.styles = c;
+    this.styles = s;
   }
   async clear() {
     this.widget?.clear();
@@ -31,7 +26,7 @@ class h extends s {
     this.widget?.startMeasurement();
   }
 }
-t("geoscene-measurement", h);
+e("geoscene-measurement", l);
 export {
-  h as GeosceneMeasurement
+  l as GeosceneMeasurement
 };