@vicin/sigil 3.3.0 → 4.0.0

package/dist/index.global.js

@@ -1,72 +1,68 @@
 (function (exports) {
   'use strict';
 
+  // src/symbols.ts
+  var __SIGIL__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__SIGIL__");
+  var __SIGIL_LINEAGE__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__SIGIL_LINEAGE__");
+  var __LABEL__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__LABEL__");
+  var __DEPTH__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__DEPTH__");
+
+  // src/is.ts
+  function isSigilCtor(ctor) {
+    return typeof ctor === "function" && ctor.prototype && __SIGIL__ in ctor.prototype;
+  }
+  function isSigilInstance(inst) {
+    return !!inst && typeof inst === "object" && __SIGIL__ in inst;
+  }
+
   // src/options.ts
   var OPTIONS = {
-    labelValidation: null,
-    autofillLabels: true,
-    skipLabelUniquenessCheck: false
+    labelValidation: null
   };
-  var updateSigilOptions = (opts) => {
-    if ("autofillLabels" in opts) {
-      if (typeof opts.autofillLabels !== "boolean")
-        throw new Error("'updateSigilOptions.autofillLabels' must be boolean");
-      OPTIONS.autofillLabels = opts.autofillLabels;
-    }
-    if ("labelValidation" in opts) {
-      const val = opts.labelValidation;
-      if (val !== null && typeof val !== "function" && !(val instanceof RegExp))
-        throw new Error("'updateSigilOptions.labelValidation' must be null, function or RegExp");
-      OPTIONS.labelValidation = val;
-    }
-    if ("skipLabelUniquenessCheck" in opts) {
-      if (typeof opts.skipLabelUniquenessCheck !== "boolean")
-        throw new Error("'updateSigilOptions.skipLabelUniquenessCheck' must be boolean");
-      OPTIONS.skipLabelUniquenessCheck = opts.skipLabelUniquenessCheck;
-    }
+  var updateSigilOptions = ({ labelValidation = null } = {}) => {
+    OPTIONS.labelValidation = labelValidation;
   };
   var RECOMMENDED_LABEL_REGEX = /^@[\w-]+(?:\/[\w-]+)*\.[A-Z][A-Za-z0-9]*$/;
-  var DEFAULT_LABEL_REGEX = RECOMMENDED_LABEL_REGEX;
-
-  // src/symbols.ts
-  var __SIGIL__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__SIGIL__");
-  var __LABEL__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__LABEL__");
-  var __EFFECTIVE_LABEL__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__EFFECTIVE_LABEL__");
-  var __LINEAGE__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__LINEAGE__");
 
-  // src/helpers.ts
-  var AUTO_LABEL_PREFEX = "@Sigil-auto";
-  var handledCtors = /* @__PURE__ */ new WeakSet();
-  function handleSigil(ctor, label, opts) {
-    if (handledCtors.has(ctor)) return;
-    verifyLabel(ctor, label, opts);
-    handleAncestors(ctor, opts);
-    sigilify(ctor, label != null ? label : generateRandomLabel(ctor));
+  // src/sigilify.ts
+  var resolved = /* @__PURE__ */ new WeakSet();
+  var hasOwnSigilRegistry = /* @__PURE__ */ new WeakSet();
+  function sigilify(ctor, label, opts) {
+    if (resolved.has(ctor))
+      throw new Error(
+        `[Sigil Error] Class '${ctor.name}' with label '${ctor.SigilLabel}' is already sigilified`
+      );
+    verifyLabel(label, opts);
+    handleAncestors(ctor);
+    updateSigil(ctor, label);
+    resolved.add(ctor);
+    hasOwnSigilRegistry.add(ctor);
+  }
+  function hasOwnSigil(ctor) {
+    return hasOwnSigilRegistry.has(ctor);
   }
-  function handleAncestors(ctor, opts) {
+  function verifyLabel(label, opts) {
     var _a;
-    const ancestors = [];
+    const labelValidation = (_a = opts == null ? void 0 : opts.labelValidation) != null ? _a : OPTIONS.labelValidation;
+    if (labelValidation) {
+      let valid;
+      if (labelValidation instanceof RegExp) valid = labelValidation.test(label);
+      else valid = labelValidation(label);
+      if (!valid)
+        throw new Error(
+          `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`
+        );
+    }
+  }
+  function handleAncestors(ctor) {
     let a = Object.getPrototypeOf(ctor);
     while (a && typeof a === "function" && a.prototype[__SIGIL__]) {
-      ancestors.unshift(a);
+      resolved.add(a);
       a = Object.getPrototypeOf(a);
     }
-    const labelOwner = /* @__PURE__ */ new Map();
-    const autofillLabels = (_a = opts == null ? void 0 : opts.autofillLabels) != null ? _a : OPTIONS.autofillLabels;
-    for (const a2 of ancestors) {
-      const l = a2.prototype[__LABEL__];
-      if (labelOwner.has(l)) {
-        if (!autofillLabels)
-          throw new Error(
-            `[Sigil Error] Class '${a2.name}' is not sigilified, Make sure to sigilify all Sigil classes or set 'autofillLabels' to 'true'`
-          );
-        sigilify(a2, generateRandomLabel(a2));
-      }
-      labelOwner.set(labelOf(a2), a2.name);
-    }
   }
-  function sigilify(ctor, label) {
-    var _a;
+  function updateSigil(ctor, label) {
+    var _a, _b, _c;
     const sym = Symbol.for(label);
     Object.defineProperty(ctor.prototype, __SIGIL__, {
       value: sym,
@@ -74,156 +70,57 @@
       enumerable: false,
       writable: false
     });
-    Object.defineProperty(ctor.prototype, sym, {
-      value: true,
+    Object.defineProperty(ctor.prototype, __LABEL__, {
+      value: label,
       configurable: false,
       enumerable: false,
       writable: false
     });
-    Object.defineProperty(ctor.prototype, __LABEL__, {
-      value: label,
+    Object.defineProperty(ctor.prototype, __SIGIL_LINEAGE__, {
+      value: [...(_b = (_a = Object.getPrototypeOf(ctor)) == null ? void 0 : _a.prototype[__SIGIL_LINEAGE__]) != null ? _b : [], sym],
       configurable: false,
       enumerable: false,
       writable: false
     });
-    if (!label.startsWith(AUTO_LABEL_PREFEX))
-      Object.defineProperty(ctor.prototype, __EFFECTIVE_LABEL__, {
-        value: label,
-        configurable: false,
-        enumerable: false,
-        writable: false
-      });
-    Object.defineProperty(ctor.prototype, __LINEAGE__, {
-      value: /* @__PURE__ */ new Set(["Sigil", ...(_a = lineageOf(ctor)) != null ? _a : [], label]),
+    Object.defineProperty(ctor.prototype, __DEPTH__, {
+      value: ((_c = ctor.prototype[__DEPTH__]) != null ? _c : -1) + 1,
       configurable: false,
       enumerable: false,
       writable: false
     });
-    const sigilSym = /* @__PURE__ */ Symbol.for("Sigil");
-    if (ctor.prototype[sigilSym] !== true)
-      Object.defineProperty(ctor.prototype, sigilSym, {
-        value: true,
-        configurable: false,
-        enumerable: false,
-        writable: false
-      });
-    handledCtors.add(ctor);
-  }
-  function isSigilCtor(ctor) {
-    return typeof ctor === "function" && ctor.prototype && __SIGIL__ in ctor.prototype;
-  }
-  function isSigilInstance(inst) {
-    return !!inst && typeof inst === "object" && __SIGIL__ in inst;
-  }
-  function hasOwnSigil(ctor) {
-    return typeof ctor === "function" && Object.hasOwn(ctor.prototype, __SIGIL__);
-  }
-  function labelOf(ctor) {
-    return ctor.prototype[__LABEL__];
-  }
-  function lineageOf(ctor) {
-    return ctor.prototype[__LINEAGE__];
-  }
-  function getSigilLabels() {
-    return getLabelRegistry().labels();
-  }
-  function getLabelRegistry() {
-    if ("__labelRegistry__" in globalThis) return globalThis.__labelRegistry__;
-    const labelSet = /* @__PURE__ */ new Set();
-    let count = 0;
-    const labelRegistry = {
-      has: (label) => labelSet.has(label),
-      add: (label) => labelSet.add(label),
-      labels: () => [...labelSet],
-      enc: () => ++count
-    };
-    Object.freeze(labelRegistry);
-    Object.defineProperty(globalThis, "__labelRegistry__", {
-      value: labelRegistry,
-      writable: false,
+    Object.defineProperty(ctor.prototype, sym, {
+      value: true,
       configurable: false,
-      enumerable: false
+      enumerable: false,
+      writable: false
     });
-    return labelRegistry;
-  }
-  function verifyLabel(ctor, label, opts) {
-    var _a, _b, _c;
-    const reg = getLabelRegistry();
-    if (!label) {
-      if (!((_a = opts == null ? void 0 : opts.autofillLabels) != null ? _a : OPTIONS.autofillLabels))
-        throw new Error(
-          `[Sigil Error] Class '${ctor == null ? void 0 : ctor.name}' is not sigilified, Make sure to sigilify all Sigil classes or set 'autofillLabels' to 'true'`
-        );
-      return;
-    }
-    if (label.startsWith(AUTO_LABEL_PREFEX))
-      throw new Error(`'${AUTO_LABEL_PREFEX}' is a prefex reserved by the library`);
-    if (!((_b = opts == null ? void 0 : opts.skipLabelUniquenessCheck) != null ? _b : OPTIONS.skipLabelUniquenessCheck) && reg.has(label))
-      throw new Error(
-        `[Sigil Error] Passed label '${label}' to class '${ctor == null ? void 0 : ctor.name}' is re-used, passed labels must be unique`
-      );
-    const labelValidation = (_c = opts == null ? void 0 : opts.labelValidation) != null ? _c : OPTIONS.labelValidation;
-    if (labelValidation) {
-      let valid;
-      if (labelValidation instanceof RegExp) valid = labelValidation.test(label);
-      else valid = labelValidation(label);
-      if (!valid)
-        throw new Error(
-          `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`
-        );
-    }
-    reg.add(label);
-  }
-  function generateRandomLabel(ctor) {
-    return `${AUTO_LABEL_PREFEX}:${ctor == null ? void 0 : ctor.name}:${getLabelRegistry().enc()}:${Math.random().toString(36).slice(2, 10)}`;
   }
 
   // src/mixin.ts
-  function Sigilify(Base, label, opts) {
-    if (hasOwnSigil(Base))
-      throw new Error(
-        `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`
-      );
-    class Sigilified extends Base {
+  function BaseSigilify(Base) {
+    class Sigil2 extends Base {
       /**
        * Class-level identity label constant for this sigil constructor.
        */
       static get SigilLabel() {
-        handleSigil(this);
         return this.prototype[__LABEL__];
       }
       /**
-       * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
-       */
-      static get SigilEffectiveLabel() {
-        handleSigil(this);
-        return this.prototype[__EFFECTIVE_LABEL__];
-      }
-      /**
-       * Linearized sigil type label chain for the current constructor.
+       * Copy of the sigil label lineage for this instance's constructor.
        *
-       * Useful for debugging and performing strict lineage comparisons.
+       * Useful for debugging and logging.
        *
-       * @returns An array of labels representing parent → child type labels.
+       * @returns An array of sigil labels representing parent → child labels.
        */
       static get SigilLabelLineage() {
-        handleSigil(this);
-        return [...this.prototype[__LINEAGE__]];
+        return this.prototype[__SIGIL_LINEAGE__].map((v) => v.description);
       }
-      /**
-       * Sigil type label set for the current constructor.
-       * Useful for debugging.
-       *
-       * @returns A Readonly Set of labels that represent the type lineage.
-       */
-      static get SigilLabelSet() {
-        handleSigil(this);
-        return this.prototype[__LINEAGE__];
+      /** Check if sigil label has been attached to this class */
+      static get hasOwnSigil() {
+        return hasOwnSigil(this);
       }
       constructor(...args) {
         super(...args);
-        const ctor = new.target;
-        handleSigil(ctor);
       }
       /**
        * Check whether `other` is (or inherits from) the instance represented by the
@@ -237,8 +134,7 @@
        * @param other - The object to test.
        * @returns A type guard asserting `other` is an instance of the constructor.
        */
-      static isOfType(other) {
-        handleSigil(this);
+      static isInstance(other) {
         if (other == null || typeof other !== "object") return false;
         return other[this.prototype[__SIGIL__]] === true;
       }
@@ -251,12 +147,9 @@
        * @param other - The object to test.
        * @returns A type guard asserting `other` is an instance of the constructor.
        */
-      static isExactType(other) {
-        var _a, _b;
-        handleSigil(this);
+      static isExactInstance(other) {
         if (other == null || typeof other !== "object") return false;
-        if (((_a = this.prototype) == null ? void 0 : _a[__LINEAGE__].size) !== ((_b = other[__LINEAGE__]) == null ? void 0 : _b.size))
-          return false;
+        if (this.prototype[__DEPTH__] !== other[__DEPTH__]) return false;
         return other[this.prototype[__SIGIL__]] === true;
       }
       /**
@@ -271,7 +164,7 @@
        * @param other - The object to test.
        * @returns A type guard asserting `other` is an instance of the constructor.
        */
-      isOfType(other) {
+      isInstance(other) {
         if (other == null || typeof other !== "object") return false;
         return other[this[__SIGIL__]] === true;
       }
@@ -284,10 +177,9 @@
        * @param other - The object to test.
        * @returns A type guard asserting `other` is an instance of the constructor.
        */
-      isExactType(other) {
-        var _a;
+      isExactInstance(other) {
         if (other == null || typeof other !== "object") return false;
-        if (this[__LINEAGE__].size !== ((_a = other[__LINEAGE__]) == null ? void 0 : _a.size)) return false;
+        if (this[__DEPTH__] !== other[__DEPTH__]) return false;
         return other[this[__SIGIL__]] === true;
       }
       /**
@@ -295,231 +187,85 @@
        *
        * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').
        */
-      getSigilLabel() {
+      get SigilLabel() {
         return this[__LABEL__];
       }
       /**
-       * Returns the human-readable sigil label of this instance's constructor.
+       * Copy of the sigil label lineage for this instance's constructor.
        *
-       * @returns The last passed label string (e.g. '@scope/pkg.ClassName').
-       */
-      getSigilEffectiveLabel() {
-        return this[__EFFECTIVE_LABEL__];
-      }
-      /**
-       * Returns a copy of the sigil type label lineage for this instance's constructor.
+       * Useful for debugging and logging.
        *
-       * @returns readonly array of labels representing the type lineage.
+       * @returns An array of sigil labels representing parent → child labels.
        */
-      getSigilLabelLineage() {
-        return [...this[__LINEAGE__]];
+      get SigilLabelLineage() {
+        return this[__SIGIL_LINEAGE__].map((v) => v.description);
       }
-      /**
-       * Returns a copy of the sigil type label lineage set for this instance's constructor.
-       *
-       * @returns readonly array of labels representing the type lineage.
-       */
-      getSigilLabelSet() {
-        return this[__LINEAGE__];
+      /** Check if sigil label has been attached to this class */
+      get hasOwnSigil() {
+        return this.constructor.hasOwnSigil;
       }
     }
-    handleSigil(Sigilified, label, opts);
+    sigilify(Sigil2, "Sigil");
+    return Sigil2;
+  }
+  function Sigilify(Base, label, opts) {
+    if (isSigilCtor(Base))
+      throw new Error(
+        `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`
+      );
+    const BaseSigil = BaseSigilify(Base);
+    class Sigilified extends BaseSigil {
+    }
+    sigilify(Sigilified, label, opts);
     return Sigilified;
   }
   function SigilifyAbstract(Base, label, opts) {
-    if (hasOwnSigil(Base))
+    if (isSigilCtor(Base))
       throw new Error(
         `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`
       );
-    class Sigilified extends Base {
-      /**
-       * Class-level identity label constant for this sigil constructor.
-       */
-      static get SigilLabel() {
-        handleSigil(this);
-        return this.prototype[__LABEL__];
-      }
-      /**
-       * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
-       */
-      static get SigilEffectiveLabel() {
-        handleSigil(this);
-        return this.prototype[__EFFECTIVE_LABEL__];
-      }
-      /**
-       * Linearized sigil type label chain for the current constructor.
-       *
-       * Useful for debugging and performing strict lineage comparisons.
-       *
-       * @returns An array of labels representing parent → child type labels.
-       */
-      static get SigilLabelLineage() {
-        handleSigil(this);
-        return [...this.prototype[__LINEAGE__]];
-      }
-      /**
-       * Sigil type label set for the current constructor.
-       * Useful for debugging.
-       *
-       * @returns A Readonly Set of labels that represent the type lineage.
-       */
-      static get SigilLabelSet() {
-        handleSigil(this);
-        return this.prototype[__LINEAGE__];
-      }
-      constructor(...args) {
-        super(...args);
-        const ctor = new.target;
-        handleSigil(ctor);
-      }
-      /**
-       * Check whether `other` is (or inherits from) the instance represented by the
-       * calling constructor.
-       *
-       * This replaces `instanceof` so that checks remain valid across bundles/realms
-       * and when subclassing.
-       *
-       * @typeParam T - The specific sigil constructor (`this`).
-       * @param this - The constructor performing the type check.
-       * @param other - The object to test.
-       * @returns A type guard asserting `other` is an instance of the constructor.
-       */
-      static isOfType(other) {
-        handleSigil(this);
-        if (other == null || typeof other !== "object") return false;
-        return other[this.prototype[__SIGIL__]] === true;
-      }
-      /**
-       * Check whether `other` is exactly the same instance represented by the
-       * calling constructor.
-       *
-       * @typeParam T - The specific sigil constructor (`this`).
-       * @param this - The constructor performing the type check.
-       * @param other - The object to test.
-       * @returns A type guard asserting `other` is an instance of the constructor.
-       */
-      static isExactType(other) {
-        var _a, _b;
-        handleSigil(this);
-        if (other == null || typeof other !== "object") return false;
-        if (((_a = this.prototype) == null ? void 0 : _a[__LINEAGE__].size) !== ((_b = other[__LINEAGE__]) == null ? void 0 : _b.size))
-          return false;
-        return other[this.prototype[__SIGIL__]] === true;
-      }
-      /**
-       * Check whether `other` is (or inherits from) the instance represented by the
-       * calling constructor.
-       *
-       * This replaces `instanceof` so that checks remain valid across bundles/realms
-       * and when subclassing.
-       *
-       * @typeParam T - The specific sigil constructor (`this`).
-       * @param this - The constructor performing the type check.
-       * @param other - The object to test.
-       * @returns A type guard asserting `other` is an instance of the constructor.
-       */
-      isOfType(other) {
-        if (other == null || typeof other !== "object") return false;
-        return other[this[__SIGIL__]] === true;
-      }
-      /**
-       * Check whether `other` is exactly the same instance represented by the
-       * calling constructor.
-       *
-       * @typeParam T - The specific sigil constructor (`this`).
-       * @param this - The constructor performing the type check.
-       * @param other - The object to test.
-       * @returns A type guard asserting `other` is an instance of the constructor.
-       */
-      isExactType(other) {
-        var _a;
-        if (other == null || typeof other !== "object") return false;
-        if (this[__LINEAGE__].size !== ((_a = other[__LINEAGE__]) == null ? void 0 : _a.size)) return false;
-        return other[this[__SIGIL__]] === true;
-      }
-      /**
-       * Returns the identity sigil label of this instance's constructor.
-       *
-       * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').
-       */
-      getSigilLabel() {
-        return this[__LABEL__];
-      }
-      /**
-       * Returns the human-readable sigil label of this instance's constructor.
-       *
-       * @returns The last passed label string (e.g. '@scope/pkg.ClassName').
-       */
-      getSigilEffectiveLabel() {
-        return this[__EFFECTIVE_LABEL__];
-      }
-      /**
-       * Returns a copy of the sigil type label lineage for this instance's constructor.
-       *
-       * @returns readonly array of labels representing the type lineage.
-       */
-      getSigilLabelLineage() {
-        return [...this[__LINEAGE__]];
-      }
-      /**
-       * Returns a copy of the sigil type label lineage set for this instance's constructor.
-       *
-       * @returns readonly array of labels representing the type lineage.
-       */
-      getSigilLabelSet() {
-        return this[__LINEAGE__];
-      }
+    const BaseSigil = BaseSigilify(Base);
+    class Sigilified extends BaseSigil {
     }
-    handleSigil(Sigilified, label, opts);
+    sigilify(Sigilified, label, opts);
     return Sigilified;
   }
 
   // src/classes.ts
-  var Sigil = Sigilify(class {
-  }, "Sigil");
+  var Sigil = BaseSigilify(class {
+  });
   var SigilError = Sigilify(Error, "SigilError");
 
-  // src/decorator.ts
-  function WithSigil(label, opts) {
-    return function(value, context) {
-      if (!isSigilCtor(value))
-        throw new Error(
-          `[Sigil Error] 'WithSigil' decorator accept only Sigil classes but used on class '${value.name}'`
-        );
-      if (hasOwnSigil(value))
+  // src/attach.ts
+  function AttachSigil(label, opts) {
+    return function(target, ctx) {
+      if (!isSigilCtor(target))
         throw new Error(
-          `[Sigil Error] Class '${value.name}' with label '${value.SigilLabel}' is already sigilified`
+          `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${target.name}'`
         );
-      handleSigil(value, label, opts);
+      sigilify(target, label, opts);
     };
   }
-
-  // src/hof.ts
-  function withSigil(Class, label, opts) {
+  function attachSigil(Class, label, opts) {
     if (!isSigilCtor(Class))
       throw new Error(
-        `[Sigil Error] 'withSigil' HOF accept only Sigil classes but used on class '${Class.name}'`
-      );
-    if (hasOwnSigil(Class))
-      throw new Error(
-        `[Sigil Error] Class '${Class.name}' with label '${Class.SigilLabel}' is already sigilified`
+        `[Sigil Error] 'attachSigil' function accept only Sigil classes but used on class '${Class.name}'`
       );
-    handleSigil(Class, label, opts);
+    sigilify(Class, label, opts);
     return Class;
   }
 
-  exports.DEFAULT_LABEL_REGEX = DEFAULT_LABEL_REGEX;
+  exports.AttachSigil = AttachSigil;
   exports.RECOMMENDED_LABEL_REGEX = RECOMMENDED_LABEL_REGEX;
   exports.Sigil = Sigil;
   exports.SigilError = SigilError;
   exports.Sigilify = Sigilify;
   exports.SigilifyAbstract = SigilifyAbstract;
-  exports.WithSigil = WithSigil;
-  exports.getSigilLabels = getSigilLabels;
+  exports.attachSigil = attachSigil;
+  exports.hasOwnSigil = hasOwnSigil;
   exports.isSigilCtor = isSigilCtor;
   exports.isSigilInstance = isSigilInstance;
   exports.updateSigilOptions = updateSigilOptions;
-  exports.withSigil = withSigil;
 
   return exports;