@arcgis/map-components 6.0.0-next.22 → 6.0.0-next.24

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 (154) hide show
  1. package/dist/cdn/{WUWF6ZDM.js → 2Z36ICJZ.js} +1 -1
  2. package/dist/cdn/{GQQTIX2X.js → 3HI5IZSQ.js} +1 -1
  3. package/dist/cdn/3KAC2MKA.js +2 -0
  4. package/dist/cdn/{2NM6UWC4.js → 47CFYOUT.js} +1 -1
  5. package/dist/cdn/4N4XDCDQ.js +2 -0
  6. package/dist/cdn/{7ZWBGSCM.js → 4NG7CALI.js} +1 -1
  7. package/dist/cdn/{NTHSQXKG.js → 5DEJDR4W.js} +1 -1
  8. package/dist/cdn/{LUW2PXWZ.js → 5PPYHS6V.js} +1 -1
  9. package/dist/cdn/{M5OK7RKI.js → 66GRDX36.js} +1 -1
  10. package/dist/cdn/{SAQ5BNZJ.js → 6CKQPMJB.js} +1 -1
  11. package/dist/cdn/6GE2WBKV.js +2 -0
  12. package/dist/cdn/6GGKA7MT.js +2 -0
  13. package/dist/cdn/{XPBFBRSY.js → 6K4IASNK.js} +1 -1
  14. package/dist/cdn/{7LO6ACC7.js → 6VV5SX76.js} +1 -1
  15. package/dist/cdn/{Y3E2FJPQ.js → 74WM2EIB.js} +1 -1
  16. package/dist/cdn/{4I6F64B2.js → 7U2V3LDM.js} +1 -1
  17. package/dist/cdn/{3GN3DAON.js → A7YFCO3R.js} +1 -1
  18. package/dist/cdn/{3SXQLU4S.js → APFZ2FVO.js} +1 -1
  19. package/dist/cdn/{VLHURRRU.js → BM3FQ4OG.js} +1 -1
  20. package/dist/cdn/{LWVYNWD5.js → CGE6E3O3.js} +1 -1
  21. package/dist/cdn/CVLOQWUD.js +2 -0
  22. package/dist/cdn/{NORQIOSX.js → DGXTCH6B.js} +1 -1
  23. package/dist/cdn/{JUYPQUPQ.js → E5CGORXN.js} +1 -1
  24. package/dist/cdn/E5X5BYWA.js +2 -0
  25. package/dist/cdn/ECF4B24M.js +2 -0
  26. package/dist/cdn/EJVFK7JX.js +2 -0
  27. package/dist/cdn/{BUH3AQ7E.js → FTLNYN3G.js} +1 -1
  28. package/dist/cdn/{BJ35LPCU.js → G7BWEBJH.js} +1 -1
  29. package/dist/cdn/GIQT67VT.js +2 -0
  30. package/dist/cdn/{V7DMA5ZO.js → GZ6UBR6R.js} +1 -1
  31. package/dist/cdn/{AOGDXJ2J.js → H66E4VOY.js} +1 -1
  32. package/dist/cdn/HADZXZIE.js +2 -0
  33. package/dist/cdn/{BDZHLGVT.js → HL6WL2YA.js} +1 -1
  34. package/dist/cdn/HTCPPGCR.js +2 -0
  35. package/dist/cdn/HTONXZBP.js +2 -0
  36. package/dist/cdn/{F2DTKJTK.js → HUWIY53T.js} +1 -1
  37. package/dist/cdn/{UE6EBLH3.js → IKVGZFZ6.js} +1 -1
  38. package/dist/cdn/{NKFAPBY3.js → JRO4IBJP.js} +1 -1
  39. package/dist/cdn/KXDLX4RE.js +2 -0
  40. package/dist/cdn/LHYI2QBZ.js +2 -0
  41. package/dist/cdn/{LXJURAXP.js → NLG5U5ZN.js} +1 -1
  42. package/dist/cdn/{BLYXYNGB.js → PPGKQRNY.js} +1 -1
  43. package/dist/cdn/{DS6EUOYE.js → PW3QCZXY.js} +1 -1
  44. package/dist/cdn/{7EIN5VCY.js → Q2GYNZYQ.js} +1 -1
  45. package/dist/cdn/{SJGQALDG.js → Q2ZQOGM2.js} +1 -1
  46. package/dist/cdn/{UFK7DHVC.js → QBRGIFBY.js} +1 -1
  47. package/dist/cdn/{ZC5YVHZ3.js → QQLN6RWA.js} +1 -1
  48. package/dist/cdn/QXEOEFF3.js +2 -0
  49. package/dist/cdn/{BJJZGYBG.js → R6ARQKAY.js} +1 -1
  50. package/dist/cdn/RFO3M46K.js +2 -0
  51. package/dist/cdn/{YBXCTOS7.js → RQPOCDJS.js} +1 -1
  52. package/dist/cdn/{CNJSDHZI.js → RT53VCER.js} +1 -1
  53. package/dist/cdn/{AIF4MCBB.js → RXKIZFNQ.js} +1 -1
  54. package/dist/cdn/{SKAZPI3A.js → TTERKXN5.js} +1 -1
  55. package/dist/cdn/{LKGURYDH.js → TTWQ7RNF.js} +1 -1
  56. package/dist/cdn/{VHZM25YV.js → UB6BQW3G.js} +1 -1
  57. package/dist/cdn/{DGSTI5DI.js → UJURQACP.js} +1 -1
  58. package/dist/cdn/{UHDJ2SI5.js → VW35MSDL.js} +1 -1
  59. package/dist/cdn/{IQGL3AGV.js → WU4NDBMC.js} +1 -1
  60. package/dist/cdn/{FRX4ZT35.js → XKGD4N75.js} +1 -1
  61. package/dist/cdn/{3B4VHD67.js → XN3MG6YU.js} +1 -1
  62. package/dist/cdn/{PFMWLSWQ.js → XWBR6FXI.js} +1 -1
  63. package/dist/cdn/{B2TICPHR.js → Y5ZZCA3R.js} +1 -1
  64. package/dist/cdn/YITBBUPR.js +2 -0
  65. package/dist/cdn/{4IG6WUCI.js → YTZZRJ7Z.js} +1 -1
  66. package/dist/cdn/{OQ6SYZBT.js → YXIJXXTK.js} +1 -1
  67. package/dist/cdn/{L6FLCEH6.js → Z3674FMT.js} +1 -1
  68. package/dist/cdn/assets/video-player/t9n/messages.en.json +1 -1
  69. package/dist/cdn/index.js +1 -1
  70. package/dist/cdn/main.css +1 -1
  71. package/dist/chunks/useArcgisViewReadyError.js +155 -151
  72. package/dist/chunks/useViewModel.js +7 -7
  73. package/dist/chunks/utils.js +17 -17
  74. package/dist/chunks/utils5.js +2 -2
  75. package/dist/components/arcgis-basemap-gallery/customElement.js +17 -17
  76. package/dist/components/arcgis-basemap-gallery-item/customElement.js +1 -1
  77. package/dist/components/arcgis-coordinate-conversion/customElement.d.ts +5 -0
  78. package/dist/components/arcgis-coordinate-conversion-next/customElement.d.ts +6 -5
  79. package/dist/components/arcgis-feature-attachments/customElement.js +18 -18
  80. package/dist/components/arcgis-feature-next/customElement.d.ts +1 -1
  81. package/dist/components/arcgis-features-next/customElement.js +14 -15
  82. package/dist/components/arcgis-scale-bar/customElement.js +11 -11
  83. package/dist/components/arcgis-search/customElement.d.ts +12 -0
  84. package/dist/components/arcgis-search/customElement.js +3 -0
  85. package/dist/components/arcgis-sketch/customElement.js +1 -1
  86. package/dist/components/arcgis-swipe/customElement.d.ts +0 -22
  87. package/dist/components/arcgis-swipe/customElement.js +47 -65
  88. package/dist/components/arcgis-time-bar/customElement.d.ts +486 -409
  89. package/dist/components/arcgis-time-bar/types.d.ts +36 -15
  90. package/dist/components/arcgis-time-bar-slider/customElement.d.ts +179 -162
  91. package/dist/components/arcgis-time-slider/customElement.d.ts +1 -0
  92. package/dist/components/arcgis-time-slider/customElement.js +8 -7
  93. package/dist/components/arcgis-track/customElement.d.ts +12 -3
  94. package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/customElement.d.ts +7 -0
  95. package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/customElement.js +8 -5
  96. package/dist/components/arcgis-utility-network-trace-analysis/customElement.d.ts +45 -2
  97. package/dist/components/arcgis-utility-network-trace-analysis/customElement.js +23 -20
  98. package/dist/components/arcgis-utility-network-trace-configuration-picker/customElement.d.ts +125 -12
  99. package/dist/components/arcgis-utility-network-trace-elements-result-item/customElement.d.ts +9 -2
  100. package/dist/components/arcgis-utility-network-trace-elements-result-item/customElement.js +60 -57
  101. package/dist/components/arcgis-utility-network-trace-functions-result-item/customElement.d.ts +7 -0
  102. package/dist/components/arcgis-utility-network-trace-functions-result-item/customElement.js +12 -9
  103. package/dist/components/arcgis-utility-network-trace-inputs/customElement.d.ts +217 -14
  104. package/dist/components/arcgis-utility-network-trace-inputs/customElement.js +119 -108
  105. package/dist/components/arcgis-utility-network-trace-locations/customElement.d.ts +155 -8
  106. package/dist/components/arcgis-utility-network-trace-results/customElement.d.ts +9 -73
  107. package/dist/components/arcgis-utility-network-trace-results/customElement.js +132 -125
  108. package/dist/components/arcgis-utility-network-trace-results-pane/customElement.d.ts +161 -2
  109. package/dist/components/arcgis-video-player/customElement.d.ts +18 -0
  110. package/dist/components/arcgis-video-player/customElement.js +72 -72
  111. package/dist/components/arcgis-video-player/index.js +4 -4
  112. package/dist/components/arcgis-video-player-action-bar/customElement.js +1 -1
  113. package/dist/components/arcgis-video-player-previews/customElement.js +159 -0
  114. package/dist/components/arcgis-video-player-settings/customElement.js +17 -16
  115. package/dist/components/arcgis-video-player-slider/customElement.js +23 -12
  116. package/dist/components/arcgis-video-player-slider/index.js +1 -0
  117. package/dist/docs/api.json +1 -1
  118. package/dist/docs/docs.json +1 -1
  119. package/dist/docs/vscode.html-custom-data.json +1 -1
  120. package/dist/docs/web-types.json +1 -1
  121. package/dist/index.d.ts +0 -20
  122. package/dist/loader.js +6 -7
  123. package/dist/types/lumina.d.ts +2 -23
  124. package/dist/types/preact.d.ts +2 -25
  125. package/dist/types/react.d.ts +2 -27
  126. package/dist/types/stencil.d.ts +2 -23
  127. package/package.json +6 -6
  128. package/dist/cdn/2WJ53TNR.js +0 -2
  129. package/dist/cdn/5A7LDBDR.js +0 -2
  130. package/dist/cdn/COSETVX4.js +0 -2
  131. package/dist/cdn/F74YQZ2X.js +0 -2
  132. package/dist/cdn/H4BTVLCG.js +0 -2
  133. package/dist/cdn/KXD4VEKE.js +0 -2
  134. package/dist/cdn/MNL7ONFB.js +0 -2
  135. package/dist/cdn/NHMHVWNB.js +0 -2
  136. package/dist/cdn/NQ3COROI.js +0 -2
  137. package/dist/cdn/OJJSIN3V.js +0 -2
  138. package/dist/cdn/P3565WG3.js +0 -2
  139. package/dist/cdn/QAOT2TJ6.js +0 -2
  140. package/dist/cdn/QVJ2FUNW.js +0 -2
  141. package/dist/cdn/SIT5NBLS.js +0 -2
  142. package/dist/cdn/SU2SAOBL.js +0 -2
  143. package/dist/cdn/UI4IEVSV.js +0 -2
  144. package/dist/cdn/VEV3AAVP.js +0 -2
  145. package/dist/cdn/YYCTSS52.js +0 -2
  146. package/dist/components/arcgis-scale-range-slider/customElement.d.ts +0 -158
  147. package/dist/components/arcgis-scale-range-slider/customElement.js +0 -26
  148. package/dist/components/arcgis-scale-range-slider/index.d.ts +0 -1
  149. package/dist/components/arcgis-time-bar/TimeBarViewModel.d.ts +0 -73
  150. package/dist/components/arcgis-value-picker-legacy/customElement.d.ts +0 -642
  151. package/dist/components/arcgis-value-picker-legacy/customElement.js +0 -39
  152. package/dist/components/arcgis-value-picker-legacy/index.d.ts +0 -1
  153. package/dist/components/arcgis-value-picker-legacy/index.js +0 -1
  154. /package/dist/components/{arcgis-scale-range-slider → arcgis-video-player-previews}/index.js +0 -0
