@geoscene/map-components 4.33.20 → 4.34.9

package/dist/components/geoscene-daylight/daylight-time-slider.d.ts

@@ -0,0 +1,10 @@
+import { JsxNode } from '@geoscene/lumina';
+import { Ref } from 'lit/directives/ref.js';
+export declare function TimeSlider(props: {
+    disabled?: boolean;
+    value: number | null;
+    onTimeChanged: (time: number) => void;
+    scale?: HTMLCalciteSliderElement["scale"];
+    steps?: number;
+    ref: Ref<HTMLCalciteSliderElement>;
+}): JsxNode;

package/dist/components/geoscene-daylight/daylight-utils.d.ts

@@ -0,0 +1,32 @@
+import { default as VirtualLighting } from '@geoscene/core/views/3d/environment/VirtualLighting.js';
+import { default as SunLighting } from '@geoscene/core/views/3d/environment/SunLighting.js';
+export type DateOrSeason = "date" | "season";
+export interface SeasonConfig {
+    dayOfMonth: number;
+    month: number;
+}
+export type Hemisphere = "northern" | "southern";
+export declare const orderedSeasons: readonly ["spring", "summer", "fall", "winter"];
+export type Season = (typeof orderedSeasons)[number];
+/**
+ * Returns a date object which has the same year and time as the reference, but whose day of the month
+ * and month are set according to the specified season.
+ */
+export declare function getSeasonDate(reference: Date, season: Season, hemisphere: Hemisphere): Date;
+/**
+ * Gets the astronomical season for the specified date.
+ */
+export declare function getSeasonFromDate(date: Date, hemisphere: Hemisphere): Season;
+/**
+ * Converts a season in the specified hemisphere to a northern hemisphere season.
+ */
+export declare function getNorthernHemisphereSeason(season: Season, hemisphere: Hemisphere): Season;
+export declare function getHemisphere(latitude: number): Hemisphere;
+export declare const dayInMinutes = 1440;
+export declare const dayInMilliseconds = 86400000;
+export declare function getSunriseAndSunsetTimes(currentDate: Date, latitude: number, longitude: number, UTCDisplayOffset: number): {
+    sunrise: Date;
+    sunset: Date;
+};
+export type LightingUnion = SunLighting | VirtualLighting;
+export declare function isSunlighting(lighting: LightingUnion | nullish): lighting is SunLighting;

package/dist/components/geoscene-daylight/index.d.ts

@@ -1 +1,10 @@
+import "@geoscene/calcite-components/components/calcite-slider";
+import "@geoscene/calcite-components/components/calcite-label";
+import "@geoscene/calcite-components/components/calcite-scrim";
+import "@geoscene/calcite-components/components/calcite-input-time-zone";
+import "@geoscene/calcite-components/components/calcite-button";
+import "@geoscene/calcite-components/components/calcite-input-date-picker";
+import "@geoscene/calcite-components/components/calcite-select";
+import "@geoscene/calcite-components/components/calcite-option";
+import "@geoscene/calcite-components/components/calcite-checkbox";
 export * from "./customElement.js";

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

@@ -1 +1,10 @@
+import "@geoscene/calcite-components/components/calcite-slider";
+import "@geoscene/calcite-components/components/calcite-label";
+import "@geoscene/calcite-components/components/calcite-scrim";
+import "@geoscene/calcite-components/components/calcite-input-time-zone";
+import "@geoscene/calcite-components/components/calcite-button";
+import "@geoscene/calcite-components/components/calcite-input-date-picker";
+import "@geoscene/calcite-components/components/calcite-select";
+import "@geoscene/calcite-components/components/calcite-option";
+import "@geoscene/calcite-components/components/calcite-checkbox";
 export * from "./customElement.js";

package/dist/components/geoscene-direct-line-measurement-3d/DirectLineMeasurement3dViewModel.d.ts

@@ -1,13 +1,12 @@
-/// <reference types="@geoscene/core/interfaces.d.ts" />
 import { default as DirectLineMeasurementAnalysis } from '@geoscene/core/analysis/DirectLineMeasurementAnalysis.js';
 import { default as SceneView } from '@geoscene/core/views/SceneView';
 import { AnalysisViewModel } from '../../support/AnalysisViewModel';
