@vicin/sigil 3.3.0 → 4.0.0

package/dist/index.cjs

@@ -0,0 +1,269 @@
+'use strict';
+
+// src/symbols.ts
+var __SIGIL__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__SIGIL__");
+var __SIGIL_LINEAGE__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__SIGIL_LINEAGE__");
+var __LABEL__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__LABEL__");
+var __DEPTH__ = /* @__PURE__ */ Symbol.for("@vicin/sigil.__DEPTH__");
+
+// src/is.ts
+function isSigilCtor(ctor) {
+  return typeof ctor === "function" && ctor.prototype && __SIGIL__ in ctor.prototype;
+}
+function isSigilInstance(inst) {
+  return !!inst && typeof inst === "object" && __SIGIL__ in inst;
+}
+
+// src/options.ts
+var OPTIONS = {
+  labelValidation: null
+};
+var updateSigilOptions = ({ labelValidation = null } = {}) => {
+  OPTIONS.labelValidation = labelValidation;
+};
+var RECOMMENDED_LABEL_REGEX = /^@[\w-]+(?:\/[\w-]+)*\.[A-Z][A-Za-z0-9]*$/;
+
+// src/sigilify.ts
+var resolved = /* @__PURE__ */ new WeakSet();
+var hasOwnSigilRegistry = /* @__PURE__ */ new WeakSet();
+function sigilify(ctor, label, opts) {
+  if (resolved.has(ctor))
+    throw new Error(
+      `[Sigil Error] Class '${ctor.name}' with label '${ctor.SigilLabel}' is already sigilified`
+    );
+  verifyLabel(label, opts);
+  handleAncestors(ctor);
+  updateSigil(ctor, label);
+  resolved.add(ctor);
+  hasOwnSigilRegistry.add(ctor);
+}
+function hasOwnSigil(ctor) {
+  return hasOwnSigilRegistry.has(ctor);
+}
+function verifyLabel(label, opts) {
+  var _a;
+  const labelValidation = (_a = opts == null ? void 0 : opts.labelValidation) != null ? _a : OPTIONS.labelValidation;
+  if (labelValidation) {
+    let valid;
+    if (labelValidation instanceof RegExp) valid = labelValidation.test(label);
+    else valid = labelValidation(label);
+    if (!valid)
+      throw new Error(
+        `[Sigil Error] Invalid Sigil label '${label}'. Make sure that supplied label matches validation regex or function`
+      );
+  }
+}
+function handleAncestors(ctor) {
+  let a = Object.getPrototypeOf(ctor);
+  while (a && typeof a === "function" && a.prototype[__SIGIL__]) {
+    resolved.add(a);
+    a = Object.getPrototypeOf(a);
+  }
+}
+function updateSigil(ctor, label) {
+  var _a, _b, _c;
+  const sym = Symbol.for(label);
+  Object.defineProperty(ctor.prototype, __SIGIL__, {
+    value: sym,
+    configurable: false,
+    enumerable: false,
+    writable: false
+  });
+  Object.defineProperty(ctor.prototype, __LABEL__, {
+    value: label,
+    configurable: false,
+    enumerable: false,
+    writable: false
+  });
+  Object.defineProperty(ctor.prototype, __SIGIL_LINEAGE__, {
+    value: [...(_b = (_a = Object.getPrototypeOf(ctor)) == null ? void 0 : _a.prototype[__SIGIL_LINEAGE__]) != null ? _b : [], sym],
+    configurable: false,
+    enumerable: false,
+    writable: false
+  });
+  Object.defineProperty(ctor.prototype, __DEPTH__, {
+    value: ((_c = ctor.prototype[__DEPTH__]) != null ? _c : -1) + 1,
+    configurable: false,
+    enumerable: false,
+    writable: false
+  });
+  Object.defineProperty(ctor.prototype, sym, {
+    value: true,
+    configurable: false,
+    enumerable: false,
+    writable: false
+  });
+}
+
+// src/mixin.ts
+function BaseSigilify(Base) {
+  class Sigil2 extends Base {
+    /**
+     * Class-level identity label constant for this sigil constructor.
+     */
+    static get SigilLabel() {
+      return this.prototype[__LABEL__];
+    }
+    /**
+     * Copy of the sigil label lineage for this instance's constructor.
+     *
+     * Useful for debugging and logging.
+     *
+     * @returns An array of sigil labels representing parent → child labels.
+     */
+    static get SigilLabelLineage() {
+      return this.prototype[__SIGIL_LINEAGE__].map((v) => v.description);
+    }
+    /** Check if sigil label has been attached to this class */
+    static get hasOwnSigil() {
+      return hasOwnSigil(this);
+    }
+    constructor(...args) {
+      super(...args);
+    }
+    /**
+     * Check whether `other` is (or inherits from) the instance represented by the
+     * calling constructor.
+     *
+     * This replaces `instanceof` so that checks remain valid across bundles/realms
+     * and when subclassing.
+     *
+     * @typeParam T - The specific sigil constructor (`this`).
+     * @param this - The constructor performing the type check.
+     * @param other - The object to test.
+     * @returns A type guard asserting `other` is an instance of the constructor.
+     */
+    static isInstance(other) {
+      if (other == null || typeof other !== "object") return false;
+      return other[this.prototype[__SIGIL__]] === true;
+    }
+    /**
+     * Check whether `other` is exactly the same instance represented by the
+     * calling constructor.
+     *
+     * @typeParam T - The specific sigil constructor (`this`).
+     * @param this - The constructor performing the type check.
+     * @param other - The object to test.
+     * @returns A type guard asserting `other` is an instance of the constructor.
+     */
+    static isExactInstance(other) {
+      if (other == null || typeof other !== "object") return false;
+      if (this.prototype[__DEPTH__] !== other[__DEPTH__]) return false;
+      return other[this.prototype[__SIGIL__]] === true;
+    }
+    /**
+     * Check whether `other` is (or inherits from) the instance represented by the
+     * calling constructor.
+     *
+     * This replaces `instanceof` so that checks remain valid across bundles/realms
+     * and when subclassing.
+     *
+     * @typeParam T - The specific sigil constructor (`this`).
+     * @param this - The constructor performing the type check.
+     * @param other - The object to test.
+     * @returns A type guard asserting `other` is an instance of the constructor.
+     */
+    isInstance(other) {
+      if (other == null || typeof other !== "object") return false;
+      return other[this[__SIGIL__]] === true;
+    }
+    /**
+     * Check whether `other` is exactly the same instance represented by the
+     * calling constructor.
+     *
+     * @typeParam T - The specific sigil constructor (`this`).
+     * @param this - The constructor performing the type check.
+     * @param other - The object to test.
+     * @returns A type guard asserting `other` is an instance of the constructor.
+     */
+    isExactInstance(other) {
+      if (other == null || typeof other !== "object") return false;
+      if (this[__DEPTH__] !== other[__DEPTH__]) return false;
+      return other[this[__SIGIL__]] === true;
+    }
+    /**
+     * Returns the identity sigil label of this instance's constructor.
+     *
+     * @returns The label string if passed (e.g. '@scope/pkg.ClassName'), random label if not passed (e.g. '@Sigil-auto:ClassName:1:pnf11bgl').
+     */
+    get SigilLabel() {
+      return this[__LABEL__];
+    }
+    /**
+     * Copy of the sigil label lineage for this instance's constructor.
+     *
+     * Useful for debugging and logging.
+     *
+     * @returns An array of sigil labels representing parent → child labels.
+     */
+    get SigilLabelLineage() {
+      return this[__SIGIL_LINEAGE__].map((v) => v.description);
+    }
+    /** Check if sigil label has been attached to this class */
+    get hasOwnSigil() {
+      return this.constructor.hasOwnSigil;
+    }
+  }
+  sigilify(Sigil2, "Sigil");
+  return Sigil2;
+}
+function Sigilify(Base, label, opts) {
+  if (isSigilCtor(Base))
+    throw new Error(
+      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`
+    );
+  const BaseSigil = BaseSigilify(Base);
+  class Sigilified extends BaseSigil {
+  }
+  sigilify(Sigilified, label, opts);
+  return Sigilified;
+}
+function SigilifyAbstract(Base, label, opts) {
+  if (isSigilCtor(Base))
+    throw new Error(
+      `[Sigil Error] Class '${Base.name}' with label '${Base.SigilLabel}' is already sigilified`
+    );
+  const BaseSigil = BaseSigilify(Base);
+  class Sigilified extends BaseSigil {
+  }
+  sigilify(Sigilified, label, opts);
+  return Sigilified;
+}
+
+// src/classes.ts
+var Sigil = BaseSigilify(class {
+});
+var SigilError = Sigilify(Error, "SigilError");
+
+// src/attach.ts
+function AttachSigil(label, opts) {
+  return function(target, ctx) {
+    if (!isSigilCtor(target))
+      throw new Error(
+        `[Sigil Error] 'AttachSigil' decorator accept only Sigil classes but used on class '${target.name}'`
+      );
+    sigilify(target, label, opts);
+  };
+}
+function attachSigil(Class, label, opts) {
+  if (!isSigilCtor(Class))
+    throw new Error(
+      `[Sigil Error] 'attachSigil' function accept only Sigil classes but used on class '${Class.name}'`
+    );
+  sigilify(Class, label, opts);
+  return Class;
+}
+
+exports.AttachSigil = AttachSigil;
+exports.RECOMMENDED_LABEL_REGEX = RECOMMENDED_LABEL_REGEX;
+exports.Sigil = Sigil;
+exports.SigilError = SigilError;
+exports.Sigilify = Sigilify;
+exports.SigilifyAbstract = SigilifyAbstract;
+exports.attachSigil = attachSigil;
+exports.hasOwnSigil = hasOwnSigil;
+exports.isSigilCtor = isSigilCtor;
+exports.isSigilInstance = isSigilInstance;
+exports.updateSigilOptions = updateSigilOptions;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/symbols.ts","../src/is.ts","../src/options.ts","../src/sigilify.ts","../src/mixin.ts","../src/classes.ts","../src/attach.ts"],"names":["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","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 { OPTIONS, type SigilOptions } from './options';\nimport { __LABEL__, __SIGIL__, __SIGIL_LINEAGE__, __DEPTH__ } from './symbols';\n\n/** -----------------------------------------\n *  Maps\n * ----------------------------------------- */\n\n/** Weak set to ensure that every ctor is handled only once */\nconst resolved = new WeakSet<Function>();\n\n/** Weak set to store ctors that called sigilify function */\nconst hasOwnSigilRegistry = new WeakSet<Function>();\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 (resolved.has(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  resolved.add(ctor);\n  hasOwnSigilRegistry.add(ctor);\n}\n\nexport function hasOwnSigil(ctor: Function) {\n  return hasOwnSigilRegistry.has(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    resolved.add(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"]}