@studiometa/js-toolkit 3.7.0 → 3.8.1-beta.0

package/Base/index.d.ts

@@ -1,2 +1,2 @@
-export * from './Base.js';
+export { Base, type BaseAsyncConstructor, type BaseChildren, type BaseConfig, type BaseConfigComponents, type BaseConstructor, type BaseEl, type BaseOptions, type BaseProps, type BaseRefs, type Managers, } from './Base.js';
 export { getInstances } from './utils.js';

package/Base/index.js

@@ -1,6 +1,9 @@
-export * from "./Base.js";
+import {
+  Base
+} from "./Base.js";
 import { getInstances } from "./utils.js";
 export {
+  Base,
   getInstances
 };
 //# sourceMappingURL=index.js.map

package/Base/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/Base/index.ts"],
-  "sourcesContent": ["export * from './Base.js';\nexport { getInstances } from './utils.js';\n"],
-  "mappings": "AAAA,cAAc;AACd,SAAS,oBAAoB;",
+  "sourcesContent": ["export {\n  Base,\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.js';\nexport { getInstances } from './utils.js';\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAWK;AACP,SAAS,oBAAoB;",
   "names": []
 }

package/decorators/index.d.ts

@@ -1,15 +1,15 @@
-export * from './withBreakpointManager.js';
-export * from './withBreakpointObserver.js';
-export * from './withDrag.js';
-export * from './withExtraConfig.js';
-export * from './withFreezedOptions.js';
-export * from './withIntersectionObserver.js';
-export * from './withMountOnMediaQuery.js';
-export * from './withMountWhenInView.js';
-export * from './withMountWhenPrefersMotion.js';
-export * from './withMutation.js';
-export * from './withName.js';
-export * from './withRelativePointer.js';
-export * from './withResponsiveOptions.js';
-export * from './withScrolledInView/index.js';
-export * from './withGroup.js';
+export { withBreakpointManager } from './withBreakpointManager.js';
+export { withBreakpointObserver, type WithBreakpointObserverInterface, type WithBreakpointObserverProps, } from './withBreakpointObserver.js';
+export { withDrag, type DragDecoratorOptions, type WithDragInterface } from './withDrag.js';
+export { withExtraConfig } from './withExtraConfig.js';
+export { withFreezedOptions, type WithFreezedOptionsInterface } from './withFreezedOptions.js';
+export { withIntersectionObserver, type WithIntersectionObserverInterface, type WithIntersectionObserverProps, } from './withIntersectionObserver.js';
+export { withMountOnMediaQuery, type withMountOnMediaQueryInterface, type withMountOnMediaQueryProps, } from './withMountOnMediaQuery.js';
+export { withMountWhenInView, type WithMountWhenInViewInterface, type WithMountWhenInViewProps, } from './withMountWhenInView.js';
+export { withMountWhenPrefersMotion } from './withMountWhenPrefersMotion.js';
+export { withMutation, type MutationDecoratorOptions, type WithMutationInterface, } from './withMutation.js';
+export { withName } from './withName.js';
+export { withRelativePointer, type RelativePointerDecoratorOptions, type RelativePointerInterface, } from './withRelativePointer.js';
+export { withResponsiveOptions } from './withResponsiveOptions.js';
+export { withScrolledInView, type NormalizedOffset, type OffsetValue, type ScrollInViewProps, type WithScrolledInViewInterface, type WithScrolledInViewOptions, type WithScrolledInViewProps, } from './withScrolledInView/index.js';
+export { getScopedGroups, withGroup, type WithGroupInterface, type WithGroupOptions, type WithGroupProps, } from './withGroup.js';

package/decorators/index.js

@@ -1,16 +1,51 @@
-export * from "./withBreakpointManager.js";
-export * from "./withBreakpointObserver.js";
-export * from "./withDrag.js";
-export * from "./withExtraConfig.js";
-export * from "./withFreezedOptions.js";
-export * from "./withIntersectionObserver.js";
-export * from "./withMountOnMediaQuery.js";
-export * from "./withMountWhenInView.js";
-export * from "./withMountWhenPrefersMotion.js";
-export * from "./withMutation.js";
-export * from "./withName.js";
-export * from "./withRelativePointer.js";
-export * from "./withResponsiveOptions.js";
-export * from "./withScrolledInView/index.js";
-export * from "./withGroup.js";
+import { withBreakpointManager } from "./withBreakpointManager.js";
+import {
+  withBreakpointObserver
+} from "./withBreakpointObserver.js";
+import { withDrag } from "./withDrag.js";
+import { withExtraConfig } from "./withExtraConfig.js";
+import { withFreezedOptions } from "./withFreezedOptions.js";
+import {
+  withIntersectionObserver
+} from "./withIntersectionObserver.js";
+import {
+  withMountOnMediaQuery
+} from "./withMountOnMediaQuery.js";
+import {
+  withMountWhenInView
+} from "./withMountWhenInView.js";
+import { withMountWhenPrefersMotion } from "./withMountWhenPrefersMotion.js";
+import {
+  withMutation
+} from "./withMutation.js";
+import { withName } from "./withName.js";
+import {
+  withRelativePointer
+} from "./withRelativePointer.js";
+import { withResponsiveOptions } from "./withResponsiveOptions.js";
+import {
+  withScrolledInView
+} from "./withScrolledInView/index.js";
+import {
+  getScopedGroups,
+  withGroup
+} from "./withGroup.js";
+export {
+  getScopedGroups,
+  withBreakpointManager,
+  withBreakpointObserver,
+  withDrag,
+  withExtraConfig,
+  withFreezedOptions,
+  withGroup,
+  withIntersectionObserver,
+  withMountOnMediaQuery,
+  withMountWhenInView,
+  withMountWhenPrefersMotion,
+  withMutation,
+  withName,
+  withRelativePointer,
+  withResponsiveOptions,
+  withScrolledInView
+};
 //# sourceMappingURL=index.js.map

package/decorators/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/decorators/index.ts"],
-  "sourcesContent": ["export * from './withBreakpointManager.js';\nexport * from './withBreakpointObserver.js';\nexport * from './withDrag.js';\nexport * from './withExtraConfig.js';\nexport * from './withFreezedOptions.js';\nexport * from './withIntersectionObserver.js';\nexport * from './withMountOnMediaQuery.js';\nexport * from './withMountWhenInView.js';\nexport * from './withMountWhenPrefersMotion.js';\nexport * from './withMutation.js';\nexport * from './withName.js';\nexport * from './withRelativePointer.js';\nexport * from './withResponsiveOptions.js';\nexport * from './withScrolledInView/index.js';\nexport * from './withGroup.js';\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export { withBreakpointManager } from './withBreakpointManager.js';\nexport {\n  withBreakpointObserver,\n  type WithBreakpointObserverInterface,\n  type WithBreakpointObserverProps,\n} from './withBreakpointObserver.js';\nexport { withDrag, type DragDecoratorOptions, type WithDragInterface } from './withDrag.js';\nexport { withExtraConfig } from './withExtraConfig.js';\nexport { withFreezedOptions, type WithFreezedOptionsInterface } from './withFreezedOptions.js';\nexport {\n  withIntersectionObserver,\n  type WithIntersectionObserverInterface,\n  type WithIntersectionObserverProps,\n} from './withIntersectionObserver.js';\nexport {\n  withMountOnMediaQuery,\n  type withMountOnMediaQueryInterface,\n  type withMountOnMediaQueryProps,\n} from './withMountOnMediaQuery.js';\nexport {\n  withMountWhenInView,\n  type WithMountWhenInViewInterface,\n  type WithMountWhenInViewProps,\n} from './withMountWhenInView.js';\nexport { withMountWhenPrefersMotion } from './withMountWhenPrefersMotion.js';\nexport {\n  withMutation,\n  type MutationDecoratorOptions,\n  type WithMutationInterface,\n} from './withMutation.js';\nexport { withName } from './withName.js';\nexport {\n  withRelativePointer,\n  type RelativePointerDecoratorOptions,\n  type RelativePointerInterface,\n} from './withRelativePointer.js';\nexport { withResponsiveOptions } from './withResponsiveOptions.js';\nexport {\n  withScrolledInView,\n  type NormalizedOffset,\n  type OffsetValue,\n  type ScrollInViewProps,\n  type WithScrolledInViewInterface,\n  type WithScrolledInViewOptions,\n  type WithScrolledInViewProps,\n} from './withScrolledInView/index.js';\nexport {\n  getScopedGroups,\n  withGroup,\n  type WithGroupInterface,\n  type WithGroupOptions,\n  type WithGroupProps,\n} from './withGroup.js';\n"],
+  "mappings": "AAAA,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,OAGK;AACP,SAAS,gBAAmE;AAC5E,SAAS,uBAAuB;AAChC,SAAS,0BAA4D;AACrE;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACE;AAAA,OAGK;AACP,SAAS,kCAAkC;AAC3C;AAAA,EACE;AAAA,OAGK;AACP,SAAS,gBAAgB;AACzB;AAAA,EACE;AAAA,OAGK;AACP,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,OAOK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;",
   "names": []
 }

package/decorators/withScrolledInView/index.d.ts

@@ -1,2 +1,2 @@
-export * from './withScrolledInView.js';
-export * from './types.js';
+export { withScrolledInView, type ScrollInViewProps, type WithScrolledInViewInterface, type WithScrolledInViewOptions, type WithScrolledInViewProps, } from './withScrolledInView.js';
+export { type NormalizedOffset, type OffsetValue } from './types.js';

package/decorators/withScrolledInView/index.js

@@ -1,3 +1,7 @@
-export * from "./withScrolledInView.js";
-export * from "./types.js";
+import {
+  withScrolledInView
+} from "./withScrolledInView.js";
+export {
+  withScrolledInView
+};
 //# sourceMappingURL=index.js.map

package/decorators/withScrolledInView/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/decorators/withScrolledInView/index.ts"],
-  "sourcesContent": ["export * from './withScrolledInView.js';\nexport * from './types.js';\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export {\n  withScrolledInView,\n  type ScrollInViewProps,\n  type WithScrolledInViewInterface,\n  type WithScrolledInViewOptions,\n  type WithScrolledInViewProps,\n} from './withScrolledInView.js';\nexport { type NormalizedOffset, type OffsetValue } from './types.js';\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAKK;",
   "names": []
 }

package/helpers/index.d.ts

@@ -1,13 +1,14 @@
-export * from './createApp.js';
-export * from './defineFeatures.js';
-export * from './getClosestParent.js';
-export * from './getDirectChildren.js';
-export * from './getInstanceFromElement.js';
-export * from './importOnInteraction.js';
-export * from './importOnMediaQuery.js';
-export * from './importWhenIdle.js';
-export * from './importWhenPrefersMotion.js';
-export * from './importWhenVisible.js';
-export * from './logTree.js';
-export * from './registerComponent.js';
+export { createApp, type CreateAppOptions } from './createApp.js';
+export { defineFeatures } from './defineFeatures.js';
+export { getClosestParent } from './getClosestParent.js';
+export { getDirectChildren, isDirectChild } from './getDirectChildren.js';
+export { getInstanceFromElement } from './getInstanceFromElement.js';
+export { importOnInteraction } from './importOnInteraction.js';
+export { importOnMediaQuery } from './importOnMediaQuery.js';
+export { importWhenIdle } from './importWhenIdle.js';
+export { importWhenPrefersMotion } from './importWhenPrefersMotion.js';
+export { importWhenVisible } from './importWhenVisible.js';
+export { logTree } from './logTree.js';
+export { registerComponent } from './registerComponent.js';
+export { registerComponents } from './registerComponents.js';
 export { type QueryOptions, queryComponent, queryComponentAll, closestComponent, } from './queryComponent.js';

package/helpers/index.js

@@ -1,15 +1,16 @@
-export * from "./createApp.js";
-export * from "./defineFeatures.js";
-export * from "./getClosestParent.js";
-export * from "./getDirectChildren.js";
-export * from "./getInstanceFromElement.js";
-export * from "./importOnInteraction.js";
-export * from "./importOnMediaQuery.js";
-export * from "./importWhenIdle.js";
-export * from "./importWhenPrefersMotion.js";
-export * from "./importWhenVisible.js";
-export * from "./logTree.js";
-export * from "./registerComponent.js";
+import { createApp } from "./createApp.js";
+import { defineFeatures } from "./defineFeatures.js";
+import { getClosestParent } from "./getClosestParent.js";
+import { getDirectChildren, isDirectChild } from "./getDirectChildren.js";
+import { getInstanceFromElement } from "./getInstanceFromElement.js";
+import { importOnInteraction } from "./importOnInteraction.js";
+import { importOnMediaQuery } from "./importOnMediaQuery.js";
+import { importWhenIdle } from "./importWhenIdle.js";
+import { importWhenPrefersMotion } from "./importWhenPrefersMotion.js";
+import { importWhenVisible } from "./importWhenVisible.js";
+import { logTree } from "./logTree.js";
+import { registerComponent } from "./registerComponent.js";
+import { registerComponents } from "./registerComponents.js";
 import {
   queryComponent,
   queryComponentAll,
@@ -17,7 +18,21 @@ import {
 } from "./queryComponent.js";
 export {
   closestComponent,
+  createApp,
+  defineFeatures,
+  getClosestParent,
+  getDirectChildren,
+  getInstanceFromElement,
+  importOnInteraction,
+  importOnMediaQuery,
+  importWhenIdle,
+  importWhenPrefersMotion,
+  importWhenVisible,
+  isDirectChild,
+  logTree,
   queryComponent,
-  queryComponentAll
+  queryComponentAll,
+  registerComponent,
+  registerComponents
 };
 //# sourceMappingURL=index.js.map

package/helpers/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/helpers/index.ts"],
-  "sourcesContent": ["export * from './createApp.js';\nexport * from './defineFeatures.js';\nexport * from './getClosestParent.js';\nexport * from './getDirectChildren.js';\nexport * from './getInstanceFromElement.js';\nexport * from './importOnInteraction.js';\nexport * from './importOnMediaQuery.js';\nexport * from './importWhenIdle.js';\nexport * from './importWhenPrefersMotion.js';\nexport * from './importWhenVisible.js';\nexport * from './logTree.js';\nexport * from './registerComponent.js';\nexport {\n  type QueryOptions,\n  queryComponent,\n  queryComponentAll,\n  closestComponent,\n} from './queryComponent.js';\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
+  "sourcesContent": ["export { createApp, type CreateAppOptions } from './createApp.js';\nexport { defineFeatures } from './defineFeatures.js';\nexport { getClosestParent } from './getClosestParent.js';\nexport { getDirectChildren, isDirectChild } from './getDirectChildren.js';\nexport { getInstanceFromElement } from './getInstanceFromElement.js';\nexport { importOnInteraction } from './importOnInteraction.js';\nexport { importOnMediaQuery } from './importOnMediaQuery.js';\nexport { importWhenIdle } from './importWhenIdle.js';\nexport { importWhenPrefersMotion } from './importWhenPrefersMotion.js';\nexport { importWhenVisible } from './importWhenVisible.js';\nexport { logTree } from './logTree.js';\nexport { registerComponent } from './registerComponent.js';\nexport { registerComponents } from './registerComponents.js';\nexport {\n  type QueryOptions,\n  queryComponent,\n  queryComponentAll,\n  closestComponent,\n} from './queryComponent.js';\n"],
+  "mappings": "AAAA,SAAS,iBAAwC;AACjD,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC,SAAS,mBAAmB,qBAAqB;AACjD,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AACpC,SAAS,0BAA0B;AACnC,SAAS,sBAAsB;AAC/B,SAAS,+BAA+B;AACxC,SAAS,yBAAyB;AAClC,SAAS,eAAe;AACxB,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AACnC;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
   "names": []
 }

package/helpers/registerComponent.d.ts

@@ -1,10 +1,24 @@
 import { BaseConstructor } from '../Base/Base.js';
 /**
- * Register globally and mount a given component, or a promise resolving to a component.
+ * 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 promise resolving to it.
+ * @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>, nameOrSelector?: string): Promise<Awaited<InstanceType<T>>[]>;
+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/helpers/registerComponent.js

@@ -1,9 +1,28 @@
+import { isDev, isFunction } from "../utils/index.js";
 async function registerComponent(ctor, nameOrSelector) {
+  if (isFunction(ctor) && !("$isBase" in ctor)) {
+    ctor = ctor(void 0);
+  }
+  let Ctor;
   if (ctor instanceof Promise) {
-    ctor = await ctor;
+    const module = await ctor;
+    Ctor = "$isBase" in module ? module : module.default;
+  } else {
+    Ctor = ctor;
   }
-  const instances = await Promise.all(ctor.$register(nameOrSelector));
-  return instances;
+  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

package/helpers/registerComponent.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/helpers/registerComponent.ts"],
-  "sourcesContent": ["import { BaseConstructor } from '../Base/Base.js';\n\n/**\n * Register globally and mount a given component, or a promise resolving to a component.\n *\n * @link https://js-toolkit.studiometa.dev/api/helpers/registerComponent.html\n * @param ctor The component constructor or a promise resolving to 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>,\n  nameOrSelector?: string,\n) {\n  if (ctor instanceof Promise) {\n    ctor = await ctor;\n  }\n\n  const instances = await Promise.all(ctor.$register(nameOrSelector));\n  return instances;\n}\n"],
-  "mappings": "AAUA,eAAsB,kBACpB,MACA,gBACA;AACA,MAAI,gBAAgB,SAAS;AAC3B,WAAO,MAAM;AAAA,EACf;AAEA,QAAM,YAAY,MAAM,QAAQ,IAAI,KAAK,UAAU,cAAc,CAAC;AAClE,SAAO;AACT;",
+  "sourcesContent": ["import { BaseConstructor, BaseAsyncConstructor } from '../Base/Base.js';\nimport { isDev, isFunction } from '../utils/index.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/helpers/registerComponents.d.ts

@@ -0,0 +1,22 @@
+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/helpers/registerComponents.js

@@ -0,0 +1,21 @@
+import { isDev } from "../utils/index.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/helpers/registerComponents.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../packages/js-toolkit/helpers/registerComponents.ts"],
+  "sourcesContent": ["import { BaseConstructor } from '../Base/Base.js';\nimport { isDev } from '../utils/index.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/index.d.ts

@@ -1,6 +1,6 @@
 export declare const version: '3.6.0-beta.0';
-export * from './Base/index.js';
-export * from './Base/types.js';
-export * from './decorators/index.js';
-export * from './helpers/index.js';
-export * from './services/index.js';
+export { Base, getInstances, type BaseAsyncConstructor, type BaseChildren, type BaseConfig, type BaseConfigComponents, type BaseConstructor, type BaseEl, type BaseOptions, type BaseProps, type BaseRefs, type Managers, } from './Base/index.js';
+export { type BaseDecorator, type BaseEventHookParams, type BaseInterface } from './Base/types.js';
+export { getScopedGroups, withBreakpointManager, withBreakpointObserver, withDrag, withExtraConfig, withFreezedOptions, withGroup, withIntersectionObserver, withMountOnMediaQuery, withMountWhenInView, withMountWhenPrefersMotion, withMutation, withName, withRelativePointer, withResponsiveOptions, withScrolledInView, type DragDecoratorOptions, type MutationDecoratorOptions, type NormalizedOffset, type OffsetValue, type RelativePointerDecoratorOptions, type RelativePointerInterface, type ScrollInViewProps, type WithBreakpointObserverInterface, type WithBreakpointObserverProps, type WithDragInterface, type WithFreezedOptionsInterface, type WithGroupInterface, type WithGroupOptions, type WithGroupProps, type WithIntersectionObserverInterface, type WithIntersectionObserverProps, type WithMountWhenInViewInterface, type WithMountWhenInViewProps, type WithMutationInterface, type WithScrolledInViewInterface, type WithScrolledInViewOptions, type WithScrolledInViewProps, type withMountOnMediaQueryInterface, type withMountOnMediaQueryProps, } from './decorators/index.js';
+export { closestComponent, createApp, defineFeatures, getClosestParent, getDirectChildren, getInstanceFromElement, importOnInteraction, importOnMediaQuery, importWhenIdle, importWhenPrefersMotion, importWhenVisible, isDirectChild, logTree, queryComponent, queryComponentAll, registerComponent, registerComponents, type CreateAppOptions, type QueryOptions, } from './helpers/index.js';
+export { AbstractService, DragService, KeyService, LoadService, MutationService, PointerService, RafService, ResizeService, ScrollService, useDrag, useKey, useLoad, useMutation, usePointer, useRaf, useResize, useScroll, type DragServiceInterface, type DragServiceOptions, type DragServiceProps, type KeyServiceInterface, type KeyServiceProps, type LoadServiceInterface, type LoadServiceProps, type MutationServiceInterface, type MutationServiceOptions, type MutationServiceProps, type PointerServiceInterface, type PointerServiceProps, type RafServiceInterface, type RafServiceProps, type ResizeServiceInterface, type ResizeServiceProps, type ScrollServiceInterface, type ScrollServiceProps, type ServiceConfig, type ServiceInterface, } from './services/index.js';

package/index.js

@@ -1,10 +1,117 @@
 const version = "3.6.0-beta.0";
-export * from "./Base/index.js";
-export * from "./Base/types.js";
-export * from "./decorators/index.js";
-export * from "./helpers/index.js";
-export * from "./services/index.js";
+import {
+  Base,
+  getInstances
+} from "./Base/index.js";
+import {
+  getScopedGroups,
+  withBreakpointManager,
+  withBreakpointObserver,
+  withDrag,
+  withExtraConfig,
+  withFreezedOptions,
+  withGroup,
+  withIntersectionObserver,
+  withMountOnMediaQuery,
+  withMountWhenInView,
+  withMountWhenPrefersMotion,
+  withMutation,
+  withName,
+  withRelativePointer,
+  withResponsiveOptions,
+  withScrolledInView
+} from "./decorators/index.js";
+import {
+  closestComponent,
+  createApp,
+  defineFeatures,
+  getClosestParent,
+  getDirectChildren,
+  getInstanceFromElement,
+  importOnInteraction,
+  importOnMediaQuery,
+  importWhenIdle,
+  importWhenPrefersMotion,
+  importWhenVisible,
+  isDirectChild,
+  logTree,
+  queryComponent,
+  queryComponentAll,
+  registerComponent,
+  registerComponents
+} from "./helpers/index.js";
+import {
+  AbstractService,
+  DragService,
+  KeyService,
+  LoadService,
+  MutationService,
+  PointerService,
+  RafService,
+  ResizeService,
+  ScrollService,
+  useDrag,
+  useKey,
+  useLoad,
+  useMutation,
+  usePointer,
+  useRaf,
+  useResize,
+  useScroll
+} from "./services/index.js";
 export {
-  version
+  AbstractService,
+  Base,
+  DragService,
+  KeyService,
+  LoadService,
+  MutationService,
+  PointerService,
+  RafService,
+  ResizeService,
+  ScrollService,
+  closestComponent,
+  createApp,
+  defineFeatures,
+  getClosestParent,
+  getDirectChildren,
+  getInstanceFromElement,
+  getInstances,
+  getScopedGroups,
+  importOnInteraction,
+  importOnMediaQuery,
+  importWhenIdle,
+  importWhenPrefersMotion,
+  importWhenVisible,
+  isDirectChild,
+  logTree,
+  queryComponent,
+  queryComponentAll,
+  registerComponent,
+  registerComponents,
+  useDrag,
+  useKey,
+  useLoad,
+  useMutation,
+  usePointer,
+  useRaf,
+  useResize,
+  useScroll,
+  version,
+  withBreakpointManager,
+  withBreakpointObserver,
+  withDrag,
+  withExtraConfig,
+  withFreezedOptions,
+  withGroup,
+  withIntersectionObserver,
+  withMountOnMediaQuery,
+  withMountWhenInView,
+  withMountWhenPrefersMotion,
+  withMutation,
+  withName,
+  withRelativePointer,
+  withResponsiveOptions,
+  withScrolledInView
 };
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../packages/js-toolkit/index.ts"],
-  "sourcesContent": ["export const version = '3.6.0-beta.0' as const;\n\nexport * from './Base/index.js';\nexport * from './Base/types.js';\nexport * from './decorators/index.js';\nexport * from './helpers/index.js';\nexport * from './services/index.js';\n"],
-  "mappings": "AAAO,MAAM,UAAU;AAEvB,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export const version = '3.6.0-beta.0' as const;\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';\n"],
+  "mappings": "AAAO,MAAM,UAAU;AAEvB;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;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiometa/js-toolkit",
-  "version": "3.7.0",
+  "version": "3.8.1-beta.0",
   "description": "A set of useful little bits of JavaScript to boost your project! 🚀",
   "publishConfig": {
     "access": "public"

package/services/index.d.ts

@@ -1,9 +1,9 @@
-export * from './AbstractService.js';
-export * from './DragService.js';
-export * from './KeyService.js';
-export * from './LoadService.js';
-export * from './MutationService.js';
-export * from './PointerService.js';
-export * from './RafService.js';
-export * from './ResizeService.js';
-export * from './ScrollService.js';
+export { AbstractService, type ServiceConfig, type ServiceInterface } from './AbstractService.js';
+export { DragService, useDrag, type DragServiceInterface, type DragServiceOptions, type DragServiceProps, } from './DragService.js';
+export { KeyService, useKey, type KeyServiceInterface, type KeyServiceProps, } from './KeyService.js';
+export { LoadService, useLoad, type LoadServiceInterface, type LoadServiceProps, } from './LoadService.js';
+export { MutationService, useMutation, type MutationServiceInterface, type MutationServiceOptions, type MutationServiceProps, } from './MutationService.js';
+export { PointerService, usePointer, type PointerServiceInterface, type PointerServiceProps, } from './PointerService.js';
+export { RafService, useRaf, type RafServiceInterface, type RafServiceProps, } from './RafService.js';
+export { ResizeService, useResize, type ResizeServiceInterface, type ResizeServiceProps, } from './ResizeService.js';
+export { ScrollService, useScroll, type ScrollServiceInterface, type ScrollServiceProps, } from './ScrollService.js';