@arcgis/map-components 5.1.0-next.12 → 5.1.0-next.120

package/dist/components/arcgis-value-picker-collection/customElement.d.ts

@@ -0,0 +1,113 @@
+/// <reference path="../../index.d.ts" />
+import type Collection from "@arcgis/core/core/Collection.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+
+export abstract class ArcgisValuePickerCollection 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()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-collection/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * Determines whether the user can interact with the next button.
+   * This property is automatically set to `false` when [currentValue](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-collection/#currentValue) matches the last index of
+   * [items](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-collection/#items).
+   *
+   * @default false
+   * @example
+   * ```js
+   * const valuePicker = document.querySelector("arcgis-value-picker");
+   * const valuePickerCollection = document.querySelector("arcgis-value-picker-collection");
+   *
+   * const collection = new Collection([
+   *   { name: "Isaac Newton", dob: new Date(1643, 0, 4)},
+   *   { name: "Albert Einstein", dob: new Date(1879, 2, 14)},
+   *   { name: "Ernest Rutherford", dob: new Date(1871, 7, 20)}
+   * ]);
+   * valuePickerCollection.items = collection;
+   * valuePickerCollection.currentValue = valuePickerCollection.items.at(0);
+   * if (valuePickerCollection.canNext === true) {
+   *   valuePicker.next();
+   *   console.log(valuePickerCollection.currentValue.name); // "Albert Einstein"
+   * }
+   * ```
+   */
+  accessor canNext: boolean;
+  /**
+   * Determines whether the user can interact with the play/pause button.
+   *
+   * @default false
+   */
+  accessor canPlay: boolean;
+  /**
+   * Determines whether the user can interact with the previous button.
+   * This property is automatically set to `false` when [currentValue](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-collection/#currentValue) matches the first index of
+   * [items](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-collection/#items).
+   *
+   * @default false
+   * @example
+   * ```js
+   * const valuePicker = document.querySelector("arcgis-value-picker");
+   * const valuePickerCollection = document.querySelector("arcgis-value-picker-collection");
+   *
+   * const collection = new Collection([
+   *   { name: "Isaac Newton", dob: new Date(1643, 0, 4)},
+   *   { name: "Albert Einstein", dob: new Date(1879, 2, 14)},
+   *   { name: "Ernest Rutherford", dob: new Date(1871, 7, 20)}
+   * ]);
+   * valuePickerCollection.items = collection;
+   * valuePickerCollection.currentValue = valuePickerCollection.items.at(1);
+   * if (valuePickerCollection.canPrevious === true) {
+   *   valuePicker.previous();
+   *   console.log(valuePickerCollection.currentValue.name); // "Isaac Newton"
+   * }
+   * ```
+   */
+  accessor canPrevious: boolean;
+  /**
+   * The currently selected collection item. Note that because the type of [items](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-collection/#items) is a
+   * [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of any shape, this component
+   * identifies `currentValue` by reference rather than matching a field that may not always be present. Ensure that `currentValue` is always
+   * assigned from an existing element within `items`.
+   *
+   * @example
+   * ```js
+   * const valuePickerCollection = document.querySelector("arcgis-value-picker-collection");
+   *
+   * const collection = new Collection([
+   *   { name: "Isaac Newton", dob: new Date(1643, 0, 4)},
+   *   { name: "Albert Einstein", dob: new Date(1879, 2, 14)},
+   *   { name: "Ernest Rutherford", dob: new Date(1871, 7, 20)}
+   * ]);
+   * valuePickerCollection.items = collection;
+   *
+   * // 3 different approaches to setting currentValue
+   *
+   * // Acceptable. currentValue is a reference to items
+   * valuePickerCollection.currentValue = valuePickerCollection.items.at(0);
+   *
+   * // Acceptable. currentValue is assigned to the element at the index of items returned by find()
+   * valuePickerCollection.currentValue = valuePickerCollection.items.find(
+   *   ({ name }) => name === "Albert Einstein"
+   * );
+   *
+   * // Invalid. The component has no mechanism to predict which field should be used to match this property to an index.
+   * valuePickerCollection.currentValue = { name: "Isaac Newton", dob: new Date(1643, 0, 4) };
+   * ```
+   */
+  accessor currentValue: unknown | undefined;
+  /** The collection of arbitrary items that [arcgis-value-picker](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker/) can iterate over. */
+  accessor items: Collection | 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. */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "canNext" | "canPlay" | "canPrevious" | "currentValue"; }>;
+  readonly "@eventTypes": {
+    arcgisPropertyChange: ArcgisValuePickerCollection["arcgisPropertyChange"]["detail"];
+  };
+}

