@vicin/sigil 2.1.0 → 2.2.1

package/dist/index.global.js

@@ -9,25 +9,24 @@
   var OPTIONS = {
     labelValidation: null,
     skipLabelInheritanceCheck: false,
-    autofillLabels: false
+    autofillLabels: true
   };
   var updateSigilOptions = (opts) => {
-    if (opts.autofillLabels) {
+    if ("autofillLabels" in opts) {
       if (typeof opts.autofillLabels !== "boolean")
         throw new Error("'updateSigilOptions.autofillLabels' must be boolean");
       OPTIONS.autofillLabels = opts.autofillLabels;
     }
-    if (opts.skipLabelInheritanceCheck) {
+    if ("skipLabelInheritanceCheck" in opts) {
       if (typeof opts.skipLabelInheritanceCheck !== "boolean")
         throw new Error("'updateSigilOptions.skipLabelInheritanceCheck' must be boolean");
       OPTIONS.skipLabelInheritanceCheck = opts.skipLabelInheritanceCheck;
     }
-    if (opts.labelValidation) {
-      if (opts.labelValidation !== null && typeof opts.labelValidation !== "function" && !(opts.labelValidation instanceof RegExp))
-        throw new Error(
-          "'updateSigilOptions.labelValidation' must be null, function or regex expression"
-        );
-      OPTIONS.labelValidation = opts.labelValidation;
+    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 != null ? val : null;
     }
   };
   var DEFAULT_LABEL_REGEX = /^@[\w-]+(?:\/[\w-]+)*\.[A-Z][A-Za-z0-9]*$/;
@@ -38,6 +37,7 @@
   var __DECORATED__ = /* @__PURE__ */ Symbol.for("@Sigil.__DECORATED__");
   var __INHERITANCE_CHECKED__ = /* @__PURE__ */ Symbol.for("@Sigil.__INHERITANCE_CHECKED__");
   var __LABEL__ = /* @__PURE__ */ Symbol.for("@Sigil.__LABEL__");
+  var __EFFECTIVE_LABEL__ = /* @__PURE__ */ Symbol.for("@Sigil.__EFFECTIVE_LABEL__");
   var __LABEL_LINEAGE__ = /* @__PURE__ */ Symbol.for("@Sigil.__LABEL_LINEAGE__");
   var __LABEL_SET__ = /* @__PURE__ */ Symbol.for("@Sigil.__LABEL_SET__");
 
@@ -1748,44 +1748,48 @@
     };
   }
 
-  // src/core/constants.ts
-  var __DEV__ = typeof process !== "undefined" && process.env.NODE_ENV === "development";
-
   // src/core/helpers.ts