@@ -1,22 +1,41 @@
1
+ /**
2
+ * Types used to configure the [Time Bar](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/) and
3
+ * [Time Bar Slider](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/) components.
4
+ *
5
+ * @since 5.2
6
+ */
1
7
  import type TimeExtent from "@arcgis/core/time/TimeExtent.js";
2
8
  import type TimeInterval from "@arcgis/core/time/TimeInterval.js";
3
- import type { DateTimeFormatOptions } from "@arcgis/core/intl/date.js";
4
9
 
5
- /** Defines the different formats for displaying time in the time bar component. */
10
+ /**
11
+ * Determines the [format](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#format) of the date displayed in the [minimum](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#showMin),
12
+ * [maximum](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#showMax), and [time extent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#showTimeExtent) labels of the Time Bar component.
13
+ * If `"date"` is specified, only the localized day, month, and year components will be displayed, for example, "6/21/2026" in the "en-US" locale.
14
+ * If `"date-time"` is specified, the localized day, month, year, hour, minute, and second components will be displayed, for example,
15
+ * "6/21/2026, 3\:30\:00 PM" in the "en-US" locale.
16
+ */
6
17
  export type Format = "date-time" | "date";
7
18
 
8
- /** Defines the different modes of the time slider component. */
19
+ /** Defines the different [modes](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#mode) of the Time Bar component. */
9
20
  export type Mode = "cumulative-from-end" | "cumulative-from-start" | "instant" | "time-window";
