@studiometa/js-toolkit 2.8.0 → 2.9.1

package/Base/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/Base/index.ts"],
-  "sourcesContent": ["/* eslint-disable no-use-before-define */\nimport { getComponentElements, getEventTarget } from './utils.js';\nimport { features } from './features.js';\nimport {\n  ChildrenManager,\n  AsyncChildrenManager,\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\n/**\n * Test if the managers' instances implement the default manager.\n * @throws\n */\nfunction createAndTestManagers(instance: Base): void {\n  [\n    {\n      prop: '__options',\n      constructorName: 'OptionsManager',\n      constructor: OptionsManager,\n    },\n    {\n      prop: '__services',\n      constructorName: 'ServicesManager',\n      constructor: ServicesManager,\n    },\n    {\n      prop: '__events',\n      constructorName: 'EventsManager',\n      constructor: EventsManager,\n    },\n    {\n      prop: '__refs',\n      constructorName: 'RefsManager',\n      constructor: RefsManager,\n    },\n    {\n      prop: '__children',\n      constructorName: 'ChildrenManager',\n      constructor: ChildrenManager,\n    },\n  ].forEach(({ prop, constructorName, constructor }) => {\n    instance[prop] = new instance.__managers[constructorName](instance);\n    if (isDev && !(instance[prop] instanceof constructor)) {\n      throw new Error(\n        `The \\`$managers.${constructorName}\\` must extend the \\`${constructorName}\\` class.`,\n      );\n    }\n  });\n}\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  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 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: features.get('asyncChildren') ? AsyncChildrenManager : 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    createAndTestManagers(this);\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    this.$isMounted = true;\n    if (isDev) {\n      this.__debug('$mount');\n    }\n    this.$children.registerAll();\n    this.$refs.registerAll();\n    this.__events.bindRootElement();\n    this.$services.enableAll();\n    this.$children.mountAll();\n\n    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    this.$refs.unregisterAll();\n    this.$services.disableAll();\n\n    // Redo\n    this.$children.registerAll();\n    this.$refs.registerAll();\n    this.$services.enableAll();\n\n    // Update\n    this.$children.updateAll();\n\n    this.__callMethod('updated');\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    this.$isMounted = false;\n    if (isDev) {\n      this.__debug('$destroy');\n    }\n    this.__events.unbindRootElement();\n    this.$refs.unregisterAll();\n    this.$services.disableAll();\n    this.$children.destroyAll();\n    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    this.$destroy();\n\n    // Execute the `terminated` hook if it exists\n    this.__callMethod('terminated');\n\n    // Delete instance\n    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   * Factory method to generate multiple instance of the class.\n   */\n  static $factory(nameOrSelector: string): Base[] {\n    if (isDev && !nameOrSelector) {\n      throw new Error(\n        'The $factory method requires a component\u2019s name or selector to be specified.',\n      );\n    }\n\n    return getComponentElements(nameOrSelector).map((el) => new this(el).$mount());\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["import_utils"]
+  "sourcesContent": ["export * from './Base.js';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,yBAAc,uBAAd;",
+  "names": []
 }

package/Base/index.d.ts

@@ -1,193 +1 @@
-import { ChildrenManager, RefsManager, ServicesManager, EventsManager, OptionsManager } from './managers/index.js';
-export type BaseEl = HTMLElement & {
-    __base__?: WeakMap<BaseConstructor, Base | 'terminated'>;
-};
-export type BaseConstructor<T extends Base = Base> = {
-    new (...args: any[]): T;
-    prototype: Base;
-} & Pick<typeof Base, keyof typeof Base>;
-export type BaseAsyncConstructor<T extends Base = Base> = (Base: any) => Promise<BaseConstructor<T> | {
-    default: BaseConstructor<T>;
-}>;
-export type BaseOptions = {
-    [name: string]: unknown;
-};
-export type BaseRefs = {
-    [name: string]: HTMLElement | HTMLElement[];
-};
-export type BaseChildren = {
-    [nameOrSelector: string]: Base[] | Promise<Base>[];
-};
-export type BaseConfigComponents = {
-    [nameOrSelector: string]: BaseConstructor | BaseAsyncConstructor;
-};
-export type BaseConfig = {
-    name: string;
-    debug?: boolean;
-    log?: boolean;
-    refs?: string[];
-    emits?: string[];
-    components?: BaseConfigComponents;
-    options?: import('./managers/OptionsManager').OptionsSchema;
-};
-export type BaseProps = {
-    $el?: HTMLElement;
-    $options?: BaseOptions;
-    $refs?: BaseRefs;
-    $children?: BaseChildren;
-    $parent?: Base;
-};
-export type Managers = {
-    ChildrenManager: typeof ChildrenManager;
-    EventsManager: typeof EventsManager;
-    OptionsManager: typeof OptionsManager;
-    RefsManager: typeof RefsManager;
-    ServicesManager: typeof ServicesManager;
-};
-/**
- * Base class.
- */
-export declare class Base<T extends BaseProps = BaseProps> extends EventTarget {
-    /**
-     * This is a Base instance.
-     */
-    static readonly $isBase: true;
-    /**
-     * The instance parent.
-     */
-    $parent: T['$parent'] & Base;
-    /**
-     * The instance id.
-     */
-    $id: string;
-    /**
-     * The root element.
-     */
-    $el: T['$el'] & BaseEl;
-    /**
-     * The state of the component.
-     */
-    $isMounted: boolean;
-    /**
-     * Store the event handlers.
-     */
-    __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>>;
-    /**
-     * Get the root instance of the app.
-     */
-    get $root(): Base;
-    /**
-     * Merge configuration with the parents' configurations.
-     */
-    get __config(): BaseConfig;
-    static config: BaseConfig;
-    __services: ServicesManager;
-    get $services(): ServicesManager;
-    __refs: RefsManager & T['$refs'] & BaseRefs;
-    get $refs(): RefsManager & T['$refs'] & BaseRefs;
-    __options: OptionsManager & T['$options'] & BaseOptions;
-    get $options(): OptionsManager & T['$options'] & BaseOptions;
-    __children: ChildrenManager & T['$children'] & BaseChildren;
-    get $children(): ChildrenManager & T['$children'] & BaseChildren;
-    __events: EventsManager;
-    /**
-     * Small helper to log stuff.
-     */
-    get $log(): (...args: unknown[]) => void;
-    /**
-     * Small helper to debug information.
-     */
-    get __debug(): (...args: unknown[]) => void;
-    /**
-     * Get manager constructors.
-     */
-    get __managers(): Managers;
-    /**
-     * Call an instance method and emit corresponding events.
-     */
-    __callMethod(method: string, ...args: unknown[]): unknown;
-    /**
-     * Test if the given event has been bound to the instance.
-     *
-     * @param   {string} event The event's name.
-     * @returns {boolean}      Wether the given event has been bound or not.
-     */
-    __hasEvent(event: string): boolean;
-    /**
-     * Class constructor where all the magic takes place.
-     *
-     * @param {HTMLElement} element The component's root element dd.
-     */
-    constructor(element: HTMLElement);
-    /**
-     * Trigger the `mounted` callback.
-     */
-    $mount(): this;
-    /**
-     * Update the instance children.
-     */
-    $update(): this;
-    /**
-     * Trigger the `destroyed` callback.
-     */
-    $destroy(): this;
-    /**
-     * Terminate a child instance when it is not needed anymore.
-     */
-    $terminate(): void;
-    /**
-     * Add an emitted event.
-     *
-     * @param   {string} event The event name.
-     * @returns {void}
-     */
-    __addEmits(event: string): void;
-    /**
-     * Remove an emitted event.
-     *
-     * @param   {string} event The event name.
-     * @returns {void}
-     */
-    __removeEmits(event: string): void;
-    /**
-     * Get the instance constructor.
-     */
-    get __ctor(): BaseConstructor;
-    /**
-     * Bind a listener function to an event.
-     *
-     * @param  {string} event
-     *   Name of the event.
-     * @param  {EventListenerOrEventListenerObject} listener
-     *   Function to be called.
-     * @param {boolean|AddEventListenerOptions} [options]
-     *   Options for the `removeEventListener` method.
-     * @returns {() => void}
-     *   A function to unbind the listener.
-     */
-    $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
-    /**
-     * Unbind a listener function from an event.
-     *
-     * @param {string} event
-     *   Name of the event.
-     * @param {EventListenerOrEventListenerObject} listener
-     *   Function to be removed.
-     * @param {boolean|EventListenerOptions} [options]
-     *   Options for the `removeEventListener` method.
-     * @returns {void}
-     */
-    $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-    /**
-     * Emits an event.
-     *
-     * @param  {string} event Name of the event.
-     * @param  {any[]}  args  The arguments to apply to the functions bound to this event.
-     * @returns {void}
-     */
-    $emit(event: string, ...args: unknown[]): void;
-    /**
-     * Factory method to generate multiple instance of the class.
-     */
-    static $factory(nameOrSelector: string): Base[];
-}
+export * from './Base.js';

package/Base/index.js

@@ -1,291 +1,2 @@
-import { getComponentElements, getEventTarget } from "./utils.js";
-import { features } from "./features.js";
-import {
-  ChildrenManager,
-  AsyncChildrenManager,
-  RefsManager,
-  ServicesManager,
-  EventsManager,
-  OptionsManager
-} from "./managers/index.js";
-import { noop, isDev, isFunction, isArray } from "../utils/index.js";
-let id = 0;
-function createAndTestManagers(instance) {
-  [
-    {
-      prop: "__options",
-      constructorName: "OptionsManager",
-      constructor: OptionsManager
-    },
-    {
-      prop: "__services",
-      constructorName: "ServicesManager",
-      constructor: ServicesManager
-    },
-    {
-      prop: "__events",
-      constructorName: "EventsManager",
-      constructor: EventsManager
-    },
-    {
-      prop: "__refs",
-      constructorName: "RefsManager",
-      constructor: RefsManager
-    },
-    {
-      prop: "__children",
-      constructorName: "ChildrenManager",
-      constructor: ChildrenManager
-    }
-  ].forEach(({ prop, constructorName, constructor }) => {
-    instance[prop] = new instance.__managers[constructorName](instance);
-    if (isDev && !(instance[prop] instanceof constructor)) {
-      throw new Error(
-        `The \`$managers.${constructorName}\` must extend the \`${constructorName}\` class.`
-      );
-    }
-  });
-}
-class Base extends EventTarget {
-  static $isBase = true;
-  $parent = null;
-  $id;
-  $el;
-  $isMounted = false;
-  __eventHandlers = /* @__PURE__ */ new Map();
-  get $root() {
-    if (!this.$parent) {
-      return this;
-    }
-    let parent = this.$parent;
-    let root = this.$parent;
-    while (parent) {
-      if (!parent.$parent) {
-        root = parent;
-      }
-      parent = parent.$parent;
-    }
-    return root;
-  }
-  get __config() {
-    let proto = Object.getPrototypeOf(this);
-    let { config } = proto.constructor;
-    while (proto.constructor.config && proto.constructor.$isBase) {
-      config = { ...proto.constructor.config, ...config };
-      if (proto.constructor.config.options) {
-        config.options = { ...proto.constructor.config.options, ...config.options };
-      }
-      if (proto.constructor.config.emits && config.emits) {
-        config.emits = [...proto.constructor.config.emits, ...config.emits];
-      }
-      proto = Object.getPrototypeOf(proto);
-    }
-    config.options = config.options ?? {};
-    config.refs = config.refs ?? [];
-    config.components = config.components ?? {};
-    return config;
-  }
-  static config = {
-    name: "Base",
-    emits: [
-      "before-mounted",
-      "mounted",
-      "updated",
-      "destroyed",
-      "terminated",
-      "ticked",
-      "scrolled",
-      "resized",
-      "moved",
-      "loaded",
-      "keyed"
-    ]
-  };
-  __services;
-  get $services() {
-    return this.__services;
-  }
-  __refs;
-  get $refs() {
-    return this.__refs;
-  }
-  __options;
-  get $options() {
-    return this.__options;
-  }
-  __children;
-  get $children() {
-    return this.__children;
-  }
-  __events;
-  get $log() {
-    return this.__options.log ? window.console.log.bind(window, `[${this.__config.name}]`) : noop;
-  }
-  get __debug() {
-    return isDev && this.__options.debug ? window.console.log.bind(window, `[debug] [${this.$id}]`) : noop;
-  }
-  get __managers() {
-    return {
-      ChildrenManager: features.get("asyncChildren") ? AsyncChildrenManager : ChildrenManager,
-      EventsManager,
-      OptionsManager,
-      RefsManager,
-      ServicesManager
-    };
-  }
-  __callMethod(method, ...args) {
-    if (isDev) {
-      this.__debug("callMethod", method, ...args);
-    }
-    this.$emit(method, ...args);
-    if (!isFunction(this[method])) {
-      return null;
-    }
-    if (isDev) {
-      this.__debug(method, this, ...args);
-    }
-    return this[method].call(this, ...args);
-  }
-  __hasEvent(event) {
-    const eventHandlers = this.__eventHandlers.get(event);
-    return eventHandlers && eventHandlers.size > 0;
-  }
-  constructor(element) {
-    super();
-    if (!element) {
-      if (isDev) {
-        throw new Error("The root element must be defined.");
-      }
-      return;
-    }
-    const { __config } = this;
-    if (__config.name === "Base") {
-      if (isDev) {
-        throw new Error("The `config.name` property is required.");
-      }
-      return;
-    }
-    this.$id = `${__config.name}-${id}`;
-    id += 1;
-    this.$el = element;
-    if (!this.$el.__base__) {
-      this.$el.__base__ = /* @__PURE__ */ new WeakMap();
-    }
-    this.$el.__base__.set(this.__ctor, this);
-    createAndTestManagers(this);
-    if (isDev) {
-      this.__debug("constructor", this);
-    }
-  }
-  $mount() {
-    if (this.$isMounted) {
-      return this;
-    }
-    this.$emit("before-mounted");
-    this.$isMounted = true;
-    if (isDev) {
-      this.__debug("$mount");
-    }
-    this.$children.registerAll();
-    this.$refs.registerAll();
-    this.__events.bindRootElement();
-    this.$services.enableAll();
-    this.$children.mountAll();
-    this.__callMethod("mounted");
-    return this;
-  }
-  $update() {
-    if (isDev) {
-      this.__debug("$update");
-    }
-    this.$refs.unregisterAll();
-    this.$services.disableAll();
-    this.$children.registerAll();
-    this.$refs.registerAll();
-    this.$services.enableAll();
-    this.$children.updateAll();
-    this.__callMethod("updated");
-    return this;
-  }
-  $destroy() {
-    if (!this.$isMounted) {
-      return this;
-    }
-    this.$isMounted = false;
-    if (isDev) {
-      this.__debug("$destroy");
-    }
-    this.__events.unbindRootElement();
-    this.$refs.unregisterAll();
-    this.$services.disableAll();
-    this.$children.destroyAll();
-    this.__callMethod("destroyed");
-    return this;
-  }
-  $terminate() {
-    if (isDev) {
-      this.__debug("$terminate");
-    }
-    this.$destroy();
-    this.__callMethod("terminated");
-    this.$el.__base__.set(this.__ctor, "terminated");
-  }
-  __addEmits(event) {
-    const ctor = this.__ctor;
-    if (isArray(ctor.config.emits)) {
-      ctor.config.emits.push(event);
-    } else {
-      ctor.config.emits = [event];
-    }
-  }
-  __removeEmits(event) {
-    const ctor = this.__ctor;
-    const index = ctor.config.emits.indexOf(event);
-    ctor.config.emits.splice(index, 1);
-  }
-  get __ctor() {
-    return this.constructor;
-  }
-  $on(event, listener, options) {
-    if (isDev) {
-      this.__debug("$on", event, listener, options);
-    }
-    let set = this.__eventHandlers.get(event);
-    if (!set) {
-      set = /* @__PURE__ */ new Set();
-      this.__eventHandlers.set(event, set);
-    }
-    set.add(listener);
-    const target = getEventTarget(this, event, this.__config);
-    target.addEventListener(event, listener, options);
-    return () => {
-      this.$off(event, listener, options);
-    };
-  }
-  $off(event, listener, options) {
-    if (isDev) {
-      this.__debug("$off", event, listener);
-    }
-    this.__eventHandlers.get(event).delete(listener);
-    const target = getEventTarget(this, event, this.__config);
-    target.removeEventListener(event, listener, options);
-  }
-  $emit(event, ...args) {
-    if (isDev) {
-      this.__debug("$emit", event, args);
-    }
-    this.dispatchEvent(new CustomEvent(event, { detail: args }));
-  }
-  static $factory(nameOrSelector) {
-    if (isDev && !nameOrSelector) {
-      throw new Error(
-        "The $factory method requires a component\u2019s name or selector to be specified."
-      );
-    }
-    return getComponentElements(nameOrSelector).map((el) => new this(el).$mount());
-  }
-}
-export {
-  Base
-};
+export * from "./Base.js";
 //# sourceMappingURL=index.js.map

package/Base/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/Base/index.ts"],
-  "sourcesContent": ["/* eslint-disable no-use-before-define */\nimport { getComponentElements, getEventTarget } from './utils.js';\nimport { features } from './features.js';\nimport {\n  ChildrenManager,\n  AsyncChildrenManager,\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\n/**\n * Test if the managers' instances implement the default manager.\n * @throws\n */\nfunction createAndTestManagers(instance: Base): void {\n  [\n    {\n      prop: '__options',\n      constructorName: 'OptionsManager',\n      constructor: OptionsManager,\n    },\n    {\n      prop: '__services',\n      constructorName: 'ServicesManager',\n      constructor: ServicesManager,\n    },\n    {\n      prop: '__events',\n      constructorName: 'EventsManager',\n      constructor: EventsManager,\n    },\n    {\n      prop: '__refs',\n      constructorName: 'RefsManager',\n      constructor: RefsManager,\n    },\n    {\n      prop: '__children',\n      constructorName: 'ChildrenManager',\n      constructor: ChildrenManager,\n    },\n  ].forEach(({ prop, constructorName, constructor }) => {\n    instance[prop] = new instance.__managers[constructorName](instance);\n    if (isDev && !(instance[prop] instanceof constructor)) {\n      throw new Error(\n        `The \\`$managers.${constructorName}\\` must extend the \\`${constructorName}\\` class.`,\n      );\n    }\n  });\n}\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  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 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: features.get('asyncChildren') ? AsyncChildrenManager : 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    createAndTestManagers(this);\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    this.$isMounted = true;\n    if (isDev) {\n      this.__debug('$mount');\n    }\n    this.$children.registerAll();\n    this.$refs.registerAll();\n    this.__events.bindRootElement();\n    this.$services.enableAll();\n    this.$children.mountAll();\n\n    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    this.$refs.unregisterAll();\n    this.$services.disableAll();\n\n    // Redo\n    this.$children.registerAll();\n    this.$refs.registerAll();\n    this.$services.enableAll();\n\n    // Update\n    this.$children.updateAll();\n\n    this.__callMethod('updated');\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    this.$isMounted = false;\n    if (isDev) {\n      this.__debug('$destroy');\n    }\n    this.__events.unbindRootElement();\n    this.$refs.unregisterAll();\n    this.$services.disableAll();\n    this.$children.destroyAll();\n    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    this.$destroy();\n\n    // Execute the `terminated` hook if it exists\n    this.__callMethod('terminated');\n\n    // Delete instance\n    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   * Factory method to generate multiple instance of the class.\n   */\n  static $factory(nameOrSelector: string): Base[] {\n    if (isDev && !nameOrSelector) {\n      throw new Error(\n        'The $factory method requires a component\u2019s name or selector to be specified.',\n      );\n    }\n\n    return getComponentElements(nameOrSelector).map((el) => new this(el).$mount());\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["export * from './Base.js';\n"],
+  "mappings": "AAAA,cAAc;",
   "names": []
 }

package/Base/managers/AbstractManager.d.ts

@@ -11,12 +11,12 @@ export declare class AbstractManager {
      * Get the base instance root element.
      */
     get __element(): HTMLElement & {
-        __base__?: WeakMap<import("../index.js").BaseConstructor<Base<import("../index.js").BaseProps>>, Base<import("../index.js").BaseProps> | "terminated">;
+        __base__?: WeakMap<import("../Base.js").BaseConstructor<Base<import("../Base.js").BaseProps>>, Base<import("../Base.js").BaseProps> | "terminated">;
     };
     /**
      * Get the base instance config.
      */
-    get __config(): import("../index.js").BaseConfig;
+    get __config(): import("../Base.js").BaseConfig;
     /**
      * Get the events manager.
      */

package/Base/managers/ChildrenManager.cjs

@@ -59,13 +59,17 @@ function __getChild(that, el, ComponentClass, name) {
   });
 }
 function __triggerHookForAll(that, hook) {
-  that.registeredNames.forEach((name) => {
-    that[name].forEach((instance) => {
-      if (instance instanceof Promise) {
-        instance.then((resolvedInstance) => that.__triggerHook(hook, resolvedInstance, name));
-      } else {
-        that.__triggerHook(hook, instance, name);
-      }
+  (0, import_utils.addToQueue)(() => {
+    that.registeredNames.forEach((name) => {
+      that[name].forEach((instance) => {
+        if (instance instanceof Promise) {
+          instance.then((resolvedInstance) => {
+            (0, import_utils.addToQueue)(() => that.__triggerHook(hook, resolvedInstance, name));
+          });
+        } else {
+          (0, import_utils.addToQueue)(() => that.__triggerHook(hook, instance, name));
+        }
+      });
     });
   });
 }