@vicin/sigil 1.3.0 → 2.0.0

package/dist/index.d.mts

@@ -1,298 +1,3 @@
-/**
- * Small wrapper around a shared registry Set that provides safe operations
- * and hot-reload-friendly behavior.
- *
- * Responsibilities:
- * - Query the current registry (may be `null` to indicate disabled checks).
- * - Register / unregister labels in a controlled manner.
- * - Query class constructors using their 'SigilLabel'.
- * - Support hot-reload tolerant registration (avoid throwing in DEV).
- */
-declare class SigilRegistry {
-    /** Internal private registry map. */
-    private _registry;
-    /**
-     * @param map - Map used to register 'Sigil' classes. if not passed it will be auto-generated internally.
-     */
-    constructor(map?: Map<string, ISigil | null>);
-    /**
-     * Return a readonly view (array) of the current registry entries.
-     *
-     * @returns An array containing all registered labels, or an empty array when registry is disabled.
-     */
-    listLabels(): string[];
-    /**
-     * Determine whether the registry currently contains `label`.
-     *
-     * @param label - The label to test.
-     * @returns `true` if present; `false` otherwise.
-     */
-    has(label: string): boolean;
-    /**
-     * Get class constructor using its label.
-     *
-     * @param label - Label appended to Sigil class.
-     * @returns Reference to Sigil class constructor or null if stored with 'SigilOptions.storeConstructor = false'.
-     */
-    get(label: string): ISigil | null;
-    /**
-     * Register a label and class constructor in the active registry.
-     *
-     * If the label already exists then:
-     *   - In DEV builds: prints a console warning (HMR friendly) and returns early.
-     *   - In non-DEV builds: throws an Error to prevent duplicate registration.
-     *
-     * @param label - Label string to register (e.g. '@scope/pkg.ClassName').
-     * @param Class - Constructor of the class being registered.
-     * @param opts - Optional per-call overrides.
-     */
-    register(label: string, Class: ISigil | null, opts?: Pick<SigilOptions, 'devMarker' | 'storeConstructor'>): void;
-    /**
-     * Alias for 'SigilRegistry.register'.
-     *
-     * @param label - Label string to register (e.g. '@scope/pkg.ClassName').
-     * @param Class - Constructor of the class being registered.
-     * @param opts - Optional per-call overrides.
-     */
-    set(label: string, Class: ISigil | null, opts?: Pick<SigilOptions, 'devMarker' | 'storeConstructor'>): void;
-    /**
-     * Unregister a previously registered class.
-     *
-     * @param label - The label to remove from the registry.
-     * @returns `true` if the label was present and removed; `false` otherwise (or when registry is disabled).
-     */
-    unregister(label: string): boolean;
-    /**
-     * Alias for 'SigilRegistry.unregister'.
-     *
-     * @param label - The label to remove from the registry.
-     * @returns `true` if the label was present and removed; `false` otherwise (or when registry is disabled).
-     */
-    delete(label: string): boolean;
-    /**
-     * Replace active registry with new one. deprecated use 'updateOptions({ registry: newRegistry })' instead.
-     *
-     * @deprecated Will be removed in v2.0.0, check https://www.npmjs.com/package/@vicin/sigil?activeTab=readme#deprecated-api for more details.
-     * @param newRegistry - New Set<string> instance to use as the active registry, or `null` to disable checks.
-     */
-    replaceRegistry(newRegistry: Map<string, ISigil | null> | null): void;
-    /**
-     * Clear the registry completely.
-     *
-     * Useful for test teardown, or when explicitly resetting state during development.
-     * No-op when the registry is disabled.
-     */
-    clear(): void;
-    /**
-     * Merge another SigilRegistry into this one.
-     *
-     * Entries from `other` will be registered into this registry. Duplicate labels
-     * are handled via this registry's `register` logic (i.e., will warn in DEV or
-     * throw in production).
-     *
-     * @param other - Another `SigilRegistry` whose entries will be merged into this registry.
-     */
-    merge(other: SigilRegistry): void;
-    /**
-     * Return a Map-style iterator over entries: `[label, constructor]`.
-     * Equivalent to calling `registry[Symbol.iterator]()`.
-     *
-     * @returns IterableIterator of `[label, ISigil]`.
-     */
-    entries(): IterableIterator<[string, ISigil | null]>;
-    /**
-     * Return an iterator over registered constructors.
-     *
-     * @returns IterableIterator of `ISigil` constructors.
-     */
-    values(): IterableIterator<ISigil | null>;
-    /**
-     * Return an iterator over registered labels (keys).
-     *
-     * @returns IterableIterator of `string` labels.
-     */
-    keys(): IterableIterator<string>;
-    /**
-     * Execute a provided function once per registry entry.
-     *
-     * @param callback - Function invoked with `(ctor, label)` for each entry.
-     * @param thisArg - Optional `this` context for the callback.
-     */
-    forEach(callback: (ctor: ISigil | null, label: string) => void, thisArg?: any): void;
-    /**
-     * Get the size (number of entries) of the active registry.
-     *
-     * @returns The number of registered labels, or 0 when registry is disabled.
-     */
-    get size(): number;
-    /**
-     * Return an iterator over `[label, constructor]` pairs.
-     *
-     * This makes the registry compatible with `for..of` and other iterable helpers:
-     * ```ts
-     * for (const [label, ctor] of registry) { ... }
-     * ```
-     *
-     * @returns An iterable iterator that yields `[label, ISigil]` tuples.
-     */
-    [Symbol.iterator](): IterableIterator<[string, ISigil | null]>;
-}
-/**
- * Returns the currently configured SigilRegistry instance (or `null` if no registry is active).
- *
- * IMPORTANT: this function reflects the live `OPTIONS.registry` value and therefore
- * will reflect any changes made via `updateOptions(...)`. Consumers that need a stable
- * registry instance for mutation should call this function each time rather than
- * holding a long-lived reference to the previously returned object.
- *
- * It gets global registry if defined, otherwise returns registry stored in SigilOptions.
- *
- * @returns {SigilRegistry | null} The active registry or `null` when no registry is in use.
- */
-declare const getActiveRegistry: () => SigilRegistry | null;
-/** -----------------------------------------
- *  Deprecated registry
- * ----------------------------------------- */
-/**
- * Old 'REGISTRY' alias to interact with registy.
- *
- * 'REGISTRY' is a live binding for compat; prefer getActiveRegistry() to avoid manual sync.
- * @deprecated Will be removed in v2.0.0, check https://www.npmjs.com/package/@vicin/sigil?activeTab=readme#deprecated-api for more details.
- */
-declare let REGISTRY: SigilRegistry;
-/** -----------------------------------------
- *  Label validation
- * ----------------------------------------- */
-/**
- * Label validation regex. Labels must follow the pattern
- * `@scope/package.ClassName` where `ClassName` begins with an uppercase
- * letter. This avoids collisions across packages and helps debugging.
- *
- * It's advised to use this regex in 'SigilOptions.labelValidation'.
- */
-declare const DEFAULT_LABEL_REGEX: RegExp;
-/** -----------------------------------------
- *  Deprecated registry
- * ----------------------------------------- */
-/**
- * Update runtime options for the Sigil library.
- * Call this early during application startup if you want non-default behavior.
- *
- * Example:
- * ```ts
- * updateOptions({ autofillLabels: true, labelValidation: /^@[\w-]+\/[\w-]+\.[A-Za-z0-9]+$/ });
- * ```
- *
- * @param opts - Partial options to merge into the global `OPTIONS` object.
- * @param mergeRegistries - Boolean to merge old registry into new one directly, default is 'true'.
- */
-declare const updateOptions: (opts: SigilOptions, mergeRegistries?: boolean) => void;
-
-/** -----------------------------------------
- *  Options
- * ----------------------------------------- */
-/**
- * Configuration options for the Sigil library.
- *
- * These options control runtime validation, inheritance checks, label autofill behavior,
- * and whether duplicate labels are permitted globally.
- *
- * Note: these options are read by runtime code during class decoration and inheritance
- * checks. Some behaviors (like `skipLabelInheritanceCheck`) are meant primarily for
- * development/test scenarios and may weaken type/identity guarantees when changed.
- */
-interface SigilOptions {
-    /**
-     * Validation rule applied to sigil labels before registration.
-     *
-     * - A function receives the label and must return `true` if valid.
-     * - A `RegExp` must match the label.
-     * - `null` disables validation entirely.
-     *
-     * Defaults to `null`.
-     */
-    labelValidation?: ((label: string) => boolean) | RegExp | null;
-    /**
-     * Skips the runtime check that prevents subclasses from inheriting
-     * the same sigil label as their ancestors.
-     *
-     * When `false` (default), extending a sigil class without
-     * using `WithSigil(newLabel)` decorator will throw an error if the label
-     * is reused and `OPTIONS.autofillLabels` is set to `false`.
-     *
-     * Set this to `true` only if you intentionally want subclasses to inherit labels
-     * from their ancestors (this weakens the uniqueness guarantees).
-     *
-     * WARNING:
-     * Disabling inheritanceCheck removes guaranties by 'Sigil' or unique label for
-     * each class and allow multiple child classes to use the same label which can
-     * result on false 'isOfType' result. this options should be used in debugging
-     * only to silence all errors but never in production.
-     */
-    skipLabelInheritanceCheck?: boolean;
-    /**
-     * When enabled, non-decorated subclasses that would otherwise inherit an ancestor's label
-     * will be assigned an autogenerated random label (so that explicit labels stay unique).
-     */
-    autofillLabels?: boolean;
-    /**
-     * Marker used internally to control dev only checks to optimize performace while preserving
-     * consistency for things like inheritance checks.
-     * defaults to 'process.env.NODE_ENV !== "production'.
-     */
-    devMarker?: boolean;
-    /**
-     * Registry instance used to store and resolve sigil labels at runtime.
-     *
-     * - When `useGlobalRegistry` is `true` (default), this registry will be
-     *   registered as the active global registry via `updateGlobalRegistry(...)`.
-     * - When `useGlobalRegistry` is `false`, this registry is kept local and will
-     *   not participate in global identity checks.
-     *
-     * IMPORTANT:
-     * Replacing the registry via `updateOptions({ registry })` changes the active
-     * registry used by Sigil, but consumers should always retrieve the registry
-     * through `getRegistry()` rather than holding a long-lived reference.
-     *
-     * Defaults to a new `SigilRegistry` instance.
-     *
-     * WARNING:
-     * Setting registry to null disables:
-     * - Label re-use checks entirly.
-     * - Feature relying on get(label) → class (e.g., deserialization)
-     */
-    registry?: SigilRegistry | null;
-    /**
-     * Controls whether the configured `registry` is stored in 'globalThis'.
-     *
-     * When `true` (default):
-     * - The registry is registered globally
-     * - All sigilized classes participate in the same identity space
-     *
-     * When `false`:
-     * - No global registry is used
-     * - Identity checks are limited to explicitly provided registry
-     *
-     * WARNING:
-     * Disabling the global registry may lead to duplicate labels across
-     * isolated registries and should only be done in advanced or test scenarios.
-     */
-    useGlobalRegistry?: boolean;
-    /**
-     * Controls whether the configured 'registry' should store class constructors.
-     * This is useful if you want to use 'Sigil' while keeping the constructor private.
-     *
-     * Note that any feature relying on get(label) → class (e.g., deserialization) will
-     * not work if set to 'true' as class is replaced with 'null'.
-     *
-     * When 'true' (default):
-     * - Class passed will be stored in the registry map under its label.
-     *
-     * When 'false':
-     * - Registry map stored only label key and class constructor is replaced with null ([label, null])
-     */
-    storeConstructor?: boolean;
-}
 /** -----------------------------------------
  *  Class and instance
  * ----------------------------------------- */