package/dist/components/arcgis-value-picker-collection/customElement.js

@@ -0,0 +1,43 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { c as s } from "../../chunks/runtime.js";
+import { LitElement as i } from "@arcgis/lumina";
+import { usePropertyChange as a } from "@arcgis/lumina/controllers";
+class r extends i {
+  constructor() {
+    super(...arguments), this.autoDestroyDisabled = !1, this.canNext = !1, this.canPlay = !1, this.canPrevious = !1, this.arcgisPropertyChange = a()("canNext", "canPlay", "canPrevious", "currentValue");
+  }
+  static {
+    this.properties = { autoDestroyDisabled: 5, items: 0, currentValue: 0, canNext: 5, canPlay: 5, canPrevious: 5 };
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  reset() {
+    this.currentValue = this.items?.at(0);
+  }
+  step(t) {
+    if (!this.items || !this.currentValue)
+      return;
+    const e = this.items.indexOf(this.currentValue) + (t === "next" ? 1 : -1);
+    e >= this.items.length || e < 0 || (this.currentValue = this.items.at(e), this._checkState());
+  }
+  connectedCallback() {
+    super.connectedCallback(), this.el.hidden = !0;
+  }
+  willUpdate(t) {
+    (t.has("currentValue") || t.has("items")) && this.items?.length && (this.currentValue ??= this.items.at(0)), this._checkState();
+  }
+  _checkState() {
+    if (!this.items?.length) {
+      this.canPlay = !1, this.canNext = !1, this.canPrevious = !1;
+      return;
+    }
+    this.canPlay = !0;
+    const t = this.items.indexOf(this.currentValue);
+    this.canNext = t >= 0 && t < this.items.length - 1, this.canPrevious = t > 0;
+  }
+}
+s("arcgis-value-picker-collection", r);
+export {
+  r as ArcgisValuePickerCollection
+};

package/dist/components/arcgis-value-picker-collection/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-value-picker-collection/index.js

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-value-picker-combobox/customElement.d.ts

@@ -0,0 +1,90 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ComboboxItem } from "../arcgis-value-picker/types.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+export abstract class ArcgisValuePickerCombobox 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()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-combobox/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * Determines whether the user can interact with the next button.
+   * This property is automatically set to `false` when [currentValue](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-combobox/#currentValue) matches the last index of
+   * [items](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-combobox/#items).
+   *
+   * @default false
+   * @example
+   * ```js
+   * const valuePicker = document.querySelector("arcgis-value-picker");
+   * const valuePickerCombobox = document.querySelector("arcgis-value-picker-combobox");
+   *
+   * valuePickerCombobox.items = [
+   *   { value: "ind", label: "Industrial" },
+   *   { value: "res", label: "Residential" },
+   *   { value: "com", label: "Commercial" }
+   * ];
+   * valuePickerCombobox.currentValue = valuePickerCombobox.items[0];
+   * if (valuePickerCombobox.canNext === true) {
+   *   valuePicker.next();
+   *   console.log(valuePickerCombobox.currentValue.label); // "Residential"
+   * }
+   * ```
+   */
+  accessor canNext: boolean;
+  /**
+   * Determines whether the user can interact with the play/pause button.
+   *
+   * @default false
+   */
+  accessor canPlay: boolean;
+  /**
+   * Determines whether the user can interact with the previous button.
+   * This property is automatically set to `false` when [currentValue](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-combobox/#currentValue) matches the first index of
+   * [items](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-combobox/#items).
+   *
+   * @default false
+   * @example
+   * ```js
+   * const valuePicker = document.querySelector("arcgis-value-picker");
+   * const valuePickerCombobox = document.querySelector("arcgis-value-picker-combobox");
+   *
+   * valuePickerCombobox.items = [
+   *   { value: "ind", label: "Industrial" },
+   *   { value: "res", label: "Residential" },
+   *   { value: "com", label: "Commercial" }
+   * ];
+   * valuePickerCombobox.currentValue = valuePickerCombobox.items[1];
+   * if (valuePickerCombobox.canPrevious === true) {
+   *   valuePicker.previous();
+   *   console.log(valuePickerCombobox.currentValue.label); // "Industrial"
+   * }
+   * ```
+   */
+  accessor canPrevious: boolean;
+  /** The currently selected combobox item rendered by the component. */
+  accessor currentValue: ComboboxItem | undefined;
+  /**
+   * When true, the component is visually withdrawn and cannot receive user interaction.
+   *
+   * @default false
+   */
+  accessor disabled: boolean;
+  /** The array of combobox items that [arcgis-value-picker](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker/) can iterate over. */
+  accessor items: ComboboxItem[] | undefined;
+  /** @internal */
+  protected messages: { comboboxLabel: string; } & T9nMeta<{ comboboxLabel: string; }>;
+  /** 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: import("@arcgis/lumina").TargetedEvent<this, { name: "canNext" | "canPlay" | "canPrevious" | "currentValue"; }>;
+  readonly "@eventTypes": {
+    arcgisPropertyChange: ArcgisValuePickerCombobox["arcgisPropertyChange"]["detail"];
+  };
+}

package/dist/components/arcgis-value-picker-combobox/customElement.js

@@ -0,0 +1,55 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { c as l } from "../../chunks/runtime.js";
+import { LitElement as r } from "@arcgis/lumina";
+import { css as n, html as a } from "lit";
+import { usePropertyChange as o } from "@arcgis/lumina/controllers";
+import { u as h } from "../../chunks/useT9n.js";
+const u = n`:host{align-items:center;display:flex;flex:auto;min-width:300px;padding-inline:var(--calcite-space-sm);--calcite-color-border-input: var(--calcite-color-border-3)}calcite-combobox{flex:auto;width:var(--calcite-space-none)}`;
+class m extends r {
+  constructor() {
+    super(...arguments), this.messages = h({ blocking: !0 }), this.autoDestroyDisabled = !1, this.disabled = !1, this.canNext = !1, this.canPlay = !1, this.canPrevious = !1, this.arcgisPropertyChange = o()("canNext", "canPlay", "canPrevious", "currentValue");
+  }
+  static {
+    this.properties = { autoDestroyDisabled: 5, disabled: 5, items: 0, currentValue: 0, canNext: 5, canPlay: 5, canPrevious: 5 };
+  }
+  static {
+    this.styles = u;
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  reset() {
+    this.currentValue = this.items?.[0];
+  }
+  step(e) {
+    if (!this.items || !this.currentValue)
+      return;
+    const s = this.items.findIndex(({ value: c }) => c === this.currentValue?.value) + (e === "next" ? 1 : -1);
+    s >= this.items.length || s < 0 || (this.currentValue = this.items[s], this._checkState());
+  }
+  connectedCallback() {
+    super.connectedCallback(), this.el.hidden = !0;
+  }
+  willUpdate(e) {
+    (e.has("currentValue") || e.has("items")) && this.items?.length && (this.currentValue ??= this.items[0]), this.el.hidden = !this.items?.length, this._checkState();
+  }
+  _checkState() {
+    if (!this.items?.length) {
+      this.canPlay = !1, this.canNext = !1, this.canPrevious = !1;
+      return;
+    }
+    this.canPlay = !0;
+    const e = this.items.findIndex(({ value: t }) => t === this.currentValue?.value);
+    this.canNext = e < this.items.length - 1, this.canPrevious = e > 0;
+  }
+  render() {
+    return a`<calcite-combobox .disabled=${this.disabled} selection-mode=single .label=${this.messages.comboboxLabel} @calciteComboboxChange=${({ currentTarget: e }) => {
+      const t = e.selectedItems[0]?.value;
+      this.currentValue = this.items?.find(({ value: i }) => i === t), this._checkState();
+    }}>${this.items?.map((e) => a`<calcite-combobox-item .value=${e.value} .heading=${e.label} .selected=${e.value === this.currentValue?.value}></calcite-combobox-item>`)}</calcite-combobox>`;
+  }
+}
+l("arcgis-value-picker-combobox", m);
+export {
+  m as ArcgisValuePickerCombobox
+};

package/dist/components/arcgis-value-picker-combobox/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-value-picker-combobox/index.js

@@ -0,0 +1,3 @@
+import "@esri/calcite-components/components/calcite-combobox";
+import "@esri/calcite-components/components/calcite-combobox-item";
+export * from "./customElement.js";

package/dist/components/arcgis-value-picker-label/customElement.d.ts

@@ -0,0 +1,81 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { LabelItem } from "../arcgis-value-picker/types.js";
+
+export abstract class ArcgisValuePickerLabel 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()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-label/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * Determines whether the user can interact with the next button.
+   * This property is automatically set to `false` when [currentValue](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-label/#currentValue) matches the last index of
+   * [items](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-label/#items).
+   *
+   * @default false
+   * @example
+   * ```js
+   * const valuePicker = document.querySelector("arcgis-value-picker");
+   * const valuePickerLabel = document.querySelector("arcgis-value-picker-label");
+   *
+   * valuePickerLabel.items = [
+   *   { value: "90606", label: "Whittier, CA (90606)" },
+   *   { value: "76001", label: "Arlington, TX (76001)" },
+   *   { value: "92335", label: "Fontana, CA (92335)" }
+   * ];
+   * valuePickerLabel.currentValue = valuePickerLabel.items[0];
+   * if (valuePickerLabel.canNext === true) {
+   *   valuePicker.next();
+   *   console.log(valuePickerLabel.currentValue.label); // "Arlington, TX (76001)"
+   * }
+   * ```
+   */
+  accessor canNext: boolean;
+  /**
+   * Determines whether the user can interact with the play/pause button.
+   *
+   * @default false
+   */
+  accessor canPlay: boolean;
+  /**
+   * Determines whether the user can interact with the previous button.
+   * This property is automatically set to `false` when [currentValue](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-label/#currentValue) matches the first index of
+   * [items](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-label/#items).
+   *
+   * @default false
+   * @example
+   * ```js
+   * const valuePicker = document.querySelector("arcgis-value-picker");
+   * const valuePickerLabel = document.querySelector("arcgis-value-picker-label");
+   *
+   * valuePickerLabel.items = [
+   *   { value: "90606", label: "Whittier, CA (90606)" },
+   *   { value: "76001", label: "Arlington, TX (76001)" },
+   *   { value: "92335", label: "Fontana, CA (92335)" }
+   * ];
+   * valuePickerLabel.currentValue = valuePickerLabel.items[1];
+   * if (valuePickerLabel.canPrevious === true) {
+   *   valuePicker.previous();
+   *   console.log(valuePickerLabel.currentValue.label); // "Whittier, CA (90606)"
+   * }
+   * ```
+   */
+  accessor canPrevious: boolean;
+  /** The currently selected label item rendered by the component. */
+  accessor currentValue: LabelItem | undefined;
+  /** The array of label items that [arcgis-value-picker](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker/) can iterate over. */
+  accessor items: LabelItem[] | 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. */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "canNext" | "canPlay" | "canPrevious" | "currentValue"; }>;
+  readonly "@eventTypes": {
+    arcgisPropertyChange: ArcgisValuePickerLabel["arcgisPropertyChange"]["detail"];
+  };
+}

