@arcgis/map-components 6.0.0-next.19 → 6.0.0-next.20

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

@@ -1,10 +1,11 @@
 /// <reference path="../../index.d.ts" />
-import type SwipeViewModel from "@arcgis/core/widgets/Swipe/SwipeViewModel.js";
+import type Collection from "@arcgis/core/core/Collection.js";
+import type Layer from "@arcgis/core/layers/Layer.js";
 import type MapView from "@arcgis/core/views/MapView.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement } from "../types.js";
+import type { SwipeDirection, SwipeState } from "./types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
-import type { Direction, State } from "@arcgis/core/widgets/Swipe/types.js";
 
 /**
  * The Swipe component provides a tool to show a portion of a layer or layers
@@ -50,7 +51,7 @@ export abstract class ArcgisSwipe extends LitElement {
    *
    * @default "horizontal"
    */
-  accessor direction: Direction;
+  accessor direction: SwipeDirection;
   /**
    * When true, the component is visually de-emphasized and does not accept user interaction.
    *
@@ -63,7 +64,7 @@ export abstract class ArcgisSwipe extends LitElement {
    * @see [trailingLayers](https://developers.arcgis.com/javascript/latest/references/core/widgets/Swipe/SwipeViewModel/#trailingLayers)
    * @since 5.0
    */
-  accessor endLayers: SwipeViewModel["trailingLayers"];
+  accessor endLayers: Collection<Layer>;
   /**
    * When `true`, the divider between the leading and trailing layers will be hidden.
    *
@@ -96,7 +97,7 @@ export abstract class ArcgisSwipe extends LitElement {
    * @deprecated since 5.0, use [startLayers](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-swipe/#startLayers) instead.
    * @see [leadingLayers](https://developers.arcgis.com/javascript/latest/references/core/widgets/Swipe/SwipeViewModel/#leadingLayers)
    */
-  accessor leadingLayers: SwipeViewModel["leadingLayers"];
+  accessor leadingLayers: Collection<Layer>;
   /**
    * Replace localized message strings with your own strings.
    *
@@ -134,13 +135,13 @@ export abstract class ArcgisSwipe extends LitElement {
    * @see [leadingLayers](https://developers.arcgis.com/javascript/latest/references/core/widgets/Swipe/SwipeViewModel/#leadingLayers)
    * @since 5.0
    */
-  accessor startLayers: SwipeViewModel["leadingLayers"];
+  accessor startLayers: Collection<Layer>;
   /**
    * The current state of the component.
    *
    * @default "disabled"
    */
-  get state(): State;
+  get state(): SwipeState;
   /**
    * The position of the Swipe component. This determines what percentage
    * of the view will be taken up by the [startLayers](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-swipe/#startLayers).
@@ -155,12 +156,12 @@ export abstract class ArcgisSwipe extends LitElement {
    * @deprecated since 5.0, use [endLayers](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-swipe/#endLayers) instead.
    * @see [trailingLayers](https://developers.arcgis.com/javascript/latest/references/core/widgets/Swipe/SwipeViewModel/#trailingLayers)
    */
-  accessor trailingLayers: SwipeViewModel["trailingLayers"];
+  accessor trailingLayers: Collection<Layer>;
   /**
    * The view associated with the component.
    * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-swipe component will be associated with a map or scene component rather than using the `view` property.
    */
-  accessor view: MapView | null | undefined;
+  accessor view: MapView | undefined;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */

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