@@ -319,18 +24,16 @@ interface ISigilStatic<L extends string = string, P extends Function = never> {
     } & SigilBrandOf<P>>;
     /** Class-level label constant (human readable). */
     readonly SigilLabel: string;
-    /** Class-level unique symbol used as the runtime type identifier. */
-    readonly SigilType: symbol;
     /**
-     * Copy of the linearized sigil type symbol chain for the current constructor.
+     * Copy of the linearized sigil type label chain for the current constructor.
      * Useful for debugging and strict lineage comparisons.
      */
-    readonly SigilTypeLineage: readonly symbol[];
+    readonly SigilLabelLineage: readonly string[];
     /**
-     * Copy of the sigil type symbol set for the current constructor. Useful for
+     * Copy of the sigil type label set for the current constructor. Useful for
      * O(1) membership checks and debugging.
      */
-    readonly SigilTypeSet: Readonly<Set<symbol>>;
+    readonly SigilLabelSet: Readonly<Set<string>>;
     /**
      * Runtime check that determines whether `obj` is an instance produced by a
      * sigil class.
@@ -344,7 +47,7 @@ interface ISigilStatic<L extends string = string, P extends Function = never> {
     isSigilified(obj: unknown): obj is ISigil;
     /**
      * Check whether `other` is (or inherits from) the type represented by the
-     * calling constructor. Uses the other instance's `SigilTypeSet` to check
+     * calling constructor. Uses the other instance's `SigilLabelSet` to check
      * membership. Works in O(1) and is reliable as long as `OPTIONS.skipLabelInheritanceCheck` is `false`.
      *
      * This replaces `instanceof` so that checks remain valid across bundles/realms
@@ -358,7 +61,7 @@ interface ISigilStatic<L extends string = string, P extends Function = never> {
     isOfType<T extends ISigil>(this: T, other: unknown): other is InstanceType<T>;
     /**
      * Strict lineage comparison: verifies that the calling constructor's type
-     * lineage (by symbol) matches the `other`'s lineage element-by-element.
+     * lineage (by label) matches the `other`'s lineage element-by-element.
      *
      * Works in O(n) where `n` is the lineage length and is useful when order
      * and exact ancestry must be confirmed. reliable when `OPTIONS.skipLabelInheritanceCheck` is `false`.
@@ -390,12 +93,12 @@ interface ISigilInstance<L extends string = string, P extends Function = never>
     } & SigilBrandOf<P>>;
     /** Returns human-readable sigil label of the class constructor. */
     getSigilLabel(): string;
