@arcgis/map-components 4.33.0-next.77 → 4.33.0-next.79

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

@@ -2,46 +2,19 @@
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/components-controllers';
 import { Nil } from '@arcgis/components-utils';
-import { default as Weather } from '@arcgis/core/widgets/Weather.js';
-import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+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 useWeatherWidget: (component: import('@arcgis/components-controllers').StencilLifecycles & {
+declare const useViewModel: (component: import('@arcgis/components-controllers').StencilLifecycles & {
     manager: import('@arcgis/components-controllers').ControllerManager;
     el: HTMLElement;
     autoDestroyDisabled?: boolean;
     destroy?: () => Promise<void>;
-} & Pick<Weather, never> & {
-    reactiveUtils?: typeof __esri.reactiveUtils;
-    state?: unknown;
-    viewModel?: __esri.WeatherViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    position: __esri.
-    /**
-     * 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.
-     */
-    UIPosition;
-    arcgisReady: import('@arcgis/components-controllers').EventEmitter;
-    arcgisPropertyChange: import('@arcgis/components-controllers').EventEmitter<{
-        name: string;
-    }> | undefined;
-    el: HTMLElement & {
-        childElem?: HTMLElement & {
-            ownedBy?: HTMLElement;
-        };
-        view?: __esri.MapView | __esri.SceneView | Nil;
-    };
-    autoDestroyDisabled: boolean;
-    destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.WeatherProperties | undefined): __esri.WeatherProperties | Promise<__esri.WeatherProperties | undefined> | undefined;
-} | undefined) => Weather;
+} & 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).
  */
 export declare class ArcgisWeather extends LitElement {
@@ -53,7 +26,19 @@ export declare class ArcgisWeather extends LitElement {
      * memory leaks.
      */
     autoDestroyDisabled: boolean;
-    headingLevel: number;
+    /**
+     * Indicates the heading level to use for the title of the component. By default, this message is rendered as a level 4
+     * heading (e.g. `<h4>Time range</h4>`). Depending on the component's placement in your app, you may need to adjust
+     * this heading for proper semantics. This is important for meeting accessibility standards.
+     *
+     * @instance
+     * @type {number}
+     * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
+     */
+    headingLevel: HeadingLevel;
+    /**
+     * Whether to hide the component's header.
+     */
     hideHeader: boolean;
     /**
      * Icon which represents the component.
@@ -62,10 +47,10 @@ export declare class ArcgisWeather extends LitElement {
      */
     icon: string;
     /** The component's default label. */
-    label: string;
+    label: string | undefined;
     position: __esri.UIPosition;
     referenceElement: ArcgisReferenceElement | Nil | string;
-    readonly state: "ready" | "disabled" | "error";
+    state: "ready" | "disabled" | "error";
     /** Permanently destroy the component */
     destroy(): Promise<void>;
     readonly arcgisPropertyChange: TargetedEvent<this, {

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

@@ -1,25 +1,179 @@
-import { c as e } from "../../chunks/runtime.js";
-import { usePropertyChange as t } from "@arcgis/components-controllers";
-import s from "@arcgis/core/widgets/Weather.js";
-import { LitElement as i, createEvent as o, noShadowRoot as a } from "@arcgis/lumina";
-import { m as r } from "../../chunks/useWidget.js";
-import { css as h } from "@lit/reactive-element/css-tag.js";
+import { c as W } from "../../chunks/runtime.js";
+import { html as o } from "lit-html";
+import { usePropertyChange as x } from "@arcgis/components-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 { 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";
 /*! 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.77 */
-const l = h`@layer{arcgis-weather{display:block}}`, d = r(s);
-class n extends i {
+v4.33.0-next.79 */
+const c = "arcgis-weather", d = {
+  base: c,
+  content: `${c}__content`,
+  hasError: `${c}__content--has-error`,
+  selector: `${c}__selector`,
+  options: `${c}__options`,
+  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;
+};
+const z = {
+  sunny: M,
+  cloudy: f,
+  rainy: $,
+  snowy: C,
+  foggy: _
+}, T = Object.keys(z);
+let n = class extends k {
+  //#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 _()
+    };
+  }
+  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(
+        () => this.current,
+        (t) => {
+          this._settingWeather || t == null || (this._weatherByType = {
+            ...this._weatherByType,
+            [t.type]: t
+          });
+        },
+        { sync: !0, initial: !0 }
+      )
+    ]);
+  }
+  get state() {
+    if (!this.view?.ready)
+      return "disabled";
+    if (this.error != null)
+      switch (this.error) {
+        case "not-visible":
+          return "ready";
+        default:
+          return "error";
+      }
+    return "ready";
+  }
+  get disabled() {
+    return this.state === "disabled";
+  }
+  get weatherByType() {
+    return this._weatherByType;
+  }
+  get error() {
+    const t = this.view;
+    return t?.ready ? t.type !== "3d" ? "unsupported-view" : t.viewingMode === "local" ? "local-scene" : t.environment.atmosphereEnabled ? t.environment.weatherAvailable ? null : "not-visible" : "no-atmosphere" : null;
+  }
+  get current() {
+    return this._environment?.weather ?? this._weatherByType.sunny;
+  }
+  set current(t) {
+    const e = this._environment;
+    e && (e.weather = t);
+  }
+  get _environment() {
+    const t = this.view;
+    return t != null && t.type === "3d" ? t.environment : null;
+  }
+  //#endregion
+  //#region Public Methods
+  setWeatherByType(t) {
+    if (!T.includes(t)) {
+      console.warn(`"arcgis-weather - ${t}" is not a valid weather type`);
+      return;
+    }
+    const e = this._environment;
+    e != null && (this._settingWeather = !0, e.weather = this._weatherByType[t], this._settingWeather = !1);
+  }
+  setSnowCoverEnabled(t) {
+    const e = this.current;
+    "snowCover" in e && (e.snowCover = t ? "enabled" : "disabled");
+  }
+  //#endregion
+};
+a([
+  h()
+], n.prototype, "view", 2);
+a([
+  h()
+], n.prototype, "state", 1);
+a([
+  h()
+], n.prototype, "disabled", 1);
+a([
+  h()
+], n.prototype, "weatherByType", 1);
+a([
+  h()
+], n.prototype, "error", 1);
+a([
+  h()
+], n.prototype, "current", 1);
+a([
+  h()
+], n.prototype, "_weatherByType", 2);
+a([
+  h()
+], n.prototype, "_environment", 1);
+n = a([
+  P("components.weather.WeatherViewModel")
+], n);
+function u({ label: t, value: e, disabled: i, onChange: s }) {
+  const r = (p) => {
+    const l = p.currentTarget.value;
+    s?.(l);
+  };
+  return o`<calcite-label scale=s>${t}<calcite-slider aria-label=${t ?? v} .disabled=${i} 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 = {
+  sunny: "brightness",
+  cloudy: "partly-cloudy",
+  rainy: "rain",
+  snowy: "snow",
+  foggy: "fog"
+};
+class q extends S {
   constructor() {
-    super(...arguments), this.widget = d(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.headingLevel = this.widget.headingLevel, this.hideHeader = this.widget.visibleElements.header, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.state = this.viewModel.state, this.arcgisPropertyChange = t()("state"), this.arcgisReady = o();
+    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();
   }
   static {
     this.properties = { autoDestroyDisabled: 5, headingLevel: 9, hideHeader: 5, icon: 1, label: 1, position: 1, referenceElement: 1, state: 3 };
   }
   static {
-    this.shadowRootOptions = a;
+    this.shadowRootOptions = E;
   }
   static {
-    this.styles = l;
+    this.styles = R;
   }
   //#endregion
   //#region Public Methods
@@ -27,8 +181,117 @@ class n extends i {
   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": {
+        const { view: e } = this.viewModel;
+        return e?.type === "3d" && e.environment.atmosphereEnabled ? this.messages.error?.notVisible : void 0;
+      }
+      default:
+        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)
+      switch (this.viewModel.error) {
+        case "local-scene":
+          return e.localScene;
+        case "no-atmosphere":
+          return e.noAtmosphere;
+        case "unsupported-view":
+          return e.unsupported;
+        default:
+          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({
+      [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=${() => {
+      r || this.viewModel.setWeatherByType(e);
+    }} scale=l title=${i ?? v}></calcite-button>`;
+  }
+  _renderOptions(e) {
+    switch (e.type) {
+      case "sunny":
+        return this._renderSunnyOptions(e);
+      case "cloudy":
+        return this._renderCloudyOptions(e);
+      case "rainy":
+        return this._renderRainyOptions(e);
+      case "snowy":
+        return this._renderSnowyOptions(e);
+      case "foggy":
+        return this._renderFoggyOptions(e);
+    }
+  }
+  _renderSunnyOptions(e) {
+    return u({ disabled: this.viewModel.disabled, label: this.messages.sunny?.cloudCover, value: e.cloudCover, onChange: (i) => {
+      e.cloudCover = i;
+    } });
+  }
+  _renderCloudyOptions(e) {
+    return u({ disabled: this.viewModel.disabled, label: this.messages.cloudy?.cloudCover, value: e.cloudCover, onChange: (i) => {
+      e.cloudCover = i;
+    } });
+  }
+  _renderRainyOptions(e) {
+    const { disabled: i } = this.viewModel, s = this.messages.rainy;
+    return o`${u({ disabled: i, label: s?.cloudCover, value: e.cloudCover, onChange: (r) => {
+      e.cloudCover = r;
+    } })}${u({ disabled: i, label: s?.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) => {
+      e.cloudCover = r;
+    } })}${u({ disabled: i, label: s?.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) => {
+      this.viewModel.setSnowCoverEnabled(r.currentTarget.checked);
+    }}></calcite-checkbox>${s?.snowCover}</calcite-label>`;
+  }
+  _renderFoggyOptions(e) {
+    return u({ disabled: this.viewModel.disabled, label: this.messages.foggy?.fogStrength, value: e.fogStrength, onChange: (i) => {
+      e.fogStrength = i;
+    } });
+  }
+  _renderWarning(e) {
+    return o`<div class=${g(d.warning)}><calcite-icon icon=exclamation-mark-triangle scale=s></calcite-icon>${e}</div>`;
+  }
 }