-  function decorateCtor(ctor, label, isMixin = false) {
-    if (isDecorated(ctor))
-      throw new Error(
-        `Constructor ${ctor} is already decorated. if you are using 'withSigilTyped()' & '@WithSigil()' at the same time remove one of them.`
-      );
+  function decorateCtor(ctor, label, runtime) {
+    if (process.env.NODE_ENV !== "production") {
+      if (isDecorated(ctor))
+        throw new Error(
+          `Constructor ${ctor} is already decorated. if you are using 'withSigilTyped()' & '@WithSigil()' at the same time remove one of them.`
+        );
+    }
     Object.defineProperty(ctor, __LABEL__, {
       value: label,
-      configurable: false,
+      configurable: true,
       enumerable: false,
       writable: false
     });
+    if (!(runtime == null ? void 0 : runtime.isInheritanceCheck))
+      Object.defineProperty(ctor, __EFFECTIVE_LABEL__, {
+        value: label,
+        configurable: true,
+        enumerable: false,
+        writable: false
+      });
     const parent = Object.getPrototypeOf(ctor);
     const parentChain = parent && parent[__LABEL_LINEAGE__] ? parent[__LABEL_LINEAGE__] : [];
-    const ctorChain = isMixin && label !== "Sigil" ? ["Sigil", ...parentChain, label] : [...parentChain, label];
+    const ctorChain = (runtime == null ? void 0 : runtime.isMixin) && label !== "Sigil" ? ["Sigil", ...parentChain, label] : [...parentChain, label];
     Object.defineProperty(ctor, __LABEL_LINEAGE__, {
       value: ctorChain,
-      configurable: false,
+      configurable: true,
       enumerable: false,
       writable: false
     });
     Object.defineProperty(ctor, __LABEL_SET__, {
       value: new Set(ctorChain),
-      configurable: false,
+      configurable: true,
       enumerable: false,
       writable: false
     });
-    markDecorated(ctor);
+    if (!(runtime == null ? void 0 : runtime.isInheritanceCheck)) markDecorated(ctor);
   }
   function checkInheritance(ctor, opts) {
     var _a, _b;
-    const skipLabelInheritanceCheck = (_a = opts == null ? void 0 : opts.skipLabelInheritanceCheck) != null ? _a : OPTIONS.skipLabelInheritanceCheck;
-    const autofillLabels = (_b = opts == null ? void 0 : opts.autofillLabels) != null ? _b : OPTIONS.autofillLabels;
-    if (!isSigilCtor(ctor)) return;
-    if (isInheritanceChecked(ctor) || skipLabelInheritanceCheck) return;
+    if (isInheritanceChecked(ctor) || ((_a = opts == null ? void 0 : opts.skipLabelInheritanceCheck) != null ? _a : OPTIONS.skipLabelInheritanceCheck))
+      return;
     const ctors = [ctor];
     let ancestor = Object.getPrototypeOf(ctor);
     while (isSigilCtor(ancestor)) {
@@ -1796,16 +1800,16 @@
     for (let i = ctors.length - 1; i >= 0; i--) {
       const ctor2 = ctors[i];
       if (!ctor2) continue;
-      let label = ctor2.SigilLabel;
+      let label = ctor2[__LABEL__];
       if (labelOwner.has(label)) {
-        if (isDecorated(ctor2) || !autofillLabels) {
-          const ancestorName = labelOwner.get(label);
-          throw new Error(
-            `[Sigil Error] Class "${ctor2.name}" re-uses Sigil label "${label}" from ancestor "${ancestorName}". Each Sigil subclass must use a unique label. Did you forget to use "WithSigil(newLabel)" on the subclass?`
-          );
+        if (process.env.NODE_ENV !== "production") {
+          if (isDecorated(ctor2) || !((_b = opts == null ? void 0 : opts.autofillLabels) != null ? _b : OPTIONS.autofillLabels))
+            throw new Error(
+              `[Sigil Error] Class "${ctor2.name}" re-uses Sigil label "${label}" from ancestor "${labelOwner.get(label)}". Each Sigil subclass must use a unique label. Did you forget to use "WithSigil(newLabel)" on the subclass?`
+            );
         }
         label = generateRandomLabel();
-        decorateCtor(ctor2, label);
+        decorateCtor(ctor2, label, { isInheritanceCheck: true });
       }
       labelOwner.set(label, ctor2.name);
     }
@@ -1818,10 +1822,12 @@
       let valid;
       if (labelValidation instanceof RegExp) valid = labelValidation.test(label);
       else valid = labelValidation(label);
-      if (!valid)
-        throw new Error(
-          `[Sigil] Invalid identity label "${label}". Make sure that supplied label matches validation regex or function.`
-        );
+      if (process.env.NODE_ENV !== "production") {
+        if (!valid)
+          throw new Error(
+            `[Sigil] Invalid identity label "${label}". Make sure that supplied label matches validation regex or function.`
+          );
+      }
     }
   }
   function generateRandomLabel() {
@@ -1890,7 +1896,7 @@
 
   // src/core/mixin.ts
   function Sigilify(Base, label, opts) {
-    if (isSigilCtor(Base)) throw new Error(`[Sigil Error] 'Sigilify(${label})' already siglified.`);
+    if (isSigilCtor(Base)) throw new Error(`[Sigil Error] 'Sigilify(${label})' already sigilified.`);
     let l;
     if (label) {
       verifyLabel(label, opts);
@@ -1898,11 +1904,18 @@
     } else l = generateRandomLabel();
     class Sigilified extends Base {
       /**
-       * Class-level human-readable label constant for this sigil constructor.
+       * Class-level identity label constant for this sigil constructor.
        */
       static get SigilLabel() {
+        if (!isInheritanceChecked(this)) checkInheritance(this);
         return this[__LABEL__];
       }
+      /**
+       * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
+       */
+      static get SigilEffectiveLabel() {
+        return this[__EFFECTIVE_LABEL__];
+      }
       /**
        * Copy of the linearized sigil type label chain for the current constructor.
        *
@@ -1912,6 +1925,7 @@
        */
       static get SigilLabelLineage() {
         var _a;
+        if (!isInheritanceChecked(this)) checkInheritance(this);
         return [...(_a = this[__LABEL_LINEAGE__]) != null ? _a : []];
       }
       /**
@@ -1922,6 +1936,7 @@
        * @returns A Readonly Set of labels that represent the type lineage.
        */
       static get SigilLabelSet() {
+        if (!isInheritanceChecked(this)) checkInheritance(this);
         const set = /* @__PURE__ */ new Set();
         for (const s of this[__LABEL_SET__]) set.add(s);
         return set;
@@ -1932,11 +1947,11 @@
           Object.setPrototypeOf(this, new.target.prototype);
         const ctor = getConstructor(this);
         if (!ctor) {
-          if (__DEV__)
+          if (process.env.NODE_ENV !== "production")
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return;
         }
-        if (__DEV__) checkInheritance(ctor);
+        checkInheritance(ctor);
       }
       /**
        * Runtime predicate indicating whether `obj` is an instance produced by a sigil class.
@@ -2015,19 +2030,33 @@
         return !!otherLineage && thisLineage.every((s, i) => s === otherLineage[i]);
       }
       /**
-       * Returns the human-readable sigil label of this instance's constructor.
+       * Returns the identity sigil label of this instance's constructor.
        *
-       * @returns The label string (e.g. '@scope/pkg.ClassName') or '@Sigil.unknown' in DEV when constructor is missing.
+       * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil.auto-dq62ib6jnvmmlfbjhxh2937h') or '@Sigil.unknown' if constructor is missing.
        */
       getSigilLabel() {
         const ctor = getConstructor(this);
         if (!ctor) {
-          if (__DEV__)
-            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          if (process.env.NODE_ENV !== "production")
+            throw new Error(`[Sigil Error] Sigil class instance without constructor`);
           return "@Sigil.unknown";
         }
         return ctor.SigilLabel;
       }
+      /**
+       * Returns the human-readable sigil label of this instance's constructor.
+       *
+       * @returns The last passed label string (e.g. '@scope/pkg.ClassName') or '@Sigil.unknown' if constructor is missing.
+       */
+      getSigilEffectiveLabel() {
+        const ctor = getConstructor(this);
+        if (!ctor) {
+          if (process.env.NODE_ENV !== "production")
+            throw new Error(`[Sigil Error] Sigil class instance without constructor`);
+          return "@Sigil.unknown";
+        }
+        return ctor.SigilEffectiveLabel;
+      }
       /**
        * Returns a copy of the sigil type label lineage for this instance's constructor.
        *
@@ -2036,8 +2065,8 @@
       getSigilLabelLineage() {
         const ctor = getConstructor(this);
         if (!ctor) {
-          if (__DEV__)
-            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          if (process.env.NODE_ENV !== "production")
+            throw new Error(`[Sigil Error] Sigil class instance without constructor`);
           return ["@Sigil.unknown"];
         }
         return ctor.SigilLabelLineage;
@@ -2050,20 +2079,20 @@
       getSigilLabelSet() {
         const ctor = getConstructor(this);
         if (!ctor) {
-          if (__DEV__)
-            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          if (process.env.NODE_ENV !== "production")
+            throw new Error(`[Sigil Error] Sigil class instance without constructor`);
           return /* @__PURE__ */ new Set(["@Sigil.unknown"]);
         }
         return ctor.SigilLabelSet;
       }
     }
-    decorateCtor(Sigilified, l, true);
+    decorateCtor(Sigilified, l, { isMixin: true });
     markSigil(Sigilified);
     markSigilBase(Sigilified);
     return Sigilified;
   }
   function SigilifyAbstract(Base, label, opts) {
-    if (isSigilCtor(Base)) throw new Error(`[Sigil Error] 'Sigilify(${label})' already siglified.`);
+    if (isSigilCtor(Base)) throw new Error(`[Sigil Error] 'Sigilify(${label})' already sigilified.`);
     let l;
     if (label) {
       verifyLabel(label, opts);
@@ -2071,11 +2100,18 @@
     } else l = generateRandomLabel();
     class Sigilified extends Base {
       /**
-       * Class-level human-readable label constant for this sigil constructor.
+       * Class-level identity label constant for this sigil constructor.
        */
       static get SigilLabel() {
+        if (!isInheritanceChecked(this)) checkInheritance(this);
         return this[__LABEL__];
       }
+      /**
+       * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
+       */
+      static get SigilEffectiveLabel() {
+        return this[__EFFECTIVE_LABEL__];
+      }
       /**
        * Copy of the linearized sigil type label chain for the current constructor.
        *
@@ -2085,6 +2121,7 @@
        */
       static get SigilLabelLineage() {
         var _a;
+        if (!isInheritanceChecked(this)) checkInheritance(this);
         return [...(_a = this[__LABEL_LINEAGE__]) != null ? _a : []];
       }
       /**
@@ -2095,6 +2132,7 @@
        * @returns A Readonly Set of labels that represent the type lineage.
        */
       static get SigilLabelSet() {
+        if (!isInheritanceChecked(this)) checkInheritance(this);
         const set = /* @__PURE__ */ new Set();
         for (const s of this[__LABEL_SET__]) set.add(s);
         return set;
@@ -2105,11 +2143,11 @@
           Object.setPrototypeOf(this, new.target.prototype);
         const ctor = getConstructor(this);
         if (!ctor) {
-          if (__DEV__)
+          if (process.env.NODE_ENV !== "production")
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return;
         }
-        if (__DEV__) checkInheritance(ctor);
+        checkInheritance(ctor);
       }
       /**
        * Runtime predicate indicating whether `obj` is an instance produced by a sigil class.
@@ -2137,7 +2175,7 @@
        */
       static isOfType(other) {
         var _a;
-        if (!isSigilInstance(other) || !isSigilCtor(this)) return false;
+        if (!isSigilInstance(other)) return false;
         const otherSet = (_a = getConstructor(other)) == null ? void 0 : _a[__LABEL_SET__];
         const thisType = this[__LABEL__];
         return !!otherSet && otherSet.has(thisType);
@@ -2156,7 +2194,7 @@
        */
       static isOfTypeStrict(other) {
         var _a;
-        if (!isSigilInstance(other) || !isSigilCtor(this)) return false;
+        if (!isSigilInstance(other)) return false;
         const otherLineage = (_a = getConstructor(other)) == null ? void 0 : _a[__LABEL_LINEAGE__];
         const thisLineage = this[__LABEL_LINEAGE__];
         return !!otherLineage && thisLineage.every((s, i) => s === otherLineage[i]);
@@ -2173,7 +2211,7 @@
        */
       isOfType(other) {
         var _a;
-        if (!isSigilInstance(other) || !isSigilInstance(this)) return false;
+        if (!isSigilInstance(other)) return false;
         const otherSet = (_a = getConstructor(other)) == null ? void 0 : _a[__LABEL_SET__];
         const thisType = getConstructor(this)[__LABEL__];
         return !!otherSet && otherSet.has(thisType);
@@ -2190,25 +2228,39 @@
        */
       isOfTypeStrict(other) {
         var _a, _b;
-        if (!isSigilInstance(other) || !isSigilInstance(this)) return false;
+        if (!isSigilInstance(other)) return false;
         const otherLineage = (_a = getConstructor(other)) == null ? void 0 : _a[__LABEL_LINEAGE__];
         const thisLineage = (_b = getConstructor(this)) == null ? void 0 : _b[__LABEL_LINEAGE__];
         return !!otherLineage && thisLineage.every((s, i) => s === otherLineage[i]);
       }
       /**
-       * Returns the human-readable sigil label of this instance's constructor.
+       * Returns the identity sigil label of this instance's constructor.
        *
-       * @returns The label string (e.g. '@scope/pkg.ClassName') or '@Sigil.unknown' in DEV when constructor is missing.
+       * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil.auto-dq62ib6jnvmmlfbjhxh2937h') or '@Sigil.unknown' if constructor is missing.
        */
       getSigilLabel() {
         const ctor = getConstructor(this);
         if (!ctor) {
-          if (__DEV__)
-            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          if (process.env.NODE_ENV !== "production")
+            throw new Error(`[Sigil Error] Sigil class instance without constructor`);
           return "@Sigil.unknown";
         }
         return ctor.SigilLabel;
       }
+      /**
+       * Returns the human-readable sigil label of this instance's constructor.
+       *
+       * @returns The last passed label string (e.g. '@scope/pkg.ClassName') or '@Sigil.unknown' if constructor is missing.
+       */
+      getSigilEffectiveLabel() {
+        const ctor = getConstructor(this);
+        if (!ctor) {
+          if (process.env.NODE_ENV !== "production")
+            throw new Error(`[Sigil Error] Sigil class instance without constructor`);
+          return "@Sigil.unknown";
+        }
+        return ctor.SigilEffectiveLabel;
+      }
       /**
        * Returns a copy of the sigil type label lineage for this instance's constructor.
        *
@@ -2217,8 +2269,8 @@
       getSigilLabelLineage() {
         const ctor = getConstructor(this);
         if (!ctor) {
-          if (__DEV__)
-            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          if (process.env.NODE_ENV !== "production")
+            throw new Error(`[Sigil Error] Sigil class instance without constructor`);
           return ["@Sigil.unknown"];
         }
         return ctor.SigilLabelLineage;
@@ -2231,14 +2283,14 @@
       getSigilLabelSet() {
         const ctor = getConstructor(this);
         if (!ctor) {
-          if (__DEV__)
-            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          if (process.env.NODE_ENV !== "production")
+            throw new Error(`[Sigil Error] Sigil class instance without constructor`);
           return /* @__PURE__ */ new Set(["@Sigil.unknown"]);
         }
         return ctor.SigilLabelSet;
       }
     }
-    decorateCtor(Sigilified, l, true);
+    decorateCtor(Sigilified, l, { isMixin: true });
     markSigil(Sigilified);
     markSigilBase(Sigilified);
     return Sigilified;
@@ -2263,7 +2315,7 @@
           `[Sigil Error] 'WithSigil' decorator accept only Sigil classes but used on class ${value.name}`
         );
       decorateCtor(value, l);
-      if (__DEV__) checkInheritance(value, opts);
+      checkInheritance(value, opts);
     };
   }
 
@@ -2281,7 +2333,7 @@
     } else l = generateRandomLabel();
     const ctor = Class;
     decorateCtor(ctor, l);
-    if (__DEV__) checkInheritance(ctor, opts);
+    checkInheritance(ctor, opts);
     return Class;
   }
   function withSigilTyped(Class, label, opts) {
@@ -2297,7 +2349,7 @@
     } else l = generateRandomLabel();
     const ctor = Class;
     decorateCtor(ctor, l);
-    if (__DEV__) checkInheritance(ctor, opts);
+    checkInheritance(ctor, opts);
     return Class;
   }
   /*! Bundled license information: