@studiometa/js-toolkit 3.9.0 → 4.0.0-alpha.1

package/dist/utils/index.js

@@ -1,283 +1,20 @@
-import { debounce } from "./debounce.js";
-import { saveActiveElement, trapFocus, untrapFocus } from "./trapFocus.js";
-import { keyCodes } from "./keyCodes.js";
-import { memoize } from "./memoize.js";
-import { nextFrame } from "./nextFrame.js";
-import { nextTick } from "./nextTick.js";
-import { nextMicrotask } from "./nextMicrotask.js";
-import { throttle } from "./throttle.js";
-import { scrollTo } from "./scrollTo.js";
-import { getComponentResolver } from "./getComponentResolver.js";
-import {
-  isArray,
-  isBoolean,
-  isDefined,
-  isDev,
-  isEmpty,
-  isEmptyString,
-  isFunction,
-  isNull,
-  isNumber,
-  isObject,
-  isString
-} from "./is.js";
-import { hasWindow } from "./has.js";
-import {
-  addClass,
-  addStyle,
-  animate,
-  getOffsetSizes,
-  matrix,
-  removeClass,
-  removeStyle,
-  toggleClass,
-  transform,
-  transition
-} from "./css/index.js";
-import {
-  objectToURLSearchParams,
-  push,
-  replace
-} from "./history.js";
-import {
-  boundingRectToCircle,
-  collideCircleCircle,
-  collideCircleRect,
-  collidePointCircle,
-  collidePointRect,
-  collideRectRect
-} from "./collide/index.js";
-import {
-  clamp,
-  clamp01,
-  createEaseInOut,
-  createEaseOut,
-  createRange,
-  damp,
-  ease,
-  easeInCirc,
-  easeInCubic,
-  easeInExpo,
-  easeInOutCirc,
-  easeInOutCubic,
-  easeInOutExpo,
-  easeInOutQuad,
-  easeInOutQuart,
-  easeInOutQuint,
-  easeInOutSine,
-  easeInQuad,
-  easeInQuart,
-  easeInQuint,
-  easeInSine,
-  easeLinear,
-  easeOutCirc,
-  easeOutCubic,
-  easeOutExpo,
-  easeOutQuad,
-  easeOutQuart,
-  easeOutQuint,
-  easeOutSine,
-  fold,
-  inertiaFinalValue,
-  lerp,
-  map,
-  mean,
-  round,
-  smoothTo,
-  spring,
-  wrap
-} from "./math/index.js";
-import {
-  camelCase,
-  dashCase,
-  endsWith,
-  lowerCase,
-  pascalCase,
-  snakeCase,
-  startsWith,
-  upperCase,
-  withLeadingCharacters,
-  withLeadingSlash,
-  withTrailingCharacters,
-  withTrailingSlash,
-  withoutLeadingCharacters,
-  withoutLeadingCharactersRecursive,
-  withoutLeadingSlash,
-  withoutTrailingCharacters,
-  withoutTrailingCharactersRecursive,
-  withoutTrailingSlash
-} from "./string/index.js";
-import { domScheduler, useScheduler } from "./scheduler.js";
+import { memo } from "./memo.js";
+import { camelCase, capitalize, kebabCase, lowerCase, pascalCase, snakeCase, upperCase, withLeadingCharacters, withLeadingSlash, withTrailingCharacters, withTrailingSlash, withoutLeadingCharacters, withoutLeadingCharactersRecursive, withoutLeadingSlash, withoutTrailingCharacters, withoutTrailingCharactersRecursive, withoutTrailingSlash } from "./strings.js";
+import { selectorFor } from "./selectors.js";
+import { DEFAULT_DAMP_FACTOR, INERTIA_FRAME, MAX_SPRING_RATIO, clamp, clamp01, clampDampFactor, createRange, damp, decayOver, fold, inertiaDecay, inertiaFinalValue, inertiaStep, inertiaTimeConstant, lerp, map, mean, round, spring, wrap } from "./maths.js";
+import { deepmerge } from "./deepmerge.js";
+import { isBoolean, isDefined, isFunction, isNull, isNumber, isObject, isString } from "./is.js";
+import { createElement, getOffsetSizes } from "./dom.js";
+import { createEaseInOut, createEaseOut, easeInCirc, easeInCubic, easeInExpo, easeInOutCirc, easeInOutCubic, easeInOutExpo, easeInOutQuad, easeInOutQuart, easeInOutQuint, easeInOutSine, easeInQuad, easeInQuart, easeInQuint, easeInSine, easeLinear, easeOutCirc, easeOutCubic, easeOutExpo, easeOutQuad, easeOutQuart, easeOutQuint, easeOutSine } from "./easings.js";
+import { saveActiveElement, trapFocus, untrapFocus } from "./focus.js";
+import { historyPush, historyReplace, objectToURLSearchParams } from "./history.js";
+import { loadImage, loadLink, loadScript } from "./load.js";
 import { noop, noopValue } from "./noop.js";
-import { tween } from "./tween.js";
-import { Queue } from "./Queue.js";
-import { SmartQueue } from "./SmartQueue.js";
-import { createElement, getAncestorWhere, getAncestorWhereUntil } from "./dom/index.js";
-import { wait } from "./wait.js";
 import { random, randomInt, randomItem } from "./random.js";
-import { memo } from "./memo.js";
-import {
-  loadElement,
-  loadIframe,
-  loadImage,
-  loadLink,
-  loadScript
-} from "./loadElement.js";
-import { cache } from "./cache.js";
-import {
-  createLocalStorage,
-  createLocalStorageProvider,
-  createMemoryStorageProvider,
-  createNoopProvider,
-  createSessionStorage,
-  createSessionStorageProvider,
-  createStorage,
-  createUrlSearchParamsInHashProvider,
-  createUrlSearchParamsInHashStorage,
-  createUrlSearchParamsProvider,
-  createUrlSearchParamsStorage,
-  localStorageProvider,
-  memoryStorageProvider,
-  sessionStorageProvider,
-  urlSearchParamsInHashProvider,
-  urlSearchParamsProvider
-} from "./storage.js";
-export {
-  Queue,
-  SmartQueue,
-  addClass,
-  addStyle,
-  animate,
-  boundingRectToCircle,
-  cache,
-  camelCase,
-  clamp,
-  clamp01,
-  collideCircleCircle,
-  collideCircleRect,
-  collidePointCircle,
-  collidePointRect,
-  collideRectRect,
-  createEaseInOut,
-  createEaseOut,
-  createElement,
-  createLocalStorage,
-  createLocalStorageProvider,
-  createMemoryStorageProvider,
-  createNoopProvider,
-  createRange,
-  createSessionStorage,
-  createSessionStorageProvider,
-  createStorage,
-  createUrlSearchParamsInHashProvider,
-  createUrlSearchParamsInHashStorage,
-  createUrlSearchParamsProvider,
-  createUrlSearchParamsStorage,
-  damp,
-  dashCase,
-  debounce,
-  domScheduler,
-  ease,
-  easeInCirc,
-  easeInCubic,
-  easeInExpo,
-  easeInOutCirc,
-  easeInOutCubic,
-  easeInOutExpo,
-  easeInOutQuad,
-  easeInOutQuart,
-  easeInOutQuint,
-  easeInOutSine,
-  easeInQuad,
-  easeInQuart,
-  easeInQuint,
-  easeInSine,
-  easeLinear,
-  easeOutCirc,
-  easeOutCubic,
-  easeOutExpo,
-  easeOutQuad,
-  easeOutQuart,
-  easeOutQuint,
-  easeOutSine,
-  endsWith,
-  fold,
-  getAncestorWhere,
-  getAncestorWhereUntil,
-  getComponentResolver,
-  getOffsetSizes,
-  hasWindow,
-  push as historyPush,
-  replace as historyReplace,
-  inertiaFinalValue,
-  isArray,
-  isBoolean,
-  isDefined,
-  isDev,
-  isEmpty,
-  isEmptyString,
-  isFunction,
-  isNull,
-  isNumber,
-  isObject,
-  isString,
-  keyCodes,
-  lerp,
-  loadElement,
-  loadIframe,
-  loadImage,
-  loadLink,
-  loadScript,
-  localStorageProvider,
-  lowerCase,
-  map,
-  matrix,
-  mean,
-  memo,
-  memoize,
-  memoryStorageProvider,
-  nextFrame,
-  nextMicrotask,
-  nextTick,
-  noop,
-  noopValue,
-  objectToURLSearchParams,
-  pascalCase,
-  random,
-  randomInt,
-  randomItem,
-  removeClass,
-  removeStyle,
-  round,
-  saveActiveElement,
-  scrollTo,
-  sessionStorageProvider,
-  smoothTo,
-  snakeCase,
-  spring,
-  startsWith,
-  throttle,
-  toggleClass,
-  transform,
-  transition,
-  trapFocus,
-  tween,
-  untrapFocus,
-  upperCase,
-  urlSearchParamsInHashProvider,
-  urlSearchParamsProvider,
-  useScheduler,
-  wait,
-  withLeadingCharacters,
-  withLeadingSlash,
-  withTrailingCharacters,
-  withTrailingSlash,
-  withoutLeadingCharacters,
-  withoutLeadingCharactersRecursive,
-  withoutLeadingSlash,
-  withoutTrailingCharacters,
-  withoutTrailingCharactersRecursive,
-  withoutTrailingSlash,
-  wrap
-};
-//# sourceMappingURL=index.js.map
+import { SCROLL_ALIGNMENTS, SCROLL_AXES, scrollPosition, scrollTo } from "./scrollTo.js";
+import { lockScroll } from "./scroll-lock.js";
+import { smoothTo } from "./smoothTo.js";
+import { debounce, throttle, wait } from "./timing.js";
+import { TRANSITION_OPTIONS, enterTransition, leaveTransition, setClassesOrStyles, transition } from "./transition.js";
+import { TRANSFORM_PROPS, matrix, transform } from "./transform.js";
+export { DEFAULT_DAMP_FACTOR, INERTIA_FRAME, MAX_SPRING_RATIO, SCROLL_ALIGNMENTS, SCROLL_AXES, TRANSFORM_PROPS, TRANSITION_OPTIONS, camelCase, capitalize, clamp, clamp01, clampDampFactor, createEaseInOut, createEaseOut, createElement, createRange, damp, debounce, decayOver, deepmerge, easeInCirc, easeInCubic, easeInExpo, easeInOutCirc, easeInOutCubic, easeInOutExpo, easeInOutQuad, easeInOutQuart, easeInOutQuint, easeInOutSine, easeInQuad, easeInQuart, easeInQuint, easeInSine, easeLinear, easeOutCirc, easeOutCubic, easeOutExpo, easeOutQuad, easeOutQuart, easeOutQuint, easeOutSine, enterTransition, fold, getOffsetSizes, historyPush, historyReplace, inertiaDecay, inertiaFinalValue, inertiaStep, inertiaTimeConstant, isBoolean, isDefined, isFunction, isNull, isNumber, isObject, isString, kebabCase, leaveTransition, lerp, loadImage, loadLink, loadScript, lockScroll, lowerCase, map, matrix, mean, memo, noop, noopValue, objectToURLSearchParams, pascalCase, random, randomInt, randomItem, round, saveActiveElement, scrollPosition, scrollTo, selectorFor, setClassesOrStyles, smoothTo, snakeCase, spring, throttle, transform, transition, trapFocus, untrapFocus, upperCase, wait, withLeadingCharacters, withLeadingSlash, withTrailingCharacters, withTrailingSlash, withoutLeadingCharacters, withoutLeadingCharactersRecursive, withoutLeadingSlash, withoutTrailingCharacters, withoutTrailingCharactersRecursive, withoutTrailingSlash, wrap };

