@vicin/sigil 1.2.7 → 1.3.0

package/dist/index.mjs

@@ -130,8 +130,7 @@ var SigilRegistry = class _SigilRegistry {
    * @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 });
   }
   /**
@@ -188,9 +187,7 @@ var SigilRegistry = class _SigilRegistry {
    * @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.
@@ -251,9 +248,7 @@ updateOptions(DEFAULT_OPTIONS);
 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__");
@@ -419,8 +414,7 @@ function generateRandomString(length = 16) {
 
 // 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);
@@ -473,9 +467,7 @@ function Sigilify(Base, label, opts) {
       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);
@@ -492,10 +484,6 @@ function Sigilify(Base, label, opts) {
     /**
      * Check whether `other` is (or inherits from) the type represented by the calling constructor.
      *
-     * Implementation detail:
-     * - Uses the other instance's `__TYPE_SET__` for O(1) membership test.
-     * - O(1) and reliable as long as `OPTIONS.skipLabelInheritanceCheck` is `false`.
-     *
      * This replaces `instanceof` so that checks remain valid across bundles/realms
      * and when subclassing.
      *
@@ -505,32 +493,61 @@ function Sigilify(Base, label, opts) {
      * @returns `true` if `other` is an instance of this type or a subtype.
      */
     static isOfType(other) {
+      var _a;
       if (!isSigilInstance(other)) return false;
-      const otherCtor = getConstructor(other);
-      if (!otherCtor) return false;
-      const otherSet = otherCtor[__TYPE_SET__];
-      return !!otherSet && otherSet.has(this.SigilType);
+      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.
      *
-     * Implementation detail:
-     * - Works in O(n) time where n is the depth of the lineage.
-     * - Reliable when `OPTIONS.skipLabelInheritanceCheck` is `false`.
-     *
      * @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 otherCtor = getConstructor(other);
-      if (!otherCtor) return false;
-      const otherLineage = otherCtor[__TYPE_LINEAGE__];
+      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.
      *
@@ -541,9 +558,7 @@ function Sigilify(Base, label, opts) {
       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;
@@ -558,9 +573,7 @@ function Sigilify(Base, label, opts) {
       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;
@@ -575,9 +588,7 @@ function Sigilify(Base, label, opts) {
       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;
@@ -592,9 +603,7 @@ function Sigilify(Base, label, opts) {
       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;
@@ -606,8 +615,7 @@ function Sigilify(Base, label, opts) {
   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 siglified.`);
   let l;
   if (label) {
     verifyLabel(label, opts);
@@ -660,9 +668,7 @@ function SigilifyAbstract(Base, label, opts) {
       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);
@@ -692,11 +698,11 @@ function SigilifyAbstract(Base, label, opts) {
      * @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.
@@ -711,13 +717,46 @@ function SigilifyAbstract(Base, label, opts) {
      * @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.
      *
@@ -728,9 +767,7 @@ function SigilifyAbstract(Base, label, opts) {
       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;
@@ -745,9 +782,7 @@ function SigilifyAbstract(Base, label, opts) {
       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;
@@ -762,9 +797,7 @@ function SigilifyAbstract(Base, label, opts) {
       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;
@@ -779,9 +812,7 @@ function SigilifyAbstract(Base, label, opts) {
       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;