@vicin/sigil 3.2.1 → 3.4.0

package/dist/index.global.js

@@ -4,7 +4,8 @@
   // src/options.ts
   var OPTIONS = {
     labelValidation: null,
-    autofillLabels: true
+    autofillLabels: true,
+    skipLabelUniquenessCheck: false
   };
   var updateSigilOptions = (opts) => {
     if ("autofillLabels" in opts) {
@@ -16,7 +17,12 @@
       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 != null ? val : null;
+      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 RECOMMENDED_LABEL_REGEX = /^@[\w-]+(?:\/[\w-]+)*\.[A-Z][A-Za-z0-9]*$/;
@@ -26,20 +32,32 @@
   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__");
+  var __DEPTH__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__DEPTH__");
 
   // src/helpers.ts
   var AUTO_LABEL_PREFEX = "@Sigil-auto";
   var handledCtors = /* @__PURE__ */ new WeakSet();
-  function handleSigil(ctor, label, opts) {
-    if (handledCtors.has(ctor)) return;
+  var handledCtorsExplicit = /* @__PURE__ */ new WeakSet();
+  function handleSigilExplicit(ctor, label, opts) {
+    if (handledCtorsExplicit.has(ctor))
+      throw new Error(
+        `[Sigil Error] Class '${ctor.name}' with label '${ctor.SigilLabel}' is already sigilified`
+      );
     verifyLabel(ctor, label, opts);
     handleAncestors(ctor, opts);
-    sigilify(ctor, label != null ? label : generateRandomLabel(ctor));
+    sigilify(ctor, label, true);
+  }
+  function handleSigilLazy(ctor) {
+    if (handledCtors.has(ctor)) return;
+    if (!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'`
+      );
+    handleAncestors(ctor);
+    sigilify(ctor, generateRandomLabel(ctor), false);
   }
   function handleAncestors(ctor, opts) {
     var _a;
-    const autofillLabels = (_a = opts == null ? void 0 : opts.autofillLabels) != null ? _a : OPTIONS.autofillLabels;
     const ancestors = [];
     let a = Object.getPrototypeOf(ctor);
     while (a && typeof a === "function" && a.prototype[__SIGIL__]) {
@@ -47,6 +65,7 @@
       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)) {
@@ -54,55 +73,48 @@
           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));
+        sigilify(a2, generateRandomLabel(a2), false);
       }
-      labelOwner.set(labelOf(a2), a2.name);
+      labelOwner.set(a2.prototype[__LABEL__], a2.name);
     }
   }
-  function sigilify(ctor, label) {
+  function sigilify(ctor, label, explicit) {
     var _a;
     const sym = Symbol.for(label);
     Object.defineProperty(ctor.prototype, __SIGIL__, {
       value: sym,
-      configurable: false,
-      enumerable: false,
-      writable: false
-    });
-    Object.defineProperty(ctor.prototype, sym, {
-      value: true,
-      configurable: false,
+      configurable: !explicit,
       enumerable: false,
       writable: false
     });
     Object.defineProperty(ctor.prototype, __LABEL__, {
       value: label,
-      configurable: false,
+      configurable: !explicit,
       enumerable: false,
       writable: false
     });
-    if (!label.startsWith(AUTO_LABEL_PREFEX))
+    if (explicit)
       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]),