@@ -1,29 +1,229 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import { c as x } from "../../chunks/runtime.js";
-import { css as _, html as d } from "lit";
-import { classes as g } from "@arcgis/toolkit/dom";
-import C from "@arcgis/core/widgets/Swipe/SwipeViewModel.js";
-import { LitElement as L, createEvent as v, safeClassMap as u, safeStyleMap as w, nothing as D } from "@arcgis/lumina";
-import { usePropertyChange as M } from "@arcgis/lumina/controllers";
-import { createRef as P, ref as $ } from "lit/directives/ref.js";
-import { u as K } from "../../chunks/useT9n.js";
-import { m as A } from "../../chunks/useViewModel.js";
-import { g as m } from "../../chunks/globalCss.js";
-import { l as b } from "../../chunks/legacyIcon.js";
-const S = _`:host{position:absolute;margin:0;background:transparent!important;padding:0;width:100%;height:100%;overflow:hidden;user-select:none;--arcgis-internal-swipe-handle-color-background: var(--calcite-color-background);--arcgis-internal-swipe-divider-color-background: var(--calcite-color-background)}.root{width:100%;height:100%;overflow:hidden;user-select:none}.root,.arcgis-ui .root{pointer-events:none!important}.container{position:absolute;z-index:1;margin:0;outline:0;border:0;padding:0;overflow:hidden;pointer-events:auto;touch-action:none;outline-color:transparent}.horizontal .container{margin-left:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:col-resize;height:100%}.vertical .container{margin-top:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:row-resize;width:100%}.disabled .container{cursor:default;pointer-events:none}.divider{position:absolute;background-color:var(--arcgis-internal-swipe-divider-color-background)}.horizontal .divider{top:0;left:calc(var(--calcite-spacing-xxxl) / 2);margin-left:calc(var(--calcite-border-width-lg) * .5 * -1);border-right:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-left:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:var(--calcite-border-width-lg);height:100%}.vertical .divider{top:calc(var(--calcite-spacing-xxxl) / 2);left:0;margin-top:calc(var(--calcite-border-width-lg) * .5 * -1);border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:100%;height:var(--calcite-border-width-lg)}.handle{display:flex;position:relative;align-items:center;justify-content:center;border:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-radius:var(--calcite-corner-radius-round);background-color:var(--arcgis-internal-swipe-handle-color-background);width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl);color:var(--calcite-color-text-3)}.handle-hidden{visibility:hidden}.vertical .handle{rotate:90deg}.handle-icon{position:relative;z-index:2}.handle-icon:before{content:"|||";color:inherit}.horizontal .handle{top:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.vertical .handle{left:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.container:focus .handle,.container:focus .divider{outline:inset 2px var(--calcite-color-focus, var(--calcite-color-focus, var(--calcite-color-brand)))}.container:focus .handle{outline-offset:calc(-2px*(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}`, k = A(C);
-class z extends L {
+import { c as z } from "../../chunks/runtime.js";
+import { css as A, html as y } from "lit";
+import { classes as b } from "@arcgis/toolkit/dom";
+import { LitElement as K, createEvent as L, safeClassMap as C, safeStyleMap as D, nothing as E } from "@arcgis/lumina";
+import { usePropertyChange as O } from "@arcgis/lumina/controllers";
+import { createRef as S, ref as H } from "lit/directives/ref.js";
+import { u as k } from "../../chunks/useT9n.js";
+import { m as U } from "../../chunks/useViewModel.js";
+import { g as P } from "../../chunks/globalCss.js";
+import { l as $ } from "../../chunks/legacyIcon.js";
+import I from "@arcgis/core/core/Accessor.js";
+import f from "@arcgis/core/core/Collection.js";
+import T from "@arcgis/core/core/Error.js";
+import { property as p, subclass as j } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { watch as x } from "@arcgis/core/core/reactiveUtils.js";
+import { c as R, i as X, l as Y } from "../../chunks/async-utils.js";
+var B = Object.defineProperty, N = Object.getOwnPropertyDescriptor, d = (t, e, i, r) => {
+  for (var s = r > 1 ? void 0 : r ? N(e, i) : e, o = t.length - 1, a; o >= 0; o--)
+    (a = t[o]) && (s = (r ? a(e, i, s) : a(s)) || s);
+  return r && s && B(e, i, s), s;
+};
+const w = {
+  left: 0,
+  right: 0,
+  top: 0,
+  bottom: 0
+}, M = {
+  leading: /* @__PURE__ */ Symbol("leading-clips"),
+  trailing: /* @__PURE__ */ Symbol("trailing-clips")
+};
+function V(t) {
+  return "clips" in t;
+}
+function F(t, e) {
+  const i = 10 ** e;
+  return Math.round(t * i) / i;
+}
+let l = class extends I {
+  constructor(t) {
+    super(t), this._leadingClips = /* @__PURE__ */ new Map(), this._trailingClips = /* @__PURE__ */ new Map(), this.direction = "horizontal", this.max = 100, this.min = 0, this.precision = 4, this.step = 0.5, this.stepMultiplier = 10, this.leadingLayers = new f(), this.trailingLayers = new f();
+  }
+  initialize() {
+    this.addHandles([
+      x(
+        () => [this.view, this.view?.ready, this.position, this.direction],
+        () => this._clipLayers(),
+        { initial: !0 }
+      ),
+      x(
+        () => this.leadingLayers.toArray(),
+        () => this._clipLeadingLayers(),
+        { initial: !0 }
+      ),
+      x(
+        () => this.trailingLayers.toArray(),
+        () => this._clipTrailingLayers(),
+        { initial: !0 }
+      )
+    ]);
+  }
+  destroy() {
+    this._removeExistingClips();
+  }
+  get leadingLayers() {
+    return this._get("leadingLayers");
+  }
+  set leadingLayers(t) {
+    this._set("leadingLayers", t instanceof f ? t : new f(t));
+  }
+  get position() {
+    return 25;
+  }
+  set position(t) {
+    const { precision: e, min: i, max: r } = this;
+    this._set("position", F(Math.max(Math.min(t, r), i), e));
+  }
+  get state() {
+    return this.view?.ready ? "ready" : "disabled";
+  }
+  get trailingLayers() {
+    return this._get("trailingLayers");
+  }
+  set trailingLayers(t) {
+    this._set("trailingLayers", t instanceof f ? t : new f(t));
+  }
+  _clipLayers() {
+    this._clipLeadingLayers(), this._clipTrailingLayers();
+  }
+  _clipLeadingLayers() {
+    this._removeClips("leading");
+    const { leadingLayers: t } = this;
+    t.forEach((e) => {
+      this.addHandles(
+        R((i) => this._clipLayer({ layer: e, type: "leading" }, i)),
+        M.leading
+      );
+    });
+  }
+  _clipTrailingLayers() {
+    this._removeClips("trailing");
+    const { trailingLayers: t } = this;
+    t.forEach((e) => {
+      this.addHandles(
+        R((i) => this._clipLayer({ layer: e, type: "trailing" }, i)),
+        M.trailing
+      );
+    });
+  }
+  async _getLayerView(t) {
+    const { view: e } = this;
+    if (!t || !e)
+      return null;
+    const i = await e.whenLayerView(t);
+    return V(i) ? i : null;
+  }
+  _getVerticalClipRect(t) {
+    const { position: e } = this;
+    return t === "leading" ? {
+      type: "rect",
+      ...w,
+      bottom: `${100 - e}%`
+    } : t === "trailing" ? {
+      type: "rect",
+      ...w,
+      top: `${e}%`
+    } : null;
+  }
+  _getHorizontalClipRect(t) {
+    const { position: e } = this;
+    return t === "leading" ? {
+      type: "rect",
+      ...w,
+      right: `${100 - e}%`
+    } : t === "trailing" ? {
+      type: "rect",
+      ...w,
+      left: `${e}%`
+    } : null;
+  }
+  _getClipRect(t) {
+    const { direction: e } = this;
+    return e === "vertical" ? this._getVerticalClipRect(t) : e === "horizontal" ? this._getHorizontalClipRect(t) : null;
+  }
+  async _clipLayer(t, e) {
+    const { _leadingClips: i, _trailingClips: r, view: s } = this, { layer: o, type: a } = t, c = a === "trailing" ? r : a === "leading" ? i : null;
+    try {
+      const n = await this._getLayerView(o);
+      if (e.aborted || this.destroyed || s !== this.view || !n || !c || !(a === "leading" ? this.leadingLayers : this.trailingLayers).includes(o))
+        return;
+      const g = c.get(n);
+      g && n.clips.remove(g);
+      const v = this._getClipRect(a);
+      if (v) {
+        const m = n.clips.length;
+        n.clips.add(v);
+        const u = n.clips.at(m);
+        u && c.set(n, u);
+      }
+    } catch (n) {
+      if (e.aborted || X(n) || n instanceof T && n.name === "view:no-layerview-for-layer")
+        return;
+      Y(n, this.declaredClass, "Failed to clip layer");
+    }
+  }
+  _removeClips(t) {
+    this.removeHandles(M[t]);
+    const { _leadingClips: e, _trailingClips: i } = this, r = t === "trailing" ? i : t === "leading" ? e : null;
+    r && (r.forEach((s, o) => {
+      V(o) && o.clips.remove(s);
+    }), r.clear());
+  }
+  _removeExistingClips() {
+    this._removeClips("leading"), this._removeClips("trailing");
+  }
+};
+d([
+  p()
+], l.prototype, "direction", 2);
+d([
+  p()
+], l.prototype, "leadingLayers", 1);
+d([
+  p({ readOnly: !0 })
+], l.prototype, "max", 2);
+d([
+  p({ readOnly: !0 })
+], l.prototype, "min", 2);
+d([
+  p()
+], l.prototype, "position", 1);
+d([
+  p()
+], l.prototype, "precision", 2);
+d([
+  p({ readOnly: !0 })
+], l.prototype, "state", 1);
+d([
+  p()
+], l.prototype, "step", 2);
+d([
+  p()
+], l.prototype, "stepMultiplier", 2);
+d([
+  p()
+], l.prototype, "trailingLayers", 1);
+d([
+  p()
+], l.prototype, "view", 2);
+l = d([
+  j("map-components.swipe.SwipeViewModel")
+], l);
+const W = A`:host{position:absolute;margin:0;background:transparent!important;padding:0;width:100%;height:100%;overflow:hidden;user-select:none;--arcgis-internal-swipe-handle-color-background: var(--calcite-color-background);--arcgis-internal-swipe-divider-color-background: var(--calcite-color-background)}.root{width:100%;height:100%;overflow:hidden;user-select:none}.root,.arcgis-ui .root{pointer-events:none!important}.container{position:absolute;z-index:1;margin:0;outline:0;border:0;padding:0;overflow:hidden;pointer-events:auto;touch-action:none;outline-color:transparent}.horizontal .container{margin-left:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:col-resize;height:100%}.vertical .container{margin-top:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:row-resize;width:100%}.disabled .container{cursor:default;pointer-events:none}.divider{position:absolute;background-color:var(--arcgis-internal-swipe-divider-color-background)}.horizontal .divider{top:0;left:calc(var(--calcite-spacing-xxxl) / 2);margin-left:calc(var(--calcite-border-width-lg) * .5 * -1);border-right:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-left:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:var(--calcite-border-width-lg);height:100%}.vertical .divider{top:calc(var(--calcite-spacing-xxxl) / 2);left:0;margin-top:calc(var(--calcite-border-width-lg) * .5 * -1);border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:100%;height:var(--calcite-border-width-lg)}.handle{display:flex;position:relative;align-items:center;justify-content:center;border:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-radius:var(--calcite-corner-radius-round);background-color:var(--arcgis-internal-swipe-handle-color-background);width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl);color:var(--calcite-color-text-3)}.handle-hidden{visibility:hidden}.vertical .handle{rotate:90deg}.handle-icon{position:relative;z-index:2}.handle-icon:before{content:"|||";color:inherit}.horizontal .handle{top:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.vertical .handle{left:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.container:focus .handle,.container:focus .divider{outline:inset 2px var(--calcite-color-focus, var(--calcite-color-focus, var(--calcite-color-brand)))}.container:focus .handle{outline-offset:calc(-2px*(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}`, q = U(l);
+class G extends K {
   constructor() {
-    super(...arguments), this._container = null, this._containerRef = P(), this._swiping = !1, this._positionChanged = !1, this.messages = K({}), this._pointerOffset = 0, this.viewModel = k(this), this._onContainerPointerDown = (e) => {
+    super(...arguments), this._containerRef = S(), this._swiping = !1, this._positionChanged = !1, this.messages = k({}), this._pointerOffset = 0, this.viewModel = q(this), this._onContainerPointerDown = (e) => {
       e.preventDefault();
-      const { _container: i } = this;
+      const i = this._containerRef.value;
       i && document.activeElement !== this.el && i.focus(), this._swiping = !0, this._calculatePointerOffset(e);
-    }, this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.direction = this.viewModel.direction, this.disabled = !1, this.hideDivider = !1, this.hideHandle = !1, this.icon = "compare", this.label = this.messages.componentLabel, this.position = this.viewModel.position, this.state = this.viewModel.state, this.arcgisPropertyChange = M()("state"), this.arcgisReady = v(), this.arcgisSwipeChange = v(), this.arcgisSwipeInput = v();
+    }, this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.direction = this.viewModel.direction, this.disabled = !1, this.hideDivider = !1, this.hideHandle = !1, this.icon = "compare", this.label = this.messages.componentLabel, this.position = this.viewModel.position, this.state = this.viewModel.state, this.arcgisPropertyChange = O()("state"), this.arcgisReady = L(), this.arcgisSwipeChange = L(), this.arcgisSwipeInput = L();
   }
   static {
     this.properties = { view: 0, autoDestroyDisabled: 5, direction: 3, disabled: 7, endLayers: 0, hideDivider: 7, hideHandle: 7, icon: 1, label: 1, leadingLayers: 0, messageOverrides: 0, position: 9, startLayers: 0, swipePosition: 9, referenceElement: 1, state: 32, trailingLayers: 0 };
   }
   static {
-    this.styles = S;
+    this.styles = W;
   }
   get endLayers() {
     return this.viewModel.trailingLayers;
@@ -62,8 +262,8 @@ class z extends L {
     this.listenOn(document, "pointermove", this._onContainerPointerMove), this.listenOn(document, "pointerup", this._onContainerPointerUp);
   }
   _calculatePointerOffset(e) {
-    const { direction: i } = this, t = this._containerRef.value, r = (i === "vertical" ? t.clientHeight : t.clientWidth) / 2, o = t.getBoundingClientRect(), n = e.clientX - o.left, c = e.clientY - o.top;
-    this._pointerOffset = i === "vertical" ? c - r : n - r;
+    const { direction: i } = this, r = this._containerRef.value, s = (i === "vertical" ? r.clientHeight : r.clientWidth) / 2, o = r.getBoundingClientRect(), a = e.clientX - o.left, c = e.clientY - o.top;
+    this._pointerOffset = i === "vertical" ? c - s : a - s;
   }
   _onContainerPointerUp(e) {
     this._swiping && (e.preventDefault(), this._positionChanged && (this.arcgisSwipeChange.emit(), this._positionChanged = !1), this._swiping = !1);
@@ -72,56 +272,56 @@ class z extends L {
     if (!this._swiping)
       return;
     e.preventDefault();
-    const { _pointerOffset: i, el: t, direction: r } = this, { clientX: o, clientY: n } = e, { top: c, left: s, width: a, height: l } = t.getBoundingClientRect(), f = r === "vertical" ? l : a, h = (r === "vertical" ? n - c - i : o - s - i) / f * 100;
-    this.position !== h && (this.position = h, this._positionChanged = !0, this.arcgisSwipeInput.emit());
+    const { _pointerOffset: i, el: r, direction: s } = this, { clientX: o, clientY: a } = e, { top: c, left: n, width: h, height: g } = r.getBoundingClientRect(), v = s === "vertical" ? g : h, u = (s === "vertical" ? a - c - i : o - n - i) / v * 100;
+    this.position !== u && (this.position = u, this._positionChanged = !0, this.arcgisSwipeInput.emit());
   }
   _getKeyPosition(e) {
-    const { key: i } = e, { position: t } = this, { max: r, min: o, step: n, stepMultiplier: c, direction: s } = this.viewModel, a = n * c;
-    if (["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown"].includes(i) && (e.preventDefault(), e.stopPropagation()), s === "vertical" ? i === "ArrowDown" || i === "ArrowRight" : i === "ArrowUp" || i === "ArrowRight") {
-      const p = e.shiftKey ? a : n;
-      return t + p;
+    const { key: i } = e, { position: r } = this, { max: s, min: o, step: a, stepMultiplier: c, direction: n } = this.viewModel, h = a * c;
+    if (["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown"].includes(i) && (e.preventDefault(), e.stopPropagation()), n === "vertical" ? i === "ArrowDown" || i === "ArrowRight" : i === "ArrowUp" || i === "ArrowRight") {
+      const _ = e.shiftKey ? h : a;
+      return r + _;
     }
-    if (s === "vertical" ? i === "ArrowUp" || i === "ArrowLeft" : i === "ArrowDown" || i === "ArrowLeft") {
-      const p = e.shiftKey ? a : n;
-      return t - p;
+    if (n === "vertical" ? i === "ArrowUp" || i === "ArrowLeft" : i === "ArrowDown" || i === "ArrowLeft") {
+      const _ = e.shiftKey ? h : a;
+      return r - _;
     }
-    return i === "Home" ? o : i === "End" ? r : (s === "vertical" ? i === "PageDown" : i === "PageUp") ? t + a : (s === "vertical" ? i === "PageUp" : i === "PageDown") ? t - a : null;
+    return i === "Home" ? o : i === "End" ? s : (n === "vertical" ? i === "PageDown" : i === "PageUp") ? r + h : (n === "vertical" ? i === "PageUp" : i === "PageDown") ? r - h : null;
   }
   _onContainerKeyDown(e) {
     const i = this._getKeyPosition(e);
     typeof i == "number" && this.position !== i && (this.position = i, this.arcgisSwipeInput.emit(), this.arcgisSwipeChange.emit());
   }
   render() {
-    const { state: e, direction: i } = this.viewModel, t = e === "disabled" || this.disabled, r = {
-      [m.disabled]: t,
-      disabled: t,
+    const { state: e, direction: i } = this.viewModel, r = e === "disabled" || this.disabled, s = {
+      [P.disabled]: r,
+      disabled: r,
       vertical: i === "vertical",
       horizontal: i === "horizontal"
     };
-    return d`<div class=${u(g("root", m.widget, r))}>${e === "disabled" ? null : this._renderContainer()}</div>`;
+    return y`<div class=${C(b("root", P.widget, s))}>${e === "disabled" ? null : this._renderContainer()}</div>`;
   }
   _renderHandle() {
-    const { direction: e } = this.viewModel, { hideHandle: i } = this, t = {
-      [b.dragHorizontal]: e === "vertical",
-      [b.dragVertical]: e === "horizontal"
-    }, r = g("handle", !!i && "handle-hidden");
-    return d`<div class=${u(r)} role=presentation><span aria-hidden=true class=${u(g("handle-icon", t))}></span></div>`;
+    const { direction: e } = this.viewModel, { hideHandle: i } = this, r = {
+      [$.dragHorizontal]: e === "vertical",
+      [$.dragVertical]: e === "horizontal"
+    }, s = b("handle", !!i && "handle-hidden");
+    return y`<div class=${C(s)} role=presentation><span aria-hidden=true class=${C(b("handle-icon", r))}></span></div>`;
   }
   _renderDivider() {
-    return this.hideDivider ? null : d`<div class="divider" role=presentation></div>`;
+    return this.hideDivider ? null : y`<div class="divider" role=presentation></div>`;
   }
   _renderContent() {
     return [this._renderDivider(), this._renderHandle()];
   }
   _renderContainer() {
-    const { disabled: e, viewModel: i } = this, { max: t, min: r, direction: o, position: n } = i, c = this.label ?? this.messages.dragLabel ?? "", s = `${n}%`, a = {
-      top: o === "vertical" ? s : void 0,
-      left: o === "vertical" ? void 0 : s
-    }, l = this._renderContent();
-    return e ? d`<div class="container" role=presentation style=${w(a)}>${l}</div>` : d`<div @pointerdown=${this._onContainerPointerDown} .ariaLabel=${c} .ariaOrientation=${o} .ariaValueMax=${`${t}`} .ariaValueMin=${`${r}`} .ariaValueNow=${`${n}`} .ariaValueText=${s} class="container" @keydown=${this._onContainerKeyDown} role=slider style=${w(a)} tabindex=0 title=${c ?? D} touch-action=none ${$(this._containerRef)}>${l}</div>`;
+    const { disabled: e, viewModel: i } = this, { max: r, min: s, direction: o, position: a } = i, c = this.label ?? this.messages.dragLabel ?? "", n = `${a}%`, h = {
+      top: o === "vertical" ? n : void 0,
+      left: o === "vertical" ? void 0 : n
+    }, g = this._renderContent();
+    return e ? y`<div class="container" role=presentation style=${D(h)}>${g}</div>` : y`<div @pointerdown=${this._onContainerPointerDown} .ariaLabel=${c} .ariaOrientation=${o} .ariaValueMax=${`${r}`} .ariaValueMin=${`${s}`} .ariaValueNow=${`${a}`} .ariaValueText=${n} class="container" @keydown=${this._onContainerKeyDown} role=slider style=${D(h)} tabindex=0 title=${c ?? E} touch-action=none ${H(this._containerRef)}>${g}</div>`;
   }
 }
-x("arcgis-swipe", z);
+z("arcgis-swipe", G);
 export {
-  z as ArcgisSwipe
+  G as ArcgisSwipe
 };

package/dist/components/arcgis-swipe/types.d.ts

@@ -0,0 +1,3 @@
+export type SwipeDirection = "horizontal" | "vertical";
+
+export type SwipeState = "disabled" | "ready";

package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/customElement.d.ts

@@ -9,9 +9,62 @@ import type { UtilityNetworkTraceResultItemState } from "../arcgis-utility-netwo
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
- * Trace result item for displaying [aggregated geometry](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#aggregatedGeometry) results from a trace.
+ * The Utility Network Trace Aggregated Geometry Result Item component displays the
+ * [aggregated geometry](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#aggregatedGeometry)
+ * returned by a utility network trace. It creates graphics for the result's line, multipoint, and polygon geometries
+ * and displays them in the view. Provides options to show or hide the graphics, change their color and size.
+ *
+ * Add this component directly to the default slot of [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/).
+ * The parent supplies the required read-only properties for the
+ * [trace result](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#traceResult) and
+ * [MapView](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#view).
+ *
+ * By default, the [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/) component displays the
+ * [aggregated geometry](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/),
+ * [elements](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/), and
+ * [functions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/) result items for the result types
+ * returned by the trace. Adding content to its default slot replaces all default result items. Add each result item
+ * that the custom configuration should display.
+ *
+ * By default, the component creates and manages a graphics layer. Set
+ * [graphicsLayer](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#graphicsLayer) to render the
+ * aggregated geometry graphics in an existing layer instead.
  *
  * @since 5.2
+ * @example
+ * The following example displays aggregated geometry in a custom set of trace result items.
+ * Providing result items in the default slot replaces the parent's default result items.
+ * This example displays only aggregated geometry results.
+ * ```html
+ * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+ *   <arcgis-utility-network-trace-analysis slot="bottom-left">
+ *     <arcgis-utility-network-trace-results slot="results">
+ *       <arcgis-utility-network-trace-aggregated-geometry-result-item>
+ *       </arcgis-utility-network-trace-aggregated-geometry-result-item>
+ *     </arcgis-utility-network-trace-results>
+ *   </arcgis-utility-network-trace-analysis>
+ * </arcgis-map>
+ * ```
+ * @example
+ * Customize the color and size of the aggregated geometry graphics. Setting `hide-graphics` initially hides the
+ * graphics from the map. Users can show them with the component's toggle.
+ * ```html
+ * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+ *   <arcgis-utility-network-trace-analysis slot="bottom-left">
+ *     <arcgis-utility-network-trace-results slot="results">
+ *       <arcgis-utility-network-trace-aggregated-geometry-result-item
+ *         graphics-color="rgba(0, 122, 194, 0.6)"
+ *         selection-size="8"
+ *         hide-graphics
+ *       ></arcgis-utility-network-trace-aggregated-geometry-result-item>
+ *     </arcgis-utility-network-trace-results>
+ *   </arcgis-utility-network-trace-analysis>
+ * </arcgis-map>
+ * ```
+ * @see [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/)
+ * @see [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/)
+ * @see [arcgis-utility-network-trace-elements-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/)
+ * @see [arcgis-utility-network-trace-functions-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/)
  * @see [Result types](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/configure-a-trace.html#DA5)
  */
 export abstract class ArcgisUtilityNetworkTraceAggregatedGeometryResultItem extends LitElement {
@@ -57,23 +110,39 @@ export abstract class ArcgisUtilityNetworkTraceAggregatedGeometryResultItem exte
    * @default false
    */
   get emitsArcgisResultReady(): true;
-  /** The graphics which represent the aggregated geometry results from the trace. */
+  /**
+   * The graphics created from the line, multipoint, and polygon geometries in the aggregated geometry result.
+   *
+   * Read this property after
+   * [@arcgisResultReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#event-arcgisResultReady) fires.
+   */
   get geometryGraphics(): Graphic[];
   /**
-   * The color used for the aggregated geometry graphics.
-   * Default value is #FFFF00.
+   * The color of the aggregated geometry graphics.
+   * The default is yellow with 0.6 opacity.
+   *
+   * @see [Color constructor](https://developers.arcgis.com/javascript/latest/references/core/Color/#constructors-summary)
    */
   accessor graphicsColor: Color;
   /**
-   * The layer used to render the graphics which represent the aggregated geometry result.
-   * If this property is not specified, a new layer will be created on the map.
+   * The layer used to render the aggregated geometry graphics.
+   *
+   * When the result is cleared or the component is destroyed:
+   *
+   * - If the layer is provided by the application, the component removes only the aggregated geometry graphics it
+   *   created. The layer and any other graphics remain unchanged.
+   * - If no layer is provided, the component creates and manages a layer. It removes the aggregated geometry graphics
+   *   and the component-owned layer from the map.
    */
   accessor graphicsLayer: GraphicsLayer | undefined;
-  /** The heading of the result item. */
+  /** The heading displayed above the aggregated geometry controls. */
   accessor heading: string | undefined;
   /**
-   * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics)
-   * from the map when the trace result contains aggregated geometry results.
+   * Whether to hide the aggregated geometry graphics from the map.
+   *
+   * When true, the graphics remain available through
+   * [geometryGraphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics) but are removed
+   * from the [graphicsLayer](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#graphicsLayer).
    *
    * @default false
    */
@@ -92,28 +161,36 @@ export abstract class ArcgisUtilityNetworkTraceAggregatedGeometryResultItem exte
       showGraphics?: string | undefined;
   };
   /**
-   * The size of the aggregated geometry graphics to render, in points.
+   * The marker size and line or polygon-outline width of the aggregated geometry graphics, in points.
+   * The default is 12.
    *
    * @default 12
    */
   accessor selectionSize: number;
   /**
-   * Whether the component has finished adding aggregated geometry graphics to the map.
+   * The processing state of the aggregated geometry result item: `"loading"` while processing a trace result and
+   * `"ready"` when no processing is in progress.
    *
    * @default "ready"
    */
   get state(): UtilityNetworkTraceResultItemState;
-  /** The trace result containing the aggregated geometry result to render graphics for. */
+  /** The trace result containing the aggregated geometry to display. */
   get traceResult(): TraceResult | undefined;
   /**
-   * The view associated with the component.
-   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-aggregated-geometry-result-item component will be associated with a map or scene component rather than using the `view` property.
+   * The MapView supplied by the parent [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/) component.
+   * Used to display the aggregated geometry graphics.
    */
   get view(): MapView | undefined;
   /**
    * Removes the aggregated geometry graphics from the
    * [graphicsLayer](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#graphicsLayer).
-   * If the layer was created by the component, it is also removed from the map.
+   * If the layer was created by the component, it is also removed from the map. The method clears
+   * [geometryGraphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics) and resets
+   * [state](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#state) to `"ready"`.
+   *
+   * This method does not clear the parent-provided
+   * [traceResult](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#traceResult) or emit
+   * [@arcgisResultReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#event-arcgisResultReady).
    */
   clearResult(): void;
   /** Permanently destroy the component. */
@@ -121,13 +198,16 @@ export abstract class ArcgisUtilityNetworkTraceAggregatedGeometryResultItem exte
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "hideGraphics" | "geometryGraphics" | "graphicsColor" | "selectionSize" | "state"; }>;
   /**
-   * Fires when the component finishes processing the aggregated geometry results.
+   * Fires when the component finishes processing the current trace result.
    *
-   * If the component has a valid trace result with aggregated geometry results, this fires
-   * when the aggregated geometry graphics have been added to the map.
+   * For a result with aggregated geometry, the event fires after the graphics are created and, unless
+   * [hideGraphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#hideGraphics) is `true`, added to
+   * the map. The event also fires when processing completes without graphics because the result, aggregated geometry,
+   * or map view is unavailable.
    *
-   * If the component does not have a valid map or trace result, this fires when the
-   * component has finished loading.
+   * Clearing a result with
+   * [clearResult()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#clearResult) does not emit this
+   * event.
    */
   readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {

package/dist/components/arcgis-utility-network-trace-analysis/customElement.d.ts

@@ -93,7 +93,6 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  * @slot
  * [results] - Slot for instances of [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/),
  * for displaying the results of one or more traces.
- * @internal
  * @since 5.0
  */
 export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {