@vicin/sigil 2.0.3 → 2.2.0

package/dist/index.global.js

@@ -9,17 +9,26 @@
   var OPTIONS = {
     labelValidation: null,
     skipLabelInheritanceCheck: false,
-    autofillLabels: false
+    autofillLabels: true
   };
-  var updateOptions = (opts) => {
-    for (const [k, v] of Object.entries(opts)) OPTIONS[k] = v;
-  };
-  var DEFAULT_OPTIONS = {
-    labelValidation: null,
-    skipLabelInheritanceCheck: false,
-    autofillLabels: false
+  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 ("skipLabelInheritanceCheck" in opts) {
+      if (typeof opts.skipLabelInheritanceCheck !== "boolean")
+        throw new Error("'updateSigilOptions.skipLabelInheritanceCheck' must be boolean");
+      OPTIONS.skipLabelInheritanceCheck = opts.skipLabelInheritanceCheck;
+    }
+    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;
+    }
   };
-  updateOptions(DEFAULT_OPTIONS);
   var DEFAULT_LABEL_REGEX = /^@[\w-]+(?:\/[\w-]+)*\.[A-Z][A-Za-z0-9]*$/;
 
   // src/core/symbols.ts
@@ -28,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__");
 
@@ -1738,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)) {
@@ -1786,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);
     }
@@ -1808,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() {
@@ -1880,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);
@@ -1888,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.
        *
@@ -1902,6 +1925,7 @@
        */
       static get SigilLabelLineage() {
         var _a;
+        if (!isInheritanceChecked(this)) checkInheritance(this);
         return [...(_a = this[__LABEL_LINEAGE__]) != null ? _a : []];
       }
       /**
@@ -1912,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;
@@ -1922,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.
@@ -2005,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.
        *
@@ -2026,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;
@@ -2040,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);
@@ -2061,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.
        *
@@ -2075,6 +2121,7 @@
        */
       static get SigilLabelLineage() {
         var _a;
+        if (!isInheritanceChecked(this)) checkInheritance(this);
         return [...(_a = this[__LABEL_LINEAGE__]) != null ? _a : []];
       }
       /**
@@ -2085,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;
@@ -2095,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.
@@ -2127,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);
@@ -2146,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]);
@@ -2163,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);
@@ -2180,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.
        *
@@ -2207,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;
@@ -2221,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;
@@ -2253,11 +2315,11 @@
           `[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);
     };
   }
 
-  // src/core/enhancers.ts
+  // src/core/hof.ts
   function withSigil(Class, label, opts) {
     var _a;
     if (!isSigilCtor(Class))
@@ -2271,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) {
@@ -2287,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:
@@ -2308,7 +2370,7 @@
   exports.isSigilBaseInstance = isSigilBaseInstance;
   exports.isSigilCtor = isSigilCtor;
   exports.isSigilInstance = isSigilInstance;
-  exports.updateOptions = updateOptions;
+  exports.updateSigilOptions = updateSigilOptions;
   exports.withSigil = withSigil;
   exports.withSigilTyped = withSigilTyped;