-      configurable: false,
-      enumerable: false,
-      writable: false
-    });
-    const sigilSym = /* @__PURE__ */ Symbol.for("Sigil");
-    if (ctor.prototype[sigilSym] !== true)
-      Object.defineProperty(ctor.prototype, sigilSym, {
-        value: true,
+    if (!handledCtors.has(ctor))
+      Object.defineProperty(ctor.prototype, __DEPTH__, {
+        value: ((_a = ctor.prototype[__DEPTH__]) != null ? _a : -1) + 1,
         configurable: false,
         enumerable: false,
         writable: false
       });
-    getLabelRegistry().add(label);
+    Object.defineProperty(ctor.prototype, sym, {
+      value: true,
+      configurable: false,
+      enumerable: false,
+      writable: false
+    });
     handledCtors.add(ctor);
+    if (explicit) handledCtorsExplicit.add(ctor);
   }
   function isSigilCtor(ctor) {
     return typeof ctor === "function" && ctor.prototype && __SIGIL__ in ctor.prototype;
@@ -110,19 +122,8 @@
   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(includeAuto = false) {
-    const labels = getLabelRegistry().labels();
-    if (includeAuto) return labels;
-    return labels.filter((l) => !l.startsWith(AUTO_LABEL_PREFEX));
+  function getSigilLabels() {
+    return getLabelRegistry().labels();
   }
   function getLabelRegistry() {
     if ("__labelRegistry__" in globalThis) return globalThis.__labelRegistry__;
@@ -145,21 +146,14 @@
   }
   function verifyLabel(ctor, label, opts) {
     var _a, _b;
-    const labelValidation = (_a = opts == null ? void 0 : opts.labelValidation) != null ? _a : OPTIONS.labelValidation;
-    const autofillLabels = (_b = opts == null ? void 0 : opts.autofillLabels) != null ? _b : OPTIONS.autofillLabels;
-    if (!label) {
-      if (!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;
-    }
+    const reg = getLabelRegistry();
     if (label.startsWith(AUTO_LABEL_PREFEX))
       throw new Error(`'${AUTO_LABEL_PREFEX}' is a prefex reserved by the library`);
-    if (getLabelRegistry().has(label))
+    if (!((_a = opts == null ? void 0 : opts.skipLabelUniquenessCheck) != null ? _a : 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 = (_b = opts == null ? void 0 : opts.labelValidation) != null ? _b : OPTIONS.labelValidation;
     if (labelValidation) {
       let valid;
       if (labelValidation instanceof RegExp) valid = labelValidation.test(label);
@@ -169,30 +163,27 @@
           `[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);
+        handleSigilLazy(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);
+        handleSigilLazy(this);
         return this.prototype[__EFFECTIVE_LABEL__];
       }
       /**
@@ -203,23 +194,29 @@
        * @returns An array of labels representing parent → child type labels.
        */
       static get SigilLabelLineage() {
-        handleSigil(this);
-        return [...this.prototype[__LINEAGE__]];
+        handleSigilLazy(this);
+        const lineage = [];
+        let c = this;
+        while (c && typeof c === "function" && c.prototype[__SIGIL__]) {
+          lineage.unshift(c.SigilLabel);
+          c = Object.getPrototypeOf(c);
+        }
+        return lineage;
       }
       /**
        * Sigil type label set for the current constructor.
        * Useful for debugging.
        *
+       * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
        * @returns A Readonly Set of labels that represent the type lineage.
        */
       static get SigilLabelSet() {
-        handleSigil(this);
-        return this.prototype[__LINEAGE__];
+        return new Set(this.SigilLabelLineage);
       }
       constructor(...args) {
         super(...args);
         const ctor = new.target;
-        handleSigil(ctor);
+        handleSigilLazy(ctor);
       }
       /**
        * Check whether `other` is (or inherits from) the instance represented by the
@@ -234,7 +231,7 @@
        * @returns A type guard asserting `other` is an instance of the constructor.
        */
       static isOfType(other) {
-        handleSigil(this);
+        handleSigilLazy(this);
         if (other == null || typeof other !== "object") return false;
         return other[this.prototype[__SIGIL__]] === true;
       }
@@ -248,11 +245,9 @@
        * @returns A type guard asserting `other` is an instance of the constructor.
        */
       static isExactType(other) {
-        var _a, _b;
-        handleSigil(this);
+        handleSigilLazy(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;
+        if (this.prototype[__DEPTH__] !== other[__DEPTH__]) return false;
         return other[this.prototype[__SIGIL__]] === true;
       }
       /**
@@ -281,9 +276,8 @@
        * @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;
+        if (this[__DEPTH__] !== other[__DEPTH__]) return false;
         return other[this[__SIGIL__]] === true;
       }
       /**
@@ -308,202 +302,77 @@
        * @returns readonly array of labels representing the type lineage.
        */
       getSigilLabelLineage() {
-        return [...this[__LINEAGE__]];
+        const lineage = [];
+        let proto = Object.getPrototypeOf(this);
+        while (proto && proto[__SIGIL__]) {
+          lineage.unshift(proto[__LABEL__]);
+          proto = Object.getPrototypeOf(proto);
+        }
+        return lineage;
       }
       /**
        * Returns a copy of the sigil type label lineage set for this instance's constructor.
        *
+       * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
        * @returns readonly array of labels representing the type lineage.
        */
       getSigilLabelSet() {
-        return this[__LINEAGE__];
+        return new Set(this.getSigilLabelLineage());
       }
     }
-    handleSigil(Sigilified, label, opts);
+    handleSigilExplicit(Sigil2, "Sigil", { skipLabelUniquenessCheck: true });
+    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 {
+    }
+    handleSigilExplicit(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);
+    handleSigilExplicit(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) {
+  // src/attach.ts
+  function AttachSigil(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}'`
+          `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${value.name}'`
         );
-      if (hasOwnSigil(value))
-        throw new Error(
-          `[Sigil Error] Class '${value.name}' with label '${value.SigilLabel}' is already sigilified`
-        );
-      handleSigil(value, label, opts);
+      handleSigilExplicit(value, label, opts);
     };
   }
-
-  // src/hof.ts
-  function withSigil(Class, label, opts) {
+  var WithSigil = AttachSigil;
+  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);
+    handleSigilExplicit(Class, label, opts);
     return Class;
   }
+  var withSigil = attachSigil;
 
+  exports.AttachSigil = AttachSigil;
   exports.DEFAULT_LABEL_REGEX = DEFAULT_LABEL_REGEX;
   exports.RECOMMENDED_LABEL_REGEX = RECOMMENDED_LABEL_REGEX;
   exports.Sigil = Sigil;
@@ -511,6 +380,7 @@
   exports.Sigilify = Sigilify;
   exports.SigilifyAbstract = SigilifyAbstract;
   exports.WithSigil = WithSigil;
+  exports.attachSigil = attachSigil;
   exports.getSigilLabels = getSigilLabels;
   exports.isSigilCtor = isSigilCtor;
   exports.isSigilInstance = isSigilInstance;