@vicin/sigil 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -2,11 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.0.2] - 2026-02-21
+
+### Changed
+
+- Patched types
+
+## [2.0.1] - 2026-02-21
+
+### Removed
+
+- `updateOptions.devMarker`
+
+### Changed
+
+- Now dev checks are internal only
+
 ## [2.0.0] - 2026-02-20
 
 ### Breaking changes
 
-All `SigilRegistry`options, methods and classes are removed.
+- All `SigilRegistry`options, methods and classes are removed.
 
 ## [1.3.0] - 2026-02-18
 

package/README.md

@@ -407,7 +407,7 @@ class X extends Sigil {
 - `withSigilTyped(Class, label?, opts?)`: like `withSigil` but narrows the TypeScript type to include brands.
 - `isSigilCtor(value)`: `true` if `value` is a `Sigil` constructor.
 - `isSigilInstance(value)`: `true` if `value` is an instance of a `Sigil` constructor.
-- `updateOptions(opts)`: change global runtime options before `Sigil` decoration (e.g., `autofillLabels`, `devMarker`, etc.).
+- `updateOptions(opts)`: change global runtime options before `Sigil` decoration (e.g., `autofillLabels`).
 - `DEFAULT_LABEL_REGEX`: regex that ensures structure of `@scope/package.ClassName` to all labels, it's advised to use it as your `SigilOptions.labelValidation`
 
 ### Instance & static helpers provided by Sigilified constructors
@@ -443,7 +443,6 @@ updateOptions({
   autofillLabels: false, // Automatically label unlabeled subclasses
   skipLabelInheritanceCheck: false, // Bypass dev inheritance checks -- ALMOST NEVER WANT TO SET THIS TO TRUE, Use 'autofillLabels: true' instead.
   labelValidation: null, // Function or regex, Enforce label format
-  devMarker: process.env.NODE_ENV !== 'production', // Toggle dev safeguards
 });
 ```
 

package/dist/index.d.mts

@@ -58,7 +58,7 @@ interface ISigilStatic<L extends string = string, P extends Function = never> {
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isOfType<T extends ISigil>(this: T, other: unknown): other is InstanceType<T>;
+    isOfType<T extends ISigilStatic>(this: T, other: unknown): other is GetInstance<T>;
     /**
      * Strict lineage comparison: verifies that the calling constructor's type
      * lineage (by label) matches the `other`'s lineage element-by-element.
@@ -71,7 +71,7 @@ interface ISigilStatic<L extends string = string, P extends Function = never> {
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance whose lineage matches exactly.
      */
-    isOfTypeStrict<T extends ISigil>(this: T, other: unknown): other is InstanceType<T>;
+    isOfTypeStrict<T extends ISigilStatic>(this: T, other: unknown): other is GetInstance<T>;
 }
 /**
  * Instance-side interface describing properties present on sigil instances.
@@ -99,6 +99,33 @@ interface ISigilInstance<L extends string = string, P extends Function = never>
     getSigilLabelLineage(): readonly string[];
     /** Returns copy of sigil type label set of the class constructor. */
     getSigilLabelSet(): Readonly<Set<string>>;
+    /**
+     * Check whether `other` is (or inherits from) the type represented by the
+     * calling constructor. Uses the other instance's `SigilLabelSet` to check
+     * membership. Works in O(1) and is reliable as long as `OPTIONS.skipLabelInheritanceCheck` is `false`.
+     *
+     * 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<T extends ISigilInstance>(this: T, other: unknown): other is GetInstance<T>;
+    /**
+     * Strict lineage comparison: verifies that the calling constructor's type
+     * lineage (by label) matches the `other`'s lineage element-by-element.
+     *
+     * Works in O(n) where `n` is the lineage length and is useful when order
+     * and exact ancestry must be confirmed. reliable when `OPTIONS.skipLabelInheritanceCheck` is `false`.
+     *
+     * @typeParam T - The specific sigil constructor (`this`).
+     * @param this - The constructor performing the strict check.
+     * @param other - The object to test.
+     * @returns A type guard asserting `other` is an instance whose lineage matches exactly.
+     */
+    isOfTypeStrict<T extends ISigilInstance>(this: T, other: unknown): other is GetInstance<T>;
 }
 /**
  * Combined constructor + static interface for a sigil class.
@@ -218,7 +245,7 @@ declare const Sigil: {
 } & {
     new (): {};
 };
-type Sigil = InstanceType<typeof Sigil>;
+type Sigil = GetInstance<typeof Sigil>;
 /**
  * A sigil variant of the built-in `Error` constructor used by the library
  * to represent Sigil-specific errors.
@@ -249,7 +276,7 @@ declare const SigilError: {
     isOfType<T>(this: T, other: unknown): other is GetInstance<T>;
     isOfTypeStrict<T>(this: T, other: unknown): other is GetInstance<T>;
 } & ErrorConstructor;
-type SigilError = InstanceType<typeof SigilError>;
+type SigilError = GetInstance<typeof SigilError>;
 
 /**
  * Configuration options for the Sigil library.
@@ -290,12 +317,6 @@ interface SigilOptions {
      * will be assigned an autogenerated random label (so that explicit labels stay unique).
      */
     autofillLabels?: boolean;
-    /**
-     * Marker used internally to control dev only checks to optimize performace while preserving
-     * consistency for things like inheritance checks.
-     * defaults to 'process.env.NODE_ENV !== "production'.
-     */
-    devMarker?: boolean;
 }
 /**
  * Update runtime options for the Sigil library.
@@ -400,7 +421,7 @@ declare function isSigilCtor(ctor: unknown): ctor is ISigil;
  * @param inst - The instanca to test.
  * @returns `true` if `obj` is an instance produced by a sigil constructor.
  */
-declare function isSigilInstance(inst: unknown): inst is InstanceType<ISigil>;
+declare function isSigilInstance(inst: unknown): inst is GetInstance<ISigil>;
 /**
  * Check whether the provided constructor was marked as a sigil base constructor.
  *
@@ -418,7 +439,7 @@ declare function isSigilBaseCtor(ctor: Function): ctor is ISigil;
  * @param inst - The instance to test.
  * @returns `true` if `inst` is an instance of a sigil base constructor.
  */
-declare function isSigilBaseInstance(inst: unknown): inst is InstanceType<ISigil>;
+declare function isSigilBaseInstance(inst: unknown): inst is GetInstance<ISigil>;
 /**
  * Returns whether the constructor has been explicitly decorated with `WithSigil`.
  *

package/dist/index.d.ts

@@ -58,7 +58,7 @@ interface ISigilStatic<L extends string = string, P extends Function = never> {
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isOfType<T extends ISigil>(this: T, other: unknown): other is InstanceType<T>;
+    isOfType<T extends ISigilStatic>(this: T, other: unknown): other is GetInstance<T>;
     /**
      * Strict lineage comparison: verifies that the calling constructor's type
      * lineage (by label) matches the `other`'s lineage element-by-element.
@@ -71,7 +71,7 @@ interface ISigilStatic<L extends string = string, P extends Function = never> {
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance whose lineage matches exactly.
      */
-    isOfTypeStrict<T extends ISigil>(this: T, other: unknown): other is InstanceType<T>;
+    isOfTypeStrict<T extends ISigilStatic>(this: T, other: unknown): other is GetInstance<T>;
 }
 /**
  * Instance-side interface describing properties present on sigil instances.
@@ -99,6 +99,33 @@ interface ISigilInstance<L extends string = string, P extends Function = never>
     getSigilLabelLineage(): readonly string[];
     /** Returns copy of sigil type label set of the class constructor. */
     getSigilLabelSet(): Readonly<Set<string>>;
+    /**
+     * Check whether `other` is (or inherits from) the type represented by the
+     * calling constructor. Uses the other instance's `SigilLabelSet` to check
+     * membership. Works in O(1) and is reliable as long as `OPTIONS.skipLabelInheritanceCheck` is `false`.
+     *
+     * 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<T extends ISigilInstance>(this: T, other: unknown): other is GetInstance<T>;
+    /**
+     * Strict lineage comparison: verifies that the calling constructor's type
+     * lineage (by label) matches the `other`'s lineage element-by-element.
+     *
+     * Works in O(n) where `n` is the lineage length and is useful when order
+     * and exact ancestry must be confirmed. reliable when `OPTIONS.skipLabelInheritanceCheck` is `false`.
+     *
+     * @typeParam T - The specific sigil constructor (`this`).
+     * @param this - The constructor performing the strict check.
+     * @param other - The object to test.
+     * @returns A type guard asserting `other` is an instance whose lineage matches exactly.
+     */
+    isOfTypeStrict<T extends ISigilInstance>(this: T, other: unknown): other is GetInstance<T>;
 }
 /**
  * Combined constructor + static interface for a sigil class.
@@ -218,7 +245,7 @@ declare const Sigil: {
 } & {
     new (): {};
 };
-type Sigil = InstanceType<typeof Sigil>;
+type Sigil = GetInstance<typeof Sigil>;
 /**
  * A sigil variant of the built-in `Error` constructor used by the library
  * to represent Sigil-specific errors.
@@ -249,7 +276,7 @@ declare const SigilError: {
     isOfType<T>(this: T, other: unknown): other is GetInstance<T>;
     isOfTypeStrict<T>(this: T, other: unknown): other is GetInstance<T>;
 } & ErrorConstructor;
-type SigilError = InstanceType<typeof SigilError>;
+type SigilError = GetInstance<typeof SigilError>;
 
 /**
  * Configuration options for the Sigil library.
@@ -290,12 +317,6 @@ interface SigilOptions {
      * will be assigned an autogenerated random label (so that explicit labels stay unique).
      */
     autofillLabels?: boolean;
-    /**
-     * Marker used internally to control dev only checks to optimize performace while preserving
-     * consistency for things like inheritance checks.
-     * defaults to 'process.env.NODE_ENV !== "production'.
-     */
-    devMarker?: boolean;
 }
 /**
  * Update runtime options for the Sigil library.
@@ -400,7 +421,7 @@ declare function isSigilCtor(ctor: unknown): ctor is ISigil;
  * @param inst - The instanca to test.
  * @returns `true` if `obj` is an instance produced by a sigil constructor.
  */
-declare function isSigilInstance(inst: unknown): inst is InstanceType<ISigil>;
+declare function isSigilInstance(inst: unknown): inst is GetInstance<ISigil>;
 /**
  * Check whether the provided constructor was marked as a sigil base constructor.
  *
@@ -418,7 +439,7 @@ declare function isSigilBaseCtor(ctor: Function): ctor is ISigil;
  * @param inst - The instance to test.
  * @returns `true` if `inst` is an instance of a sigil base constructor.
  */
-declare function isSigilBaseInstance(inst: unknown): inst is InstanceType<ISigil>;
+declare function isSigilBaseInstance(inst: unknown): inst is GetInstance<ISigil>;
 /**
  * Returns whether the constructor has been explicitly decorated with `WithSigil`.
  *

package/dist/index.global.js

@@ -9,8 +9,7 @@
   var OPTIONS = {
     labelValidation: null,
     skipLabelInheritanceCheck: false,
-    autofillLabels: false,
-    devMarker: false
+    autofillLabels: false
   };
   var updateOptions = (opts) => {
     for (const [k, v] of Object.entries(opts)) OPTIONS[k] = v;
@@ -18,8 +17,7 @@
   var DEFAULT_OPTIONS = {
     labelValidation: null,
     skipLabelInheritanceCheck: false,
-    autofillLabels: false,
-    devMarker: process.env.NODE_ENV !== "production"
+    autofillLabels: false
   };
   updateOptions(DEFAULT_OPTIONS);
   var DEFAULT_LABEL_REGEX = /^@[\w-]+(?:\/[\w-]+)*\.[A-Z][A-Za-z0-9]*$/;
@@ -1740,6 +1738,9 @@
     };
   }
 
+  // src/core/constants.ts
+  var __DEV__ = typeof process !== "undefined" && process.env.NODE_ENV === "development";
+
   // src/core/helpers.ts
   function decorateCtor(ctor, label, isMixin = false) {
     if (isDecorated(ctor))
@@ -1770,11 +1771,9 @@
     markDecorated(ctor);
   }
   function checkInheritance(ctor, opts) {
-    var _a, _b, _c;
-    const devMarker = (_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker;
-    const skipLabelInheritanceCheck = (_b = opts == null ? void 0 : opts.skipLabelInheritanceCheck) != null ? _b : OPTIONS.skipLabelInheritanceCheck;
-    const autofillLabels = (_c = opts == null ? void 0 : opts.autofillLabels) != null ? _c : OPTIONS.autofillLabels;
-    if (!devMarker) return;
+    var _a, _b;
+    const skipLabelInheritanceCheck = (_a = opts == null ? void 0 : opts.skipLabelInheritanceCheck) != null ? _a : OPTIONS.skipLabelInheritanceCheck;
+    const autofillLabels = (_b = opts == null ? void 0 : opts.autofillLabels) != null ? _b : OPTIONS.autofillLabels;
     if (!isSigilCtor(ctor)) return;
     if (isInheritanceChecked(ctor) || skipLabelInheritanceCheck) return;
     const ctors = [ctor];
@@ -1918,17 +1917,16 @@
         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)
+          if (__DEV__)
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return;
         }
-        checkInheritance(ctor);
+        if (__DEV__) checkInheritance(ctor);
       }
       /**
        * Runtime predicate indicating whether `obj` is an instance produced by a sigil class.
@@ -2012,10 +2010,9 @@
        * @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)
+          if (__DEV__)
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return "@Sigil.unknown";
         }
@@ -2027,10 +2024,9 @@
        * @returns readonly array of labels representing the type lineage.
        */
       getSigilLabelLineage() {
-        var _a;
         const ctor = getConstructor(this);
         if (!ctor) {
-          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+          if (__DEV__)
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return ["@Sigil.unknown"];
         }
@@ -2042,10 +2038,9 @@
        * @returns A Readonly Set of labels representing the type lineage for O(1) membership tests.
        */
       getSigilLabelSet() {
-        var _a;
         const ctor = getConstructor(this);
         if (!ctor) {
-          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+          if (__DEV__)
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return /* @__PURE__ */ new Set(["@Sigil.unknown"]);
         }
@@ -2095,17 +2090,16 @@
         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)
+          if (__DEV__)
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return;
         }
-        checkInheritance(ctor);
+        if (__DEV__) checkInheritance(ctor);
       }
       /**
        * Runtime predicate indicating whether `obj` is an instance produced by a sigil class.
@@ -2197,10 +2191,9 @@
        * @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)
+          if (__DEV__)
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return "@Sigil.unknown";
         }
@@ -2212,10 +2205,9 @@
        * @returns readonly array of labels representing the type lineage.
        */
       getSigilLabelLineage() {
-        var _a;
         const ctor = getConstructor(this);
         if (!ctor) {
-          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+          if (__DEV__)
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return ["@Sigil.unknown"];
         }
@@ -2227,10 +2219,9 @@
        * @returns A Readonly Set of labels representing the type lineage for O(1) membership tests.
        */
       getSigilLabelSet() {
-        var _a;
         const ctor = getConstructor(this);
         if (!ctor) {
-          if ((_a = opts == null ? void 0 : opts.devMarker) != null ? _a : OPTIONS.devMarker)
+          if (__DEV__)
             throw new Error(`[Sigil Error] 'Sigilify(${label})' instance without constructor`);
           return /* @__PURE__ */ new Set(["@Sigil.unknown"]);
         }
@@ -2262,7 +2253,7 @@
           `[Sigil Error] 'WithSigil' decorator accept only Sigil classes but used on class ${value.name}`
         );
       decorateCtor(value, l);
-      checkInheritance(value, opts);
+      if (__DEV__) checkInheritance(value, opts);
     };
   }
 
@@ -2280,7 +2271,7 @@
     } else l = generateRandomLabel();
     const ctor = Class;
     decorateCtor(ctor, l);
-    checkInheritance(ctor, opts);
+    if (__DEV__) checkInheritance(ctor, opts);
     return Class;
   }
   function withSigilTyped(Class, label, opts) {
@@ -2296,7 +2287,7 @@
     } else l = generateRandomLabel();
     const ctor = Class;
     decorateCtor(ctor, l);
-    checkInheritance(ctor, opts);
+    if (__DEV__) checkInheritance(ctor, opts);
     return Class;
   }
   /*! Bundled license information: