@arcgis/toolkit 5.2.0-next.9 → 5.2.0-next.91

package/package.json

@@ -1,71 +1,26 @@
 {
   "name": "@arcgis/toolkit",
-  "version": "5.2.0-next.9",
+  "version": "5.2.0-next.91",
   "description": "Collection of common internal patterns and utilities for ArcGIS Maps SDK for JavaScript components.",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "sideEffects": false,
   "type": "module",
   "exports": {
-    "./array": {
-      "types": "./dist/array/index.d.ts",
-      "import": "./dist/array/index.js",
-      "require": "./dist/array/index.cjs"
-    },
-    "./dom": {
-      "types": "./dist/dom/index.d.ts",
-      "import": "./dist/dom/index.js",
-      "require": "./dist/dom/index.cjs"
-    },
-    "./error": {
-      "types": "./dist/error/index.d.ts",
-      "import": "./dist/error/index.js",
-      "require": "./dist/error/index.cjs"
-    },
-    "./function": {
-      "types": "./dist/function/index.d.ts",
-      "import": "./dist/function/index.js",
-      "require": "./dist/function/index.cjs"
-    },
-    "./intl": {
-      "types": "./dist/intl/index.d.ts",
-      "import": "./dist/intl/index.js",
-      "require": "./dist/intl/index.cjs"
-    },
-    "./log": {
-      "types": "./dist/log/index.d.ts",
-      "import": "./dist/log/index.js",
-      "require": "./dist/log/index.cjs"
-    },
-    "./number": {
-      "types": "./dist/number/index.d.ts",
-      "import": "./dist/number/index.js",
-      "require": "./dist/number/index.cjs"
-    },
-    "./predicate": {
-      "types": "./dist/predicate/index.d.ts",
-      "import": "./dist/predicate/index.js",
-      "require": "./dist/predicate/index.cjs"
-    },
-    "./promise": {
-      "types": "./dist/promise/index.d.ts",
-      "import": "./dist/promise/index.js",
-      "require": "./dist/promise/index.cjs"
-    },
-    "./string": {
-      "types": "./dist/string/index.d.ts",
-      "import": "./dist/string/index.js",
-      "require": "./dist/string/index.cjs"
-    },
-    "./type": {
-      "types": "./dist/type/index.d.ts",
-      "import": "./dist/type/index.js",
-      "require": "./dist/type/index.cjs"
-    },
-    "./url": {
-      "types": "./dist/url/index.d.ts",
-      "import": "./dist/url/index.js",
-      "require": "./dist/url/index.cjs"
-    },
+    "./array": "./dist/array.js",
+    "./dom": "./dist/dom.js",
+    "./dom/slots": "./dist/dom/slots.js",
+    "./dom/referenceElement": "./dist/dom/referenceElement.js",
+    "./error": "./dist/error.js",
+    "./function": "./dist/function.js",
+    "./intl": "./dist/intl.js",
+    "./intl/dom": "./dist/intl/dom.js",
+    "./log": "./dist/log.js",
+    "./number": "./dist/number.js",
+    "./predicate": "./dist/predicate.js",
+    "./promise": "./dist/promise.js",
+    "./string": "./dist/string.js",
+    "./type": "./dist/type.js",
+    "./url": "./dist/url.js",
     "./package.json": "./package.json"
   },
   "files": [

package/dist/array/index.cjs

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

package/dist/array/index.d.ts

@@ -1,12 +0,0 @@
-import { nil } from '../type/index.ts';
-/**
- * A combination of map and find.
- * Find a value in an array, and return its mapped variant.
- *
- * @example
- * ```ts
- * // Given array of url strings, return the first valid URL object.
- * const url = mappedFind(urlsStrings, (url) => URL.parse(url));
- * ```
- */
-export declare const mappedFind: <Item, ReturnType>(array: readonly Item[], callback: (item: Item, index: number) => nil | ReturnType) => ReturnType | undefined;

package/dist/dom/index.cjs

@@ -1,227 +0,0 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const log_index = require("../log/index.cjs");
-function slotChangeHasContent(event) {
-  return slotChangeHasAssignedElement(event) || slotChangeHasTextContent(event);
-}
-function slotChangeGetTextContent(event) {
-  return slotChangeGetAssignedNodes(event).filter((node) => node.nodeType === Node.TEXT_NODE).map((node) => node.textContent).join("").trim();
-}
-function slotChangeHasTextContent(event) {
-  return slotChangeGetTextContent(event).length > 0;
-}
-function slotChangeHasAssignedNode(event) {
-  return slotChangeGetAssignedNodes(event).length > 0;
-}
-function slotChangeGetAssignedNodes(event) {
-  return event.currentTarget.assignedNodes({
-    flatten: true
-  });
-}
-function slotChangeHasAssignedElement(event) {
-  return slotChangeGetAssignedElements(event).length > 0;
-}
-function slotChangeGetAssignedElements(event, selector) {
-  return getSlotAssignedElements(event.target, selector);
-}
-function getSlotAssignedElements(slot, selector) {
-  const assignedElements = slot.assignedElements({
-    flatten: true
-  });
-  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) {
-    const arg = classes2[i];
-    if (typeof arg === "string") {
-      effectiveClasses.push(arg);
-    } else if (Array.isArray(arg)) {
-      effectiveClasses.push.apply(effectiveClasses, arg);
-    } else if (typeof arg === "object") {
-      for (const prop in arg) {
-        if (arg[prop]) {
-          effectiveClasses.push(prop);
-        }
-      }
-    }
-  }
-  const className = effectiveClasses.join(" ");
-  effectiveClasses.length = 0;
-  return className;
-};
-const inTargetElement = (element, targetElement) => {
-  let currentElement = element;
-  while (currentElement) {
-    if (currentElement === targetElement) {
-      return true;
-    }
-    if (!currentElement.parentNode) {
-      return false;
-    }
-    if (currentElement.parentNode instanceof ShadowRoot) {
-      currentElement = currentElement.parentNode.host;
-    } else {
-      currentElement = currentElement.parentNode;
-    }
-  }
-  return false;
-};
-const observeAncestorsMutation = (element, attributeFilter, callback) => {
-  const subscribe = observe(attributeFilter).subscribe;
-  return subscribe((mutations) => {
-    const matched = mutations.some((mutation) => inTargetElement(element, mutation.target));
-    if (matched) {
-      callback();
-    }
-  });
-};
-const observers = {};
-const observe = (attributeFilter) => {
-  const attributes = attributeFilter.join(",");
-  const previousObserver = observers[attributes];
-  if (previousObserver !== void 0) {
-    return previousObserver;
-  }
-  const subscribers = /* @__PURE__ */ new Set();
-  const mutationObserver = new MutationObserver((mutations) => subscribers.forEach((callback) => callback(mutations)));
-  if (globalThis.document) {
-    mutationObserver.observe(document.documentElement, {
-      attributes: true,
-      attributeFilter,
-      subtree: true
-    });
-  }
-  const observer = {
-    subscribe: (callback) => {
-      subscribers.add(callback);
-      return () => {
-        subscribers.delete(callback);
-        if (subscribers.size === 0) {
-          mutationObserver.disconnect();
-          observers[attributes] = void 0;
-        }
-      };
-    }
-  };
-  observers[attributes] = observer;
-  return observer;
-};
-const getClosestElement = (base, selector) => {
-  let currentElement = base;
-  while (currentElement) {
-    const element = currentElement.closest?.(selector);
-    if (element) {
-      return element;
-    }
-    const rootElement = currentElement.getRootNode?.();
-    if (rootElement === globalThis.document) {
-      return;
-    }
-    currentElement = rootElement?.host;
-  }
-  return;
-};
-function unsafeGetCalciteModeName(el) {
-  const closestElWithMode = getClosestElement(el, `.calcite-mode-dark, .calcite-mode-light, .calcite-mode-auto`);
-  return closestElWithMode?.classList.contains("calcite-mode-dark") || closestElWithMode?.classList.contains("calcite-mode-auto") && window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
-}
-const unsafeGetElementDirection = (el) => (
-  //#endregion unsafeGetElementDirection
-  getElementAttribute(el, "dir", "ltr")
-);
-const getElementAttribute = (el, attributeName, fallbackValue) => {
-  const closest = getClosestElement(el, `[${attributeName}]`);
-  return closest?.getAttribute(attributeName) ?? fallbackValue;
-};
-const focusElement = async (el) => {
-  if (el == null) {
-    return;
-  }
-  if (hasSetFocus(el)) {
-    await el.setFocus();
-  } else {
-    el.focus();
-  }
-};
-const hasSetFocus = (ref) => typeof ref.setFocus === "function";
-const setFocusOnElement = (ref, selector) => {
-  if (!ref?.shadowRoot) {
-    return;
-  }
-  if (ref.hasAttribute("hydrated") || ref.hasAttribute("calcite-hydrated")) {
-    setFocus(ref, selector);
-    return;
-  }
-  void Promise.resolve(ref.componentOnReady?.()).then(() => setFocus(ref, selector));
-};
-const isElement = (ref) => ref.nodeType === Node.ELEMENT_NODE;
-const setFocus = (ref, selector = "") => {
-  if (!isElement(ref)) {
-    return false;
-  }
-  if (ref.matches(selector)) {
-    if (hasSetFocus(ref)) {
-      setTimeout(() => void ref.setFocus(), 0);
-    }
-    return true;
-  }
-  for (const child of ref.children) {
-    if (setFocus(child, selector)) {
-      return true;
-    }
-  }
-  const shadowRoot = ref.shadowRoot;
-  if (shadowRoot) {
-    for (const child of shadowRoot.children) {
-      if (setFocus(child, selector)) {
-        return true;
-      }
-    }
-  }
-  return false;
-};
-exports.classes = classes;
-exports.focusElement = focusElement;
-exports.getClosestElement = getClosestElement;
-exports.getElementAttribute = getElementAttribute;
-exports.getSlotAssignedElements = getSlotAssignedElements;
-exports.observeAncestorsMutation = observeAncestorsMutation;
-exports.resolveReferenceElement = resolveReferenceElement;
-exports.setFocusOnElement = setFocusOnElement;
-exports.slotChangeGetAssignedElements = slotChangeGetAssignedElements;
-exports.slotChangeGetAssignedNodes = slotChangeGetAssignedNodes;
-exports.slotChangeGetTextContent = slotChangeGetTextContent;
-exports.slotChangeHasAssignedElement = slotChangeHasAssignedElement;
-exports.slotChangeHasAssignedNode = slotChangeHasAssignedNode;
-exports.slotChangeHasContent = slotChangeHasContent;
-exports.slotChangeHasTextContent = slotChangeHasTextContent;
-exports.unsafeGetCalciteModeName = unsafeGetCalciteModeName;
-exports.unsafeGetElementDirection = unsafeGetElementDirection;

package/dist/dom/index.d.cts

@@ -1,117 +0,0 @@
-import { nil } from '../type/index.ts';
-export * from './slots.ts';
-export * from './reference-element.ts';
-/**
- * Combine multiple class names into a single string.
- *
- * @remarks
- * This function is less necessary in Lumina packages as the `class` JSX prop
- * accepts `Record<string, boolean>` objects.
- */
-export declare const classes: (...classes: (nil | Record<string, boolean> | string[] | string | false)[]) => string;
-/**
- * Observe the element and its ancestors for attribute mutations.
- * If the attributes have been changed in the ancestor tree then the callback
- * will be invoked.
- *
- * @param element The element on which to observe the attribute mutations.
- * @param attributeFilter The list of attributes to observe.
- * @param callback The callback to invoke when the attributes have been changed.
- * @returns A callback to unsubscribe from the observer.
- *
- * @example
- * ```ts
- * observeAncestorsMutation(
- *   element,
- *   ["dir", "lang"],
- *   () => console.log(getElementAttribute(element, "dir", "ltr"))
- * );
- * ```
- */
-export declare const observeAncestorsMutation: (element: Node, attributeFilter: string[], callback: () => void) => (() => void);
-/**
- * Find the closest element that matches the selector.
- * It will traverse the element's ancestors to find the target element.
- * Shadow DOM boundaries are also taken into account.
- * @param base The element to start the search from.
- * @param selector The selector to match.
- * @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),
- * but the DOM's utility only looks up until the first shadow boundary.
- *
- * @example
- * ```ts
- * const hostElement = getClosestElement(element, "arcgis-map, arcgis-scene");
- * ```
- */
-export declare const getClosestElement: <T = Element>(base: Element, selector: string) => T | undefined;
-/**
- * Use the closest Calcite mode class name to determine the
- * theme of the element. It will traverse the element's
- * ancestors to find the theme. Shadow DOM boundaries are also
- * taken into account.
- *
- * @param base The element to start the search from.
- * @returns The theme of the element ("light" or "dark"). "light" is the default.
- *
- * @remarks
- * It is advised to consider alternative solutions before using this utility:
- * - Calcite CSS variables. Benefits: makes styles more consistent,
- *   and variables are updated automatically to match dark/light theme.
- * - Detect dark mode using CSS selectors and apply styles in CSS.
- *   Benefit: styles update automatically when the theme changes.
- */
-export declare function unsafeGetCalciteModeName(el: HTMLElement): "dark" | "light";
-/**
- * Get direction property of the closest element.
- *
- * @param el The element to start the search from.
- * @returns The direction of the element ("ltr" | "rtl"). "ltr" is the default.
- *
- * @remarks
- * Do not set the `dir` property on the element itself. Do not set the `dir`
- * attribute on the components you are rendering. The `dir` attribute is only
- * meant to be set by the consumers of your component. Your component is
- * expected to respect what was set by the consumer.
- *
- * @remarks
- * Prefer [useDirection()](https://webgis.esri.com/references/lumina/controllers/useDirection)
- * to ensure your component is responsive to direction changes.
- */
-export declare const unsafeGetElementDirection: (el: HTMLElement) => "ltr" | "rtl";
-/**
- * Get the attribute value from the element or closest ancestor.
- * Shadow DOM boundaries are also taken into account.
- * If the attribute is not found then the fallback value is returned.
- *
- * @example
- * ```ts
- * const dir = getElementAttribute(element, "dir", "ltr");
- * ```
- */
-export declare const getElementAttribute: (el: Element, attributeName: string, fallbackValue: string) => string;
-/**
- * Focus the element if it is focusable.
- * @returns A promise that resolves once the focus is set.
- */
-export declare const focusElement: (el: FocusableElement | undefined) => Promise<void>;
-export interface FocusableElement extends HTMLElement {
-    setFocus?: () => Promise<void>;
-}
-/**
- * Set the focus on the element that matches the selector.
- * It will traverse the element's ancestors to find the target element.
- * Shadow DOM boundaries are also taken into account.
- * If the element is not found then the focus is not set.
- * Example: `setFocusOnElement(element, "[role='menuitem']");`
- * @param ref The element to start the search from.
- * @param selector The selector to match.
- * @returns Returns true if the focus is set on the element.
- *
- * @deprecated This function is doing too much. Import from `focusElement(getClosestElement())` from `@arcgis/toolkit/dom` instead.
- */
-export declare const setFocusOnElement: (ref: (Element & {
-    componentOnReady?: () => Promise<void>;
-}) | null | undefined, selector: string) => void;

package/dist/dom/index.d.ts

@@ -1,117 +0,0 @@
-import { nil } from '../type/index.ts';
-export * from './slots.ts';
-export * from './reference-element.ts';
-/**
- * Combine multiple class names into a single string.
- *
- * @remarks
- * This function is less necessary in Lumina packages as the `class` JSX prop
- * accepts `Record<string, boolean>` objects.
- */
-export declare const classes: (...classes: (nil | Record<string, boolean> | string[] | string | false)[]) => string;
-/**
- * Observe the element and its ancestors for attribute mutations.
- * If the attributes have been changed in the ancestor tree then the callback
- * will be invoked.
- *
- * @param element The element on which to observe the attribute mutations.
- * @param attributeFilter The list of attributes to observe.
- * @param callback The callback to invoke when the attributes have been changed.
- * @returns A callback to unsubscribe from the observer.
- *
- * @example
- * ```ts
- * observeAncestorsMutation(
- *   element,
- *   ["dir", "lang"],
- *   () => console.log(getElementAttribute(element, "dir", "ltr"))
- * );
- * ```
- */
-export declare const observeAncestorsMutation: (element: Node, attributeFilter: string[], callback: () => void) => (() => void);
-/**
- * Find the closest element that matches the selector.
- * It will traverse the element's ancestors to find the target element.
- * Shadow DOM boundaries are also taken into account.
- * @param base The element to start the search from.
- * @param selector The selector to match.
- * @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),
- * but the DOM's utility only looks up until the first shadow boundary.
- *
- * @example
- * ```ts
- * const hostElement = getClosestElement(element, "arcgis-map, arcgis-scene");
- * ```
- */
-export declare const getClosestElement: <T = Element>(base: Element, selector: string) => T | undefined;
-/**
- * Use the closest Calcite mode class name to determine the
- * theme of the element. It will traverse the element's
- * ancestors to find the theme. Shadow DOM boundaries are also
- * taken into account.
- *
- * @param base The element to start the search from.
- * @returns The theme of the element ("light" or "dark"). "light" is the default.
- *
- * @remarks
- * It is advised to consider alternative solutions before using this utility:
- * - Calcite CSS variables. Benefits: makes styles more consistent,
- *   and variables are updated automatically to match dark/light theme.
- * - Detect dark mode using CSS selectors and apply styles in CSS.
- *   Benefit: styles update automatically when the theme changes.
- */
-export declare function unsafeGetCalciteModeName(el: HTMLElement): "dark" | "light";
-/**
- * Get direction property of the closest element.
- *
- * @param el The element to start the search from.
- * @returns The direction of the element ("ltr" | "rtl"). "ltr" is the default.
- *
- * @remarks
- * Do not set the `dir` property on the element itself. Do not set the `dir`
- * attribute on the components you are rendering. The `dir` attribute is only
- * meant to be set by the consumers of your component. Your component is
- * expected to respect what was set by the consumer.
- *
- * @remarks
- * Prefer [useDirection()](https://webgis.esri.com/references/lumina/controllers/useDirection)
- * to ensure your component is responsive to direction changes.
- */
-export declare const unsafeGetElementDirection: (el: HTMLElement) => "ltr" | "rtl";
-/**
- * Get the attribute value from the element or closest ancestor.
- * Shadow DOM boundaries are also taken into account.
- * If the attribute is not found then the fallback value is returned.
- *
- * @example
- * ```ts
- * const dir = getElementAttribute(element, "dir", "ltr");
- * ```
- */
-export declare const getElementAttribute: (el: Element, attributeName: string, fallbackValue: string) => string;
-/**
- * Focus the element if it is focusable.
- * @returns A promise that resolves once the focus is set.
- */
-export declare const focusElement: (el: FocusableElement | undefined) => Promise<void>;
-export interface FocusableElement extends HTMLElement {
-    setFocus?: () => Promise<void>;
-}
-/**
- * Set the focus on the element that matches the selector.
- * It will traverse the element's ancestors to find the target element.
- * Shadow DOM boundaries are also taken into account.
- * If the element is not found then the focus is not set.
- * Example: `setFocusOnElement(element, "[role='menuitem']");`
- * @param ref The element to start the search from.
- * @param selector The selector to match.
- * @returns Returns true if the focus is set on the element.
- *
- * @deprecated This function is doing too much. Import from `focusElement(getClosestElement())` from `@arcgis/toolkit/dom` instead.
- */
-export declare const setFocusOnElement: (ref: (Element & {
-    componentOnReady?: () => Promise<void>;
-}) | null | undefined, selector: string) => void;

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

@@ -1,6 +0,0 @@
-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

@@ -1,6 +0,0 @@
-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 {};