@vicin/sigil 4.0.1 → 4.0.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @vicin/sigil
 
+## 4.0.2
+
+### Patch Changes
+
+- a7a5314: fix: type of passed class to 'Sigilify' and 'SigilifyAbstract' is now propegated properly
+
 ## 4.0.1
 
 ### Patch Changes

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/symbols.ts","../src/is.ts","../src/options.ts","../src/registry.ts","../src/sigilify.ts","../src/mixin.ts","../src/classes.ts","../src/attach.ts"],"names":["hasOwnSigil","Sigil"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Symbol to uniquely identify sigil classes.\n *\n * @constant {symbol}\n */\nexport const __SIGIL__ = Symbol.for('@vicin/sigil.__SIGIL__');\n\n/**\n * Symbol to store sigil lineage of a class\n *\n * @constant {symbol}\n */\nexport const __SIGIL_LINEAGE__ = Symbol.for('@vicin/sigil.__SIGIL_LINEAGE__');\n\n/**\n * Symbol used to store the identity label for a sigil constructor.\n *\n * Stored on the constructor as a non-enumerable property.\n *\n * @constant {symbol}\n */\nexport const __LABEL__ = Symbol.for('@vicin/sigil.__LABEL__');\n\n/**\n * Symbol used to store the depth inside Sigil chain. used in exact checks\n *\n * @constant {symbol}\n */\nexport const __DEPTH__ = Symbol.for('@vicin/sigil.__DEPTH__');\n\n/**\n * Symbol of global Sigil registry\n *\n * @constant {symbol}\n */\nexport const __SIGIL_REGISTRY__ = Symbol.for('@vicin/sigil.__SIGIL_REGISTRY__');\n","import type { Sigil } from './classes';\nimport { __SIGIL__ } from './symbols';\n\n/**\n * Runtime predicate that checks whether the provided value is a sigil constructor.\n *\n * @param ctor - Constructor to test.\n * @returns `true` if `value` is a sigil constructor, otherwise `false`.\n */\nexport function isSigilCtor(ctor: unknown): ctor is typeof Sigil {\n  return typeof ctor === 'function' && ctor.prototype && __SIGIL__ in ctor.prototype;\n}\n\n/**\n * Runtime predicate that checks whether the provided object is an instance\n * of a sigil class.\n *\n * @param inst - The instanca to test.\n * @returns `true` if `obj` is an instance produced by a sigil constructor.\n */\nexport function isSigilInstance(inst: unknown): inst is Sigil {\n  return !!inst && typeof inst === 'object' && __SIGIL__ in inst;\n}\n","/** -----------------------------------------\n *  Types\n * ----------------------------------------- */\n\n/**\n * Configuration options for the Sigil library.\n *\n * These options control runtime validation, inheritance checks, label autofill behavior.\n */\nexport interface SigilOptions {\n  /**\n   * Validation rule applied to sigil labels before registration.\n   *\n   * - A function receives the label and must return `true` if valid.\n   * - A `RegExp` must match the label.\n   * - `null` disables validation entirely.\n   *\n   * Defaults to `null`.\n   */\n  labelValidation?: ((label: string) => boolean) | RegExp | null;\n}\n\n/** -----------------------------------------\n *  Internal options object\n * ----------------------------------------- */\n\n/**\n * Defined SigilOptions used in the library.\n *\n * @internal\n */\nexport const OPTIONS: Required<SigilOptions> = {\n  labelValidation: null,\n};\n\n/** -----------------------------------------\n *  Update options\n * ----------------------------------------- */\n\n/**\n * Update runtime options for the Sigil library.\n * Call this early during application startup if you want non-default behavior.\n *\n * @param opts - Partial options to merge into the global `OPTIONS` object.\n */\nexport const updateSigilOptions = ({ labelValidation = null }: SigilOptions = {}): void => {\n  OPTIONS.labelValidation = labelValidation;\n};\n\n/** -----------------------------------------\n *  Label validation\n * ----------------------------------------- */\n\n/**\n * Label validation regex. Labels must follow the pattern\n * `@scope/package.ClassName` where `ClassName` begins with an uppercase\n * letter. This avoids collisions across packages and helps debugging.\n *\n * It's advised to use this regex in 'SigilOptions.labelValidation'.\n */\nexport const RECOMMENDED_LABEL_REGEX = /^@[\\w-]+(?:\\/[\\w-]+)*\\.[A-Z][A-Za-z0-9]*$/;\n","import { __SIGIL_REGISTRY__ } from './symbols';\n\ninterface SigilRegistry {\n  registerResolved: (ctor: Function) => void;\n  checkResolved: (ctor: Function) => boolean;\n  registerHasOwn: (ctor: Function) => void;\n  checkHasOwn: (ctor: Function) => boolean;\n}\n\nexport function getSigilRegistry(): SigilRegistry {\n  if ((globalThis as any)[__SIGIL_REGISTRY__]) return (globalThis as any)[__SIGIL_REGISTRY__];\n\n  /** Weak set to ensure that every ctor is handled only once */\n  const resolved = new WeakSet<Function>();\n\n  /** Weak set to store ctors that called sigilify function */\n  const hasOwnSigil = new WeakSet<Function>();\n\n  /** Registry */\n  const registry: SigilRegistry = {\n    registerResolved(ctor) {\n      resolved.add(ctor);\n    },\n    checkResolved(ctor) {\n      return resolved.has(ctor);\n    },\n    registerHasOwn(ctor) {\n      hasOwnSigil.add(ctor);\n    },\n    checkHasOwn(ctor) {\n      return hasOwnSigil.has(ctor);\n    },\n  };\n\n  // Freeze registy to prevent any mutations\n  Object.freeze(registry);\n  // Append registry into globalThis and make it non-writable\n  Object.defineProperty(globalThis, __SIGIL_REGISTRY__, {\n    value: registry,\n    writable: false,\n    configurable: false,\n    enumerable: false,\n  });\n  // return registry\n  return registry;\n}\n","import { OPTIONS, type SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport { getSigilRegistry } from './registry';\n\n/** -----------------------------------------\n *  Get registry\n * ----------------------------------------- */\n\nconst sigilRegistry = getSigilRegistry();\n\n/** -----------------------------------------\n *  Main helpers\n * ----------------------------------------- */\n\n/** Main function to handle 'Sigil' and attach its metadata to the class when label is passed */\nexport function sigilify(ctor: Function, label: string, opts?: SigilOptions): void {\n  // throw if already seen\n  if (sigilRegistry.checkResolved(ctor))\n    throw new Error(\n      `[Sigil Error] Class '${ctor.name}' with label '${(ctor as any).SigilLabel}' is already sigilified`\n    );\n  // verify label\n  verifyLabel(label, opts);\n  // handle ancestors (add them to seen)\n  handleAncestors(ctor);\n  // sigilify ctor\n  updateSigil(ctor, label);\n  // mark as seen and register in hasOwnSigil set\n  sigilRegistry.registerResolved(ctor);\n  sigilRegistry.registerHasOwn(ctor);\n}\n\nexport function hasOwnSigil(ctor: Function) {\n  return sigilRegistry.checkHasOwn(ctor);\n}\n\n/** -----------------------------------------\n *  Generic helpers\n * ----------------------------------------- */\n\n/** Helper function to validate passed label */\nexport function verifyLabel<L extends string>(label: L, opts?: SigilOptions): void {\n  // If validation regex or function is defined validate\n  const labelValidation = opts?.labelValidation ?? OPTIONS.labelValidation;\n  if (labelValidation) {\n    let valid: boolean;\n    if (labelValidation instanceof RegExp) valid = labelValidation.test(label);\n    else valid = labelValidation(label);\n\n    if (!valid)\n      throw new Error(\n        `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`\n      );\n  }\n}\n\nfunction handleAncestors(ctor: Function) {\n  let a = Object.getPrototypeOf(ctor);\n  while (a && typeof a === 'function' && a.prototype[__SIGIL__]) {\n    sigilRegistry.registerResolved(a);\n    a = Object.getPrototypeOf(a);\n  }\n}\n\nfunction updateSigil(ctor: Function, label: string) {\n  // -------------------------\n  // Get symbol from label\n  // -------------------------\n\n  const sym = Symbol.for(label);\n\n  // -------------------------\n  // Populate 'Sigil' symbols\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, __SIGIL__, {\n    value: sym,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __LABEL__, {\n    value: label,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __SIGIL_LINEAGE__, {\n    value: [...(Object.getPrototypeOf(ctor).prototype[__SIGIL_LINEAGE__] ?? []), sym],\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __DEPTH__, {\n    value: (ctor.prototype[__DEPTH__] ?? -1) + 1,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n\n  // -------------------------\n  // Add { symbol: ture } pair\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, sym, {\n    value: true,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n}\n","import { isSigilCtor } from './is';\nimport { sigilify, hasOwnSigil } from './sigilify';\nimport type { SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport type { Constructor, ConstructorAbstract, GetPrototype, sigil, ExtendSigil } from './types';\n\n/**\n * Helper function to extend Base class with Sigil Class that should be present at the start of each Sigil chain\n * @param Base - The base constructor to extend.\n * @returns Base Sigil class at the start of each Sigil chain\n */\nexport function BaseSigilify(Base: ConstructorAbstract) {\n  class Sigil extends Base {\n    /**\n     * Class-level identity label constant for this sigil constructor.\n     */\n    static get SigilLabel(): string {\n      return (this as any).prototype[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    static get SigilLabelLineage(): readonly string[] {\n      return (this as any).prototype[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    static get hasOwnSigil(): boolean {\n      return hasOwnSigil(this);\n    }\n\n    /**\n     * Compile-time nominal brand that encodes the class sigil labels object.\n     */\n    declare readonly [sigil]: {\n      Sigil: true;\n    };\n\n    constructor(...args: any[]) {\n      super(...args);\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isExactInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any).prototype[__DEPTH__] !== other[__DEPTH__]) return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isExactInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any)[__DEPTH__] !== (other as any)[__DEPTH__]) return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Returns the identity sigil label of this instance's constructor.\n     *\n     * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').\n     */\n    get SigilLabel(): string {\n      return (this as any)[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    get SigilLabelLineage(): readonly string[] {\n      return (this as any)[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    get hasOwnSigil(): boolean {\n      return (this.constructor as unknown as Sigil).hasOwnSigil;\n    }\n  }\n\n  sigilify(Sigil, 'Sigil');\n  return Sigil;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function Sigilify<L extends string>(Base: Constructor, label: L, opts?: SigilOptions) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, InstanceType<typeof BaseSigil>>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function SigilifyAbstract<L extends string>(\n  Base: ConstructorAbstract,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  abstract class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, InstanceType<typeof BaseSigil>>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n","import { Sigilify, BaseSigilify } from './mixin';\nimport type { sigil } from './types';\n\n/**\n * A minimal root Sigil class used by the library as a base identity.\n *\n * This is produced by `Sigilify` and can serve as a basic sentinel/base\n * class for other sigil classes or for debugging/inspection.\n */\nexport const Sigil = BaseSigilify(class {});\nexport type Sigil = InstanceType<typeof Sigil>;\n\n/**\n * A sigil variant of the built-in `Error` constructor used by the library\n * to represent Sigil-specific errors.\n *\n * Use `SigilError` when you want an Error type that is identifiable via sigil\n * runtime checks (e.g. `SigilError.isInstance(someError)`).\n */\nexport const SigilError = Sigilify(Error, 'SigilError');\nexport type SigilError = InstanceType<typeof SigilError>;\n","import { isSigilCtor } from './is';\nimport { sigilify } from './sigilify';\nimport type { SigilOptions } from './options';\n\n/**\n * Class decorator factory that attaches sigil statics to a class constructor.\n *\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns A class decorator compatible with the ECMAScript decorator context.\n */\nexport function AttachSigil(label: string, opts?: SigilOptions) {\n  return function (target: Function, ctx: any) {\n    if (!isSigilCtor(target))\n      throw new Error(\n        `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${target.name}'`\n      );\n\n    sigilify(target, label, opts);\n  };\n}\n\n/**\n * Function that attaches runtime sigil metadata to Sigil class.\n * Alternative to '@AttachSigil' if you prefer normal functions.\n *\n * @typeParam S - Constructor type (should be an instance of sigil class).\n * @param Class - The constructor (class) to enhance.\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns The same constructor value, with runtime metadata ensured.\n */\nexport function attachSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S {\n  if (!isSigilCtor(Class))\n    throw new Error(\n      `[Sigil Error] 'attachSigil' function accept only Sigil classes but used on class '${Class.name}'`\n    );\n\n  sigilify(Class, label, opts);\n  return Class;\n}\n"]}
+{"version":3,"sources":["../src/symbols.ts","../src/is.ts","../src/options.ts","../src/registry.ts","../src/sigilify.ts","../src/mixin.ts","../src/classes.ts","../src/attach.ts"],"names":["hasOwnSigil","Sigil"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Symbol to uniquely identify sigil classes.\n *\n * @constant {symbol}\n */\nexport const __SIGIL__ = Symbol.for('@vicin/sigil.__SIGIL__');\n\n/**\n * Symbol to store sigil lineage of a class\n *\n * @constant {symbol}\n */\nexport const __SIGIL_LINEAGE__ = Symbol.for('@vicin/sigil.__SIGIL_LINEAGE__');\n\n/**\n * Symbol used to store the identity label for a sigil constructor.\n *\n * Stored on the constructor as a non-enumerable property.\n *\n * @constant {symbol}\n */\nexport const __LABEL__ = Symbol.for('@vicin/sigil.__LABEL__');\n\n/**\n * Symbol used to store the depth inside Sigil chain. used in exact checks\n *\n * @constant {symbol}\n */\nexport const __DEPTH__ = Symbol.for('@vicin/sigil.__DEPTH__');\n\n/**\n * Symbol of global Sigil registry\n *\n * @constant {symbol}\n */\nexport const __SIGIL_REGISTRY__ = Symbol.for('@vicin/sigil.__SIGIL_REGISTRY__');\n","import type { Sigil } from './classes';\nimport { __SIGIL__ } from './symbols';\n\n/**\n * Runtime predicate that checks whether the provided value is a sigil constructor.\n *\n * @param ctor - Constructor to test.\n * @returns `true` if `value` is a sigil constructor, otherwise `false`.\n */\nexport function isSigilCtor(ctor: unknown): ctor is typeof Sigil {\n  return typeof ctor === 'function' && ctor.prototype && __SIGIL__ in ctor.prototype;\n}\n\n/**\n * Runtime predicate that checks whether the provided object is an instance\n * of a sigil class.\n *\n * @param inst - The instanca to test.\n * @returns `true` if `obj` is an instance produced by a sigil constructor.\n */\nexport function isSigilInstance(inst: unknown): inst is Sigil {\n  return !!inst && typeof inst === 'object' && __SIGIL__ in inst;\n}\n","/** -----------------------------------------\n *  Types\n * ----------------------------------------- */\n\n/**\n * Configuration options for the Sigil library.\n *\n * These options control runtime validation, inheritance checks, label autofill behavior.\n */\nexport interface SigilOptions {\n  /**\n   * Validation rule applied to sigil labels before registration.\n   *\n   * - A function receives the label and must return `true` if valid.\n   * - A `RegExp` must match the label.\n   * - `null` disables validation entirely.\n   *\n   * Defaults to `null`.\n   */\n  labelValidation?: ((label: string) => boolean) | RegExp | null;\n}\n\n/** -----------------------------------------\n *  Internal options object\n * ----------------------------------------- */\n\n/**\n * Defined SigilOptions used in the library.\n *\n * @internal\n */\nexport const OPTIONS: Required<SigilOptions> = {\n  labelValidation: null,\n};\n\n/** -----------------------------------------\n *  Update options\n * ----------------------------------------- */\n\n/**\n * Update runtime options for the Sigil library.\n * Call this early during application startup if you want non-default behavior.\n *\n * @param opts - Partial options to merge into the global `OPTIONS` object.\n */\nexport const updateSigilOptions = ({ labelValidation = null }: SigilOptions = {}): void => {\n  OPTIONS.labelValidation = labelValidation;\n};\n\n/** -----------------------------------------\n *  Label validation\n * ----------------------------------------- */\n\n/**\n * Label validation regex. Labels must follow the pattern\n * `@scope/package.ClassName` where `ClassName` begins with an uppercase\n * letter. This avoids collisions across packages and helps debugging.\n *\n * It's advised to use this regex in 'SigilOptions.labelValidation'.\n */\nexport const RECOMMENDED_LABEL_REGEX = /^@[\\w-]+(?:\\/[\\w-]+)*\\.[A-Z][A-Za-z0-9]*$/;\n","import { __SIGIL_REGISTRY__ } from './symbols';\n\ninterface SigilRegistry {\n  registerResolved: (ctor: Function) => void;\n  checkResolved: (ctor: Function) => boolean;\n  registerHasOwn: (ctor: Function) => void;\n  checkHasOwn: (ctor: Function) => boolean;\n}\n\nexport function getSigilRegistry(): SigilRegistry {\n  if ((globalThis as any)[__SIGIL_REGISTRY__]) return (globalThis as any)[__SIGIL_REGISTRY__];\n\n  /** Weak set to ensure that every ctor is handled only once */\n  const resolved = new WeakSet<Function>();\n\n  /** Weak set to store ctors that called sigilify function */\n  const hasOwnSigil = new WeakSet<Function>();\n\n  /** Registry */\n  const registry: SigilRegistry = {\n    registerResolved(ctor) {\n      resolved.add(ctor);\n    },\n    checkResolved(ctor) {\n      return resolved.has(ctor);\n    },\n    registerHasOwn(ctor) {\n      hasOwnSigil.add(ctor);\n    },\n    checkHasOwn(ctor) {\n      return hasOwnSigil.has(ctor);\n    },\n  };\n\n  // Freeze registy to prevent any mutations\n  Object.freeze(registry);\n  // Append registry into globalThis and make it non-writable\n  Object.defineProperty(globalThis, __SIGIL_REGISTRY__, {\n    value: registry,\n    writable: false,\n    configurable: false,\n    enumerable: false,\n  });\n  // return registry\n  return registry;\n}\n","import { OPTIONS, type SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport { getSigilRegistry } from './registry';\n\n/** -----------------------------------------\n *  Get registry\n * ----------------------------------------- */\n\nconst sigilRegistry = getSigilRegistry();\n\n/** -----------------------------------------\n *  Main helpers\n * ----------------------------------------- */\n\n/** Main function to handle 'Sigil' and attach its metadata to the class when label is passed */\nexport function sigilify(ctor: Function, label: string, opts?: SigilOptions): void {\n  // throw if already seen\n  if (sigilRegistry.checkResolved(ctor))\n    throw new Error(\n      `[Sigil Error] Class '${ctor.name}' with label '${(ctor as any).SigilLabel}' is already sigilified`\n    );\n  // verify label\n  verifyLabel(label, opts);\n  // handle ancestors (add them to seen)\n  handleAncestors(ctor);\n  // sigilify ctor\n  updateSigil(ctor, label);\n  // mark as seen and register in hasOwnSigil set\n  sigilRegistry.registerResolved(ctor);\n  sigilRegistry.registerHasOwn(ctor);\n}\n\nexport function hasOwnSigil(ctor: Function) {\n  return sigilRegistry.checkHasOwn(ctor);\n}\n\n/** -----------------------------------------\n *  Generic helpers\n * ----------------------------------------- */\n\n/** Helper function to validate passed label */\nexport function verifyLabel<L extends string>(label: L, opts?: SigilOptions): void {\n  // If validation regex or function is defined validate\n  const labelValidation = opts?.labelValidation ?? OPTIONS.labelValidation;\n  if (labelValidation) {\n    let valid: boolean;\n    if (labelValidation instanceof RegExp) valid = labelValidation.test(label);\n    else valid = labelValidation(label);\n\n    if (!valid)\n      throw new Error(\n        `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`\n      );\n  }\n}\n\nfunction handleAncestors(ctor: Function) {\n  let a = Object.getPrototypeOf(ctor);\n  while (a && typeof a === 'function' && a.prototype[__SIGIL__]) {\n    sigilRegistry.registerResolved(a);\n    a = Object.getPrototypeOf(a);\n  }\n}\n\nfunction updateSigil(ctor: Function, label: string) {\n  // -------------------------\n  // Get symbol from label\n  // -------------------------\n\n  const sym = Symbol.for(label);\n\n  // -------------------------\n  // Populate 'Sigil' symbols\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, __SIGIL__, {\n    value: sym,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __LABEL__, {\n    value: label,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __SIGIL_LINEAGE__, {\n    value: [...(Object.getPrototypeOf(ctor).prototype[__SIGIL_LINEAGE__] ?? []), sym],\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __DEPTH__, {\n    value: (ctor.prototype[__DEPTH__] ?? -1) + 1,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n\n  // -------------------------\n  // Add { symbol: ture } pair\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, sym, {\n    value: true,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n}\n","import { isSigilCtor } from './is';\nimport { sigilify, hasOwnSigil } from './sigilify';\nimport type { SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport type { Constructor, ConstructorAbstract, GetPrototype, sigil, ExtendSigil } from './types';\nimport type { Sigil } from './classes';\n\n/**\n * Helper function to extend Base class with Sigil Class that should be present at the start of each Sigil chain\n * @param Base - The base constructor to extend.\n * @returns Base Sigil class at the start of each Sigil chain\n */\nexport function BaseSigilify<B extends ConstructorAbstract>(Base: B) {\n  // @ts-expect-error Abstract definition will be used in SigilifyAbstract\n  class Sigil extends Base {\n    /**\n     * Class-level identity label constant for this sigil constructor.\n     */\n    static get SigilLabel(): string {\n      return (this as any).prototype[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    static get SigilLabelLineage(): readonly string[] {\n      return (this as any).prototype[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    static get hasOwnSigil(): boolean {\n      return hasOwnSigil(this);\n    }\n\n    /**\n     * Compile-time nominal brand that encodes the class sigil labels object.\n     */\n    declare readonly [sigil]: {\n      Sigil: true;\n    };\n\n    constructor(...args: any[]) {\n      super(...args);\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isExactInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any).prototype[__DEPTH__] !== other[__DEPTH__]) return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isExactInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any)[__DEPTH__] !== (other as any)[__DEPTH__]) return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Returns the identity sigil label of this instance's constructor.\n     *\n     * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').\n     */\n    get SigilLabel(): string {\n      return (this as any)[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    get SigilLabelLineage(): readonly string[] {\n      return (this as any)[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    get hasOwnSigil(): boolean {\n      return (this.constructor as unknown as Sigil).hasOwnSigil;\n    }\n  }\n\n  sigilify(Sigil, 'Sigil');\n  return Sigil;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function Sigilify<B extends Constructor, L extends string>(\n  Base: B,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, Sigil>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function SigilifyAbstract<B extends ConstructorAbstract, L extends string>(\n  Base: B,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  abstract class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, Sigil>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n","import { Sigilify, BaseSigilify } from './mixin';\nimport type { sigil } from './types';\n\n/**\n * A minimal root Sigil class used by the library as a base identity.\n *\n * This is produced by `Sigilify` and can serve as a basic sentinel/base\n * class for other sigil classes or for debugging/inspection.\n */\nexport const Sigil = BaseSigilify(class {});\nexport type Sigil = InstanceType<typeof Sigil>;\n\n/**\n * A sigil variant of the built-in `Error` constructor used by the library\n * to represent Sigil-specific errors.\n *\n * Use `SigilError` when you want an Error type that is identifiable via sigil\n * runtime checks (e.g. `SigilError.isInstance(someError)`).\n */\nexport const SigilError = Sigilify(Error, 'SigilError');\nexport type SigilError = InstanceType<typeof SigilError>;\n","import { isSigilCtor } from './is';\nimport { sigilify } from './sigilify';\nimport type { SigilOptions } from './options';\n\n/**\n * Class decorator factory that attaches sigil statics to a class constructor.\n *\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns A class decorator compatible with the ECMAScript decorator context.\n */\nexport function AttachSigil(label: string, opts?: SigilOptions) {\n  return function (target: Function, ctx: any) {\n    if (!isSigilCtor(target))\n      throw new Error(\n        `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${target.name}'`\n      );\n\n    sigilify(target, label, opts);\n  };\n}\n\n/**\n * Function that attaches runtime sigil metadata to Sigil class.\n * Alternative to '@AttachSigil' if you prefer normal functions.\n *\n * @typeParam S - Constructor type (should be an instance of sigil class).\n * @param Class - The constructor (class) to enhance.\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns The same constructor value, with runtime metadata ensured.\n */\nexport function attachSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S {\n  if (!isSigilCtor(Class))\n    throw new Error(\n      `[Sigil Error] 'attachSigil' function accept only Sigil classes but used on class '${Class.name}'`\n    );\n\n  sigilify(Class, label, opts);\n  return Class;\n}\n"]}

package/dist/index.d.cts

@@ -78,6 +78,8 @@ declare const Sigil: {
     get hasOwnSigil(): boolean;
     isInstance<T>(this: T, other: any): other is GetPrototype<T>;
     isExactInstance<T>(this: T, other: any): other is GetPrototype<T>;
+} & {
+    new (): {};
 };
 type Sigil = InstanceType<typeof Sigil>;
 /**
@@ -104,7 +106,7 @@ declare const SigilError: {
     get hasOwnSigil(): boolean;
     isInstance<T>(this: T, other: any): other is GetPrototype<T>;
     isExactInstance<T>(this: T, other: any): other is GetPrototype<T>;
-};
+} & ErrorConstructor;
 type SigilError = InstanceType<typeof SigilError>;
 
 /** -----------------------------------------
@@ -194,7 +196,7 @@ declare function isSigilInstance(inst: unknown): inst is Sigil;
  * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.
  * @throws Error if `Base` is already sigilified.
  */
-declare function Sigilify<L extends string>(Base: Constructor, label: L, opts?: SigilOptions): {
+declare function Sigilify<B extends Constructor, L extends string>(Base: B, label: L, opts?: SigilOptions): {
     new (...args: any[]): {
         [sigil]: {
             Sigil: true;
@@ -276,7 +278,7 @@ declare function Sigilify<L extends string>(Base: Constructor, label: L, opts?:
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
     isExactInstance<T>(this: T, other: any): other is GetPrototype<T>;
-};
+} & B;
 /**
  * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.
  *
@@ -286,7 +288,7 @@ declare function Sigilify<L extends string>(Base: Constructor, label: L, opts?:
  * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.
  * @throws Error if `Base` is already sigilified.
  */
-declare function SigilifyAbstract<L extends string>(Base: ConstructorAbstract, label: L, opts?: SigilOptions): (abstract new (...args: any[]) => {
+declare function SigilifyAbstract<B extends ConstructorAbstract, L extends string>(Base: B, 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;
@@ -367,7 +369,7 @@ declare function SigilifyAbstract<L extends string>(Base: ConstructorAbstract, l
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
     isExactInstance<T>(this: T, other: any): other is GetPrototype<T>;
-};
+}) & B;
 
 declare function hasOwnSigil(ctor: Function): boolean;
 

package/dist/index.d.ts

@@ -78,6 +78,8 @@ declare const Sigil: {
     get hasOwnSigil(): boolean;
     isInstance<T>(this: T, other: any): other is GetPrototype<T>;
     isExactInstance<T>(this: T, other: any): other is GetPrototype<T>;
+} & {
+    new (): {};
 };
 type Sigil = InstanceType<typeof Sigil>;
 /**
@@ -104,7 +106,7 @@ declare const SigilError: {
     get hasOwnSigil(): boolean;
     isInstance<T>(this: T, other: any): other is GetPrototype<T>;
     isExactInstance<T>(this: T, other: any): other is GetPrototype<T>;
-};
+} & ErrorConstructor;
 type SigilError = InstanceType<typeof SigilError>;
 
 /** -----------------------------------------
@@ -194,7 +196,7 @@ declare function isSigilInstance(inst: unknown): inst is Sigil;
  * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.
  * @throws Error if `Base` is already sigilified.
  */
-declare function Sigilify<L extends string>(Base: Constructor, label: L, opts?: SigilOptions): {
+declare function Sigilify<B extends Constructor, L extends string>(Base: B, label: L, opts?: SigilOptions): {
     new (...args: any[]): {
         [sigil]: {
             Sigil: true;
@@ -276,7 +278,7 @@ declare function Sigilify<L extends string>(Base: Constructor, label: L, opts?:
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
     isExactInstance<T>(this: T, other: any): other is GetPrototype<T>;
-};
+} & B;
 /**
  * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.
  *
@@ -286,7 +288,7 @@ declare function Sigilify<L extends string>(Base: Constructor, label: L, opts?:
  * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.
  * @throws Error if `Base` is already sigilified.
  */
-declare function SigilifyAbstract<L extends string>(Base: ConstructorAbstract, label: L, opts?: SigilOptions): (abstract new (...args: any[]) => {
+declare function SigilifyAbstract<B extends ConstructorAbstract, L extends string>(Base: B, 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;
@@ -367,7 +369,7 @@ declare function SigilifyAbstract<L extends string>(Base: ConstructorAbstract, l
      * @returns A type guard asserting `other` is an instance of the constructor.
      */
     isExactInstance<T>(this: T, other: any): other is GetPrototype<T>;
-};
+}) & B;
 
 declare function hasOwnSigil(ctor: Function): boolean;
 

package/dist/index.global.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/symbols.ts","../src/is.ts","../src/options.ts","../src/registry.ts","../src/sigilify.ts","../src/mixin.ts","../src/classes.ts","../src/attach.ts"],"names":["hasOwnSigil","Sigil"],"mappings":"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","file":"index.global.js","sourcesContent":["/**\n * Symbol to uniquely identify sigil classes.\n *\n * @constant {symbol}\n */\nexport const __SIGIL__ = Symbol.for('@vicin/sigil.__SIGIL__');\n\n/**\n * Symbol to store sigil lineage of a class\n *\n * @constant {symbol}\n */\nexport const __SIGIL_LINEAGE__ = Symbol.for('@vicin/sigil.__SIGIL_LINEAGE__');\n\n/**\n * Symbol used to store the identity label for a sigil constructor.\n *\n * Stored on the constructor as a non-enumerable property.\n *\n * @constant {symbol}\n */\nexport const __LABEL__ = Symbol.for('@vicin/sigil.__LABEL__');\n\n/**\n * Symbol used to store the depth inside Sigil chain. used in exact checks\n *\n * @constant {symbol}\n */\nexport const __DEPTH__ = Symbol.for('@vicin/sigil.__DEPTH__');\n\n/**\n * Symbol of global Sigil registry\n *\n * @constant {symbol}\n */\nexport const __SIGIL_REGISTRY__ = Symbol.for('@vicin/sigil.__SIGIL_REGISTRY__');\n","import type { Sigil } from './classes';\nimport { __SIGIL__ } from './symbols';\n\n/**\n * Runtime predicate that checks whether the provided value is a sigil constructor.\n *\n * @param ctor - Constructor to test.\n * @returns `true` if `value` is a sigil constructor, otherwise `false`.\n */\nexport function isSigilCtor(ctor: unknown): ctor is typeof Sigil {\n  return typeof ctor === 'function' && ctor.prototype && __SIGIL__ in ctor.prototype;\n}\n\n/**\n * Runtime predicate that checks whether the provided object is an instance\n * of a sigil class.\n *\n * @param inst - The instanca to test.\n * @returns `true` if `obj` is an instance produced by a sigil constructor.\n */\nexport function isSigilInstance(inst: unknown): inst is Sigil {\n  return !!inst && typeof inst === 'object' && __SIGIL__ in inst;\n}\n","/** -----------------------------------------\n *  Types\n * ----------------------------------------- */\n\n/**\n * Configuration options for the Sigil library.\n *\n * These options control runtime validation, inheritance checks, label autofill behavior.\n */\nexport interface SigilOptions {\n  /**\n   * Validation rule applied to sigil labels before registration.\n   *\n   * - A function receives the label and must return `true` if valid.\n   * - A `RegExp` must match the label.\n   * - `null` disables validation entirely.\n   *\n   * Defaults to `null`.\n   */\n  labelValidation?: ((label: string) => boolean) | RegExp | null;\n}\n\n/** -----------------------------------------\n *  Internal options object\n * ----------------------------------------- */\n\n/**\n * Defined SigilOptions used in the library.\n *\n * @internal\n */\nexport const OPTIONS: Required<SigilOptions> = {\n  labelValidation: null,\n};\n\n/** -----------------------------------------\n *  Update options\n * ----------------------------------------- */\n\n/**\n * Update runtime options for the Sigil library.\n * Call this early during application startup if you want non-default behavior.\n *\n * @param opts - Partial options to merge into the global `OPTIONS` object.\n */\nexport const updateSigilOptions = ({ labelValidation = null }: SigilOptions = {}): void => {\n  OPTIONS.labelValidation = labelValidation;\n};\n\n/** -----------------------------------------\n *  Label validation\n * ----------------------------------------- */\n\n/**\n * Label validation regex. Labels must follow the pattern\n * `@scope/package.ClassName` where `ClassName` begins with an uppercase\n * letter. This avoids collisions across packages and helps debugging.\n *\n * It's advised to use this regex in 'SigilOptions.labelValidation'.\n */\nexport const RECOMMENDED_LABEL_REGEX = /^@[\\w-]+(?:\\/[\\w-]+)*\\.[A-Z][A-Za-z0-9]*$/;\n","import { __SIGIL_REGISTRY__ } from './symbols';\n\ninterface SigilRegistry {\n  registerResolved: (ctor: Function) => void;\n  checkResolved: (ctor: Function) => boolean;\n  registerHasOwn: (ctor: Function) => void;\n  checkHasOwn: (ctor: Function) => boolean;\n}\n\nexport function getSigilRegistry(): SigilRegistry {\n  if ((globalThis as any)[__SIGIL_REGISTRY__]) return (globalThis as any)[__SIGIL_REGISTRY__];\n\n  /** Weak set to ensure that every ctor is handled only once */\n  const resolved = new WeakSet<Function>();\n\n  /** Weak set to store ctors that called sigilify function */\n  const hasOwnSigil = new WeakSet<Function>();\n\n  /** Registry */\n  const registry: SigilRegistry = {\n    registerResolved(ctor) {\n      resolved.add(ctor);\n    },\n    checkResolved(ctor) {\n      return resolved.has(ctor);\n    },\n    registerHasOwn(ctor) {\n      hasOwnSigil.add(ctor);\n    },\n    checkHasOwn(ctor) {\n      return hasOwnSigil.has(ctor);\n    },\n  };\n\n  // Freeze registy to prevent any mutations\n  Object.freeze(registry);\n  // Append registry into globalThis and make it non-writable\n  Object.defineProperty(globalThis, __SIGIL_REGISTRY__, {\n    value: registry,\n    writable: false,\n    configurable: false,\n    enumerable: false,\n  });\n  // return registry\n  return registry;\n}\n","import { OPTIONS, type SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport { getSigilRegistry } from './registry';\n\n/** -----------------------------------------\n *  Get registry\n * ----------------------------------------- */\n\nconst sigilRegistry = getSigilRegistry();\n\n/** -----------------------------------------\n *  Main helpers\n * ----------------------------------------- */\n\n/** Main function to handle 'Sigil' and attach its metadata to the class when label is passed */\nexport function sigilify(ctor: Function, label: string, opts?: SigilOptions): void {\n  // throw if already seen\n  if (sigilRegistry.checkResolved(ctor))\n    throw new Error(\n      `[Sigil Error] Class '${ctor.name}' with label '${(ctor as any).SigilLabel}' is already sigilified`\n    );\n  // verify label\n  verifyLabel(label, opts);\n  // handle ancestors (add them to seen)\n  handleAncestors(ctor);\n  // sigilify ctor\n  updateSigil(ctor, label);\n  // mark as seen and register in hasOwnSigil set\n  sigilRegistry.registerResolved(ctor);\n  sigilRegistry.registerHasOwn(ctor);\n}\n\nexport function hasOwnSigil(ctor: Function) {\n  return sigilRegistry.checkHasOwn(ctor);\n}\n\n/** -----------------------------------------\n *  Generic helpers\n * ----------------------------------------- */\n\n/** Helper function to validate passed label */\nexport function verifyLabel<L extends string>(label: L, opts?: SigilOptions): void {\n  // If validation regex or function is defined validate\n  const labelValidation = opts?.labelValidation ?? OPTIONS.labelValidation;\n  if (labelValidation) {\n    let valid: boolean;\n    if (labelValidation instanceof RegExp) valid = labelValidation.test(label);\n    else valid = labelValidation(label);\n\n    if (!valid)\n      throw new Error(\n        `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`\n      );\n  }\n}\n\nfunction handleAncestors(ctor: Function) {\n  let a = Object.getPrototypeOf(ctor);\n  while (a && typeof a === 'function' && a.prototype[__SIGIL__]) {\n    sigilRegistry.registerResolved(a);\n    a = Object.getPrototypeOf(a);\n  }\n}\n\nfunction updateSigil(ctor: Function, label: string) {\n  // -------------------------\n  // Get symbol from label\n  // -------------------------\n\n  const sym = Symbol.for(label);\n\n  // -------------------------\n  // Populate 'Sigil' symbols\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, __SIGIL__, {\n    value: sym,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __LABEL__, {\n    value: label,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __SIGIL_LINEAGE__, {\n    value: [...(Object.getPrototypeOf(ctor).prototype[__SIGIL_LINEAGE__] ?? []), sym],\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __DEPTH__, {\n    value: (ctor.prototype[__DEPTH__] ?? -1) + 1,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n\n  // -------------------------\n  // Add { symbol: ture } pair\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, sym, {\n    value: true,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n}\n","import { isSigilCtor } from './is';\nimport { sigilify, hasOwnSigil } from './sigilify';\nimport type { SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport type { Constructor, ConstructorAbstract, GetPrototype, sigil, ExtendSigil } from './types';\n\n/**\n * Helper function to extend Base class with Sigil Class that should be present at the start of each Sigil chain\n * @param Base - The base constructor to extend.\n * @returns Base Sigil class at the start of each Sigil chain\n */\nexport function BaseSigilify(Base: ConstructorAbstract) {\n  class Sigil extends Base {\n    /**\n     * Class-level identity label constant for this sigil constructor.\n     */\n    static get SigilLabel(): string {\n      return (this as any).prototype[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    static get SigilLabelLineage(): readonly string[] {\n      return (this as any).prototype[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    static get hasOwnSigil(): boolean {\n      return hasOwnSigil(this);\n    }\n\n    /**\n     * Compile-time nominal brand that encodes the class sigil labels object.\n     */\n    declare readonly [sigil]: {\n      Sigil: true;\n    };\n\n    constructor(...args: any[]) {\n      super(...args);\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isExactInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any).prototype[__DEPTH__] !== other[__DEPTH__]) return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isExactInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any)[__DEPTH__] !== (other as any)[__DEPTH__]) return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Returns the identity sigil label of this instance's constructor.\n     *\n     * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').\n     */\n    get SigilLabel(): string {\n      return (this as any)[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    get SigilLabelLineage(): readonly string[] {\n      return (this as any)[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    get hasOwnSigil(): boolean {\n      return (this.constructor as unknown as Sigil).hasOwnSigil;\n    }\n  }\n\n  sigilify(Sigil, 'Sigil');\n  return Sigil;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function Sigilify<L extends string>(Base: Constructor, label: L, opts?: SigilOptions) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, InstanceType<typeof BaseSigil>>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function SigilifyAbstract<L extends string>(\n  Base: ConstructorAbstract,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  abstract class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, InstanceType<typeof BaseSigil>>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n","import { Sigilify, BaseSigilify } from './mixin';\nimport type { sigil } from './types';\n\n/**\n * A minimal root Sigil class used by the library as a base identity.\n *\n * This is produced by `Sigilify` and can serve as a basic sentinel/base\n * class for other sigil classes or for debugging/inspection.\n */\nexport const Sigil = BaseSigilify(class {});\nexport type Sigil = InstanceType<typeof Sigil>;\n\n/**\n * A sigil variant of the built-in `Error` constructor used by the library\n * to represent Sigil-specific errors.\n *\n * Use `SigilError` when you want an Error type that is identifiable via sigil\n * runtime checks (e.g. `SigilError.isInstance(someError)`).\n */\nexport const SigilError = Sigilify(Error, 'SigilError');\nexport type SigilError = InstanceType<typeof SigilError>;\n","import { isSigilCtor } from './is';\nimport { sigilify } from './sigilify';\nimport type { SigilOptions } from './options';\n\n/**\n * Class decorator factory that attaches sigil statics to a class constructor.\n *\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns A class decorator compatible with the ECMAScript decorator context.\n */\nexport function AttachSigil(label: string, opts?: SigilOptions) {\n  return function (target: Function, ctx: any) {\n    if (!isSigilCtor(target))\n      throw new Error(\n        `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${target.name}'`\n      );\n\n    sigilify(target, label, opts);\n  };\n}\n\n/**\n * Function that attaches runtime sigil metadata to Sigil class.\n * Alternative to '@AttachSigil' if you prefer normal functions.\n *\n * @typeParam S - Constructor type (should be an instance of sigil class).\n * @param Class - The constructor (class) to enhance.\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns The same constructor value, with runtime metadata ensured.\n */\nexport function attachSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S {\n  if (!isSigilCtor(Class))\n    throw new Error(\n      `[Sigil Error] 'attachSigil' function accept only Sigil classes but used on class '${Class.name}'`\n    );\n\n  sigilify(Class, label, opts);\n  return Class;\n}\n"]}
+{"version":3,"sources":["../src/symbols.ts","../src/is.ts","../src/options.ts","../src/registry.ts","../src/sigilify.ts","../src/mixin.ts","../src/classes.ts","../src/attach.ts"],"names":["hasOwnSigil","Sigil"],"mappings":"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","file":"index.global.js","sourcesContent":["/**\n * Symbol to uniquely identify sigil classes.\n *\n * @constant {symbol}\n */\nexport const __SIGIL__ = Symbol.for('@vicin/sigil.__SIGIL__');\n\n/**\n * Symbol to store sigil lineage of a class\n *\n * @constant {symbol}\n */\nexport const __SIGIL_LINEAGE__ = Symbol.for('@vicin/sigil.__SIGIL_LINEAGE__');\n\n/**\n * Symbol used to store the identity label for a sigil constructor.\n *\n * Stored on the constructor as a non-enumerable property.\n *\n * @constant {symbol}\n */\nexport const __LABEL__ = Symbol.for('@vicin/sigil.__LABEL__');\n\n/**\n * Symbol used to store the depth inside Sigil chain. used in exact checks\n *\n * @constant {symbol}\n */\nexport const __DEPTH__ = Symbol.for('@vicin/sigil.__DEPTH__');\n\n/**\n * Symbol of global Sigil registry\n *\n * @constant {symbol}\n */\nexport const __SIGIL_REGISTRY__ = Symbol.for('@vicin/sigil.__SIGIL_REGISTRY__');\n","import type { Sigil } from './classes';\nimport { __SIGIL__ } from './symbols';\n\n/**\n * Runtime predicate that checks whether the provided value is a sigil constructor.\n *\n * @param ctor - Constructor to test.\n * @returns `true` if `value` is a sigil constructor, otherwise `false`.\n */\nexport function isSigilCtor(ctor: unknown): ctor is typeof Sigil {\n  return typeof ctor === 'function' && ctor.prototype && __SIGIL__ in ctor.prototype;\n}\n\n/**\n * Runtime predicate that checks whether the provided object is an instance\n * of a sigil class.\n *\n * @param inst - The instanca to test.\n * @returns `true` if `obj` is an instance produced by a sigil constructor.\n */\nexport function isSigilInstance(inst: unknown): inst is Sigil {\n  return !!inst && typeof inst === 'object' && __SIGIL__ in inst;\n}\n","/** -----------------------------------------\n *  Types\n * ----------------------------------------- */\n\n/**\n * Configuration options for the Sigil library.\n *\n * These options control runtime validation, inheritance checks, label autofill behavior.\n */\nexport interface SigilOptions {\n  /**\n   * Validation rule applied to sigil labels before registration.\n   *\n   * - A function receives the label and must return `true` if valid.\n   * - A `RegExp` must match the label.\n   * - `null` disables validation entirely.\n   *\n   * Defaults to `null`.\n   */\n  labelValidation?: ((label: string) => boolean) | RegExp | null;\n}\n\n/** -----------------------------------------\n *  Internal options object\n * ----------------------------------------- */\n\n/**\n * Defined SigilOptions used in the library.\n *\n * @internal\n */\nexport const OPTIONS: Required<SigilOptions> = {\n  labelValidation: null,\n};\n\n/** -----------------------------------------\n *  Update options\n * ----------------------------------------- */\n\n/**\n * Update runtime options for the Sigil library.\n * Call this early during application startup if you want non-default behavior.\n *\n * @param opts - Partial options to merge into the global `OPTIONS` object.\n */\nexport const updateSigilOptions = ({ labelValidation = null }: SigilOptions = {}): void => {\n  OPTIONS.labelValidation = labelValidation;\n};\n\n/** -----------------------------------------\n *  Label validation\n * ----------------------------------------- */\n\n/**\n * Label validation regex. Labels must follow the pattern\n * `@scope/package.ClassName` where `ClassName` begins with an uppercase\n * letter. This avoids collisions across packages and helps debugging.\n *\n * It's advised to use this regex in 'SigilOptions.labelValidation'.\n */\nexport const RECOMMENDED_LABEL_REGEX = /^@[\\w-]+(?:\\/[\\w-]+)*\\.[A-Z][A-Za-z0-9]*$/;\n","import { __SIGIL_REGISTRY__ } from './symbols';\n\ninterface SigilRegistry {\n  registerResolved: (ctor: Function) => void;\n  checkResolved: (ctor: Function) => boolean;\n  registerHasOwn: (ctor: Function) => void;\n  checkHasOwn: (ctor: Function) => boolean;\n}\n\nexport function getSigilRegistry(): SigilRegistry {\n  if ((globalThis as any)[__SIGIL_REGISTRY__]) return (globalThis as any)[__SIGIL_REGISTRY__];\n\n  /** Weak set to ensure that every ctor is handled only once */\n  const resolved = new WeakSet<Function>();\n\n  /** Weak set to store ctors that called sigilify function */\n  const hasOwnSigil = new WeakSet<Function>();\n\n  /** Registry */\n  const registry: SigilRegistry = {\n    registerResolved(ctor) {\n      resolved.add(ctor);\n    },\n    checkResolved(ctor) {\n      return resolved.has(ctor);\n    },\n    registerHasOwn(ctor) {\n      hasOwnSigil.add(ctor);\n    },\n    checkHasOwn(ctor) {\n      return hasOwnSigil.has(ctor);\n    },\n  };\n\n  // Freeze registy to prevent any mutations\n  Object.freeze(registry);\n  // Append registry into globalThis and make it non-writable\n  Object.defineProperty(globalThis, __SIGIL_REGISTRY__, {\n    value: registry,\n    writable: false,\n    configurable: false,\n    enumerable: false,\n  });\n  // return registry\n  return registry;\n}\n","import { OPTIONS, type SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport { getSigilRegistry } from './registry';\n\n/** -----------------------------------------\n *  Get registry\n * ----------------------------------------- */\n\nconst sigilRegistry = getSigilRegistry();\n\n/** -----------------------------------------\n *  Main helpers\n * ----------------------------------------- */\n\n/** Main function to handle 'Sigil' and attach its metadata to the class when label is passed */\nexport function sigilify(ctor: Function, label: string, opts?: SigilOptions): void {\n  // throw if already seen\n  if (sigilRegistry.checkResolved(ctor))\n    throw new Error(\n      `[Sigil Error] Class '${ctor.name}' with label '${(ctor as any).SigilLabel}' is already sigilified`\n    );\n  // verify label\n  verifyLabel(label, opts);\n  // handle ancestors (add them to seen)\n  handleAncestors(ctor);\n  // sigilify ctor\n  updateSigil(ctor, label);\n  // mark as seen and register in hasOwnSigil set\n  sigilRegistry.registerResolved(ctor);\n  sigilRegistry.registerHasOwn(ctor);\n}\n\nexport function hasOwnSigil(ctor: Function) {\n  return sigilRegistry.checkHasOwn(ctor);\n}\n\n/** -----------------------------------------\n *  Generic helpers\n * ----------------------------------------- */\n\n/** Helper function to validate passed label */\nexport function verifyLabel<L extends string>(label: L, opts?: SigilOptions): void {\n  // If validation regex or function is defined validate\n  const labelValidation = opts?.labelValidation ?? OPTIONS.labelValidation;\n  if (labelValidation) {\n    let valid: boolean;\n    if (labelValidation instanceof RegExp) valid = labelValidation.test(label);\n    else valid = labelValidation(label);\n\n    if (!valid)\n      throw new Error(\n        `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`\n      );\n  }\n}\n\nfunction handleAncestors(ctor: Function) {\n  let a = Object.getPrototypeOf(ctor);\n  while (a && typeof a === 'function' && a.prototype[__SIGIL__]) {\n    sigilRegistry.registerResolved(a);\n    a = Object.getPrototypeOf(a);\n  }\n}\n\nfunction updateSigil(ctor: Function, label: string) {\n  // -------------------------\n  // Get symbol from label\n  // -------------------------\n\n  const sym = Symbol.for(label);\n\n  // -------------------------\n  // Populate 'Sigil' symbols\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, __SIGIL__, {\n    value: sym,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __LABEL__, {\n    value: label,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __SIGIL_LINEAGE__, {\n    value: [...(Object.getPrototypeOf(ctor).prototype[__SIGIL_LINEAGE__] ?? []), sym],\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __DEPTH__, {\n    value: (ctor.prototype[__DEPTH__] ?? -1) + 1,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n\n  // -------------------------\n  // Add { symbol: ture } pair\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, sym, {\n    value: true,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n}\n","import { isSigilCtor } from './is';\nimport { sigilify, hasOwnSigil } from './sigilify';\nimport type { SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport type { Constructor, ConstructorAbstract, GetPrototype, sigil, ExtendSigil } from './types';\nimport type { Sigil } from './classes';\n\n/**\n * Helper function to extend Base class with Sigil Class that should be present at the start of each Sigil chain\n * @param Base - The base constructor to extend.\n * @returns Base Sigil class at the start of each Sigil chain\n */\nexport function BaseSigilify<B extends ConstructorAbstract>(Base: B) {\n  // @ts-expect-error Abstract definition will be used in SigilifyAbstract\n  class Sigil extends Base {\n    /**\n     * Class-level identity label constant for this sigil constructor.\n     */\n    static get SigilLabel(): string {\n      return (this as any).prototype[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    static get SigilLabelLineage(): readonly string[] {\n      return (this as any).prototype[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    static get hasOwnSigil(): boolean {\n      return hasOwnSigil(this);\n    }\n\n    /**\n     * Compile-time nominal brand that encodes the class sigil labels object.\n     */\n    declare readonly [sigil]: {\n      Sigil: true;\n    };\n\n    constructor(...args: any[]) {\n      super(...args);\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isExactInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any).prototype[__DEPTH__] !== other[__DEPTH__]) return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isExactInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any)[__DEPTH__] !== (other as any)[__DEPTH__]) return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Returns the identity sigil label of this instance's constructor.\n     *\n     * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').\n     */\n    get SigilLabel(): string {\n      return (this as any)[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    get SigilLabelLineage(): readonly string[] {\n      return (this as any)[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    get hasOwnSigil(): boolean {\n      return (this.constructor as unknown as Sigil).hasOwnSigil;\n    }\n  }\n\n  sigilify(Sigil, 'Sigil');\n  return Sigil;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function Sigilify<B extends Constructor, L extends string>(\n  Base: B,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, Sigil>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function SigilifyAbstract<B extends ConstructorAbstract, L extends string>(\n  Base: B,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  abstract class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, Sigil>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n","import { Sigilify, BaseSigilify } from './mixin';\nimport type { sigil } from './types';\n\n/**\n * A minimal root Sigil class used by the library as a base identity.\n *\n * This is produced by `Sigilify` and can serve as a basic sentinel/base\n * class for other sigil classes or for debugging/inspection.\n */\nexport const Sigil = BaseSigilify(class {});\nexport type Sigil = InstanceType<typeof Sigil>;\n\n/**\n * A sigil variant of the built-in `Error` constructor used by the library\n * to represent Sigil-specific errors.\n *\n * Use `SigilError` when you want an Error type that is identifiable via sigil\n * runtime checks (e.g. `SigilError.isInstance(someError)`).\n */\nexport const SigilError = Sigilify(Error, 'SigilError');\nexport type SigilError = InstanceType<typeof SigilError>;\n","import { isSigilCtor } from './is';\nimport { sigilify } from './sigilify';\nimport type { SigilOptions } from './options';\n\n/**\n * Class decorator factory that attaches sigil statics to a class constructor.\n *\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns A class decorator compatible with the ECMAScript decorator context.\n */\nexport function AttachSigil(label: string, opts?: SigilOptions) {\n  return function (target: Function, ctx: any) {\n    if (!isSigilCtor(target))\n      throw new Error(\n        `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${target.name}'`\n      );\n\n    sigilify(target, label, opts);\n  };\n}\n\n/**\n * Function that attaches runtime sigil metadata to Sigil class.\n * Alternative to '@AttachSigil' if you prefer normal functions.\n *\n * @typeParam S - Constructor type (should be an instance of sigil class).\n * @param Class - The constructor (class) to enhance.\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns The same constructor value, with runtime metadata ensured.\n */\nexport function attachSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S {\n  if (!isSigilCtor(Class))\n    throw new Error(\n      `[Sigil Error] 'attachSigil' function accept only Sigil classes but used on class '${Class.name}'`\n    );\n\n  sigilify(Class, label, opts);\n  return Class;\n}\n"]}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/symbols.ts","../src/is.ts","../src/options.ts","../src/registry.ts","../src/sigilify.ts","../src/mixin.ts","../src/classes.ts","../src/attach.ts"],"names":["hasOwnSigil","Sigil"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Symbol to uniquely identify sigil classes.\n *\n * @constant {symbol}\n */\nexport const __SIGIL__ = Symbol.for('@vicin/sigil.__SIGIL__');\n\n/**\n * Symbol to store sigil lineage of a class\n *\n * @constant {symbol}\n */\nexport const __SIGIL_LINEAGE__ = Symbol.for('@vicin/sigil.__SIGIL_LINEAGE__');\n\n/**\n * Symbol used to store the identity label for a sigil constructor.\n *\n * Stored on the constructor as a non-enumerable property.\n *\n * @constant {symbol}\n */\nexport const __LABEL__ = Symbol.for('@vicin/sigil.__LABEL__');\n\n/**\n * Symbol used to store the depth inside Sigil chain. used in exact checks\n *\n * @constant {symbol}\n */\nexport const __DEPTH__ = Symbol.for('@vicin/sigil.__DEPTH__');\n\n/**\n * Symbol of global Sigil registry\n *\n * @constant {symbol}\n */\nexport const __SIGIL_REGISTRY__ = Symbol.for('@vicin/sigil.__SIGIL_REGISTRY__');\n","import type { Sigil } from './classes';\nimport { __SIGIL__ } from './symbols';\n\n/**\n * Runtime predicate that checks whether the provided value is a sigil constructor.\n *\n * @param ctor - Constructor to test.\n * @returns `true` if `value` is a sigil constructor, otherwise `false`.\n */\nexport function isSigilCtor(ctor: unknown): ctor is typeof Sigil {\n  return typeof ctor === 'function' && ctor.prototype && __SIGIL__ in ctor.prototype;\n}\n\n/**\n * Runtime predicate that checks whether the provided object is an instance\n * of a sigil class.\n *\n * @param inst - The instanca to test.\n * @returns `true` if `obj` is an instance produced by a sigil constructor.\n */\nexport function isSigilInstance(inst: unknown): inst is Sigil {\n  return !!inst && typeof inst === 'object' && __SIGIL__ in inst;\n}\n","/** -----------------------------------------\n *  Types\n * ----------------------------------------- */\n\n/**\n * Configuration options for the Sigil library.\n *\n * These options control runtime validation, inheritance checks, label autofill behavior.\n */\nexport interface SigilOptions {\n  /**\n   * Validation rule applied to sigil labels before registration.\n   *\n   * - A function receives the label and must return `true` if valid.\n   * - A `RegExp` must match the label.\n   * - `null` disables validation entirely.\n   *\n   * Defaults to `null`.\n   */\n  labelValidation?: ((label: string) => boolean) | RegExp | null;\n}\n\n/** -----------------------------------------\n *  Internal options object\n * ----------------------------------------- */\n\n/**\n * Defined SigilOptions used in the library.\n *\n * @internal\n */\nexport const OPTIONS: Required<SigilOptions> = {\n  labelValidation: null,\n};\n\n/** -----------------------------------------\n *  Update options\n * ----------------------------------------- */\n\n/**\n * Update runtime options for the Sigil library.\n * Call this early during application startup if you want non-default behavior.\n *\n * @param opts - Partial options to merge into the global `OPTIONS` object.\n */\nexport const updateSigilOptions = ({ labelValidation = null }: SigilOptions = {}): void => {\n  OPTIONS.labelValidation = labelValidation;\n};\n\n/** -----------------------------------------\n *  Label validation\n * ----------------------------------------- */\n\n/**\n * Label validation regex. Labels must follow the pattern\n * `@scope/package.ClassName` where `ClassName` begins with an uppercase\n * letter. This avoids collisions across packages and helps debugging.\n *\n * It's advised to use this regex in 'SigilOptions.labelValidation'.\n */\nexport const RECOMMENDED_LABEL_REGEX = /^@[\\w-]+(?:\\/[\\w-]+)*\\.[A-Z][A-Za-z0-9]*$/;\n","import { __SIGIL_REGISTRY__ } from './symbols';\n\ninterface SigilRegistry {\n  registerResolved: (ctor: Function) => void;\n  checkResolved: (ctor: Function) => boolean;\n  registerHasOwn: (ctor: Function) => void;\n  checkHasOwn: (ctor: Function) => boolean;\n}\n\nexport function getSigilRegistry(): SigilRegistry {\n  if ((globalThis as any)[__SIGIL_REGISTRY__]) return (globalThis as any)[__SIGIL_REGISTRY__];\n\n  /** Weak set to ensure that every ctor is handled only once */\n  const resolved = new WeakSet<Function>();\n\n  /** Weak set to store ctors that called sigilify function */\n  const hasOwnSigil = new WeakSet<Function>();\n\n  /** Registry */\n  const registry: SigilRegistry = {\n    registerResolved(ctor) {\n      resolved.add(ctor);\n    },\n    checkResolved(ctor) {\n      return resolved.has(ctor);\n    },\n    registerHasOwn(ctor) {\n      hasOwnSigil.add(ctor);\n    },\n    checkHasOwn(ctor) {\n      return hasOwnSigil.has(ctor);\n    },\n  };\n\n  // Freeze registy to prevent any mutations\n  Object.freeze(registry);\n  // Append registry into globalThis and make it non-writable\n  Object.defineProperty(globalThis, __SIGIL_REGISTRY__, {\n    value: registry,\n    writable: false,\n    configurable: false,\n    enumerable: false,\n  });\n  // return registry\n  return registry;\n}\n","import { OPTIONS, type SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport { getSigilRegistry } from './registry';\n\n/** -----------------------------------------\n *  Get registry\n * ----------------------------------------- */\n\nconst sigilRegistry = getSigilRegistry();\n\n/** -----------------------------------------\n *  Main helpers\n * ----------------------------------------- */\n\n/** Main function to handle 'Sigil' and attach its metadata to the class when label is passed */\nexport function sigilify(ctor: Function, label: string, opts?: SigilOptions): void {\n  // throw if already seen\n  if (sigilRegistry.checkResolved(ctor))\n    throw new Error(\n      `[Sigil Error] Class '${ctor.name}' with label '${(ctor as any).SigilLabel}' is already sigilified`\n    );\n  // verify label\n  verifyLabel(label, opts);\n  // handle ancestors (add them to seen)\n  handleAncestors(ctor);\n  // sigilify ctor\n  updateSigil(ctor, label);\n  // mark as seen and register in hasOwnSigil set\n  sigilRegistry.registerResolved(ctor);\n  sigilRegistry.registerHasOwn(ctor);\n}\n\nexport function hasOwnSigil(ctor: Function) {\n  return sigilRegistry.checkHasOwn(ctor);\n}\n\n/** -----------------------------------------\n *  Generic helpers\n * ----------------------------------------- */\n\n/** Helper function to validate passed label */\nexport function verifyLabel<L extends string>(label: L, opts?: SigilOptions): void {\n  // If validation regex or function is defined validate\n  const labelValidation = opts?.labelValidation ?? OPTIONS.labelValidation;\n  if (labelValidation) {\n    let valid: boolean;\n    if (labelValidation instanceof RegExp) valid = labelValidation.test(label);\n    else valid = labelValidation(label);\n\n    if (!valid)\n      throw new Error(\n        `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`\n      );\n  }\n}\n\nfunction handleAncestors(ctor: Function) {\n  let a = Object.getPrototypeOf(ctor);\n  while (a && typeof a === 'function' && a.prototype[__SIGIL__]) {\n    sigilRegistry.registerResolved(a);\n    a = Object.getPrototypeOf(a);\n  }\n}\n\nfunction updateSigil(ctor: Function, label: string) {\n  // -------------------------\n  // Get symbol from label\n  // -------------------------\n\n  const sym = Symbol.for(label);\n\n  // -------------------------\n  // Populate 'Sigil' symbols\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, __SIGIL__, {\n    value: sym,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __LABEL__, {\n    value: label,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __SIGIL_LINEAGE__, {\n    value: [...(Object.getPrototypeOf(ctor).prototype[__SIGIL_LINEAGE__] ?? []), sym],\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __DEPTH__, {\n    value: (ctor.prototype[__DEPTH__] ?? -1) + 1,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n\n  // -------------------------\n  // Add { symbol: ture } pair\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, sym, {\n    value: true,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n}\n","import { isSigilCtor } from './is';\nimport { sigilify, hasOwnSigil } from './sigilify';\nimport type { SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport type { Constructor, ConstructorAbstract, GetPrototype, sigil, ExtendSigil } from './types';\n\n/**\n * Helper function to extend Base class with Sigil Class that should be present at the start of each Sigil chain\n * @param Base - The base constructor to extend.\n * @returns Base Sigil class at the start of each Sigil chain\n */\nexport function BaseSigilify(Base: ConstructorAbstract) {\n  class Sigil extends Base {\n    /**\n     * Class-level identity label constant for this sigil constructor.\n     */\n    static get SigilLabel(): string {\n      return (this as any).prototype[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    static get SigilLabelLineage(): readonly string[] {\n      return (this as any).prototype[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    static get hasOwnSigil(): boolean {\n      return hasOwnSigil(this);\n    }\n\n    /**\n     * Compile-time nominal brand that encodes the class sigil labels object.\n     */\n    declare readonly [sigil]: {\n      Sigil: true;\n    };\n\n    constructor(...args: any[]) {\n      super(...args);\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isExactInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any).prototype[__DEPTH__] !== other[__DEPTH__]) return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isExactInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any)[__DEPTH__] !== (other as any)[__DEPTH__]) return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Returns the identity sigil label of this instance's constructor.\n     *\n     * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').\n     */\n    get SigilLabel(): string {\n      return (this as any)[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    get SigilLabelLineage(): readonly string[] {\n      return (this as any)[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    get hasOwnSigil(): boolean {\n      return (this.constructor as unknown as Sigil).hasOwnSigil;\n    }\n  }\n\n  sigilify(Sigil, 'Sigil');\n  return Sigil;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function Sigilify<L extends string>(Base: Constructor, label: L, opts?: SigilOptions) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, InstanceType<typeof BaseSigil>>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function SigilifyAbstract<L extends string>(\n  Base: ConstructorAbstract,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  abstract class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, InstanceType<typeof BaseSigil>>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n","import { Sigilify, BaseSigilify } from './mixin';\nimport type { sigil } from './types';\n\n/**\n * A minimal root Sigil class used by the library as a base identity.\n *\n * This is produced by `Sigilify` and can serve as a basic sentinel/base\n * class for other sigil classes or for debugging/inspection.\n */\nexport const Sigil = BaseSigilify(class {});\nexport type Sigil = InstanceType<typeof Sigil>;\n\n/**\n * A sigil variant of the built-in `Error` constructor used by the library\n * to represent Sigil-specific errors.\n *\n * Use `SigilError` when you want an Error type that is identifiable via sigil\n * runtime checks (e.g. `SigilError.isInstance(someError)`).\n */\nexport const SigilError = Sigilify(Error, 'SigilError');\nexport type SigilError = InstanceType<typeof SigilError>;\n","import { isSigilCtor } from './is';\nimport { sigilify } from './sigilify';\nimport type { SigilOptions } from './options';\n\n/**\n * Class decorator factory that attaches sigil statics to a class constructor.\n *\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns A class decorator compatible with the ECMAScript decorator context.\n */\nexport function AttachSigil(label: string, opts?: SigilOptions) {\n  return function (target: Function, ctx: any) {\n    if (!isSigilCtor(target))\n      throw new Error(\n        `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${target.name}'`\n      );\n\n    sigilify(target, label, opts);\n  };\n}\n\n/**\n * Function that attaches runtime sigil metadata to Sigil class.\n * Alternative to '@AttachSigil' if you prefer normal functions.\n *\n * @typeParam S - Constructor type (should be an instance of sigil class).\n * @param Class - The constructor (class) to enhance.\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns The same constructor value, with runtime metadata ensured.\n */\nexport function attachSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S {\n  if (!isSigilCtor(Class))\n    throw new Error(\n      `[Sigil Error] 'attachSigil' function accept only Sigil classes but used on class '${Class.name}'`\n    );\n\n  sigilify(Class, label, opts);\n  return Class;\n}\n"]}
+{"version":3,"sources":["../src/symbols.ts","../src/is.ts","../src/options.ts","../src/registry.ts","../src/sigilify.ts","../src/mixin.ts","../src/classes.ts","../src/attach.ts"],"names":["hasOwnSigil","Sigil"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Symbol to uniquely identify sigil classes.\n *\n * @constant {symbol}\n */\nexport const __SIGIL__ = Symbol.for('@vicin/sigil.__SIGIL__');\n\n/**\n * Symbol to store sigil lineage of a class\n *\n * @constant {symbol}\n */\nexport const __SIGIL_LINEAGE__ = Symbol.for('@vicin/sigil.__SIGIL_LINEAGE__');\n\n/**\n * Symbol used to store the identity label for a sigil constructor.\n *\n * Stored on the constructor as a non-enumerable property.\n *\n * @constant {symbol}\n */\nexport const __LABEL__ = Symbol.for('@vicin/sigil.__LABEL__');\n\n/**\n * Symbol used to store the depth inside Sigil chain. used in exact checks\n *\n * @constant {symbol}\n */\nexport const __DEPTH__ = Symbol.for('@vicin/sigil.__DEPTH__');\n\n/**\n * Symbol of global Sigil registry\n *\n * @constant {symbol}\n */\nexport const __SIGIL_REGISTRY__ = Symbol.for('@vicin/sigil.__SIGIL_REGISTRY__');\n","import type { Sigil } from './classes';\nimport { __SIGIL__ } from './symbols';\n\n/**\n * Runtime predicate that checks whether the provided value is a sigil constructor.\n *\n * @param ctor - Constructor to test.\n * @returns `true` if `value` is a sigil constructor, otherwise `false`.\n */\nexport function isSigilCtor(ctor: unknown): ctor is typeof Sigil {\n  return typeof ctor === 'function' && ctor.prototype && __SIGIL__ in ctor.prototype;\n}\n\n/**\n * Runtime predicate that checks whether the provided object is an instance\n * of a sigil class.\n *\n * @param inst - The instanca to test.\n * @returns `true` if `obj` is an instance produced by a sigil constructor.\n */\nexport function isSigilInstance(inst: unknown): inst is Sigil {\n  return !!inst && typeof inst === 'object' && __SIGIL__ in inst;\n}\n","/** -----------------------------------------\n *  Types\n * ----------------------------------------- */\n\n/**\n * Configuration options for the Sigil library.\n *\n * These options control runtime validation, inheritance checks, label autofill behavior.\n */\nexport interface SigilOptions {\n  /**\n   * Validation rule applied to sigil labels before registration.\n   *\n   * - A function receives the label and must return `true` if valid.\n   * - A `RegExp` must match the label.\n   * - `null` disables validation entirely.\n   *\n   * Defaults to `null`.\n   */\n  labelValidation?: ((label: string) => boolean) | RegExp | null;\n}\n\n/** -----------------------------------------\n *  Internal options object\n * ----------------------------------------- */\n\n/**\n * Defined SigilOptions used in the library.\n *\n * @internal\n */\nexport const OPTIONS: Required<SigilOptions> = {\n  labelValidation: null,\n};\n\n/** -----------------------------------------\n *  Update options\n * ----------------------------------------- */\n\n/**\n * Update runtime options for the Sigil library.\n * Call this early during application startup if you want non-default behavior.\n *\n * @param opts - Partial options to merge into the global `OPTIONS` object.\n */\nexport const updateSigilOptions = ({ labelValidation = null }: SigilOptions = {}): void => {\n  OPTIONS.labelValidation = labelValidation;\n};\n\n/** -----------------------------------------\n *  Label validation\n * ----------------------------------------- */\n\n/**\n * Label validation regex. Labels must follow the pattern\n * `@scope/package.ClassName` where `ClassName` begins with an uppercase\n * letter. This avoids collisions across packages and helps debugging.\n *\n * It's advised to use this regex in 'SigilOptions.labelValidation'.\n */\nexport const RECOMMENDED_LABEL_REGEX = /^@[\\w-]+(?:\\/[\\w-]+)*\\.[A-Z][A-Za-z0-9]*$/;\n","import { __SIGIL_REGISTRY__ } from './symbols';\n\ninterface SigilRegistry {\n  registerResolved: (ctor: Function) => void;\n  checkResolved: (ctor: Function) => boolean;\n  registerHasOwn: (ctor: Function) => void;\n  checkHasOwn: (ctor: Function) => boolean;\n}\n\nexport function getSigilRegistry(): SigilRegistry {\n  if ((globalThis as any)[__SIGIL_REGISTRY__]) return (globalThis as any)[__SIGIL_REGISTRY__];\n\n  /** Weak set to ensure that every ctor is handled only once */\n  const resolved = new WeakSet<Function>();\n\n  /** Weak set to store ctors that called sigilify function */\n  const hasOwnSigil = new WeakSet<Function>();\n\n  /** Registry */\n  const registry: SigilRegistry = {\n    registerResolved(ctor) {\n      resolved.add(ctor);\n    },\n    checkResolved(ctor) {\n      return resolved.has(ctor);\n    },\n    registerHasOwn(ctor) {\n      hasOwnSigil.add(ctor);\n    },\n    checkHasOwn(ctor) {\n      return hasOwnSigil.has(ctor);\n    },\n  };\n\n  // Freeze registy to prevent any mutations\n  Object.freeze(registry);\n  // Append registry into globalThis and make it non-writable\n  Object.defineProperty(globalThis, __SIGIL_REGISTRY__, {\n    value: registry,\n    writable: false,\n    configurable: false,\n    enumerable: false,\n  });\n  // return registry\n  return registry;\n}\n","import { OPTIONS, type SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport { getSigilRegistry } from './registry';\n\n/** -----------------------------------------\n *  Get registry\n * ----------------------------------------- */\n\nconst sigilRegistry = getSigilRegistry();\n\n/** -----------------------------------------\n *  Main helpers\n * ----------------------------------------- */\n\n/** Main function to handle 'Sigil' and attach its metadata to the class when label is passed */\nexport function sigilify(ctor: Function, label: string, opts?: SigilOptions): void {\n  // throw if already seen\n  if (sigilRegistry.checkResolved(ctor))\n    throw new Error(\n      `[Sigil Error] Class '${ctor.name}' with label '${(ctor as any).SigilLabel}' is already sigilified`\n    );\n  // verify label\n  verifyLabel(label, opts);\n  // handle ancestors (add them to seen)\n  handleAncestors(ctor);\n  // sigilify ctor\n  updateSigil(ctor, label);\n  // mark as seen and register in hasOwnSigil set\n  sigilRegistry.registerResolved(ctor);\n  sigilRegistry.registerHasOwn(ctor);\n}\n\nexport function hasOwnSigil(ctor: Function) {\n  return sigilRegistry.checkHasOwn(ctor);\n}\n\n/** -----------------------------------------\n *  Generic helpers\n * ----------------------------------------- */\n\n/** Helper function to validate passed label */\nexport function verifyLabel<L extends string>(label: L, opts?: SigilOptions): void {\n  // If validation regex or function is defined validate\n  const labelValidation = opts?.labelValidation ?? OPTIONS.labelValidation;\n  if (labelValidation) {\n    let valid: boolean;\n    if (labelValidation instanceof RegExp) valid = labelValidation.test(label);\n    else valid = labelValidation(label);\n\n    if (!valid)\n      throw new Error(\n        `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`\n      );\n  }\n}\n\nfunction handleAncestors(ctor: Function) {\n  let a = Object.getPrototypeOf(ctor);\n  while (a && typeof a === 'function' && a.prototype[__SIGIL__]) {\n    sigilRegistry.registerResolved(a);\n    a = Object.getPrototypeOf(a);\n  }\n}\n\nfunction updateSigil(ctor: Function, label: string) {\n  // -------------------------\n  // Get symbol from label\n  // -------------------------\n\n  const sym = Symbol.for(label);\n\n  // -------------------------\n  // Populate 'Sigil' symbols\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, __SIGIL__, {\n    value: sym,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __LABEL__, {\n    value: label,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __SIGIL_LINEAGE__, {\n    value: [...(Object.getPrototypeOf(ctor).prototype[__SIGIL_LINEAGE__] ?? []), sym],\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n  Object.defineProperty(ctor.prototype, __DEPTH__, {\n    value: (ctor.prototype[__DEPTH__] ?? -1) + 1,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n\n  // -------------------------\n  // Add { symbol: ture } pair\n  // -------------------------\n\n  Object.defineProperty(ctor.prototype, sym, {\n    value: true,\n    configurable: false,\n    enumerable: false,\n    writable: false,\n  });\n}\n","import { isSigilCtor } from './is';\nimport { sigilify, hasOwnSigil } from './sigilify';\nimport type { SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\nimport type { Constructor, ConstructorAbstract, GetPrototype, sigil, ExtendSigil } from './types';\nimport type { Sigil } from './classes';\n\n/**\n * Helper function to extend Base class with Sigil Class that should be present at the start of each Sigil chain\n * @param Base - The base constructor to extend.\n * @returns Base Sigil class at the start of each Sigil chain\n */\nexport function BaseSigilify<B extends ConstructorAbstract>(Base: B) {\n  // @ts-expect-error Abstract definition will be used in SigilifyAbstract\n  class Sigil extends Base {\n    /**\n     * Class-level identity label constant for this sigil constructor.\n     */\n    static get SigilLabel(): string {\n      return (this as any).prototype[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    static get SigilLabelLineage(): readonly string[] {\n      return (this as any).prototype[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    static get hasOwnSigil(): boolean {\n      return hasOwnSigil(this);\n    }\n\n    /**\n     * Compile-time nominal brand that encodes the class sigil labels object.\n     */\n    declare readonly [sigil]: {\n      Sigil: true;\n    };\n\n    constructor(...args: any[]) {\n      super(...args);\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    static isExactInstance<T>(this: T, other: any): other is GetPrototype<T> {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any).prototype[__DEPTH__] !== other[__DEPTH__]) return false;\n      return other[(this as any).prototype[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is (or inherits from) the instance represented by the\n     * calling constructor.\n     *\n     * This replaces `instanceof` so that checks remain valid across bundles/realms\n     * and when subclassing.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Check whether `other` is exactly the same instance represented by the\n     * calling constructor.\n     *\n     * @typeParam T - The specific sigil constructor (`this`).\n     * @param this - The constructor performing the type check.\n     * @param other - The object to test.\n     * @returns A type guard asserting `other` is an instance of the constructor.\n     */\n    isExactInstance<T>(this: T, other: any): other is T {\n      if (other == null || typeof other !== 'object') return false;\n      if ((this as any)[__DEPTH__] !== (other as any)[__DEPTH__]) return false;\n      return other[(this as any)[__SIGIL__]] === true;\n    }\n\n    /**\n     * Returns the identity sigil label of this instance's constructor.\n     *\n     * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').\n     */\n    get SigilLabel(): string {\n      return (this as any)[__LABEL__];\n    }\n\n    /**\n     * Copy of the sigil label lineage for this instance's constructor.\n     *\n     * Useful for debugging and logging.\n     *\n     * @returns An array of sigil labels representing parent → child labels.\n     */\n    get SigilLabelLineage(): readonly string[] {\n      return (this as any)[__SIGIL_LINEAGE__].map((v: symbol) => v.description);\n    }\n\n    /** Check if sigil label has been attached to this class */\n    get hasOwnSigil(): boolean {\n      return (this.constructor as unknown as Sigil).hasOwnSigil;\n    }\n  }\n\n  sigilify(Sigil, 'Sigil');\n  return Sigil;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function Sigilify<B extends Constructor, L extends string>(\n  Base: B,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, Sigil>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n\n/**\n * Mixin factory that augments an existing class with Sigil runtime metadata and helpers. Accept and return 'abstract' class.\n *\n * @param Base - The base constructor to extend.\n * @param label - Identity label to attach to the resulting class (e.g. '@scope/pkg.ClassName').\n * @param opts - Options object to override any global options if needed.\n * @returns A new abstract constructor that extends `Base` and includes Sigil statics/instance methods.\n * @throws Error if `Base` is already sigilified.\n */\nexport function SigilifyAbstract<B extends ConstructorAbstract, L extends string>(\n  Base: B,\n  label: L,\n  opts?: SigilOptions\n) {\n  if (isSigilCtor(Base))\n    throw new Error(\n      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`\n    );\n\n  const BaseSigil = BaseSigilify(Base);\n  abstract class Sigilified extends BaseSigil {\n    declare [sigil]: ExtendSigil<L, Sigil>;\n  }\n\n  sigilify(Sigilified, label, opts);\n  return Sigilified;\n}\n","import { Sigilify, BaseSigilify } from './mixin';\nimport type { sigil } from './types';\n\n/**\n * A minimal root Sigil class used by the library as a base identity.\n *\n * This is produced by `Sigilify` and can serve as a basic sentinel/base\n * class for other sigil classes or for debugging/inspection.\n */\nexport const Sigil = BaseSigilify(class {});\nexport type Sigil = InstanceType<typeof Sigil>;\n\n/**\n * A sigil variant of the built-in `Error` constructor used by the library\n * to represent Sigil-specific errors.\n *\n * Use `SigilError` when you want an Error type that is identifiable via sigil\n * runtime checks (e.g. `SigilError.isInstance(someError)`).\n */\nexport const SigilError = Sigilify(Error, 'SigilError');\nexport type SigilError = InstanceType<typeof SigilError>;\n","import { isSigilCtor } from './is';\nimport { sigilify } from './sigilify';\nimport type { SigilOptions } from './options';\n\n/**\n * Class decorator factory that attaches sigil statics to a class constructor.\n *\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns A class decorator compatible with the ECMAScript decorator context.\n */\nexport function AttachSigil(label: string, opts?: SigilOptions) {\n  return function (target: Function, ctx: any) {\n    if (!isSigilCtor(target))\n      throw new Error(\n        `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${target.name}'`\n      );\n\n    sigilify(target, label, opts);\n  };\n}\n\n/**\n * Function that attaches runtime sigil metadata to Sigil class.\n * Alternative to '@AttachSigil' if you prefer normal functions.\n *\n * @typeParam S - Constructor type (should be an instance of sigil class).\n * @param Class - The constructor (class) to enhance.\n * @param label - Sigil label string to assign to the decorated class (e.g. `@scope/pkg.ClassName`).\n * @param opts - Options object to override any global options if needed.\n * @returns The same constructor value, with runtime metadata ensured.\n */\nexport function attachSigil<S extends Function>(Class: S, label: string, opts?: SigilOptions): S {\n  if (!isSigilCtor(Class))\n    throw new Error(\n      `[Sigil Error] 'attachSigil' function accept only Sigil classes but used on class '${Class.name}'`\n    );\n\n  sigilify(Class, label, opts);\n  return Class;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vicin/sigil",
-  "version": "4.0.1",
+  "version": "4.0.2",
   "description": "Sigil, bulletproof class identity for large TypeScript projects",
   "license": "MIT",
   "author": "Ziad ziadtaha62@gmail.com",