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

package/dist/helpers/queryComponent.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../packages/js-toolkit/helpers/queryComponent.ts"],
-  "sourcesContent": ["import type { Base, BaseEl } from '../Base/Base.js';\nimport { getInstances, hasInstance } from '../Base/utils.js';\nimport { memo } from '../utils/memo.js';\nimport { getAncestorWhere } from '../utils/dom/ancestors.js';\n\nexport interface QueryOptions {\n  from?: HTMLElement | Document;\n}\n\ntype ComponentState = 'mounted' | 'destroyed' | 'terminated';\nexport type ParsedQuery = {\n  name: string;\n  cssSelector?: string;\n  state?: string;\n};\n\nconst REGEX_QUERY = /([a-zA-Z0-9]+)(\\((.*)\\))?(:([a-z]+))?/;\n\n/**\n * Parse a query string like 'Foo(.css-selector):mounted' into its parts.\n */\nexport const parseQuery = memo((query: string): ParsedQuery => {\n  const [, name, , cssSelector, , state] = query.match(REGEX_QUERY) as [\n    string,\n    string,\n    string | undefined,\n    string | undefined,\n    string | undefined,\n    ComponentState | undefined,\n  ];\n\n  return {\n    name,\n    cssSelector,\n    state,\n  };\n});\n\nexport function instanceIsMatching(instance: Base, parsedQuery: ParsedQuery): boolean {\n  if (instance.$config.name !== parsedQuery.name) return false;\n  if (parsedQuery.cssSelector && !instance.$el.matches(parsedQuery.cssSelector)) return false;\n\n  if (parsedQuery.state === 'mounted' && !instance.$isMounted) return false;\n  if (parsedQuery.state === 'destroyed' && instance.$isMounted) return false;\n\n  return true;\n}\n\n/**\n * Resolve the live instance attached to an element under a given name.\n *\n * Reads the element's `__base__` map (the same O(1)-per-element lookup\n * `closestComponent` uses) and applies the single matching gate:\n *   - the entry must exist and not be the literal `'terminated'` string\n *     written by `$terminate` (`Base.ts`);\n *   - the instance must still be \"live\" (registered in the global storage\n *     between `before-mounted` and `after-destroyed`) \u2014 `__base__` keeps\n *     destroyed-but-not-terminated instances that `getInstances()` has already\n *     dropped, so `hasInstance` preserves the historical visibility window;\n *   - it must satisfy `instanceIsMatching` (name, CSS selector, state).\n *\n * The lookup is keyed on `parsedQuery.name` only \u2014 never on a name-derived DOM\n * selector \u2014 because `__base__` membership is independent of whether the element\n * carries a `data-component` attribute or a `w-name` tag.\n */\nfunction resolveMatch<T extends Base>(element: BaseEl, parsedQuery: ParsedQuery): T | undefined {\n  const baseMap = element.__base__;\n  if (!baseMap) return undefined;\n\n  const instance = baseMap.get(parsedQuery.name);\n  if (!instance || instance === 'terminated') return undefined;\n  if (!hasInstance(instance) || !instanceIsMatching(instance, parsedQuery)) return undefined;\n\n  return instance as T;\n}\n\n/**\n * Yield the instances matching the given query within the `from` root.\n *\n * When `from` is the document, there is no containment/attachment constraint, so\n * every live matching instance is returned even if its `$el` is detached from the\n * global document \u2014 the global instance storage is the source of truth here (a\n * `document.querySelectorAll` scan would miss detached elements entirely).\n *\n * When `from` is an element, matches are resolved via a scoped\n * `querySelectorAll('*')` descendant traversal plus an explicit check of `from`\n * itself (which `querySelectorAll` excludes), each resolved through its\n * `__base__` map. This scales with the size of the `from` subtree instead of the\n * global instance count. `'*'` is required \u2014 a name-derived selector would miss\n * components mounted on elements that carry no matching attribute/tag (e.g.\n * `withName(Base, name)` on a plain element, or a component registered under an\n * arbitrary CSS selector).\n */\nfunction* queryMatches<T extends Base>(\n  parsedQuery: ParsedQuery,\n  from: HTMLElement | Document,\n): Generator<T> {\n  if (from === document) {\n    for (const instance of getInstances()) {\n      if (hasInstance(instance) && instanceIsMatching(instance, parsedQuery)) {\n        yield instance as T;\n      }\n    }\n    return;\n  }\n\n  const seen = new Set<T>();\n\n  const selfMatch = resolveMatch<T>(from as BaseEl, parsedQuery);\n  if (selfMatch) {\n    seen.add(selfMatch);\n    yield selfMatch;\n  }\n\n  for (const element of from.querySelectorAll<HTMLElement>('*')) {\n    const match = resolveMatch<T>(element as BaseEl, parsedQuery);\n    if (match && !seen.has(match)) {\n      seen.add(match);\n      yield match;\n    }\n  }\n}\n\n/**\n * Get the first instance of component with the given query.\n */\nexport function queryComponent<T extends Base = Base>(\n  query: string,\n  options: QueryOptions = {},\n): T | undefined {\n  const parsedQuery = parseQuery(query);\n  const { from = document } = options;\n\n  for (const instance of queryMatches<T>(parsedQuery, from)) {\n    return instance;\n  }\n\n  return undefined;\n}\n\n/**\n * Get all instances of component with the given query.\n */\nexport function queryComponentAll<T extends Base = Base>(\n  query: string,\n  options: QueryOptions = {},\n): T[] {\n  const parsedQuery = parseQuery(query);\n  const { from = document } = options;\n\n  return Array.from(queryMatches<T>(parsedQuery, from));\n}\n\n/**\n * Get the closest component instance by traversing up the DOM tree.\n */\nexport function closestComponent<T extends Base = Base>(\n  query: string,\n  options: { from: HTMLElement } = { from: null },\n): T | undefined {\n  const { from } = options;\n  const parsedQuery = parseQuery(query);\n  let closestInstance: T | undefined;\n\n  getAncestorWhere(from, (element) => {\n    if (!element) return false;\n\n    // Use the element's __base__ map for O(1) lookup by component name\n    const baseMap = (element as BaseEl).__base__;\n    if (!baseMap) return false;\n\n    const instance = baseMap.get(parsedQuery.name) as T;\n    if (\n      instance &&\n      instance !== ('terminated' as unknown) &&\n      instanceIsMatching(instance, parsedQuery)\n    ) {\n      closestInstance = instance;\n      return true;\n    }\n\n    return false;\n  });\n\n  return closestInstance;\n}\n"],
-  "mappings": "AACA,SAAS,cAAc,mBAAmB;AAC1C,SAAS,YAAY;AACrB,SAAS,wBAAwB;AAajC,MAAM,cAAc;AAKb,MAAM,aAAa,KAAK,CAAC,UAA+B;AAC7D,QAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,MAAM,MAAM,WAAW;AAShE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF,CAAC;AAEM,SAAS,mBAAmB,UAAgB,aAAmC;AACpF,MAAI,SAAS,QAAQ,SAAS,YAAY,KAAM,QAAO;AACvD,MAAI,YAAY,eAAe,CAAC,SAAS,IAAI,QAAQ,YAAY,WAAW,EAAG,QAAO;AAEtF,MAAI,YAAY,UAAU,aAAa,CAAC,SAAS,WAAY,QAAO;AACpE,MAAI,YAAY,UAAU,eAAe,SAAS,WAAY,QAAO;AAErE,SAAO;AACT;AAmBA,SAAS,aAA6B,SAAiB,aAAyC;AAC9F,QAAM,UAAU,QAAQ;AACxB,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,WAAW,QAAQ,IAAI,YAAY,IAAI;AAC7C,MAAI,CAAC,YAAY,aAAa,aAAc,QAAO;AACnD,MAAI,CAAC,YAAY,QAAQ,KAAK,CAAC,mBAAmB,UAAU,WAAW,EAAG,QAAO;AAEjF,SAAO;AACT;AAmBA,UAAU,aACR,aACA,MACc;AACd,MAAI,SAAS,UAAU;AACrB,eAAW,YAAY,aAAa,GAAG;AACrC,UAAI,YAAY,QAAQ,KAAK,mBAAmB,UAAU,WAAW,GAAG;AACtE,cAAM;AAAA,MACR;AAAA,IACF;AACA;AAAA,EACF;AAEA,QAAM,OAAO,oBAAI,IAAO;AAExB,QAAM,YAAY,aAAgB,MAAgB,WAAW;AAC7D,MAAI,WAAW;AACb,SAAK,IAAI,SAAS;AAClB,UAAM;AAAA,EACR;AAEA,aAAW,WAAW,KAAK,iBAA8B,GAAG,GAAG;AAC7D,UAAM,QAAQ,aAAgB,SAAmB,WAAW;AAC5D,QAAI,SAAS,CAAC,KAAK,IAAI,KAAK,GAAG;AAC7B,WAAK,IAAI,KAAK;AACd,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAKO,SAAS,eACd,OACA,UAAwB,CAAC,GACV;AACf,QAAM,cAAc,WAAW,KAAK;AACpC,QAAM,EAAE,OAAO,SAAS,IAAI;AAE5B,aAAW,YAAY,aAAgB,aAAa,IAAI,GAAG;AACzD,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAKO,SAAS,kBACd,OACA,UAAwB,CAAC,GACpB;AACL,QAAM,cAAc,WAAW,KAAK;AACpC,QAAM,EAAE,OAAO,SAAS,IAAI;AAE5B,SAAO,MAAM,KAAK,aAAgB,aAAa,IAAI,CAAC;AACtD;AAKO,SAAS,iBACd,OACA,UAAiC,EAAE,MAAM,KAAK,GAC/B;AACf,QAAM,EAAE,KAAK,IAAI;AACjB,QAAM,cAAc,WAAW,KAAK;AACpC,MAAI;AAEJ,mBAAiB,MAAM,CAAC,YAAY;AAClC,QAAI,CAAC,QAAS,QAAO;AAGrB,UAAM,UAAW,QAAmB;AACpC,QAAI,CAAC,QAAS,QAAO;AAErB,UAAM,WAAW,QAAQ,IAAI,YAAY,IAAI;AAC7C,QACE,YACA,aAAc,gBACd,mBAAmB,UAAU,WAAW,GACxC;AACA,wBAAkB;AAClB,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT,CAAC;AAED,SAAO;AACT;",
-  "names": []
-}