-    /** Returns runtime sigil type symbol of the class constructor. */
-    getSigilType(): symbol;
-    /** Returns copy of sigil type symbol lineage of the class constructor. */
-    getSigilTypeLineage(): readonly symbol[];
-    /** Returns copy of sigil type symbol set of the class constructor. */
-    getSigilTypeSet(): Readonly<Set<symbol>>;
+    /** Returns runtime sigil type label of the class constructor. */
+    getSigilType(): string;
+    /** Returns copy of sigil type label lineage of the class constructor. */
+    getSigilLabelLineage(): readonly string[];
+    /** Returns copy of sigil type label set of the class constructor. */
+    getSigilLabelSet(): Readonly<Set<string>>;
 }
 /**
  * Combined constructor + static interface for a sigil class.
@@ -498,19 +201,17 @@ declare const Sigil: {
             Sigil: true;
         };
         isOfType<T>(this: T, other: unknown): other is GetInstance<T>;
-        isOfTypeStrict<T>(this: T, other: unknown): other is /*elided*/ any;
+        isOfTypeStrict<T>(this: T, other: unknown): other is GetInstance<T>;
         getSigilLabel(): string;
-        getSigilType(): symbol;
-        getSigilTypeLineage(): readonly symbol[];
-        getSigilTypeSet(): Readonly<Set<symbol>>;
+        getSigilLabelLineage(): readonly string[];
+        getSigilLabelSet(): Readonly<Set<string>>;
     };
     readonly __SIGIL_BRAND__: {
         Sigil: true;
     };
     get SigilLabel(): string;