package/dist/utils/is.d.ts

@@ -1,54 +1,43 @@
+//#region src/utils/is.d.ts
+/** Type guards for the values a component reads from the DOM or its options. */
 /**
- * @link https://js-toolkit.studiometa.dev/utils/is/isDev.html
+ * Whether a value is `null`.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isnull
  */
-export declare const isDev: boolean;
+declare function isNull(value: unknown): value is null;
 /**
- * Test is the given value is null.
- * @link https://js-toolkit.studiometa.dev/utils/is/isNull.html
+ * Whether a value is anything but `undefined`.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isdefined
  */
-export declare const isNull: (value: unknown) => value is null;
+declare function isDefined<T>(value: T | undefined): value is T;
 /**
- * Test if the given value is a function.
- * @link https://js-toolkit.studiometa.dev/utils/is/isFunction.html
+ * Whether a value is a string.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isstring
  */
-export declare const isFunction: (value: unknown) => value is Function;
+declare function isString(value: unknown): value is string;
 /**
- * Test if a value is defined or not.
- * @link https://js-toolkit.studiometa.dev/utils/is/isDefined.html
+ * Whether a value is a number, `NaN` excluded.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isnumber
  */
-export declare const isDefined: (value: unknown) => boolean;
+declare function isNumber(value: unknown): value is number;
 /**
- * Test if value is a string.
- * @link https://js-toolkit.studiometa.dev/utils/is/isString.html
+ * Whether a value is a boolean.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isboolean
  */
-export declare const isString: (value: unknown) => value is string;
+declare function isBoolean(value: unknown): value is boolean;
 /**
- * Test if the given value is an object.
- * @link https://js-toolkit.studiometa.dev/utils/is/isObject.html
+ * Whether a value is callable.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isfunction
  */
-export declare const isObject: (value: unknown) => boolean;
+declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
 /**
- * Test if a given value is a number.
- * @link https://js-toolkit.studiometa.dev/utils/is/isNumber.html
+ * Whether a value is a plain object: an array, a `Date`, a DOM node and `null`
+ * are all excluded.
+ *
+ * The tag is read through `Object.prototype`, so an object with no prototype
+ * answers instead of throwing on a missing `toString`.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isobject
  */
-export declare const isNumber: (value: unknown) => value is number;
-/**
- * Test if a given value is a boolean.
- * @link https://js-toolkit.studiometa.dev/utils/is/isBoolean.html
- */
-export declare const isBoolean: (value: unknown) => value is boolean;
-/**
- * Test if a given value is an array.
- * @link https://js-toolkit.studiometa.dev/utils/is/isArray.html
- */
-export declare const isArray: (arg: any) => arg is any[];
-/**
- * Test if a given value is an empty string.
- * @link https://js-toolkit.studiometa.dev/utils/is/isEmptyString.html
- */
-export declare const isEmptyString: (value?: unknown) => boolean;
-/**
- * Test if the given value is empty.
- * @link https://js-toolkit.studiometa.dev/utils/is/isEmpty.html
- */
-export declare const isEmpty: (value?: any) => boolean;
+declare function isObject(value: unknown): value is Record<string, unknown>;
+//#endregion
+export { isBoolean, isDefined, isFunction, isNull, isNumber, isObject, isString };

package/dist/utils/is.js

