@vicin/sigil 3.3.0 → 4.0.0

package/dist/index.js

@@ -1,71 +1,65 @@
-'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 handleAncestors(ctor, opts) {
+function hasOwnSigil(ctor) {
+  return hasOwnSigilRegistry.has(ctor);
+}
+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,
@@ -73,156 +67,57 @@ function sigilify(ctor, label) {
     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
@@ -236,8 +131,7 @@ function Sigilify(Base, label, opts) {
      * @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;
     }
@@ -250,12 +144,9 @@ function Sigilify(Base, label, opts) {
      * @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;
     }
     /**
@@ -270,7 +161,7 @@ function Sigilify(Base, label, opts) {
      * @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;
     }
@@ -283,10 +174,9 @@ function Sigilify(Base, label, opts) {
      * @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;
     }
     /**
@@ -294,230 +184,74 @@ function Sigilify(Base, label, opts) {
      *
      * @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.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.isSigilCtor = isSigilCtor;
-exports.isSigilInstance = isSigilInstance;
-exports.updateSigilOptions = updateSigilOptions;
-exports.withSigil = withSigil;
+export { AttachSigil, RECOMMENDED_LABEL_REGEX, Sigil, SigilError, Sigilify, SigilifyAbstract, attachSigil, hasOwnSigil, isSigilCtor, isSigilInstance, updateSigilOptions };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map