-    get SigilType(): symbol;
-    get SigilTypeLineage(): readonly symbol[];
-    get SigilTypeSet(): Readonly<Set<symbol>>;
+    get SigilLabelLineage(): readonly string[];
+    get SigilLabelSet(): Readonly<Set<string>>;
     isSigilified(obj: unknown): obj is ISigil;
     isOfType<T>(this: T, other: unknown): other is GetInstance<T>;
     isOfTypeStrict<T>(this: T, other: unknown): other is GetInstance<T>;
@@ -532,26 +233,89 @@ declare const SigilError: {
             SigilError: true;
         };
         isOfType<T>(this: T, other: unknown): other is GetInstance<T>;
-        isOfTypeStrict<T>(this: T, other: unknown): other is /*elided*/ any;
+        isOfTypeStrict<T>(this: T, other: unknown): other is GetInstance<T>;
         getSigilLabel(): string;
-        getSigilType(): symbol;
-        getSigilTypeLineage(): readonly symbol[];
-        getSigilTypeSet(): Readonly<Set<symbol>>;
+        getSigilLabelLineage(): readonly string[];
+        getSigilLabelSet(): Readonly<Set<string>>;
     };
     readonly __SIGIL_BRAND__: {
         Sigil: true;
         SigilError: true;
     };
     get SigilLabel(): string;
-    get SigilType(): symbol;
-    get SigilTypeLineage(): readonly symbol[];
-    get SigilTypeSet(): Readonly<Set<symbol>>;
+    get SigilLabelLineage(): readonly string[];
+    get SigilLabelSet(): Readonly<Set<string>>;
     isSigilified(obj: unknown): obj is ISigil;
     isOfType<T>(this: T, other: unknown): other is GetInstance<T>;
     isOfTypeStrict<T>(this: T, other: unknown): other is GetInstance<T>;
 } & ErrorConstructor;
 type SigilError = InstanceType<typeof SigilError>;
 
+/**
+ * Configuration options for the Sigil library.
+ *
+ * These options control runtime validation, inheritance checks, label autofill behavior.
+ */
+interface SigilOptions {
+    /**
+     * Validation rule applied to sigil labels before registration.
+     *
+     * - A function receives the label and must return `true` if valid.
+     * - A `RegExp` must match the label.
+     * - `null` disables validation entirely.
+     *
+     * Defaults to `null`.
+     */
+    labelValidation?: ((label: string) => boolean) | RegExp | null;
+    /**
+     * Skips the runtime check that prevents subclasses from inheriting
+     * the same sigil label as their ancestors.
+     *
+     * When `false` (default), extending a sigil class without
+     * using `WithSigil(newLabel)` decorator will throw an error if the label
+     * is reused and `OPTIONS.autofillLabels` is set to `false`.
+     *
+     * Set this to `true` only if you intentionally want subclasses to inherit labels
+     * from their ancestors (this weakens the uniqueness guarantees).
+     *
+     * WARNING:
+     * Disabling inheritanceCheck removes guaranties by 'Sigil' or unique label for
+     * each class and allow multiple child classes to use the same label which can
+     * result on false 'isOfType' result. this options should be used in debugging
+     * only to silence all errors but never in production.
+     */
+    skipLabelInheritanceCheck?: boolean;
+    /**
+     * When enabled, non-decorated subclasses that would otherwise inherit an ancestor's label
+     * will be assigned an autogenerated random label (so that explicit labels stay unique).
+     */
+    autofillLabels?: boolean;
+    /**
+     * Marker used internally to control dev only checks to optimize performace while preserving
+     * consistency for things like inheritance checks.
+     * defaults to 'process.env.NODE_ENV !== "production'.
+     */
+    devMarker?: boolean;
+}
+/**
+ * Update runtime options for the Sigil library.
+ * Call this early during application startup if you want non-default behavior.
+ *
+ * @param opts - Partial options to merge into the global `OPTIONS` object.
+ */
+declare const updateOptions: (opts: SigilOptions) => void;
+/** -----------------------------------------
+ *  Label validation
+ * ----------------------------------------- */
+/**
+ * Label validation regex. Labels must follow the pattern
+ * `@scope/package.ClassName` where `ClassName` begins with an uppercase
+ * letter. This avoids collisions across packages and helps debugging.
+ *
+ * It's advised to use this regex in 'SigilOptions.labelValidation'.
+ */
+declare const DEFAULT_LABEL_REGEX: RegExp;
+
 /**
  * Class decorator factory that attaches sigil statics to a class constructor.
  *
@@ -598,23 +362,6 @@ declare function WithSigil<L extends string>(label?: L, opts?: SigilOptions): (v
  * @returns The same constructor value, with runtime metadata ensured.
  */
 declare function withSigil<S extends Function, L extends string = string>(Class: S, label?: L, opts?: SigilOptions): S;
