@vicin/sigil 1.2.6 → 1.3.0

package/dist/index.global.js

@@ -133,8 +133,7 @@
      * @param newRegistry - New Set<string> instance to use as the active registry, or `null` to disable checks.
      */
     replaceRegistry(newRegistry) {
-      if (newRegistry)
-        updateOptions({ registry: new _SigilRegistry(newRegistry) });
+      if (newRegistry) updateOptions({ registry: new _SigilRegistry(newRegistry) });
       else updateOptions({ registry: newRegistry });
     }
     /**
@@ -191,9 +190,7 @@
      * @param thisArg - Optional `this` context for the callback.
      */
     forEach(callback, thisArg) {
-      this._registry.forEach(
-        (ctor, label) => callback.call(thisArg, ctor, label)
-      );
+      this._registry.forEach((ctor, label) => callback.call(thisArg, ctor, label));
     }
     /**
      * Get the size (number of entries) of the active registry.
@@ -254,9 +251,7 @@
   var __SIGIL__ = /* @__PURE__ */ Symbol.for("@Sigil.__SIGIL__");
   var __SIGIL_BASE__ = /* @__PURE__ */ Symbol.for("@Sigil.__SIGIL_BASE__");
   var __DECORATED__ = /* @__PURE__ */ Symbol.for("@Sigil.__DECORATED__");
-  var __INHERITANCE_CHECKED__ = /* @__PURE__ */ Symbol.for(
-    "@Sigil.__INHERITANCE_CHECKED__"
-  );
+  var __INHERITANCE_CHECKED__ = /* @__PURE__ */ Symbol.for("@Sigil.__INHERITANCE_CHECKED__");
   var __LABEL__ = /* @__PURE__ */ Symbol.for("@Sigil.__LABEL__");
   var __TYPE__ = /* @__PURE__ */ Symbol.for("@Sigil.__TYPE__");
   var __TYPE_LINEAGE__ = /* @__PURE__ */ Symbol.for("@Sigil.__TYPE_LINEAGE__");