10
21
 
11
- /** Defines the different states of the time bar component. */
22
+ /** Defines the different [states](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#state) of the Time Bar component. */
12
23
  export type State = "disabled" | "playing" | "ready";
13
24
 
14
- /** Stops are positioned at specific dates. */
25
+ /**
26
+ * [Stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#stops) are positioned at specific dates.
27
+ *
28
+ * @see [Time Bar stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#stops)
29
+ */
15
30
  export interface StopsByDates {
16
31
  dates: Date[];
17
32
  }
18
33
 
19
- /** Stops are positioned at regular intervals defined by a [time interval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval). */
34
+ /**
35
+ * [Stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#stops) are positioned at regular intervals defined by a [time interval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval).
36
+ *
37
+ * @see [Time Bar stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#stops)
38
+ */
20
39
  export interface StopsByInterval {
21
40
  /** The interval at which stops will be created. */
22
41
  interval: TimeInterval;
@@ -25,22 +44,24 @@ export interface StopsByInterval {
25
44
  }
26
45
 
27
46
  /**
28
- * Stops are positioned at a specific number of evenly spaced locations along the time slider.
29
- * The exact positions of the stops will be calculated based on the provided count and the time extent of the slider.
47
+ * [Stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#stops) are positioned at a specific number of evenly spaced locations for the Time Bar.
48
+ * The exact positions of the stops will be calculated based on the provided count and the time extent of the Time Bar.
49
+ *
50
+ * @see [Time Bar stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#stops)
30
51
  */
31
52
  export interface StopsByCount {
32
- /** The number of stops to create along the time slider. */
53
+ /** The number of stops to create for the Time Bar. */
33
54
  count: number;
34
55
  /** The time extent over which the stops will be distributed. */
35
56
  timeExtent?: TimeExtent;
36
57
  }
37
58
 
59
+ /**
60
+ * Defines the different ways [stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#stops) can be specified for the Time Bar component.
61
+ *
62
+ * @see [Time Bar stops](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#stops)
63
+ */
38
64
  export type Stops = StopsByCount | StopsByDates | StopsByInterval;
39
65
 
40
- export interface TickFormat {
41
- duration: number;
42
- format: DateTimeFormatOptions;
43
- timeInterval: TimeInterval;
44
- }
45
-
66
+ /** Defines how and when popovers are displayed for the [Time Bar Slider](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#popoverDisplay)'s thumb or range. */
46
67
  export type PopoverDisplay = "always" | "auto" | "none";
@@ -1,136 +1,224 @@
1
1
  /// <reference path="../../index.d.ts" />
2
2
  import type TimeExtent from "@arcgis/core/time/TimeExtent.js";
3
3
  import type { PopoverDisplay } from "../arcgis-time-bar/types.js";
4
- import type { TimeBarViewModel } from "../arcgis-time-bar/TimeBarViewModel.js";
5
4
  import type { PublicLitElement as LitElement } from "@arcgis/lumina";
6
5
 
7
6
  /**
8
- * The `arcgis-time-bar-slider` component renders a time-based slider intended for use `arcgis-time-bar`'s "time-extent" slot.
7
+ * * [Configuring the Time Bar Slider](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#time-bar-slider-configuration)
8
+ * * [Built-in configuration with visible UI controls](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#built-in-slider-content)
9
+ * * [Custom configuration with visible UI controls](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#custom-slider-content)
10
+ *
11
+ * The Time Bar Slider component renders an interactive time-based slider inside the Time Bar component. It can only be used in the
12
+ * [Time Bar](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/) component's [time-extent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#slot-time-extent) slot.
13
+ * Users can drag the slider thumbs to update the Time Bar's [timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#timeExtent).
14
+ * The Time Bar's [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#mode) determines whether the slider selects a single instant,
15
+ * a time window, or a cumulative range within its [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#fullTimeExtent).
16
+ *
17
+ * <span id="time-bar-slider-configuration"></span>
18
+ * ### Configuring the Time Bar Slider
19
+ *
20
+ * The Time Bar Slider is highly configurable. You can customize its appearance, behavior, and the content of its slots to suit your application's needs.
21
+ * Use the [showMin](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#showMin), [showMax](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#showMax), and
22
+ * [showTicks](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#showTicks) properties (or their corresponding HTML attributes `show-min`, `show-max`, and `show-ticks`) to display optional minimum and maximum date
23
+ * labels and tick marks.
24
+ *
25
+ * ![Time Bar Slider anatomy showing controls, attributes, and named slots](https://developers.arcgis.com/javascript/latest/assets/references/components/time-bar/time-bar-slider-anatomy.avif)
26
+ *
27
+ * <details>
28
+ * <summary>Read More</summary>
29
+ *
30
+ * <span id="built-in-slider-content"></span>
31
+ * #### Built-in configuration with visible UI controls
32
+ *
33
+ * The image below shows a Time Bar Slider displaying minimum and maximum date labels, tick marks, and a persistent popover.
34
+ * The popover displays the current date range.
35
+ * ![Time Bar Slider with popover](https://developers.arcgis.com/javascript/latest/assets/references/components/time-bar/time-bar-slider.avif)
9
36
  *
10
- * @slot [content-end] - A slot that displays ticks at the end of the slider. If not provided, default ticks will be rendered.
11
- * @slot [max] - A slot that displays a label for the end date of the slider. If not provided, a default label will be rendered.
12
- * @slot [min] - A slot that displays a label for the start date of the slider. If not provided, a default label will be rendered.
13
- * @slot [popover] - A slot that displays a popover's content while interacting with the slider's thumb or range. If not provided, a default content will be rendered.
14
- * @since 5.2
15
- * @example
16
- * An example of a `<arcgis-time-bar-slider>` slotted into time-bar's `time-extent` slot.
17
37
  * ```html
18
- * <arcgis-map basemap="satellite" zoom="6" center="-2,54">
19
- * <arcgis-time-bar show-play show-next show-previous show-time-extent slot="top-right">
20
- * <arcgis-time-bar-slider slot="time-extent"></arcgis-time-bar-slider>
21
- * </arcgis-time-bar>
22
- * </arcgis-map>
38
+ * <arcgis-time-bar id="time-bar" show-time-extent show-play show-next show-previous format="date-time" floating>
39
+ * <arcgis-time-bar-slider
40
+ * slot="time-extent"
41
+ * show-min
42
+ * show-max
43
+ * show-ticks
44
+ * popover-display="always">
45
+ * </arcgis-time-bar-slider>
46
+ * </arcgis-time-bar>
23
47
  * ```
24
48
  * ```js
25
- * <script type="module">
26
- * const [TimeExtent] = await $arcgis.import([
27
- * "@arcgis/core/time/TimeExtent.js",
28
- * ]);
49
+ * const timeBar = document.querySelector("arcgis-time-bar");
50
+ * await timeBar.componentOnReady();
51
+ * timeBar.fullTimeExtent = layer.timeInfo.fullTimeExtent;
52
+ * ```
53
+ *
54
+ * <span id="custom-slider-content"></span>
55
+ * #### Custom configuration with visible UI controls
29
56
  *
30
- * const viewElement = document.querySelector("arcgis-map");
31
- * const timeBarElement = document.querySelector("arcgis-time-bar");
32
- * const timeBarSliderElement = document.querySelector("arcgis-time-bar-slider");
57
+ * The `"min"`, `"max"`, `"content-end"`, and `"popover"` slots can be used to define custom content like formatted start and end dates.
58
+ * The following example customizes the `"content-end"` and `"popover"` slots, shows ticks every 3 days, keeps the date popover visible with `popover-display="always"`,
59
+ * and uses CSS for custom styling.
33
60
  *
34
- * const [_, timeBar] = await Promise.all([
35
- * viewElement.viewOnReady(),
36
- * timeBarElement.componentOnReady(),
37
- * timeBarSliderElement.componentOnReady(),
38
- * ]);
61
+ * ![Time Bar Slider with custom popover](https://developers.arcgis.com/javascript/latest/assets/references/components/time-bar/time-bar-slider-custom.avif)
62
+ *
63
+ * ```css
64
+ * #time-bar {
65
+ * --calcite-color-brand: #C53C06;
66
+ * --calcite-color-brand-press: #c79e42;
67
+ * }
68
+ * arcgis-time-bar-slider {
69
+ * block-size: 64px;
70
+ * color: var(--calcite-color-brand);
71
+ * }
72
+ * .time-label {
73
+ * color: var(--calcite-color-brand);
74
+ * font-size: 18px;
75
+ * font-weight: bold;
76
+ * text-align: center;
77
+ * width: max-content;
78
+ * max-width: min(280px, calc(100vw - 32px));
79
+ * }
80
+ * ```
39
81
  *
40
- * timeBar.fullTimeExtent = new TimeExtent({
41
- * start: new Date(2020, 0, 1),
42
- * end: new Date(2021, 0, 1),
43
- * });
44
- * </script>
82
+ * ```html
83
+ * <!-- Initialize the Time Bar with ticks and a locked time window -->
84
+ * <arcgis-time-bar floating show-play show-time-extent id="time-bar">
85
+ * <arcgis-time-bar-slider
86
+ * slot="time-extent"
87
+ * show-min
88
+ * show-max
89
+ * show-ticks
90
+ * show-lock-time-window
91
+ * lock-time-window
92
+ * popover-display="always">
93
+ * <arcgis-ticks slot="content-end" mode="value" show-labels> </arcgis-ticks>
94
+ * <div slot="popover" class="time-label"></div>
95
+ * </arcgis-time-bar-slider>
96
+ * </arcgis-time-bar>
45
97
  * ```
98
+ *
99
+ * ```js
100
+ * const timeBar = document.querySelector("arcgis-time-bar");
101
+ * await timeBar.componentOnReady();
102
+ * timeBar.fullTimeExtent = layer.timeInfo.fullTimeExtent;
103
+ *
104
+ * const timeBarSlider = timeBar.querySelector("arcgis-time-bar-slider");
105
+ * const ticks = timeBarSlider.querySelector("arcgis-ticks");
106
+ * const popoverSlot = timeBarSlider.querySelector('[slot="popover"]');
107
+ * const popoverFormatter = new Intl.DateTimeFormat(undefined, {
108
+ * month: "short",
109
+ * day: "numeric",
110
+ * });
111
+ *
112
+ * // Match the tick range to the Time Bar's full time extent
113
+ * ticks.min = timeBar.fullTimeExtent.start.getTime();
114
+ * ticks.max = timeBar.fullTimeExtent.end.getTime();
115
+ * const tickValues = [];
116
+ *
117
+ * // Add a tick every three days
118
+ * for (const date = new Date(ticks.min); date.getTime() <= ticks.max; date.setDate(date.getDate() + 3)) {
119
+ * tickValues.push(date.getTime());
120
+ * }
121
+ * ticks.values = tickValues;
122
+ *
123
+ * const tickDateFormatter = new Intl.DateTimeFormat(undefined, { month: "numeric", day: "numeric" });
124
+ * ticks.labelFormatter = (value) => tickDateFormatter.format(new Date(value));
125
+ *
126
+ * // Display the selected date range in the slider's popover
127
+ * function updatePopover() {
128
+ * const { start, end } = timeBar.timeExtent;
129
+ * popoverSlot.textContent = popoverFormatter.formatRange(start, end);
130
+ * }
131
+ *
132
+ * timeBar.addEventListener("arcgisPropertyChange", async (event) => {
133
+ * if (event.detail.name === "timeExtent") {
134
+ * updatePopover();
135
+ * }
136
+ * });
137
+ * ```
138
+ * </details>
139
+ *
140
+ * @slot
141
+ * [content-end] - A slot that displays content directly below the slider, typically a [Ticks](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-ticks/)
142
+ * component with custom tick positions and labels. If unused, the default Ticks component will be displayed.
143
+ * @slot [max] - A slot at the end of the Time Bar Slider. If unused, a label with the slider's end date will be displayed.
144
+ * @slot [min] - A slot that displays a label at the start of the Time Bar Slider. If unused, a label with the slider's start date will be displayed.
145
+ * @slot
146
+ * [popover] - A slot that displays a popover's content while interacting with the slider's thumb or range. If not provided, current time extent dates will be rendered. To display a Time Bar Slider's
147
+ * popover, the [popoverDisplay](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#popoverDisplay) property or `"popover-display"` attribute must be set to either `auto` or `always`.
148
+ * @since 5.2
149
+ * @see [Time Bar UI Configuration](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#time-bar-configuration)
150
+ * @see [Samples using Time Bar](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-time-bar-slider)
46
151
  */
47
152
  export abstract class ArcgisTimeBarSlider extends LitElement {
48
153
  /**
49
- * This property is intended to be used when inserting an element in the "popover" slot.
154
+ * This property is intended to be used when inserting an element in the `"popover"` slot.
50
155
  * This property will return either `undefined`, a
51
156
  * [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) or a
52
157
  * [TimeExtent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/)
53
158
  * depending on [popoverDisplay](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#popoverDisplay) and user interaction.
54
159
  *
55
- * When the `popover-display` is set to:
56
- * - `"none"`, this property will always return `undefined`
57
- * - `"always"`, this property will always return [arcgis-time-bar.timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#timeExtent),
160
+ * When `popover-display` is set to:
161
+ * - `"none"`, this property will always return `undefined`.
162
+ * - `"always"`, this property will always return [arcgis-time-bar.timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#timeExtent).
58
163
  * - `"auto"`, this property will either return a [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date)
59
164
  * if the user is interacting with a slider thumb, or
60
165
  * [arcgis-time-bar.timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#timeExtent) if the user is interacting with a slider track, or
61
166
  * `undefined` if the user is not interacting with either a slider thumb or slider track.
62
167
  *
63
168
  * @example
64
- * The following example demonstrates how to use the `activeValue` property to update the content of a popover while
65
- * interacting with the slider's thumb or track.
66
- *
67
- * When the time-bar-slider's thumb is being dragged, the popover will display the day of the week associated with the thumb's position.
68
- *
69
- * When the time-bar-slider's track is being dragged, the popover will display the day of the week associated with the start and end of the time extent.
169
+ * The following example demonstrates how to use the `activeValue` property to update custom popover content during user interaction:
170
+ * * Dragging a thumb: Displays the day of the week for that specific thumb's position.
171
+ * * Dragging the track: Displays the days of the week for the start and end of the active time range.
70
172
  *
71
173
  * ```html
72
174
  * <arcgis-map basemap="satellite" zoom="6" center="-2,54">
73
175
  * <arcgis-time-bar show-play show-next show-previous show-time-extent slot="top-right">
74
176
  * <arcgis-time-bar-slider slot="time-extent" popover-display="auto">
75
- * <div slot="popover" style="color: red; font-weight: bold; text-align: center; width: 100px;" />
177
+ * <div slot="popover" style="color: red; font-weight: bold; text-align: center; width: 100px;"></div>
76
178
  * </arcgis-time-bar-slider>
77
179
  * </arcgis-time-bar>
78
180
  * </arcgis-map>
79
181
  * ```
80
182
  * ```js
81
- * <script type="module">
82
- * const [TimeExtent, TimeInterval, reactiveUtils] = await $arcgis.import([
83
- * "@arcgis/core/time/TimeExtent.js",
84
- * "@arcgis/core/time/TimeInterval.js",
85
- * "@arcgis/core/core/reactiveUtils.js",
86
- * ]);
87
- *
88
- * const viewElement = document.querySelector("arcgis-map");
89
- * const timeBarElement = document.querySelector("arcgis-time-bar");
90
- * const timeBarSliderElement = document.querySelector("arcgis-time-bar-slider");
91
- * const popoverSlotElement = timeBarSliderElement.querySelector('[slot="popover"]');
92
- *
93
- * const [_, timeBar, timeBarSlider] = await Promise.all([
94
- * viewElement.viewOnReady(),
95
- * timeBarElement.componentOnReady(),
96
- * timeBarSliderElement.componentOnReady(),
97
- * ]);
183
+ * const timeBar = document.querySelector("arcgis-time-bar");
184
+ * await timeBar.componentOnReady();
185
+ * const timeBarSlider = document.querySelector("arcgis-time-bar-slider");
186
+ * const popoverSlot = timeBarSlider.querySelector('[slot="popover"]');
98
187
  *
99
- * timeBar.fullTimeExtent = new TimeExtent({
100
- * start: new Date(2026, 5, 22),
101
- * end: new Date(2026, 5, 26),
102
- * });
103
- * timeBar.stops = {
104
- * interval: new TimeInterval({
105
- * value: 1,
106
- * unit: "days",
107
- * }),
108
- * };
188
+ * timeBar.fullTimeExtent = new TimeExtent({
189
+ * start: new Date(2026, 5, 22),
190
+ * end: new Date(2026, 5, 26),
191
+ * });
192
+ * timeBar.stops = {
193
+ * interval: new TimeInterval({
194
+ * value: 1,
195
+ * unit: "days",
196
+ * }),
197
+ * };
109
198
  *
110
199
  * reactiveUtils.watch(
111
200
  * () => timeBarSlider.activeValue,
112
201
  * (activeValue) => {
113
202
  * if (!activeValue) {
114
- * popoverSlotElement.innerHTML = "";
203
+ * popoverSlot.innerHTML = "";
115
204
  * }
116
205
  *
117
206
  * // A date is returned when the user is interacting with the slider's thumb.
118
207
  * if (activeValue instanceof Date) {
119
- * popoverSlotElement.innerHTML = activeValue.toLocaleDateString(undefined, { weekday: "long" });
120
- * popoverSlotElement.style.width = "100px";
208
+ * popoverSlot.innerHTML = activeValue.toLocaleDateString(undefined, { weekday: "long" });
209
+ * popoverSlot.style.width = "100px";
121
210
  * }
122
211
  *
123
212
  * // A time extent is returned when the user is interacting with the slider's track.
124
213
  * if (activeValue instanceof TimeExtent) {
125
214
  * const start = activeValue.start?.toLocaleDateString(undefined, { weekday: "long" });
126
215
  * const end = activeValue.end?.toLocaleDateString(undefined, { weekday: "long" });
127
- * popoverSlotElement.innerHTML = `${start} - ${end}`;
128
- * popoverSlotElement.style.width = "150px";
216
+ * popoverSlot.innerHTML = `${start} - ${end}`;
217
+ * popoverSlot.style.width = "150px";
129
218
  * }
130
219
  * },
131
220
  * { initial: true },
132
221
  * );
133
- * </script>
134
222
  * ```
135
223
  */
136
224
  get activeValue(): Date | TimeExtent | null | undefined;
@@ -154,108 +242,43 @@ export abstract class ArcgisTimeBarSlider extends LitElement {
154
242
  */
155
243
  accessor autoDestroyDisabled: boolean;
156
244
  /**
157
- * When `true` and the time bar is in `time-window` mode, users will not be able to adjust individual thumbs. The thumbs will maintain a finite stop separation.
158
- * This ensures that the time window behaves as a single unit rather than allowing individual thumbs to be moved independently.
245
+ * When `true` and the Time Bar is in `time-window` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#mode), users will not be able to adjust individual thumbs.
246
+ * The thumbs remain a fixed number of stops apart. This ensures that the time window behaves as a single unit rather than allowing individual thumbs to be moved independently.
247
+ * This property can be toggled by the user if the [showLockTimeWindow](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#showLockTimeWindow) property is `true`.
159
248
  *
160
249
  * @default false
250
+ * @see [Time Bar Slider custom configuration](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#custom-slider-content)
161
251
  */
162
252
  accessor lockTimeWindow: boolean;
163
- accessor messages: {
164
- componentLabel: string;
165
- count: string;
166
- countPrompt: string;
167
- date: string;
168
- display: string;
169
- displayDescription: string;
170
- emptyTimeExtent: string;
171
- end: string;
172
- endDescription: string;
173
- everyDurationPartsTemplate: string;
174
- everyDurationTemplate: string;
175
- formatOptions: {
176
- dateAndTime: string;
177
- dateOnly: string;
178
- };
179
- from: string;
180
- lockTimeWindow: string;
181
- loop: string;
182
- mode: string;
183
- modeDescription: string;
184
- modeOptions: {
185
- "cumulative-from-end": string;
186
- "cumulative-from-start": string;
187
- instant: string;
188
- "time-window": string;
189
- };
190
- next: string;
191
- noTimeExtent: string;
192
- noTimeZoneAdjustment: string;
193
- overview: string;
194
- play: string;
195
- playbackRate: string;
196
- playbackRateDescription: string;
197
- previous: string;
198
- regularInterval: string;
199
- settings: string;
200
- start: string;
201
- startDescription: string;
202
- stop: string;
203
- stopOptions: {
204
- discreteDates: string;
205
- evenlySpaced: string;
206
- evenlySpacedTemplate: string;
207
- freeMovement: string;
208
- };
209
- stops: string;
210
- stopsDescription: string;
211
- through: string;
212
- time: string;
213
- timeBarSettings: string;
214
- timeExtent: string;
215
- timeUnitOptions: {
216
- day: string;
217
- hour: string;
218
- millisecond: string;
219
- minute: string;
220
- month: string;
221
- second: string;
222
- week: string;
223
- year: string;
224
- };
225
- timeZone: string;
226
- timeZoneDescription: string;
227
- unit: string;
228
- unitPrompt: string;
229
- units: string;
230
- unlockTimeWindow: string;
231
- } | undefined;
232
253
  /**
233
254
  * Defines how and when popovers are displayed for the slider's thumb or range.
234
- * When `none`, popovers are not displayed.
235
- * When `auto`, popovers are displayed automatically when interacting with a thumb or the slider's range.
236
- * When `always`, popovers are always displayed. If the slider is in `time-window` mode, popovers are displayed for the slider range otherwise the thumb.
255
+ * * When `none`, popovers are not displayed.
256
+ * * When `auto`, popovers are displayed automatically when the user interacts with a thumb or the slider's range.
257
+ * * When `always`, popovers are always displayed. If the slider is in `time-window` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#mode), popovers are displayed for the slider range; otherwise, they are displayed for the thumb.
237
258
  *
238
259
  * @default "none"
239
260
  */
240
261
  accessor popoverDisplay: PopoverDisplay;
241
262
  /**
242
- * When `true`, the `arcgis-time-bar-slider` will display a button to toggle the value of the `lockTimeWindow` property.
243
- * The button will appear depressed when `lockTimeWindow` is `true`.
244
- * The button will appear disabled when the mode is not `time-window`.
263
+ * When `true`, the [Time Bar](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/) component will display a button to toggle the value of the [lockTimeWindow](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#lockTimeWindow) property.
264
+ * * The button will appear depressed when `lockTimeWindow` is `true`.
265
+ * * The button will appear disabled when the mode is not `time-window`.
245
266
  *
246
267
  * @default false
247
268
  */
248
269
  accessor showLockTimeWindow: boolean;
249
270
  /**
250
- * When `true`, displays a label for the end date of the slider.
251
- * The contents of this label can be customized by providing a slotted element in the "max" slot.
271
+ * When `true`, displays the slot at the end of the Time Bar Slider. By default, the slotted element contains a label for the end date of the Time Bar's
272
+ * [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#fullTimeExtent).
273
+ * Provide an element in the `"max"` slot to replace the default label.
252
274
  *
253
275
  * @default false
254
276
  */
255
277
  accessor showMax: boolean;
256
278
  /**
257
- * When `true`, displays a label for the start date of the slider.
258
- * The contents of this label can be customized by providing a slotted element in the "min" slot.
279
+ * When `true`, displays the slot at the start of the Time Bar Slider. By default, the slotted element contains a label for the start date of the Time Bar's
280
+ * [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#fullTimeExtent).
281
+ * Provide an element in the `"min"` slot to replace the default label.
259
282
  *
260
283
  * @default false
261
284
  */
@@ -266,12 +289,6 @@ export abstract class ArcgisTimeBarSlider extends LitElement {
266
289
  * @default false
267
290
  */
268
291
  accessor showTicks: boolean;
269
- /**
270
- * The view model for the time bar slider.
271
- *
272
- * @internal
273
- */
274
- accessor viewModel: TimeBarViewModel | undefined;
275
292
  /** Permanently destroy the component. */
276
293
  destroy(): Promise<void>;
277
294
  /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
@@ -14,6 +14,7 @@ import type { TickConfig } from "@arcgis/core/widgets/Slider/types.js";
14
14
  /**
15
15
  * The Time Slider component simplifies visualization of temporal data in your application.
16
16
  *
17
+ * @deprecated since 5.2. Use the [Time Bar component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/) instead.
17
18
  * @since 4.28
18
19
  */
19
20
  export abstract class ArcgisTimeSlider extends LitElement {