@studiometa/js-toolkit 3.0.0-alpha.5 → 3.0.0-alpha.6

package/Base/Base.d.ts

@@ -126,19 +126,19 @@ export declare class Base<T extends BaseProps = BaseProps> extends EventTarget {
     /**
      * Trigger the `mounted` callback.
      */
-    $mount(): this;
+    $mount(): Promise<this>;
     /**
      * Update the instance children.
      */
-    $update(): this;
+    $update(): Promise<this>;
     /**
      * Trigger the `destroyed` callback.
      */
-    $destroy(): this;
+    $destroy(): Promise<this>;
     /**
      * Terminate a child instance when it is not needed anymore.
      */
-    $terminate(): void;
+    $terminate(): Promise<void>;
     /**
      * Add an emitted event.
      *
@@ -193,5 +193,5 @@ export declare class Base<T extends BaseProps = BaseProps> extends EventTarget {
     /**
      * Register and mount all instances of the component.
      */
-    static $register(nameOrSelector?: string): Base[];
+    static $register(nameOrSelector?: string): Array<Promise<Base>>;
 }

package/Base/Base.js

@@ -211,7 +211,7 @@ class Base extends EventTarget {
   /**
    * Trigger the `mounted` callback.
    */
-  $mount() {
+  async $mount() {
     if (this.$isMounted) {
       return this;
     }
@@ -219,59 +219,73 @@ class Base extends EventTarget {
     if (isDev) {
       this.__debug("$mount");
     }
-    addToQueue(() => this.$children.registerAll());
-    addToQueue(() => this.$refs.registerAll());
-    addToQueue(() => this.__events.bindRootElement());
-    addToQueue(() => this.$services.enableAll());
-    addToQueue(() => this.$children.mountAll());
-    addToQueue(() => this.$isMounted = true);
-    addToQueue(() => this.__callMethod("mounted"));
+    await Promise.all([
+      addToQueue(() => this.$children.registerAll()),
+      addToQueue(() => this.$refs.registerAll()),
+      addToQueue(() => this.__events.bindRootElement()),
+      addToQueue(() => this.$services.enableAll()),
+      addToQueue(() => this.$children.mountAll()),
+      addToQueue(() => this.$isMounted = true),
+      addToQueue(() => this.__callMethod("mounted"))
+    ]);
     return this;
   }
   /**
    * Update the instance children.
    */
-  $update() {
+  async $update() {
     if (isDev) {
       this.__debug("$update");
     }
-    addToQueue(() => this.$refs.unregisterAll());
-    addToQueue(() => this.$services.disableAll());
-    addToQueue(() => this.$children.registerAll());
-    addToQueue(() => this.$refs.registerAll());
-    addToQueue(() => this.$services.enableAll());
-    addToQueue(() => this.$children.updateAll());
-    addToQueue(() => this.__callMethod("updated"));
+    await Promise.all([
+      // Undo
+      addToQueue(() => this.$refs.unregisterAll()),
+      addToQueue(() => this.$services.disableAll()),
+      // Redo
+      addToQueue(() => this.$children.registerAll()),
+      addToQueue(() => this.$refs.registerAll()),
+      addToQueue(() => this.$services.enableAll()),
+      // Update
+      addToQueue(() => this.$children.updateAll()),
+      addToQueue(() => this.__callMethod("updated"))
+    ]);
     return this;
   }
   /**
    * Trigger the `destroyed` callback.
    */
-  $destroy() {
+  async $destroy() {
     if (!this.$isMounted) {
       return this;
     }
     if (isDev) {
       this.__debug("$destroy");
     }
-    addToQueue(() => this.$isMounted = false);
-    addToQueue(() => this.__events.unbindRootElement());
-    addToQueue(() => this.$refs.unregisterAll());
-    addToQueue(() => this.$services.disableAll());
-    addToQueue(() => this.$children.destroyAll());
-    addToQueue(() => this.__callMethod("destroyed"));
+    await Promise.all([
+      addToQueue(() => this.$isMounted = false),
+      addToQueue(() => this.__events.unbindRootElement()),
+      addToQueue(() => this.$refs.unregisterAll()),
+      addToQueue(() => this.$services.disableAll()),
+      addToQueue(() => this.$children.destroyAll()),
+      addToQueue(() => this.__callMethod("destroyed"))
+    ]);
     return this;
   }
   /**
    * Terminate a child instance when it is not needed anymore.
    */
-  $terminate() {
+  async $terminate() {
     if (isDev) {
       this.__debug("$terminate");
     }
-    addToQueue(() => this.$destroy());
-    addToQueue(() => this.__callMethod("terminated"));
-    addToQueue(() => this.$el.__base__.set(this.__ctor, "terminated"));
+    await Promise.all([
+      // First, destroy the component.
+      addToQueue(() => this.$destroy()),
+      // Execute the `terminated` hook if it exists
+      addToQueue(() => this.__callMethod("terminated")),
+      // Delete instance
+      addToQueue(() => this.$el.__base__.set(this.__ctor, "terminated"))
+    ]);
   }
   /**
    * Add an emitted event.

package/Base/Base.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/Base/Base.ts"],
-  "sourcesContent": ["/* eslint-disable no-use-before-define */\nimport {\n  getComponentElements,\n  getEventTarget,\n  addToQueue,\n  addInstance,\n  deleteInstance,\n} from './utils.js';\nimport {\n  ChildrenManager,\n  RefsManager,\n  ServicesManager,\n  EventsManager,\n  OptionsManager,\n} from './managers/index.js';\nimport { noop, isDev, isFunction, isArray } from '../utils/index.js';\n\nlet id = 0;\n\nexport type BaseEl = HTMLElement & { __base__?: WeakMap<BaseConstructor, Base | 'terminated'> };\nexport type BaseConstructor<T extends Base = Base> = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  new (...args: any[]): T;\n  prototype: Base;\n} & Pick<typeof Base, keyof typeof Base>;\nexport type BaseAsyncConstructor<T extends Base = Base> = (\n  instance: Base,\n) => Promise<BaseConstructor<T> | { default: BaseConstructor<T> }>;\nexport type BaseOptions = { [name: string]: unknown };\nexport type BaseRefs = { [name: string]: HTMLElement | HTMLElement[] };\nexport type BaseChildren = { [nameOrSelector: string]: Base[] | Promise<Base>[] };\nexport type BaseConfigComponents = {\n  [nameOrSelector: string]: BaseConstructor | BaseAsyncConstructor;\n};\n\nexport type BaseConfig = {\n  name: string;\n  debug?: boolean;\n  log?: boolean;\n  refs?: string[];\n  emits?: string[];\n  components?: BaseConfigComponents;\n  options?: import('./managers/OptionsManager').OptionsSchema;\n};\n\nexport type BaseProps = {\n  $el?: HTMLElement;\n  $options?: BaseOptions;\n  $refs?: BaseRefs;\n  $children?: BaseChildren;\n  $parent?: Base;\n};\n\nexport type Managers = {\n  ChildrenManager: typeof ChildrenManager;\n  EventsManager: typeof EventsManager;\n  OptionsManager: typeof OptionsManager;\n  RefsManager: typeof RefsManager;\n  ServicesManager: typeof ServicesManager;\n};\n\n/**\n * Base class.\n */\nexport class Base<T extends BaseProps = BaseProps> extends EventTarget {\n  /**\n   * This is a Base instance.\n   */\n  static readonly $isBase = true as const;\n\n  /**\n   * The instance parent.\n   */\n  $parent: T['$parent'] & Base = null;\n\n  /**\n   * The instance id.\n   */\n  $id: string;\n\n  /**\n   * The root element.\n   */\n  $el: T['$el'] & BaseEl;\n\n  /**\n   * The state of the component.\n   */\n  $isMounted = false;\n\n  /**\n   * Store the event handlers.\n   */\n  __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>> = new Map();\n\n  /**\n   * Get the root instance of the app.\n   */\n  get $root(): Base {\n    if (!this.$parent) {\n      return this;\n    }\n\n    let parent = this.$parent;\n    let root = this.$parent;\n\n    while (parent) {\n      if (!parent.$parent) {\n        root = parent;\n      }\n\n      parent = parent.$parent;\n    }\n\n    return root;\n  }\n\n  /**\n   * Merge configuration with the parents' configurations.\n   */\n  get __config(): BaseConfig {\n    let proto = Object.getPrototypeOf(this);\n    let { config } = proto.constructor;\n\n    while (proto.constructor.config && proto.constructor.$isBase) {\n      config = { ...proto.constructor.config, ...config };\n\n      if (proto.constructor.config.options) {\n        config.options = { ...proto.constructor.config.options, ...config.options };\n      }\n\n      if (proto.constructor.config.emits && config.emits) {\n        config.emits = [...proto.constructor.config.emits, ...config.emits];\n      }\n\n      proto = Object.getPrototypeOf(proto);\n    }\n\n    config.options = config.options ?? {};\n    config.refs = config.refs ?? [];\n    config.components = config.components ?? {};\n\n    return config;\n  }\n\n  static config: BaseConfig = {\n    name: 'Base',\n    emits: [\n      // hook events\n      'before-mounted',\n      'mounted',\n      'updated',\n      'destroyed',\n      'terminated',\n      // default services' events\n      'ticked',\n      'scrolled',\n      'resized',\n      'moved',\n      'loaded',\n      'keyed',\n    ],\n  };\n\n  __services: ServicesManager;\n\n  get $services(): ServicesManager {\n    return this.__services;\n  }\n\n  __refs: RefsManager & T['$refs'] & BaseRefs;\n\n  get $refs(): RefsManager & T['$refs'] & BaseRefs {\n    return this.__refs;\n  }\n\n  __options: OptionsManager & T['$options'] & BaseOptions;\n\n  get $options(): OptionsManager & T['$options'] & BaseOptions {\n    return this.__options;\n  }\n\n  __children: ChildrenManager & T['$children'] & BaseChildren;\n\n  get $children(): ChildrenManager & T['$children'] & BaseChildren {\n    return this.__children;\n  }\n\n  __events: EventsManager;\n\n  /**\n   * Small helper to log stuff.\n   */\n  get $log(): (...args: unknown[]) => void {\n    return this.__options.log ? window.console.log.bind(window, `[${this.__config.name}]`) : noop;\n  }\n\n  /**\n   * Small helper to make warning easier.\n   */\n  get $warn(): (...args: unknown[]) => void {\n    return this.__options.log ? window.console.warn.bind(window, `[${this.__config.name}]`) : noop;\n  }\n\n  /**\n   * Small helper to debug information.\n   */\n  get __debug(): (...args: unknown[]) => void {\n    return isDev && this.__options.debug\n      ? window.console.log.bind(window, `[debug] [${this.$id}]`)\n      : noop;\n  }\n\n  /**\n   * Get manager constructors.\n   */\n  get __managers(): Managers {\n    return {\n      ChildrenManager,\n      EventsManager,\n      OptionsManager,\n      RefsManager,\n      ServicesManager,\n    };\n  }\n\n  /**\n   * Call an instance method and emit corresponding events.\n   */\n  __callMethod(method: string, ...args: unknown[]): unknown {\n    if (isDev) {\n      this.__debug('callMethod', method, ...args);\n    }\n\n    this.$emit(method, ...args);\n\n    // We always emit an event, but we do not call the method if it does not exist\n    if (!isFunction(this[method])) {\n      return null;\n    }\n\n    if (isDev) {\n      this.__debug(method, this, ...args);\n    }\n\n    return this[method].call(this, ...args);\n  }\n\n  /**\n   * Test if the given event has been bound to the instance.\n   *\n   * @param   {string} event The event's name.\n   * @returns {boolean}      Wether the given event has been bound or not.\n   */\n  __hasEvent(event: string): boolean {\n    const eventHandlers = this.__eventHandlers.get(event);\n    return eventHandlers && eventHandlers.size > 0;\n  }\n\n  /**\n   * Class constructor where all the magic takes place.\n   *\n   * @param {HTMLElement} element The component's root element dd.\n   */\n  constructor(element: HTMLElement) {\n    super();\n\n    if (!element) {\n      if (isDev) {\n        throw new Error('The root element must be defined.');\n      }\n      return;\n    }\n\n    const { __config } = this;\n\n    if (__config.name === 'Base') {\n      if (isDev) {\n        throw new Error('The `config.name` property is required.');\n      }\n      return;\n    }\n\n    this.$id = `${__config.name}-${id}`;\n    id += 1;\n\n    this.$el = element;\n\n    if (!this.$el.__base__) {\n      this.$el.__base__ = new WeakMap();\n    }\n\n    this.$el.__base__.set(this.__ctor, this);\n\n    for (const service of ['Options', 'Services', 'Events', 'Refs', 'Children']) {\n      this[`__${service.toLowerCase()}`] = new this.__managers[`${service}Manager`](this);\n    }\n\n    this.$on('mounted', () => {\n      addInstance(this);\n    });\n    this.$on('destroyed', () => {\n      deleteInstance(this);\n    });\n\n    if (isDev) {\n      this.__debug('constructor', this);\n    }\n  }\n\n  /**\n   * Trigger the `mounted` callback.\n   */\n  $mount(): this {\n    if (this.$isMounted) {\n      return this;\n    }\n\n    this.$emit('before-mounted');\n\n    if (isDev) {\n      this.__debug('$mount');\n    }\n\n    addToQueue(() => this.$children.registerAll());\n    addToQueue(() => this.$refs.registerAll());\n    addToQueue(() => this.__events.bindRootElement());\n    addToQueue(() => this.$services.enableAll());\n    addToQueue(() => this.$children.mountAll());\n    // eslint-disable-next-line no-return-assign\n    addToQueue(() => (this.$isMounted = true));\n    addToQueue(() => this.__callMethod('mounted'));\n\n    return this;\n  }\n\n  /**\n   * Update the instance children.\n   */\n  $update(): this {\n    if (isDev) {\n      this.__debug('$update');\n    }\n\n    // Undo\n    addToQueue(() => this.$refs.unregisterAll());\n    addToQueue(() => this.$services.disableAll());\n    // Redo\n    addToQueue(() => this.$children.registerAll());\n    addToQueue(() => this.$refs.registerAll());\n    addToQueue(() => this.$services.enableAll());\n    // Update\n    addToQueue(() => this.$children.updateAll());\n    addToQueue(() => this.__callMethod('updated'));\n\n    return this;\n  }\n\n  /**\n   * Trigger the `destroyed` callback.\n   */\n  $destroy(): this {\n    if (!this.$isMounted) {\n      return this;\n    }\n\n    if (isDev) {\n      this.__debug('$destroy');\n    }\n\n    // eslint-disable-next-line no-return-assign\n    addToQueue(() => (this.$isMounted = false));\n    addToQueue(() => this.__events.unbindRootElement());\n    addToQueue(() => this.$refs.unregisterAll());\n    addToQueue(() => this.$services.disableAll());\n    addToQueue(() => this.$children.destroyAll());\n    addToQueue(() => this.__callMethod('destroyed'));\n\n    return this;\n  }\n\n  /**\n   * Terminate a child instance when it is not needed anymore.\n   */\n  $terminate(): void {\n    if (isDev) {\n      this.__debug('$terminate');\n    }\n\n    // First, destroy the component.\n    addToQueue(() => this.$destroy());\n    // Execute the `terminated` hook if it exists\n    addToQueue(() => this.__callMethod('terminated'));\n    // Delete instance\n    addToQueue(() => this.$el.__base__.set(this.__ctor, 'terminated'));\n  }\n\n  /**\n   * Add an emitted event.\n   *\n   * @param   {string} event The event name.\n   * @returns {void}\n   */\n  __addEmits(event: string): void {\n    const ctor = this.__ctor;\n    if (isArray(ctor.config.emits)) {\n      ctor.config.emits.push(event);\n    } else {\n      ctor.config.emits = [event];\n    }\n  }\n\n  /**\n   * Remove an emitted event.\n   *\n   * @param   {string} event The event name.\n   * @returns {void}\n   */\n  __removeEmits(event: string): void {\n    const ctor = this.__ctor;\n    const index = ctor.config.emits.indexOf(event);\n    ctor.config.emits.splice(index, 1);\n  }\n\n  /**\n   * Get the instance constructor.\n   */\n  get __ctor(): BaseConstructor {\n    return this.constructor as BaseConstructor;\n  }\n\n  /**\n   * Bind a listener function to an event.\n   *\n   * @param  {string} event\n   *   Name of the event.\n   * @param  {EventListenerOrEventListenerObject} listener\n   *   Function to be called.\n   * @param {boolean|AddEventListenerOptions} [options]\n   *   Options for the `removeEventListener` method.\n   * @returns {() => void}\n   *   A function to unbind the listener.\n   */\n  $on(\n    event: string,\n    listener: EventListenerOrEventListenerObject,\n    options?: boolean | AddEventListenerOptions,\n  ): () => void {\n    if (isDev) {\n      this.__debug('$on', event, listener, options);\n    }\n\n    let set = this.__eventHandlers.get(event);\n\n    if (!set) {\n      set = new Set();\n      this.__eventHandlers.set(event, set);\n    }\n\n    set.add(listener);\n\n    const target = getEventTarget(this, event, this.__config);\n    target.addEventListener(event, listener, options);\n\n    return () => {\n      this.$off(event, listener, options);\n    };\n  }\n\n  /**\n   * Unbind a listener function from an event.\n   *\n   * @param {string} event\n   *   Name of the event.\n   * @param {EventListenerOrEventListenerObject} listener\n   *   Function to be removed.\n   * @param {boolean|EventListenerOptions} [options]\n   *   Options for the `removeEventListener` method.\n   * @returns {void}\n   */\n  $off(\n    event: string,\n    listener: EventListenerOrEventListenerObject,\n    options?: boolean | EventListenerOptions,\n  ) {\n    if (isDev) {\n      this.__debug('$off', event, listener);\n    }\n\n    this.__eventHandlers.get(event).delete(listener);\n\n    const target = getEventTarget(this, event, this.__config);\n    target.removeEventListener(event, listener, options);\n  }\n\n  /**\n   * Emits an event.\n   *\n   * @param  {string} event Name of the event.\n   * @param  {any[]}  args  The arguments to apply to the functions bound to this event.\n   * @returns {void}\n   */\n  $emit(event: string, ...args: unknown[]) {\n    if (isDev) {\n      this.__debug('$emit', event, args);\n    }\n\n    this.dispatchEvent(new CustomEvent(event, { detail: args }));\n  }\n\n  /**\n   * Register and mount all instances of the component.\n   */\n  static $register(nameOrSelector?: string): Base[] {\n    return getComponentElements(nameOrSelector ?? this.config.name).map((el) =>\n      new this(el).$mount(),\n    );\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/* eslint-disable no-use-before-define */\nimport {\n  getComponentElements,\n  getEventTarget,\n  addToQueue,\n  addInstance,\n  deleteInstance,\n} from './utils.js';\nimport {\n  ChildrenManager,\n  RefsManager,\n  ServicesManager,\n  EventsManager,\n  OptionsManager,\n} from './managers/index.js';\nimport { noop, isDev, isFunction, isArray } from '../utils/index.js';\n\nlet id = 0;\n\nexport type BaseEl = HTMLElement & { __base__?: WeakMap<BaseConstructor, Base | 'terminated'> };\nexport type BaseConstructor<T extends Base = Base> = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  new (...args: any[]): T;\n  prototype: Base;\n} & Pick<typeof Base, keyof typeof Base>;\nexport type BaseAsyncConstructor<T extends Base = Base> = (\n  instance: Base,\n) => Promise<BaseConstructor<T> | { default: BaseConstructor<T> }>;\nexport type BaseOptions = { [name: string]: unknown };\nexport type BaseRefs = { [name: string]: HTMLElement | HTMLElement[] };\nexport type BaseChildren = { [nameOrSelector: string]: Base[] | Promise<Base>[] };\nexport type BaseConfigComponents = {\n  [nameOrSelector: string]: BaseConstructor | BaseAsyncConstructor;\n};\n\nexport type BaseConfig = {\n  name: string;\n  debug?: boolean;\n  log?: boolean;\n  refs?: string[];\n  emits?: string[];\n  components?: BaseConfigComponents;\n  options?: import('./managers/OptionsManager').OptionsSchema;\n};\n\nexport type BaseProps = {\n  $el?: HTMLElement;\n  $options?: BaseOptions;\n  $refs?: BaseRefs;\n  $children?: BaseChildren;\n  $parent?: Base;\n};\n\nexport type Managers = {\n  ChildrenManager: typeof ChildrenManager;\n  EventsManager: typeof EventsManager;\n  OptionsManager: typeof OptionsManager;\n  RefsManager: typeof RefsManager;\n  ServicesManager: typeof ServicesManager;\n};\n\n/**\n * Base class.\n */\nexport class Base<T extends BaseProps = BaseProps> extends EventTarget {\n  /**\n   * This is a Base instance.\n   */\n  static readonly $isBase = true as const;\n\n  /**\n   * The instance parent.\n   */\n  $parent: T['$parent'] & Base = null;\n\n  /**\n   * The instance id.\n   */\n  $id: string;\n\n  /**\n   * The root element.\n   */\n  $el: T['$el'] & BaseEl;\n\n  /**\n   * The state of the component.\n   */\n  $isMounted = false;\n\n  /**\n   * Store the event handlers.\n   */\n  __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>> = new Map();\n\n  /**\n   * Get the root instance of the app.\n   */\n  get $root(): Base {\n    if (!this.$parent) {\n      return this;\n    }\n\n    let parent = this.$parent;\n    let root = this.$parent;\n\n    while (parent) {\n      if (!parent.$parent) {\n        root = parent;\n      }\n\n      parent = parent.$parent;\n    }\n\n    return root;\n  }\n\n  /**\n   * Merge configuration with the parents' configurations.\n   */\n  get __config(): BaseConfig {\n    let proto = Object.getPrototypeOf(this);\n    let { config } = proto.constructor;\n\n    while (proto.constructor.config && proto.constructor.$isBase) {\n      config = { ...proto.constructor.config, ...config };\n\n      if (proto.constructor.config.options) {\n        config.options = { ...proto.constructor.config.options, ...config.options };\n      }\n\n      if (proto.constructor.config.emits && config.emits) {\n        config.emits = [...proto.constructor.config.emits, ...config.emits];\n      }\n\n      proto = Object.getPrototypeOf(proto);\n    }\n\n    config.options = config.options ?? {};\n    config.refs = config.refs ?? [];\n    config.components = config.components ?? {};\n\n    return config;\n  }\n\n  static config: BaseConfig = {\n    name: 'Base',\n    emits: [\n      // hook events\n      'before-mounted',\n      'mounted',\n      'updated',\n      'destroyed',\n      'terminated',\n      // default services' events\n      'ticked',\n      'scrolled',\n      'resized',\n      'moved',\n      'loaded',\n      'keyed',\n    ],\n  };\n\n  __services: ServicesManager;\n\n  get $services(): ServicesManager {\n    return this.__services;\n  }\n\n  __refs: RefsManager & T['$refs'] & BaseRefs;\n\n  get $refs(): RefsManager & T['$refs'] & BaseRefs {\n    return this.__refs;\n  }\n\n  __options: OptionsManager & T['$options'] & BaseOptions;\n\n  get $options(): OptionsManager & T['$options'] & BaseOptions {\n    return this.__options;\n  }\n\n  __children: ChildrenManager & T['$children'] & BaseChildren;\n\n  get $children(): ChildrenManager & T['$children'] & BaseChildren {\n    return this.__children;\n  }\n\n  __events: EventsManager;\n\n  /**\n   * Small helper to log stuff.\n   */\n  get $log(): (...args: unknown[]) => void {\n    return this.__options.log ? window.console.log.bind(window, `[${this.__config.name}]`) : noop;\n  }\n\n  /**\n   * Small helper to make warning easier.\n   */\n  get $warn(): (...args: unknown[]) => void {\n    return this.__options.log ? window.console.warn.bind(window, `[${this.__config.name}]`) : noop;\n  }\n\n  /**\n   * Small helper to debug information.\n   */\n  get __debug(): (...args: unknown[]) => void {\n    return isDev && this.__options.debug\n      ? window.console.log.bind(window, `[debug] [${this.$id}]`)\n      : noop;\n  }\n\n  /**\n   * Get manager constructors.\n   */\n  get __managers(): Managers {\n    return {\n      ChildrenManager,\n      EventsManager,\n      OptionsManager,\n      RefsManager,\n      ServicesManager,\n    };\n  }\n\n  /**\n   * Call an instance method and emit corresponding events.\n   */\n  __callMethod(method: string, ...args: unknown[]): unknown {\n    if (isDev) {\n      this.__debug('callMethod', method, ...args);\n    }\n\n    this.$emit(method, ...args);\n\n    // We always emit an event, but we do not call the method if it does not exist\n    if (!isFunction(this[method])) {\n      return null;\n    }\n\n    if (isDev) {\n      this.__debug(method, this, ...args);\n    }\n\n    return this[method].call(this, ...args);\n  }\n\n  /**\n   * Test if the given event has been bound to the instance.\n   *\n   * @param   {string} event The event's name.\n   * @returns {boolean}      Wether the given event has been bound or not.\n   */\n  __hasEvent(event: string): boolean {\n    const eventHandlers = this.__eventHandlers.get(event);\n    return eventHandlers && eventHandlers.size > 0;\n  }\n\n  /**\n   * Class constructor where all the magic takes place.\n   *\n   * @param {HTMLElement} element The component's root element dd.\n   */\n  constructor(element: HTMLElement) {\n    super();\n\n    if (!element) {\n      if (isDev) {\n        throw new Error('The root element must be defined.');\n      }\n      return;\n    }\n\n    const { __config } = this;\n\n    if (__config.name === 'Base') {\n      if (isDev) {\n        throw new Error('The `config.name` property is required.');\n      }\n      return;\n    }\n\n    this.$id = `${__config.name}-${id}`;\n    id += 1;\n\n    this.$el = element;\n\n    if (!this.$el.__base__) {\n      this.$el.__base__ = new WeakMap();\n    }\n\n    this.$el.__base__.set(this.__ctor, this);\n\n    for (const service of ['Options', 'Services', 'Events', 'Refs', 'Children']) {\n      this[`__${service.toLowerCase()}`] = new this.__managers[`${service}Manager`](this);\n    }\n\n    this.$on('mounted', () => {\n      addInstance(this);\n    });\n    this.$on('destroyed', () => {\n      deleteInstance(this);\n    });\n\n    if (isDev) {\n      this.__debug('constructor', this);\n    }\n  }\n\n  /**\n   * Trigger the `mounted` callback.\n   */\n  async $mount(): Promise<this> {\n    if (this.$isMounted) {\n      return this;\n    }\n\n    this.$emit('before-mounted');\n\n    if (isDev) {\n      this.__debug('$mount');\n    }\n\n    await Promise.all([\n      addToQueue(() => this.$children.registerAll()),\n      addToQueue(() => this.$refs.registerAll()),\n      addToQueue(() => this.__events.bindRootElement()),\n      addToQueue(() => this.$services.enableAll()),\n      addToQueue(() => this.$children.mountAll()),\n      addToQueue(() => (this.$isMounted = true)),\n      addToQueue(() => this.__callMethod('mounted')),\n    ]);\n\n    return this;\n  }\n\n  /**\n   * Update the instance children.\n   */\n  async $update(): Promise<this> {\n    if (isDev) {\n      this.__debug('$update');\n    }\n\n    await Promise.all([\n      // Undo\n      addToQueue(() => this.$refs.unregisterAll()),\n      addToQueue(() => this.$services.disableAll()),\n      // Redo\n      addToQueue(() => this.$children.registerAll()),\n      addToQueue(() => this.$refs.registerAll()),\n      addToQueue(() => this.$services.enableAll()),\n      // Update\n      addToQueue(() => this.$children.updateAll()),\n      addToQueue(() => this.__callMethod('updated')),\n    ]);\n\n    return this;\n  }\n\n  /**\n   * Trigger the `destroyed` callback.\n   */\n  async $destroy(): Promise<this> {\n    if (!this.$isMounted) {\n      return this;\n    }\n\n    if (isDev) {\n      this.__debug('$destroy');\n    }\n\n    await Promise.all([\n      addToQueue(() => (this.$isMounted = false)),\n      addToQueue(() => this.__events.unbindRootElement()),\n      addToQueue(() => this.$refs.unregisterAll()),\n      addToQueue(() => this.$services.disableAll()),\n      addToQueue(() => this.$children.destroyAll()),\n      addToQueue(() => this.__callMethod('destroyed')),\n    ]);\n\n    return this;\n  }\n\n  /**\n   * Terminate a child instance when it is not needed anymore.\n   */\n  async $terminate(): Promise<void> {\n    if (isDev) {\n      this.__debug('$terminate');\n    }\n\n    await Promise.all([\n      // First, destroy the component.\n      addToQueue(() => this.$destroy()),\n      // Execute the `terminated` hook if it exists\n      addToQueue(() => this.__callMethod('terminated')),\n      // Delete instance\n      addToQueue(() => this.$el.__base__.set(this.__ctor, 'terminated')),\n    ]);\n  }\n\n  /**\n   * Add an emitted event.\n   *\n   * @param   {string} event The event name.\n   * @returns {void}\n   */\n  __addEmits(event: string): void {\n    const ctor = this.__ctor;\n    if (isArray(ctor.config.emits)) {\n      ctor.config.emits.push(event);\n    } else {\n      ctor.config.emits = [event];\n    }\n  }\n\n  /**\n   * Remove an emitted event.\n   *\n   * @param   {string} event The event name.\n   * @returns {void}\n   */\n  __removeEmits(event: string): void {\n    const ctor = this.__ctor;\n    const index = ctor.config.emits.indexOf(event);\n    ctor.config.emits.splice(index, 1);\n  }\n\n  /**\n   * Get the instance constructor.\n   */\n  get __ctor(): BaseConstructor {\n    return this.constructor as BaseConstructor;\n  }\n\n  /**\n   * Bind a listener function to an event.\n   *\n   * @param  {string} event\n   *   Name of the event.\n   * @param  {EventListenerOrEventListenerObject} listener\n   *   Function to be called.\n   * @param {boolean|AddEventListenerOptions} [options]\n   *   Options for the `removeEventListener` method.\n   * @returns {() => void}\n   *   A function to unbind the listener.\n   */\n  $on(\n    event: string,\n    listener: EventListenerOrEventListenerObject,\n    options?: boolean | AddEventListenerOptions,\n  ): () => void {\n    if (isDev) {\n      this.__debug('$on', event, listener, options);\n    }\n\n    let set = this.__eventHandlers.get(event);\n\n    if (!set) {\n      set = new Set();\n      this.__eventHandlers.set(event, set);\n    }\n\n    set.add(listener);\n\n    const target = getEventTarget(this, event, this.__config);\n    target.addEventListener(event, listener, options);\n\n    return () => {\n      this.$off(event, listener, options);\n    };\n  }\n\n  /**\n   * Unbind a listener function from an event.\n   *\n   * @param {string} event\n   *   Name of the event.\n   * @param {EventListenerOrEventListenerObject} listener\n   *   Function to be removed.\n   * @param {boolean|EventListenerOptions} [options]\n   *   Options for the `removeEventListener` method.\n   * @returns {void}\n   */\n  $off(\n    event: string,\n    listener: EventListenerOrEventListenerObject,\n    options?: boolean | EventListenerOptions,\n  ) {\n    if (isDev) {\n      this.__debug('$off', event, listener);\n    }\n\n    this.__eventHandlers.get(event).delete(listener);\n\n    const target = getEventTarget(this, event, this.__config);\n    target.removeEventListener(event, listener, options);\n  }\n\n  /**\n   * Emits an event.\n   *\n   * @param  {string} event Name of the event.\n   * @param  {any[]}  args  The arguments to apply to the functions bound to this event.\n   * @returns {void}\n   */\n  $emit(event: string, ...args: unknown[]) {\n    if (isDev) {\n      this.__debug('$emit', event, args);\n    }\n\n    this.dispatchEvent(new CustomEvent(event, { detail: args }));\n  }\n\n  /**\n   * Register and mount all instances of the component.\n   */\n  static $register(nameOrSelector?: string): Array<Promise<Base>> {\n    return getComponentElements(nameOrSelector ?? this.config.name).map((el) =>\n      new this(el).$mount(),\n    );\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/Base/features.d.ts

@@ -1,6 +1,11 @@
 export type Features = {
     blocking: boolean;
     breakpoints: Record<string, string>;
+    attributes: {
+        component: string;
+        option: string;
+        ref: string;
+    };
 };
 interface FeaturesMap extends Map<keyof Features, Features[keyof Features]> {
     get<T extends keyof Features>(key: T): Features[T];

package/Base/features.js

@@ -19,6 +19,14 @@ const features = /* @__PURE__ */ new Map([
       xxxl: "160rem"
       // 2560px
     }
+  ],
+  [
+    "attributes",
+    {
+      component: "data-component",
+      option: "data-option",
+      ref: "data-ref"
+    }
   ]
 ]);
 export {

package/Base/features.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/Base/features.ts"],
-  "sourcesContent": ["export type Features = {\n  blocking: boolean;\n  breakpoints: Record<string, string>;\n};\n\ninterface FeaturesMap extends Map<keyof Features, Features[keyof Features]> {\n  get<T extends keyof Features>(key: T): Features[T];\n  set<T extends keyof Features>(key: T, value: Features[T]): this;\n}\n\nexport const features = new Map<keyof Features, Features[keyof Features]>([\n  ['blocking', false],\n  [\n    'breakpoints',\n    {\n      xxs: '0rem',\n      xs: '30rem', // 480px\n      s: '48rem', // 768px\n      m: '64rem', // 1024px\n      l: '80rem', // 1280px\n      xl: '90rem', // 1440px\n      xxl: '120rem', // 1920px\n      xxxl: '160rem', // 2560px\n    },\n  ],\n]) as FeaturesMap;\n"],
-  "mappings": "AAUO,MAAM,WAAW,oBAAI,IAA8C;AAAA,EACxE,CAAC,YAAY,KAAK;AAAA,EAClB;AAAA,IACE;AAAA,IACA;AAAA,MACE,KAAK;AAAA,MACL,IAAI;AAAA;AAAA,MACJ,GAAG;AAAA;AAAA,MACH,GAAG;AAAA;AAAA,MACH,GAAG;AAAA;AAAA,MACH,IAAI;AAAA;AAAA,MACJ,KAAK;AAAA;AAAA,MACL,MAAM;AAAA;AAAA,IACR;AAAA,EACF;AACF,CAAC;",
+  "sourcesContent": ["export type Features = {\n  blocking: boolean;\n  breakpoints: Record<string, string>;\n  attributes: {\n    component: string;\n    option: string;\n    ref: string;\n  }\n};\n\ninterface FeaturesMap extends Map<keyof Features, Features[keyof Features]> {\n  get<T extends keyof Features>(key: T): Features[T];\n  set<T extends keyof Features>(key: T, value: Features[T]): this;\n}\n\nexport const features = new Map<keyof Features, Features[keyof Features]>([\n  ['blocking', false],\n  [\n    'breakpoints',\n    {\n      xxs: '0rem',\n      xs: '30rem', // 480px\n      s: '48rem', // 768px\n      m: '64rem', // 1024px\n      l: '80rem', // 1280px\n      xl: '90rem', // 1440px\n      xxl: '120rem', // 1920px\n      xxxl: '160rem', // 2560px\n    },\n  ],\n  [\n    'attributes',\n    {\n      component: 'data-component',\n      option: 'data-option',\n      ref: 'data-ref'\n    }\n  ]\n]) as FeaturesMap;\n"],
+  "mappings": "AAeO,MAAM,WAAW,oBAAI,IAA8C;AAAA,EACxE,CAAC,YAAY,KAAK;AAAA,EAClB;AAAA,IACE;AAAA,IACA;AAAA,MACE,KAAK;AAAA,MACL,IAAI;AAAA;AAAA,MACJ,GAAG;AAAA;AAAA,MACH,GAAG;AAAA;AAAA,MACH,GAAG;AAAA;AAAA,MACH,IAAI;AAAA;AAAA,MACJ,KAAK;AAAA;AAAA,MACL,MAAM;AAAA;AAAA,IACR;AAAA,EACF;AAAA,EACA;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,KAAK;AAAA,IACP;AAAA,EACF;AACF,CAAC;",
   "names": []
 }

package/Base/managers/ChildrenManager.d.ts

@@ -17,19 +17,19 @@ export declare class ChildrenManager extends AbstractManager {
     /**
      * Register instances of all children components.
      */
-    registerAll(): void;
+    registerAll(): Promise<void>;
     /**
      * Mount all child component instances.
      */
-    mountAll(): void;
+    mountAll(): Promise<void>;
     /**
      * Update all child component instances.
      */
-    updateAll(): void;
+    updateAll(): Promise<void>;
     /**
      * Destroy all child component instances.
      */
-    destroyAll(): void;
+    destroyAll(): Promise<void>;
     /**
      * Execute the given hook for the given instance.
      *
@@ -38,7 +38,7 @@ export declare class ChildrenManager extends AbstractManager {
      * @param {string} name The name of the component.
      * @private
      */
-    __triggerHook(hook: '$mount' | '$update' | '$destroy', instance: Base, name: string): void;
+    __triggerHook(hook: '$mount' | '$update' | '$destroy', instance: Base, name: string): Promise<void>;
     /**
      * Register instance of a child component.
      *

package/Base/managers/ChildrenManager.js

@@ -35,19 +35,23 @@ function __getChild(that, el, ComponentClass) {
     return __getChild(that, el, ctor);
   });
 }
-function __triggerHookForAll(that, hook) {
-  addToQueue(() => {
+async function __triggerHookForAll(that, hook) {
+  return addToQueue(() => {
+    const promises = [];
     for (const name of that.registeredNames) {
       for (const instance of that[name]) {
         if (instance instanceof Promise) {
-          instance.then((resolvedInstance) => {
-            addToQueue(() => that.__triggerHook(hook, resolvedInstance, name));
-          });
+          promises.push(
+            instance.then(
+              (resolvedInstance) => addToQueue(() => that.__triggerHook(hook, resolvedInstance, name))
+            )
+          );
         } else {
-          addToQueue(() => that.__triggerHook(hook, instance, name));
+          promises.push(addToQueue(() => that.__triggerHook(hook, instance, name)));
         }
       }
     }
+    return Promise.all(promises);
   });
 }
 class ChildrenManager extends AbstractManager {
@@ -62,27 +66,30 @@ class ChildrenManager extends AbstractManager {
   /**
    * Register instances of all children components.
    */
-  registerAll() {
-    for (const [name, component] of Object.entries(this.__config.components))
-      this.__register(name, component);
+  async registerAll() {
+    const promises = [];
+    for (const [name, component] of Object.entries(this.__config.components)) {
+      promises.push(this.__register(name, component));
+    }
+    await Promise.all(promises);
   }
   /**
    * Mount all child component instances.
    */
-  mountAll() {
-    __triggerHookForAll(this, "$mount");
+  async mountAll() {
+    await __triggerHookForAll(this, "$mount");
   }
   /**
    * Update all child component instances.
    */
-  updateAll() {
-    __triggerHookForAll(this, "$update");
+  async updateAll() {
+    await __triggerHookForAll(this, "$update");
   }
   /**
    * Destroy all child component instances.
    */
-  destroyAll() {
-    __triggerHookForAll(this, "$destroy");
+  async destroyAll() {
+    await __triggerHookForAll(this, "$destroy");
   }
   /**
    * Execute the given hook for the given instance.
@@ -92,7 +99,7 @@ class ChildrenManager extends AbstractManager {
    * @param {string} name The name of the component.
    * @private
    */
-  __triggerHook(hook, instance, name) {
+  async __triggerHook(hook, instance, name) {
     if (hook === "$update" && !instance.$isMounted) {
       hook = "$mount";
     }
@@ -102,7 +109,7 @@ class ChildrenManager extends AbstractManager {
     if (hook === "$update" || hook === "$mount") {
       this.__eventsManager.bindChild(name, instance);
     }
-    instance[hook]();
+    await instance[hook]();
   }
   /**
    * Register instance of a child component.

package/Base/managers/ChildrenManager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/Base/managers/ChildrenManager.ts"],
-  "sourcesContent": ["import type { Base, BaseConstructor, BaseAsyncConstructor, BaseEl } from '../index.js';\nimport { AbstractManager } from './AbstractManager.js';\nimport { getComponentElements, addToQueue } from '../utils.js';\nimport { startsWith } from '../../utils/index.js';\n\n/**\n * Get a child component's instance.\n *\n * @param {ChildrenManager} that\n * @param {HTMLElement & { __base__?: WeakMap<BaseConstructor, Base> }} el\n *   The root element of the child component.\n * @param {BaseConstructor|BaseAsyncConstructor} ComponentClass\n *   A Base class or a Promise for async components.\n * @returns {Base|Promise<Base | 'terminated'>|'terminated'}\n *   A Base instance or a Promise resolving to a Base instance.\n * @private\n */\nfunction __getChild(\n  // eslint-disable-next-line no-use-before-define\n  that: ChildrenManager,\n  el: BaseEl,\n  ComponentClass: BaseConstructor | BaseAsyncConstructor,\n): Base | Promise<Base | 'terminated'> | 'terminated' {\n  const asyncComponentPromise = that.__asyncComponentPromises.get(\n    ComponentClass as BaseAsyncConstructor,\n  );\n\n  // Test if we have a constructor and not a promise or if the promise has been resolved\n  if (\n    '$isBase' in ComponentClass ||\n    (asyncComponentPromise && asyncComponentPromise.status === 'resolved')\n  ) {\n    let ctor = ComponentClass as BaseConstructor;\n\n    // Get resolved constructor from weakmap.\n    // Only test for existence as the status was checked before.\n    if (asyncComponentPromise) {\n      ctor = asyncComponentPromise.ctor;\n    }\n\n    // Return existing instance if it exists\n    if (el.__base__ && el.__base__.has(ctor)) {\n      return el.__base__.get(ctor);\n    }\n\n    // Return a new instance if the component class is a child of the Base class\n    // eslint-disable-next-line new-cap\n    const child = new ctor(el);\n    Object.defineProperty(child, '$parent', { get: () => that.__base });\n    return child;\n  }\n\n  const promise = asyncComponentPromise\n    ? asyncComponentPromise.promise\n    : ComponentClass(that.__base);\n\n  if (!asyncComponentPromise) {\n    that.__asyncComponentPromises.set(ComponentClass, {\n      promise,\n      status: 'pending',\n      ctor: undefined,\n    });\n  }\n\n  // Resolve async components\n  return promise.then((module) => {\n    // @ts-ignore\n    const ctor = module.default ?? module;\n\n    that.__asyncComponentPromises.set(ComponentClass, {\n      promise,\n      status: 'resolved',\n      ctor,\n    });\n\n    return __getChild(that, el, ctor);\n  });\n}\n\n/**\n * Execute the given hook for all children instances.\n *\n * @param {ChildrenManager} that\n * @param {'$mount'|'$update'|'$destroy'} hook The hook to execute.\n * @private\n */\n// eslint-disable-next-line no-use-before-define\nfunction __triggerHookForAll(that: ChildrenManager, hook: '$mount' | '$update' | '$destroy') {\n  addToQueue(() => {\n    for (const name of that.registeredNames) {\n      for (const instance of that[name]) {\n        if (instance instanceof Promise) {\n          instance.then((resolvedInstance) => {\n            addToQueue(() => that.__triggerHook(hook, resolvedInstance, name));\n          });\n        } else {\n          addToQueue(() => that.__triggerHook(hook, instance, name));\n        }\n      }\n    }\n  });\n}\n\n/**\n * Children manager.\n */\nexport class ChildrenManager extends AbstractManager {\n  /**\n   * Store async component promises to avoid calling them multiple times and\n   * waiting for them when they are already resolved.\n   */\n  __asyncComponentPromises: WeakMap<\n    BaseAsyncConstructor,\n    {\n      promise: ReturnType<BaseAsyncConstructor>;\n      status: 'pending' | 'resolved';\n      ctor?: BaseConstructor;\n    }\n  > = new WeakMap();\n\n  get registeredNames(): string[] {\n    return Object.keys(this).filter((key) => !startsWith(key, '__'));\n  }\n\n  /**\n   * Register instances of all children components.\n   */\n  registerAll() {\n    for (const [name, component] of Object.entries(this.__config.components))\n      this.__register(name, component);\n  }\n\n  /**\n   * Mount all child component instances.\n   */\n  mountAll() {\n    __triggerHookForAll(this, '$mount');\n  }\n\n  /**\n   * Update all child component instances.\n   */\n  updateAll() {\n    __triggerHookForAll(this, '$update');\n  }\n\n  /**\n   * Destroy all child component instances.\n   */\n  destroyAll() {\n    __triggerHookForAll(this, '$destroy');\n  }\n\n  /**\n   * Execute the given hook for the given instance.\n   *\n   * @param {'$mount'|'$update'|'$destroy'} hook The hook to trigger.\n   * @param {Base} instance The target instance.\n   * @param {string} name The name of the component.\n   * @private\n   */\n  __triggerHook(hook: '$mount' | '$update' | '$destroy', instance: Base, name: string) {\n    if (hook === '$update' && !instance.$isMounted) {\n      // eslint-disable-next-line no-param-reassign\n      hook = '$mount';\n    }\n\n    if (hook === '$update' || hook === '$destroy') {\n      this.__eventsManager.unbindChild(name, instance);\n    }\n\n    if (hook === '$update' || hook === '$mount') {\n      this.__eventsManager.bindChild(name, instance);\n    }\n\n    instance[hook]();\n  }\n\n  /**\n   * Register instance of a child component.\n   *\n   * @param {string} name\n   *   The name of the child component.\n   * @param {BaseConstructor|BaseAsyncConstructor} component\n   *   A Base class or a Promise for async components.\n   * @private\n   */\n  __register(name: string, component: BaseConstructor | BaseAsyncConstructor) {\n    Object.defineProperty(this, name, {\n      enumerable: true,\n      configurable: true,\n      get: () => this.__getValue(name, component),\n    });\n  }\n\n  __getValue(name: string, component: BaseConstructor | BaseAsyncConstructor) {\n    const elements = getComponentElements(name, this.__element);\n\n    if (elements.length === 0) {\n      return [];\n    }\n\n    return elements\n      .map((element) => __getChild(this, element, component))\n      .filter((instance) => instance !== 'terminated');\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Base, BaseConstructor, BaseAsyncConstructor, BaseEl } from '../index.js';\nimport { AbstractManager } from './AbstractManager.js';\nimport { getComponentElements, addToQueue } from '../utils.js';\nimport { startsWith } from '../../utils/index.js';\n\n/**\n * Get a child component's instance.\n *\n * @param {ChildrenManager} that\n * @param {HTMLElement & { __base__?: WeakMap<BaseConstructor, Base> }} el\n *   The root element of the child component.\n * @param {BaseConstructor|BaseAsyncConstructor} ComponentClass\n *   A Base class or a Promise for async components.\n * @returns {Base|Promise<Base | 'terminated'>|'terminated'}\n *   A Base instance or a Promise resolving to a Base instance.\n * @private\n */\nfunction __getChild(\n  // eslint-disable-next-line no-use-before-define\n  that: ChildrenManager,\n  el: BaseEl,\n  ComponentClass: BaseConstructor | BaseAsyncConstructor,\n): Base | Promise<Base | 'terminated'> | 'terminated' {\n  const asyncComponentPromise = that.__asyncComponentPromises.get(\n    ComponentClass as BaseAsyncConstructor,\n  );\n\n  // Test if we have a constructor and not a promise or if the promise has been resolved\n  if (\n    '$isBase' in ComponentClass ||\n    (asyncComponentPromise && asyncComponentPromise.status === 'resolved')\n  ) {\n    let ctor = ComponentClass as BaseConstructor;\n\n    // Get resolved constructor from weakmap.\n    // Only test for existence as the status was checked before.\n    if (asyncComponentPromise) {\n      ctor = asyncComponentPromise.ctor;\n    }\n\n    // Return existing instance if it exists\n    if (el.__base__ && el.__base__.has(ctor)) {\n      return el.__base__.get(ctor);\n    }\n\n    // Return a new instance if the component class is a child of the Base class\n    // eslint-disable-next-line new-cap\n    const child = new ctor(el);\n    Object.defineProperty(child, '$parent', { get: () => that.__base });\n    return child;\n  }\n\n  const promise = asyncComponentPromise\n    ? asyncComponentPromise.promise\n    : ComponentClass(that.__base);\n\n  if (!asyncComponentPromise) {\n    that.__asyncComponentPromises.set(ComponentClass, {\n      promise,\n      status: 'pending',\n      ctor: undefined,\n    });\n  }\n\n  // Resolve async components\n  return promise.then((module) => {\n    // @ts-ignore\n    const ctor = module.default ?? module;\n\n    that.__asyncComponentPromises.set(ComponentClass, {\n      promise,\n      status: 'resolved',\n      ctor,\n    });\n\n    return __getChild(that, el, ctor);\n  });\n}\n\n/**\n * Execute the given hook for all children instances.\n *\n * @param {ChildrenManager} that\n * @param {'$mount'|'$update'|'$destroy'} hook The hook to execute.\n * @private\n */\n// eslint-disable-next-line no-use-before-define\nasync function __triggerHookForAll(that: ChildrenManager, hook: '$mount' | '$update' | '$destroy') {\n  return addToQueue(() => {\n    const promises = [];\n    for (const name of that.registeredNames) {\n      for (const instance of that[name]) {\n        if (instance instanceof Promise) {\n          promises.push(\n            instance.then((resolvedInstance) =>\n              addToQueue(() => that.__triggerHook(hook, resolvedInstance, name)),\n            ),\n          );\n        } else {\n          promises.push(addToQueue(() => that.__triggerHook(hook, instance, name)));\n        }\n      }\n    }\n    return Promise.all(promises);\n  });\n}\n\n/**\n * Children manager.\n */\nexport class ChildrenManager extends AbstractManager {\n  /**\n   * Store async component promises to avoid calling them multiple times and\n   * waiting for them when they are already resolved.\n   */\n  __asyncComponentPromises: WeakMap<\n    BaseAsyncConstructor,\n    {\n      promise: ReturnType<BaseAsyncConstructor>;\n      status: 'pending' | 'resolved';\n      ctor?: BaseConstructor;\n    }\n  > = new WeakMap();\n\n  get registeredNames(): string[] {\n    return Object.keys(this).filter((key) => !startsWith(key, '__'));\n  }\n\n  /**\n   * Register instances of all children components.\n   */\n  async registerAll() {\n    const promises = [];\n\n    for (const [name, component] of Object.entries(this.__config.components)) {\n      promises.push(this.__register(name, component));\n    }\n\n    await Promise.all(promises);\n  }\n\n  /**\n   * Mount all child component instances.\n   */\n  async mountAll() {\n    await __triggerHookForAll(this, '$mount');\n  }\n\n  /**\n   * Update all child component instances.\n   */\n  async updateAll() {\n    await __triggerHookForAll(this, '$update');\n  }\n\n  /**\n   * Destroy all child component instances.\n   */\n  async destroyAll() {\n    await __triggerHookForAll(this, '$destroy');\n  }\n\n  /**\n   * Execute the given hook for the given instance.\n   *\n   * @param {'$mount'|'$update'|'$destroy'} hook The hook to trigger.\n   * @param {Base} instance The target instance.\n   * @param {string} name The name of the component.\n   * @private\n   */\n  async __triggerHook(hook: '$mount' | '$update' | '$destroy', instance: Base, name: string) {\n    if (hook === '$update' && !instance.$isMounted) {\n      // eslint-disable-next-line no-param-reassign\n      hook = '$mount';\n    }\n\n    if (hook === '$update' || hook === '$destroy') {\n      this.__eventsManager.unbindChild(name, instance);\n    }\n\n    if (hook === '$update' || hook === '$mount') {\n      this.__eventsManager.bindChild(name, instance);\n    }\n\n    await instance[hook]();\n  }\n\n  /**\n   * Register instance of a child component.\n   *\n   * @param {string} name\n   *   The name of the child component.\n   * @param {BaseConstructor|BaseAsyncConstructor} component\n   *   A Base class or a Promise for async components.\n   * @private\n   */\n  __register(name: string, component: BaseConstructor | BaseAsyncConstructor) {\n    Object.defineProperty(this, name, {\n      enumerable: true,\n      configurable: true,\n      get: () => this.__getValue(name, component),\n    });\n  }\n\n  __getValue(name: string, component: BaseConstructor | BaseAsyncConstructor) {\n    const elements = getComponentElements(name, this.__element);\n\n    if (elements.length === 0) {\n      return [];\n    }\n\n    return elements\n      .map((element) => __getChild(this, element, component))\n      .filter((instance) => instance !== 'terminated');\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/Base/managers/EventsManager.d.ts

@@ -28,6 +28,12 @@ export declare function normalizeName(name: string): string;
  * @returns {string}
  */
 export declare function normalizeEventName(name: string): string;
+export type EventManagerCallbackParams = {
+    event: Event | null;
+    args: Array<any>;
+    index: number;
+    target: Element | Base | Promise<Base> | typeof window | typeof document | null;
+};
 /**
  * Event management class.
  *

package/Base/managers/EventsManager.js

@@ -3,6 +3,7 @@ import { isArray } from "../../utils/index.js";
 import { getEventTarget, eventIsNative, eventIsDefinedInConfig } from "../utils.js";
 import { AbstractManager } from "./AbstractManager.js";
 import { normalizeRefName } from "./RefsManager.js";
+import { features } from "../features.js";
 const names = /* @__PURE__ */ new Map();
 const normalizeRegex1 = /[A-Z]([A-Z].*)/g;
 const normalizeRegex2 = /[^a-zA-Z\d\s:]/g;
@@ -100,6 +101,15 @@ function manageRootElement(that, mode = "add") {
     }
   }
 }
+function normalizeParams(params = {}) {
+  return {
+    event: null,
+    args: [],
+    index: 0,
+    target: null,
+    ...params
+  };
+}
 class EventsManager extends AbstractManager {
   __methodsCache = /* @__PURE__ */ new Map();
   /**
@@ -109,11 +119,14 @@ class EventsManager extends AbstractManager {
     handleEvent: (event) => {
       const normalizedEventName = normalizeName(event.type);
       const method = `on${normalizedEventName}`;
-      if (event instanceof CustomEvent && isArray(event.detail) && event.detail.length) {
-        this.__base[method](...event.detail, event);
-      } else {
-        this.__base[method](event);
-      }
+      const isCustomEvent = event instanceof CustomEvent;
+      this.__base[method](
+        normalizeParams({
+          event,
+          args: isCustomEvent ? event.detail ?? [] : [],
+          target: isCustomEvent ? this.__base : this.__element
+        })
+      );
     }
   };
   /**
@@ -129,7 +142,7 @@ class EventsManager extends AbstractManager {
     handleEvent: (event) => {
       const normalizedEventName = normalizeName(event.type);
       const method = `onDocument${normalizedEventName}`;
-      this.__base[method](event);
+      this.__base[method](normalizeParams({ event, target: document }));
     }
   };
   /**
@@ -145,7 +158,7 @@ class EventsManager extends AbstractManager {
     handleEvent: (event) => {
       const normalizedEventName = normalizeName(event.type);
       const method = `onWindow${normalizedEventName}`;
-      this.__base[method](event);
+      this.__base[method](normalizeParams({ event, target: window }));
     }
   };
   /**
@@ -154,7 +167,8 @@ class EventsManager extends AbstractManager {
   __refsHandler = {
     handleEvent: (event) => {
       const ref = event.currentTarget;
-      const refName = normalizeRefName(ref.dataset.ref);
+      const attributes = features.get("attributes");
+      const refName = normalizeRefName(ref.getAttribute(attributes.ref));
       const normalizedRefName = normalizeName(refName);
       const normalizedEventName = normalizeName(event.type);
       const method = `on${normalizedRefName}${normalizedEventName}`;
@@ -162,7 +176,7 @@ class EventsManager extends AbstractManager {
       if (isArray(this.__base.$refs[refName])) {
         index = this.__base.$refs[refName].indexOf(ref);
       }
-      this.__base[method](event, index);
+      this.__base[method](normalizeParams({ event, index, target: ref }));
     }
   };
   /**
@@ -183,7 +197,7 @@ class EventsManager extends AbstractManager {
       const method = `on${normalizedChildName}${normalizedEventName}`;
       const index = [...childrenManager[name]].indexOf(resolvedChild);
       const args = isArray(event.detail) ? event.detail : [];
-      this.__base[method](...args, index, event);
+      this.__base[method](normalizeParams({ event, index, args, target: resolvedChild }));
     }
   };
   /**