package/dist/helpers/registerComponent.d.ts

@@ -1,24 +0,0 @@
-import { BaseConstructor } from '../Base/Base.js';
-/**
- * Register globally and mount a given component.
- *
- * The component can be provided in any of the forms also accepted for child
- * components in `config.components`:
- * - a `Base` constructor;
- * - a promise resolving to a constructor or a module namespace (`import(...)`);
- * - a factory function returning such a promise (`() => import(...)`).
- *
- * Instances are mounted independently: an element that fails to mount is
- * skipped (and logged in development) instead of failing the whole call, so
- * the resolved array contains every instance that mounted successfully.
- *
- * @link https://js-toolkit.studiometa.dev/api/helpers/registerComponent.html
- * @param ctor The component constructor, or a way to resolve it.
- * @param nameOrSelector The name or selector to used for this component.
- * @return A promise resolving to an array of mounted component instances.
- */
-export declare function registerComponent<T extends BaseConstructor = BaseConstructor>(ctor: T | Promise<T | {
-    default: T;
-}> | (() => Promise<T | {
-    default: T;
-}>), nameOrSelector?: string): Promise<Awaited<InstanceType<T>>[]>;

package/dist/helpers/registerComponent.js

@@ -1,30 +0,0 @@
-import { isDev, isFunction } from "../utils/is.js";
-async function registerComponent(ctor, nameOrSelector) {
-  if (isFunction(ctor) && !("$isBase" in ctor)) {
-    ctor = ctor(void 0);
-  }
-  let Ctor;
-  if (ctor instanceof Promise) {
-    const module = await ctor;
-    Ctor = "$isBase" in module ? module : module.default;
-  } else {
-    Ctor = ctor;
-  }
-  const results = await Promise.allSettled(Ctor.$register(nameOrSelector));
-  return results.flatMap((result) => {
-    if (result.status === "fulfilled") {
-      return [result.value];
-    }
-    if (isDev) {
-      console.error(
-        "[registerComponent] An instance failed to mount and was skipped.",
-        result.reason
-      );
-    }
-    return [];
-  });
-}
-export {
-  registerComponent
-};
-//# sourceMappingURL=registerComponent.js.map

package/dist/helpers/registerComponent.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../packages/js-toolkit/helpers/registerComponent.ts"],
-  "sourcesContent": ["import { BaseAsyncConstructor, BaseConstructor } from '../Base/Base.js';\nimport { isDev, isFunction } from '../utils/is.js';\n\n/**\n * Register globally and mount a given component.\n *\n * The component can be provided in any of the forms also accepted for child\n * components in `config.components`:\n * - a `Base` constructor;\n * - a promise resolving to a constructor or a module namespace (`import(...)`);\n * - a factory function returning such a promise (`() => import(...)`).\n *\n * Instances are mounted independently: an element that fails to mount is\n * skipped (and logged in development) instead of failing the whole call, so\n * the resolved array contains every instance that mounted successfully.\n *\n * @link https://js-toolkit.studiometa.dev/api/helpers/registerComponent.html\n * @param ctor The component constructor, or a way to resolve it.\n * @param nameOrSelector The name or selector to used for this component.\n * @return A promise resolving to an array of mounted component instances.\n */\nexport async function registerComponent<T extends BaseConstructor = BaseConstructor>(\n  ctor: T | Promise<T | { default: T }> | (() => Promise<T | { default: T }>),\n  nameOrSelector?: string,\n) {\n  // Resolve factory functions such as `() => import('./Component.js')`, mirroring\n  // how lazy child components are declared. A `Base` constructor is a function too,\n  // so it is distinguished by its `$isBase` marker.\n  if (isFunction(ctor) && !('$isBase' in ctor)) {\n    ctor = (ctor as BaseAsyncConstructor)(undefined as never) as Promise<T | { default: T }>;\n  }\n\n  let Ctor: T;\n  if (ctor instanceof Promise) {\n    const module = await ctor;\n    // A resolved `Base` constructor is used as-is; only a module namespace is\n    // unwrapped. Keying on `$isBase` (like the async child resolution) avoids\n    // mistaking a user-defined static `default` member for a module namespace.\n    Ctor = ('$isBase' in module ? module : (module as { default: T }).default) as T;\n  } else {\n    Ctor = ctor;\n  }\n\n  const results = await Promise.allSettled(Ctor.$register(nameOrSelector));\n\n  return results.flatMap((result) => {\n    if (result.status === 'fulfilled') {\n      return [result.value];\n    }\n\n    if (isDev) {\n      console.error(\n        '[registerComponent] An instance failed to mount and was skipped.',\n        result.reason,\n      );\n    }\n\n    return [];\n  });\n}\n"],
-  "mappings": "AACA,SAAS,OAAO,kBAAkB;AAoBlC,eAAsB,kBACpB,MACA,gBACA;AAIA,MAAI,WAAW,IAAI,KAAK,EAAE,aAAa,OAAO;AAC5C,WAAQ,KAA8B,MAAkB;AAAA,EAC1D;AAEA,MAAI;AACJ,MAAI,gBAAgB,SAAS;AAC3B,UAAM,SAAS,MAAM;AAIrB,WAAQ,aAAa,SAAS,SAAU,OAA0B;AAAA,EACpE,OAAO;AACL,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,MAAM,QAAQ,WAAW,KAAK,UAAU,cAAc,CAAC;AAEvE,SAAO,QAAQ,QAAQ,CAAC,WAAW;AACjC,QAAI,OAAO,WAAW,aAAa;AACjC,aAAO,CAAC,OAAO,KAAK;AAAA,IACtB;AAEA,QAAI,OAAO;AACT,cAAQ;AAAA,QACN;AAAA,QACA,OAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO,CAAC;AAAA,EACV,CAAC;AACH;",
-  "names": []
-}

package/dist/helpers/registerComponents.d.ts

