@vicin/sigil 3.2.1 → 3.4.0

package/dist/index.d.mts

@@ -18,11 +18,11 @@ declare const sigil: unique symbol;
  * @template L - Narrow string literal type representing the label.
  * @template P - Optinal parent to extend its '[sigil]'.
  */
-interface ISigilStatic<L extends string = string> {
+interface ISigilStatic {
     /** Class-level label constant (identity). */
-    readonly SigilLabel: L;
+    readonly SigilLabel: string;
     /** Class-level label constant (human readable). */
-    readonly SigilEffectiveLabel: L;
+    readonly SigilEffectiveLabel: string;
     /**
      * Copy of the linearized sigil type label chain for the current constructor.
      * Useful for debugging.
@@ -109,7 +109,7 @@ interface ISigilInstance<L extends string = string, P extends Function = never>
  * @template L - Narrow string literal type for the label.
  * @template P - Optinal parent to extend its '[sigil]'.
  */
-type ISigil<L extends string = string, P extends Function = never> = ConstructorAbstract<ISigilInstance<L, P>> & ISigilStatic<L>;
+type ISigil<L extends string = string, P extends Function = never> = ISigilStatic & ConstructorAbstract<ISigilInstance<L, P>>;
 /** Update '[sigil]' field for nominal typing */
 type ExtendSigil<L extends string, P extends ISigilInstance> = Prettify<IfNever<SigilOf<P>, {}> & {
     [K in L]: true;
@@ -169,8 +169,8 @@ type GetPrototype<T> = T extends {
  */
 declare const Sigil: {
     new (...args: any[]): {
-        isOfType<T extends ISigilInstance>(this: T, other: unknown): other is T;
-        isExactType<T extends ISigilInstance>(this: T, other: unknown): other is T;
+        isOfType<T>(this: T, other: unknown): other is T;
+        isExactType<T>(this: T, other: unknown): other is T;
         getSigilLabel(): string;
         getSigilEffectiveLabel(): string;
         getSigilLabelLineage(): readonly string[];
@@ -179,14 +179,12 @@ declare const Sigil: {
             Sigil: true;
         };
     };
-    get SigilLabel(): "Sigil";
-    get SigilEffectiveLabel(): "Sigil";
+    get SigilLabel(): string;
+    get SigilEffectiveLabel(): string;
     get SigilLabelLineage(): readonly string[];
     get SigilLabelSet(): Readonly<Set<string>>;
-    isOfType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-    isExactType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-} & {
-    new (): {};
+    isOfType<T>(this: T, other: unknown): other is GetPrototype<T>;
+    isExactType<T>(this: T, other: unknown): other is GetPrototype<T>;
 };
 type Sigil = InstanceType<typeof Sigil>;
 /**
@@ -198,24 +196,24 @@ type Sigil = InstanceType<typeof Sigil>;
  */
 declare const SigilError: {
     new (...args: any[]): {
-        isOfType<T extends ISigilInstance>(this: T, other: unknown): other is T;
-        isExactType<T extends ISigilInstance>(this: T, other: unknown): other is T;
+        [sigil]: {
+            Sigil: true;
+            SigilError: true;
+        };
+        isOfType<T>(this: T, other: unknown): other is T;
+        isExactType<T>(this: T, other: unknown): other is T;
         getSigilLabel(): string;
         getSigilEffectiveLabel(): string;
         getSigilLabelLineage(): readonly string[];
         getSigilLabelSet(): Readonly<Set<string>>;
-        readonly [sigil]: {
-            Sigil: true;
-            SigilError: true;
-        };
     };
-    get SigilLabel(): "SigilError";
-    get SigilEffectiveLabel(): "SigilError";
+    get SigilLabel(): string;
+    get SigilEffectiveLabel(): string;
     get SigilLabelLineage(): readonly string[];
     get SigilLabelSet(): Readonly<Set<string>>;
-    isOfType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-    isExactType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-} & ErrorConstructor;
+    isOfType<T>(this: T, other: unknown): other is GetPrototype<T>;
+    isExactType<T>(this: T, other: unknown): other is GetPrototype<T>;
+};
 type SigilError = InstanceType<typeof SigilError>;
 
 /** -----------------------------------------
@@ -242,6 +240,13 @@ interface SigilOptions {
      * will be assigned an autogenerated random label (so that explicit labels stay unique).
      */
     autofillLabels?: boolean;
+    /**
+     * Option for Hot module reload set-ups, reload of files can result in class redefinition which will throw
+     * duplicate label error, setting this to 'true' will disabel this error.
+     * However as it disables unique label check bugs can appear if the same label is passed to two different
+     * classes so set this to 'true' only when needed and ensure uniqueness of passed labels.
+     */
+    skipLabelUniquenessCheck?: boolean;
 }
 /** -----------------------------------------
  *  Update options
@@ -274,11 +279,14 @@ declare const DEFAULT_LABEL_REGEX: RegExp;
  * @param opts - Options object to override any global options if needed.
  * @returns A class decorator compatible with the ECMAScript decorator context.
  */
-declare function WithSigil(label: string, opts?: SigilOptions): (value: Function, context: any) => void;
-
+declare function AttachSigil(label: string, opts?: SigilOptions): (value: Function, context: any) => void;
 /**
- * HOF (class inhancer) that attaches runtime sigil metadata to Sigil class.
- * Alternative to '@WithSigil' if you prefer HOFs.
+ * @deprecated Use 'AttachSigil' instead, updated for clarity. will be removed in v4
+ */
+declare const WithSigil: typeof AttachSigil;
+/**
+ * Function that attaches runtime sigil metadata to Sigil class.
+ * Alternative to '@AttachSigil' if you prefer normal functions.
  *
  * @typeParam S - Constructor type (should be an instance of sigil class).
  * @param Class - The constructor (class) to enhance.
@@ -286,7 +294,11 @@ declare function WithSigil(label: string, opts?: SigilOptions): (value: Function
  * @param opts - Options object to override any global options if needed.
  * @returns The same constructor value, with runtime metadata ensured.
  */
-declare function withSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S;
+declare function attachSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S;
+/**
+ * @deprecated Use 'attachSigil' instead, updated for clarity. will be removed in v4
+ */
+declare const withSigil: typeof attachSigil;
 
 /** -----------------------------------------
  *  Inspection helpers
@@ -308,11 +320,9 @@ declare function isSigilCtor(ctor: unknown): ctor is ISigil;
 declare function isSigilInstance(inst: unknown): inst is ISigilInstance;
 /**
  * Helper function to get labels registered by 'Sigil'
- *
- * @param includeAuto - Flag to include auto-generated labels as well, default is 'false'.
  * @returns Sigil labels registered
  */
-declare function getSigilLabels(includeAuto?: boolean): string[];
+declare function getSigilLabels(): string[];
 
 /**
  * Mixin factory that augments an existing class with Sigil runtime metadata and helpers.
@@ -323,8 +333,11 @@ declare function getSigilLabels(includeAuto?: boolean): string[];
  * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.
  * @throws Error if `Base` is already sigilified.
  */
-declare function Sigilify<B extends Constructor, L extends string>(Base: B, label: L, opts?: SigilOptions): {
+declare function Sigilify<L extends string>(Base: Constructor, label: L, opts?: SigilOptions): {
     new (...args: any[]): {
+        [sigil]: {
+            Sigil: true;
+        } & { [K_1 in L]: true; } extends infer T ? { [K in keyof T]: T[K]; } : never;
         /**
          * Check whether `other` is (or inherits from) the instance represented by the
          * calling constructor.
@@ -337,7 +350,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
          * @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 T;
+        isOfType<T_1>(this: T_1, other: unknown): other is T_1;
         /**
          * Check whether `other` is exactly the same instance represented by the
          * calling constructor.
@@ -347,7 +360,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
          * @param other - The object to test.
          * @returns A type guard asserting `other` is an instance of the constructor.
          */
-        isExactType<T extends ISigilInstance>(this: T, other: unknown): other is T;
+        isExactType<T_1>(this: T_1, other: unknown): other is T_1;
         /**
          * Returns the identity sigil label of this instance's constructor.
          *
@@ -369,24 +382,19 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
         /**
          * Returns a copy of the sigil type label lineage set for this instance's constructor.
          *
+         * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
          * @returns readonly array of labels representing the type lineage.
          */
         getSigilLabelSet(): Readonly<Set<string>>;
-        /**
-         * Compile-time nominal brand that encodes the class sigil labels object.
-         */
-        readonly [sigil]: {
-            Sigil: true;
-        } & { [K_1 in L]: true; } extends infer T ? { [K in keyof T]: T[K]; } : never;
     };
     /**
      * Class-level identity label constant for this sigil constructor.
      */
-    get SigilLabel(): L;
+    get SigilLabel(): string;
     /**
      * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
      */
-    get SigilEffectiveLabel(): L;
+    get SigilEffectiveLabel(): string;
     /**
      * Linearized sigil type label chain for the current constructor.
      *
@@ -399,6 +407,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
      * Sigil type label set for the current constructor.
      * Useful for debugging.
      *
+     * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
      * @returns A Readonly Set of labels that represent the type lineage.
      */
     get SigilLabelSet(): Readonly<Set<string>>;
@@ -414,7 +423,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isOfType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
+    isOfType<T>(this: T, other: unknown): other is GetPrototype<T>;
     /**
      * Check whether `other` is exactly the same instance represented by the
      * calling constructor.
@@ -424,8 +433,8 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isExactType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-} & B;
+    isExactType<T>(this: T, other: unknown): other is GetPrototype<T>;
+};
 /**
  * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.
  *
@@ -435,7 +444,10 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
  * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.
  * @throws Error if `Base` is already sigilified.
  */
-declare function SigilifyAbstract<B extends ConstructorAbstract, L extends string>(Base: B, label: L, opts?: SigilOptions): ((abstract new (...args: any[]) => {
+declare function SigilifyAbstract<L extends string>(Base: ConstructorAbstract, label: L, opts?: SigilOptions): (abstract new (...args: any[]) => {
+    [sigil]: {
+        Sigil: true;
+    } & { [K_1 in L]: true; } extends infer T ? { [K in keyof T]: T[K]; } : never;
     /**
      * Check whether `other` is (or inherits from) the instance represented by the
      * calling constructor.
@@ -448,7 +460,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isOfType<T>(this: T, other: unknown): other is T;
+    isOfType<T_1>(this: T_1, other: unknown): other is T_1;
     /**
      * Check whether `other` is exactly the same instance represented by the
      * calling constructor.
@@ -458,7 +470,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isExactType<T>(this: T, other: unknown): other is T;
+    isExactType<T_1>(this: T_1, other: unknown): other is T_1;
     /**
      * Returns the identity sigil label of this instance's constructor.
      *
@@ -480,24 +492,19 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
     /**
      * Returns a copy of the sigil type label lineage set for this instance's constructor.
      *
+     * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
      * @returns readonly array of labels representing the type lineage.
      */
     getSigilLabelSet(): Readonly<Set<string>>;
-    /**
-     * Compile-time nominal brand that encodes the class sigil labels object.
-     */
-    readonly [sigil]: {
-        Sigil: true;
-    } & { [K_1 in L]: true; } extends infer T ? { [K in keyof T]: T[K]; } : never;
 }) & {
     /**
      * Class-level identity label constant for this sigil constructor.
      */
-    get SigilLabel(): L;
+    get SigilLabel(): string;
     /**
      * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
      */
-    get SigilEffectiveLabel(): L;
+    get SigilEffectiveLabel(): string;
     /**
      * Linearized sigil type label chain for the current constructor.
      *
@@ -510,6 +517,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * Sigil type label set for the current constructor.
      * Useful for debugging.
      *
+     * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
      * @returns A Readonly Set of labels that represent the type lineage.
      */
     get SigilLabelSet(): Readonly<Set<string>>;
@@ -536,6 +544,6 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
     isExactType<T>(this: T, other: unknown): other is GetPrototype<T>;
-}) & B;
+};
 
-export { DEFAULT_LABEL_REGEX, type ExtendSigil, type GetPrototype, type ISigil, type ISigilInstance, type ISigilStatic, RECOMMENDED_LABEL_REGEX, Sigil, SigilError, type SigilOf, type SigilOptions, Sigilify, SigilifyAbstract, WithSigil, getSigilLabels, isSigilCtor, isSigilInstance, sigil, updateSigilOptions, withSigil };
+export { AttachSigil, DEFAULT_LABEL_REGEX, type ExtendSigil, type GetPrototype, type ISigil, type ISigilInstance, type ISigilStatic, RECOMMENDED_LABEL_REGEX, Sigil, SigilError, type SigilOf, type SigilOptions, Sigilify, SigilifyAbstract, WithSigil, attachSigil, getSigilLabels, isSigilCtor, isSigilInstance, sigil, updateSigilOptions, withSigil };

package/dist/index.d.ts

@@ -18,11 +18,11 @@ declare const sigil: unique symbol;
  * @template L - Narrow string literal type representing the label.
  * @template P - Optinal parent to extend its '[sigil]'.
  */
-interface ISigilStatic<L extends string = string> {
+interface ISigilStatic {
     /** Class-level label constant (identity). */
-    readonly SigilLabel: L;
+    readonly SigilLabel: string;
     /** Class-level label constant (human readable). */
-    readonly SigilEffectiveLabel: L;
+    readonly SigilEffectiveLabel: string;
     /**
      * Copy of the linearized sigil type label chain for the current constructor.
      * Useful for debugging.
@@ -109,7 +109,7 @@ interface ISigilInstance<L extends string = string, P extends Function = never>
  * @template L - Narrow string literal type for the label.
  * @template P - Optinal parent to extend its '[sigil]'.
  */
-type ISigil<L extends string = string, P extends Function = never> = ConstructorAbstract<ISigilInstance<L, P>> & ISigilStatic<L>;
+type ISigil<L extends string = string, P extends Function = never> = ISigilStatic & ConstructorAbstract<ISigilInstance<L, P>>;
 /** Update '[sigil]' field for nominal typing */
 type ExtendSigil<L extends string, P extends ISigilInstance> = Prettify<IfNever<SigilOf<P>, {}> & {
     [K in L]: true;
@@ -169,8 +169,8 @@ type GetPrototype<T> = T extends {
  */
 declare const Sigil: {
     new (...args: any[]): {
-        isOfType<T extends ISigilInstance>(this: T, other: unknown): other is T;
-        isExactType<T extends ISigilInstance>(this: T, other: unknown): other is T;
+        isOfType<T>(this: T, other: unknown): other is T;
+        isExactType<T>(this: T, other: unknown): other is T;
         getSigilLabel(): string;
         getSigilEffectiveLabel(): string;
         getSigilLabelLineage(): readonly string[];
@@ -179,14 +179,12 @@ declare const Sigil: {
             Sigil: true;
         };
     };
-    get SigilLabel(): "Sigil";
-    get SigilEffectiveLabel(): "Sigil";
+    get SigilLabel(): string;
+    get SigilEffectiveLabel(): string;
     get SigilLabelLineage(): readonly string[];
     get SigilLabelSet(): Readonly<Set<string>>;
-    isOfType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-    isExactType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-} & {
-    new (): {};
+    isOfType<T>(this: T, other: unknown): other is GetPrototype<T>;
+    isExactType<T>(this: T, other: unknown): other is GetPrototype<T>;
 };
 type Sigil = InstanceType<typeof Sigil>;
 /**
@@ -198,24 +196,24 @@ type Sigil = InstanceType<typeof Sigil>;
  */
 declare const SigilError: {
     new (...args: any[]): {
-        isOfType<T extends ISigilInstance>(this: T, other: unknown): other is T;
-        isExactType<T extends ISigilInstance>(this: T, other: unknown): other is T;
+        [sigil]: {
+            Sigil: true;
+            SigilError: true;
+        };
+        isOfType<T>(this: T, other: unknown): other is T;
+        isExactType<T>(this: T, other: unknown): other is T;
         getSigilLabel(): string;
         getSigilEffectiveLabel(): string;
         getSigilLabelLineage(): readonly string[];
         getSigilLabelSet(): Readonly<Set<string>>;
-        readonly [sigil]: {
-            Sigil: true;
-            SigilError: true;
-        };
     };
-    get SigilLabel(): "SigilError";
-    get SigilEffectiveLabel(): "SigilError";
+    get SigilLabel(): string;
+    get SigilEffectiveLabel(): string;
     get SigilLabelLineage(): readonly string[];
     get SigilLabelSet(): Readonly<Set<string>>;
-    isOfType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-    isExactType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-} & ErrorConstructor;
+    isOfType<T>(this: T, other: unknown): other is GetPrototype<T>;
+    isExactType<T>(this: T, other: unknown): other is GetPrototype<T>;
+};
 type SigilError = InstanceType<typeof SigilError>;
 
 /** -----------------------------------------
@@ -242,6 +240,13 @@ interface SigilOptions {
      * will be assigned an autogenerated random label (so that explicit labels stay unique).
      */
     autofillLabels?: boolean;
+    /**
+     * Option for Hot module reload set-ups, reload of files can result in class redefinition which will throw
+     * duplicate label error, setting this to 'true' will disabel this error.
+     * However as it disables unique label check bugs can appear if the same label is passed to two different
+     * classes so set this to 'true' only when needed and ensure uniqueness of passed labels.
+     */
+    skipLabelUniquenessCheck?: boolean;
 }
 /** -----------------------------------------
  *  Update options
@@ -274,11 +279,14 @@ declare const DEFAULT_LABEL_REGEX: RegExp;
  * @param opts - Options object to override any global options if needed.
  * @returns A class decorator compatible with the ECMAScript decorator context.
  */
-declare function WithSigil(label: string, opts?: SigilOptions): (value: Function, context: any) => void;
-
+declare function AttachSigil(label: string, opts?: SigilOptions): (value: Function, context: any) => void;
 /**
- * HOF (class inhancer) that attaches runtime sigil metadata to Sigil class.
- * Alternative to '@WithSigil' if you prefer HOFs.
+ * @deprecated Use 'AttachSigil' instead, updated for clarity. will be removed in v4
+ */
+declare const WithSigil: typeof AttachSigil;
+/**
+ * Function that attaches runtime sigil metadata to Sigil class.
+ * Alternative to '@AttachSigil' if you prefer normal functions.
  *
  * @typeParam S - Constructor type (should be an instance of sigil class).
  * @param Class - The constructor (class) to enhance.
@@ -286,7 +294,11 @@ declare function WithSigil(label: string, opts?: SigilOptions): (value: Function
  * @param opts - Options object to override any global options if needed.
  * @returns The same constructor value, with runtime metadata ensured.
  */
-declare function withSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S;
+declare function attachSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S;
+/**
+ * @deprecated Use 'attachSigil' instead, updated for clarity. will be removed in v4
+ */
+declare const withSigil: typeof attachSigil;
 
 /** -----------------------------------------
  *  Inspection helpers
@@ -308,11 +320,9 @@ declare function isSigilCtor(ctor: unknown): ctor is ISigil;
 declare function isSigilInstance(inst: unknown): inst is ISigilInstance;
 /**
  * Helper function to get labels registered by 'Sigil'
- *
- * @param includeAuto - Flag to include auto-generated labels as well, default is 'false'.
  * @returns Sigil labels registered
  */
-declare function getSigilLabels(includeAuto?: boolean): string[];
+declare function getSigilLabels(): string[];
 
 /**
  * Mixin factory that augments an existing class with Sigil runtime metadata and helpers.
@@ -323,8 +333,11 @@ declare function getSigilLabels(includeAuto?: boolean): string[];
  * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.
  * @throws Error if `Base` is already sigilified.
  */
-declare function Sigilify<B extends Constructor, L extends string>(Base: B, label: L, opts?: SigilOptions): {
+declare function Sigilify<L extends string>(Base: Constructor, label: L, opts?: SigilOptions): {
     new (...args: any[]): {
+        [sigil]: {
+            Sigil: true;
+        } & { [K_1 in L]: true; } extends infer T ? { [K in keyof T]: T[K]; } : never;
         /**
          * Check whether `other` is (or inherits from) the instance represented by the
          * calling constructor.
@@ -337,7 +350,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
          * @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 T;
+        isOfType<T_1>(this: T_1, other: unknown): other is T_1;
         /**
          * Check whether `other` is exactly the same instance represented by the
          * calling constructor.
@@ -347,7 +360,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
          * @param other - The object to test.
          * @returns A type guard asserting `other` is an instance of the constructor.
          */
-        isExactType<T extends ISigilInstance>(this: T, other: unknown): other is T;
+        isExactType<T_1>(this: T_1, other: unknown): other is T_1;
         /**
          * Returns the identity sigil label of this instance's constructor.
          *
@@ -369,24 +382,19 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
         /**
          * Returns a copy of the sigil type label lineage set for this instance's constructor.
          *
+         * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
          * @returns readonly array of labels representing the type lineage.
          */
         getSigilLabelSet(): Readonly<Set<string>>;
-        /**
-         * Compile-time nominal brand that encodes the class sigil labels object.
-         */
-        readonly [sigil]: {
-            Sigil: true;
-        } & { [K_1 in L]: true; } extends infer T ? { [K in keyof T]: T[K]; } : never;
     };
     /**
      * Class-level identity label constant for this sigil constructor.
      */
-    get SigilLabel(): L;
+    get SigilLabel(): string;
     /**
      * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
      */
-    get SigilEffectiveLabel(): L;
+    get SigilEffectiveLabel(): string;
     /**
      * Linearized sigil type label chain for the current constructor.
      *
@@ -399,6 +407,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
      * Sigil type label set for the current constructor.
      * Useful for debugging.
      *
+     * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
      * @returns A Readonly Set of labels that represent the type lineage.
      */
     get SigilLabelSet(): Readonly<Set<string>>;
@@ -414,7 +423,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isOfType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
+    isOfType<T>(this: T, other: unknown): other is GetPrototype<T>;
     /**
      * Check whether `other` is exactly the same instance represented by the
      * calling constructor.
@@ -424,8 +433,8 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isExactType<T extends ISigilStatic>(this: T, other: unknown): other is GetPrototype<T>;
-} & B;
+    isExactType<T>(this: T, other: unknown): other is GetPrototype<T>;
+};
 /**
  * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.
  *
@@ -435,7 +444,10 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
  * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.
  * @throws Error if `Base` is already sigilified.
  */
-declare function SigilifyAbstract<B extends ConstructorAbstract, L extends string>(Base: B, label: L, opts?: SigilOptions): ((abstract new (...args: any[]) => {
+declare function SigilifyAbstract<L extends string>(Base: ConstructorAbstract, label: L, opts?: SigilOptions): (abstract new (...args: any[]) => {
+    [sigil]: {
+        Sigil: true;
+    } & { [K_1 in L]: true; } extends infer T ? { [K in keyof T]: T[K]; } : never;
     /**
      * Check whether `other` is (or inherits from) the instance represented by the
      * calling constructor.
@@ -448,7 +460,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isOfType<T>(this: T, other: unknown): other is T;
+    isOfType<T_1>(this: T_1, other: unknown): other is T_1;
     /**
      * Check whether `other` is exactly the same instance represented by the
      * calling constructor.
@@ -458,7 +470,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * @param other - The object to test.
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
-    isExactType<T>(this: T, other: unknown): other is T;
+    isExactType<T_1>(this: T_1, other: unknown): other is T_1;
     /**
      * Returns the identity sigil label of this instance's constructor.
      *
@@ -480,24 +492,19 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
     /**
      * Returns a copy of the sigil type label lineage set for this instance's constructor.
      *
+     * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
      * @returns readonly array of labels representing the type lineage.
      */
     getSigilLabelSet(): Readonly<Set<string>>;
-    /**
-     * Compile-time nominal brand that encodes the class sigil labels object.
-     */
-    readonly [sigil]: {
-        Sigil: true;
-    } & { [K_1 in L]: true; } extends infer T ? { [K in keyof T]: T[K]; } : never;
 }) & {
     /**
      * Class-level identity label constant for this sigil constructor.
      */
-    get SigilLabel(): L;
+    get SigilLabel(): string;
     /**
      * Class-level human-readable label constant for this sigil constructor, last passed label in 'Sigil' chain by developer.
      */
-    get SigilEffectiveLabel(): L;
+    get SigilEffectiveLabel(): string;
     /**
      * Linearized sigil type label chain for the current constructor.
      *
@@ -510,6 +517,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * Sigil type label set for the current constructor.
      * Useful for debugging.
      *
+     * @deprecated To minize API and bundle size, internally this method is 'new Set(this.SigilLabelLineage)' only. will be removed in v4
      * @returns A Readonly Set of labels that represent the type lineage.
      */
     get SigilLabelSet(): Readonly<Set<string>>;
@@ -536,6 +544,6 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
     isExactType<T>(this: T, other: unknown): other is GetPrototype<T>;
-}) & B;
+};
 
-export { DEFAULT_LABEL_REGEX, type ExtendSigil, type GetPrototype, type ISigil, type ISigilInstance, type ISigilStatic, RECOMMENDED_LABEL_REGEX, Sigil, SigilError, type SigilOf, type SigilOptions, Sigilify, SigilifyAbstract, WithSigil, getSigilLabels, isSigilCtor, isSigilInstance, sigil, updateSigilOptions, withSigil };
+export { AttachSigil, DEFAULT_LABEL_REGEX, type ExtendSigil, type GetPrototype, type ISigil, type ISigilInstance, type ISigilStatic, RECOMMENDED_LABEL_REGEX, Sigil, SigilError, type SigilOf, type SigilOptions, Sigilify, SigilifyAbstract, WithSigil, attachSigil, getSigilLabels, isSigilCtor, isSigilInstance, sigil, updateSigilOptions, withSigil };