package/dist/components/arcgis-value-picker-label/customElement.js

@@ -0,0 +1,51 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { c as a } from "../../chunks/runtime.js";
+import { LitElement as r } from "@arcgis/lumina";
+import { css as n, html as c } from "lit";
+import { usePropertyChange as l } from "@arcgis/lumina/controllers";
+const o = n`:host{display:flex;flex:auto;min-width:300px;padding:var(--calcite-space-sm)}.container{align-items:center;border:solid 1px var(--calcite-color-border-3);display:flex;flex:auto;padding-inline:var(--calcite-space-sm)}.text{color:var(--calcite-color-text-1);flex:auto;font-family:inherit;font-size:var(--calcite-font-size--1);font-weight:var(--calcite-font-weight-normal);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;width:var(--calcite-space-none)}`;
+class h extends r {
+  constructor() {
+    super(...arguments), this.autoDestroyDisabled = !1, this.canNext = !1, this.canPlay = !1, this.canPrevious = !1, this.arcgisPropertyChange = l()("canNext", "canPlay", "canPrevious", "currentValue");
+  }
+  static {
+    this.properties = { autoDestroyDisabled: 5, items: 0, currentValue: 0, canNext: 5, canPlay: 5, canPrevious: 5 };
+  }
+  static {
+    this.styles = o;
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  reset() {
+    this.currentValue = this.items?.[0];
+  }
+  step(e) {
+    if (!this.items || !this.currentValue)
+      return;
+    const t = this.items.findIndex(({ value: s }) => s === this.currentValue?.value) + (e === "next" ? 1 : -1);
+    t >= this.items.length || t < 0 || (this.currentValue = this.items[t], this._checkState());
+  }
+  connectedCallback() {
+    super.connectedCallback(), this.el.hidden = !0;
+  }
+  willUpdate(e) {
+    (e.has("currentValue") || e.has("items")) && this.items?.length && !this.currentValue && (this.currentValue = this.items[0]), this.el.hidden = !this.items?.length, this._checkState();
+  }
+  _checkState() {
+    if (!this.items?.length) {
+      this.canPlay = !1, this.canNext = !1, this.canPrevious = !1;
+      return;
+    }
+    this.canPlay = !0;
+    const e = this.items.findIndex(({ value: i }) => i === this.currentValue?.value);
+    this.canNext = e < this.items.length - 1, this.canPrevious = e > 0;
+  }
+  render() {
+    return c`<div class="container"><div class="text">${this.currentValue?.label}</div></div>`;
+  }
+}
+a("arcgis-value-picker-label", h);
+export {
+  h as ArcgisValuePickerLabel
+};

package/dist/components/arcgis-value-picker-label/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-value-picker-label/index.js

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-value-picker-legacy/customElement.d.ts

@@ -34,7 +34,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * It is important to note that the Value Picker component is not associated with a [View](https://developers.arcgis.com/javascript/latest/references/core/views/View/) nor does it
  * necessarily require data.
  *
- * ![option-nodata](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/valuepicker/option-nodata.png)
+ * ![option-nodata](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/valuepicker/option-nodata.avif)
  *
  * ```html
  * <arcgis-map itemId="462c629e8e604c15baf45627c4f337d6">
@@ -58,7 +58,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * Consider using the [label component](https://developers.arcgis.com/javascript/latest/references/core/widgets/ValuePicker/ValuePickerLabel/) to step through a fixed list of predefined values like land use zones.
  * In the following snippet a Value Picker component is created containing three coded land use zones.
  *
- * ![option-labels](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/valuepicker/option-labels.png)
+ * ![option-labels](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/valuepicker/option-labels.avif)
  *
  * ```js
  * const ValuePickerLabel = (await import("@arcgis/core/widgets/ValuePicker/ValuePickerLabel.js")).default;
@@ -103,7 +103,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * initialized with starting value of "topo-vector". Since "topo-vector" is the first item in the collection, only the _next_
  * button will be enabled.
  *
- * ![option-collection](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/valuepicker/option-collection.png)
+ * ![option-collection](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/valuepicker/option-collection.avif)
  *
  * ```js
  * const Collection = (await import("@arcgis/core/core/Collection.js")).default;
@@ -138,7 +138,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * Consider using the [combobox component](https://developers.arcgis.com/javascript/latest/references/core/widgets/ValuePicker/ValuePickerCombobox/) when a searchable
  * dropdown list is required. In the following snippet the Value Picker component is created containing three coded land use zones.
  *
- * ![option-combobox](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/valuepicker/option-combobox.png)
+ * ![option-combobox](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/valuepicker/option-combobox.avif)
  *
  * ```js
  * const ValuePickerCombobox = (await import("@arcgis/core/widgets/ValuePicker/ValuePickerCombobox.js")).default;
@@ -178,7 +178,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * for users that need to select a value within a fixed numeric range. For example, the snippet below presents a
  * Value Picker with a slider for picking a layer's opacity. The starting value is 50%.
  *
- * ![option-slider](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/valuepicker/option-slider.png)
+ * ![option-slider](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/valuepicker/option-slider.avif)
  *
  * ```js
  * const ValuePickerSlider = (await import("@arcgis/core/widgets/ValuePicker/ValuePickerSlider.js")).default;