@@ -1,22 +0,0 @@
-import { BaseConstructor } from '../Base/Base.js';
-/**
- * Register globally and mount multiple components at once.
- *
- * Each component accepts the same forms as {@link registerComponent}: a `Base`
- * constructor, a promise resolving to a constructor or module namespace, or a
- * factory function returning such a promise.
- *
- * Components are registered independently: a single failure (e.g. a rejected
- * dynamic import) does not prevent the others from being registered, and the
- * returned array contains every instance that mounted successfully. Failures
- * are logged in development.
- *
- * @link https://js-toolkit.studiometa.dev/api/helpers/registerComponents.html
- * @param ctors The components, or ways to resolve them.
- * @return A promise resolving to a flat array of mounted component instances.
- */
-export declare function registerComponents<T extends BaseConstructor = BaseConstructor>(...ctors: (T | Promise<T | {
-    default: T;
-}> | (() => Promise<T | {
-    default: T;
-}>))[]): Promise<Awaited<InstanceType<T>>[]>;

package/dist/helpers/registerComponents.js

@@ -1,21 +0,0 @@
-import { isDev } from "../utils/is.js";
-import { registerComponent } from "./registerComponent.js";
-async function registerComponents(...ctors) {
-  const results = await Promise.allSettled(ctors.map((ctor) => registerComponent(ctor)));
-  return results.flatMap((result) => {
-    if (result.status === "fulfilled") {
-      return result.value;
-    }
-    if (isDev) {
-      console.error(
-        "[registerComponents] A component failed to register and was skipped.",
-        result.reason
-      );
-    }
-    return [];
-  });
-}
-export {
-  registerComponents
-};
-//# sourceMappingURL=registerComponents.js.map

package/dist/helpers/registerComponents.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../packages/js-toolkit/helpers/registerComponents.ts"],
-  "sourcesContent": ["import { BaseConstructor } from '../Base/Base.js';\nimport { isDev } from '../utils/is.js';\nimport { registerComponent } from './registerComponent.js';\n\n/**\n * Register globally and mount multiple components at once.\n *\n * Each component accepts the same forms as {@link registerComponent}: a `Base`\n * constructor, a promise resolving to a constructor or module namespace, or a\n * factory function returning such a promise.\n *\n * Components are registered independently: a single failure (e.g. a rejected\n * dynamic import) does not prevent the others from being registered, and the\n * returned array contains every instance that mounted successfully. Failures\n * are logged in development.\n *\n * @link https://js-toolkit.studiometa.dev/api/helpers/registerComponents.html\n * @param ctors The components, or ways to resolve them.\n * @return A promise resolving to a flat array of mounted component instances.\n */\nexport async function registerComponents<T extends BaseConstructor = BaseConstructor>(\n  ...ctors: (T | Promise<T | { default: T }> | (() => Promise<T | { default: T }>))[]\n) {\n  const results = await Promise.allSettled(ctors.map((ctor) => registerComponent(ctor)));\n\n  return results.flatMap((result) => {\n    if (result.status === 'fulfilled') {\n      return result.value;\n    }\n\n    if (isDev) {\n      console.error(\n        '[registerComponents] A component failed to register and was skipped.',\n        result.reason,\n      );\n    }\n\n    return [];\n  });\n}\n"],
-  "mappings": "AACA,SAAS,aAAa;AACtB,SAAS,yBAAyB;AAkBlC,eAAsB,sBACjB,OACH;AACA,QAAM,UAAU,MAAM,QAAQ,WAAW,MAAM,IAAI,CAAC,SAAS,kBAAkB,IAAI,CAAC,CAAC;AAErF,SAAO,QAAQ,QAAQ,CAAC,WAAW;AACjC,QAAI,OAAO,WAAW,aAAa;AACjC,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,OAAO;AACT,cAAQ;AAAA,QACN;AAAA,QACA,OAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO,CAAC;AAAA,EACV,CAAC;AACH;",
-  "names": []
-}

package/dist/helpers/utils.d.ts

@@ -1,10 +0,0 @@
-/**
- * Get the target elements for the lazy import helper functions.
- *
- * @param {string|HTMLElement|HTMLElement[]} nameOrSelectorOrElement
- *   The original selector or element, or list of elements.
- * @param {HTMLElement} [context]
- *   The optional context to use to query for elements.
- * @return {HTMLElement[]} A normalized list of elements.
- */
-export declare function getTargetElements(nameOrSelectorOrElement: string | HTMLElement | HTMLElement[], context: HTMLElement): HTMLElement[];

package/dist/helpers/utils.js

@@ -1,15 +0,0 @@
-import { getComponentElements } from "../Base/utils.js";
-import { isArray, isString } from "../utils/is.js";
-function getTargetElements(nameOrSelectorOrElement, context) {
-  if (isString(nameOrSelectorOrElement)) {
-    return getComponentElements(nameOrSelectorOrElement, context);
-  }
-  if (!isArray(nameOrSelectorOrElement)) {
-    return [nameOrSelectorOrElement];
-  }
-  return nameOrSelectorOrElement;
-}
-export {
-  getTargetElements
-};
-//# sourceMappingURL=utils.js.map

package/dist/helpers/utils.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../packages/js-toolkit/helpers/utils.ts"],
-  "sourcesContent": ["/* eslint-disable import/prefer-default-export */\nimport { getComponentElements } from '../Base/utils.js';\nimport { isArray, isString } from '../utils/is.js';\n\n/**\n * Get the target elements for the lazy import helper functions.\n *\n * @param {string|HTMLElement|HTMLElement[]} nameOrSelectorOrElement\n *   The original selector or element, or list of elements.\n * @param {HTMLElement} [context]\n *   The optional context to use to query for elements.\n * @return {HTMLElement[]} A normalized list of elements.\n */\nexport function getTargetElements(\n  nameOrSelectorOrElement: string | HTMLElement | HTMLElement[],\n  context: HTMLElement,\n): HTMLElement[] {\n  if (isString(nameOrSelectorOrElement)) {\n    return getComponentElements(nameOrSelectorOrElement, context);\n  }\n\n  if (!isArray(nameOrSelectorOrElement)) {\n    return [nameOrSelectorOrElement];\n  }\n\n  return nameOrSelectorOrElement;\n}\n"],
-  "mappings": "AACA,SAAS,4BAA4B;AACrC,SAAS,SAAS,gBAAgB;AAW3B,SAAS,kBACd,yBACA,SACe;AACf,MAAI,SAAS,uBAAuB,GAAG;AACrC,WAAO,qBAAqB,yBAAyB,OAAO;AAAA,EAC9D;AAEA,MAAI,CAAC,QAAQ,uBAAuB,GAAG;AACrC,WAAO,CAAC,uBAAuB;AAAA,EACjC;AAEA,SAAO;AACT;",
-  "names": []
-}