-e("arcgis-weather", n);
+W("arcgis-weather", q);
 export {
-  n as ArcgisWeather
+  q as ArcgisWeather
 };

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

@@ -1 +1,6 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-slider";
+import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-checkbox";
+import "@esri/calcite-components/components/calcite-icon";
 export * from "./customElement.js";

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

@@ -1 +1,6 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-slider";
+import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-checkbox";
+import "@esri/calcite-components/components/calcite-icon";
 export * from "./customElement.js";

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

@@ -9,7 +9,7 @@ import { m as b } from "../../chunks/useViewModel.js";
 import { css as w } 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.77 */
+v4.33.0-next.79 */
 const o = {
   base: "arcgis-zoom",
   horizontalLayout: "arcgis-zoom--horizontal",

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-04-10T05:08:22",
+  "timestamp": "2025-04-11T15:22:06",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.33.0-next.77",
+    "version": "4.33.0-next.79",
     "typescriptVersion": "5.6.3"
   },
   "schemaVersion": "1.0.0",
@@ -53918,21 +53918,56 @@
             {
               "kind": "field",
               "name": "headingLevel",
-              "description": "Indicates the heading level to use for the title of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Weather.html#headingLevel)",
+              "description": "Indicates the heading level to use for the title of the component. By default, this message is rendered as a level 4\nheading (e.g. `<h4>Time range</h4>`). Depending on the component's placement in your app, you may need to adjust\nthis heading for proper semantics. This is important for meeting accessibility standards.",
               "type": {
-                "text": "number",
+                "text": "1 | 2 | 3 | 4 | 5 | 6",
                 "values": [
                   {
+                    "value": "1",
+                    "type": "number"
+                  },
+                  {
+                    "value": "2",
+                    "type": "number"
+                  },
+                  {
+                    "value": "3",
+                    "type": "number"
+                  },
+                  {
+                    "value": "4",
+                    "type": "number"
+                  },
+                  {
+                    "value": "5",
+                    "type": "number"
+                  },
+                  {
+                    "value": "6",
                     "type": "number"
                   }
                 ]
               },
               "default": "4",
-              "attribute": "heading-level"
+              "attribute": "heading-level",
+              "docsTags": [
+                {
+                  "name": "instance"
+                },
+                {
+                  "name": "type",
+                  "text": "{number}"
+                },
+                {
+                  "name": "see",
+                  "text": "[Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "hideHeader",
+              "description": "Whether to hide the component's header.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -53971,6 +54006,7 @@
                   }
                 ]
               },
