@studiometa/js-toolkit 2.8.0 → 2.9.1

package/Base/Base.cjs

@@ -0,0 +1,325 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+
+// packages/js-toolkit/Base/Base.ts
+var Base_exports = {};
+__export(Base_exports, {
+  Base: () => Base
+});
+module.exports = __toCommonJS(Base_exports);
+var import_utils = require("./utils.cjs");
+var import_managers = require("./managers/index.cjs");
+var import_utils2 = require("../utils/index.cjs");
+var id = 0;
+function createAndTestManagers(instance) {
+  [
+    {
+      prop: "__options",
+      constructorName: "OptionsManager",
+      constructor: import_managers.OptionsManager
+    },
+    {
+      prop: "__services",
+      constructorName: "ServicesManager",
+      constructor: import_managers.ServicesManager
+    },
+    {
+      prop: "__events",
+      constructorName: "EventsManager",
+      constructor: import_managers.EventsManager
+    },
+    {
+      prop: "__refs",
+      constructorName: "RefsManager",
+      constructor: import_managers.RefsManager
+    },
+    {
+      prop: "__children",
+      constructorName: "ChildrenManager",
+      constructor: import_managers.ChildrenManager
+    }
+  ].forEach(({ prop, constructorName, constructor }) => {
+    instance[prop] = new instance.__managers[constructorName](instance);
+    if (import_utils2.isDev && !(instance[prop] instanceof constructor)) {
+      throw new Error(
+        `The \`$managers.${constructorName}\` must extend the \`${constructorName}\` class.`
+      );
+    }
+  });
+}
+var Base = class extends EventTarget {
+  $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;
+  }
+  __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}]`) : import_utils2.noop;
+  }
+  get $warn() {
+    return this.__options.log ? window.console.warn.bind(window, `[${this.__config.name}]`) : import_utils2.noop;
+  }
+  get __debug() {
+    return import_utils2.isDev && this.__options.debug ? window.console.log.bind(window, `[debug] [${this.$id}]`) : import_utils2.noop;
+  }
+  get __managers() {
+    return {
+      ChildrenManager: import_managers.ChildrenManager,
+      EventsManager: import_managers.EventsManager,
+      OptionsManager: import_managers.OptionsManager,
+      RefsManager: import_managers.RefsManager,
+      ServicesManager: import_managers.ServicesManager
+    };
+  }
+  __callMethod(method, ...args) {
+    if (import_utils2.isDev) {
+      this.__debug("callMethod", method, ...args);
+    }
+    this.$emit(method, ...args);
+    if (!(0, import_utils2.isFunction)(this[method])) {
+      return null;
+    }
+    if (import_utils2.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 (import_utils2.isDev) {
+        throw new Error("The root element must be defined.");
+      }
+      return;
+    }
+    const { __config } = this;
+    if (__config.name === "Base") {
+      if (import_utils2.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 (import_utils2.isDev) {
+      this.__debug("constructor", this);
+    }
+  }
+  $mount() {
+    if (this.$isMounted) {
+      return this;
+    }
+    this.$emit("before-mounted");
+    if (import_utils2.isDev) {
+      this.__debug("$mount");
+    }
+    [
+      () => this.$children.registerAll(),
+      () => this.$refs.registerAll(),
+      () => this.__events.bindRootElement(),
+      () => this.$services.enableAll(),
+      () => this.$children.mountAll(),
+      () => {
+        this.$isMounted = true;
+      },
+      () => this.__callMethod("mounted")
+    ].forEach(import_utils.addToQueue);
+    return this;
+  }
+  $update() {
+    if (import_utils2.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")
+    ].forEach(import_utils.addToQueue);
+    return this;
+  }
+  $destroy() {
+    if (!this.$isMounted) {
+      return this;
+    }
+    if (import_utils2.isDev) {
+      this.__debug("$destroy");
+    }
+    [
+      () => {
+        this.$isMounted = false;
+      },
+      () => this.__events.unbindRootElement(),
+      () => this.$refs.unregisterAll(),
+      () => this.$services.disableAll(),
+      () => this.$children.destroyAll(),
+      () => this.__callMethod("destroyed")
+    ].forEach(import_utils.addToQueue);
+    return this;
+  }
+  $terminate() {
+    if (import_utils2.isDev) {
+      this.__debug("$terminate");
+    }
+    [
+      () => this.$destroy(),
+      () => this.__callMethod("terminated"),
+      () => this.$el.__base__.set(this.__ctor, "terminated")
+    ].forEach(import_utils.addToQueue);
+  }
+  __addEmits(event) {
+    const ctor = this.__ctor;
+    if ((0, import_utils2.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 (import_utils2.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 = (0, import_utils.getEventTarget)(this, event, this.__config);
+    target.addEventListener(event, listener, options);
+    return () => {
+      this.$off(event, listener, options);
+    };
+  }
+  $off(event, listener, options) {
+    if (import_utils2.isDev) {
+      this.__debug("$off", event, listener);
+    }
+    this.__eventHandlers.get(event).delete(listener);
+    const target = (0, import_utils.getEventTarget)(this, event, this.__config);
+    target.removeEventListener(event, listener, options);
+  }
+  $emit(event, ...args) {
+    if (import_utils2.isDev) {
+      this.__debug("$emit", event, args);
+    }
+    this.dispatchEvent(new CustomEvent(event, { detail: args }));
+  }
+  static $factory(nameOrSelector) {
+    if (import_utils2.isDev && !nameOrSelector) {
+      throw new Error(
+        "The $factory method requires a component\u2019s name or selector to be specified."
+      );
+    }
+    return (0, import_utils.getComponentElements)(nameOrSelector).map((el) => new this(el).$mount());
+  }
+};
+__publicField(Base, "$isBase", true);
+__publicField(Base, "config", {
+  name: "Base",
+  emits: [
+    "before-mounted",
+    "mounted",
+    "updated",
+    "destroyed",
+    "terminated",
+    "ticked",
+    "scrolled",
+    "resized",
+    "moved",
+    "loaded",
+    "keyed"
+  ]
+});
+if (module.exports.default) module.exports = module.exports.default;
+//# sourceMappingURL=Base.cjs.map

package/Base/Base.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../packages/js-toolkit/Base/Base.ts"],
+  "sourcesContent": ["/* eslint-disable no-use-before-define */\nimport { getComponentElements, getEventTarget, addToQueue } 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\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 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    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    if (isDev) {\n      this.__debug('$mount');\n    }\n\n    [\n      () => this.$children.registerAll(),\n      () => this.$refs.registerAll(),\n      () => this.__events.bindRootElement(),\n      () => this.$services.enableAll(),\n      () => this.$children.mountAll(),\n      // eslint-disable-next-line prettier/prettier\n      () => {\n        this.$isMounted = true;\n      },\n      () => this.__callMethod('mounted'),\n    ].forEach(addToQueue);\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    [\n      // Undo\n      () => this.$refs.unregisterAll(),\n      () => this.$services.disableAll(),\n      // Redo\n      () => this.$children.registerAll(),\n      () => this.$refs.registerAll(),\n      () => this.$services.enableAll(),\n      // Update\n      () => this.$children.updateAll(),\n      () => this.__callMethod('updated'),\n    ].forEach(addToQueue);\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    [\n      // eslint-disable-next-line prettier/prettier\n      () => {\n        this.$isMounted = false;\n      },\n      () => this.__events.unbindRootElement(),\n      () => this.$refs.unregisterAll(),\n      () => this.$services.disableAll(),\n      () => this.$children.destroyAll(),\n      () => this.__callMethod('destroyed'),\n    ].forEach(addToQueue);\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    [\n      // First, destroy the component.\n      () => this.$destroy(),\n      // Execute the `terminated` hook if it exists\n      () => this.__callMethod('terminated'),\n      // Delete instance\n      () => this.$el.__base__.set(this.__ctor, 'terminated'),\n    ].forEach(addToQueue);\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"]
+}

package/Base/Base.d.ts

@@ -0,0 +1,197 @@
+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 make warning easier.
+     */
+    get $warn(): (...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[];
+}