@vicin/sigil 3.2.1 → 3.4.0

package/dist/index.js

@@ -3,7 +3,8 @@
 // src/options.ts
 var OPTIONS = {
   labelValidation: null,
-  autofillLabels: true
+  autofillLabels: true,
+  skipLabelUniquenessCheck: false
 };
 var updateSigilOptions = (opts) => {
   if ("autofillLabels" in opts) {
@@ -15,7 +16,12 @@ var updateSigilOptions = (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 != 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]*$/;
@@ -25,20 +31,32 @@ var DEFAULT_LABEL_REGEX = RECOMMENDED_LABEL_REGEX;
 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__]) {
@@ -46,6 +64,7 @@ function handleAncestors(ctor, opts) {
     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)) {
@@ -53,55 +72,48 @@ function handleAncestors(ctor, opts) {
         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;
@@ -109,19 +121,8 @@ function isSigilCtor(ctor) {
 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__;
@@ -144,21 +145,14 @@ function getLabelRegistry() {
 }
 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);
@@ -168,30 +162,27 @@ function verifyLabel(ctor, label, opts) {
         `[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__];
     }
     /**
@@ -202,23 +193,29 @@ function Sigilify(Base, label, opts) {
      * @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
@@ -233,7 +230,7 @@ function Sigilify(Base, label, opts) {
      * @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;
     }
@@ -247,11 +244,9 @@ function Sigilify(Base, label, opts) {
      * @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;
     }
     /**
@@ -280,9 +275,8 @@ function Sigilify(Base, label, opts) {
      * @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;
     }
     /**
@@ -307,202 +301,77 @@ function Sigilify(Base, label, opts) {
      * @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;
@@ -510,6 +379,7 @@ exports.SigilError = SigilError;
 exports.Sigilify = Sigilify;
 exports.SigilifyAbstract = SigilifyAbstract;
 exports.WithSigil = WithSigil;
+exports.attachSigil = attachSigil;
 exports.getSigilLabels = getSigilLabels;
 exports.isSigilCtor = isSigilCtor;
 exports.isSigilInstance = isSigilInstance;