-/**
- * Narrow a constructor to a compile-time `TypedSigil` without modifying runtime.
- *
- * This is a *purely type-level* helper (no runtime changes). It optionally
- * verifies in DEV that the runtime `SigilLabel` matches the provided `label`.
- *
- * Use this when the runtime metadata is already present (for example the class
- * is already decorated or was created via `Sigilify`).
- *
- * @deprecated Will be removed in v2.0.0, check https://www.npmjs.com/package/@vicin/sigil?activeTab=readme#deprecated-api for more details.
- * @typeParam S - Constructor type (should be an ISigil).
- * @typeParam L - Label literal to associate at compile-time.
- * @param Class - The constructor to assert as typed sigil.
- * @param label - Optional label literal to assert at compile-time (and to verify in DEV).
- * @returns The same constructor value, typed as `TypedSigil<S, L, P>`.
- */
-declare function typed<S extends Function, L extends string = string>(Class: S, label?: L, opts?: Pick<SigilOptions, 'devMarker'>): TypedSigil<S, L>;
 /**
  * Convenience helper that combine 'withSigil' and 'typeSigil'.
  *
@@ -698,7 +445,6 @@ declare function isInheritanceChecked(ctor: Function): boolean;
  * helpers.
  *
  * The returned class:
- * - registers a stable symbol for the provided `label` (via `WithSigil`)
  * - exposes static helpers such as `SigilLabel`, `SigilType`, `isOfType`, and `isOfTypeStrict`
  * - exposes instance helpers such as `getSigilLabel`, `getSigilType`, etc.
  *
@@ -733,7 +479,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
          */
         isOfType<T_1>(this: T_1, other: unknown): other is GetInstance<T_1>;
         /**
-         * Strict lineage check: compares the type symbol lineage arrays element-by-element.
+         * Strict lineage check: compares the type label lineage arrays element-by-element.
          *
          * Allows 'instanceof' like checks but in instances.
          *
@@ -742,7 +488,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
          * @param other - The object to test.
          * @returns `true` if `other` has an identical lineage up to the length of this instance's lineage.
          */
-        isOfTypeStrict<T_1>(this: T_1, other: unknown): other is /*elided*/ any;
+        isOfTypeStrict<T_1>(this: T_1, other: unknown): other is GetInstance<T_1>;
         /**
          * Returns the human-readable sigil label of this instance's constructor.
          *
@@ -750,23 +496,17 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
          */
         getSigilLabel(): string;
         /**
-         * Returns the runtime sigil type symbol of this instance's constructor.
+         * Returns a copy of the sigil type label lineage for this instance's constructor.
          *
-         * @returns The symbol that identifies this type at runtime.
+         * @returns readonly array of labels representing the type lineage.
          */
-        getSigilType(): symbol;
+        getSigilLabelLineage(): readonly string[];
         /**
-         * Returns a copy of the sigil type symbol lineage for this instance's constructor.
+         * Returns a readonly copy of the sigil type label set for this instance's constructor.
          *
-         * @returns readonly array of symbols representing the type lineage.
+         * @returns A Readonly Set of labels representing the type lineage for O(1) membership tests.
          */