package/dist/index.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../packages/js-toolkit/index.ts"],
-  "sourcesContent": ["export { version } from './version.js';\n\nexport {\n  Base,\n  getInstances,\n  type BaseAsyncConstructor,\n  type BaseChildren,\n  type BaseConfig,\n  type BaseConfigComponents,\n  type BaseConstructor,\n  type BaseEl,\n  type BaseOptions,\n  type BaseProps,\n  type BaseRefs,\n  type Managers,\n} from './Base/index.js';\nexport { type BaseDecorator, type BaseEventHookParams, type BaseInterface } from './Base/types.js';\nexport {\n  getScopedGroups,\n  withBreakpointManager,\n  withBreakpointObserver,\n  withDrag,\n  withExtraConfig,\n  withFreezedOptions,\n  withGroup,\n  withIntersectionObserver,\n  withMountOnMediaQuery,\n  withMountWhenInView,\n  withMountWhenPrefersMotion,\n  withMutation,\n  withName,\n  withRelativePointer,\n  withResponsiveOptions,\n  withScrolledInView,\n  type DragDecoratorOptions,\n  type MutationDecoratorOptions,\n  type NormalizedOffset,\n  type OffsetValue,\n  type RelativePointerDecoratorOptions,\n  type RelativePointerInterface,\n  type ScrollInViewProps,\n  type WithBreakpointObserverInterface,\n  type WithBreakpointObserverProps,\n  type WithDragInterface,\n  type WithFreezedOptionsInterface,\n  type WithGroupInterface,\n  type WithGroupOptions,\n  type WithGroupProps,\n  type WithIntersectionObserverInterface,\n  type WithIntersectionObserverProps,\n  type WithMountWhenInViewInterface,\n  type WithMountWhenInViewProps,\n  type WithMutationInterface,\n  type WithScrolledInViewInterface,\n  type WithScrolledInViewOptions,\n  type WithScrolledInViewProps,\n  type withMountOnMediaQueryInterface,\n  type withMountOnMediaQueryProps,\n} from './decorators/index.js';\nexport {\n  closestComponent,\n  createApp,\n  defineFeatures,\n  getClosestParent,\n  getDirectChildren,\n  getInstanceFromElement,\n  importOnInteraction,\n  importOnMediaQuery,\n  importWhenIdle,\n  importWhenPrefersMotion,\n  importWhenVisible,\n  isDirectChild,\n  logTree,\n  queryComponent,\n  queryComponentAll,\n  registerComponent,\n  registerComponents,\n  type CreateAppOptions,\n  type QueryOptions,\n} from './helpers/index.js';\nexport {\n  AbstractService,\n  DragService,\n  KeyService,\n  LoadService,\n  MutationService,\n  PointerService,\n  RafService,\n  ResizeService,\n  ScrollService,\n  useDrag,\n  useKey,\n  useLoad,\n  useMutation,\n  usePointer,\n  useRaf,\n  useResize,\n  useScroll,\n  type DragServiceInterface,\n  type DragServiceOptions,\n  type DragServiceProps,\n  type KeyServiceInterface,\n  type KeyServiceProps,\n  type LoadServiceInterface,\n  type LoadServiceProps,\n  type MutationServiceInterface,\n  type MutationServiceOptions,\n  type MutationServiceProps,\n  type PointerServiceInterface,\n  type PointerServiceProps,\n  type RafServiceInterface,\n  type RafServiceProps,\n  type ResizeServiceInterface,\n  type ResizeServiceProps,\n  type ScrollServiceInterface,\n  type ScrollServiceProps,\n  type ServiceConfig,\n  type ServiceInterface,\n} from './services/index.js';\nexport {\n  ComponentLoader,\n  DEFAULT_DIAGNOSTIC_PREFIX,\n  VISIBLE_ROOT_MARGIN,\n  IDLE_TIMEOUT,\n  autoload,\n  composeManifests,\n  registerManifest,\n  registerManifests,\n  readEagerTokens,\n  defineManifest,\n  fromMetaGlob,\n  fromWebpackContext,\n  type ComponentLoadStrategy,\n  type ComponentManifestEntry,\n  type ComponentManifest,\n  type LoaderDependencies,\n  type ComponentLoaderOptions,\n  type ComponentLoaderStartOptions,\n  type AutoloadOptions,\n  type AutoloadHandle,\n  type AutoloadRuntime,\n  type RegisterManifestOptions,\n  type ModuleRecord,\n  type ComponentOverride,\n  type DefineManifestOptions,\n  type WebpackContextLike,\n} from './autoload/index.js';\n"],
-  "mappings": "AAAA,SAAS,eAAe;AAExB;AAAA,EACE;AAAA,EACA;AAAA,OAWK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAyBK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAqBK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAeK;",
-  "names": []
-}

package/dist/services/AbstractService.d.ts

