@studiometa/js-toolkit 2.10.3 → 2.12.0

package/Base/managers/EventsManager.js

@@ -11,7 +11,7 @@ function normalizeName(name) {
   if (!names.has(name)) {
     names.set(
       name,
-      name.replace(normalizeRegex1, (c) => c.toLowerCase()).replace(normalizeRegex2, " ").replace(normalizeRegex3, (c) => c.trim().toUpperCase()).trim()
+      name.replaceAll(normalizeRegex1, (c) => c.toLowerCase()).replaceAll(normalizeRegex2, " ").replaceAll(normalizeRegex3, (c) => c.trim().toUpperCase()).trim()
     );
   }
   return names.get(name);
@@ -23,7 +23,7 @@ function normalizeEventName(name) {
   if (!eventNames.has(name)) {
     eventNames.set(
       name,
-      name.replace(normalizeEventRegex1, (c) => `-${c.toLowerCase()}`).replace(normalizeEventRegex2, "")
+      name.replaceAll(normalizeEventRegex1, (c) => `-${c.toLowerCase()}`).replace(normalizeEventRegex2, "")
     );
   }
   return eventNames.get(name);
@@ -58,18 +58,22 @@ function getEventMethodsByName(that, name = "") {
 function manageRef(that, name, elements, mode = "add") {
   const action = `${mode}EventListener`;
   const methods = getEventMethodsByName(that, name);
-  methods.forEach((method) => {
+  for (const method of methods) {
     const event = getEventNameByMethod(method, name);
-    elements.filter((element) => element).forEach((element) => element[action](event, that.__refsHandler));
-  });
+    for (const element of elements) {
+      if (element instanceof EventTarget) {
+        element[action](event, that.__refsHandler);
+      }
+    }
+  }
 }
 function manageChild(that, name, instance, mode = "add") {
   const action = mode === "add" ? "$on" : "$off";
   const methods = getEventMethodsByName(that, name);
-  methods.forEach((method) => {
+  for (const method of methods) {
     const event = getEventNameByMethod(method, name);
     instance[action](event, that.__childrenHandler);
-  });
+  }
 }
 const isDocumentRegex = /^onDocument[A-Z][a-z]+/;
 const isWindowRegex = /^onWindow[A-Z][a-z]+/;
@@ -81,7 +85,7 @@ function manageRootElement(that, mode = "add") {
   const modeMethod = `${mode}EventListener`;
   const methods = getEventMethodsByName(that);
   const { __base: base, __config: config } = that;
-  methods.forEach((method) => {
+  for (const method of methods) {
     let event = getEventNameByMethod(method);
     if (eventIsDefinedInConfig(event, config) || eventIsNative(event, base.$el)) {
       const target = getEventTarget(base, event, config);
@@ -94,10 +98,13 @@ function manageRootElement(that, mode = "add") {
         methodIsDocument(method) ? that.__documentHandler : that.__windowHandler
       );
     }
-  });
+  }
 }
 class EventsManager extends AbstractManager {
   __methodsCache = /* @__PURE__ */ new Map();
+  /**
+   * Event listener object for the root element.
+   */
   __rootElementHandler = {
     handleEvent: (event) => {
       const normalizedEventName = normalizeName(event.type);
@@ -109,20 +116,41 @@ class EventsManager extends AbstractManager {
       }
     }
   };
+  /**
+   * Event listener object for the root element.
+   *
+   * @type {EventListenerObject}
+   */
   __documentHandler = {
+    /**
+     * @param   {Event|CustomEvent} event
+     * @returns {void}
+     */
     handleEvent: (event) => {
       const normalizedEventName = normalizeName(event.type);
       const method = `onDocument${normalizedEventName}`;
       this.__base[method](event);
     }
   };
+  /**
+   * Event listener object for the root element.
+   *
+   * @type {EventListenerObject}
+   */
   __windowHandler = {
+    /**
+     * @param   {Event|CustomEvent} event
+     * @returns {void}
+     */
     handleEvent: (event) => {
       const normalizedEventName = normalizeName(event.type);
       const method = `onWindow${normalizedEventName}`;
       this.__base[method](event);
     }
   };
+  /**
+   * Event listener object for the refs.
+   */
   __refsHandler = {
     handleEvent: (event) => {
       const ref = event.currentTarget;
@@ -137,12 +165,16 @@ class EventsManager extends AbstractManager {
       this.__base[method](event, index);
     }
   };
+  /**
+   * Event listener object for the children.
+   */
   __childrenHandler = {
     handleEvent: (event) => {
       const childrenManager = this.__base.$children;
       const { name, child: resolvedChild } = childrenManager.registeredNames.map((childName) => ({
         name: childName,
         child: [...childrenManager[childName]].find(
+          // @ts-ignore
           (instance) => instance === event.currentTarget || instance.$el === event.currentTarget
         )
       })).find(({ child }) => child);
@@ -154,6 +186,9 @@ class EventsManager extends AbstractManager {
       this.__base[method](...args, index, event);
     }
   };
+  /**
+   * Class constructor.
+   */
   constructor(base) {
     super(base);
     this.__hideProperties([
@@ -165,21 +200,67 @@ class EventsManager extends AbstractManager {
       "__windowHandler"
     ]);
   }
+  /**
+   * Bind event methods to the given ref elements.
+   *
+   * @param {string} name
+   *   The name of the ref.
+   * @param {HTMLElement[]} elements
+   *   The elements of the ref.
+   * @returns {void}
+   */
   bindRef(name, elements) {
     manageRef(this, name, elements);
   }
+  /**
+   * Bind event methods to the given ref elements.
+   *
+   * @param {string} name
+   *   The name of the ref.
+   * @param {HTMLElement[]} elements
+   *   The elements of the ref.
+   * @returns {void}
+   */
   unbindRef(name, elements) {
     manageRef(this, name, elements, "remove");
   }
+  /**
+   * Bind event methods to the given child instance.
+   *
+   * @param {string} name
+   *   The name of the ref.
+   * @param {Base} instance
+   *   A base instance.
+   * @returns {void}
+   */
   bindChild(name, instance) {
     manageChild(this, name, instance);
   }
+  /**
+   * Unbind event methods to the given child instance.
+   *
+   * @param {string} name
+   *   The name of the ref.
+   * @param {Base} instance
+   *   A base instance.
+   * @returns {void}
+   */
   unbindChild(name, instance) {
     manageChild(this, name, instance, "remove");
   }
+  /**
+   * Bind event methods on the root element.
+   *
+   * @returns {void}
+   */
   bindRootElement() {
     manageRootElement(this);
   }
+  /**
+   * Unbind event method from the root element.
+   *
+   * @returns {void}
+   */
   unbindRootElement() {
     manageRootElement(this, "remove");
   }

package/Base/managers/EventsManager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/Base/managers/EventsManager.ts"],
-  "sourcesContent": ["import type { Base } from '../index.js';\nimport getAllProperties from '../../utils/object/getAllProperties.js';\nimport { isArray } from '../../utils/index.js';\nimport { getEventTarget, eventIsNative, eventIsDefinedInConfig } from '../utils.js';\nimport { AbstractManager } from './AbstractManager.js';\nimport { normalizeRefName } from './RefsManager.js';\n\nconst names = new Map();\nconst normalizeRegex1 = /[A-Z]([A-Z].*)/g;\nconst normalizeRegex2 = /[^a-zA-Z\\d\\s:]/g;\nconst normalizeRegex3 = /(^\\w|\\s+\\w)/g;\n\n/**\n * Normalize the given name to PascalCase, such as:\n *\n * ```\n * sentence case          => SentenceCase\n * lowercase              => Lowercase\n * UPPERCASE              => Uppercase\n * kebab-case             => KebabCase\n * snake_case             => SnakeCase\n * camelCase              => CamelCase\n * PascalCase             => PascalCase\n * .class-selector        => ClassSelector\n * .bem__selector         => BemSelector\n * __id-selector          => IdSelector\n * .complex[class^ =\"__\"] => ComplexClass\n * ```\n *\n * @param {string} name\n * @returns {string}\n */\nexport function normalizeName(name: string): string {\n  if (!names.has(name)) {\n    names.set(\n      name,\n      name\n        .replace(normalizeRegex1, (c) => c.toLowerCase())\n        .replace(normalizeRegex2, ' ')\n        .replace(normalizeRegex3, (c) => c.trim().toUpperCase())\n        .trim(),\n    );\n  }\n\n  return names.get(name);\n}\n\nconst eventNames = new Map();\n\nconst normalizeEventRegex1 = /[A-Z]/g;\nconst normalizeEventRegex2 = /^-/;\n/**\n * Normalize the event names from PascalCase to kebab-case.\n *\n * @param {string} name\n * @returns {string}\n */\nexport function normalizeEventName(name: string): string {\n  if (!eventNames.has(name)) {\n    eventNames.set(\n      name,\n      name\n        .replace(normalizeEventRegex1, (c) => `-${c.toLowerCase()}`)\n        .replace(normalizeEventRegex2, ''),\n    );\n  }\n\n  return eventNames.get(name);\n}\n\nconst regexes = new Map();\n\n/**\n * Get a regex with a cache;\n *\n * @param   {string} regex\n * @returns {RegExp}\n */\nfunction getRegex(regex: string): RegExp {\n  if (!regexes.has(regex)) {\n    regexes.set(regex, new RegExp(regex));\n  }\n\n  return regexes.get(regex);\n}\n\n/**\n * Get the event name from the given method and its tied ref or children name.\n *\n * @param {string} method\n * @param {string} name\n * @returns {string}\n * @private\n */\nfunction getEventNameByMethod(method: string, name = ''): string {\n  const regex = getRegex(`^on${normalizeName(name)}([A-Z].*)$`);\n  const [, event] = method.match(regex);\n  return normalizeEventName(event);\n}\n\n/**\n * Get the base instance methods matching the `onSomething` pattern.\n *\n * @param {EventsManager} that\n * @param {string} [name]\n * @returns {string[]}\n * @private\n */\n// eslint-disable-next-line no-use-before-define\nfunction getEventMethodsByName(that: EventsManager, name = ''): string[] {\n  const regex = getRegex(`^on${normalizeName(name)}[A-Z].*$`);\n  const key = regex.toString();\n\n  let methods = that.__methodsCache.get(key);\n\n  if (!methods) {\n    methods = Array.from(\n      getAllProperties(that.__base, [], (method) => regex.test(method)).reduce(\n        (set, [method]) => set.add(method),\n        new Set(),\n      ),\n    ) as string[];\n    that.__methodsCache.set(key, methods);\n  }\n\n  return methods;\n}\n\n/**\n * Manage a ref event methods.\n *\n * @param {EventsManager} that\n * @param  {string} name\n *   The name of the ref.\n * @param  {HTMLElement[]} elements\n *   The elements of the ref.\n * @param  {'add'|'remove'} [mode]\n *   The action to perform: add or remove the event listeners.\n * @returns {void}\n * @private\n */\nfunction manageRef(\n  // eslint-disable-next-line no-use-before-define\n  that: EventsManager,\n  name: string,\n  elements: HTMLElement[],\n  mode: 'add' | 'remove' = 'add',\n) {\n  const action = `${mode}EventListener`;\n  const methods = getEventMethodsByName(that, name);\n  methods.forEach((method) => {\n    const event = getEventNameByMethod(method, name);\n    elements\n      .filter((element) => element)\n      .forEach((element) => element[action](event, that.__refsHandler));\n  });\n}\n/**\n * Manage event methods to the given child instance.\n *\n * @param {EventsManager} that\n * @param {string} name\n *   The name of the ref.\n * @param {Base} instance\n *   A base instance.\n * @param {'add'|'remove'} [mode]\n *   The action to perform: add or remove the event listeners.\n * @returns {void}\n * @private\n */\nfunction manageChild(\n  // eslint-disable-next-line no-use-before-define\n  that: EventsManager,\n  name: string,\n  instance: Base,\n  mode: 'add' | 'remove' = 'add',\n) {\n  const action = mode === 'add' ? '$on' : '$off';\n  const methods = getEventMethodsByName(that, name);\n  methods.forEach((method) => {\n    const event = getEventNameByMethod(method, name);\n    instance[action](event, that.__childrenHandler);\n  });\n}\n\nconst isDocumentRegex = /^onDocument[A-Z][a-z]+/;\nconst isWindowRegex = /^onWindow[A-Z][a-z]+/;\nconst methodIsDocument = (method) => isDocumentRegex.test(method);\nconst methodIsWindow = (method) => isWindowRegex.test(method);\nconst methodIsGlobal = (method) => methodIsWindow(method) || methodIsDocument(method);\nconst getGlobalEventTarget = (method) => (methodIsDocument(method) ? document : window);\n\n/**\n * Manage event methods on the root element.\n *\n * @param {EventsManager} that\n * @param {'add'|'remove'} [mode]\n *   The action to perform: add or remove the event listeners, defaults to 'add'.\n * @returns {void}\n * @private\n */\n// eslint-disable-next-line no-use-before-define\nfunction manageRootElement(that: EventsManager, mode: 'add' | 'remove' = 'add') {\n  const modeMethod = `${mode}EventListener`;\n  const methods = getEventMethodsByName(that);\n\n  const { __base: base, __config: config } = that;\n\n  methods.forEach((method) => {\n    let event = getEventNameByMethod(method);\n\n    if (eventIsDefinedInConfig(event, config) || eventIsNative(event, base.$el)) {\n      const target = getEventTarget(base, event, config);\n      target[modeMethod](event, that.__rootElementHandler);\n    } else if (methodIsGlobal(method)) {\n      event = getEventNameByMethod(method, methodIsDocument(method) ? 'document' : 'window');\n      const target = getGlobalEventTarget(method);\n      target[modeMethod](\n        event,\n        methodIsDocument(method) ? that.__documentHandler : that.__windowHandler,\n      );\n    }\n  });\n}\n\n/**\n * Event management class.\n * @todo Prevent binding of `onChildOrRefEvent` to the root element\n * @todo Use event delegation?\n */\nexport class EventsManager extends AbstractManager {\n  __methodsCache: Map<string, string[]> = new Map();\n\n  /**\n   * Event listener object for the root element.\n   */\n  __rootElementHandler: EventListenerObject = {\n    handleEvent: (event: Event | CustomEvent) => {\n      const normalizedEventName = normalizeName(event.type);\n      const method = `on${normalizedEventName}`;\n\n      if (event instanceof CustomEvent && isArray(event.detail) && event.detail.length) {\n        this.__base[method](...event.detail, event);\n      } else {\n        this.__base[method](event);\n      }\n    },\n  };\n\n  /**\n   * Event listener object for the root element.\n   *\n   * @type {EventListenerObject}\n   */\n  __documentHandler = {\n    /**\n     * @param   {Event|CustomEvent} event\n     * @returns {void}\n     */\n    handleEvent: (event) => {\n      const normalizedEventName = normalizeName(event.type);\n      const method = `onDocument${normalizedEventName}`;\n\n      this.__base[method](event);\n    },\n  };\n\n  /**\n   * Event listener object for the root element.\n   *\n   * @type {EventListenerObject}\n   */\n  __windowHandler = {\n    /**\n     * @param   {Event|CustomEvent} event\n     * @returns {void}\n     */\n    handleEvent: (event) => {\n      const normalizedEventName = normalizeName(event.type);\n      const method = `onWindow${normalizedEventName}`;\n\n      this.__base[method](event);\n    },\n  };\n\n  /**\n   * Event listener object for the refs.\n   */\n  __refsHandler: EventListenerObject = {\n    handleEvent: (event) => {\n      const ref = event.currentTarget as HTMLElement;\n      const refName = normalizeRefName(ref.dataset.ref);\n\n      const normalizedRefName = normalizeName(refName);\n      const normalizedEventName = normalizeName(event.type);\n      const method = `on${normalizedRefName}${normalizedEventName}`;\n\n      let index = 0;\n      if (isArray(this.__base.$refs[refName])) {\n        index = (this.__base.$refs[refName] as HTMLElement[]).indexOf(ref);\n      }\n\n      this.__base[method](event, index);\n    },\n  };\n\n  /**\n   * Event listener object for the children.\n   */\n  __childrenHandler: EventListenerObject = {\n    handleEvent: (event: CustomEvent) => {\n      const childrenManager = this.__base.$children;\n\n      // @todo handle async child components\n      const { name, child: resolvedChild } = childrenManager.registeredNames\n        .map((childName) => ({\n          name: childName,\n          child: [...childrenManager[childName]].find(\n            // @ts-ignore\n            (instance) => instance === event.currentTarget || instance.$el === event.currentTarget,\n          ),\n        }))\n        .find(({ child }) => child);\n\n      const normalizedChildName = normalizeName(name);\n      const normalizedEventName = normalizeName(event.type);\n      const method = `on${normalizedChildName}${normalizedEventName}`;\n\n      const index = [...childrenManager[name]].indexOf(resolvedChild);\n\n      const args = isArray(event.detail) ? event.detail : [];\n      this.__base[method](...args, index, event);\n    },\n  };\n\n  /**\n   * Class constructor.\n   */\n  constructor(base: Base) {\n    super(base);\n\n    this.__hideProperties([\n      '__methodsCache',\n      '__rootElementHandler',\n      '__refsHandler',\n      '__childrenHandler',\n      '__documentHandler',\n      '__windowHandler',\n    ]);\n  }\n\n  /**\n   * Bind event methods to the given ref elements.\n   *\n   * @param {string} name\n   *   The name of the ref.\n   * @param {HTMLElement[]} elements\n   *   The elements of the ref.\n   * @returns {void}\n   */\n  bindRef(name: string, elements: HTMLElement[]) {\n    manageRef(this, name, elements);\n  }\n\n  /**\n   * Bind event methods to the given ref elements.\n   *\n   * @param {string} name\n   *   The name of the ref.\n   * @param {HTMLElement[]} elements\n   *   The elements of the ref.\n   * @returns {void}\n   */\n  unbindRef(name: string, elements: HTMLElement[]) {\n    manageRef(this, name, elements, 'remove');\n  }\n\n  /**\n   * Bind event methods to the given child instance.\n   *\n   * @param {string} name\n   *   The name of the ref.\n   * @param {Base} instance\n   *   A base instance.\n   * @returns {void}\n   */\n  bindChild(name: string, instance: Base) {\n    manageChild(this, name, instance);\n  }\n\n  /**\n   * Unbind event methods to the given child instance.\n   *\n   * @param {string} name\n   *   The name of the ref.\n   * @param {Base} instance\n   *   A base instance.\n   * @returns {void}\n   */\n  unbindChild(name: string, instance: Base) {\n    manageChild(this, name, instance, 'remove');\n  }\n\n  /**\n   * Bind event methods on the root element.\n   *\n   * @returns {void}\n   */\n  bindRootElement() {\n    manageRootElement(this);\n  }\n\n  /**\n   * Unbind event method from the root element.\n   *\n   * @returns {void}\n   */\n  unbindRootElement() {\n    manageRootElement(this, 'remove');\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Base } from '../index.js';\nimport getAllProperties from '../../utils/object/getAllProperties.js';\nimport { isArray } from '../../utils/index.js';\nimport { getEventTarget, eventIsNative, eventIsDefinedInConfig } from '../utils.js';\nimport { AbstractManager } from './AbstractManager.js';\nimport { normalizeRefName } from './RefsManager.js';\n\nconst names = new Map();\nconst normalizeRegex1 = /[A-Z]([A-Z].*)/g;\nconst normalizeRegex2 = /[^a-zA-Z\\d\\s:]/g;\nconst normalizeRegex3 = /(^\\w|\\s+\\w)/g;\n\n/**\n * Normalize the given name to PascalCase, such as:\n *\n * ```\n * sentence case          => SentenceCase\n * lowercase              => Lowercase\n * UPPERCASE              => Uppercase\n * kebab-case             => KebabCase\n * snake_case             => SnakeCase\n * camelCase              => CamelCase\n * PascalCase             => PascalCase\n * .class-selector        => ClassSelector\n * .bem__selector         => BemSelector\n * __id-selector          => IdSelector\n * .complex[class^ =\"__\"] => ComplexClass\n * ```\n *\n * @param {string} name\n * @returns {string}\n */\nexport function normalizeName(name: string): string {\n  if (!names.has(name)) {\n    names.set(\n      name,\n      name\n        .replaceAll(normalizeRegex1, (c) => c.toLowerCase())\n        .replaceAll(normalizeRegex2, ' ')\n        .replaceAll(normalizeRegex3, (c) => c.trim().toUpperCase())\n        .trim(),\n    );\n  }\n\n  return names.get(name);\n}\n\nconst eventNames = new Map();\n\nconst normalizeEventRegex1 = /[A-Z]/g;\nconst normalizeEventRegex2 = /^-/;\n/**\n * Normalize the event names from PascalCase to kebab-case.\n *\n * @param {string} name\n * @returns {string}\n */\nexport function normalizeEventName(name: string): string {\n  if (!eventNames.has(name)) {\n    eventNames.set(\n      name,\n      name\n        .replaceAll(normalizeEventRegex1, (c) => `-${c.toLowerCase()}`)\n        .replace(normalizeEventRegex2, ''),\n    );\n  }\n\n  return eventNames.get(name);\n}\n\nconst regexes = new Map();\n\n/**\n * Get a regex with a cache;\n *\n * @param   {string} regex\n * @returns {RegExp}\n */\nfunction getRegex(regex: string): RegExp {\n  if (!regexes.has(regex)) {\n    regexes.set(regex, new RegExp(regex));\n  }\n\n  return regexes.get(regex);\n}\n\n/**\n * Get the event name from the given method and its tied ref or children name.\n *\n * @param {string} method\n * @param {string} name\n * @returns {string}\n * @private\n */\nfunction getEventNameByMethod(method: string, name = ''): string {\n  const regex = getRegex(`^on${normalizeName(name)}([A-Z].*)$`);\n  const [, event] = method.match(regex);\n  return normalizeEventName(event);\n}\n\n/**\n * Get the base instance methods matching the `onSomething` pattern.\n *\n * @param {EventsManager} that\n * @param {string} [name]\n * @returns {string[]}\n * @private\n */\n// eslint-disable-next-line no-use-before-define\nfunction getEventMethodsByName(that: EventsManager, name = ''): string[] {\n  const regex = getRegex(`^on${normalizeName(name)}[A-Z].*$`);\n  const key = regex.toString();\n\n  let methods = that.__methodsCache.get(key);\n\n  if (!methods) {\n    methods = Array.from(\n      getAllProperties(that.__base, [], (method) => regex.test(method)).reduce(\n        (set, [method]) => set.add(method),\n        new Set(),\n      ),\n    ) as string[];\n    that.__methodsCache.set(key, methods);\n  }\n\n  return methods;\n}\n\n/**\n * Manage a ref event methods.\n *\n * @param {EventsManager} that\n * @param  {string} name\n *   The name of the ref.\n * @param  {HTMLElement[]} elements\n *   The elements of the ref.\n * @param  {'add'|'remove'} [mode]\n *   The action to perform: add or remove the event listeners.\n * @returns {void}\n * @private\n */\nfunction manageRef(\n  // eslint-disable-next-line no-use-before-define\n  that: EventsManager,\n  name: string,\n  elements: HTMLElement[],\n  mode: 'add' | 'remove' = 'add',\n) {\n  const action = `${mode}EventListener`;\n  const methods = getEventMethodsByName(that, name);\n  for (const method of methods) {\n    const event = getEventNameByMethod(method, name);\n    for (const element of elements) {\n      if (element instanceof EventTarget) {\n        element[action](event, that.__refsHandler);\n      }\n    }\n  }\n}\n/**\n * Manage event methods to the given child instance.\n *\n * @param {EventsManager} that\n * @param {string} name\n *   The name of the ref.\n * @param {Base} instance\n *   A base instance.\n * @param {'add'|'remove'} [mode]\n *   The action to perform: add or remove the event listeners.\n * @returns {void}\n * @private\n */\nfunction manageChild(\n  // eslint-disable-next-line no-use-before-define\n  that: EventsManager,\n  name: string,\n  instance: Base,\n  mode: 'add' | 'remove' = 'add',\n) {\n  const action = mode === 'add' ? '$on' : '$off';\n  const methods = getEventMethodsByName(that, name);\n  for (const method of methods) {\n    const event = getEventNameByMethod(method, name);\n    instance[action](event, that.__childrenHandler);\n  }\n}\n\nconst isDocumentRegex = /^onDocument[A-Z][a-z]+/;\nconst isWindowRegex = /^onWindow[A-Z][a-z]+/;\nconst methodIsDocument = (method) => isDocumentRegex.test(method);\nconst methodIsWindow = (method) => isWindowRegex.test(method);\nconst methodIsGlobal = (method) => methodIsWindow(method) || methodIsDocument(method);\nconst getGlobalEventTarget = (method) => (methodIsDocument(method) ? document : window);\n\n/**\n * Manage event methods on the root element.\n *\n * @param {EventsManager} that\n * @param {'add'|'remove'} [mode]\n *   The action to perform: add or remove the event listeners, defaults to 'add'.\n * @returns {void}\n * @private\n */\n// eslint-disable-next-line no-use-before-define\nfunction manageRootElement(that: EventsManager, mode: 'add' | 'remove' = 'add') {\n  const modeMethod = `${mode}EventListener`;\n  const methods = getEventMethodsByName(that);\n\n  const { __base: base, __config: config } = that;\n\n  for (const method of methods) {\n    let event = getEventNameByMethod(method);\n\n    if (eventIsDefinedInConfig(event, config) || eventIsNative(event, base.$el)) {\n      const target = getEventTarget(base, event, config);\n      target[modeMethod](event, that.__rootElementHandler);\n    } else if (methodIsGlobal(method)) {\n      event = getEventNameByMethod(method, methodIsDocument(method) ? 'document' : 'window');\n      const target = getGlobalEventTarget(method);\n      target[modeMethod](\n        event,\n        methodIsDocument(method) ? that.__documentHandler : that.__windowHandler,\n      );\n    }\n  }\n}\n\n/**\n * Event management class.\n *\n * @todo Prevent binding of `onChildOrRefEvent` to the root element\n * @todo Use event delegation?\n */\nexport class EventsManager extends AbstractManager {\n  __methodsCache: Map<string, string[]> = new Map();\n\n  /**\n   * Event listener object for the root element.\n   */\n  __rootElementHandler: EventListenerObject = {\n    handleEvent: (event: Event | CustomEvent) => {\n      const normalizedEventName = normalizeName(event.type);\n      const method = `on${normalizedEventName}`;\n\n      if (event instanceof CustomEvent && isArray(event.detail) && event.detail.length) {\n        this.__base[method](...event.detail, event);\n      } else {\n        this.__base[method](event);\n      }\n    },\n  };\n\n  /**\n   * Event listener object for the root element.\n   *\n   * @type {EventListenerObject}\n   */\n  __documentHandler = {\n    /**\n     * @param   {Event|CustomEvent} event\n     * @returns {void}\n     */\n    handleEvent: (event) => {\n      const normalizedEventName = normalizeName(event.type);\n      const method = `onDocument${normalizedEventName}`;\n\n      this.__base[method](event);\n    },\n  };\n\n  /**\n   * Event listener object for the root element.\n   *\n   * @type {EventListenerObject}\n   */\n  __windowHandler = {\n    /**\n     * @param   {Event|CustomEvent} event\n     * @returns {void}\n     */\n    handleEvent: (event) => {\n      const normalizedEventName = normalizeName(event.type);\n      const method = `onWindow${normalizedEventName}`;\n\n      this.__base[method](event);\n    },\n  };\n\n  /**\n   * Event listener object for the refs.\n   */\n  __refsHandler: EventListenerObject = {\n    handleEvent: (event) => {\n      const ref = event.currentTarget as HTMLElement;\n      const refName = normalizeRefName(ref.dataset.ref);\n\n      const normalizedRefName = normalizeName(refName);\n      const normalizedEventName = normalizeName(event.type);\n      const method = `on${normalizedRefName}${normalizedEventName}`;\n\n      let index = 0;\n      if (isArray(this.__base.$refs[refName])) {\n        index = (this.__base.$refs[refName] as HTMLElement[]).indexOf(ref);\n      }\n\n      this.__base[method](event, index);\n    },\n  };\n\n  /**\n   * Event listener object for the children.\n   */\n  __childrenHandler: EventListenerObject = {\n    handleEvent: (event: CustomEvent) => {\n      const childrenManager = this.__base.$children;\n\n      // @todo handle async child components\n      const { name, child: resolvedChild } = childrenManager.registeredNames\n        .map((childName) => ({\n          name: childName,\n          child: [...childrenManager[childName]].find(\n            // @ts-ignore\n            (instance) => instance === event.currentTarget || instance.$el === event.currentTarget,\n          ),\n        }))\n        .find(({ child }) => child);\n\n      const normalizedChildName = normalizeName(name);\n      const normalizedEventName = normalizeName(event.type);\n      const method = `on${normalizedChildName}${normalizedEventName}`;\n\n      const index = [...childrenManager[name]].indexOf(resolvedChild);\n\n      const args = isArray(event.detail) ? event.detail : [];\n      this.__base[method](...args, index, event);\n    },\n  };\n\n  /**\n   * Class constructor.\n   */\n  constructor(base: Base) {\n    super(base);\n\n    this.__hideProperties([\n      '__methodsCache',\n      '__rootElementHandler',\n      '__refsHandler',\n      '__childrenHandler',\n      '__documentHandler',\n      '__windowHandler',\n    ]);\n  }\n\n  /**\n   * Bind event methods to the given ref elements.\n   *\n   * @param {string} name\n   *   The name of the ref.\n   * @param {HTMLElement[]} elements\n   *   The elements of the ref.\n   * @returns {void}\n   */\n  bindRef(name: string, elements: HTMLElement[]) {\n    manageRef(this, name, elements);\n  }\n\n  /**\n   * Bind event methods to the given ref elements.\n   *\n   * @param {string} name\n   *   The name of the ref.\n   * @param {HTMLElement[]} elements\n   *   The elements of the ref.\n   * @returns {void}\n   */\n  unbindRef(name: string, elements: HTMLElement[]) {\n    manageRef(this, name, elements, 'remove');\n  }\n\n  /**\n   * Bind event methods to the given child instance.\n   *\n   * @param {string} name\n   *   The name of the ref.\n   * @param {Base} instance\n   *   A base instance.\n   * @returns {void}\n   */\n  bindChild(name: string, instance: Base) {\n    manageChild(this, name, instance);\n  }\n\n  /**\n   * Unbind event methods to the given child instance.\n   *\n   * @param {string} name\n   *   The name of the ref.\n   * @param {Base} instance\n   *   A base instance.\n   * @returns {void}\n   */\n  unbindChild(name: string, instance: Base) {\n    manageChild(this, name, instance, 'remove');\n  }\n\n  /**\n   * Bind event methods on the root element.\n   *\n   * @returns {void}\n   */\n  bindRootElement() {\n    manageRootElement(this);\n  }\n\n  /**\n   * Unbind event method from the root element.\n   *\n   * @returns {void}\n   */\n  unbindRootElement() {\n    manageRootElement(this, 'remove');\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/Base/managers/OptionsManager.cjs

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -77,10 +81,27 @@ function __register(that, name, config) {
   });
 }
 var OptionsManager = class extends import_AbstractManager.AbstractManager {
+  /**
+   * An object to store Array and Object values for reference.
+   *
+   * @private
+   */
   __values = {};
+  /**
+   * Default value for the name property.
+   */
   name = "Base";
+  /**
+   * Default value for the debug property.
+   */
   debug = false;
+  /**
+   * Default value for the log property.
+   */
   log = false;
+  /**
+   * Class constructor.
+   */
   constructor(base) {
     super(base);
     this.__hideProperties(["__values", "__defaultValues"]);
@@ -94,14 +115,17 @@ var OptionsManager = class extends import_AbstractManager.AbstractManager {
       type: Boolean,
       default: this.__config.log ?? false
     };
-    Object.entries(schema).forEach(([name, config]) => {
+    for (const [name, config] of Object.entries(schema)) {
       __register(
         this,
         name,
         types.has(config) ? { type: config } : config
       );
-    });
+    }
   }
+  /**
+   * Get an option value.
+   */
   get(name, config) {
     const { type, default: defaultValue } = config;
     const propertyName = __getPropertyName(name);
@@ -131,6 +155,9 @@ var OptionsManager = class extends import_AbstractManager.AbstractManager {
     }
     return hasProperty ? value : defaultValue;
   }
+  /**
+   * Set an option value.
+   */
   set(name, value, config) {
     const { type, default: defaultValue } = config;
     const propertyName = __getPropertyName(name);

package/Base/managers/OptionsManager.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/Base/managers/OptionsManager.ts"],
-  "sourcesContent": ["import deepmerge from 'deepmerge';\nimport type { Options as DeepmergeOptions } from 'deepmerge';\nimport { AbstractManager } from './AbstractManager.js';\nimport { isDev, isFunction, isDefined, isBoolean, isArray, isObject } from '../../utils/index.js';\nimport type { Base } from '../index.js';\n\ntype OptionType =\n  | StringConstructor\n  | NumberConstructor\n  | BooleanConstructor\n  | ArrayConstructor\n  | ObjectConstructor;\n\ntype ArrayOption = {\n  type: ArrayConstructor;\n  default?: () => unknown[];\n  merge?: boolean | DeepmergeOptions;\n};\n\ntype ObjectOption = {\n  type: ObjectConstructor;\n  default?: () => unknown;\n  merge?: boolean | DeepmergeOptions;\n};\n\ntype StringOption = {\n  type: StringConstructor;\n  default?: string;\n};\n\ntype NumberOption = {\n  type: NumberConstructor;\n  default?: number;\n};\n\ntype BooleanOption = {\n  type: BooleanConstructor;\n  default?: boolean;\n};\n\nexport type OptionObject = ArrayOption | ObjectOption | StringOption | NumberOption | BooleanOption;\nexport type OptionsSchema = { [name: string]: OptionType | OptionObject };\nexport type OptionsInterface = { [optionName: string]: unknown };\n\n/**\n * List of allowed types.\n */\nconst types: Set<OptionType> = new Set([String, Number, Boolean, Array, Object]);\n\n/**\n * The default values to return for each available type.\n */\nconst __defaultValues = {\n  String: '',\n  Number: 0,\n  Boolean: false,\n  Array: () => [],\n  Object: () => ({}),\n};\n\n/**\n * Property name cache.\n */\nconst __propertyNameCache: Map<string, string> = new Map();\n\n/**\n * Get a property name.\n */\nexport function __getPropertyName(name: string, prefix = '') {\n  const key = name + prefix;\n\n  if (__propertyNameCache.has(key)) {\n    return __propertyNameCache.get(key);\n  }\n\n  const propertyName = `option${prefix}${name.replace(/^\\w/, (c) => c.toUpperCase())}`;\n  __propertyNameCache.set(key, propertyName);\n  return propertyName;\n}\n\n/**\n * Register an option.\n *\n * @param  {OptionsManager} that\n * @param  {string} name\n * @param  {OptionObject} config\n * @returns {void}\n * @private\n */\nfunction __register(that: OptionsManager, name: string, config: OptionObject) {\n  if (!types.has(config.type)) {\n    if (isDev) {\n      throw new Error(\n        `The \"${name}\" option has an invalid type. The allowed types are: String, Number, Boolean, Array and Object.`,\n      );\n    }\n    return;\n  }\n\n  config.default = config.default ?? __defaultValues[config.type.name];\n\n  if ((config.type === Array || config.type === Object) && !isFunction(config.default)) {\n    if (isDev) {\n      throw new Error(\n        `The default value for options of type \"${config.type.name}\" must be returned by a function.`,\n      );\n    }\n    return;\n  }\n\n  Object.defineProperty(that, name, {\n    get: () => that.get(name, config),\n    set: (value) => {\n      that.set(name, value, config);\n    },\n    enumerable: true,\n  });\n}\n\n/**\n * Class options to manage options as data attributes on an HTML element.\n *\n * @todo Use `MutationObserver` to update values? Might be more performant.\n */\nexport class OptionsManager extends AbstractManager {\n  /**\n   * An object to store Array and Object values for reference.\n   * @private\n   */\n  __values = {};\n\n  /**\n   * Default value for the name property.\n   */\n  name = 'Base';\n\n  /**\n   * Default value for the debug property.\n   */\n  debug = false;\n\n  /**\n   * Default value for the log property.\n   */\n  log = false;\n\n  /**\n   * Class constructor.\n   */\n  constructor(base: Base) {\n    super(base);\n\n    this.__hideProperties(['__values', '__defaultValues']);\n    const schema: OptionsSchema = this.__config.options || {};\n    this.name = this.__config.name;\n\n    schema.debug = {\n      type: Boolean,\n      default: this.__config.debug ?? false,\n    };\n\n    schema.log = {\n      type: Boolean,\n      default: this.__config.log ?? false,\n    };\n\n    Object.entries(schema).forEach(([name, config]) => {\n      __register(\n        this,\n        name,\n        types.has(config as OptionType)\n          ? ({ type: config as OptionType } as OptionObject)\n          : (config as OptionObject),\n      );\n    });\n  }\n\n  /**\n   * Get an option value.\n   */\n  get(name: string, config: OptionObject) {\n    const { type, default: defaultValue } = config;\n    const propertyName = __getPropertyName(name);\n    const hasProperty = isDefined(this.__element.dataset[propertyName]);\n\n    if (type === Boolean) {\n      if (defaultValue) {\n        const negatedPropertyName = __getPropertyName(name, 'No');\n        const hasNegatedProperty = isDefined(this.__element.dataset[negatedPropertyName]);\n\n        return !hasNegatedProperty;\n      }\n\n      return hasProperty || defaultValue;\n    }\n\n    const value = this.__element.dataset[propertyName];\n\n    if (type === Number) {\n      return hasProperty ? Number(value) : defaultValue;\n    }\n\n    if (type === Array || type === Object) {\n      // eslint-disable-next-line no-param-reassign\n      config = type === Array ? (config as ArrayOption) : (config as ObjectOption);\n\n      if (!this.__values[name]) {\n        let val = hasProperty ? JSON.parse(value) : config.default();\n\n        if (isDefined(config.merge)) {\n          val = isBoolean(config.merge)\n            ? deepmerge(config.default(), val)\n            : deepmerge(config.default(), val, config.merge);\n        }\n\n        this.__values[name] = val;\n      }\n\n      return this.__values[name];\n    }\n\n    return hasProperty ? value : defaultValue;\n  }\n\n  /**\n   * Set an option value.\n   */\n  set(name: string, value: unknown, config: OptionObject) {\n    const { type, default: defaultValue } = config;\n    const propertyName = __getPropertyName(name);\n\n    if (value.constructor.name !== type.name) {\n      if (isDev) {\n        const val = isArray(value) || isObject(value) ? JSON.stringify(value) : value;\n        throw new TypeError(\n          `The \"${val}\" value for the \"${name}\" option must be of type \"${type.name}\"`,\n        );\n      }\n      return;\n    }\n\n    switch (type) {\n      case Boolean:\n        if (defaultValue) {\n          const negatedPropertyName = __getPropertyName(name, 'No');\n\n          if (value) {\n            delete this.__element.dataset[negatedPropertyName];\n          } else {\n            this.__element.dataset[negatedPropertyName] = '';\n          }\n        } else if (value) {\n          this.__element.dataset[propertyName] = '';\n        } else {\n          delete this.__element.dataset[propertyName];\n        }\n        break;\n      case Array:\n      case Object:\n        this.__values[name] = value;\n        break;\n      default:\n        this.__element.dataset[propertyName] = value as string;\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import deepmerge from 'deepmerge';\nimport type { Options as DeepmergeOptions } from 'deepmerge';\nimport { AbstractManager } from './AbstractManager.js';\nimport { isDev, isFunction, isDefined, isBoolean, isArray, isObject } from '../../utils/index.js';\nimport type { Base } from '../index.js';\n\ntype OptionType =\n  | StringConstructor\n  | NumberConstructor\n  | BooleanConstructor\n  | ArrayConstructor\n  | ObjectConstructor;\n\ntype ArrayOption = {\n  type: ArrayConstructor;\n  default?: () => unknown[];\n  merge?: boolean | DeepmergeOptions;\n};\n\ntype ObjectOption = {\n  type: ObjectConstructor;\n  default?: () => unknown;\n  merge?: boolean | DeepmergeOptions;\n};\n\ntype StringOption = {\n  type: StringConstructor;\n  default?: string;\n};\n\ntype NumberOption = {\n  type: NumberConstructor;\n  default?: number;\n};\n\ntype BooleanOption = {\n  type: BooleanConstructor;\n  default?: boolean;\n};\n\nexport type OptionObject = ArrayOption | ObjectOption | StringOption | NumberOption | BooleanOption;\nexport type OptionsSchema = { [name: string]: OptionType | OptionObject };\nexport type OptionsInterface = { [optionName: string]: unknown };\n\n/**\n * List of allowed types.\n */\nconst types: Set<OptionType> = new Set([String, Number, Boolean, Array, Object]);\n\n/**\n * The default values to return for each available type.\n */\nconst __defaultValues = {\n  String: '',\n  Number: 0,\n  Boolean: false,\n  Array: () => [],\n  Object: () => ({}),\n};\n\n/**\n * Property name cache.\n */\nconst __propertyNameCache: Map<string, string> = new Map();\n\n/**\n * Get a property name.\n */\nexport function __getPropertyName(name: string, prefix = '') {\n  const key = name + prefix;\n\n  if (__propertyNameCache.has(key)) {\n    return __propertyNameCache.get(key);\n  }\n\n  const propertyName = `option${prefix}${name.replace(/^\\w/, (c) => c.toUpperCase())}`;\n  __propertyNameCache.set(key, propertyName);\n  return propertyName;\n}\n\n/**\n * Register an option.\n *\n * @param  {OptionsManager} that\n * @param  {string} name\n * @param  {OptionObject} config\n * @returns {void}\n * @private\n */\nfunction __register(that: OptionsManager, name: string, config: OptionObject) {\n  if (!types.has(config.type)) {\n    if (isDev) {\n      throw new Error(\n        `The \"${name}\" option has an invalid type. The allowed types are: String, Number, Boolean, Array and Object.`,\n      );\n    }\n    return;\n  }\n\n  config.default = config.default ?? __defaultValues[config.type.name];\n\n  if ((config.type === Array || config.type === Object) && !isFunction(config.default)) {\n    if (isDev) {\n      throw new Error(\n        `The default value for options of type \"${config.type.name}\" must be returned by a function.`,\n      );\n    }\n    return;\n  }\n\n  Object.defineProperty(that, name, {\n    get: () => that.get(name, config),\n    set: (value) => {\n      that.set(name, value, config);\n    },\n    enumerable: true,\n  });\n}\n\n/**\n * Class options to manage options as data attributes on an HTML element.\n *\n * @todo Use `MutationObserver` to update values? Might be more performant.\n */\nexport class OptionsManager extends AbstractManager {\n  /**\n   * An object to store Array and Object values for reference.\n   *\n   * @private\n   */\n  __values = {};\n\n  /**\n   * Default value for the name property.\n   */\n  name = 'Base';\n\n  /**\n   * Default value for the debug property.\n   */\n  debug = false;\n\n  /**\n   * Default value for the log property.\n   */\n  log = false;\n\n  /**\n   * Class constructor.\n   */\n  constructor(base: Base) {\n    super(base);\n\n    this.__hideProperties(['__values', '__defaultValues']);\n    const schema: OptionsSchema = this.__config.options || {};\n    this.name = this.__config.name;\n\n    schema.debug = {\n      type: Boolean,\n      default: this.__config.debug ?? false,\n    };\n\n    schema.log = {\n      type: Boolean,\n      default: this.__config.log ?? false,\n    };\n\n    for (const [name, config] of Object.entries(schema)) {\n      __register(\n        this,\n        name,\n        types.has(config as OptionType)\n          ? ({ type: config as OptionType } as OptionObject)\n          : (config as OptionObject),\n      );\n    }\n  }\n\n  /**\n   * Get an option value.\n   */\n  get(name: string, config: OptionObject) {\n    const { type, default: defaultValue } = config;\n    const propertyName = __getPropertyName(name);\n    const hasProperty = isDefined(this.__element.dataset[propertyName]);\n\n    if (type === Boolean) {\n      if (defaultValue) {\n        const negatedPropertyName = __getPropertyName(name, 'No');\n        const hasNegatedProperty = isDefined(this.__element.dataset[negatedPropertyName]);\n\n        return !hasNegatedProperty;\n      }\n\n      return hasProperty || defaultValue;\n    }\n\n    const value = this.__element.dataset[propertyName];\n\n    if (type === Number) {\n      return hasProperty ? Number(value) : defaultValue;\n    }\n\n    if (type === Array || type === Object) {\n      // eslint-disable-next-line no-param-reassign\n      config = type === Array ? (config as ArrayOption) : (config as ObjectOption);\n\n      if (!this.__values[name]) {\n        let val = hasProperty ? JSON.parse(value) : config.default();\n\n        if (isDefined(config.merge)) {\n          val = isBoolean(config.merge)\n            ? deepmerge(config.default(), val)\n            : deepmerge(config.default(), val, config.merge);\n        }\n\n        this.__values[name] = val;\n      }\n\n      return this.__values[name];\n    }\n\n    return hasProperty ? value : defaultValue;\n  }\n\n  /**\n   * Set an option value.\n   */\n  set(name: string, value: unknown, config: OptionObject) {\n    const { type, default: defaultValue } = config;\n    const propertyName = __getPropertyName(name);\n\n    if (value.constructor.name !== type.name) {\n      if (isDev) {\n        const val = isArray(value) || isObject(value) ? JSON.stringify(value) : value;\n        throw new TypeError(\n          `The \"${val}\" value for the \"${name}\" option must be of type \"${type.name}\"`,\n        );\n      }\n      return;\n    }\n\n    switch (type) {\n      case Boolean:\n        if (defaultValue) {\n          const negatedPropertyName = __getPropertyName(name, 'No');\n\n          if (value) {\n            delete this.__element.dataset[negatedPropertyName];\n          } else {\n            this.__element.dataset[negatedPropertyName] = '';\n          }\n        } else if (value) {\n          this.__element.dataset[propertyName] = '';\n        } else {\n          delete this.__element.dataset[propertyName];\n        }\n        break;\n      case Array:\n      case Object:\n        this.__values[name] = value;\n        break;\n      default:\n        this.__element.dataset[propertyName] = value as string;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": ["deepmerge"]
 }

package/Base/managers/OptionsManager.d.ts

@@ -43,6 +43,7 @@ export declare function __getPropertyName(name: string, prefix?: string): string
 export declare class OptionsManager extends AbstractManager {
     /**
      * An object to store Array and Object values for reference.
+     *
      * @private
      */
     __values: {};

package/Base/managers/OptionsManager.js

@@ -46,10 +46,27 @@ function __register(that, name, config) {
   });
 }
 class OptionsManager extends AbstractManager {
+  /**
+   * An object to store Array and Object values for reference.
+   *
+   * @private
+   */
   __values = {};
+  /**
+   * Default value for the name property.
+   */
   name = "Base";
+  /**
+   * Default value for the debug property.
+   */
   debug = false;
+  /**
+   * Default value for the log property.
+   */
   log = false;
+  /**
+   * Class constructor.
+   */
   constructor(base) {
     super(base);
     this.__hideProperties(["__values", "__defaultValues"]);
@@ -63,14 +80,17 @@ class OptionsManager extends AbstractManager {
       type: Boolean,
       default: this.__config.log ?? false
     };
-    Object.entries(schema).forEach(([name, config]) => {
+    for (const [name, config] of Object.entries(schema)) {
       __register(
         this,
         name,
         types.has(config) ? { type: config } : config
       );
-    });
+    }
   }
+  /**
+   * Get an option value.
+   */
   get(name, config) {
     const { type, default: defaultValue } = config;
     const propertyName = __getPropertyName(name);
@@ -100,6 +120,9 @@ class OptionsManager extends AbstractManager {
     }
     return hasProperty ? value : defaultValue;
   }
+  /**
+   * Set an option value.
+   */
   set(name, value, config) {
     const { type, default: defaultValue } = config;
     const propertyName = __getPropertyName(name);

package/Base/managers/OptionsManager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/Base/managers/OptionsManager.ts"],
-  "sourcesContent": ["import deepmerge from 'deepmerge';\nimport type { Options as DeepmergeOptions } from 'deepmerge';\nimport { AbstractManager } from './AbstractManager.js';\nimport { isDev, isFunction, isDefined, isBoolean, isArray, isObject } from '../../utils/index.js';\nimport type { Base } from '../index.js';\n\ntype OptionType =\n  | StringConstructor\n  | NumberConstructor\n  | BooleanConstructor\n  | ArrayConstructor\n  | ObjectConstructor;\n\ntype ArrayOption = {\n  type: ArrayConstructor;\n  default?: () => unknown[];\n  merge?: boolean | DeepmergeOptions;\n};\n\ntype ObjectOption = {\n  type: ObjectConstructor;\n  default?: () => unknown;\n  merge?: boolean | DeepmergeOptions;\n};\n\ntype StringOption = {\n  type: StringConstructor;\n  default?: string;\n};\n\ntype NumberOption = {\n  type: NumberConstructor;\n  default?: number;\n};\n\ntype BooleanOption = {\n  type: BooleanConstructor;\n  default?: boolean;\n};\n\nexport type OptionObject = ArrayOption | ObjectOption | StringOption | NumberOption | BooleanOption;\nexport type OptionsSchema = { [name: string]: OptionType | OptionObject };\nexport type OptionsInterface = { [optionName: string]: unknown };\n\n/**\n * List of allowed types.\n */\nconst types: Set<OptionType> = new Set([String, Number, Boolean, Array, Object]);\n\n/**\n * The default values to return for each available type.\n */\nconst __defaultValues = {\n  String: '',\n  Number: 0,\n  Boolean: false,\n  Array: () => [],\n  Object: () => ({}),\n};\n\n/**\n * Property name cache.\n */\nconst __propertyNameCache: Map<string, string> = new Map();\n\n/**\n * Get a property name.\n */\nexport function __getPropertyName(name: string, prefix = '') {\n  const key = name + prefix;\n\n  if (__propertyNameCache.has(key)) {\n    return __propertyNameCache.get(key);\n  }\n\n  const propertyName = `option${prefix}${name.replace(/^\\w/, (c) => c.toUpperCase())}`;\n  __propertyNameCache.set(key, propertyName);\n  return propertyName;\n}\n\n/**\n * Register an option.\n *\n * @param  {OptionsManager} that\n * @param  {string} name\n * @param  {OptionObject} config\n * @returns {void}\n * @private\n */\nfunction __register(that: OptionsManager, name: string, config: OptionObject) {\n  if (!types.has(config.type)) {\n    if (isDev) {\n      throw new Error(\n        `The \"${name}\" option has an invalid type. The allowed types are: String, Number, Boolean, Array and Object.`,\n      );\n    }\n    return;\n  }\n\n  config.default = config.default ?? __defaultValues[config.type.name];\n\n  if ((config.type === Array || config.type === Object) && !isFunction(config.default)) {\n    if (isDev) {\n      throw new Error(\n        `The default value for options of type \"${config.type.name}\" must be returned by a function.`,\n      );\n    }\n    return;\n  }\n\n  Object.defineProperty(that, name, {\n    get: () => that.get(name, config),\n    set: (value) => {\n      that.set(name, value, config);\n    },\n    enumerable: true,\n  });\n}\n\n/**\n * Class options to manage options as data attributes on an HTML element.\n *\n * @todo Use `MutationObserver` to update values? Might be more performant.\n */\nexport class OptionsManager extends AbstractManager {\n  /**\n   * An object to store Array and Object values for reference.\n   * @private\n   */\n  __values = {};\n\n  /**\n   * Default value for the name property.\n   */\n  name = 'Base';\n\n  /**\n   * Default value for the debug property.\n   */\n  debug = false;\n\n  /**\n   * Default value for the log property.\n   */\n  log = false;\n\n  /**\n   * Class constructor.\n   */\n  constructor(base: Base) {\n    super(base);\n\n    this.__hideProperties(['__values', '__defaultValues']);\n    const schema: OptionsSchema = this.__config.options || {};\n    this.name = this.__config.name;\n\n    schema.debug = {\n      type: Boolean,\n      default: this.__config.debug ?? false,\n    };\n\n    schema.log = {\n      type: Boolean,\n      default: this.__config.log ?? false,\n    };\n\n    Object.entries(schema).forEach(([name, config]) => {\n      __register(\n        this,\n        name,\n        types.has(config as OptionType)\n          ? ({ type: config as OptionType } as OptionObject)\n          : (config as OptionObject),\n      );\n    });\n  }\n\n  /**\n   * Get an option value.\n   */\n  get(name: string, config: OptionObject) {\n    const { type, default: defaultValue } = config;\n    const propertyName = __getPropertyName(name);\n    const hasProperty = isDefined(this.__element.dataset[propertyName]);\n\n    if (type === Boolean) {\n      if (defaultValue) {\n        const negatedPropertyName = __getPropertyName(name, 'No');\n        const hasNegatedProperty = isDefined(this.__element.dataset[negatedPropertyName]);\n\n        return !hasNegatedProperty;\n      }\n\n      return hasProperty || defaultValue;\n    }\n\n    const value = this.__element.dataset[propertyName];\n\n    if (type === Number) {\n      return hasProperty ? Number(value) : defaultValue;\n    }\n\n    if (type === Array || type === Object) {\n      // eslint-disable-next-line no-param-reassign\n      config = type === Array ? (config as ArrayOption) : (config as ObjectOption);\n\n      if (!this.__values[name]) {\n        let val = hasProperty ? JSON.parse(value) : config.default();\n\n        if (isDefined(config.merge)) {\n          val = isBoolean(config.merge)\n            ? deepmerge(config.default(), val)\n            : deepmerge(config.default(), val, config.merge);\n        }\n\n        this.__values[name] = val;\n      }\n\n      return this.__values[name];\n    }\n\n    return hasProperty ? value : defaultValue;\n  }\n\n  /**\n   * Set an option value.\n   */\n  set(name: string, value: unknown, config: OptionObject) {\n    const { type, default: defaultValue } = config;\n    const propertyName = __getPropertyName(name);\n\n    if (value.constructor.name !== type.name) {\n      if (isDev) {\n        const val = isArray(value) || isObject(value) ? JSON.stringify(value) : value;\n        throw new TypeError(\n          `The \"${val}\" value for the \"${name}\" option must be of type \"${type.name}\"`,\n        );\n      }\n      return;\n    }\n\n    switch (type) {\n      case Boolean:\n        if (defaultValue) {\n          const negatedPropertyName = __getPropertyName(name, 'No');\n\n          if (value) {\n            delete this.__element.dataset[negatedPropertyName];\n          } else {\n            this.__element.dataset[negatedPropertyName] = '';\n          }\n        } else if (value) {\n          this.__element.dataset[propertyName] = '';\n        } else {\n          delete this.__element.dataset[propertyName];\n        }\n        break;\n      case Array:\n      case Object:\n        this.__values[name] = value;\n        break;\n      default:\n        this.__element.dataset[propertyName] = value as string;\n    }\n  }\n}\n"],
-  "mappings": "AAAA,OAAO,eAAe;AAEtB,SAAS,uBAAuB;AAChC,SAAS,OAAO,YAAY,WAAW,WAAW,SAAS,gBAAgB;AA4C3E,MAAM,QAAyB,oBAAI,IAAI,CAAC,QAAQ,QAAQ,SAAS,OAAO,MAAM,CAAC;AAK/E,MAAM,kBAAkB;AAAA,EACtB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,OAAO,MAAM,CAAC;AAAA,EACd,QAAQ,OAAO,CAAC;AAClB;AAKA,MAAM,sBAA2C,oBAAI,IAAI;AAKlD,SAAS,kBAAkB,MAAc,SAAS,IAAI;AAC3D,QAAM,MAAM,OAAO;AAEnB,MAAI,oBAAoB,IAAI,GAAG,GAAG;AAChC,WAAO,oBAAoB,IAAI,GAAG;AAAA,EACpC;AAEA,QAAM,eAAe,SAAS,SAAS,KAAK,QAAQ,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC;AACjF,sBAAoB,IAAI,KAAK,YAAY;AACzC,SAAO;AACT;AAWA,SAAS,WAAW,MAAsB,MAAc,QAAsB;AAC5E,MAAI,CAAC,MAAM,IAAI,OAAO,IAAI,GAAG;AAC3B,QAAI,OAAO;AACT,YAAM,IAAI;AAAA,QACR,QAAQ;AAAA,MACV;AAAA,IACF;AACA;AAAA,EACF;AAEA,SAAO,UAAU,OAAO,WAAW,gBAAgB,OAAO,KAAK;AAE/D,OAAK,OAAO,SAAS,SAAS,OAAO,SAAS,WAAW,CAAC,WAAW,OAAO,OAAO,GAAG;AACpF,QAAI,OAAO;AACT,YAAM,IAAI;AAAA,QACR,0CAA0C,OAAO,KAAK;AAAA,MACxD;AAAA,IACF;AACA;AAAA,EACF;AAEA,SAAO,eAAe,MAAM,MAAM;AAAA,IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,MAAM;AAAA,IAChC,KAAK,CAAC,UAAU;AACd,WAAK,IAAI,MAAM,OAAO,MAAM;AAAA,IAC9B;AAAA,IACA,YAAY;AAAA,EACd,CAAC;AACH;AAOO,MAAM,uBAAuB,gBAAgB;AAAA,EAKlD,WAAW,CAAC;AAAA,EAKZ,OAAO;AAAA,EAKP,QAAQ;AAAA,EAKR,MAAM;AAAA,EAKN,YAAY,MAAY;AACtB,UAAM,IAAI;AAEV,SAAK,iBAAiB,CAAC,YAAY,iBAAiB,CAAC;AACrD,UAAM,SAAwB,KAAK,SAAS,WAAW,CAAC;AACxD,SAAK,OAAO,KAAK,SAAS;AAE1B,WAAO,QAAQ;AAAA,MACb,MAAM;AAAA,MACN,SAAS,KAAK,SAAS,SAAS;AAAA,IAClC;AAEA,WAAO,MAAM;AAAA,MACX,MAAM;AAAA,MACN,SAAS,KAAK,SAAS,OAAO;AAAA,IAChC;AAEA,WAAO,QAAQ,MAAM,EAAE,QAAQ,CAAC,CAAC,MAAM,MAAM,MAAM;AACjD;AAAA,QACE;AAAA,QACA;AAAA,QACA,MAAM,IAAI,MAAoB,IACzB,EAAE,MAAM,OAAqB,IAC7B;AAAA,MACP;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAKA,IAAI,MAAc,QAAsB;AACtC,UAAM,EAAE,MAAM,SAAS,aAAa,IAAI;AACxC,UAAM,eAAe,kBAAkB,IAAI;AAC3C,UAAM,cAAc,UAAU,KAAK,UAAU,QAAQ,aAAa;AAElE,QAAI,SAAS,SAAS;AACpB,UAAI,cAAc;AAChB,cAAM,sBAAsB,kBAAkB,MAAM,IAAI;AACxD,cAAM,qBAAqB,UAAU,KAAK,UAAU,QAAQ,oBAAoB;AAEhF,eAAO,CAAC;AAAA,MACV;AAEA,aAAO,eAAe;AAAA,IACxB;AAEA,UAAM,QAAQ,KAAK,UAAU,QAAQ;AAErC,QAAI,SAAS,QAAQ;AACnB,aAAO,cAAc,OAAO,KAAK,IAAI;AAAA,IACvC;AAEA,QAAI,SAAS,SAAS,SAAS,QAAQ;AAErC,eAAS,SAAS,QAAS,SAA0B;AAErD,UAAI,CAAC,KAAK,SAAS,OAAO;AACxB,YAAI,MAAM,cAAc,KAAK,MAAM,KAAK,IAAI,OAAO,QAAQ;AAE3D,YAAI,UAAU,OAAO,KAAK,GAAG;AAC3B,gBAAM,UAAU,OAAO,KAAK,IACxB,UAAU,OAAO,QAAQ,GAAG,GAAG,IAC/B,UAAU,OAAO,QAAQ,GAAG,KAAK,OAAO,KAAK;AAAA,QACnD;AAEA,aAAK,SAAS,QAAQ;AAAA,MACxB;AAEA,aAAO,KAAK,SAAS;AAAA,IACvB;AAEA,WAAO,cAAc,QAAQ;AAAA,EAC/B;AAAA,EAKA,IAAI,MAAc,OAAgB,QAAsB;AACtD,UAAM,EAAE,MAAM,SAAS,aAAa,IAAI;AACxC,UAAM,eAAe,kBAAkB,IAAI;AAE3C,QAAI,MAAM,YAAY,SAAS,KAAK,MAAM;AACxC,UAAI,OAAO;AACT,cAAM,MAAM,QAAQ,KAAK,KAAK,SAAS,KAAK,IAAI,KAAK,UAAU,KAAK,IAAI;AACxE,cAAM,IAAI;AAAA,UACR,QAAQ,uBAAuB,iCAAiC,KAAK;AAAA,QACvE;AAAA,MACF;AACA;AAAA,IACF;AAEA,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,YAAI,cAAc;AAChB,gBAAM,sBAAsB,kBAAkB,MAAM,IAAI;AAExD,cAAI,OAAO;AACT,mBAAO,KAAK,UAAU,QAAQ;AAAA,UAChC,OAAO;AACL,iBAAK,UAAU,QAAQ,uBAAuB;AAAA,UAChD;AAAA,QACF,WAAW,OAAO;AAChB,eAAK,UAAU,QAAQ,gBAAgB;AAAA,QACzC,OAAO;AACL,iBAAO,KAAK,UAAU,QAAQ;AAAA,QAChC;AACA;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,aAAK,SAAS,QAAQ;AACtB;AAAA,MACF;AACE,aAAK,UAAU,QAAQ,gBAAgB;AAAA,IAC3C;AAAA,EACF;AACF;",
+  "sourcesContent": ["import deepmerge from 'deepmerge';\nimport type { Options as DeepmergeOptions } from 'deepmerge';\nimport { AbstractManager } from './AbstractManager.js';\nimport { isDev, isFunction, isDefined, isBoolean, isArray, isObject } from '../../utils/index.js';\nimport type { Base } from '../index.js';\n\ntype OptionType =\n  | StringConstructor\n  | NumberConstructor\n  | BooleanConstructor\n  | ArrayConstructor\n  | ObjectConstructor;\n\ntype ArrayOption = {\n  type: ArrayConstructor;\n  default?: () => unknown[];\n  merge?: boolean | DeepmergeOptions;\n};\n\ntype ObjectOption = {\n  type: ObjectConstructor;\n  default?: () => unknown;\n  merge?: boolean | DeepmergeOptions;\n};\n\ntype StringOption = {\n  type: StringConstructor;\n  default?: string;\n};\n\ntype NumberOption = {\n  type: NumberConstructor;\n  default?: number;\n};\n\ntype BooleanOption = {\n  type: BooleanConstructor;\n  default?: boolean;\n};\n\nexport type OptionObject = ArrayOption | ObjectOption | StringOption | NumberOption | BooleanOption;\nexport type OptionsSchema = { [name: string]: OptionType | OptionObject };\nexport type OptionsInterface = { [optionName: string]: unknown };\n\n/**\n * List of allowed types.\n */\nconst types: Set<OptionType> = new Set([String, Number, Boolean, Array, Object]);\n\n/**\n * The default values to return for each available type.\n */\nconst __defaultValues = {\n  String: '',\n  Number: 0,\n  Boolean: false,\n  Array: () => [],\n  Object: () => ({}),\n};\n\n/**\n * Property name cache.\n */\nconst __propertyNameCache: Map<string, string> = new Map();\n\n/**\n * Get a property name.\n */\nexport function __getPropertyName(name: string, prefix = '') {\n  const key = name + prefix;\n\n  if (__propertyNameCache.has(key)) {\n    return __propertyNameCache.get(key);\n  }\n\n  const propertyName = `option${prefix}${name.replace(/^\\w/, (c) => c.toUpperCase())}`;\n  __propertyNameCache.set(key, propertyName);\n  return propertyName;\n}\n\n/**\n * Register an option.\n *\n * @param  {OptionsManager} that\n * @param  {string} name\n * @param  {OptionObject} config\n * @returns {void}\n * @private\n */\nfunction __register(that: OptionsManager, name: string, config: OptionObject) {\n  if (!types.has(config.type)) {\n    if (isDev) {\n      throw new Error(\n        `The \"${name}\" option has an invalid type. The allowed types are: String, Number, Boolean, Array and Object.`,\n      );\n    }\n    return;\n  }\n\n  config.default = config.default ?? __defaultValues[config.type.name];\n\n  if ((config.type === Array || config.type === Object) && !isFunction(config.default)) {\n    if (isDev) {\n      throw new Error(\n        `The default value for options of type \"${config.type.name}\" must be returned by a function.`,\n      );\n    }\n    return;\n  }\n\n  Object.defineProperty(that, name, {\n    get: () => that.get(name, config),\n    set: (value) => {\n      that.set(name, value, config);\n    },\n    enumerable: true,\n  });\n}\n\n/**\n * Class options to manage options as data attributes on an HTML element.\n *\n * @todo Use `MutationObserver` to update values? Might be more performant.\n */\nexport class OptionsManager extends AbstractManager {\n  /**\n   * An object to store Array and Object values for reference.\n   *\n   * @private\n   */\n  __values = {};\n\n  /**\n   * Default value for the name property.\n   */\n  name = 'Base';\n\n  /**\n   * Default value for the debug property.\n   */\n  debug = false;\n\n  /**\n   * Default value for the log property.\n   */\n  log = false;\n\n  /**\n   * Class constructor.\n   */\n  constructor(base: Base) {\n    super(base);\n\n    this.__hideProperties(['__values', '__defaultValues']);\n    const schema: OptionsSchema = this.__config.options || {};\n    this.name = this.__config.name;\n\n    schema.debug = {\n      type: Boolean,\n      default: this.__config.debug ?? false,\n    };\n\n    schema.log = {\n      type: Boolean,\n      default: this.__config.log ?? false,\n    };\n\n    for (const [name, config] of Object.entries(schema)) {\n      __register(\n        this,\n        name,\n        types.has(config as OptionType)\n          ? ({ type: config as OptionType } as OptionObject)\n          : (config as OptionObject),\n      );\n    }\n  }\n\n  /**\n   * Get an option value.\n   */\n  get(name: string, config: OptionObject) {\n    const { type, default: defaultValue } = config;\n    const propertyName = __getPropertyName(name);\n    const hasProperty = isDefined(this.__element.dataset[propertyName]);\n\n    if (type === Boolean) {\n      if (defaultValue) {\n        const negatedPropertyName = __getPropertyName(name, 'No');\n        const hasNegatedProperty = isDefined(this.__element.dataset[negatedPropertyName]);\n\n        return !hasNegatedProperty;\n      }\n\n      return hasProperty || defaultValue;\n    }\n\n    const value = this.__element.dataset[propertyName];\n\n    if (type === Number) {\n      return hasProperty ? Number(value) : defaultValue;\n    }\n\n    if (type === Array || type === Object) {\n      // eslint-disable-next-line no-param-reassign\n      config = type === Array ? (config as ArrayOption) : (config as ObjectOption);\n\n      if (!this.__values[name]) {\n        let val = hasProperty ? JSON.parse(value) : config.default();\n\n        if (isDefined(config.merge)) {\n          val = isBoolean(config.merge)\n            ? deepmerge(config.default(), val)\n            : deepmerge(config.default(), val, config.merge);\n        }\n\n        this.__values[name] = val;\n      }\n\n      return this.__values[name];\n    }\n\n    return hasProperty ? value : defaultValue;\n  }\n\n  /**\n   * Set an option value.\n   */\n  set(name: string, value: unknown, config: OptionObject) {\n    const { type, default: defaultValue } = config;\n    const propertyName = __getPropertyName(name);\n\n    if (value.constructor.name !== type.name) {\n      if (isDev) {\n        const val = isArray(value) || isObject(value) ? JSON.stringify(value) : value;\n        throw new TypeError(\n          `The \"${val}\" value for the \"${name}\" option must be of type \"${type.name}\"`,\n        );\n      }\n      return;\n    }\n\n    switch (type) {\n      case Boolean:\n        if (defaultValue) {\n          const negatedPropertyName = __getPropertyName(name, 'No');\n\n          if (value) {\n            delete this.__element.dataset[negatedPropertyName];\n          } else {\n            this.__element.dataset[negatedPropertyName] = '';\n          }\n        } else if (value) {\n          this.__element.dataset[propertyName] = '';\n        } else {\n          delete this.__element.dataset[propertyName];\n        }\n        break;\n      case Array:\n      case Object:\n        this.__values[name] = value;\n        break;\n      default:\n        this.__element.dataset[propertyName] = value as string;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/Base/managers/RefsManager.cjs

@@ -26,11 +26,24 @@ module.exports = __toCommonJS(RefsManager_exports);
 var import_AbstractManager = require("./AbstractManager.cjs");
 var import_utils = require("../../utils/index.cjs");
 var NORMALIZE_REF_NAME_REGEX = /\[\]$/;
+var NAMESPACED_REF_REGEX = /^(.*\.)/;
+var normalizedRefNamesCache = /* @__PURE__ */ new Map();
 function normalizeRefName(name) {
-  return name.endsWith("[]") ? name.replace(NORMALIZE_REF_NAME_REGEX, "") : name;
+  if (normalizedRefNamesCache.has(name)) {
+    return normalizedRefNamesCache.get(name);
+  }
+  let normalizedName = name;
+  if ((0, import_utils.endsWith)(name, "[]")) {
+    normalizedName = normalizedName.replace(NORMALIZE_REF_NAME_REGEX, "");
+  }
+  if (normalizedName.includes(".")) {
+    return normalizedName.replace(NAMESPACED_REF_REGEX, "");
+  }
+  normalizedRefNamesCache.set(name, normalizedName);
+  return normalizedName;
 }
 function refBelongToInstance(ref, rootElement, name) {
-  const isPrefixed = ref.dataset.ref.startsWith(name);
+  const isPrefixed = (0, import_utils.startsWith)(ref.dataset.ref, name);
   const firstComponentAncestor = (0, import_utils.getAncestorWhereUntil)(
     ref,
     (el) => el && (isPrefixed ? el.dataset.component === name && el : (0, import_utils.isDefined)(el.dataset.component)) && el !== rootElement,
@@ -39,7 +52,7 @@ function refBelongToInstance(ref, rootElement, name) {
   return firstComponentAncestor === rootElement;
 }
 function __register(that, refName) {
-  const isMultiple = refName.endsWith("[]");
+  const isMultiple = (0, import_utils.endsWith)(refName, "[]");
   const propName = normalizeRefName(refName);
   const { name } = that.__base.$options;
   const refs = Array.from(
@@ -49,6 +62,7 @@ function __register(that, refName) {
   ).filter((ref) => refBelongToInstance(ref, that.__element, name));
   if (import_utils.isDev && !isMultiple && refs.length > 1) {
     console.warn(
+      // @ts-ignore
       `[${that.__base.$options.name}]`,
       `The "${refName}" ref has been found multiple times.`,
       "Did you forgot to add the `[]` suffix to its name?"
@@ -57,6 +71,7 @@ function __register(that, refName) {
   if (!isMultiple && refs.length <= 1 && !(0, import_utils.isDefined)(refs[0])) {
     if (import_utils.isDev) {
       console.warn(
+        // @ts-ignore
         `[${that.__base.$options.name}]`,
         `The "${refName}" ref is missing.`,
         `Is there an \`[data-ref="${refName}"]\` element in the component's scope?`
@@ -66,6 +81,7 @@ function __register(that, refName) {
   }
   that.__eventsManager.bindRef(refName, refs);
   Object.defineProperty(that, propName, {
+    // @todo remove usage of non-multiple refs as array
     value: isMultiple || refs.length > 1 ? refs : refs[0],
     enumerable: true,
     configurable: true
@@ -77,14 +93,25 @@ function __unregister(that, refName) {
   that.__eventsManager.unbindRef(refName, refs);
 }
 var RefsManager = class extends import_AbstractManager.AbstractManager {
+  /**
+   * Get refs configuration.
+   */
   get __refs() {
     return this.__config.refs ?? [];
   }
+  /**
+   * Register all refs.
+   */
   registerAll() {
-    this.__refs.forEach((refName) => __register(this, refName));
+    for (const refName of this.__refs)
+      __register(this, refName);
   }
+  /**
+   * Unregister all refs.
+   */
   unregisterAll() {
-    this.__refs.forEach((refName) => __unregister(this, refName));
+    for (const refName of this.__refs)
+      __unregister(this, refName);
   }
 };
 if (module.exports.default) module.exports = module.exports.default;