-        getSigilTypeLineage(): readonly symbol[];
-        /**
-         * Returns a readonly copy of the sigil type symbol set for this instance's constructor.
-         *
-         * @returns A Readonly Set of symbols representing the type lineage for O(1) membership tests.
-         */
-        getSigilTypeSet(): Readonly<Set<symbol>>;
+        getSigilLabelSet(): Readonly<Set<string>>;
     };
     /**
      * Compile-time nominal brand that encodes the class label `L` plus parent's brand keys `BrandOf<P>`.
@@ -783,28 +523,21 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
      */
     get SigilLabel(): string;
     /**
-     * Class-level unique runtime symbol used as the type identifier.
-     *
-     * This symbol is created with `Symbol.for(label)` during decoration so it is
-     * stable across realms that share the same global symbol registry.
-     */
-    get SigilType(): symbol;
-    /**
-     * Copy of the linearized sigil type symbol chain for the current constructor.
+     * Copy of the linearized sigil type label chain for the current constructor.
      *
      * Useful for debugging and performing strict lineage comparisons.
      *
-     * @returns An array of symbols representing parent → child type symbols.
+     * @returns An array of labels representing parent → child type labels.
      */
-    get SigilTypeLineage(): readonly symbol[];
+    get SigilLabelLineage(): readonly string[];
     /**
-     * Copy of the sigil type symbol set for the current constructor.
+     * Copy of the sigil type label set for the current constructor.
      *
      * Useful for quick membership checks (O(1) lookups) and debugging.
      *
-     * @returns A Readonly Set of symbols that represent the type lineage.
+     * @returns A Readonly Set of labels that represent the type lineage.
      */
-    get SigilTypeSet(): Readonly<Set<symbol>>;
+    get SigilLabelSet(): Readonly<Set<string>>;
     /**
      * Runtime predicate indicating whether `obj` is an instance produced by a sigil class.
      *
@@ -825,7 +558,7 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
      */
     isOfType<T>(this: T, other: unknown): other is GetInstance<T>;
     /**
-     * Strict lineage check: compares the type symbol lineage arrays element-by-element.
+     * Strict lineage check: compares the type label lineage arrays element-by-element.
      *
      * @typeParam T - The calling constructor type.
      * @param this - The constructor performing the check.
@@ -839,7 +572,6 @@ declare function Sigilify<B extends Constructor, L extends string>(Base: B, labe
  * helpers. Accept and return 'abstract' class.
  *
  * The returned class:
- * - registers a stable symbol for the provided `label` (via `WithSigil`)
  * - exposes static helpers such as `SigilLabel`, `SigilType`, `isOfType`, and `isOfTypeStrict`
  * - exposes instance helpers such as `getSigilLabel`, `getSigilType`, etc.
  *
@@ -873,7 +605,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      */
     isOfType<T_1>(this: T_1, other: unknown): other is GetInstance<T_1>;
     /**
-     * Strict lineage check: compares the type symbol lineage arrays element-by-element.
+     * Strict lineage check: compares the type label lineage arrays element-by-element.
      *
      * Allows 'instanceof' like checks but in instances.
      *
@@ -882,7 +614,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * @param other - The object to test.
      * @returns `true` if `other` has an identical lineage up to the length of this instance's lineage.
      */
-    isOfTypeStrict<T_1>(this: T_1, other: unknown): other is /*elided*/ any;
+    isOfTypeStrict<T_1>(this: T_1, other: unknown): other is GetInstance<T_1>;
     /**
      * Returns the human-readable sigil label of this instance's constructor.
      *
@@ -890,23 +622,17 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      */
     getSigilLabel(): string;
     /**
-     * Returns the runtime sigil type symbol of this instance's constructor.
-     *
-     * @returns The symbol that identifies this type at runtime.
-     */
-    getSigilType(): symbol;
-    /**
-     * Returns a copy of the sigil type symbol lineage for this instance's constructor.
+     * Returns a copy of the sigil type label lineage for this instance's constructor.
      *
-     * @returns readonly array of symbols representing the type lineage.
+     * @returns readonly array of labels representing the type lineage.
      */