@@ -1,98 +0,0 @@
-export interface ServiceInterface<T> {
-    /**
-     * Remove a function from the resize service by its key.
-     */
-    remove(key: string | symbol): void;
-    /**
-     * Add a callback to the service. The callback will receive the current service props as parameter.
-     */
-    add(key: string | symbol, callback: (props: T) => void): void;
-    /**
-     * Test if the service has alreaydy a callback for the given key.
-     */
-    has(key: string | symbol): boolean;
-    /**
-     * Get the service's props.
-     */
-    props(): T;
-}
-/**
- * Service configuration of events to be attached to targets.
- */
-export type ServiceConfig = [
-    (instance: AbstractService) => EventTarget,
-    [
-        string,
-        AddEventListenerOptions?
-    ][]
-][];
-/**
- * AbstractService class.
- */
-export declare class AbstractService<PropsType = any> {
-    /**
-     * Used to type `this.constructor` correctly
-     * @link https://github.com/microsoft/TypeScript/issues/3841#issuecomment-2381594311
-     */
-    ['constructor']: typeof AbstractService;
-    /**
-     * Service configuration.
-     */
-    static config: ServiceConfig;
-    /**
-     * Cache for the created instances.
-     */
-    static __instances: Map<any, any>;
-    /**
-     * Get a service instance as a singleton based on the given key.
-     */
-    static getInstance<T extends ServiceInterface<any>>(keys?: any, ...args: any[]): T;
-    /**
-     * Is the service active or not?
-     */
-    __isInit: boolean;
-    /**
-     * Props for the service.
-     */
-    props: {};
-    /**
-     * Holds all the callbacks that will be triggered.
-     */
-    callbacks: Map<string | symbol, (props: PropsType) => unknown>;
-    /**
-     * Does the service has the given key?
-     */
-    has(key: string | symbol): boolean;
-    /**
-     * Get a service callback by its key.
-     */
-    get(key: string | symbol): (props: PropsType) => unknown;
-    /**
-     * Add a callback to the service.
-     */
-    add(key: string | symbol, callback: (props: PropsType) => unknown): void;
-    /**
-     * Remove a callback from the service by its key.
-     */
-    remove(key: string | symbol): void;
-    /**
-     * Trigger all service callbacks with service props.
-     */
-    trigger(props: PropsType): void;
-    /**
-     * Implements the EventListenerObject interface.
-     */
-    handleEvent(_event: Event): void;
-    /**
-     * Add or remove event listeners based on the static `config` property.
-     */
-    __manageEvents(mode: 'add' | 'remove'): void;
-    /**
-     * Triggered when the service is initialized.
-     */
-    init(): void;
-    /**
-     * Triggered when the service is killed.
-     */
-    kill(): void;
-}

package/dist/services/AbstractService.js

@@ -1,114 +0,0 @@
-import { cache } from "../utils/cache.js";
-class AbstractService {
-  /**
-   * Service configuration.
-   */
-  static config = [];
-  /**
-   * Cache for the created instances.
-   */
-  static __instances = /* @__PURE__ */ new Map();
-  /**
-   * Get a service instance as a singleton based on the given key.
-   */
-  static getInstance(keys = [this], ...args) {
-    return cache(keys, () => {
-      const instance = new this(...args);
-      return {
-        add: (key, callback) => instance.add(key, callback),
-        remove: (key) => instance.remove(key),
-        has: (key) => instance.has(key),
-        props: () => instance.props
-      };
-    });
-  }
-  /**
-   * Is the service active or not?
-   */
-  __isInit = false;
-  /**
-   * Props for the service.
-   */
-  props = {};
-  /**
-   * Holds all the callbacks that will be triggered.
-   */
-  callbacks = /* @__PURE__ */ new Map();
-  /**
-   * Does the service has the given key?
-   */
-  has(key) {
-    return this.callbacks.has(key);
-  }
-  /**
-   * Get a service callback by its key.
-   */
-  get(key) {
-    return this.callbacks.get(key);
-  }
-  /**
-   * Add a callback to the service.
-   */
-  add(key, callback) {
-    if (this.has(key)) {
-      console.warn(`The key \`${String(key)}\` has already been added.`);
-      return;
-    }
-    if (this.callbacks.size === 0 && !this.__isInit) {
-      this.init();
-      this.__isInit = true;
-    }
-    this.callbacks.set(key, callback);
-  }
-  /**
-   * Remove a callback from the service by its key.
-   */
-  remove(key) {
-    this.callbacks.delete(key);
-    if (this.callbacks.size === 0 && this.__isInit) {
-      this.kill();
-      this.__isInit = false;
-    }
-  }
-  /**
-   * Trigger all service callbacks with service props.
-   */
-  trigger(props) {
-    for (const callback of this.callbacks.values()) {
-      callback(props);
-    }
-  }
-  /* v8 ignore next 6 */
-  /**
-   * Implements the EventListenerObject interface.
-   */
-  handleEvent(_event) {
-  }
-  /**
-   * Add or remove event listeners based on the static `config` property.
-   */
-  __manageEvents(mode) {
-    for (const [target, events] of this.constructor.config) {
-      const resolvedTarget = target(this);
-      for (const [type, options] of events) {
-        resolvedTarget[`${mode}EventListener`](type, this, options);
-      }
-    }
-  }
-  /**
-   * Triggered when the service is initialized.
-   */
-  init() {
-    this.__manageEvents("add");
-  }
-  /**
-   * Triggered when the service is killed.
-   */
-  kill() {
-    this.__manageEvents("remove");
-  }
-}
-export {
-  AbstractService
-};
-//# sourceMappingURL=AbstractService.js.map