@@ -1,36 +1,59 @@
-const isDev = typeof __DEV__ !== "undefined" && __DEV__;
-const isNull = (value) => value === null;
-const isFunction = (value) => typeof value === "function";
-const isDefined = (value) => typeof value !== "undefined";
-const isString = (value) => typeof value === "string";
-const isObject = (value) => typeof value === "object" && !!value && value.toString() === "[object Object]";
-const isNumber = (value) => typeof value === "number" && !Number.isNaN(value);
-const isBoolean = (value) => typeof value === "boolean";
-const isArray = Array.isArray;
-const isEmptyString = (value) => isString(value) && value.length === 0;
-const isEmpty = (value) => {
-  if (isNull(value) || !isDefined(value)) {
-    return true;
-  }
-  if (isString(value) || isArray(value)) {
-    return value.length === 0;
-  }
-  if (isObject(value)) {
-    return value.constructor === Object && Object.keys(value).length === 0;
-  }
-  return false;
-};
-export {
-  isArray,
-  isBoolean,
-  isDefined,
-  isDev,
-  isEmpty,
-  isEmptyString,
-  isFunction,
-  isNull,
-  isNumber,
-  isObject,
-  isString
-};
-//# sourceMappingURL=is.js.map
+//#region src/utils/is.ts
+/** Type guards for the values a component reads from the DOM or its options. */
+/**
+* Whether a value is `null`.
+* @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isnull
+*/
+function isNull(value) {
+	return value === null;
+}
+/**
+* Whether a value is anything but `undefined`.
+* @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isdefined
+*/
+function isDefined(value) {
+	return typeof value !== "undefined";
+}
+/**
+* Whether a value is a string.
+* @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isstring
+*/
+function isString(value) {
+	return typeof value === "string";
+}
+/**
+* Whether a value is a number, `NaN` excluded.
+* @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isnumber
+*/
+function isNumber(value) {
+	return typeof value === "number" && !Number.isNaN(value);
+}
+/**
+* Whether a value is a boolean.
+* @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isboolean
+*/
+function isBoolean(value) {
+	return typeof value === "boolean";
+}
+/**
+* Whether a value is callable.
+* @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isfunction
+*/
+function isFunction(value) {
+	return typeof value === "function";
+}
+/**
+* Whether a value is a plain object: an array, a `Date`, a DOM node and `null`
+* are all excluded.
+*
+* The tag is read through `Object.prototype`, so an object with no prototype
+* answers instead of throwing on a missing `toString`.
+* @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isobject
+*/
+function isObject(value) {
+	return Object.prototype.toString.call(value) === "[object Object]";
+}
+//#endregion
+export { isBoolean, isDefined, isFunction, isNull, isNumber, isObject, isString };
+
+//# sourceMappingURL=is.js.map

package/dist/utils/is.js.map

