@arcgis/toolkit 5.0.0-next.98 → 5.0.0

package/LICENSE.md

@@ -4,10 +4,14 @@ COPYRIGHT © Esri
 
 All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
 
-This material is licensed for use under the Esri Master License Agreement (MLA), and is bound by the terms of that agreement. You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.
+This material is licensed for use under the [Esri Master License Agreement (MLA)](https://www.esri.com/content/dam/esrisites/en-us/media/legal/ma-full/ma-full.pdf), and is bound by the terms of that agreement.
+You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.
 
-See use restrictions at http://www.esri.com/legal/pdfs/mla_e204_e300/english
+For additional information, contact:
+Environmental Systems Research Institute, Inc.
+Attn: Contracts and Legal Services Department
+380 New York Street
+Redlands, California, USA 92373
+USA
 
-For additional information, contact: Environmental Systems Research Institute, Inc. Attn: Contracts and Legal Services Department 380 New York Street Redlands, California, USA 92373 USA
-
-email: contracts@esri.com
+email: legal@esri.com

package/README.md

@@ -8,6 +8,5 @@ It is not intended to be used directly, but rather used as a dependency by other
 
 ## License
 
-COPYRIGHT © Esri
-
-This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package.
+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.

package/dist/array/index.cjs

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const mappedFind = (array, callback) => {
-  for (let i = 0; i < array.length; i++) {
+  const length = array.length;
+  for (let i = 0; i < length; ++i) {
     const value = callback(array[i], i);
     if (value != null) {
       return value ?? void 0;

package/dist/array/index.js

@@ -1,5 +1,6 @@
 const mappedFind = (array, callback) => {
-  for (let i = 0; i < array.length; i++) {
+  const length = array.length;
+  for (let i = 0; i < length; ++i) {
     const value = callback(array[i], i);
     if (value != null) {
       return value ?? void 0;

package/dist/dom/index.cjs

@@ -31,7 +31,7 @@ function getSlotAssignedElements(slot, selector) {
 }
 const classes = (...classes2) => {
   const effectiveClasses = [];
-  for (let i = 0; i < classes2.length; i++) {
+  for (let i = 0; i < classes2.length; ++i) {
     const arg = classes2[i];
     if (typeof arg === "string") {
       effectiveClasses.push(arg);

package/dist/dom/index.js

@@ -29,7 +29,7 @@ function getSlotAssignedElements(slot, selector) {
 }
 const classes = (...classes2) => {
   const effectiveClasses = [];
-  for (let i = 0; i < classes2.length; i++) {
+  for (let i = 0; i < classes2.length; ++i) {
     const arg = classes2[i];
     if (typeof arg === "string") {
       effectiveClasses.push(arg);

package/dist/dom/slots.d.cts

@@ -14,7 +14,7 @@ export declare function slotChangeHasContent(event: Event): boolean;
  * Returns a string of textContent if the target `slot` element from the `onSlotchange` event has any text content.
  *
  * @param event The event.
- * @returns {string} The slots text.
+ * @returns The slots text.
  *
  * @example
  * ```tsx
@@ -73,9 +73,9 @@ export declare function slotChangeHasAssignedElement(event: Event): boolean;
 /**
  * Returns the assigned elements on a `slot` element from the `onSlotchange` event.
  *
- * @param {Event} event The event.
- * @param {string} selector The CSS selector string to filter the returned elements by.
- * @returns {Element[]} An array of elements.
+ * @param event The event.
+ * @param selector The CSS selector string to filter the returned elements by.
+ * @returns An array of elements.
  *
  * @example
  * ```tsx
@@ -86,8 +86,8 @@ export declare function slotChangeGetAssignedElements<T extends Element>(event:
 /**
  * Returns the assigned elements on a `slot` element, filtered by an optional css selector.
  *
- * @param {HTMLSlotElement} slot The slot element.
- * @param {string} selector CSS selector string to filter the returned elements by.
- * @returns {Element[]} An array of elements.
+ * @param slot The slot element.
+ * @param selector CSS selector string to filter the returned elements by.
+ * @returns An array of elements.
  */
 export declare function getSlotAssignedElements<T extends Element>(slot: HTMLSlotElement, selector?: string): T[];

package/dist/dom/slots.d.ts

@@ -14,7 +14,7 @@ export declare function slotChangeHasContent(event: Event): boolean;
  * Returns a string of textContent if the target `slot` element from the `onSlotchange` event has any text content.
  *
  * @param event The event.
- * @returns {string} The slots text.
+ * @returns The slots text.
  *
  * @example
  * ```tsx
@@ -73,9 +73,9 @@ export declare function slotChangeHasAssignedElement(event: Event): boolean;
 /**
  * Returns the assigned elements on a `slot` element from the `onSlotchange` event.
  *
- * @param {Event} event The event.
- * @param {string} selector The CSS selector string to filter the returned elements by.
- * @returns {Element[]} An array of elements.
+ * @param event The event.
+ * @param selector The CSS selector string to filter the returned elements by.
+ * @returns An array of elements.
  *
  * @example
  * ```tsx
@@ -86,8 +86,8 @@ export declare function slotChangeGetAssignedElements<T extends Element>(event:
 /**
  * Returns the assigned elements on a `slot` element, filtered by an optional css selector.
  *
- * @param {HTMLSlotElement} slot The slot element.
- * @param {string} selector CSS selector string to filter the returned elements by.
- * @returns {Element[]} An array of elements.
+ * @param slot The slot element.
+ * @param selector CSS selector string to filter the returned elements by.
+ * @returns An array of elements.
  */
 export declare function getSlotAssignedElements<T extends Element>(slot: HTMLSlotElement, selector?: string): T[];

package/dist/log/index.d.cts

@@ -19,15 +19,15 @@ type LogOptions = {
 type EsriConfig = {
     log: {
         /**
-         * @link {https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html#LogInterceptor}
+         * @link {https://developers.arcgis.com/javascript/latest/references/core/config/#LogInterceptor}
          */
         interceptors?: ((level: LogLevel | "none", module: string, ...args: any[]) => void)[];
     };
 };
 /**
- * Workaround for setting {@link https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html#log log interceptors} and maintaining compatibility with {@link https://devtopia.esri.com/WebGIS/arcgis-websceneviewer-app/blob/8f0a1bbcf12d1193134d94589d9e187f0afa72fa/src/js/support/ApiLoggerInstrumentation.ts#L17 js-api's interceptor usage}.
+ * Workaround for setting {@link https://developers.arcgis.com/javascript/latest/references/core/config/#log log interceptors} and maintaining compatibility with {@link https://devtopia.esri.com/WebGIS/arcgis-websceneviewer-app/blob/8f0a1bbcf12d1193134d94589d9e187f0afa72fa/src/js/support/ApiLoggerInstrumentation.ts#L17 js-api's interceptor usage}.
  * @see {@link https://devtopia.esri.com/WebGIS/arcgis-js-api/discussions/74935}
- * @param config {@link https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html}
+ * @param config {@link https://developers.arcgis.com/javascript/latest/references/core/config/}
  * @example
  * ```ts
  * // IMPORTANT: do this only in config.ts or another early-loaded module

package/dist/log/index.d.ts

@@ -19,15 +19,15 @@ type LogOptions = {
 type EsriConfig = {
     log: {
         /**
-         * @link {https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html#LogInterceptor}
+         * @link {https://developers.arcgis.com/javascript/latest/references/core/config/#LogInterceptor}
          */
         interceptors?: ((level: LogLevel | "none", module: string, ...args: any[]) => void)[];
     };
 };
 /**
- * Workaround for setting {@link https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html#log log interceptors} and maintaining compatibility with {@link https://devtopia.esri.com/WebGIS/arcgis-websceneviewer-app/blob/8f0a1bbcf12d1193134d94589d9e187f0afa72fa/src/js/support/ApiLoggerInstrumentation.ts#L17 js-api's interceptor usage}.
+ * Workaround for setting {@link https://developers.arcgis.com/javascript/latest/references/core/config/#log log interceptors} and maintaining compatibility with {@link https://devtopia.esri.com/WebGIS/arcgis-websceneviewer-app/blob/8f0a1bbcf12d1193134d94589d9e187f0afa72fa/src/js/support/ApiLoggerInstrumentation.ts#L17 js-api's interceptor usage}.
  * @see {@link https://devtopia.esri.com/WebGIS/arcgis-js-api/discussions/74935}
- * @param config {@link https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html}
+ * @param config {@link https://developers.arcgis.com/javascript/latest/references/core/config/}
  * @example
  * ```ts
  * // IMPORTANT: do this only in config.ts or another early-loaded module

package/dist/string/index.cjs

@@ -72,9 +72,7 @@ const getMinorVersion = (version) => {
 };
 const getPreamble = (version) => (
   //#endregion getPreamble
-  `All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/${getMinorVersion(version)}/esri/copyright.txt for details.
-v${version}`
+  `COPYRIGHT Esri - https://js.arcgis.com/${getMinorVersion(version)}/LICENSE.txt`
 );
 const setValuesInString = (message, values = {}) => (message ?? "").replace(/\{(?<valueName>.*?)\}/gu, (match, valueName) => values[valueName] ?? match);
 exports.addLtrMark = addLtrMark;

package/dist/string/index.d.cts

@@ -42,7 +42,7 @@ export declare const quoteString: (value: string) => string;
  * Create a filter expression from a filter word.
  *
  * @remarks Once browser support permits, use `RegExp.escape()` instead.
- * @todo DEPRECATE
+ * @privateRemarks TODO: DEPRECATE
  */
 export declare const createFilterExpression: (filterWord: string) => RegExp;
 /**
@@ -88,12 +88,12 @@ export declare const getMinorVersion: (version: string) => string;
  * notice at the top of a file.
  * 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
  * @example
  * ```ts
- * const preamble = getPreamble("4.34.0-next.123");
- * // All material copyright Esri, All Rights Reserved, unless otherwise specified.
- * // See https://js.arcgis.com/4.34/esri/copyright.txt for details.
- * // v4.34.0-next.123
+ * const preamble = getPreamble("5.0.1-next.456");
+ * // COPYRIGHT Esri - https://js.arcgis.com/5.0/LICENSE.txt
  * ```
  */
 export declare const getPreamble: (version: string) => string;
@@ -101,6 +101,6 @@ export declare const getPreamble: (version: string) => string;
  * Replace values in a string using the format {valueName} with the value from the values object.
  * If the value is not found in the values object, then the value is not replaced.
  *
- * @deprecated Import from https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-intl.html#substitute instead
+ * @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;

package/dist/string/index.d.ts

@@ -42,7 +42,7 @@ export declare const quoteString: (value: string) => string;
  * Create a filter expression from a filter word.
  *
  * @remarks Once browser support permits, use `RegExp.escape()` instead.
- * @todo DEPRECATE
+ * @privateRemarks TODO: DEPRECATE
  */
 export declare const createFilterExpression: (filterWord: string) => RegExp;
 /**
@@ -88,12 +88,12 @@ export declare const getMinorVersion: (version: string) => string;
  * notice at the top of a file.
  * 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
  * @example
  * ```ts
- * const preamble = getPreamble("4.34.0-next.123");
- * // All material copyright Esri, All Rights Reserved, unless otherwise specified.
- * // See https://js.arcgis.com/4.34/esri/copyright.txt for details.
- * // v4.34.0-next.123
+ * const preamble = getPreamble("5.0.1-next.456");
+ * // COPYRIGHT Esri - https://js.arcgis.com/5.0/LICENSE.txt
  * ```
  */
 export declare const getPreamble: (version: string) => string;
@@ -101,6 +101,6 @@ export declare const getPreamble: (version: string) => string;
  * Replace values in a string using the format {valueName} with the value from the values object.
  * If the value is not found in the values object, then the value is not replaced.
  *
- * @deprecated Import from https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-intl.html#substitute instead
+ * @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;

package/dist/string/index.js

@@ -70,9 +70,7 @@ const getMinorVersion = (version) => {
 };
 const getPreamble = (version) => (
   //#endregion getPreamble
-  `All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/${getMinorVersion(version)}/esri/copyright.txt for details.
-v${version}`
+  `COPYRIGHT Esri - https://js.arcgis.com/${getMinorVersion(version)}/LICENSE.txt`
 );
 const setValuesInString = (message, values = {}) => (message ?? "").replace(/\{(?<valueName>.*?)\}/gu, (match, valueName) => values[valueName] ?? match);
 export {

package/dist/url/index.d.cts

@@ -13,6 +13,6 @@ export declare const hasSameOrigin: (url1: string | null | undefined, url2: stri
  * @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
- * @todo DEPRECATE
+ * @privateRemarks TODO: DEPRECATE
  */
 export declare const isURL: (url: string) => boolean;

package/dist/url/index.d.ts

@@ -13,6 +13,6 @@ export declare const hasSameOrigin: (url1: string | null | undefined, url2: stri
  * @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
- * @todo DEPRECATE
+ * @privateRemarks TODO: DEPRECATE
  */
 export declare const isURL: (url: string) => boolean;

package/package.json

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