+              "default": "\"Weather\"",
               "attribute": "label"
             },
             {
@@ -54068,7 +54104,6 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the view model that can be used for rendering the UI of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Weather-WeatherViewModel.html#state)",
               "type": {
                 "text": "\"disabled\" | \"error\" | \"ready\"",
                 "values": [
@@ -54086,11 +54121,8 @@
                   }
                 ]
               },
-              "default": "\"disabled\"",
-              "readonly": true,
               "attribute": "state",
-              "reflects": true,
-              "docsOnlyReadonly": true
+              "reflects": true
             }
           ],
           "attributes": [
@@ -54110,11 +54142,32 @@
             },
             {
               "name": "heading-level",
-              "description": "Indicates the heading level to use for the title of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Weather.html#headingLevel)",
+              "description": "Indicates the heading level to use for the title of the component. By default, this message is rendered as a level 4\nheading (e.g. `<h4>Time range</h4>`). Depending on the component's placement in your app, you may need to adjust\nthis heading for proper semantics. This is important for meeting accessibility standards.",
               "type": {
-                "text": "number",
+                "text": "1 | 2 | 3 | 4 | 5 | 6",
                 "values": [
                   {
+                    "value": "1",
+                    "type": "number"
+                  },
+                  {
+                    "value": "2",
+                    "type": "number"
+                  },
+                  {
+                    "value": "3",
+                    "type": "number"
+                  },
+                  {
+                    "value": "4",
+                    "type": "number"
+                  },
+                  {
+                    "value": "5",
+                    "type": "number"
+                  },
+                  {
+                    "value": "6",
                     "type": "number"
                   }
                 ]
@@ -54124,6 +54177,7 @@
             },
             {
               "name": "hide-header",
+              "description": "Whether to hide the component's header.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -54160,6 +54214,7 @@
                   }
                 ]
               },
+              "default": "\"Weather\"",
               "fieldName": "label"
             },
             {
@@ -54222,7 +54277,6 @@
             },
             {
               "name": "state",
-              "description": "The current state of the view model that can be used for rendering the UI of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Weather-WeatherViewModel.html#state)",
               "type": {
                 "text": "\"disabled\" | \"error\" | \"ready\"",
                 "values": [
@@ -54240,7 +54294,6 @@
                   }
                 ]
               },
-              "default": "\"disabled\"",
               "fieldName": "state"
             }
           ],