@@ -1,7 +1 @@
-{
-  "version": 3,
-  "sources": ["../../../packages/js-toolkit/utils/is.ts"],
-  "sourcesContent": ["// eslint-disable-next-line no-undef\n/**\n * @link https://js-toolkit.studiometa.dev/utils/is/isDev.html\n */\nexport const isDev = typeof __DEV__ !== 'undefined' && __DEV__;\n\n/**\n * Test is the given value is null.\n * @link https://js-toolkit.studiometa.dev/utils/is/isNull.html\n */\nexport const isNull = (value: unknown): value is null => value === null;\n\n/**\n * Test if the given value is a function.\n * @link https://js-toolkit.studiometa.dev/utils/is/isFunction.html\n */\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport const isFunction = (value: unknown): value is Function => typeof value === 'function';\n\n/**\n * Test if a value is defined or not.\n * @link https://js-toolkit.studiometa.dev/utils/is/isDefined.html\n */\nexport const isDefined = (value: unknown): boolean => typeof value !== 'undefined';\n\n/**\n * Test if value is a string.\n * @link https://js-toolkit.studiometa.dev/utils/is/isString.html\n */\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\n/**\n * Test if the given value is an object.\n * @link https://js-toolkit.studiometa.dev/utils/is/isObject.html\n */\nexport const isObject = (value: unknown): boolean =>\n  typeof value === 'object' && !!value && value.toString() === '[object Object]';\n\n/**\n * Test if a given value is a number.\n * @link https://js-toolkit.studiometa.dev/utils/is/isNumber.html\n */\nexport const isNumber = (value: unknown): value is number =>\n  typeof value === 'number' && !Number.isNaN(value);\n\n/**\n * Test if a given value is a boolean.\n * @link https://js-toolkit.studiometa.dev/utils/is/isBoolean.html\n */\nexport const isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\n\n// eslint-disable-next-line prefer-destructuring\n/**\n * Test if a given value is an array.\n * @link https://js-toolkit.studiometa.dev/utils/is/isArray.html\n */\nexport const isArray = Array.isArray;\n\n/**\n * Test if a given value is an empty string.\n * @link https://js-toolkit.studiometa.dev/utils/is/isEmptyString.html\n */\nexport const isEmptyString = (value?: unknown): boolean => isString(value) && value.length === 0;\n\n/**\n * Test if the given value is empty.\n * @link https://js-toolkit.studiometa.dev/utils/is/isEmpty.html\n */\nexport const isEmpty = (value?) => {\n  if (isNull(value) || !isDefined(value)) {\n    return true;\n  }\n\n  if (isString(value) || isArray(value)) {\n    return value.length === 0;\n  }\n\n  if (isObject(value)) {\n    return value.constructor === Object && Object.keys(value).length === 0;\n  }\n\n  return false;\n};\n"],
-  "mappings": "AAIO,MAAM,QAAQ,OAAO,YAAY,eAAe;AAMhD,MAAM,SAAS,CAAC,UAAkC,UAAU;AAO5D,MAAM,aAAa,CAAC,UAAsC,OAAO,UAAU;AAM3E,MAAM,YAAY,CAAC,UAA4B,OAAO,UAAU;AAMhE,MAAM,WAAW,CAAC,UAAoC,OAAO,UAAU;AAMvE,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM,SAAS,MAAM;AAMxD,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,KAAK;AAM3C,MAAM,YAAY,CAAC,UAAqC,OAAO,UAAU;AAOzE,MAAM,UAAU,MAAM;AAMtB,MAAM,gBAAgB,CAAC,UAA6B,SAAS,KAAK,KAAK,MAAM,WAAW;AAMxF,MAAM,UAAU,CAAC,UAAW;AACjC,MAAI,OAAO,KAAK,KAAK,CAAC,UAAU,KAAK,GAAG;AACtC,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,KAAK,KAAK,QAAQ,KAAK,GAAG;AACrC,WAAO,MAAM,WAAW;AAAA,EAC1B;AAEA,MAAI,SAAS,KAAK,GAAG;AACnB,WAAO,MAAM,gBAAgB,UAAU,OAAO,KAAK,KAAK,EAAE,WAAW;AAAA,EACvE;AAEA,SAAO;AACT;",
-  "names": []
-}
+{"version":3,"file":"is.js","names":[],"sources":["../../src/utils/is.ts"],"sourcesContent":["/** Type guards for the values a component reads from the DOM or its options. */\n\n/**\n * Whether a value is `null`.\n * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isnull\n */\nexport function isNull(value: unknown): value is null {\n  return value === null;\n}\n\n/**\n * Whether a value is anything but `undefined`.\n * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isdefined\n */\nexport function isDefined<T>(value: T | undefined): value is T {\n  return typeof value !== 'undefined';\n}\n\n/**\n * Whether a value is a string.\n * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isstring\n */\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\n/**\n * Whether a value is a number, `NaN` excluded.\n * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isnumber\n */\nexport function isNumber(value: unknown): value is number {\n  return typeof value === 'number' && !Number.isNaN(value);\n}\n\n/**\n * Whether a value is a boolean.\n * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isboolean\n */\nexport function isBoolean(value: unknown): value is boolean {\n  return typeof value === 'boolean';\n}\n\n/**\n * Whether a value is callable.\n * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isfunction\n */\nexport function isFunction(value: unknown): value is (...args: unknown[]) => unknown {\n  return typeof value === 'function';\n}\n\n/**\n * Whether a value is a plain object: an array, a `Date`, a DOM node and `null`\n * are all excluded.\n *\n * The tag is read through `Object.prototype`, so an object with no prototype\n * answers instead of throwing on a missing `toString`.\n * @link https://js-toolkit-v4.studiometa.dev/utils/is.html#isobject\n */\nexport function isObject(value: unknown): value is Record<string, unknown> {\n  return Object.prototype.toString.call(value) === '[object Object]';\n}\n"],"mappings":";;;;;;AAMA,SAAgB,OAAO,OAA+B;CACpD,OAAO,UAAU;AACnB;;;;;AAMA,SAAgB,UAAa,OAAkC;CAC7D,OAAO,OAAO,UAAU;AAC1B;;;;;AAMA,SAAgB,SAAS,OAAiC;CACxD,OAAO,OAAO,UAAU;AAC1B;;;;;AAMA,SAAgB,SAAS,OAAiC;CACxD,OAAO,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,KAAK;AACzD;;;;;AAMA,SAAgB,UAAU,OAAkC;CAC1D,OAAO,OAAO,UAAU;AAC1B;;;;;AAMA,SAAgB,WAAW,OAA0D;CACnF,OAAO,OAAO,UAAU;AAC1B;;;;;;;;;AAUA,SAAgB,SAAS,OAAkD;CACzE,OAAO,OAAO,UAAU,SAAS,KAAK,KAAK,MAAM;AACnD"}

package/dist/utils/load.d.ts

@@ -0,0 +1,46 @@
+//#region src/utils/load.d.ts
+/** Loading a resource, as a promise that settles when the browser is done with it. */
+/**
+ * Load an image, resolved once its bitmap is decoded.
+ *
+ * The element is detached and stays that way: this preloads a URL, it does not
+ * put an image on the page. Awaiting `decode()` rather than the load event is
+ * the point — assigning the URL to a visible `<img>` afterwards paints in the
+ * same frame instead of janking the one after it. The element comes back for
+ * its `naturalWidth`/`naturalHeight`.
+ *
+ * Nothing is deduplicated here: the HTTP cache already does it, and a detached
+ * element costs nothing to build.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/load.html#loadimage
+ */
+declare function loadImage(src: string): Promise<HTMLImageElement>;
+/**
+ * Load a script, appended to `<head>`.
+ *
+ * There is no target option: a detached `<script>` never runs. Calls are
+ * deduplicated by resolved URL, so asking twice for one embed returns the very
+ * same promise and executes the third-party code once. A failed load is
+ * forgotten, so it can be retried.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/load.html#loadscript
+ */
+declare function loadScript(src: string, attributes?: Record<string, string>): Promise<HTMLScriptElement>;
+/**
+ * Load a `<link>`, appended to `<head>`.
+ *
+ * `rel` is required because a `<link>` without one is inert and would never
+ * settle. It is also part of the deduplication key, next to the resolved URL:
+ * prefetching a URL and loading it as a stylesheet are two intents on one
+ * href, and both must happen.
+ *
+ * **A `rel` the browser ignores resolves at once.** `relList.supports()`
+ * answers whether the browser will act on it — Safari ignores `prefetch`
+ * entirely — and a hint is best-effort, so an ignored one is a resolved
+ * promise over an inert element rather than a promise waiting forever for an
+ * event that will never fire. The element is appended either way.
+ * @link https://js-toolkit-v4.studiometa.dev/utils/load.html#loadlink
+ */
+declare function loadLink(href: string, attributes: {
+  rel: string;
+} & Record<string, string>): Promise<HTMLLinkElement>;
+//#endregion
+export { loadImage, loadLink, loadScript };