@@ -422,8 +417,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 siglified.`);
     let l;
     if (label) {
       verifyLabel(label, opts);
@@ -476,9 +470,208 @@
         const ctor = getConstructor(this);
         if (!ctor) {
           if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
-            throw new Error(
-              `[Sigil Error] 'Sigilify(${label})' instance without constructor`
-            );
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          return;
+        }
+        checkInheritance(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 type represented by the calling constructor.
+       *
+       * This replaces `instanceof` so that checks remain valid across bundles/realms
+       * and when subclassing.
+       *
+       * @typeParam T - The calling constructor type (narrowing the returned instance type).
+       * @param this - The constructor performing the check.
+       * @param other - The object to test.
+       * @returns `true` if `other` is an instance of this type or a subtype.
+       */
+      static isOfType(other) {
+        var _a;
+        if (!isSigilInstance(other)) return false;
+        const otherSet = (_a = getConstructor(other)) == null ? void 0 : _a[__TYPE_SET__];
+        const thisType = this[__TYPE__];
+        return !!otherSet && otherSet.has(thisType);
+      }
+      /**
+       * Strict lineage check: compares the type symbol lineage arrays element-by-element.
+       *
+       * @typeParam T - The calling constructor type.
+       * @param this - The constructor performing the check.
+       * @param other - The object to test.
+       * @returns `true` if `other` has an identical lineage up to the length of this constructor's lineage.
+       */
+      static isOfTypeStrict(other) {
+        var _a;
+        if (!isSigilInstance(other)) return false;
+        const otherLineage = (_a = getConstructor(other)) == null ? void 0 : _a[__TYPE_LINEAGE__];
+        const thisLineage = this[__TYPE_LINEAGE__];
+        return !!otherLineage && thisLineage.every((s, i) => s === otherLineage[i]);
+      }
+      /**
+       * Check whether `other` is (or inherits from) the type instance.
+       *
+       * Allows 'instanceof' like checks but in instances.
+       *
+       * @typeParam T - The instance type.
+       * @param this - The instance performing the check.
+       * @param other - The object to test.
+       * @returns `true` if `other` is the same instance of this type or a subtype.
+       */
+      isOfType(other) {
+        var _a;
+        if (!isSigilInstance(other)) return false;
+        const otherSet = (_a = getConstructor(other)) == null ? void 0 : _a[__TYPE_SET__];
+        const thisType = getConstructor(this)[__TYPE__];
+        return !!otherSet && otherSet.has(thisType);
+      }
+      /**
+       * Strict lineage check: compares the type symbol lineage arrays element-by-element.
+       *
+       * Allows 'instanceof' like checks but in instances.
+       *
+       * @typeParam T - The instance type.
+       * @param this - The instance performing the check.
+       * @param other - The object to test.
+       * @returns `true` if `other` has an identical lineage up to the length of this instance's lineage.
+       */
+      isOfTypeStrict(other) {
+        var _a, _b;
+        if (!isSigilInstance(other)) return false;
+        const otherLineage = (_a = getConstructor(other)) == null ? void 0 : _a[__TYPE_LINEAGE__];
+        const thisLineage = (_b = getConstructor(this)) == null ? void 0 : _b[__TYPE_LINEAGE__];
+        return !!otherLineage && thisLineage.every((s, i) => s === otherLineage[i]);
+      }
+      /**
+       * Returns the human-readable 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.
+       */
+      getSigilLabel() {
+        var _a;
+        const ctor = getConstructor(this);
+        if (!ctor) {
+          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          return "@Sigil.unknown";
+        }
+        return ctor.SigilLabel;
+      }
+      /**
+       * Returns the runtime sigil type symbol of this instance's constructor.
+       *
+       * @returns The symbol that identifies this type at runtime.
+       */
+      getSigilType() {
+        var _a;
+        const ctor = getConstructor(this);
+        if (!ctor) {
+          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          return /* @__PURE__ */ Symbol.for("@Sigil.unknown");
+        }
+        return ctor.SigilType;
+      }
+      /**
+       * Returns a copy of the sigil type symbol lineage for this instance's constructor.
+       *
+       * @returns readonly array of symbols representing the type lineage.
+       */
+      getSigilTypeLineage() {
+        var _a;
+        const ctor = getConstructor(this);
+        if (!ctor) {
+          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          return [/* @__PURE__ */ Symbol.for("@Sigil.unknown")];
+        }
+        return ctor.SigilTypeLineage;
+      }
+      /**
+       * Returns a readonly copy of the sigil type symbol set for this instance's constructor.
+       *
+       * @returns A Readonly Set of symbols representing the type lineage for O(1) membership tests.
+       */
+      getSigilTypeSet() {
+        var _a;
+        const ctor = getConstructor(this);
+        if (!ctor) {
+          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
+          return /* @__PURE__ */ new Set([/* @__PURE__ */ Symbol.for("@Sigil.unknown")]);
+        }
+        return ctor.SigilTypeSet;
+      }
+    }
+    decorateCtor(Sigilified, l, opts, true);
+    markSigil(Sigilified);
+    markSigilBase(Sigilified);
+    return Sigilified;
+  }
+  function SigilifyAbstract(Base, label, opts) {
+    if (isSigilCtor(Base)) throw new Error(`[Sigil Error] 'Sigilify(${label})' already siglified.`);
+    let l;
+    if (label) {
+      verifyLabel(label, opts);
+      l = label;
+    } else l = generateRandomLabel();
+    class Sigilified extends Base {
+      /**
+       * Class-level human-readable label constant for this sigil constructor.
+       */
+      static get SigilLabel() {
+        return this[__LABEL__];
+      }
+      /**
+       * Class-level unique runtime symbol used as the type identifier.
+       *
+       * This symbol is created with `Symbol.for(label)` during decoration so it is
+       * stable across realms that share the same global symbol registry.
+       */
+      static get SigilType() {
+        return this[__TYPE__];
+      }
+      /**
+       * Copy of the linearized sigil type symbol chain for the current constructor.
+       *
+       * Useful for debugging and performing strict lineage comparisons.
+       *
+       * @returns An array of symbols representing parent → child type symbols.
+       */
+      static get SigilTypeLineage() {
+        var _a;
+        return [...(_a = this[__TYPE_LINEAGE__]) != null ? _a : []];
+      }
+      /**
+       * Copy of the sigil type symbol set for the current constructor.
+       *
+       * Useful for quick membership checks (O(1) lookups) and debugging.
+       *
+       * @returns A Readonly Set of symbols that represent the type lineage.
+       */
+      static get SigilTypeSet() {
+        const set = /* @__PURE__ */ new Set();
+        for (const s of this[__TYPE_SET__]) set.add(s);
+        return set;
+      }
+      constructor(...args) {
+        var _a;
+        super(...args);
+        if (Object.getPrototypeOf(this) !== new.target.prototype)
+          Object.setPrototypeOf(this, new.target.prototype);
+        const ctor = getConstructor(this);
+        if (!ctor) {
+          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return;
         }
         checkInheritance(ctor);
@@ -508,11 +701,11 @@
        * @returns `true` if `other` is an instance of this type or a subtype.
        */
       static isOfType(other) {
-        if (!isSigilInstance(other)) return false;
-        const otherCtor = getConstructor(other);
-        if (!otherCtor) return false;
-        const otherSet = otherCtor[__TYPE_SET__];
-        return !!otherSet && otherSet.has(this.SigilType);
+        var _a;
+        if (!isSigilInstance(other) || !isSigilCtor(this)) return false;
+        const otherSet = (_a = getConstructor(other)) == null ? void 0 : _a[__TYPE_SET__];
+        const thisType = this[__TYPE__];
+        return !!otherSet && otherSet.has(thisType);
       }
       /**
        * Strict lineage check: compares the type symbol lineage arrays element-by-element.
@@ -527,13 +720,46 @@
        * @returns `true` if `other` has an identical lineage up to the length of this constructor's lineage.
        */
       static isOfTypeStrict(other) {
-        if (!isSigilInstance(other)) return false;
-        const otherCtor = getConstructor(other);
-        if (!otherCtor) return false;
-        const otherLineage = otherCtor[__TYPE_LINEAGE__];
+        var _a;
+        if (!isSigilInstance(other) || !isSigilCtor(this)) return false;
+        const otherLineage = (_a = getConstructor(other)) == null ? void 0 : _a[__TYPE_LINEAGE__];
         const thisLineage = this[__TYPE_LINEAGE__];
         return !!otherLineage && thisLineage.every((s, i) => s === otherLineage[i]);
       }
+      /**
+       * Check whether `other` is (or inherits from) the type instance.
+       *
+       * Allows 'instanceof' like checks but in instances.
+       *
+       * @typeParam T - The instance type.
+       * @param this - The instance performing the check.
+       * @param other - The object to test.
+       * @returns `true` if `other` is the same instance of this type or a subtype.
+       */
+      isOfType(other) {
+        var _a;
+        if (!isSigilInstance(other) || !isSigilInstance(this)) return false;
+        const otherSet = (_a = getConstructor(other)) == null ? void 0 : _a[__TYPE_SET__];
+        const thisType = getConstructor(this)[__TYPE__];
+        return !!otherSet && otherSet.has(thisType);
+      }
+      /**
+       * Strict lineage check: compares the type symbol lineage arrays element-by-element.
+       *
+       * Allows 'instanceof' like checks but in instances.
+       *
+       * @typeParam T - The instance type.
+       * @param this - The instance performing the check.
+       * @param other - The object to test.
+       * @returns `true` if `other` has an identical lineage up to the length of this instance's lineage.
+       */
+      isOfTypeStrict(other) {
+        var _a, _b;
+        if (!isSigilInstance(other) || !isSigilInstance(this)) return false;
+        const otherLineage = (_a = getConstructor(other)) == null ? void 0 : _a[__TYPE_LINEAGE__];
+        const thisLineage = (_b = getConstructor(this)) == null ? void 0 : _b[__TYPE_LINEAGE__];
+        return !!otherLineage && thisLineage.every((s, i) => s === otherLineage[i]);
+      }
       /**
        * Returns the human-readable sigil label of this instance's constructor.
        *
@@ -544,9 +770,7 @@
         const ctor = getConstructor(this);
         if (!ctor) {
           if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
-            throw new Error(
-              `[Sigil Error] 'Sigilify(${label})' instance without constructor`
-            );
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return "@Sigil.unknown";
         }
         return ctor.SigilLabel;
@@ -561,9 +785,7 @@
         const ctor = getConstructor(this);
         if (!ctor) {
           if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
-            throw new Error(
-              `[Sigil Error] 'Sigilify(${label})' instance without constructor`
-            );
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return /* @__PURE__ */ Symbol.for("@Sigil.unknown");
         }
         return ctor.SigilType;
@@ -578,9 +800,7 @@
         const ctor = getConstructor(this);
         if (!ctor) {
           if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
-            throw new Error(
-              `[Sigil Error] 'Sigilify(${label})' instance without constructor`
-            );
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return [/* @__PURE__ */ Symbol.for("@Sigil.unknown")];
         }
         return ctor.SigilTypeLineage;
@@ -595,9 +815,7 @@
         const ctor = getConstructor(this);
         if (!ctor) {
           if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
-            throw new Error(
-              `[Sigil Error] 'Sigilify(${label})' instance without constructor`
-            );
+            throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return /* @__PURE__ */ new Set([/* @__PURE__ */ Symbol.for("@Sigil.unknown")]);
         }
         return ctor.SigilTypeSet;
@@ -687,6 +905,7 @@
   exports.SigilError = SigilError;
   exports.SigilRegistry = SigilRegistry;
   exports.Sigilify = Sigilify;
+  exports.SigilifyAbstract = SigilifyAbstract;
   exports.WithSigil = WithSigil;
   exports.getActiveRegistry = getActiveRegistry;
   exports.isDecorated = isDecorated;