package/dist/services/AbstractService.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../packages/js-toolkit/services/AbstractService.ts"],
-  "sourcesContent": ["import { cache } from '../utils/cache.js';\n\nexport interface ServiceInterface<T> {\n  /**\n   * Remove a function from the resize service by its key.\n   */\n  remove(key: string | symbol): void;\n  /**\n   * Add a callback to the service. The callback will receive the current service props as parameter.\n   */\n  add(key: string | symbol, callback: (props: T) => void): void;\n  /**\n   * Test if the service has alreaydy a callback for the given key.\n   */\n  has(key: string | symbol): boolean;\n  /**\n   * Get the service's props.\n   */\n  props(): T;\n}\n\n/**\n * Service configuration of events to be attached to targets.\n */\nexport type ServiceConfig = [\n  (instance: AbstractService) => EventTarget,\n  [string, AddEventListenerOptions?][],\n][];\n\n/**\n * AbstractService class.\n */\nexport class AbstractService<PropsType = any> {\n  /**\n   * Used to type `this.constructor` correctly\n   * @link https://github.com/microsoft/TypeScript/issues/3841#issuecomment-2381594311\n   */\n  declare ['constructor']: typeof AbstractService;\n\n  /**\n   * Service configuration.\n   */\n  static config: ServiceConfig = [];\n\n  /**\n   * Cache for the created instances.\n   */\n  static __instances = new Map();\n\n  /**\n   * Get a service instance as a singleton based on the given key.\n   */\n  static getInstance<T extends ServiceInterface<any>>(keys: any = [this], ...args: any[]) {\n    return cache(keys, () => {\n      // @ts-ignore\n      const instance = new this(...args);\n      return {\n        add: (key, callback) => instance.add(key, callback),\n        remove: (key) => instance.remove(key),\n        has: (key) => instance.has(key),\n        props: () => instance.props,\n      } as T;\n    });\n  }\n\n  /**\n   * Is the service active or not?\n   */\n  __isInit = false;\n\n  /**\n   * Props for the service.\n   */\n  props = {};\n\n  /**\n   * Holds all the callbacks that will be triggered.\n   */\n  callbacks: Map<string | symbol, (props: PropsType) => unknown> = new Map();\n\n  /**\n   * Does the service has the given key?\n   */\n  has(key: string | symbol): boolean {\n    return this.callbacks.has(key);\n  }\n\n  /**\n   * Get a service callback by its key.\n   */\n  get(key: string | symbol): (props: PropsType) => unknown {\n    return this.callbacks.get(key);\n  }\n\n  /**\n   * Add a callback to the service.\n   */\n  add(key: string | symbol, callback: (props: PropsType) => unknown) {\n    if (this.has(key)) {\n      console.warn(`The key \\`${String(key)}\\` has already been added.`);\n      return;\n    }\n\n    // Initialize the service when we add the first callback\n    if (this.callbacks.size === 0 && !this.__isInit) {\n      this.init();\n      this.__isInit = true;\n    }\n\n    this.callbacks.set(key, callback);\n  }\n\n  /**\n   * Remove a callback from the service by its key.\n   */\n  remove(key: string | symbol) {\n    this.callbacks.delete(key);\n\n    // Kill the service when we remove the last callback\n    if (this.callbacks.size === 0 && this.__isInit) {\n      this.kill();\n      this.__isInit = false;\n    }\n  }\n\n  /**\n   * Trigger all service callbacks with service props.\n   */\n  trigger(props: PropsType) {\n    for (const callback of this.callbacks.values()) {\n      callback(props);\n    }\n  }\n\n  /* v8 ignore next 6 */\n  /**\n   * Implements the EventListenerObject interface.\n   */\n  handleEvent(_event: Event) {\n    // Should be implemented.\n  }\n\n  /**\n   * Add or remove event listeners based on the static `config` property.\n   */\n  __manageEvents(mode: 'add' | 'remove') {\n    for (const [target, events] of this.constructor.config) {\n      const resolvedTarget = target(this);\n      for (const [type, options] of events) {\n        resolvedTarget[`${mode}EventListener`](type, this, options);\n      }\n    }\n  }\n\n  /**\n   * Triggered when the service is initialized.\n   */\n  init() {\n    this.__manageEvents('add');\n  }\n\n  /**\n   * Triggered when the service is killed.\n   */\n  kill() {\n    this.__manageEvents('remove');\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,aAAa;AAgCf,MAAM,gBAAiC;AAAA;AAAA;AAAA;AAAA,EAU5C,OAAO,SAAwB,CAAC;AAAA;AAAA;AAAA;AAAA,EAKhC,OAAO,cAAc,oBAAI,IAAI;AAAA;AAAA;AAAA;AAAA,EAK7B,OAAO,YAA6C,OAAY,CAAC,IAAI,MAAM,MAAa;AACtF,WAAO,MAAM,MAAM,MAAM;AAEvB,YAAM,WAAW,IAAI,KAAK,GAAG,IAAI;AACjC,aAAO;AAAA,QACL,KAAK,CAAC,KAAK,aAAa,SAAS,IAAI,KAAK,QAAQ;AAAA,QAClD,QAAQ,CAAC,QAAQ,SAAS,OAAO,GAAG;AAAA,QACpC,KAAK,CAAC,QAAQ,SAAS,IAAI,GAAG;AAAA,QAC9B,OAAO,MAAM,SAAS;AAAA,MACxB;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW;AAAA;AAAA;AAAA;AAAA,EAKX,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA,EAKT,YAAiE,oBAAI,IAAI;AAAA;AAAA;AAAA;AAAA,EAKzE,IAAI,KAA+B;AACjC,WAAO,KAAK,UAAU,IAAI,GAAG;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,KAAqD;AACvD,WAAO,KAAK,UAAU,IAAI,GAAG;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,KAAsB,UAAyC;AACjE,QAAI,KAAK,IAAI,GAAG,GAAG;AACjB,cAAQ,KAAK,aAAa,OAAO,GAAG,CAAC,4BAA4B;AACjE;AAAA,IACF;AAGA,QAAI,KAAK,UAAU,SAAS,KAAK,CAAC,KAAK,UAAU;AAC/C,WAAK,KAAK;AACV,WAAK,WAAW;AAAA,IAClB;AAEA,SAAK,UAAU,IAAI,KAAK,QAAQ;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,KAAsB;AAC3B,SAAK,UAAU,OAAO,GAAG;AAGzB,QAAI,KAAK,UAAU,SAAS,KAAK,KAAK,UAAU;AAC9C,WAAK,KAAK;AACV,WAAK,WAAW;AAAA,IAClB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,OAAkB;AACxB,eAAW,YAAY,KAAK,UAAU,OAAO,GAAG;AAC9C,eAAS,KAAK;AAAA,IAChB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAY,QAAe;AAAA,EAE3B;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,MAAwB;AACrC,eAAW,CAAC,QAAQ,MAAM,KAAK,KAAK,YAAY,QAAQ;AACtD,YAAM,iBAAiB,OAAO,IAAI;AAClC,iBAAW,CAAC,MAAM,OAAO,KAAK,QAAQ;AACpC,uBAAe,GAAG,IAAI,eAAe,EAAE,MAAM,MAAM,OAAO;AAAA,MAC5D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO;AACL,SAAK,eAAe,KAAK;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO;AACL,SAAK,eAAe,QAAQ;AAAA,EAC9B;AACF;",
-  "names": []
-}

package/dist/services/DragService.d.ts

@@ -1,138 +0,0 @@
-import { AbstractService, type ServiceConfig, type ServiceInterface } from './AbstractService.js';
-export interface DragServiceProps {
-    /**
-     * The current mode of the dragging logic.
-     */
-    mode: 'start' | 'drag' | 'drop' | 'inertia' | 'stop';
-    /**
-     * Available modes.
-     */
-    MODES: {
-        START: 'start';
-        DRAG: 'drag';
-        DROP: 'drop';
-        INERTIA: 'inertia';
-        STOP: 'stop';
-    };
-    /**
-     * The target element of the drag.
-     */
-    target: HTMLElement;
-    /**
-     * Whether the user is currently grabbing the targeted element or not.
-     */
-    isGrabbing: boolean;
-    /**
-     * Whether the drag currently has inertia or not.
-     */
-    hasInertia: boolean;
-    /**
-     * The current horizontal position in the viewport.
-     */
-    x: number;
-    /**
-     * The current vertical position in the viewport.
-     */
-    y: number;
-    /**
-     * The delta between the current position and the last.
-     */
-    delta: {
-        x: number;
-        y: number;
-    };
-    /**
-     * The initial position where the dragging started.
-     */
-    origin: {
-        x: number;
-        y: number;
-    };
-    /**
-     * The distance from the current position to the origin.
-     */
-    distance: {
-        x: number;
-        y: number;
-    };
-    /**
-     * The final position that will be reached at the end of the inertia.
-     */
-    final: {
-        x: number;
-        y: number;
-    };
-}
-export type DragServiceInterface = ServiceInterface<DragServiceProps>;
-export interface DragServiceOptions {
-    dampFactor?: number;
-    dragTreshold?: number;
-}
-export declare class DragService extends AbstractService<DragServiceProps> {
-    static MODES: {
-        readonly START: 'start';
-        readonly DRAG: 'drag';
-        readonly DROP: 'drop';
-        readonly INERTIA: 'inertia';
-        readonly STOP: 'stop';
-    };
-    static config: ServiceConfig;
-    id: string;
-    dampFactor: number;
-    dragTreshold: number;
-    previousEvent: TouchEvent | MouseEvent;
-    props: DragServiceProps;
-    /**
-     * Test if we should allow click on links and buttons.
-     */
-    get shouldPreventClick(): boolean;
-    constructor(target: HTMLElement, { dampFactor, dragTreshold }?: DragServiceOptions);
-    /**
-     * Get the client value for the given axis.
-     */
-    getEventPosition(event: MouseEvent | TouchEvent): {
-        x: number;
-        y: number;
-    };
-    /**
-     * Start the drag.
-     *
-     * @param {number} x The initial horizontal position.
-     * @param {number} y The initial vertical position.
-     */
-    start(x: number, y: number): void;
-    /**
-     * Stop the drag, or drop.
-     */
-    drop(): void;
-    /**
-     * Stop the drag.
-     */
-    stop(): void;
-    /**
-     * Raf service handler.
-     */
-    rafHandler(): void;
-    /**
-     * Pointer service handler.
-     */
-    drag(event: TouchEvent | MouseEvent): void;
-    /**
-     * Handle any event.
-     */
-    handleEvent(event: TouchEvent | MouseEvent | PointerEvent | DragEvent): void;
-}
-/**
- * Use the drag service.
- *
- * ```js
- * import { useDrag } from '@studiometa/js-toolkit/services';
- * const element = document.querySelector('.draggable');
- * const { add, remove, props } = useDrag(element, { dampFactor: 0.5 });
- * add('key', (props) => console.log(props));
- * remove('key');
- * props();
- * ```
- * @link https://js-toolkit.studiometa.dev/api/services/useDrag.html
- */
-export declare function useDrag(target: HTMLElement, options: DragServiceOptions): DragServiceInterface;