@vicin/sigil 3.0.0 → 3.1.0

package/dist/index.js

@@ -1,2 +1,527 @@
-'use strict';var cuid2=require('@paralleldrive/cuid2');var w={labelValidation:null,skipLabelInheritanceCheck:false,autofillLabels:true},V=i=>{if("autofillLabels"in i){if(typeof i.autofillLabels!="boolean")throw new Error("'updateSigilOptions.autofillLabels' must be boolean");w.autofillLabels=i.autofillLabels;}if("skipLabelInheritanceCheck"in i){if(typeof i.skipLabelInheritanceCheck!="boolean")throw new Error("'updateSigilOptions.skipLabelInheritanceCheck' must be boolean");w.skipLabelInheritanceCheck=i.skipLabelInheritanceCheck;}if("labelValidation"in i){let t=i.labelValidation;if(t!==null&&typeof t!="function"&&!(t instanceof RegExp))throw new Error("'updateSigilOptions.labelValidation' must be null, function or RegExp");w.labelValidation=t!=null?t:null;}},P=/^@[\w-]+(?:\/[\w-]+)*\.[A-Z][A-Za-z0-9]*$/;var k=Symbol.for("@vicin/sigil.__SIGIL__"),T=Symbol.for("@vicin/sigil.__SIGIL_BASE__"),C=Symbol.for("@vicin/sigil.__DECORATED__"),v=Symbol.for("@vicin/sigil.__INHERITANCE_CHECKED__"),p=Symbol.for("@vicin/sigil.__LABEL__"),O=Symbol.for("@vicin/sigil.__EFFECTIVE_LABEL__"),g=Symbol.for("@vicin/sigil.__LABEL_LINEAGE__"),_=Symbol.for("@vicin/sigil.__LABEL_SET__");function L(i,t,n){if(process.env.NODE_ENV!=="production"&&B(i))throw new Error(`Constructor ${i} is already decorated. if you are using 'withSigilTyped()' & '@WithSigil()' at the same time remove one of them.`);Object.defineProperty(i,p,{value:t,configurable:true,enumerable:false,writable:false}),n!=null&&n.isInheritanceCheck||Object.defineProperty(i,O,{value:t,configurable:true,enumerable:false,writable:false});let o=Object.getPrototypeOf(i),l=o&&o[g]?o[g]:[],S=n!=null&&n.isMixin&&t!=="Sigil"?["Sigil",...l,t]:[...l,t];Object.defineProperty(i,g,{value:S,configurable:true,enumerable:false,writable:false}),Object.defineProperty(i,_,{value:new Set(S),configurable:true,enumerable:false,writable:false}),n!=null&&n.isInheritanceCheck||F(i);}function f(i,t){var S,e;if(b(i)||((S=t==null?void 0:t.skipLabelInheritanceCheck)!=null?S:w.skipLabelInheritanceCheck))return;let n=[i],o=Object.getPrototypeOf(i);for(;h(o);)n.push(o),o=Object.getPrototypeOf(o);let l=new Map;for(let r=n.length-1;r>=0;r--){let c=n[r];if(!c)continue;let s=c[p];if(l.has(s)){if(process.env.NODE_ENV!=="production"&&(B(c)||!((e=t==null?void 0:t.autofillLabels)!=null?e:w.autofillLabels)))throw new Error(`[Sigil Error] Class "${c.name}" re-uses Sigil label "${s}" from ancestor "${l.get(s)}". Each Sigil subclass must use a unique label. Did you forget to use "WithSigil(newLabel)" on the subclass?`);s=y(),L(c,s,{isInheritanceCheck:true});}l.set(s,c.name);}R(i);}function I(i,t){var o;let n=(o=t==null?void 0:t.labelValidation)!=null?o:w.labelValidation;if(n){let l;if(n instanceof RegExp?l=n.test(i):l=n(i),process.env.NODE_ENV!=="production"&&!l)throw new Error(`[Sigil] Invalid identity label "${i}". Make sure that supplied label matches validation regex or function.`)}}function y(){return `@Sigil.auto-${cuid2.createId()}`}function A(i){Object.defineProperty(i,k,{value:true,configurable:false,enumerable:false,writable:false});}function N(i){Object.defineProperty(i,T,{value:true,configurable:false,enumerable:false,writable:false});}function F(i){Object.defineProperty(i,C,{value:true,configurable:false,enumerable:false,writable:false});}function R(i){Object.defineProperty(i,v,{value:true,configurable:false,enumerable:false,writable:false});}function h(i){return typeof i=="function"&&i[k]===true}function u(i){if(!i||typeof i!="object")return  false;let t=a(i);return h(t)}function D(i){return Object.hasOwn(i,T)}function $(i){if(!i||typeof i!="object")return  false;let t=a(i);return D(t)}function B(i){return Object.hasOwn(i,C)}function b(i){return Object.hasOwn(i,v)}function a(i){var t,n,o;return !i||typeof i!="object"?null:(o=(n=i.constructor)!=null?n:(t=Object.getPrototypeOf(i))==null?void 0:t.constructor)!=null?o:null}function m(i,t,n){if(h(i))throw new Error(`[Sigil Error] 'Sigilify(${t})' already sigilified.`);let o;t?(I(t,n),o=t):o=y();class l extends i{static get SigilLabel(){return b(this)||f(this),this[p]}static get SigilEffectiveLabel(){return this[O]}static get SigilLabelLineage(){var e;return b(this)||f(this),[...(e=this[g])!=null?e:[]]}static get SigilLabelSet(){b(this)||f(this);let e=new Set;for(let r of this[_])e.add(r);return e}constructor(...e){super(...e),Object.getPrototypeOf(this)!==new.target.prototype&&Object.setPrototypeOf(this,new.target.prototype);let r=a(this);if(!r){if(process.env.NODE_ENV!=="production")throw new Error(`[Sigil Error] 'Sigilify(${t})' instance without constructor`);return}f(r);}static isSigilified(e){return u(e)}static isOfType(e){var s;if(!u(e))return  false;let r=(s=a(e))==null?void 0:s[_],c=this[p];return !!r&&r.has(c)}static isOfTypeStrict(e){var s;if(!u(e))return  false;let r=(s=a(e))==null?void 0:s[g],c=this[g];return !!r&&c.every((E,d)=>E===r[d])}isOfType(e){var s;if(!u(e))return  false;let r=(s=a(e))==null?void 0:s[_],c=a(this)[p];return !!r&&r.has(c)}isOfTypeStrict(e){var s,E;if(!u(e))return  false;let r=(s=a(e))==null?void 0:s[g],c=(E=a(this))==null?void 0:E[g];return !!r&&c.every((d,x)=>d===r[x])}getSigilLabel(){let e=a(this);if(!e){if(process.env.NODE_ENV!=="production")throw new Error("[Sigil Error] Sigil class instance without constructor");return "@Sigil.unknown"}return e.SigilLabel}getSigilEffectiveLabel(){let e=a(this);if(!e){if(process.env.NODE_ENV!=="production")throw new Error("[Sigil Error] Sigil class instance without constructor");return "@Sigil.unknown"}return e.SigilEffectiveLabel}getSigilLabelLineage(){let e=a(this);if(!e){if(process.env.NODE_ENV!=="production")throw new Error("[Sigil Error] Sigil class instance without constructor");return ["@Sigil.unknown"]}return e.SigilLabelLineage}getSigilLabelSet(){let e=a(this);if(!e){if(process.env.NODE_ENV!=="production")throw new Error("[Sigil Error] Sigil class instance without constructor");return new Set(["@Sigil.unknown"])}return e.SigilLabelSet}}return L(l,o,{isMixin:true}),A(l),N(l),l}function G(i,t,n){if(h(i))throw new Error(`[Sigil Error] 'Sigilify(${t})' already sigilified.`);let o;t?(I(t,n),o=t):o=y();class l extends i{static get SigilLabel(){return b(this)||f(this),this[p]}static get SigilEffectiveLabel(){return this[O]}static get SigilLabelLineage(){var e;return b(this)||f(this),[...(e=this[g])!=null?e:[]]}static get SigilLabelSet(){b(this)||f(this);let e=new Set;for(let r of this[_])e.add(r);return e}constructor(...e){super(...e),Object.getPrototypeOf(this)!==new.target.prototype&&Object.setPrototypeOf(this,new.target.prototype);let r=a(this);if(!r){if(process.env.NODE_ENV!=="production")throw new Error(`[Sigil Error] 'Sigilify(${t})' instance without constructor`);return}f(r);}static isSigilified(e){return u(e)}static isOfType(e){var s;if(!u(e))return  false;let r=(s=a(e))==null?void 0:s[_],c=this[p];return !!r&&r.has(c)}static isOfTypeStrict(e){var s;if(!u(e))return  false;let r=(s=a(e))==null?void 0:s[g],c=this[g];return !!r&&c.every((E,d)=>E===r[d])}isOfType(e){var s;if(!u(e))return  false;let r=(s=a(e))==null?void 0:s[_],c=a(this)[p];return !!r&&r.has(c)}isOfTypeStrict(e){var s,E;if(!u(e))return  false;let r=(s=a(e))==null?void 0:s[g],c=(E=a(this))==null?void 0:E[g];return !!r&&c.every((d,x)=>d===r[x])}getSigilLabel(){let e=a(this);if(!e){if(process.env.NODE_ENV!=="production")throw new Error("[Sigil Error] Sigil class instance without constructor");return "@Sigil.unknown"}return e.SigilLabel}getSigilEffectiveLabel(){let e=a(this);if(!e){if(process.env.NODE_ENV!=="production")throw new Error("[Sigil Error] Sigil class instance without constructor");return "@Sigil.unknown"}return e.SigilEffectiveLabel}getSigilLabelLineage(){let e=a(this);if(!e){if(process.env.NODE_ENV!=="production")throw new Error("[Sigil Error] Sigil class instance without constructor");return ["@Sigil.unknown"]}return e.SigilLabelLineage}getSigilLabelSet(){let e=a(this);if(!e){if(process.env.NODE_ENV!=="production")throw new Error("[Sigil Error] Sigil class instance without constructor");return new Set(["@Sigil.unknown"])}return e.SigilLabelSet}}return L(l,o,{isMixin:true}),A(l),N(l),l}var H=m(class{},"Sigil"),M=m(Error,"SigilError");function K(i,t){let n;return i?(I(i,t),n=i):n=y(),function(o,l){if(l.kind==="class"){if(!h(o))throw new Error(`[Sigil Error] 'WithSigil' decorator accept only Sigil classes but used on class ${o.name}`);L(o,n),f(o,t);}}}function W(i,t,n){var S;if(!h(i))throw new Error(`[Sigil Error] 'withSigil' HOF accept only Sigil classes  but used on class ${(S=i==null?void 0:i.name)!=null?S:"unknown"}`);let o;t?(I(t,n),o=t):o=y();let l=i;return L(l,o),f(l,n),i}exports.DEFAULT_LABEL_REGEX=P;exports.Sigil=H;exports.SigilError=M;exports.Sigilify=m;exports.SigilifyAbstract=G;exports.WithSigil=K;exports.isDecorated=B;exports.isInheritanceChecked=b;exports.isSigilBaseCtor=D;exports.isSigilBaseInstance=$;exports.isSigilCtor=h;exports.isSigilInstance=u;exports.updateSigilOptions=V;exports.withSigil=W;//# sourceMappingURL=index.js.map
+'use strict';
+
+// src/options.ts
+var OPTIONS = {
+  labelValidation: null,
+  autofillLabels: true
+};
+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 != null ? val : null;
+  }
+};
+var DEFAULT_LABEL_REGEX = /^@[\w-]+(?:\/[\w-]+)*\.[A-Z][A-Za-z0-9]*$/;
+
+// 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;
+  handledCtors.add(ctor);
+  verifyLabel(ctor, label, opts);
+  const ancLabelsMap = handleAncestors(ctor, opts);
+  if (label && ancLabelsMap.has(label))
+    throw new Error(
+      `[Sigil Error] Attempt to assign label '${label}' to ${ctor.name} but label is already used by parent '${ancLabelsMap.get(label)}', Make sure that every class has a unique label`
+    );
+  sigilify(ctor, label != null ? label : generateRandomLabel(ctor));
+}
+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__]) {
+    ancestors.unshift(a);
+    a = Object.getPrototypeOf(a);
+  }
+  const labelOwner = /* @__PURE__ */ new Map();
+  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 with 'autofillLabels' setted to 'false', Make sure to sigilify all Sigil classes or set 'autofillLabels' to 'true'`
+        );
+      sigilify(a2, generateRandomLabel(a2));
+    }
+    labelOwner.set(labelOf(a2), a2.name);
+  }
+  return labelOwner;
+}
+function sigilify(ctor, label) {
+  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,
+    enumerable: false,
+    writable: false
+  });
+  Object.defineProperty(ctor.prototype, __LABEL__, {
+    value: label,
+    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]),
+    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
+    });
+}
+function isSigilCtor(ctor) {
+  return typeof ctor === "function" && __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 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.name}' is not sigilified with 'autofillLabels' setted to 'false', 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 (labelValidation) {
+    let valid;
+    if (labelValidation instanceof RegExp) valid = labelValidation.test(label);
+    else valid = labelValidation(label);
+    if (process.env.NODE_ENV !== "production") {
+      if (!valid)
+        throw new Error(
+          `[Sigil Error] Invalid identity label "${label}". Make sure that supplied label matches validation regex or function`
+        );
+    }
+  }
+}
+if (!globalThis.__SigilabelCounter) globalThis.__SigilabelCounter = 0;
+function generateRandomLabel(ctor) {
+  const namePart = ctor && typeof ctor.name === "string" && ctor.name.length ? ctor.name : "C";
+  const counter = globalThis.__SigilabelCounter++;
+  const time = Date.now().toString(36);
+  const rand = Math.random().toString(36).slice(2, 6);
+  return `${AUTO_LABEL_PREFEX}:${namePart}:${time}:${counter.toString(36)}:${rand}`;
+}
+
+// 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 {
+    /**
+     * Class-level identity label constant for this sigil constructor.
+     */
+    static get SigilLabel() {
+      var _a;
+      handleSigil(this);
+      return (_a = this.prototype) == null ? void 0 : _a[__LABEL__];
+    }
+    /**
+     * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
+     */
+    static get SigilEffectiveLabel() {
+      var _a;
+      handleSigil(this);
+      return (_a = this.prototype) == null ? void 0 : _a[__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() {
+      var _a, _b;
+      handleSigil(this);
+      return [...(_b = (_a = this.prototype) == null ? void 0 : _a[__LINEAGE__]) != null ? _b : []];
+    }
+    /**
+     * 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() {
+      var _a;
+      handleSigil(this);
+      return (_a = this.prototype) == null ? void 0 : _a[__LINEAGE__];
+    }
+    constructor(...args) {
+      super(...args);
+      const ctor = new.target;
+      handleSigil(ctor);
+    }
+    /**
+     * Runtime predicate indicating whether `obj` is an instance produced by a sigil class.
+     *
+     * @param obj - The value to test.
+     * @returns `true` if `obj` is a sigil instance.
+     */
+    static isSigilified(obj) {
+      return isSigilInstance(obj);
+    }
+    /**
+     * 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) {
+      var _a;
+      handleSigil(this);
+      if (other == null || typeof other !== "object") return false;
+      return other[(_a = this.prototype) == null ? void 0 : _a[__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, _c;
+      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[(_c = this.prototype) == null ? void 0 : _c[__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:mm2gkdwn:0:g1sq').
+     */
+    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__];
+    }
+  }
+  handleSigil(Sigilified, label, opts);
+  return Sigilified;
+}
+function SigilifyAbstract(Base, label, opts) {
+  if (hasOwnSigil(Base))
+    throw new Error(
+      `[Sigil Error] Base 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() {
+      var _a;
+      handleSigil(this);
+      return (_a = this.prototype) == null ? void 0 : _a[__LABEL__];
+    }
+    /**
+     * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
+     */
+    static get SigilEffectiveLabel() {
+      var _a;
+      handleSigil(this);
+      return (_a = this.prototype) == null ? void 0 : _a[__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() {
+      var _a, _b;
+      handleSigil(this);
+      return [...(_b = (_a = this.prototype) == null ? void 0 : _a[__LINEAGE__]) != null ? _b : []];
+    }
+    /**
+     * 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() {
+      var _a;
+      handleSigil(this);
+      return (_a = this.prototype) == null ? void 0 : _a[__LINEAGE__];
+    }
+    constructor(...args) {
+      super(...args);
+      const ctor = new.target;
+      handleSigil(ctor);
+    }
+    /**
+     * Runtime predicate indicating whether `obj` is an instance produced by a sigil class.
+     *
+     * @param obj - The value to test.
+     * @returns `true` if `obj` is a sigil instance.
+     */
+    static isSigilified(obj) {
+      return isSigilInstance(obj);
+    }
+    /**
+     * 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) {
+      var _a;
+      if (other == null || typeof other !== "object") return false;
+      return other[(_a = this.prototype) == null ? void 0 : _a[__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, _c;
+      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[(_c = this.prototype) == null ? void 0 : _c[__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:mm2gkdwn:0:g1sq').
+     */
+    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__];
+    }
+  }
+  handleSigil(Sigilified, label, opts);
+  return Sigilified;
+}
+
+// src/classes.ts
+var Sigil = Sigilify(class {
+}, "Sigil");
+var SigilError = Sigilify(Error, "SigilError");
+
+// src/decorator.ts
+function WithSigil(label, opts) {
+  return function(value, context) {
+    if (context.kind !== "class") return;
+    if (!isSigilCtor(value))
+      throw new Error(
+        `[Sigil Error] 'WithSigil' 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);
+  };
+}
+
+// src/hof.ts
+function withSigil(Class, label, opts) {
+  var _a;
+  if (!isSigilCtor(Class))
+    throw new Error(
+      `[Sigil Error] 'withSigil' HOF accept only Sigil classes  but used on class ${(_a = Class == null ? void 0 : Class.name) != null ? _a : "unknown"}`
+    );
+  if (hasOwnSigil(Class))
+    throw new Error(
+      `[Sigil Error] Class '${Class.name}' with label '${Class.SigilLabel}' is already sigilified`
+    );
+  handleSigil(Class, label, opts);
+  return Class;
+}
+
+exports.DEFAULT_LABEL_REGEX = DEFAULT_LABEL_REGEX;
+exports.Sigil = Sigil;
+exports.SigilError = SigilError;
+exports.Sigilify = Sigilify;
+exports.SigilifyAbstract = SigilifyAbstract;
+exports.WithSigil = WithSigil;
+exports.isSigilCtor = isSigilCtor;
+exports.isSigilInstance = isSigilInstance;
+exports.updateSigilOptions = updateSigilOptions;
+exports.withSigil = withSigil;
+//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map