@arcgis/map-components 6.0.0-next.42 → 6.0.0-next.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/dist/cdn/{HOMM5T7F.js → 23FQMZEJ.js} +1 -1
  2. package/dist/cdn/{OT4D3TVG.js → 2KGJ7SZH.js} +1 -1
  3. package/dist/cdn/{GTQOMGD7.js → 2MIHLZFT.js} +1 -1
  4. package/dist/cdn/{NF426VVG.js → 3L2QSX64.js} +1 -1
  5. package/dist/cdn/{IH2T7XRU.js → 3VLSPKTJ.js} +1 -1
  6. package/dist/cdn/3ZRVPLIZ.js +2 -0
  7. package/dist/cdn/{TII37L6V.js → 4FBPT5MA.js} +1 -1
  8. package/dist/cdn/{6WT5CUW4.js → 4IPFHL7W.js} +1 -1
  9. package/dist/cdn/{HUZLTULW.js → 5MRT5VRJ.js} +1 -1
  10. package/dist/cdn/6E4PVTTN.js +2 -0
  11. package/dist/cdn/{5VK56DPB.js → 6NY67VW5.js} +1 -1
  12. package/dist/cdn/{RX7LVZ5V.js → 6P7V62WJ.js} +1 -1
  13. package/dist/cdn/{2BKWAHTD.js → 6TLX4R5A.js} +1 -1
  14. package/dist/cdn/6YPY3QWH.js +2 -0
  15. package/dist/cdn/{5IWCWL2Q.js → 7FB4DOVH.js} +1 -1
  16. package/dist/cdn/{QW37JDSG.js → 7GXJ6HJZ.js} +1 -1
  17. package/dist/cdn/{DVLTVCIH.js → 7YSYI32G.js} +1 -1
  18. package/dist/cdn/{FTRRLFYT.js → B6VGTQ4L.js} +1 -1
  19. package/dist/cdn/BQCOYIEH.js +2 -0
  20. package/dist/cdn/{Y6MM3GUE.js → BVWTI63V.js} +1 -1
  21. package/dist/cdn/{4DRKK3S6.js → CBCAUSDJ.js} +1 -1
  22. package/dist/cdn/{CX23L4OX.js → CPK3PMBE.js} +1 -1
  23. package/dist/cdn/CSVVXWVY.js +2 -0
  24. package/dist/cdn/{Y4GL4RZF.js → CX5AZKYT.js} +1 -1
  25. package/dist/cdn/{2J6WEB6T.js → DEICCDP4.js} +1 -1
  26. package/dist/cdn/DJAFLMKA.js +2 -0
  27. package/dist/cdn/{NYIKMTKG.js → E4ZUESKS.js} +1 -1
  28. package/dist/cdn/{UJBFSJDF.js → E5BLQ5FK.js} +1 -1
  29. package/dist/cdn/{KKSTZRNG.js → EDGXY4OL.js} +1 -1
  30. package/dist/cdn/{BLC3NFIQ.js → EL5AFBNE.js} +1 -1
  31. package/dist/cdn/{GEZIZQV6.js → EN5NCDOJ.js} +1 -1
  32. package/dist/cdn/{QNQOBXLM.js → EQA4WO3H.js} +1 -1
  33. package/dist/cdn/{JILA7S66.js → FLSEDKWU.js} +1 -1
  34. package/dist/cdn/{625O4F4L.js → GQVCBPZS.js} +1 -1
  35. package/dist/cdn/{I7XTEFQP.js → GSGFAJCR.js} +1 -1
  36. package/dist/cdn/{BXBPEOE3.js → GSU7GNNP.js} +1 -1
  37. package/dist/cdn/{RCJ3GROZ.js → HBQAYD5H.js} +1 -1
  38. package/dist/cdn/{D7RGMUI2.js → IAJNBAC5.js} +1 -1
  39. package/dist/cdn/{JPQ5ELDQ.js → INMMQJOE.js} +1 -1
  40. package/dist/cdn/{OMDFAKMT.js → IQYLP2H7.js} +1 -1
  41. package/dist/cdn/{DVH35LZL.js → J2K2LRII.js} +1 -1
  42. package/dist/cdn/{Y6ZJNJZ7.js → KSOO3XZ2.js} +1 -1
  43. package/dist/cdn/{KLSIUZNN.js → MKL4YXDU.js} +1 -1
  44. package/dist/cdn/{EMOYKTQL.js → O2BFE6NY.js} +1 -1
  45. package/dist/cdn/{O2RCWKKW.js → PD2BELF2.js} +1 -1
  46. package/dist/cdn/{T2JBUILX.js → PFYEJDRJ.js} +1 -1
  47. package/dist/cdn/{JWCEHGEZ.js → PNMBUGPD.js} +1 -1
  48. package/dist/cdn/{U53HTVZS.js → RUJLTSDR.js} +1 -1
  49. package/dist/cdn/{IH7XQCY4.js → SA7B3XQG.js} +1 -1
  50. package/dist/cdn/T7PDMEAD.js +2 -0
  51. package/dist/cdn/{F4QPMY2N.js → U5BYZI4G.js} +1 -1
  52. package/dist/cdn/{MG2HQ3FT.js → UW3FYQWG.js} +1 -1
  53. package/dist/cdn/{WRB2DEQ6.js → W6ILOTBW.js} +1 -1
  54. package/dist/cdn/{EZFBYRI4.js → WYX6WXW4.js} +1 -1
  55. package/dist/cdn/{JFE63ANJ.js → X27EW2YC.js} +1 -1
  56. package/dist/cdn/{6GFNMSM4.js → XHHVIWXO.js} +1 -1
  57. package/dist/cdn/{CRJB272X.js → XURPEC42.js} +1 -1
  58. package/dist/cdn/{4KLAFS2R.js → YB6AHPU5.js} +1 -1
  59. package/dist/cdn/{LQYTLVCL.js → YRQXG7GX.js} +1 -1
  60. package/dist/cdn/{LHH3PS5H.js → ZVGWUEUE.js} +1 -1
  61. package/dist/cdn/assets/time-zone-chip/t9n/messages.en.json +1 -1
  62. package/dist/cdn/index.js +1 -1
  63. package/dist/chunks/AnalysisViewModel.js +1 -1
  64. package/dist/chunks/async-utils.js +1 -1
  65. package/dist/components/arcgis-daylight/customElement.d.ts +43 -50
  66. package/dist/components/arcgis-daylight/customElement.js +231 -225
  67. package/dist/components/arcgis-elevation-profile/customElement.d.ts +8 -0
  68. package/dist/components/arcgis-elevation-profile/customElement.js +39 -38
  69. package/dist/components/arcgis-line-of-sight/customElement.d.ts +4 -1
  70. package/dist/components/arcgis-shadow-cast/customElement.d.ts +36 -24
  71. package/dist/components/arcgis-shadow-cast/customElement.js +105 -128
  72. package/dist/components/arcgis-time-zone-chip/customElement.d.ts +8 -0
  73. package/dist/components/arcgis-time-zone-chip/customElement.js +27 -18
  74. package/dist/components/arcgis-utility-network-trace-locations/customElement.js +34 -34
  75. package/dist/components/types.d.ts +7 -0
  76. package/dist/docs/api.json +1 -1
  77. package/dist/docs/docs.json +1 -1
  78. package/dist/docs/vscode.html-custom-data.json +1 -1
  79. package/dist/docs/web-types.json +1 -1
  80. package/dist/loader.js +3 -3
  81. package/dist/types/lumina.d.ts +6 -3
  82. package/dist/types/preact.d.ts +6 -3
  83. package/dist/types/react.d.ts +6 -3
  84. package/dist/types/stencil.d.ts +6 -3
  85. package/package.json +6 -6
  86. package/dist/cdn/4JR57ZIQ.js +0 -2
  87. package/dist/cdn/6BT6RP22.js +0 -2
  88. package/dist/cdn/GOMR7D5M.js +0 -2
  89. package/dist/cdn/LZUAJU6O.js +0 -2
  90. package/dist/cdn/SKV3CQSZ.js +0 -2
  91. package/dist/cdn/TXVB6WRV.js +0 -2
  92. package/dist/cdn/YGBYB3BZ.js +0 -2
