@vicin/sigil 1.2.6 → 1.3.0

package/dist/index.js

@@ -132,8 +132,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 });
   }
   /**
@@ -190,9 +189,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.
@@ -253,9 +250,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__");
@@ -421,8 +416,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);
@@ -475,9 +469,208 @@ 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);
+    }
+    /**
+     * 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);
@@ -507,11 +700,11 @@ function Sigilify(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.
@@ -526,13 +719,46 @@ function Sigilify(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.
      *
@@ -543,9 +769,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;
@@ -560,9 +784,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;
@@ -577,9 +799,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;
@@ -594,9 +814,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;
@@ -686,6 +904,7 @@ exports.Sigil = Sigil;
 exports.SigilError = SigilError;
 exports.SigilRegistry = SigilRegistry;
 exports.Sigilify = Sigilify;
+exports.SigilifyAbstract = SigilifyAbstract;
 exports.WithSigil = WithSigil;
 exports.getActiveRegistry = getActiveRegistry;
 exports.isDecorated = isDecorated;