@studiometa/js-toolkit 2.2.1 → 2.3.0

package/Base/index.cjs

@@ -36,10 +36,8 @@ var import_RefsManager = __toESM(require("./managers/RefsManager.cjs"), 1);
 var import_ServicesManager = __toESM(require("./managers/ServicesManager.cjs"), 1);
 var import_EventsManager = __toESM(require("./managers/EventsManager.cjs"), 1);
 var import_OptionsManager = __toESM(require("./managers/OptionsManager.cjs"), 1);
+var import_utils2 = require("../utils/index.cjs");
 var id = 0;
-var isDev = typeof __DEV__ !== "undefined" && __DEV__;
-function noop() {
-}
 function createAndTestManagers(instance) {
   [
     {
@@ -69,43 +67,17 @@ function createAndTestManagers(instance) {
     }
   ].forEach(({ prop, constructorName, constructor }) => {
     instance[prop] = new instance.__managers[constructorName](instance);
-    if (!(instance[prop] instanceof constructor)) {
+    if (import_utils2.isDev && !(instance[prop] instanceof constructor)) {
       throw new Error(`The \`$managers.${constructorName}\` must extend the \`${constructorName}\` class.`);
     }
   });
 }
 var Base = class extends EventTarget {
-  constructor(element) {
-    super();
-    __publicField(this, "$parent", null);
-    __publicField(this, "$id");
-    __publicField(this, "$el");
-    __publicField(this, "$isMounted", false);
-    __publicField(this, "__eventHandlers", /* @__PURE__ */ new Map());
-    __publicField(this, "__services");
-    __publicField(this, "__refs");
-    __publicField(this, "__options");
-    __publicField(this, "__children");
-    __publicField(this, "__events");
-    if (!element) {
-      throw new Error("The root element must be defined.");
-    }
-    const { __config } = this;
-    if (__config.name === "Base") {
-      throw new Error("The `config.name` property is required.");
-    }
-    this.$id = `${__config.name}-${id}`;
-    id += 1;
-    this.$el = element;
-    if (!this.$el.__base__) {
-      this.$el.__base__ = /* @__PURE__ */ new WeakMap();
-    }
-    this.$el.__base__.set(this.__ctor, this);
-    createAndTestManagers(this);
-    if (isDev) {
-      this.__debug("constructor", this);
-    }
-  }
+  $parent = null;
+  $id;
+  $el;
+  $isMounted = false;
+  __eventHandlers = /* @__PURE__ */ new Map();
   get $root() {
     if (!this.$parent) {
       return this;
@@ -121,7 +93,6 @@ var Base = class extends EventTarget {
     return root;
   }
   get __config() {
-    var _a, _b, _c;
     let proto = Object.getPrototypeOf(this);
     let { config } = proto.constructor;
     while (proto.constructor.config && proto.constructor.$isBase) {
@@ -134,28 +105,33 @@ var Base = class extends EventTarget {
       }
       proto = Object.getPrototypeOf(proto);
     }
-    config.options = (_a = config.options) != null ? _a : {};
-    config.refs = (_b = config.refs) != null ? _b : [];
-    config.components = (_c = config.components) != null ? _c : {};
+    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}]`) : noop;
+    return this.__options.log ? window.console.log.bind(window, `[${this.__config.name}]`) : import_utils2.noop;
   }
   get __debug() {
-    return isDev && this.__options.debug ? window.console.log.bind(window, `[debug] [${this.$id}]`) : noop;
+    return import_utils2.isDev && this.__options.debug ? window.console.log.bind(window, `[debug] [${this.$id}]`) : import_utils2.noop;
   }
   get __managers() {
     return {
@@ -167,14 +143,14 @@ var Base = class extends EventTarget {
     };
   }
   __callMethod(method, ...args) {
-    if (isDev) {
+    if (import_utils2.isDev) {
       this.__debug("callMethod", method, ...args);
     }
     this.$emit(method, ...args);
-    if (typeof this[method] !== "function") {
+    if (!(0, import_utils2.isFunction)(this[method])) {
       return null;
     }
-    if (isDev) {
+    if (import_utils2.isDev) {
       this.__debug(method, this, ...args);
     }
     return this[method].call(this, ...args);
@@ -183,13 +159,40 @@ var Base = class extends EventTarget {
     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");
     this.$isMounted = true;
-    if (isDev) {
+    if (import_utils2.isDev) {
       this.__debug("$mount");
     }
     this.$children.registerAll();
@@ -201,7 +204,7 @@ var Base = class extends EventTarget {
     return this;
   }
   $update() {
-    if (isDev) {
+    if (import_utils2.isDev) {
       this.__debug("$update");
     }
     this.$refs.unregisterAll();
@@ -218,7 +221,7 @@ var Base = class extends EventTarget {
       return this;
     }
     this.$isMounted = false;
-    if (isDev) {
+    if (import_utils2.isDev) {
       this.__debug("$destroy");
     }
     this.__events.unbindRootElement();
@@ -229,21 +232,16 @@ var Base = class extends EventTarget {
     return this;
   }
   $terminate() {
-    if (isDev) {
+    if (import_utils2.isDev) {
       this.__debug("$terminate");
     }
     this.$destroy();
     this.__callMethod("terminated");
     this.$el.__base__.set(this.__ctor, "terminated");
   }
-  __testEventIsDefined(event) {
-    if (!(Array.isArray(this.__config.emits) && this.__config.emits.includes(event))) {
-      console.warn(`[${this.__config.name}]`, `The "${event}" event is missing from the configuration.`);
-    }
-  }
   __addEmits(event) {
     const ctor = this.__ctor;
-    if (Array.isArray(ctor.config.emits)) {
+    if ((0, import_utils2.isArray)(ctor.config.emits)) {
       ctor.config.emits.push(event);
     } else {
       ctor.config.emits = [event];
@@ -258,44 +256,37 @@ var Base = class extends EventTarget {
     return this.constructor;
   }
   $on(event, listener, options) {
-    if (isDev) {
+    if (import_utils2.isDev) {
       this.__debug("$on", event, listener, options);
     }
-    if (isDev) {
-      this.__testEventIsDefined(event);
-    }
     let set = this.__eventHandlers.get(event);
     if (!set) {
       set = /* @__PURE__ */ new Set();
       this.__eventHandlers.set(event, set);
     }
     set.add(listener);
-    this.addEventListener(event, listener, options);
+    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 (isDev) {
+    if (import_utils2.isDev) {
       this.__debug("$off", event, listener);
     }
-    if (isDev) {
-      this.__testEventIsDefined(event);
-    }
     this.__eventHandlers.get(event).delete(listener);
-    this.removeEventListener(event, listener, options);
+    const target = (0, import_utils.getEventTarget)(this, event, this.__config);
+    target.removeEventListener(event, listener, options);
   }
   $emit(event, ...args) {
-    if (isDev) {
+    if (import_utils2.isDev) {
       this.__debug("$emit", event, args);
     }
-    if (isDev) {
-      this.__testEventIsDefined(event);
-    }
     this.dispatchEvent(new CustomEvent(event, { detail: args }));
   }
   static $factory(nameOrSelector) {
-    if (!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());

package/Base/index.d.ts

@@ -191,14 +191,6 @@ export default class Base extends EventTarget {
      * @returns {void}
      */
     $terminate(): void;
-    /**
-     * Test if the given event is configured and warn otherwise.
-     *
-     * @private
-     * @param   {string} event The event name.
-     * @returns {void}
-     */
-    private __testEventIsDefined;
     /**
      * Add an emitted event.
      *

package/Base/index.js

@@ -1,19 +1,11 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
-import { getComponentElements } from "./utils.js";
+import { getComponentElements, getEventTarget } from "./utils.js";
 import ChildrenManager from "./managers/ChildrenManager.js";
 import RefsManager from "./managers/RefsManager.js";
 import ServicesManager from "./managers/ServicesManager.js";
 import EventsManager from "./managers/EventsManager.js";
 import OptionsManager from "./managers/OptionsManager.js";
+import { noop, isDev, isFunction, isArray } from "../utils/index.js";
 let id = 0;
-const isDev = typeof __DEV__ !== "undefined" && __DEV__;
-function noop() {
-}
 function createAndTestManagers(instance) {
   [
     {
@@ -43,43 +35,18 @@ function createAndTestManagers(instance) {
     }
   ].forEach(({ prop, constructorName, constructor }) => {
     instance[prop] = new instance.__managers[constructorName](instance);
-    if (!(instance[prop] instanceof constructor)) {
+    if (isDev && !(instance[prop] instanceof constructor)) {
       throw new Error(`The \`$managers.${constructorName}\` must extend the \`${constructorName}\` class.`);
     }
   });
 }
 class Base extends EventTarget {
-  constructor(element) {
-    super();
-    __publicField(this, "$parent", null);
-    __publicField(this, "$id");
-    __publicField(this, "$el");
-    __publicField(this, "$isMounted", false);
-    __publicField(this, "__eventHandlers", /* @__PURE__ */ new Map());
-    __publicField(this, "__services");
-    __publicField(this, "__refs");
-    __publicField(this, "__options");
-    __publicField(this, "__children");
-    __publicField(this, "__events");
-    if (!element) {
-      throw new Error("The root element must be defined.");
-    }
-    const { __config } = this;
-    if (__config.name === "Base") {
-      throw new Error("The `config.name` property is required.");
-    }
-    this.$id = `${__config.name}-${id}`;
-    id += 1;
-    this.$el = element;
-    if (!this.$el.__base__) {
-      this.$el.__base__ = /* @__PURE__ */ new WeakMap();
-    }
-    this.$el.__base__.set(this.__ctor, this);
-    createAndTestManagers(this);
-    if (isDev) {
-      this.__debug("constructor", this);
-    }
-  }
+  static $isBase = true;
+  $parent = null;
+  $id;
+  $el;
+  $isMounted = false;
+  __eventHandlers = /* @__PURE__ */ new Map();
   get $root() {
     if (!this.$parent) {
       return this;
@@ -95,7 +62,6 @@ class Base extends EventTarget {
     return root;
   }
   get __config() {
-    var _a, _b, _c;
     let proto = Object.getPrototypeOf(this);
     let { config } = proto.constructor;
     while (proto.constructor.config && proto.constructor.$isBase) {
@@ -108,23 +74,44 @@ class Base extends EventTarget {
       }
       proto = Object.getPrototypeOf(proto);
     }
-    config.options = (_a = config.options) != null ? _a : {};
-    config.refs = (_b = config.refs) != null ? _b : [];
-    config.components = (_c = config.components) != null ? _c : {};
+    config.options = config.options ?? {};
+    config.refs = config.refs ?? [];
+    config.components = config.components ?? {};
     return config;
   }
+  static config = {
+    name: "Base",
+    emits: [
+      "before-mounted",
+      "mounted",
+      "updated",
+      "destroyed",
+      "terminated",
+      "ticked",
+      "scrolled",
+      "resized",
+      "moved",
+      "loaded",
+      "keyed"
+    ]
+  };
+  __services;
   get $services() {
     return this.__services;
   }
+  __refs;
   get $refs() {
     return this.__refs;
   }
+  __options;
   get $options() {
     return this.__options;
   }
+  __children;
   get $children() {
     return this.__children;
   }
+  __events;
   get $log() {
     return this.__options.log ? window.console.log.bind(window, `[${this.__config.name}]`) : noop;
   }
@@ -145,7 +132,7 @@ class Base extends EventTarget {
       this.__debug("callMethod", method, ...args);
     }
     this.$emit(method, ...args);
-    if (typeof this[method] !== "function") {
+    if (!isFunction(this[method])) {
       return null;
     }
     if (isDev) {
@@ -157,6 +144,33 @@ class Base extends EventTarget {
     const eventHandlers = this.__eventHandlers.get(event);
     return eventHandlers && eventHandlers.size > 0;
   }
+  constructor(element) {
+    super();
+    if (!element) {
+      if (isDev) {
+        throw new Error("The root element must be defined.");
+      }
+      return;
+    }
+    const { __config } = this;
+    if (__config.name === "Base") {
+      if (isDev) {
+        throw new Error("The `config.name` property is required.");
+      }
+      return;
+    }
+    this.$id = `${__config.name}-${id}`;
+    id += 1;
+    this.$el = element;
+    if (!this.$el.__base__) {
+      this.$el.__base__ = /* @__PURE__ */ new WeakMap();
+    }
+    this.$el.__base__.set(this.__ctor, this);
+    createAndTestManagers(this);
+    if (isDev) {
+      this.__debug("constructor", this);
+    }
+  }
   $mount() {
     if (this.$isMounted) {
       return this;
@@ -210,14 +224,9 @@ class Base extends EventTarget {
     this.__callMethod("terminated");
     this.$el.__base__.set(this.__ctor, "terminated");
   }
-  __testEventIsDefined(event) {
-    if (!(Array.isArray(this.__config.emits) && this.__config.emits.includes(event))) {
-      console.warn(`[${this.__config.name}]`, `The "${event}" event is missing from the configuration.`);
-    }
-  }
   __addEmits(event) {
     const ctor = this.__ctor;
-    if (Array.isArray(ctor.config.emits)) {
+    if (isArray(ctor.config.emits)) {
       ctor.config.emits.push(event);
     } else {
       ctor.config.emits = [event];
@@ -235,16 +244,14 @@ class Base extends EventTarget {
     if (isDev) {
       this.__debug("$on", event, listener, options);
     }
-    if (isDev) {
-      this.__testEventIsDefined(event);
-    }
     let set = this.__eventHandlers.get(event);
     if (!set) {
       set = /* @__PURE__ */ new Set();
       this.__eventHandlers.set(event, set);
     }
     set.add(listener);
-    this.addEventListener(event, listener, options);
+    const target = getEventTarget(this, event, this.__config);
+    target.addEventListener(event, listener, options);
     return () => {
       this.$off(event, listener, options);
     };
@@ -253,45 +260,23 @@ class Base extends EventTarget {
     if (isDev) {
       this.__debug("$off", event, listener);
     }
-    if (isDev) {
-      this.__testEventIsDefined(event);
-    }
     this.__eventHandlers.get(event).delete(listener);
-    this.removeEventListener(event, listener, options);
+    const target = getEventTarget(this, event, this.__config);
+    target.removeEventListener(event, listener, options);
   }
   $emit(event, ...args) {
     if (isDev) {
       this.__debug("$emit", event, args);
     }
-    if (isDev) {
-      this.__testEventIsDefined(event);
-    }
     this.dispatchEvent(new CustomEvent(event, { detail: args }));
   }
   static $factory(nameOrSelector) {
-    if (!nameOrSelector) {
+    if (isDev && !nameOrSelector) {
       throw new Error("The $factory method requires a component\u2019s name or selector to be specified.");
     }
     return getComponentElements(nameOrSelector).map((el) => new this(el).$mount());
   }
 }
-__publicField(Base, "$isBase", true);
-__publicField(Base, "config", {
-  name: "Base",
-  emits: [
-    "before-mounted",
-    "mounted",
-    "updated",
-    "destroyed",
-    "terminated",
-    "ticked",
-    "scrolled",
-    "resized",
-    "moved",
-    "loaded",
-    "keyed"
-  ]
-});
 export {
   Base as default
 };

package/Base/managers/AbstractManager.cjs

@@ -2,7 +2,6 @@ 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 });
@@ -16,10 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   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/managers/AbstractManager.js
 var AbstractManager_exports = {};
@@ -28,11 +23,7 @@ __export(AbstractManager_exports, {
 });
 module.exports = __toCommonJS(AbstractManager_exports);
 var AbstractManager = class {
-  constructor(base) {
-    __publicField(this, "__base");
-    this.__base = base;
-    this.__hideProperties(["__base"]);
-  }
+  __base;
   get __element() {
     return this.__base.$el;
   }
@@ -42,6 +33,10 @@ var AbstractManager = class {
   get __eventsManager() {
     return this.__base.__events;
   }
+  constructor(base) {
+    this.__base = base;
+    this.__hideProperties(["__base"]);
+  }
   __hideProperties(properties) {
     Object.defineProperties(this, Object.fromEntries(properties.map((property) => [
       property,

package/Base/managers/AbstractManager.js

@@ -1,15 +1,5 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
 class AbstractManager {
-  constructor(base) {
-    __publicField(this, "__base");
-    this.__base = base;
-    this.__hideProperties(["__base"]);
-  }
+  __base;
   get __element() {
     return this.__base.$el;
   }
@@ -19,6 +9,10 @@ class AbstractManager {
   get __eventsManager() {
     return this.__base.__events;
   }
+  constructor(base) {
+    this.__base = base;
+    this.__hideProperties(["__base"]);
+  }
   __hideProperties(properties) {
     Object.defineProperties(this, Object.fromEntries(properties.map((property) => [
       property,

package/Base/managers/ChildrenManager.cjs

@@ -4,7 +4,6 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 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 });
@@ -19,10 +18,6 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
 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/managers/ChildrenManager.js
 var ChildrenManager_exports = {};
@@ -55,8 +50,7 @@ function __getChild(that, el, ComponentClass, name) {
     });
   }
   return promise.then((module2) => {
-    var _a;
-    const ctor = (_a = module2.default) != null ? _a : module2;
+    const ctor = module2.default ?? module2;
     that.__asyncComponentPromises.set(ComponentClass, {
       promise,
       status: "resolved",
@@ -102,10 +96,7 @@ function __triggerHookForAll(that, hook) {
   });
 }
 var ChildrenManager = class extends import_AbstractManager.default {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "__asyncComponentPromises", /* @__PURE__ */ new WeakMap());
-  }
+  __asyncComponentPromises = /* @__PURE__ */ new WeakMap();
   get registeredNames() {
     return Object.keys(this).filter((key) => !key.startsWith("__"));
   }

package/Base/managers/ChildrenManager.js

@@ -1,9 +1,3 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
 import AbstractManager from "./AbstractManager.js";
 import { getComponentElements } from "../utils.js";
 function __getChild(that, el, ComponentClass, name) {
@@ -29,8 +23,7 @@ function __getChild(that, el, ComponentClass, name) {
     });
   }
   return promise.then((module) => {
-    var _a;
-    const ctor = (_a = module.default) != null ? _a : module;
+    const ctor = module.default ?? module;
     that.__asyncComponentPromises.set(ComponentClass, {
       promise,
       status: "resolved",
@@ -76,10 +69,7 @@ function __triggerHookForAll(that, hook) {
   });
 }
 class ChildrenManager extends AbstractManager {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "__asyncComponentPromises", /* @__PURE__ */ new WeakMap());
-  }
+  __asyncComponentPromises = /* @__PURE__ */ new WeakMap();
   get registeredNames() {
     return Object.keys(this).filter((key) => !key.startsWith("__"));
   }