-    getSigilTypeLineage(): readonly symbol[];
+    getSigilLabelLineage(): readonly string[];
     /**
-     * Returns a readonly copy of the sigil type symbol set for this instance's constructor.
+     * Returns a readonly copy of the sigil type label set for this instance's constructor.
      *
-     * @returns A Readonly Set of symbols representing the type lineage for O(1) membership tests.
+     * @returns A Readonly Set of labels representing the type lineage for O(1) membership tests.
      */
-    getSigilTypeSet(): Readonly<Set<symbol>>;
+    getSigilLabelSet(): Readonly<Set<string>>;
 }) & {
     /**
      * Compile-time nominal brand that encodes the class label `L` plus parent's brand keys `BrandOf<P>`.
@@ -923,28 +649,21 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      */
     get SigilLabel(): string;
     /**
-     * Class-level unique runtime symbol used as the type identifier.
-     *
-     * This symbol is created with `Symbol.for(label)` during decoration so it is
-     * stable across realms that share the same global symbol registry.
-     */
-    get SigilType(): symbol;
-    /**
-     * Copy of the linearized sigil type symbol chain for the current constructor.
+     * Copy of the linearized sigil type label chain for the current constructor.
      *
      * Useful for debugging and performing strict lineage comparisons.
      *
-     * @returns An array of symbols representing parent → child type symbols.
+     * @returns An array of labels representing parent → child type labels.
      */
-    get SigilTypeLineage(): readonly symbol[];
+    get SigilLabelLineage(): readonly string[];
     /**
-     * Copy of the sigil type symbol set for the current constructor.
+     * Copy of the sigil type label set for the current constructor.
      *
      * Useful for quick membership checks (O(1) lookups) and debugging.
      *
-     * @returns A Readonly Set of symbols that represent the type lineage.
+     * @returns A Readonly Set of labels that represent the type lineage.
      */
-    get SigilTypeSet(): Readonly<Set<symbol>>;
+    get SigilLabelSet(): Readonly<Set<string>>;
     /**
      * Runtime predicate indicating whether `obj` is an instance produced by a sigil class.
      *
@@ -956,7 +675,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      * Check whether `other` is (or inherits from) the type represented by the calling constructor.
      *
      * Implementation detail:
-     * - Uses the other instance's `__TYPE_SET__` for O(1) membership test.
+     * - Uses the other instance's `__LABEL_SET__` for O(1) membership test.
      * - O(1) and reliable as long as `OPTIONS.skipLabelInheritanceCheck` is `false`.
      *
      * This replaces `instanceof` so that checks remain valid across bundles/realms
@@ -969,7 +688,7 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
      */
     isOfType<T>(this: T, other: unknown): other is GetInstance<T>;
     /**
-     * Strict lineage check: compares the type symbol lineage arrays element-by-element.
+     * Strict lineage check: compares the type label lineage arrays element-by-element.
      *
      * Implementation detail:
      * - Works in O(n) time where n is the depth of the lineage.
@@ -983,4 +702,4 @@ declare function SigilifyAbstract<B extends ConstructorAbstract, L extends strin
     isOfTypeStrict<T>(this: T, other: unknown): other is GetInstance<T>;
 }) & B;
 
-export { DEFAULT_LABEL_REGEX, type GetInstance, type ISigil, type ISigilInstance, type ISigilStatic, REGISTRY, Sigil, type SigilBrandOf, SigilError, type SigilOptions, SigilRegistry, Sigilify, SigilifyAbstract, type TypedSigil, type UpdateSigilBrand, WithSigil, getActiveRegistry, isDecorated, isInheritanceChecked, isSigilBaseCtor, isSigilBaseInstance, isSigilCtor, isSigilInstance, typed, updateOptions, withSigil, withSigilTyped };
+export { DEFAULT_LABEL_REGEX, type GetInstance, type ISigil, type ISigilInstance, type ISigilStatic, Sigil, type SigilBrandOf, SigilError, type SigilOptions, Sigilify, SigilifyAbstract, type TypedSigil, type UpdateSigilBrand, WithSigil, isDecorated, isInheritanceChecked, isSigilBaseCtor, isSigilBaseInstance, isSigilCtor, isSigilInstance, updateOptions, withSigil, withSigilTyped };