@@ -59,7 +59,7 @@ function H(t, r) {
59
59
  }
60
60
  let s = class extends d {
61
61
  constructor(t, r) {
62
- super({}), this._abortHandle = null, this.abort = () => {
62
+ super(), this._abortHandle = null, this.abort = () => {
63
63
  this._abortController = h(this._abortController);
64
64
  }, this.remove = this.abort, this._abortController = new AbortController();
65
65
  const { signal: e } = this._abortController;
@@ -1,7 +1,7 @@
1
1
  /// <reference path="../../index.d.ts" />
2
2
  import type SceneView from "@arcgis/core/views/SceneView.js";
3
3
  import type { PublicLitElement as LitElement } from "@arcgis/lumina";
4
- import type { ArcgisReferenceElement, HeadingLevel } from "../types.js";
4
+ import type { ArcgisReferenceElement, HeadingLevel, TimeZoneEditMode } from "../types.js";
5
5
  import type { Season } from "./types.js";
6
6
  import type { T9nMeta } from "@arcgis/lumina/controllers";
7
7
  import type { Icon as Icon } from "@esri/calcite-components/components/calcite-icon";
@@ -22,30 +22,22 @@ import type { Icon as Icon } from "@esri/calcite-components/components/calcite-i
22
22
  * [date](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SunLighting/#date) property of
23
23
  * the lighting of [arcgis-scene.environment](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#environment).
24
24
  *
25
- * **How date, time, and UTC offset work**
25
+ * **How date, time, and scene time zone work**
26
26
  *
27
- * In sunlight mode, `SunLighting.date` is the source of truth for the scene lighting instant. The Daylight component's
28
- * [utcOffset](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#utcOffset) is a numeric offset from Coordinated Universal Time (UTC). It controls
29
- * how that instant is displayed (date and slider time) and how user-entered local values are converted back to UTC.
30
- * A UTC offset does not identify a regional time zone, such as `Europe/Zurich`, or automatically account for
31
- * daylight saving time.
27
+ * In sunlight mode, `SunLighting.date` is the source of truth for the scene lighting instant. The
28
+ * [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone) property controls how that instant is displayed (date and slider time) and how
29
+ * user-entered local values are converted back to UTC, including daylight saving time.
32
30
  *
33
- * This means changing only [utcOffset](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#utcOffset) updates the displayed local date/time but
31
+ * This means changing only [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone) updates the displayed local date/time but
34
32
  * preserves the same lighting instant. Changing [localDate](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#localDate) and/or
35
33
  * [timeSliderPosition](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#timeSliderPosition) writes a new `SunLighting.date` instant.
36
34
  *
37
- * > [!IMPORTANT]
38
- * >
39
- * > Daylight does not use [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone). Changing the scene's time zone does not update the
40
- * > date and time shown in Daylight or change the lighting instant. Support for using the scene's time zone is planned
41
- * > for a future release.
42
- *
43
35
  * [![daylight-default](https://developers.arcgis.com/javascript/latest/assets/references/core/components/daylight/daylight-default.avif)](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)
44
36
  *
45
- * The UTC offset selector, labeled **Timezone** in the component, sets [utcOffset](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#utcOffset).
46
- * Changing the selection updates the displayed date and time without changing the scene's lighting instant or
47
- * [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone).
37
+ * The time zone selector, labeled **Scene time zone** in the component, sets [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone).
38
+ * Changing the selection updates the displayed date and time without changing the scene's lighting instant.
48
39
  * The selector can be hidden using the [hideTimezone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#hideTimezone) property.
40
+ * Use [timeZoneEditMode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#timeZoneEditMode) to change the time zone button's behavior.
49
41
  *
50
42
  * By default, a calendar is displayed to select the day, month, and year.
51
43
  * With the [dateOrSeason](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#dateOrSeason) property, the calendar can be replaced with
@@ -66,7 +58,7 @@ import type { Icon as Icon } from "@esri/calcite-components/components/calcite-i
66
58
  *
67
59
  * Whenever the sun position option is unchecked, the scene applies the
68
60
  * **[virtual light](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/VirtualLighting/)** source relative to the camera.
69
- * With this, the component's time slider, UTC offset selector, and date picker get automatically disabled:
61
+ * With this, the component's time slider, scene time zone control, and date picker get automatically disabled:
70
62
  *
71
63
  * ![daylight-virtual](https://developers.arcgis.com/javascript/latest/assets/references/core/components/daylight/daylight-virtual.avif)
72
64
  *
@@ -76,11 +68,10 @@ import type { Icon as Icon } from "@esri/calcite-components/components/calcite-i
76
68
  * * When using the [virtual light](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/VirtualLighting/),
77
69
  * setting the time and date programmatically does not have an influence on the lighting conditions of the scene.
78
70
  * * When using the [sunlight](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SunLighting/),
79
- * the time slider and UTC offset react to camera changes when
71
+ * the lighting instant reacts to camera changes when
80
72
  * [cameraTrackingEnabled](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SunLighting/#cameraTrackingEnabled)
81
73
  * is enabled. Camera tracking updates the simulated sun's position to maintain a consistent solar time of day as the
82
- * camera moves. The component estimates the UTC offset from the camera's longitude; it does not determine the regional
83
- * time zone at the camera's location.
74
+ * camera moves. Camera tracking does not select or change the scene time zone.
84
75
  *
85
76
  * @see [arcgis-scene.environment](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#environment)
86
77
  * @see [SunLighting](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SunLighting/)
@@ -148,7 +139,7 @@ export abstract class ArcgisDaylight extends LitElement {
148
139
  /** @default false */
149
140
  accessor hideSunLightingToggle: boolean;
150
141
  /**
151
- * If true, the UTC offset selector, labeled **Timezone** in the component, is hidden.
142
+ * If true, the time zone control is hidden.
152
143
  *
153
144
  * @default false
154
145
  */
@@ -163,7 +154,7 @@ export abstract class ArcgisDaylight extends LitElement {
163
154
  /** The component's default label. */
164
155
  accessor label: string | undefined;
165
156
  /**
166
- * The local calendar date using [utcOffset](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#utcOffset).
157
+ * The local calendar date in [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone).
167
158
  *
168
159
  * Date-only ISO strings in `YYYY-MM-DD` format are preserved as-is to avoid day shifts in locations with negative
169
160
  * UTC offsets. Other valid `Date`, `number`, and `string` values are normalized to canonical `YYYY-MM-DD`.
@@ -250,12 +241,12 @@ export abstract class ArcgisDaylight extends LitElement {
250
241
  */
251
242
  accessor referenceElement: ArcgisReferenceElement | string | undefined;
252
243
  /**
253
- * Slider position for the local time of day using [utcOffset](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#utcOffset).
244
+ * Slider position for the local time of day in [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone).
254
245
  * The position represents the time of day in minutes. Values are normalized to a single day (0-1439).
255
246
  *
256
247
  * @example
257
248
  * ```js
258
- * // Set the local time to 4:00 PM (16:00) using the component's UTC offset.
249
+ * // Set the local scene time to 4:00 PM (16:00).
259
250
  * daylight.timeSliderPosition = 16 * 60;
260
251
  * ```
261
252
  * @example
@@ -281,39 +272,33 @@ export abstract class ArcgisDaylight extends LitElement {
281
272
  */
282
273
  accessor timeSliderSteps: number[] | number;
283
274
  /**
284
- * Time zone mode. Not supported after the component has loaded.
275
+ * Controls what happens when the time zone button is clicked.
276
+ *
277
+ * - `"inline"`: Opens the Scene time zone picker.
278
+ * - `"action"`: Emits [@arcgisTimeZoneAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#event-arcgisTimeZoneAction). The application can open its own settings.
279
+ * - `"read-only"`: Shows the time zone in a noninteractive chip.
280
+ *
281
+ * @default "inline"
282
+ * @since 6.0
283
+ */
284
+ accessor timeZoneEditMode: TimeZoneEditMode;
285
+ /**
286
+ * Controls scene time-zone or legacy UTC-offset behavior.
285
287
  *
288
+ * @default "region"
286
289
  * @internal
287
290
  */
288
291
  accessor timeZoneMode: "offset" | "region";
289
292
  /**
290
- * The UTC offset in hours used to display the component's local date and time. This numeric offset does not identify
291
- * a regional time zone or automatically account for daylight saving time.
293
+ * The UTC offset in hours used to display the component's local date and time.
294
+ * This value is derived from [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone) and the lighting instant.
295
+ * To change the displayed time zone, set [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone).
292
296
  *
293
- * In sunlight mode, changing only this property preserves the current `SunLighting.date` instant and recomputes
294
- * displayed local date/time in the new offset. When this property changes together with
295
- * [localDate](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#localDate) and/or [timeSliderPosition](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#timeSliderPosition),
296
- * the date/time values are applied as one local selection and a new lighting instant is written.
297
- * This property is separate from [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone). Changing one does not update the other.
298
- *
299
- * @example
300
- * ```js
301
- * // Change the UTC offset while preserving the same scene lighting instant.
302
- * daylight.utcOffset = -8;
303
- * ```
297
+ * @deprecated since 6.0. Use [arcgis-scene.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#timeZone) instead.
304
298
  * @example
305
299
  * ```js
306
- * // Apply the UTC offset and local date/time together to write a new lighting instant.
307
- * daylight.utcOffset = -8;
308
- * daylight.localDate = "2025-01-15";
309
- * daylight.timeSliderPosition = 16 * 60;
310
- * ```
311
- * @example
312
- * ```js
313
- * // Alternatively, the UTC offset can be set by configuring the `displayUTCOffset` property of `SunLighting`.
314
- * viewElement.environment.lighting = new SunLighting({
315
- * displayUTCOffset: -8
316
- * });
300
+ * // Update the displayed local time without changing the scene lighting instant.
301
+ * viewElement.timeZone = "America/Los_Angeles";
317
302
  * ```
318
303
  * @since 4.34
319
304
  */
@@ -340,6 +325,13 @@ export abstract class ArcgisDaylight extends LitElement {
340
325
  };
341
326
  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
342
327
  readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
328
+ /**
329
+ * Fires when the time zone button is clicked and [timeZoneEditMode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/#timeZoneEditMode) is `"action"`.
330
+ * The application handles this event to open its own time zone settings.
331
+ *
332
+ * @since 6.0
333
+ */
334
+ readonly arcgisTimeZoneAction: import("@arcgis/lumina").TargetedEvent<this, void>;
343
335
  /**
344
336
  * Fires when the user changes the date or time in the component by interacting with the slider, the date picker, the
345
337
  * season selector or the play buttons.
@@ -352,6 +344,7 @@ export abstract class ArcgisDaylight extends LitElement {
352
344
  readonly arcgisUserDateTimeChange: import("@arcgis/lumina").TargetedEvent<this, void>;
353
345
  readonly "@eventTypes": {
354
346
  arcgisReady: ArcgisDaylight["arcgisReady"]["detail"];
347
+ arcgisTimeZoneAction: ArcgisDaylight["arcgisTimeZoneAction"]["detail"];
355
348
  arcgisUserDateTimeChange: ArcgisDaylight["arcgisUserDateTimeChange"]["detail"];
356
349
  };
357
350
  }