@studiometa/js-toolkit 2.0.0-beta.0 → 2.0.0-beta.12

package/Base/managers/OptionsManager.cjs

@@ -0,0 +1,167 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __markAsModule = (target) => __defProp(target, "__esModule", { value: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __reExport = (target, module2, copyDefault, desc) => {
+  if (module2 && typeof module2 === "object" || typeof module2 === "function") {
+    for (let key of __getOwnPropNames(module2))
+      if (!__hasOwnProp.call(target, key) && (copyDefault || key !== "default"))
+        __defProp(target, key, { get: () => module2[key], enumerable: !(desc = __getOwnPropDesc(module2, key)) || desc.enumerable });
+  }
+  return target;
+};
+var __toESM = (module2, isNodeMode) => {
+  return __reExport(__markAsModule(__defProp(module2 != null ? __create(__getProtoOf(module2)) : {}, "default", !isNodeMode && module2 && module2.__esModule ? { get: () => module2.default, enumerable: true } : { value: module2, enumerable: true })), module2);
+};
+var __toCommonJS = /* @__PURE__ */ ((cache) => {
+  return (module2, temp) => {
+    return cache && cache.get(module2) || (temp = __reExport(__markAsModule({}), module2, 1), cache && cache.set(module2, temp), temp);
+  };
+})(typeof WeakMap !== "undefined" ? /* @__PURE__ */ new WeakMap() : 0);
+var OptionsManager_exports = {};
+__export(OptionsManager_exports, {
+  default: () => OptionsManager
+});
+var import_deepmerge = __toESM(require("deepmerge"), 1);
+var import_isObject = __toESM(require("../../utils/object/isObject.js"), 1);
+class OptionsManager {
+  __element;
+  __values = {};
+  static types = [String, Number, Boolean, Array, Object];
+  __defaultValues = {
+    String: "",
+    Number: 0,
+    Boolean: false,
+    Array: () => [],
+    Object: () => ({})
+  };
+  name = "Base";
+  debug = false;
+  log = false;
+  constructor(element, schema, baseConfig) {
+    Object.defineProperties(this, {
+      __element: {
+        enumerable: false,
+        writable: false,
+        value: element
+      },
+      __values: {
+        enumerable: false,
+        writable: false,
+        value: this.__values
+      },
+      __defaultValues: {
+        enumerable: false,
+        writable: false,
+        value: this.__defaultValues
+      }
+    });
+    this.name = baseConfig.name;
+    schema.debug = {
+      type: Boolean,
+      default: baseConfig.debug ?? false
+    };
+    schema.log = {
+      type: Boolean,
+      default: baseConfig.log ?? false
+    };
+    Object.entries(schema).forEach(([name, config]) => {
+      this.__register(name, config);
+    });
+    return this;
+  }
+  __register(name, config) {
+    const hasDefaultValue = !OptionsManager.types.includes(config);
+    const type = hasDefaultValue ? config.type : config;
+    if (!OptionsManager.types.includes(type)) {
+      throw new Error(`The "${name}" option has an invalid type. The allowed types are: String, Number, Boolean, Array and Object.`);
+    }
+    const defaultValue = hasDefaultValue ? config.default : this.__defaultValues[type.name];
+    if ((type === Array || type === Object) && typeof defaultValue !== "function") {
+      throw new Error(`The default value for options of type "${type.name}" must be returned by a function.`);
+    }
+    Object.defineProperty(this, name, {
+      get: () => {
+        return this.get(name, type, defaultValue);
+      },
+      set: (value) => {
+        this.set(name, type, value, defaultValue);
+      },
+      enumerable: true
+    });
+  }
+  get(name, type, defaultValue) {
+    const propertyName = OptionsManager.__getPropertyName(name);
+    const hasProperty = this.__hasProperty(propertyName);
+    if (type === Boolean) {
+      if (defaultValue) {
+        const negatedPropertyName = OptionsManager.__getPropertyName(name, "No");
+        const hasNegatedProperty = this.__hasProperty(negatedPropertyName);
+        return !hasNegatedProperty;
+      }
+      return hasProperty || defaultValue;
+    }
+    const value = this.__element.dataset[propertyName];
+    if (type === Number) {
+      return hasProperty ? Number(value) : defaultValue;
+    }
+    if (type === Array || type === Object) {
+      const val = (0, import_deepmerge.default)(defaultValue(), hasProperty ? JSON.parse(value) : this.__defaultValues[type.name]());
+      if (!this.__values[name]) {
+        this.__values[name] = val;
+      }
+      return this.__values[name];
+    }
+    return hasProperty ? value : defaultValue;
+  }
+  set(name, type, value, defaultValue) {
+    const propertyName = OptionsManager.__getPropertyName(name);
+    if (value.constructor.name !== type.name) {
+      const val = Array.isArray(value) || (0, import_isObject.default)(value) ? JSON.stringify(value) : value;
+      throw new TypeError(`The "${val}" value for the "${name}" option must be of type "${type.name}"`);
+    }
+    switch (type) {
+      case Boolean:
+        if (defaultValue) {
+          const negatedPropertyName = OptionsManager.__getPropertyName(name, "No");
+          if (value) {
+            delete this.__element.dataset[negatedPropertyName];
+          } else {
+            this.__element.dataset[negatedPropertyName] = "";
+          }
+        } else if (value) {
+          this.__element.dataset[propertyName] = "";
+        } else {
+          delete this.__element.dataset[propertyName];
+        }
+        break;
+      case Array:
+      case Object:
+        this.__values[name] = value;
+        break;
+      default:
+        this.__element.dataset[propertyName] = value;
+    }
+  }
+  __hasProperty(prop) {
+    return typeof this.__element.dataset[prop] !== "undefined";
+  }
+  static __propertyNameCache = /* @__PURE__ */ new Map();
+  static __getPropertyName(name, prefix = "") {
+    const key = name + prefix;
+    if (OptionsManager.__propertyNameCache.has(key)) {
+      return OptionsManager.__propertyNameCache.get(key);
+    }
+    const propertyName = `option${prefix}${name.replace(/^\w/, (c) => c.toUpperCase())}`;
+    OptionsManager.__propertyNameCache.set(key, propertyName);
+    return propertyName;
+  }
+}
+module.exports = __toCommonJS(OptionsManager_exports);

package/Base/managers/OptionsManager.d.ts

@@ -8,6 +8,8 @@
  */
 /**
  * Class options to manage options as data attributes on an HTML element.
+ *
+ * @todo Use `MutationObserver` to update values? Might be more performant.
  * @augments {OptionsInterface}
  */
 export default class OptionsManager {

package/Base/managers/OptionsManager.js

@@ -1,28 +1,20 @@
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import deepmerge from 'deepmerge';
-import isObject from '../../utils/object/isObject.js';
-export default class OptionsManager {
+import deepmerge from "deepmerge";
+import isObject from "../../utils/object/isObject.js";
+class OptionsManager {
+  __element;
+  __values = {};
+  static types = [String, Number, Boolean, Array, Object];
+  __defaultValues = {
+    String: "",
+    Number: 0,
+    Boolean: false,
+    Array: () => [],
+    Object: () => ({})
+  };
+  name = "Base";
+  debug = false;
+  log = false;
   constructor(element, schema, baseConfig) {
-    var _baseConfig$debug, _baseConfig$log;
-
-    _defineProperty(this, "__element", void 0);
-
-    _defineProperty(this, "__values", {});
-
-    _defineProperty(this, "__defaultValues", {
-      String: '',
-      Number: 0,
-      Boolean: false,
-      Array: () => [],
-      Object: () => ({})
-    });
-
-    _defineProperty(this, "name", 'Base');
-
-    _defineProperty(this, "debug", false);
-
-    _defineProperty(this, "log", false);
-
     Object.defineProperties(this, {
       __element: {
         enumerable: false,
@@ -43,138 +35,104 @@ export default class OptionsManager {
     this.name = baseConfig.name;
     schema.debug = {
       type: Boolean,
-      default: (_baseConfig$debug = baseConfig.debug) !== null && _baseConfig$debug !== void 0 ? _baseConfig$debug : false
+      default: baseConfig.debug ?? false
     };
     schema.log = {
       type: Boolean,
-      default: (_baseConfig$log = baseConfig.log) !== null && _baseConfig$log !== void 0 ? _baseConfig$log : false
+      default: baseConfig.log ?? false
     };
-    Object.entries(schema).forEach(_ref => {
-      var [name, config] = _ref;
-
+    Object.entries(schema).forEach(([name, config]) => {
       this.__register(name, config);
     });
     return this;
   }
-
   __register(name, config) {
-    var hasDefaultValue = !OptionsManager.types.includes(config);
-    var type = hasDefaultValue ? config.type : config;
-
+    const hasDefaultValue = !OptionsManager.types.includes(config);
+    const type = hasDefaultValue ? config.type : config;
     if (!OptionsManager.types.includes(type)) {
-      throw new Error("The \"".concat(name, "\" option has an invalid type. The allowed types are: String, Number, Boolean, Array and Object."));
+      throw new Error(`The "${name}" option has an invalid type. The allowed types are: String, Number, Boolean, Array and Object.`);
     }
-
-    var defaultValue = hasDefaultValue ? config.default : this.__defaultValues[type.name];
-
-    if ((type === Array || type === Object) && typeof defaultValue !== 'function') {
-      throw new Error("The default value for options of type \"".concat(type.name, "\" must be returned by a function."));
+    const defaultValue = hasDefaultValue ? config.default : this.__defaultValues[type.name];
+    if ((type === Array || type === Object) && typeof defaultValue !== "function") {
+      throw new Error(`The default value for options of type "${type.name}" must be returned by a function.`);
     }
-
     Object.defineProperty(this, name, {
       get: () => {
         return this.get(name, type, defaultValue);
       },
-      set: value => {
+      set: (value) => {
         this.set(name, type, value, defaultValue);
       },
       enumerable: true
     });
   }
-
   get(name, type, defaultValue) {
-    var propertyName = OptionsManager.__getPropertyName(name);
-
-    var hasProperty = this.__hasProperty(propertyName);
-
+    const propertyName = OptionsManager.__getPropertyName(name);
+    const hasProperty = this.__hasProperty(propertyName);
     if (type === Boolean) {
       if (defaultValue) {
-        var negatedPropertyName = OptionsManager.__getPropertyName(name, 'No');
-
-        var hasNegatedProperty = this.__hasProperty(negatedPropertyName);
-
+        const negatedPropertyName = OptionsManager.__getPropertyName(name, "No");
+        const hasNegatedProperty = this.__hasProperty(negatedPropertyName);
         return !hasNegatedProperty;
       }
-
       return hasProperty || defaultValue;
     }
-
-    var value = this.__element.dataset[propertyName];
-
+    const value = this.__element.dataset[propertyName];
     if (type === Number) {
       return hasProperty ? Number(value) : defaultValue;
     }
-
     if (type === Array || type === Object) {
-      var val = deepmerge(defaultValue(), hasProperty ? JSON.parse(value) : this.__defaultValues[type.name]());
-
+      const val = deepmerge(defaultValue(), hasProperty ? JSON.parse(value) : this.__defaultValues[type.name]());
       if (!this.__values[name]) {
         this.__values[name] = val;
       }
-
       return this.__values[name];
     }
-
     return hasProperty ? value : defaultValue;
   }
-
   set(name, type, value, defaultValue) {
-    var propertyName = OptionsManager.__getPropertyName(name);
-
+    const propertyName = OptionsManager.__getPropertyName(name);
     if (value.constructor.name !== type.name) {
-      var val = Array.isArray(value) || isObject(value) ? JSON.stringify(value) : value;
-      throw new TypeError("The \"".concat(val, "\" value for the \"").concat(name, "\" option must be of type \"").concat(type.name, "\""));
+      const val = Array.isArray(value) || isObject(value) ? JSON.stringify(value) : value;
+      throw new TypeError(`The "${val}" value for the "${name}" option must be of type "${type.name}"`);
     }
-
     switch (type) {
       case Boolean:
         if (defaultValue) {
-          var negatedPropertyName = OptionsManager.__getPropertyName(name, 'No');
-
+          const negatedPropertyName = OptionsManager.__getPropertyName(name, "No");
           if (value) {
             delete this.__element.dataset[negatedPropertyName];
           } else {
-            this.__element.dataset[negatedPropertyName] = '';
+            this.__element.dataset[negatedPropertyName] = "";
           }
         } else if (value) {
-          this.__element.dataset[propertyName] = '';
+          this.__element.dataset[propertyName] = "";
         } else {
           delete this.__element.dataset[propertyName];
         }
-
         break;
-
       case Array:
       case Object:
         this.__values[name] = value;
         break;
-
       default:
         this.__element.dataset[propertyName] = value;
     }
   }
-
   __hasProperty(prop) {
-    return typeof this.__element.dataset[prop] !== 'undefined';
+    return typeof this.__element.dataset[prop] !== "undefined";
   }
-
-  static __getPropertyName(name) {
-    var prefix = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
-    var key = name + prefix;
-
+  static __propertyNameCache = /* @__PURE__ */ new Map();
+  static __getPropertyName(name, prefix = "") {
+    const key = name + prefix;
     if (OptionsManager.__propertyNameCache.has(key)) {
       return OptionsManager.__propertyNameCache.get(key);
     }
-
-    var propertyName = "option".concat(prefix).concat(name.replace(/^\w/, c => c.toUpperCase()));
-
+    const propertyName = `option${prefix}${name.replace(/^\w/, (c) => c.toUpperCase())}`;
     OptionsManager.__propertyNameCache.set(key, propertyName);
-
     return propertyName;
   }
-
 }
-
-_defineProperty(OptionsManager, "types", [String, Number, Boolean, Array, Object]);
-
-_defineProperty(OptionsManager, "__propertyNameCache", new Map());
+export {
+  OptionsManager as default
+};

package/Base/managers/RefsManager.cjs

@@ -0,0 +1,96 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __markAsModule = (target) => __defProp(target, "__esModule", { value: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __reExport = (target, module2, copyDefault, desc) => {
+  if (module2 && typeof module2 === "object" || typeof module2 === "function") {
+    for (let key of __getOwnPropNames(module2))
+      if (!__hasOwnProp.call(target, key) && (copyDefault || key !== "default"))
+        __defProp(target, key, { get: () => module2[key], enumerable: !(desc = __getOwnPropDesc(module2, key)) || desc.enumerable });
+  }
+  return target;
+};
+var __toCommonJS = /* @__PURE__ */ ((cache) => {
+  return (module2, temp) => {
+    return cache && cache.get(module2) || (temp = __reExport(__markAsModule({}), module2, 1), cache && cache.set(module2, temp), temp);
+  };
+})(typeof WeakMap !== "undefined" ? /* @__PURE__ */ new WeakMap() : 0);
+var RefsManager_exports = {};
+__export(RefsManager_exports, {
+  default: () => RefsManager
+});
+class RefsManager {
+  __element;
+  __refs;
+  __base;
+  __eventsManager;
+  constructor(base, element, refs, eventsManager) {
+    Object.defineProperties(this, {
+      __element: {
+        enumerable: false,
+        writable: false,
+        value: element
+      },
+      __refs: {
+        enumerable: false,
+        writable: false,
+        value: refs
+      },
+      __base: {
+        enumerable: false,
+        writable: false,
+        value: base
+      },
+      __eventsManager: {
+        enumerable: false,
+        writable: false,
+        value: eventsManager
+      }
+    });
+  }
+  registerAll() {
+    this.__refs.forEach((refName) => this.__register(refName));
+  }
+  unregisterAll() {
+    this.__refs.forEach((refName) => this.__unregister(refName));
+  }
+  __register(refName) {
+    const isMultiple = refName.endsWith("[]");
+    const propName = RefsManager.normalizeRefName(refName);
+    const refs = Array.from(this.__element.querySelectorAll(`[data-ref="${refName}"]`)).filter((ref) => this.__filterRefsBelongingToInstance(ref));
+    if (!isMultiple && refs.length > 1) {
+      console.warn(`[${this.__base.$options.name}]`, `The "${refName}" ref has been found multiple times.`, "Did you forgot to add the `[]` suffix to its name?");
+    }
+    if (!isMultiple && refs.length <= 1 && refs[0] === void 0) {
+      console.warn(`[${this.__base.$options.name}]`, `The "${refName}" ref is missing.`, `Is there an \`[data-ref="${refName}"]\` element in the component's scope?`);
+      return;
+    }
+    this.__eventsManager.bindRef(refName, refs);
+    Object.defineProperty(this, propName, {
+      value: isMultiple || refs.length > 1 ? refs : refs[0],
+      enumerable: true,
+      configurable: true
+    });
+  }
+  __unregister(refName) {
+    const propName = RefsManager.normalizeRefName(refName);
+    const refs = Array.isArray(this[propName]) ? this[propName] : [this[propName]];
+    this.__eventsManager.unbindRef(refName, refs);
+  }
+  static normalizeRefName(name) {
+    return name.endsWith("[]") ? name.replace(/\[\]$/, "") : name;
+  }
+  __filterRefsBelongingToInstance(ref) {
+    let ancestor = ref.parentElement;
+    while (ancestor && ancestor.dataset.component === void 0) {
+      ancestor = ancestor.parentElement;
+    }
+    return ancestor === null || ancestor === this.__element;
+  }
+}
+module.exports = __toCommonJS(RefsManager_exports);

package/Base/managers/RefsManager.d.ts

@@ -4,6 +4,8 @@
  */
 /**
  * Refs Manager
+ *
+ * @todo Use `MutationObserver` to automatically update refs?
  */
 export default class RefsManager {
     /**

package/Base/managers/RefsManager.js

@@ -1,14 +1,9 @@
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-export default class RefsManager {
+class RefsManager {
+  __element;
+  __refs;
+  __base;
+  __eventsManager;
   constructor(base, element, refs, eventsManager) {
-    _defineProperty(this, "__element", void 0);
-
-    _defineProperty(this, "__refs", void 0);
-
-    _defineProperty(this, "__base", void 0);
-
-    _defineProperty(this, "__eventsManager", void 0);
-
     Object.defineProperties(this, {
       __element: {
         enumerable: false,
@@ -32,52 +27,46 @@ export default class RefsManager {
       }
     });
   }
-
   registerAll() {
-    this.__refs.forEach(refName => this.__register(refName));
+    this.__refs.forEach((refName) => this.__register(refName));
   }
-
   unregisterAll() {
-    this.__refs.forEach(refName => this.__unregister(refName));
+    this.__refs.forEach((refName) => this.__unregister(refName));
   }
-
   __register(refName) {
-    var isMultiple = refName.endsWith('[]');
-    var propName = RefsManager.normalizeRefName(refName);
-    var refs = Array.from(this.__element.querySelectorAll("[data-ref=\"".concat(refName, "\"]"))).filter(ref => this.__filterRefsBelongingToInstance(ref));
-
+    const isMultiple = refName.endsWith("[]");
+    const propName = RefsManager.normalizeRefName(refName);
+    const refs = Array.from(this.__element.querySelectorAll(`[data-ref="${refName}"]`)).filter((ref) => this.__filterRefsBelongingToInstance(ref));
     if (!isMultiple && refs.length > 1) {
-      console.warn("[".concat(this.__base.$options.name, "]"), "The \"".concat(refName, "\" ref has been found multiple times."), 'Did you forgot to add the `[]` suffix to its name?');
+      console.warn(`[${this.__base.$options.name}]`, `The "${refName}" ref has been found multiple times.`, "Did you forgot to add the `[]` suffix to its name?");
+    }
+    if (!isMultiple && refs.length <= 1 && refs[0] === void 0) {
+      console.warn(`[${this.__base.$options.name}]`, `The "${refName}" ref is missing.`, `Is there an \`[data-ref="${refName}"]\` element in the component's scope?`);
+      return;
     }
-
     this.__eventsManager.bindRef(refName, refs);
-
     Object.defineProperty(this, propName, {
       value: isMultiple || refs.length > 1 ? refs : refs[0],
       enumerable: true,
       configurable: true
     });
   }
-
   __unregister(refName) {
-    var propName = RefsManager.normalizeRefName(refName);
-    var refs = Array.isArray(this[propName]) ? this[propName] : [this[propName]];
-
+    const propName = RefsManager.normalizeRefName(refName);
+    const refs = Array.isArray(this[propName]) ? this[propName] : [this[propName]];
     this.__eventsManager.unbindRef(refName, refs);
   }
-
   static normalizeRefName(name) {
-    return name.endsWith('[]') ? name.replace(/\[\]$/, '') : name;
+    return name.endsWith("[]") ? name.replace(/\[\]$/, "") : name;
   }
-
   __filterRefsBelongingToInstance(ref) {
-    var ancestor = ref.parentElement;
-
-    while (ancestor && ancestor.dataset.component === undefined) {
+    let ancestor = ref.parentElement;
+    while (ancestor && ancestor.dataset.component === void 0) {
       ancestor = ancestor.parentElement;
     }
-
     return ancestor === null || ancestor === this.__element;
   }
-
-}
+}
+export {
+  RefsManager as default
+};