-import { MeasurementModeString, MeasurementState, MeasurementValue } from '../../support/measurementUtils';
+import { Length, MeasurementModeString, MeasurementState, MeasurementValue, SystemOrLengthUnit } from '../../support/measurementUtils';
 export interface Measurement {
     readonly mode: MeasurementModeString;
-    readonly directDistance: MeasurementValue<__geoscene.Length>;
-    readonly horizontalDistance: MeasurementValue<__geoscene.Length>;
-    readonly verticalDistance: MeasurementValue<__geoscene.Length>;
+    readonly directDistance: MeasurementValue<Length>;
+    readonly horizontalDistance: MeasurementValue<Length>;
+    readonly verticalDistance: MeasurementValue<Length>;
 }
 export type State = "disabled" | "measured" | "measuring" | "ready";
 export default class DirectLineMeasurement3DViewModel extends AnalysisViewModel<SceneView, DirectLineMeasurementAnalysis> {
@@ -21,16 +20,16 @@ export default class DirectLineMeasurement3DViewModel extends AnalysisViewModel<
     /**
      * List of unit systems (imperial, metric) and specific units for displaying the distance values.
      */
-    get unitOptions(): __geoscene.SystemOrLengthUnit[];
-    set unitOptions(units: __geoscene.SystemOrLengthUnit[] | undefined);
+    get unitOptions(): SystemOrLengthUnit[];
+    set unitOptions(units: SystemOrLengthUnit[] | undefined);
     private _userUnitOptions?;
     /**
      * Unit system (imperial, metric) or specific unit used for displaying the distance values.
      */
-    get unit(): __geoscene.SystemOrLengthUnit;
-    set unit(unit: __geoscene.SystemOrLengthUnit | undefined);
+    get unit(): SystemOrLengthUnit;
+    set unit(unit: SystemOrLengthUnit | undefined);
     private _userUnit?;
-    get defaultUnit(): __geoscene.MeasurementSystem | undefined;
+    private get _defaultUnit();
     place(options?: {
         signal?: AbortSignal;
     }): Promise<void>;

package/dist/components/geoscene-direct-line-measurement-3d/customElement.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="@geoscene/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <reference path="../../index.d.ts" />
 import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@geoscene/lumina';
 import { Use } from '@geoscene/lumina/controllers';
 import { GeosceneReferenceElement } from '../../utils/component-utils';
@@ -55,8 +55,15 @@ declare const useViewModel: (component: LitElement & Pick<DirectLineMeasurement3
  * - [Sample - Color theming for interactive tools](https://doc.geoscene.cn/javascript/4.33/sample-code/view-theme/)
  *
  * [Read more...](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-direct-line-measurement-3d/)
+ *
+ * @since 4.33
  */
 export declare class GeosceneDirectLineMeasurement3d 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 Direct Line Measurement 3D component will be associated with a map or scene component rather than using the `view` property.
+     */
+    view?: __geoscene.SceneView | undefined;
     /**
      * The [DirectLineMeasurementAnalysis](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-analysis-DirectLineMeasurementAnalysis.html)
      * created or modified by the component.
@@ -117,8 +124,8 @@ export declare class GeosceneDirectLineMeasurement3d extends LitElement {
     icon?: HTMLCalciteIconElement["icon"];
     /** The component's default label. */
     label?: string;
-    /** @default "bottom-left" */
-    position: __geoscene.UIPosition;
+    /** @deprecated since 4.34, use [`slot`](https://doc.geoscene.cn/javascript/4.33/building-your-ui/#slots) instead. */
+    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.
      *
@@ -133,7 +140,7 @@ export declare class GeosceneDirectLineMeasurement3d extends LitElement {
      * * `measuring` - currently measuring
      * * `measured` - measuring has finished
      */
-    readonly state: "ready" | "disabled" | "measuring" | "measured";
+    readonly state: "ready" | "disabled" | "measured" | "measuring";
     /**
      * Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in
      * [unitOptions](#unitOptions).
@@ -155,7 +162,7 @@ export declare class GeosceneDirectLineMeasurement3d extends LitElement {
     readonly geoscenePropertyChange: TargetedEvent<this, {
         name: "state" | "analysis";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly geosceneReady: TargetedEvent<this, void>;
 }
 /**

package/dist/components/geoscene-direct-line-measurement-3d/customElement.js

@@ -1,35 +1,35 @@
 import { c as p } from "../../chunks/runtime.js";
-import { html as g } from "lit-html";
-import { LitElement as v, createEvent as f, noShadowRoot as w, nothing as D, safeClassMap as b } from "@geoscene/lumina";
-import { usePropertyChange as M } from "@geoscene/lumina/controllers";
-import { u as O } from "../../chunks/useT9n.js";
-import { m as U } from "../../chunks/useViewModel.js";
-import { g as d } from "../../chunks/globalCss.js";
-import { css as $ } from "@lit/reactive-element/css-tag.js";
-import L from "@geoscene/core/analysis/DirectLineMeasurementAnalysis.js";
-import { isAboveGeodesicDistanceThreshold as _ } from "@geoscene/core/applications/Components/analysisUtils.js";
-import { getDefaultUnitForView as V } from "@geoscene/core/applications/Components/getDefaultUnits.js";
-import { property as o, subclass as P } from "@geoscene/core/core/accessorSupport/decorators.js";
-import { watch as A } from "@geoscene/core/core/reactiveUtils.js";
-import { A as C } from "../../chunks/AnalysisViewModel.js";
-import { g as c, m } from "../../chunks/measurementUtils.js";
+import { css as _, html as w } from "lit";
+import { LitElement as f, createEvent as v, nothing as b, safeClassMap as x } from "@geoscene/lumina";
+import { usePropertyChange as y } from "@geoscene/lumina/controllers";
+import { u as D } from "../../chunks/useT9n.js";
+import { m as z } from "../../chunks/useViewModel.js";
+import { g } from "../../chunks/globalCss.js";
+import k from "@geoscene/core/analysis/DirectLineMeasurementAnalysis.js";
+import { isAboveGeodesicDistanceThreshold as M } from "@geoscene/core/applications/Components/analysisUtils.js";
+import { getDefaultUnitForView as O } from "@geoscene/core/applications/Components/getDefaultUnits.js";
+import { property as a, subclass as U } from "@geoscene/core/core/accessorSupport/decorators.js";
+import { watch as $ } from "@geoscene/core/core/reactiveUtils.js";
+import { A as L } from "../../chunks/AnalysisViewModel.js";
+import { g as c, m as u } from "../../chunks/measurementUtils.js";
+import { b as V } from "../../chunks/async-utils.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 z = $`@layer{geoscene-directline-measurement-3d,geoscene-direct-line-measurement-3d{display:block}.geoscene-direct-line-measurement-3d{position:relative;padding:var(--geoscene-widget-padding);overflow-y:auto}}`;
-var S = Object.defineProperty, E = Object.getOwnPropertyDescriptor, r = (e, t, s, a) => {
-  for (var n = a > 1 ? void 0 : a ? E(t, s) : t, l = e.length - 1, u; l >= 0; l--)
-    (u = e[l]) && (n = (a ? u(t, s, n) : u(n)) || n);
-  return a && n && S(t, s, n), n;
+See https://js.geoscene.cn/4.34/geoscene/copyright.txt for details.
+v4.34.9 */
+const C = _`.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{--geoscene-widget-padding-x: 15px;--geoscene-widget-padding-y: var(--calcite-spacing-md);--geoscene-widget-padding: var(--geoscene-widget-padding-y) var(--geoscene-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)}.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__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-widget--panel{min-width:300px;min-height:32px;padding:var(--geoscene-widget-padding);transition:max-height .25s ease-in-out;overflow-y:auto}.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-widget-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{.geoscene-widget--panel{min-width:0}}`;
+var A = Object.defineProperty, E = Object.getOwnPropertyDescriptor, s = (e, t, i, o) => {
+  for (var n = o > 1 ? void 0 : o ? E(t, i) : t, l = e.length - 1, d; l >= 0; l--)
+    (d = e[l]) && (n = (o ? d(t, i, n) : d(n)) || n);
+  return o && n && A(t, i, n), n;
 };
-let i = class extends C {
+let r = class extends L {
   constructor() {
     super(...arguments), this.supportedViewType = "3d", this.unsupportedErrorMessage = "The Direct Line Measurement 3D component is only supported in 3D views.";
   }
   initialize() {
     this.addHandles(
       // Make sure the analysis and view model units are in sync.
-      A(
+      $(
         () => ({
           analysis: this.analysis,
           unit: this.unit
@@ -66,33 +66,33 @@ let i = class extends C {
         horizontalDistance: c(void 0),
         verticalDistance: c(void 0)
       };
-    const s = e?.directDistance, a = s != null && _(s);
+    const i = e?.directDistance, o = i != null && M(i);
     return {
       mode: t ?? "euclidean",
-      directDistance: c(a ? void 0 : s),
+      directDistance: c(o ? void 0 : i),
       horizontalDistance: c(e?.horizontalDistance),
       verticalDistance: c(e?.verticalDistance)
     };
   }
   get unitOptions() {
-    const e = this._userUnitOptions?.filter((t) => m.includes(t));
-    return e && e.length > 0 ? e : m.slice();
+    const e = this._userUnitOptions?.filter((t) => u.includes(t));
+    return e && e.length > 0 ? e : u.slice();
   }
   set unitOptions(e) {
     this._userUnitOptions = e;
   }
   get unit() {
-    const e = this._userUnit, t = this.unitOptions;
+    const e = this._userUnit ?? this.analysis.unit, t = this.unitOptions;
     if (e && t.includes(e))
       return e;
-    const s = this.defaultUnit;
-    return s && t.includes(s) ? s : t[0];
+    const i = this._defaultUnit;
+    return i && t.includes(i) ? i : t[0];
   }
   set unit(e) {
     this._userUnit = e;
   }
-  get defaultUnit() {
-    return this.view ? V(this.view) : void 0;
+  get _defaultUnit() {
+    return this.view ? O(this.view) : void 0;
   }
   async place(e) {
     await this.analysisView?.place(e);
@@ -101,49 +101,46 @@ let i = class extends C {
     this.analysis.startPoint = null, this.analysis.endPoint = null;
   }
   constructAnalysis() {
-    return new L();
+    return new k();
   }
 };
-r([
-  o({ readOnly: !0 })
-], i.prototype, "state", 1);
-r([
-  o({ readOnly: !0 })
-], i.prototype, "displayState", 1);
-r([
-  o({ readOnly: !0 })
-], i.prototype, "measurement", 1);
-r([
-  o()
-], i.prototype, "unitOptions", 1);
-r([
-  o()
-], i.prototype, "_userUnitOptions", 2);
-r([
-  o()
-], i.prototype, "unit", 1);
-r([
-  o()
-], i.prototype, "_userUnit", 2);
-r([
-  o({ readOnly: !0 })
-], i.prototype, "defaultUnit", 1);
-i = r([
-  P("components.direct-line-measurement-3d.DirectLineMeasurement3dViewModel")
-], i);
-const x = "geoscene-direct-line-measurement-3d", T = { base: x }, R = U(i);
-class h extends v {
+s([
+  a({ readOnly: !0 })
+], r.prototype, "state", 1);
+s([
+  a({ readOnly: !0 })
+], r.prototype, "displayState", 1);
+s([
+  a({ readOnly: !0 })
+], r.prototype, "measurement", 1);
+s([
+  a()
+], r.prototype, "unitOptions", 1);
+s([
+  a()
+], r.prototype, "_userUnitOptions", 2);
+s([
+  a()
+], r.prototype, "unit", 1);
+s([
+  a()
+], r.prototype, "_userUnit", 2);
+s([
+  a({ readOnly: !0 })
+], r.prototype, "_defaultUnit", 1);
+r = s([
+  U("components.direct-line-measurement-3d.DirectLineMeasurement3dViewModel")
+], r);
+const P = "geoscene-direct-line-measurement-3d", j = { base: P }, S = z(r);
+class m extends f {
   constructor() {
-    super(...arguments), this.viewModel = R(this), this.messages = O({ name: "directline-measurement-3d", blocking: !0 }), this.analysis = this.viewModel.analysis, this.autoDestroyDisabled = !1, this.icon = "measure-line", this.position = "bottom-left", this.state = this.viewModel.state, this.unit = this.viewModel.unit, this.unitOptions = this.viewModel.unitOptions, this.geoscenePropertyChange = M()("analysis", "state"), this.geosceneReady = f();
+    super(...arguments), this.viewModel = S(this), this.messages = D({ name: "directline-measurement-3d", blocking: !0 }), this.view = this.viewModel.view, this.analysis = this.viewModel.analysis, this.autoDestroyDisabled = !1, this.icon = "measure-line", this.state = this.viewModel.state, this.unit = this.viewModel.unit, this.unitOptions = this.viewModel.unitOptions, this.geoscenePropertyChange = y()("analysis", "state"), this.geosceneReady = v();
   }
   static {
-    this.properties = { analysis: 0, autoDestroyDisabled: 5, icon: 3, label: 1, position: 1, referenceElement: 1, state: 35, unit: 1, unitOptions: 0 };
+    this.properties = { view: 0, analysis: 0, autoDestroyDisabled: 5, icon: 3, label: 1, position: 1, referenceElement: 1, state: 35, unit: 1, unitOptions: 0 };
   }
   static {
-    this.shadowRootOptions = w;
-  }
-  static {
-    this.styles = z;
+    this.styles = C;
   }
   async clear() {
     this.viewModel.clear();
@@ -152,14 +149,14 @@ class h extends v {
     await this.manager.destroy();
   }
   async start() {
-    await this.viewModel.start();
+    V(this.viewModel.start());
   }
   render() {
-    const { messages: t, unit: s, unitOptions: a, viewModel: n } = this, { measurement: l, state: u } = n;
-    return g`<div aria-label=${t.componentLabel ?? D} class=${b({
-      [T.base]: !0,
-      [d.widget]: !0,
-      [d.panel]: !0
+    const { messages: t, unit: i, unitOptions: o, viewModel: n } = this, { measurement: l, state: d } = n;
+    return w`<div aria-label=${t.componentLabel ?? b} class=${x({
+      [j.base]: !0,
+      [g.widget]: !0,
+      [g.panel]: !0
     })} role=presentation><geoscene-measurement-content .state=${n.displayState} .hintLabel=${t.hint} .unsupportedLabel=${t.unsupported} .items=${[
       {
         title: t.direct,
@@ -173,21 +170,19 @@ class h extends v {
         title: t.vertical,
         measurement: l.verticalDistance
       }
-    ]}><geoscene-unit-select slot=settings .options=${a} .selectLabel=${t.unit} .value=${s} @geosceneUnitSelectChange=${(y) => {
-      this.unit = y.detail;
-    }}></geoscene-unit-select><calcite-button slot=actions .disabled=${u === "disabled"} @click=${() => {
-      this.viewModel.clear(), this.viewModel.start();
-    }}>${t.newMeasurement}</calcite-button></geoscene-measurement-content></div>`;
+    ]}><geoscene-unit-select slot=settings .options=${o} .selectLabel=${t.unit} .value=${i} @geosceneUnitSelectChange=${(h) => {
+      this.unit = h.detail;
+    }}></geoscene-unit-select><calcite-button slot=actions .disabled=${d === "disabled"} @click=${this.start}>${t.newMeasurement}</calcite-button></geoscene-measurement-content></div>`;
   }
 }
-class j extends h {
+class T extends m {
   constructor() {
     super(), console.warn('geoscene-directline-measurement-3d - this component is deprecated. Use the "geoscene-direct-line-measurement-3d" component instead.');
   }
 }
-p("geoscene-direct-line-measurement-3d", h);
-p("geoscene-directline-measurement-3d", j);
+p("geoscene-direct-line-measurement-3d", m);
+p("geoscene-directline-measurement-3d", T);
 export {
-  h as GeosceneDirectLineMeasurement3d,
-  j as DeprecatedGeosceneDirectLineMeasurement3d
+  m as GeosceneDirectLineMeasurement3d,
+  T as DeprecatedGeosceneDirectLineMeasurement3d
 };

package/dist/components/geoscene-directional-pad/customElement.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="@geoscene/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <reference path="../../index.d.ts" />
 import { Use } from '@geoscene/lumina/controllers';
 import { default as DirectionalPadViewModel } from '@geoscene/core/widgets/DirectionalPad/DirectionalPadViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@geoscene/lumina';
@@ -18,8 +18,15 @@ declare const useDirectionalPadViewModel: (component: LitElement & Pick<Directio
  * The Directional Pad component is not supported in 3D.
  *
  * [Read more...](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-directional-pad/)
+ *
+ * @since 4.29
  */
 export declare class GeosceneDirectionalPad 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 Directional Pad component will be associated with a map or scene component rather than using the `view` property.
+     */
+    view?: __geoscene.MapView | nullish;
     /**
      * 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
@@ -60,8 +67,8 @@ export declare class GeosceneDirectionalPad extends LitElement {
      * _**Note**: Individual message keys may change between releases._
      */
     messageOverrides?: typeof this.messages._overrides;
-    /** @default "bottom-left" */
-    position: __geoscene.UIPosition;
+    /** @deprecated since 4.34, use [`slot`](https://doc.geoscene.cn/javascript/4.33/building-your-ui/#slots) instead. */
+    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.
      *
@@ -98,7 +105,7 @@ export declare class GeosceneDirectionalPad extends LitElement {
     readonly geoscenePropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly geosceneReady: TargetedEvent<this, void>;
     private messages: Partial<{
         componentLabel: string;

package/dist/components/geoscene-directional-pad/customElement.js

@@ -1,21 +1,20 @@
 import { c as p } from "../../chunks/runtime.js";
-import { html as o } from "lit-html";
-import { ref as m } from "lit-html/directives/ref.js";
-import { keyed as d } from "lit-html/directives/keyed.js";
-import { usePropertyChange as b } from "@geoscene/lumina/controllers";
-import { focusElement as g } from "@arcgis/components-utils";
+import { css as m, html as o } from "lit";
+import { ref as b } from "lit/directives/ref.js";
+import { keyed as d } from "lit/directives/keyed.js";
+import { usePropertyChange as g } from "@geoscene/lumina/controllers";
+import { focusElement as v } from "@arcgis/toolkit/dom";
 import { watch as _ } from "@geoscene/core/core/reactiveUtils.js";
 import f from "@geoscene/core/widgets/DirectionalPad/DirectionalPadViewModel.js";
-import { LitElement as v, createEvent as $, noShadowRoot as w, safeClassMap as n, nothing as l, safeStyleMap as R } from "@geoscene/lumina";
-import { u as C } from "../../chunks/useT9n.js";
+import { LitElement as $, createEvent as w, safeClassMap as n, nothing as l, safeStyleMap as C } from "@geoscene/lumina";
+import { u as R } from "../../chunks/useT9n.js";
 import { m as x } from "../../chunks/useViewModel.js";
 import { g as y } from "../../chunks/component-utils.js";
 import { g as h } from "../../chunks/globalCss.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 u = [-45, 0, 45, -90, 90, -135, 180, 135], S = {
+See https://js.geoscene.cn/4.34/geoscene/copyright.txt for details.
+v4.34.9 */
+const u = [-45, 0, 45, -90, 90, -135, 180, 135], M = {
   0: { label: "north", iconName: "chevron-up" },
   45: { label: "northEast", iconName: "chevron-up-right" },
   90: { label: "east", iconName: "chevron-right" },
@@ -33,27 +32,24 @@ const u = [-45, 0, 45, -90, 90, -135, 180, 135], S = {
   rotationSliderContainer: `${a}__rotation-slider-container`,
   rotationReset: `${a}__rotation-reset-button`,
   error: `${a}__error`
-}, B = M`@layer{.geoscene-directional-pad{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);outline:none;box-shadow:none!important;background-color:transparent!important;user-select:none;calcite-action-pad{display:contents}calcite-action-group{touch-action:none}calcite-action{aspect-ratio:1}}.geoscene-directional-pad__buttons-container{--calcite-color-background: transparent;--calcite-action-group-gap: 0;--calcite-action-group-padding: 0;calcite-action{--calcite-color-focus: var(--calcite-color-foreground-3)}calcite-action:not([active]){--calcite-action-background-color-press: var(--calcite-color-foreground-1)}calcite-action[active]{--calcite-action-background-color: var(--calcite-color-foreground-3)}calcite-icon{transform:var(--rotation, unset)}@media (hover: none){calcite-action{--calcite-action-background-color-hover: var(--calcite-color-foreground-1);--calcite-action-text-color-press: var(--calcite-color-text-3)}}}.geoscene-directional-pad__rotation-container{display:block;width:100%;calcite-action{flex:.3}}.geoscene-directional-pad__rotation-slider-container{display:flex;flex:1;align-items:center;calcite-slider{flex:1;padding-inline:var(--calcite-spacing-xxs)}}}`;
-function E(c) {
+}, S = m`:host{outline:none;box-shadow:none!important;background-color:transparent!important;user-select:none;calcite-action-pad{display:contents}calcite-action-group{touch-action:none}calcite-action{aspect-ratio:1}}.geoscene-directional-pad{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm)}.geoscene-directional-pad__buttons-container{--calcite-color-background: transparent;--calcite-action-group-gap: 0;--calcite-action-group-padding: 0;calcite-action{--calcite-color-focus: var(--calcite-color-foreground-3)}calcite-action:not([active]){--calcite-action-background-color-press: var(--calcite-color-foreground-1)}calcite-action[active]{--calcite-action-background-color: var(--calcite-color-foreground-3)}calcite-icon{transform:var(--rotation, unset)}@media (hover: none){calcite-action{--calcite-action-background-color-hover: var(--calcite-color-foreground-1);--calcite-action-text-color-press: var(--calcite-color-text-3)}}}.geoscene-directional-pad__rotation-container{display:block;width:100%;calcite-action{flex:.3}}.geoscene-directional-pad__rotation-slider-container{display:flex;flex:1;align-items:center;calcite-slider{flex:1;padding-inline:var(--calcite-spacing-xxs)}}`;
+function B(c) {
   const { x: t, y: e, width: i, height: r } = c.getBoundingClientRect();
   return { x: t + i / 2, y: e + r / 2 };
 }
-function D(c) {
+function E(c) {
   return c?.spatialReference?.isWebMercator || c?.spatialReference?.isGeographic || !1;
 }
-const k = x(f);
-class P extends v {
+const D = x(f);
+class k extends $ {
   constructor() {
-    super(...arguments), this.messages = C({}), this._onContextMenu = (t) => t.preventDefault(), this._buttons = {}, this.viewModel = k(this), this.angle = this.viewModel.angle, this.rotation = this.viewModel.rotation, this.autoDestroyDisabled = !1, this.disabled = this.viewModel.disabled, this.hideDirectionalButtons = !1, this.icon = "move", this.position = "bottom-left", this.showRotationResetButton = !1, this.showRotationSlider = !1, this.state = this.viewModel.state, this.visualScale = "s", this.geoscenePropertyChange = b()("state"), this.geosceneReady = $();
-  }
-  static {
-    this.properties = { _rotationEnabled: 16, angle: 16, rotation: 16, autoDestroyDisabled: 5, disabled: 5, hideDirectionalButtons: 5, icon: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, showRotationResetButton: 5, showRotationSlider: 5, state: 3, visualScale: 1 };
+    super(...arguments), this.messages = R({}), this._onContextMenu = (t) => t.preventDefault(), this._buttons = {}, this.viewModel = D(this), this.angle = this.viewModel.angle, this.rotation = this.viewModel.rotation, this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.disabled = this.viewModel.disabled, this.hideDirectionalButtons = !1, this.icon = "move", this.showRotationResetButton = !1, this.showRotationSlider = !1, this.state = this.viewModel.state, this.visualScale = "s", this.geoscenePropertyChange = g()("state"), this.geosceneReady = w();
   }
   static {
-    this.shadowRootOptions = w;
+    this.properties = { _rotationEnabled: 16, angle: 16, rotation: 16, view: 0, autoDestroyDisabled: 5, disabled: 5, hideDirectionalButtons: 5, icon: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, showRotationResetButton: 5, showRotationSlider: 5, state: 3, visualScale: 1 };
   }
   static {
-    this.styles = B;
+    this.styles = S;
   }
   get _rotationEnabled() {
     return this.view?.ready ? this.view.constraints.rotationEnabled ?? !1 : !0;
@@ -65,7 +61,7 @@ class P extends v {
     this.manager.onLifecycle(() => [
       // Move focus when movement angle changed by touch/mouse (not keyboard!)
       _(() => this.viewModel.angle, () => {
-        this._buttonsContainer?.contains(document.activeElement) && (this.viewModel.angle == null ? y(this)?.focus() : g(this._buttons[this.viewModel.angle]));
+        this._buttonsContainer?.contains(document.activeElement) && (this.viewModel.angle == null ? y(this)?.focus() : v(this._buttons[this.viewModel.angle]));
       })
     ]);
   }
@@ -86,7 +82,7 @@ class P extends v {
     if (this._buttonsContainer === void 0)
       return;
     t.composedPath().find((r) => r.hasPointerCapture?.(t.pointerId))?.releasePointerCapture(t.pointerId);
-    const i = E(this._buttonsContainer);
+    const i = B(this._buttonsContainer);
     this.viewModel.beginFollowingPointer(t, i);
   }
   _onSliderInput({ currentTarget: t }) {
@@ -115,15 +111,15 @@ class P extends v {
     return d("directional-buttons-container", o`<calcite-action-bar expand-disabled floating layout=grid overflow-actions-disabled><calcite-action-group class=${n(s.buttonsContainer)} dir=ltr @contextmenu=${{
       handleEvent: this._onContextMenu,
       capture: !0
-    }} ${m(this._setButtonContainerRef)}>${u.slice(0, 4).map(this._renderButton, this)}${this._renderCompass()}${u.slice(4).map(this._renderButton, this)}</calcite-action-group></calcite-action-bar>`);
+    }} ${b(this._setButtonContainerRef)}>${u.slice(0, 4).map(this._renderButton, this)}${this._renderCompass()}${u.slice(4).map(this._renderButton, this)}</calcite-action-group></calcite-action-bar>`);
   }
   _renderButton(t) {
-    const { label: e, iconName: i } = S[t], r = this.messages[e];
+    const { label: e, iconName: i } = M[t], r = this.messages[e];
     return o`<calcite-action .active=${this.angle === t} alignment=center class=${n(s.button)} data-angle=${t ?? l} .disabled=${this.disabled} @click=${this._onClick.bind(this, t)} @pointerdown=${this._onButtonPointerDown} .scale=${this.visualScale} .text=${r ?? ""} title=${r ?? l}><calcite-icon .icon=${i} .scale=${this.visualScale}></calcite-icon></calcite-action>`;
   }
   _renderCompass() {
-    const t = this.disabled || D(this.view) ? "compass-needle" : "arrow-up", e = this.rotation === 0, i = this.messages.resetHeading;
-    return o`<calcite-action alignment=center class=${n(s.compassButton)} .disabled=${this.disabled || !this._rotationEnabled || e} @click=${this._onRotationReset} .scale=${this.visualScale} style=${R(this._rotateIcon(this.rotation))} .text=${i ?? ""} title=${i ?? l}>${!e && o`<calcite-icon .icon=${t} .scale=${this.visualScale}></calcite-icon>` || ""}</calcite-action>`;
+    const t = this.disabled || E(this.view) ? "compass-needle" : "arrow-up", e = this.rotation === 0, i = this.messages.resetHeading;
+    return o`<calcite-action alignment=center class=${n(s.compassButton)} .disabled=${this.disabled || !this._rotationEnabled || e} @click=${this._onRotationReset} .scale=${this.visualScale} style=${C(this._rotateIcon(this.rotation))} .text=${i ?? ""} title=${i ?? l}>${!e && o`<calcite-icon .icon=${t} .scale=${this.visualScale}></calcite-icon>` || ""}</calcite-action>`;
   }
   _renderRotation() {
     return d("slider-container", o`<calcite-action-bar expand-disabled floating layout=horizontal><calcite-action-group class=${n(s.rotationContainer)}>${this.showRotationResetButton ? this._renderRotationResetButton() : null}${this._renderRotationSlider()}</calcite-action-group></calcite-action-bar>`);
@@ -136,7 +132,7 @@ class P extends v {
     return o`<div class=${n(s.rotationSliderContainer)}><calcite-slider .ariaLabel=${this.messages.heading} .disabled=${this.disabled || !this._rotationEnabled} label-handles max=360 min=0 required .scale=${this.visualScale} .value=${Math.round(this.rotation)} @calciteSliderInput=${this._onSliderInput}></calcite-slider></div>`;
   }
 }
-p("geoscene-directional-pad", P);
+p("geoscene-directional-pad", k);
 export {
-  P as GeosceneDirectionalPad
+  k as GeosceneDirectionalPad
 };

package/dist/components/geoscene-directional-pad/utils.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="@geoscene/core/interfaces.d.ts" />
-import { Nil } from '@arcgis/components-utils';
+import { nil } from '@arcgis/toolkit/type';
 import { DirectionalPadAngle } from './constants';
 export interface Vector {
     readonly x: number;
@@ -22,4 +22,4 @@ export declare function toUnitVector(first: Vector, second: Vector): Vector;
  * @private
  */
 export declare function findElementCenter(element: Element): Vector;
-export declare function canShowNorth(view: __geoscene.MapView | __geoscene.SceneView | Nil): boolean;
+export declare function canShowNorth(view: __geoscene.MapView | __geoscene.SceneView | nil): boolean;