@arcgis/toolkit 5.1.0-next.13 → 5.1.0-next.131

package/README.md

@@ -8,5 +8,5 @@ It is not intended to be used directly, but rather used as a dependency by other
 
 ## License
 
-This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.0/LICENSE.txt.
-For third party notices, see https://js.arcgis.com/5.0/third-party-notices.txt.
+This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.1/LICENSE.txt.
+For third party notices, see https://js.arcgis.com/5.1/third-party-notices.txt.

package/dist/dom/index.cjs

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const log_index = require("../log/index.cjs");
 function slotChangeHasContent(event) {
   return slotChangeHasAssignedElement(event) || slotChangeHasTextContent(event);
 }
@@ -29,6 +30,33 @@ function getSlotAssignedElements(slot, selector) {
   });
   return selector ? assignedElements.filter((element) => element.matches(selector)) : assignedElements;
 }
+const allowedTags = ["arcgis-map", "arcgis-scene", "arcgis-link-chart"];
+function resolveReferenceElement(component, referenceElementString) {
+  const referenceElement = referenceElementString ?? component.referenceElement;
+  if (typeof referenceElement !== "string") {
+    return referenceElement ?? void 0;
+  }
+  const isComplexSelector = referenceElement.includes("#") || referenceElement.includes(".") || referenceElement.includes("[");
+  const rootNode = component.el.getRootNode();
+  const resolved = (isComplexSelector ? void 0 : rootNode.querySelector(`#${referenceElement}`)) ?? rootNode.querySelector(referenceElement) ?? (isComplexSelector ? void 0 : getClosestElement(component.el, `#${referenceElement}`)) ?? getClosestElement(component.el, referenceElement);
+  if (resolved == null) {
+    log_index.log(
+      "error",
+      component,
+      `Expected property \`referenceElement\` to resolve to an <arcgis-map>, <arcgis-scene>, or <arcgis-link-chart> element, but no element matched \`${referenceElement}\`.`
+    );
+    return void 0;
+  }
+  if (!allowedTags.includes(resolved.localName)) {
+    log_index.log(
+      "error",
+      component,
+      `Expected property \`referenceElement\` to point to an <arcgis-map>, <arcgis-scene>, or <arcgis-link-chart> element, but instead found <${resolved?.localName}>.`,
+      { detail: { referenceElement, resolved } }
+    );
+  }
+  return resolved ?? void 0;
+}
 const classes = (...classes2) => {
   const effectiveClasses = [];
   for (let i = 0; i < classes2.length; ++i) {
@@ -117,7 +145,7 @@ const getClosestElement = (base, selector) => {
     if (rootElement === globalThis.document) {
       return;
     }
-    currentElement = rootElement.host;
+    currentElement = rootElement?.host;
   }
   return;
 };
@@ -186,6 +214,7 @@ exports.getClosestElement = getClosestElement;
 exports.getElementAttribute = getElementAttribute;
 exports.getSlotAssignedElements = getSlotAssignedElements;
 exports.observeAncestorsMutation = observeAncestorsMutation;
+exports.resolveReferenceElement = resolveReferenceElement;
 exports.setFocusOnElement = setFocusOnElement;
 exports.slotChangeGetAssignedElements = slotChangeGetAssignedElements;
 exports.slotChangeGetAssignedNodes = slotChangeGetAssignedNodes;

package/dist/dom/index.d.cts

@@ -1,5 +1,6 @@
 import { nil } from '../type/index.ts';
 export * from './slots.ts';
+export * from './reference-element.ts';
 /**
  * Combine multiple class names into a single string.
  *
@@ -37,7 +38,7 @@ export declare const observeAncestorsMutation: (element: Node, attributeFilter:
  * @returns The closest element that matches the selector or null if not found.
  *
  * @remarks
- * This is similar to [Element.closest()](https://developer.mozilla.org/en-US/docs/Web/API/Element/closest),
+ * This is similar to [Element.closest()](https://developer.mozilla.org/docs/Web/API/Element/closest),
  * but the DOM's utility only looks up until the first shadow boundary.
  *
  * @example

package/dist/dom/index.d.ts

@@ -1,5 +1,6 @@
 import { nil } from '../type/index.ts';
 export * from './slots.ts';
+export * from './reference-element.ts';
 /**
  * Combine multiple class names into a single string.
  *
@@ -37,7 +38,7 @@ export declare const observeAncestorsMutation: (element: Node, attributeFilter:
  * @returns The closest element that matches the selector or null if not found.
  *
  * @remarks
- * This is similar to [Element.closest()](https://developer.mozilla.org/en-US/docs/Web/API/Element/closest),
+ * This is similar to [Element.closest()](https://developer.mozilla.org/docs/Web/API/Element/closest),
  * but the DOM's utility only looks up until the first shadow boundary.
  *
  * @example

package/dist/dom/index.js

@@ -1,3 +1,4 @@
+import { log } from "../log/index.js";
 function slotChangeHasContent(event) {
   return slotChangeHasAssignedElement(event) || slotChangeHasTextContent(event);
 }
@@ -27,6 +28,33 @@ function getSlotAssignedElements(slot, selector) {
   });
   return selector ? assignedElements.filter((element) => element.matches(selector)) : assignedElements;
 }
+const allowedTags = ["arcgis-map", "arcgis-scene", "arcgis-link-chart"];
+function resolveReferenceElement(component, referenceElementString) {
+  const referenceElement = referenceElementString ?? component.referenceElement;
+  if (typeof referenceElement !== "string") {
+    return referenceElement ?? void 0;
+  }
+  const isComplexSelector = referenceElement.includes("#") || referenceElement.includes(".") || referenceElement.includes("[");
+  const rootNode = component.el.getRootNode();
+  const resolved = (isComplexSelector ? void 0 : rootNode.querySelector(`#${referenceElement}`)) ?? rootNode.querySelector(referenceElement) ?? (isComplexSelector ? void 0 : getClosestElement(component.el, `#${referenceElement}`)) ?? getClosestElement(component.el, referenceElement);
+  if (resolved == null) {
+    log(
+      "error",
+      component,
+      `Expected property \`referenceElement\` to resolve to an <arcgis-map>, <arcgis-scene>, or <arcgis-link-chart> element, but no element matched \`${referenceElement}\`.`
+    );
+    return void 0;
+  }
+  if (!allowedTags.includes(resolved.localName)) {
+    log(
+      "error",
+      component,
+      `Expected property \`referenceElement\` to point to an <arcgis-map>, <arcgis-scene>, or <arcgis-link-chart> element, but instead found <${resolved?.localName}>.`,
+      { detail: { referenceElement, resolved } }
+    );
+  }
+  return resolved ?? void 0;
+}
 const classes = (...classes2) => {
   const effectiveClasses = [];
   for (let i = 0; i < classes2.length; ++i) {
@@ -115,7 +143,7 @@ const getClosestElement = (base, selector) => {
     if (rootElement === globalThis.document) {
       return;
     }
-    currentElement = rootElement.host;
+    currentElement = rootElement?.host;
   }
   return;
 };
@@ -185,6 +213,7 @@ export {
   getElementAttribute,
   getSlotAssignedElements,
   observeAncestorsMutation,
+  resolveReferenceElement,
   setFocusOnElement,
   slotChangeGetAssignedElements,
   slotChangeGetAssignedNodes,

package/dist/dom/reference-element.d.cts

@@ -0,0 +1,6 @@
+type ArcgisComponentBase<T> = {
+    el: HTMLElement;
+    referenceElement?: T | string | null | undefined;
+};
+export declare function resolveReferenceElement<T extends Element>(component: ArcgisComponentBase<T>, referenceElementString?: ArcgisComponentBase<T>["referenceElement"] | string): T | undefined;
+export {};

package/dist/dom/reference-element.d.ts

@@ -0,0 +1,6 @@
+type ArcgisComponentBase<T> = {
+    el: HTMLElement;
+    referenceElement?: T | string | null | undefined;
+};
+export declare function resolveReferenceElement<T extends Element>(component: ArcgisComponentBase<T>, referenceElementString?: ArcgisComponentBase<T>["referenceElement"] | string): T | undefined;
+export {};

package/dist/intl/index.cjs

@@ -12,8 +12,10 @@ const supportedLocales = (
 const defaultLocale = "en";
 const localeEquivalencies = {
   //#region localeEquivalencies
-  // We use `pt-PT` as it will have the same translations as `pt`, which has no corresponding bundle
-  pt: "pt-PT",
+  // Locale equivalencies aligned with ArcGIS Maps SDK for JavaScript:
+  // https://developers.arcgis.com/javascript/latest/localization/#locale-support
+  // We resolve to `pt-BR` as it will have the same translations as `pt`, which has no corresponding bundle
+  pt: "pt-BR",
   // We support both 'nb' and 'no' (BCP 47) for Norwegian but only `no` has corresponding bundle
   nb: "no",
   // We support both 'nn' and 'no' (BCP 47) for Norwegian but only `no` has corresponding bundle

package/dist/intl/index.d.cts

@@ -65,6 +65,9 @@ export declare const getElementLocale: (element: HTMLElement) => {
  * Try to parse any language string into one of the locales supported by WebGIS SDK.
  *
  * @remarks
+ * Follows the ArcGIS Maps SDK for JavaScript locale support:
+ * https://developers.arcgis.com/javascript/latest/localization/#locale-support
+ *
  * If language includes a region code, but we don't have a bundle for it, the
  * language is normalized to the language code only.
  */

package/dist/intl/index.d.ts

@@ -65,6 +65,9 @@ export declare const getElementLocale: (element: HTMLElement) => {
  * Try to parse any language string into one of the locales supported by WebGIS SDK.
  *
  * @remarks
+ * Follows the ArcGIS Maps SDK for JavaScript locale support:
+ * https://developers.arcgis.com/javascript/latest/localization/#locale-support
+ *
  * If language includes a region code, but we don't have a bundle for it, the
  * language is normalized to the language code only.
  */

package/dist/intl/index.js

@@ -10,8 +10,10 @@ const supportedLocales = (
 const defaultLocale = "en";
 const localeEquivalencies = {
   //#region localeEquivalencies
-  // We use `pt-PT` as it will have the same translations as `pt`, which has no corresponding bundle
-  pt: "pt-PT",
+  // Locale equivalencies aligned with ArcGIS Maps SDK for JavaScript:
+  // https://developers.arcgis.com/javascript/latest/localization/#locale-support
+  // We resolve to `pt-BR` as it will have the same translations as `pt`, which has no corresponding bundle
+  pt: "pt-BR",
   // We support both 'nb' and 'no' (BCP 47) for Norwegian but only `no` has corresponding bundle
   nb: "no",
   // We support both 'nn' and 'no' (BCP 47) for Norwegian but only `no` has corresponding bundle

package/dist/log/index.cjs

@@ -33,6 +33,7 @@ const log = (level, context, message, options) => {
       if ((typeof value === "object" || typeof value === "function") && value !== null) {
         const weakRefValue = new WeakRef(value);
         Object.defineProperty(memorySafeDetail, key, {
+          enumerable: true,
           get() {
             return weakRefValue.deref();
           }

package/dist/log/index.js

@@ -31,6 +31,7 @@ const log = (level, context, message, options) => {
       if ((typeof value === "object" || typeof value === "function") && value !== null) {
         const weakRefValue = new WeakRef(value);
         Object.defineProperty(memorySafeDetail, key, {
+          enumerable: true,
           get() {
             return weakRefValue.deref();
           }

package/dist/promise/index.cjs

@@ -11,6 +11,20 @@ class Deferred {
     });
   }
 }
+async function forEachWithConcurrency(items, concurrency, callback) {
+  if (items.length === 0) {
+    return;
+  }
+  let index = 0;
+  async function consumeItems() {
+    while (index < items.length) {
+      const item = items[index];
+      index += 1;
+      await callback(item);
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, async () => await consumeItems()));
+}
 const devToolsAwareTimeout = (callback, timeout) => {
   const interval = timeout > longTimeoutThreshold ? longTimeoutInterval : timeout / shortTimeoutIntervals;
   let elapsed = 0;
@@ -28,3 +42,4 @@ const longTimeoutInterval = 2e3;
 const shortTimeoutIntervals = 4;
 exports.Deferred = Deferred;
 exports.devToolsAwareTimeout = devToolsAwareTimeout;
+exports.forEachWithConcurrency = forEachWithConcurrency;

package/dist/promise/index.d.cts

@@ -11,7 +11,7 @@
  *
  * @deprecated
  * If browser support permits, prefer using
- * [Promise.withResolvers()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers)
+ * [Promise.withResolvers()](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers)
  */
 export declare class Deferred<T> {
     /**
@@ -37,6 +37,20 @@ export interface Deferred<T> {
      */
     reject(_error: unknown): void;
 }
+/**
+ * Execute async callbacks against a list with a fixed number of in-flight
+ * operations.
+ * Useful for rate-limiting or to avoid overwhelming resources with too many concurrent operations.
+ *
+ * @example
+ * ```ts
+ * const items = [...lotsOfItems];
+ * await forEachWithConcurrency(items, 5, async (item) => {
+ *   await doSomethingAsync(item);
+ * });
+ * ```
+ */
+export declare function forEachWithConcurrency<T>(items: readonly T[], concurrency: number, callback: (item: T) => Promise<void>): Promise<void>;
 /**
  * Like setTimeout(), but does not advance the clock if the program is
  * stopped on a debugger breakpoint.

package/dist/promise/index.d.ts

@@ -11,7 +11,7 @@
  *
  * @deprecated
  * If browser support permits, prefer using
- * [Promise.withResolvers()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers)
+ * [Promise.withResolvers()](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers)
  */
 export declare class Deferred<T> {
     /**
@@ -37,6 +37,20 @@ export interface Deferred<T> {
      */
     reject(_error: unknown): void;
 }
+/**
+ * Execute async callbacks against a list with a fixed number of in-flight
+ * operations.
+ * Useful for rate-limiting or to avoid overwhelming resources with too many concurrent operations.
+ *
+ * @example
+ * ```ts
+ * const items = [...lotsOfItems];
+ * await forEachWithConcurrency(items, 5, async (item) => {
+ *   await doSomethingAsync(item);
+ * });
+ * ```
+ */
+export declare function forEachWithConcurrency<T>(items: readonly T[], concurrency: number, callback: (item: T) => Promise<void>): Promise<void>;
 /**
  * Like setTimeout(), but does not advance the clock if the program is
  * stopped on a debugger breakpoint.

package/dist/promise/index.js

@@ -9,6 +9,20 @@ class Deferred {
     });
   }
 }
+async function forEachWithConcurrency(items, concurrency, callback) {
+  if (items.length === 0) {
+    return;
+  }
+  let index = 0;
+  async function consumeItems() {
+    while (index < items.length) {
+      const item = items[index];
+      index += 1;
+      await callback(item);
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, async () => await consumeItems()));
+}
 const devToolsAwareTimeout = (callback, timeout) => {
   const interval = timeout > longTimeoutThreshold ? longTimeoutInterval : timeout / shortTimeoutIntervals;
   let elapsed = 0;
@@ -26,5 +40,6 @@ const longTimeoutInterval = 2e3;
 const shortTimeoutIntervals = 4;
 export {
   Deferred,
-  devToolsAwareTimeout
+  devToolsAwareTimeout,
+  forEachWithConcurrency
 };

package/dist/string/index.cjs

@@ -75,11 +75,39 @@ const getPreamble = (version) => (
   `COPYRIGHT Esri - https://js.arcgis.com/${getMinorVersion(version)}/LICENSE.txt`
 );
 const setValuesInString = (message, values = {}) => (message ?? "").replace(/\{(?<valueName>.*?)\}/gu, (match, valueName) => values[valueName] ?? match);
+const regionStartPattern = /^\s*\/\/\s*#region(?::)?\s*(?<regionName>.*?)\s*$/u;
+const regionAnyStartPattern = /^\s*\/\/\s*#region(?::)?\s*.*$/u;
+const regionEndPattern = /^\s*\/\/\s*#endregion(?::)?(?:\s+.*)?\s*$/u;
+const extractRegion = (source, regionName) => {
+  const lines = source.split(/\r?\n/gu);
+  const startLineIndex = lines.findIndex((line) => regionStartPattern.exec(line)?.groups?.regionName === regionName);
+  if (startLineIndex === -1) {
+    throw new Error(`Unable to locate source region "${regionName}".`);
+  }
+  let nestedRegionDepth = 0;
+  for (let lineIndex = startLineIndex + 1; lineIndex < lines.length; lineIndex++) {
+    const line = lines[lineIndex];
+    if (regionAnyStartPattern.test(line)) {
+      nestedRegionDepth++;
+      continue;
+    }
+    if (!regionEndPattern.test(line)) {
+      continue;
+    }
+    if (nestedRegionDepth > 0) {
+      nestedRegionDepth--;
+      continue;
+    }
+    return lines.slice(startLineIndex + 1, lineIndex).join("\n").trim();
+  }
+  throw new Error(`Unable to locate source region end for "${regionName}".`);
+};
 exports.addLtrMark = addLtrMark;
 exports.camelToHuman = camelToHuman;
 exports.camelToKebab = camelToKebab;
 exports.capitalize = capitalize;
 exports.createFilterExpression = createFilterExpression;
+exports.extractRegion = extractRegion;
 exports.generateGuid = generateGuid;
 exports.getMinorVersion = getMinorVersion;
 exports.getPreamble = getPreamble;

package/dist/string/index.d.cts

@@ -62,15 +62,18 @@ export declare const addLtrMark: (value: string | undefined) => string;
 export type UUID = ReturnType<typeof crypto.randomUUID>;
 /**
  * Generate a GUID string.
+ *
+ * If your component is using shadow root, the DOM element IDs do not need
+ * to be globally unique - IDs are scoped to the shadow root.
+ *
+ * Avoid using GUID and other non-deterministic output in render() as they
+ * cause SSR hydration issues and snapshot test instability.
+ *
  * @example
  * ```ts
  * const id = generateGuid();
  * // 00000000-0000-0000-0000-000000000000.
  * ```
- *
- * @remarks
- * If your component is using shadow root, the DOM element IDs do not need
- * to be globally unique.
  */
 export declare const generateGuid: () => UUID;
 /**
@@ -89,7 +92,7 @@ export declare const getMinorVersion: (version: string) => string;
  * The preamble text contains the version number and a link to the license.
  * The version number should normally come from package.json.
  *
- * @see https://webgis.esri.com/webgis/platform-guidelines/licensing
+ * @see https://webgis.esri.com/sdk/contributing/licensing
  * @example
  * ```ts
  * const preamble = getPreamble("5.0.1-next.456");
@@ -104,3 +107,24 @@ export declare const getPreamble: (version: string) => string;
  * @deprecated Import from https://next.gha.afd.arcgis.com/javascript/latest/references/core/intl/#substitute instead
  */
 export declare const setValuesInString: (message: string | null | undefined, values?: Record<string, string>) => string;
+/**
+ * Use `extractRegion` when you need to read a named `#region` block from a JavaScript/TypeScript source string,
+ * such as docs or MDX snippets that should stay in sync with the real implementation.
+ *
+ * Throws when the named region cannot be found or is missing its closing marker.
+ *
+ * @example
+ * ```ts
+ * import code from "my-code-file.ts?raw";
+ * const snippet = extractRegion(code, "myRegion");
+ *
+ * // where code is:
+ * `
+ * //#region myRegion
+ * const value = 1;
+ * //#endregion
+ * `
+ * // const value = 1;
+ * ```
+ */
+export declare const extractRegion: (source: string, regionName: string) => string;

package/dist/string/index.d.ts

@@ -62,15 +62,18 @@ export declare const addLtrMark: (value: string | undefined) => string;
 export type UUID = ReturnType<typeof crypto.randomUUID>;
 /**
  * Generate a GUID string.
+ *
+ * If your component is using shadow root, the DOM element IDs do not need
+ * to be globally unique - IDs are scoped to the shadow root.
+ *
+ * Avoid using GUID and other non-deterministic output in render() as they
+ * cause SSR hydration issues and snapshot test instability.
+ *
  * @example
  * ```ts
  * const id = generateGuid();
  * // 00000000-0000-0000-0000-000000000000.
  * ```
- *
- * @remarks
- * If your component is using shadow root, the DOM element IDs do not need
- * to be globally unique.
  */
 export declare const generateGuid: () => UUID;
 /**
@@ -89,7 +92,7 @@ export declare const getMinorVersion: (version: string) => string;
  * The preamble text contains the version number and a link to the license.
  * The version number should normally come from package.json.
  *
- * @see https://webgis.esri.com/webgis/platform-guidelines/licensing
+ * @see https://webgis.esri.com/sdk/contributing/licensing
  * @example
  * ```ts
  * const preamble = getPreamble("5.0.1-next.456");
@@ -104,3 +107,24 @@ export declare const getPreamble: (version: string) => string;
  * @deprecated Import from https://next.gha.afd.arcgis.com/javascript/latest/references/core/intl/#substitute instead
  */
 export declare const setValuesInString: (message: string | null | undefined, values?: Record<string, string>) => string;
+/**
+ * Use `extractRegion` when you need to read a named `#region` block from a JavaScript/TypeScript source string,
+ * such as docs or MDX snippets that should stay in sync with the real implementation.
+ *
+ * Throws when the named region cannot be found or is missing its closing marker.
+ *
+ * @example
+ * ```ts
+ * import code from "my-code-file.ts?raw";
+ * const snippet = extractRegion(code, "myRegion");
+ *
+ * // where code is:
+ * `
+ * //#region myRegion
+ * const value = 1;
+ * //#endregion
+ * `
+ * // const value = 1;
+ * ```
+ */
+export declare const extractRegion: (source: string, regionName: string) => string;

package/dist/string/index.js

@@ -73,12 +73,40 @@ const getPreamble = (version) => (
   `COPYRIGHT Esri - https://js.arcgis.com/${getMinorVersion(version)}/LICENSE.txt`
 );
 const setValuesInString = (message, values = {}) => (message ?? "").replace(/\{(?<valueName>.*?)\}/gu, (match, valueName) => values[valueName] ?? match);
+const regionStartPattern = /^\s*\/\/\s*#region(?::)?\s*(?<regionName>.*?)\s*$/u;
+const regionAnyStartPattern = /^\s*\/\/\s*#region(?::)?\s*.*$/u;
+const regionEndPattern = /^\s*\/\/\s*#endregion(?::)?(?:\s+.*)?\s*$/u;
+const extractRegion = (source, regionName) => {
+  const lines = source.split(/\r?\n/gu);
+  const startLineIndex = lines.findIndex((line) => regionStartPattern.exec(line)?.groups?.regionName === regionName);
+  if (startLineIndex === -1) {
+    throw new Error(`Unable to locate source region "${regionName}".`);
+  }
+  let nestedRegionDepth = 0;
+  for (let lineIndex = startLineIndex + 1; lineIndex < lines.length; lineIndex++) {
+    const line = lines[lineIndex];
+    if (regionAnyStartPattern.test(line)) {
+      nestedRegionDepth++;
+      continue;
+    }
+    if (!regionEndPattern.test(line)) {
+      continue;
+    }
+    if (nestedRegionDepth > 0) {
+      nestedRegionDepth--;
+      continue;
+    }
+    return lines.slice(startLineIndex + 1, lineIndex).join("\n").trim();
+  }
+  throw new Error(`Unable to locate source region end for "${regionName}".`);
+};
 export {
   addLtrMark,
   camelToHuman,
   camelToKebab,
   capitalize,
   createFilterExpression,
+  extractRegion,
   generateGuid,
   getMinorVersion,
   getPreamble,

package/dist/type/index.d.cts

@@ -4,7 +4,7 @@
  */
 export type nil = null | undefined;
 /**
- * @deprecated Import from `__esri.IHandle` instead
+ * @deprecated import type { ResourceHandle } from "@arcgis/core/core/Handles.js";
  */
 export type IHandle = {
     remove: () => void;
@@ -18,7 +18,7 @@ export type Nil = nil;
  * This complements the TypeScript's `satisfies` operator.
  *
  * See usage examples:
- * https://webgis.esri.com/webgis/additional-resources/typescript-tips#use-satisfies-operator-for-type-tests
+ * https://webgis.esri.com/sdk/resources/typescript-tips#use-satisfies-operator-for-type-tests
  *
  * During production end-application build, such type tests will be removed as
  * they have no runtime impact.

package/dist/type/index.d.ts

@@ -4,7 +4,7 @@
  */
 export type nil = null | undefined;
 /**
- * @deprecated Import from `__esri.IHandle` instead
+ * @deprecated import type { ResourceHandle } from "@arcgis/core/core/Handles.js";
  */
 export type IHandle = {
     remove: () => void;
@@ -18,7 +18,7 @@ export type Nil = nil;
  * This complements the TypeScript's `satisfies` operator.
  *
  * See usage examples:
- * https://webgis.esri.com/webgis/additional-resources/typescript-tips#use-satisfies-operator-for-type-tests
+ * https://webgis.esri.com/sdk/resources/typescript-tips#use-satisfies-operator-for-type-tests
  *
  * During production end-application build, such type tests will be removed as
  * they have no runtime impact.

package/dist/url/index.d.cts

@@ -12,7 +12,7 @@ export declare const hasSameOrigin: (url1: string | null | undefined, url2: stri
  * @param url The url string to test
  * @returns True if the string is a URL.
  *
- * @remarks If browser support permits, use https://developer.mozilla.org/en-US/docs/Web/API/URL/parse_static instead
+ * @remarks If browser support permits, use https://developer.mozilla.org/docs/Web/API/URL/parse_static instead
  * @privateRemarks TODO: DEPRECATE
  */
 export declare const isURL: (url: string) => boolean;

package/dist/url/index.d.ts

@@ -12,7 +12,7 @@ export declare const hasSameOrigin: (url1: string | null | undefined, url2: stri
  * @param url The url string to test
  * @returns True if the string is a URL.
  *
- * @remarks If browser support permits, use https://developer.mozilla.org/en-US/docs/Web/API/URL/parse_static instead
+ * @remarks If browser support permits, use https://developer.mozilla.org/docs/Web/API/URL/parse_static instead
  * @privateRemarks TODO: DEPRECATE
  */
 export declare const isURL: (url: string) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/toolkit",
-  "version": "5.1.0-next.13",
+  "version": "5.1.0-next.131",
   "description": "Collection of common internal patterns and utilities for ArcGIS Maps SDK for JavaScript components.",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "sideEffects": false,