@arcgis/map-components 4.33.0-next.99 → 4.34.0-next.0

package/dist/components/arcgis-video-player-settings/customElement.js

@@ -5,8 +5,8 @@ import { watch as h } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as p } from "@arcgis/lumina";
 import { css as m } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const v = m`.arcgis-video-player__settings-flow{min-width:var(--calcite-size-160)}`, $ = ["Auto"], g = [
   { label: "0.25x", value: 0.25 },
   { label: "0.5x", value: 0.5 },
@@ -14,9 +14,9 @@ const v = m`.arcgis-video-player__settings-flow{min-width:var(--calcite-size-160
   { label: "1.5x", value: 1.5 },
   { label: "2x", value: 2 }
 ], s = new a([255, 127, 0]);
-class u extends p {
+class _ extends p {
   constructor() {
-    super(...arguments), this._color = null, this._speed = "1x", this._quality = "Auto", this._disabled = !1, this._active = null;
+    super(...arguments), this._color = null, this._speed = "1x", this._quality = "Auto", this._disabled = !1;
   }
   static {
     this.properties = { _disabled: 16, _active: 16, viewModel: 0, messages: 0 };
@@ -24,28 +24,24 @@ class u extends p {
   static {
     this.styles = v;
   }
-  //#endregion
-  //#region Lifecycle
   loaded() {
     this.manager.onLifecycle(() => [
-      h(() => this.viewModel.state, (l) => {
-        this._disabled = l === "not-ready" || l === "waiting";
+      h(() => this.viewModel.state, (c) => {
+        this._disabled = c === "not-ready" || c === "waiting";
       }, { initial: !0 })
     ]);
   }
-  //#endregion
-  //#region Rendering
   render() {
-    const { viewModel: l, messages: e } = this, o = i`<calcite-flow-item .heading=${e.playbackSpeed} .selected=${this._active === "speed"} @calciteFlowItemBack=${() => this._active = null}><calcite-list .label=${e.playbackSpeed} selection-mode=single-persist>${g.map(({ label: t, value: c }) => i`<calcite-list-item .label=${t} @click=${() => {
-      this._speed = t, l.changePlaybackSpeed(c);
-    }} .selected=${t === this._speed}></calcite-list-item>`)}</calcite-list></calcite-flow-item>`, n = i`<calcite-flow-item .heading=${e.quality} .selected=${this._active === "quality"} @calciteFlowItemBack=${() => this._active = null}><calcite-list .label=${e.quality} selection-mode=single-persist>${$.map((t) => i`<calcite-list-item .label=${t} @click=${() => this._quality = t} .selected=${t === this._quality}></calcite-list-item>`)}</calcite-list></calcite-flow-item>`, r = i`<calcite-flow-item .heading=${e.graphics} .selected=${this._active === "color"} @calciteFlowItemBack=${() => this._active = null}><calcite-block .heading=${e.color} open><calcite-color-picker channels-disabled format=hex saved-disabled scale=s .value=${this._color?.toHex() ?? s.toHex()} @calciteColorPickerChange=${({ currentTarget: t }) => {
-      const c = t.value?.toString() ?? null;
-      this._color = c ? new a(c) : null, this._color && l.changeGraphicsColor(this._color);
+    const { viewModel: c, messages: e } = this, o = i`<calcite-flow-item .heading=${e.playbackSpeed} .selected=${this._active === "speed"} @calciteFlowItemBack=${() => this._active = void 0}><calcite-list .label=${e.playbackSpeed} selection-mode=single-persist>${g.map(({ label: t, value: l }) => i`<calcite-list-item .label=${t} @click=${() => {
+      this._speed = t, c.changePlaybackSpeed(l);
+    }} .selected=${t === this._speed}></calcite-list-item>`)}</calcite-list></calcite-flow-item>`, n = i`<calcite-flow-item .heading=${e.quality} .selected=${this._active === "quality"} @calciteFlowItemBack=${() => this._active = void 0}><calcite-list .label=${e.quality} selection-mode=single-persist>${$.map((t) => i`<calcite-list-item .label=${t} @click=${() => this._quality = t} .selected=${t === this._quality}></calcite-list-item>`)}</calcite-list></calcite-flow-item>`, r = i`<calcite-flow-item .heading=${e.graphics} .selected=${this._active === "color"} @calciteFlowItemBack=${() => this._active = void 0}><calcite-block .heading=${e.color} open><calcite-color-picker channels-disabled format=hex saved-disabled scale=s .value=${this._color?.toHex() ?? s.toHex()} @calciteColorPickerChange=${({ currentTarget: t }) => {
+      const l = t.value?.toString() ?? null;
+      this._color = l ? new a(l) : null, this._color && c.changeGraphicsColor(this._color);
     }}></calcite-color-picker></calcite-block></calcite-flow-item>`;
-    return i`<div><calcite-popover auto-close .label=${e.settings} overlay-positioning=fixed placement=top-end pointer-disabled reference-element=settings-action scale=s @calcitePopoverClose=${() => this._active = null}><calcite-flow class=arcgis-video-player__settings-flow><calcite-flow-item heading=Settings .selected=${!this._active}><calcite-list .label=${e.settings}><calcite-list-item .label=${e.speed} @click=${() => this._active = "speed"}><div slot=content-end><calcite-chip .label=${this._speed} scale=s>${this._speed}</calcite-chip></div><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item><calcite-list-item .label=${e.quality} @click=${() => this._active = "quality"}><div slot=content-end><calcite-chip .label=${this._quality} scale=s>${this._quality}</calcite-chip></div><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item><calcite-list-item .label=${e.graphics} @click=${() => this._active = "color"}><calcite-color-picker-swatch .color=${this._color?.toString() ?? s.toString()} scale=s slot=content-end></calcite-color-picker-swatch><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item></calcite-list></calcite-flow-item>${this._active === "speed" ? o : null}${this._active === "quality" ? n : null}${this._active === "color" ? r : null}</calcite-flow></calcite-popover><calcite-action alignment=center .disabled=${this._disabled} icon=sliders id=settings-action scale=s slot=trigger .text=${e.settings}></calcite-action></div>`;
+    return i`<div><calcite-popover auto-close .label=${e.settings} overlay-positioning=fixed placement=top-end pointer-disabled reference-element=settings-action scale=s @calcitePopoverClose=${() => this._active = void 0}><calcite-flow class=arcgis-video-player__settings-flow><calcite-flow-item heading=Settings .selected=${!this._active}><calcite-list .label=${e.settings}><calcite-list-item .label=${e.speed} @click=${() => this._active = "speed"}><div slot=content-end><calcite-chip .label=${this._speed} scale=s>${this._speed}</calcite-chip></div><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item><calcite-list-item .label=${e.quality} @click=${() => this._active = "quality"}><div slot=content-end><calcite-chip .label=${this._quality} scale=s>${this._quality}</calcite-chip></div><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item><calcite-list-item .label=${e.graphics} @click=${() => this._active = "color"}><calcite-color-picker-swatch .color=${this._color?.toString() ?? s.toString()} scale=s slot=content-end></calcite-color-picker-swatch><calcite-icon icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item></calcite-list></calcite-flow-item>${this._active === "speed" ? o : null}${this._active === "quality" ? n : null}${this._active === "color" ? r : null}</calcite-flow></calcite-popover><calcite-action alignment=center .disabled=${this._disabled} icon=sliders id=settings-action scale=s slot=trigger .text=${e.settings}></calcite-action></div>`;
   }
 }
-d("arcgis-video-player-settings", u);
+d("arcgis-video-player-settings", _);
 export {
-  u as VideoPlayerSettings
+  _ as VideoPlayerSettings
 };

package/dist/components/arcgis-video-player-slider/customElement.js

@@ -3,8 +3,8 @@ import { html as l } from "lit-html";
 import { LitElement as c, safeClassMap as s } from "@arcgis/lumina";
 import { css as t } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const d = t`.arcgis-video-player__slider-progress-container{position:relative;z-index:1;width:100%}.arcgis-video-player__progress{--esri-video-player-progress-width: 2px;appearance:none;display:block;position:absolute;top:calc(50% - var(--esri-video-player-progress-width) / 2);left:var(--esri-video-player-controls-spacing);border:none;background:var(--calcite-color-border-1);cursor:pointer;width:calc(100% - var(--esri-video-player-controls-spacing) * 2);height:var(--esri-video-player-progress-width)}.arcgis-video-player__progress::-webkit-progress-bar{background-color:var(--calcite-color-border-3)}.arcgis-video-player__progress::-webkit-progress-value{background-color:var(--calcite-color-border-input)}.arcgis-video-player__progress::-moz-progress-bar{background-color:var(--calcite-color-border-3)}.arcgis-video-player__slider{--calcite-slider-track-color: transparent;background-color:var(--calcite-color-foreground-1);padding:calc(var(--esri-video-player-controls-spacing) / 4) calc(var(--esri-video-player-controls-spacing) / 2)}`, o = "arcgis-video-player", i = {
   progress: `${o}__progress`,
   slider: `${o}__slider`,
@@ -17,16 +17,12 @@ class p extends c {
   static {
     this.styles = d;
   }
-  //#endregion
-  //#region Private Methods
   _onSliderInput({ currentTarget: r }) {
     if (typeof r.value == "number") {
       const e = r.value * this.viewModel.duration / 100;
       this.viewModel.seekTo(e);
     }
   }
-  //#endregion
-  //#region Rendering
   render() {
     const { value: r, buffered: e } = this;
     return l`<div class=${s(i.sliderProgressContainer)}><progress class=${s(i.progress)} max=1 .value=${`${e}`}></progress><div class=${s(i.slider)}><calcite-slider max=100 min=0 .value=${r} @calciteSliderInput=${this._onSliderInput}></calcite-slider></div></div>`;

package/dist/components/arcgis-weather/customElement.d.ts

@@ -1,24 +1,26 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { HeadingLevel } from '../../support/heading.jsx';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { WeatherViewModel } from './WeatherViewModel.js';
 
-declare const useViewModel: (component: LitElement & Pick<WeatherViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<WeatherViewModel>, options?: {
-    editConstructorProperties(props: unknown): unknown;
-} | undefined) => WeatherViewModel;
-/** Weather component provides an interface for easily selecting and configuring the weather effects in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+declare const useViewModel: (component: LitElement & Pick<WeatherViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<WeatherViewModel>) => WeatherViewModel;
+/**
+ * The Weather component provides an interface for easily selecting and configuring the weather effects in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-weather/)
  */
 export declare class ArcgisWeather extends LitElement {
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
      * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-weather/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     /**
@@ -29,28 +31,112 @@ export declare class ArcgisWeather extends LitElement {
      * @instance
      * @type {number}
      * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
+     * @default 4
      */
     headingLevel: HeadingLevel;
     /**
      * Whether to hide the component's header.
+     *
+     * @default false
      */
     hideHeader: boolean;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "partly-cloudy"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The component's default label.
+     *
+     * @default "Weather"
+     */
     label: string | undefined;
+    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    messageOverrides?: typeof this.messages._overrides;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /** The current state of the component. */
     state: "ready" | "disabled" | "error";
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
+    private messages: Partial<{
+        componentLabel: string;
+        componentLabelAccessible: string;
+        weatherType: string;
+        error: {
+            unsupported: string;
+            localScene: string;
+            notVisible: string;
+            noAtmosphere: string;
+        };
+        sunny: {
+            label: string;
+            cloudCover: string;
+        };
+        cloudy: {
+            label: string;
+            cloudCover: string;
+        };
+        rainy: {
+            label: string;
+            cloudCover: string;
+            precipitation: string;
+        };
+        snowy: {
+            label: string;
+            cloudCover: string;
+            precipitation: string;
+            snowCover: string;
+            snowCoverTooltip: string;
+        };
+        foggy: {
+            label: string;
+            fogStrength: string;
+        };
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        componentLabelAccessible: string;
+        weatherType: string;
+        error: {
+            unsupported: string;
+            localScene: string;
+            notVisible: string;
+            noAtmosphere: string;
+        };
+        sunny: {
+            label: string;
+            cloudCover: string;
+        };
+        cloudy: {
+            label: string;
+            cloudCover: string;
+        };
+        rainy: {
+            label: string;
+            cloudCover: string;
+            precipitation: string;
+        };
+        snowy: {
+            label: string;
+            cloudCover: string;
+            precipitation: string;
+            snowCover: string;
+            snowCoverTooltip: string;
+        };
+        foggy: {
+            label: string;
+            fogStrength: string;
+        };
+    }>;
 }
 export {};

package/dist/components/arcgis-weather/customElement.js

@@ -1,24 +1,24 @@
-import { c as W } from "../../chunks/runtime.js";
+import { c as T } from "../../chunks/runtime.js";
 import { html as o } from "lit-html";
-import { usePropertyChange as x } from "@arcgis/lumina/controllers";
+import { usePropertyChange as W } from "@arcgis/lumina/controllers";
 import { classes as y } from "@arcgis/components-utils";
-import { watch as b } from "@arcgis/core/core/reactiveUtils.js";
-import { nothing as v, safeStyleMap as O, LitElement as S, createEvent as B, noShadowRoot as E, safeClassMap as g } from "@arcgis/lumina";
-import { u as H } from "../../chunks/useT9n.js";
-import { m as L } from "../../chunks/useViewModel.js";
-import { H as A } from "../../chunks/heading.js";
+import { nothing as v, safeStyleMap as O, LitElement as x, createEvent as S, noShadowRoot as B, safeClassMap as g } from "@arcgis/lumina";
+import { u as E } from "../../chunks/useT9n.js";
+import { m as H } from "../../chunks/useViewModel.js";
+import { H as L } from "../../chunks/heading.js";
 import { g as w } from "../../chunks/globalCss.js";
-import { css as D } from "@lit/reactive-element/css-tag.js";
-import k from "@arcgis/core/core/Accessor.js";
-import { property as h, subclass as P } from "@arcgis/core/core/accessorSupport/decorators.js";
-import f from "@arcgis/core/views/3d/environment/CloudyWeather.js";
-import _ from "@arcgis/core/views/3d/environment/FoggyWeather.js";
-import $ from "@arcgis/core/views/3d/environment/RainyWeather.js";
-import C from "@arcgis/core/views/3d/environment/SnowyWeather.js";
-import M from "@arcgis/core/views/3d/environment/SunnyWeather.js";
+import { css as A } from "@lit/reactive-element/css-tag.js";
+import D from "@arcgis/core/core/Accessor.js";
+import { property as h, subclass as k } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { watch as P } from "@arcgis/core/core/reactiveUtils.js";
+import b from "@arcgis/core/views/3d/environment/CloudyWeather.js";
+import f from "@arcgis/core/views/3d/environment/FoggyWeather.js";
+import _ from "@arcgis/core/views/3d/environment/RainyWeather.js";
+import $ from "@arcgis/core/views/3d/environment/SnowyWeather.js";
+import C from "@arcgis/core/views/3d/environment/SunnyWeather.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const c = "arcgis-weather", d = {
   base: c,
   content: `${c}__content`,
@@ -28,35 +28,35 @@ const c = "arcgis-weather", d = {
   optionsHidden: `${c}__options--hidden`,
   error: `${c}__error`,
   warning: `${c}__warning`
-}, R = D`@layer{.arcgis-weather{position:relative;padding:var(--esri-widget-padding);width:fit-content}.arcgis-weather__content{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);width:min-content}.arcgis-weather__content--has-error{visibility:hidden;height:0;overflow:hidden;pointer-events:none}.arcgis-weather__selector{display:flex;flex-direction:row;gap:var(--calcite-spacing-sm);align-items:center}.arcgis-weather__options{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);calcite-label:last-child{--calcite-label-margin-bottom: 0}}.arcgis-weather__options--hidden{display:none}.arcgis-weather__warning{display:flex;flex-direction:row;gap:var(--calcite-spacing-xs);align-items:center;font-size:var(--calcite-font-size-sm);calcite-icon{color:var(--calcite-color-status-warning)}}}`;
-var V = Object.defineProperty, j = Object.getOwnPropertyDescriptor, a = (t, e, i, s) => {
-  for (var r = s > 1 ? void 0 : s ? j(e, i) : e, p = t.length - 1, l; p >= 0; p--)
-    (l = t[p]) && (r = (s ? l(e, i, r) : l(r)) || r);
-  return s && r && V(e, i, r), r;
+}, R = A`@layer{.arcgis-weather{position:relative;padding:var(--esri-widget-padding);width:fit-content}.arcgis-weather__content{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);width:min-content}.arcgis-weather__content--has-error{visibility:hidden;height:0;overflow:hidden;pointer-events:none}.arcgis-weather__selector{display:flex;flex-direction:row;gap:var(--calcite-spacing-sm);align-items:center}.arcgis-weather__options{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);calcite-label:last-child{--calcite-label-margin-bottom: 0}}.arcgis-weather__options--hidden{display:none}.arcgis-weather__warning{display:flex;flex-direction:row;gap:var(--calcite-spacing-xs);align-items:center;font-size:var(--calcite-font-size-sm);calcite-icon{color:var(--calcite-color-status-warning)}}}`;
+var V = Object.defineProperty, j = Object.getOwnPropertyDescriptor, a = (t, e, s, i) => {
+  for (var r = i > 1 ? void 0 : i ? j(e, s) : e, p = t.length - 1, l; p >= 0; p--)
+    (l = t[p]) && (r = (i ? l(e, s, r) : l(r)) || r);
+  return i && r && V(e, s, r), r;
 };
 const z = {
-  sunny: M,
-  cloudy: f,
-  rainy: $,
-  snowy: C,
-  foggy: _
-}, T = Object.keys(z);
-let n = class extends k {
+  sunny: C,
+  cloudy: b,
+  rainy: _,
+  snowy: $,
+  foggy: f
+}, M = Object.keys(z);
+let n = class extends D {
   //#region Lifecycle
   constructor(t) {
     super(t), this.view = null, this._settingWeather = !1, this._weatherByType = {
-      sunny: new M(),
-      cloudy: new f(),
-      rainy: new $(),
-      snowy: new C(),
-      foggy: new _()
+      sunny: new C(),
+      cloudy: new b(),
+      rainy: new _(),
+      snowy: new $(),
+      foggy: new f()
     };
   }
   initialize() {
     this.addHandles([
       // When the weather is changed directly in the environment (not in the VM),
       // we need to update the corresponding weather instance in the view model.
-      b(
+      P(
         () => this.current,
         (t) => {
           this._settingWeather || t == null || (this._weatherByType = {
@@ -73,8 +73,13 @@ let n = class extends k {
       return "disabled";
     if (this.error != null)
       switch (this.error) {
+        // When the weather is not visible because of camera position, we don't
+        // consider it to be a fatal error so we still want to display the full
+        // UI, just with a warning at the bottom.
         case "not-visible":
           return "ready";
+        // Other errors make the widget unusable, so we consider them to be fatal
+        // and show only the error message.
         default:
           return "error";
       }
@@ -104,7 +109,7 @@ let n = class extends k {
   //#endregion
   //#region Public Methods
   setWeatherByType(t) {
-    if (!T.includes(t)) {
+    if (!M.includes(t)) {
       console.warn(`arcgis-weather - "${t}" is not a valid weather type`);
       return;
     }
@@ -142,58 +147,42 @@ a([
   h()
 ], n.prototype, "_environment", 1);
 n = a([
-  P("components.weather.WeatherViewModel")
+  k("components.weather.WeatherViewModel")
 ], n);
-function u({ label: t, value: e, disabled: i, onChange: s }) {
+function u({ label: t, value: e, disabled: s, onChange: i }) {
   const r = (p) => {
     const l = p.currentTarget.value;
-    s?.(l);
+    i?.(l);
   };
-  return o`<calcite-label scale=s>${t}<calcite-slider aria-label=${t ?? v} .disabled=${i} style=${O({
+  return o`<calcite-label scale=s>${t}<calcite-slider aria-label=${t ?? v} .disabled=${s} style=${O({
     // Tweaks to make the slider more compact and better-align within the weather component */
     marginInline: "-7px",
     marginBottom: "-7px"
   })} max=1 min=0 step=0.01 .value=${e ?? 0} @calciteSliderChange=${r} @calciteSliderInput=${r}></calcite-slider></calcite-label>`;
 }
-const F = L(n), I = {
+const F = H(n), I = {
   sunny: "brightness",
   cloudy: "partly-cloudy",
   rainy: "rain",
   snowy: "snow",
   foggy: "fog"
 };
-class q extends S {
+class q extends x {
   constructor() {
-    super(...arguments), this.viewModel = F(this), this.messages = H(), this.autoDestroyDisabled = !1, this.headingLevel = 4, this.hideHeader = !1, this.icon = "partly-cloudy", this.label = this.messages.componentLabel, this.position = "bottom-left", this.state = this.viewModel.state, this.arcgisPropertyChange = x()("state"), this.arcgisReady = B();
+    super(...arguments), this.viewModel = F(this), this.messages = E(), this.autoDestroyDisabled = !1, this.headingLevel = 4, this.hideHeader = !1, this.icon = "partly-cloudy", this.label = this.messages.componentLabel, this.position = "bottom-left", this.state = this.viewModel.state, this.arcgisPropertyChange = W()("state"), this.arcgisReady = S();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, headingLevel: 9, hideHeader: 5, icon: 1, label: 1, position: 1, referenceElement: 1, state: 3 };
+    this.properties = { autoDestroyDisabled: 5, headingLevel: 9, hideHeader: 5, icon: 1, label: 1, messageOverrides: 0, position: 1, referenceElement: 1, state: 3 };
   }
   static {
-    this.shadowRootOptions = E;
+    this.shadowRootOptions = B;
   }
   static {
     this.styles = R;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  //#endregion
-  //#region Lifecycle
-  load() {
-    this.manager.onLifecycle(() => [
-      b(() => this._renderContent(), () => this.requestUpdate())
-    ]);
-  }
-  //#endregion
-  //#region Private Methods
-  /**
-   * When the widget has a non-fatal error, we display the UI but show a warning
-   * at the bottom.
-   */
   _getWarningMessage() {
     switch (this.viewModel.error) {
       case "not-visible": {
@@ -204,10 +193,6 @@ class q extends S {
         return;
     }
   }
-  /**
-   * When the widget has a fatal error (i.e. it can't work at all), no weather
-   * configuration UI is shown. Instead, the error message is shown.
-   */
   _getErrorMessage() {
     const e = this.messages.error;
     if (e)
@@ -222,23 +207,21 @@ class q extends S {
           return;
       }
   }
-  //#endregion
-  //#region Rendering
   render() {
     return o`<div aria-label=${this.messages.componentLabelAccessible ?? v} class=${g(y(d.base, w.widget, this.viewModel.disabled && w.widgetDisabled))} role=region>${this._renderContent()}</div>`;
   }
   _renderContent() {
-    const { headingLevel: e, messages: i, viewModel: s } = this, r = this._getWarningMessage(), p = s.current, l = s.state === "error";
-    return o`${this.hideHeader ? void 0 : A({ level: e, children: i.componentLabel })}${l ? o`<div class=${g(d.error)}>${this._getErrorMessage()}</div>` : void 0}<div class=${g(y({ [d.content]: !0, [d.hasError]: l }))}><div aria-label=${i.weatherType ?? v} class=${g(d.selector)} role=radiogroup>${T.map(this._renderWeatherTypeButton, this)}</div>${Object.values(s.weatherByType).map((m) => o`<div class=${g(y({
+    const { headingLevel: e, messages: s, viewModel: i } = this, r = this._getWarningMessage(), p = i.current, l = i.state === "error";
+    return o`${this.hideHeader ? void 0 : L({ level: e, children: s.componentLabel })}${l ? o`<div class=${g(d.error)}>${this._getErrorMessage()}</div>` : void 0}<div class=${g(y({ [d.content]: !0, [d.hasError]: l }))}><div aria-label=${s.weatherType ?? v} class=${g(d.selector)} role=radiogroup>${M.map(this._renderWeatherTypeButton, this)}</div>${Object.values(i.weatherByType).map((m) => o`<div class=${g(y({
       [d.options]: !0,
       [d.optionsHidden]: m.type !== p?.type
     }))}>${this._renderOptions(m)}</div>`)}${r ? this._renderWarning(r) : void 0}</div>`;
   }
   _renderWeatherTypeButton(e) {
-    const i = this.messages[e]?.label ?? "", { disabled: s } = this.viewModel, r = !s && this.viewModel.current.type === e;
-    return o`<calcite-button .appearance=${r ? "solid" : "outline"} aria-checked=${r ? "true" : "false"} .disabled=${s} .iconStart=${I[e]} .kind=${r ? "brand" : "neutral"} .label=${i} @click=${() => {
+    const s = this.messages[e]?.label ?? "", { disabled: i } = this.viewModel, r = !i && this.viewModel.current.type === e;
+    return o`<calcite-button .appearance=${r ? "solid" : "outline"} aria-checked=${r ? "true" : "false"} .disabled=${i} .iconStart=${I[e]} .kind=${r ? "brand" : "neutral"} .label=${s} @click=${() => {
       r || this.viewModel.setWeatherByType(e);
-    }} scale=l title=${i ?? v}></calcite-button>`;
+    }} scale=l title=${s ?? v}></calcite-button>`;
   }
   _renderOptions(e) {
     switch (e.type) {
@@ -255,43 +238,43 @@ class q extends S {
     }
   }
   _renderSunnyOptions(e) {
-    return u({ disabled: this.viewModel.disabled, label: this.messages.sunny?.cloudCover, value: e.cloudCover, onChange: (i) => {
-      e.cloudCover = i;
+    return u({ disabled: this.viewModel.disabled, label: this.messages.sunny?.cloudCover, value: e.cloudCover, onChange: (s) => {
+      e.cloudCover = s;
     } });
   }
   _renderCloudyOptions(e) {
-    return u({ disabled: this.viewModel.disabled, label: this.messages.cloudy?.cloudCover, value: e.cloudCover, onChange: (i) => {
-      e.cloudCover = i;
+    return u({ disabled: this.viewModel.disabled, label: this.messages.cloudy?.cloudCover, value: e.cloudCover, onChange: (s) => {
+      e.cloudCover = s;
     } });
   }
   _renderRainyOptions(e) {
-    const { disabled: i } = this.viewModel, s = this.messages.rainy;
-    return o`${u({ disabled: i, label: s?.cloudCover, value: e.cloudCover, onChange: (r) => {
+    const { disabled: s } = this.viewModel, i = this.messages.rainy;
+    return o`${u({ disabled: s, label: i?.cloudCover, value: e.cloudCover, onChange: (r) => {
       e.cloudCover = r;
-    } })}${u({ disabled: i, label: s?.precipitation, value: e.precipitation, onChange: (r) => {
+    } })}${u({ disabled: s, label: i?.precipitation, value: e.precipitation, onChange: (r) => {
       e.precipitation = r;
     } })}`;
   }
   _renderSnowyOptions(e) {
-    const { disabled: i } = this.viewModel, s = this.messages.snowy;
-    return o`${u({ disabled: i, label: s?.cloudCover, value: e.cloudCover, onChange: (r) => {
+    const { disabled: s } = this.viewModel, i = this.messages.snowy;
+    return o`${u({ disabled: s, label: i?.cloudCover, value: e.cloudCover, onChange: (r) => {
       e.cloudCover = r;
-    } })}${u({ disabled: i, label: s?.precipitation, value: e.precipitation, onChange: (r) => {
+    } })}${u({ disabled: s, label: i?.precipitation, value: e.precipitation, onChange: (r) => {
       e.precipitation = r;
-    } })}<calcite-label layout=inline scale=s title=${s?.snowCoverTooltip ?? v}><calcite-checkbox .checked=${e.snowCover === "enabled"} .disabled=${i} @calciteCheckboxChange=${(r) => {
+    } })}<calcite-label layout=inline scale=s title=${i?.snowCoverTooltip ?? v}><calcite-checkbox .checked=${e.snowCover === "enabled"} .disabled=${s} @calciteCheckboxChange=${(r) => {
       this.viewModel.setSnowCoverEnabled(r.currentTarget.checked);
-    }}></calcite-checkbox>${s?.snowCover}</calcite-label>`;
+    }}></calcite-checkbox>${i?.snowCover}</calcite-label>`;
   }
   _renderFoggyOptions(e) {
-    return u({ disabled: this.viewModel.disabled, label: this.messages.foggy?.fogStrength, value: e.fogStrength, onChange: (i) => {
-      e.fogStrength = i;
+    return u({ disabled: this.viewModel.disabled, label: this.messages.foggy?.fogStrength, value: e.fogStrength, onChange: (s) => {
+      e.fogStrength = s;
     } });
   }
   _renderWarning(e) {
     return o`<div class=${g(d.warning)}><calcite-icon icon=exclamation-mark-triangle scale=s></calcite-icon>${e}</div>`;
   }
 }
-W("arcgis-weather", q);
+T("arcgis-weather", q);
 export {
   q as ArcgisWeather
 };

package/dist/components/arcgis-zoom/customElement.d.ts

@@ -1,47 +1,67 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
-import { Nil } from '@arcgis/components-utils';
 import { default as MapView } from '@arcgis/core/views/MapView.js';
 import { default as SceneView } from '@arcgis/core/views/SceneView.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
 type Layout = "horizontal" | "vertical";
-/** Zoom component allows users to zoom in/out within a view.
+type State = "disabled" | "ready";
+/**
+ * The Zoom component allows users to zoom in/out within a map or scene.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-zoom/)
  */
 export declare class ArcgisZoom extends LitElement {
     /**
-     * If true, the component will not be destroyed automatically when
-     * it is disconnected from the document. This is useful when you
-     * want to move the component to a different place on the page, or
-     * temporary hide it. If this is set, make sure to call the
-     * \`destroy\` method when you are done to prevent memory leaks.
+     * If true, the component will not be destroyed automatically when it is
+     * disconnected from the document. This is useful when you want to move the
+     * component to a different place on the page, or temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-zoom/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
-    /** Icon which represents the component. */
-    icon: Nil | string;
+    /**
+     * Icon which represents the component.
+     * Typically used when the component is controlled by another component (e.g. by the Expand component).
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "magnifying-glass-plus"
+     */
+    icon?: string;
     /** The component's default label. */
-    label: Nil | string;
-    /** Determines the layout/orientation of the Zoom widget. */
+    label?: string;
+    /**
+     * Determines the layout/orientation of the Zoom widget.
+     *
+     * @default "vertical"
+     */
     layout: Layout;
-    /** Replace localized message strings with your own strings. */
+    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
     messageOverrides?: typeof this.messages._overrides;
+    /** @default "top-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
     /**
      * The current state of the component.
+     *
+     * @default "disabled"
      */
-    get state(): "disabled" | "ready";
-    /** Permanently destroy the component */
+    state: State;
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /** Zooms the view in by an LOD factor of 0.5. */
     zoomIn(): Promise<void>;
     /** Zooms the view out by an LOD factor of 2. */
     zoomOut(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
     private messages: Partial<{
         componentLabel: string;
         zoomIn: string;