Class ComponentRegistry

constructor

• new ComponentRegistry(config?: Partial<RegistryConfig>): ComponentRegistry

  Creates a new ComponentRegistry instance

  Parameters

  • Optionalconfig: Partial<RegistryConfig>

    Optional registry configuration

  Returns ComponentRegistry

ReadonlyRegistryId

registryId

• get registryId(): string

  Returns string

  Deprecated

  Use RegistryId.

cleanup

• cleanup(force?: boolean): number

  Parameters

  • force: boolean = false

  Returns number

  Deprecated

  Use Cleanup.

Cleanup

• Cleanup(force?: boolean): number

  Performs cleanup of unused components

  Parameters

  • force: boolean = false

    Force cleanup regardless of reference count

  Returns number

  Number of components removed

clear

• clear(): void

  Returns void

  Deprecated

  Use Clear.

Clear

• Clear(): void

  Clears all components from the registry

  Returns void

clearNamespace

• clearNamespace(namespace?: string): number

  Parameters

  • namespace: string = 'Global'

  Returns number

  Deprecated

  Use ClearNamespace.

ClearNamespace

• ClearNamespace(namespace?: string): number

  Clear all components in a specific namespace

  Parameters

  • namespace: string = 'Global'

    Namespace to clear (default: 'Global')

  Returns number

  Number of components removed

destroy

• destroy(): void

  Returns void

  Deprecated

  Use Destroy.

Destroy

• Destroy(): void

  Destroys the registry and cleans up resources

  Returns void

forceClear

• forceClear(): void

  Returns void

  Deprecated

  Use ForceClear.

ForceClear

• ForceClear(): void

  Force clear all components and reset registry Used for development/testing scenarios

  Returns void

get

• get(
      name: string,
      namespace?: string,
      version?: string,
      contentHash?: string,
  ): ComponentObject | undefined

  Parameters

  • name: string
  • namespace: string = 'Global'
  • Optionalversion: string
  • OptionalcontentHash: string

  Returns ComponentObject | undefined

  Deprecated

  Use Get.

Get

• Get(
      name: string,
      namespace?: string,
      version?: string,
      contentHash?: string,
  ): ComponentObject | undefined

  Gets a component from the registry

  Parameters

  • name: string

    Component name

  • namespace: string = 'Global'

    Component namespace

  • Optionalversion: string

    Component version

  • OptionalcontentHash: string

    Optional content fingerprint. When provided, looks up the exact (name, namespace, version, contentHash) entry. When omitted, falls back to the most recently registered entry matching the other keys (existing behavior).

  Returns ComponentObject | undefined

  The component object if found, undefined otherwise

getAll

• getAll(namespace?: string, version?: string): Record<string, ComponentObject>

  Parameters

  • namespace: string = 'Global'
  • version: string = 'v1'

  Returns Record<string, ComponentObject>

  Deprecated

  Use GetAll.

GetAll

• GetAll(namespace?: string, version?: string): Record<string, ComponentObject>

  Gets all components in a namespace and version as a map

  Parameters

  • namespace: string = 'Global'

    Namespace to query (default: 'Global')

  • version: string = 'v1'

    Version to query (default: 'v1')

  Returns Record<string, ComponentObject>

  Object mapping component names to component objects

getByTags

• getByTags(tags: string[]): ComponentMetadata[]

  Parameters

  • tags: string[]

  Returns ComponentMetadata[]

  Deprecated

  Use GetByTags.

GetByTags

• GetByTags(tags: string[]): ComponentMetadata[]

  Gets components by tags

  Parameters

  • tags: string[]

    Tags to search for

  Returns ComponentMetadata[]

  Array of components matching any of the tags

getNamespace

• getNamespace(namespace: string): ComponentMetadata[]

  Parameters

  • namespace: string

  Returns ComponentMetadata[]

  Deprecated

  Use GetNamespace.

GetNamespace

• GetNamespace(namespace: string): ComponentMetadata[]

  Gets all components in a namespace

  Parameters

  • namespace: string

    Namespace to query

  Returns ComponentMetadata[]

  Array of components in the namespace

getNamespaces

• getNamespaces(): string[]

  Returns string[]

  Deprecated

  Use GetNamespaces.

GetNamespaces

• GetNamespaces(): string[]

  Gets all registered namespaces

  Returns string[]

  Array of unique namespace names

getStats

• getStats(): {
      namespaces: number;
      newestComponent?: Date;
      oldestComponent?: Date;
      totalComponents: number;
      totalRefCount: number;
  }

  Returns {
      namespaces: number;
      newestComponent?: Date;
      oldestComponent?: Date;
      totalComponents: number;
      totalRefCount: number;
  }

  Deprecated

  Use GetStats.

GetStats

• GetStats(): {
      namespaces: number;
      newestComponent?: Date;
      oldestComponent?: Date;
      totalComponents: number;
      totalRefCount: number;
  }

  Gets registry statistics

  Returns {
      namespaces: number;
      newestComponent?: Date;
      oldestComponent?: Date;
      totalComponents: number;
      totalRefCount: number;
  }

  Object containing registry stats

has

• has(
      name: string,
      namespace?: string,
      version?: string,
      contentHash?: string,
  ): boolean

  Parameters

  • name: string
  • namespace: string = 'Global'
  • Optionalversion: string
  • OptionalcontentHash: string

  Returns boolean

  Deprecated

  Use Has.

Has

• Has(
      name: string,
      namespace?: string,
      version?: string,
      contentHash?: string,
  ): boolean

  Checks if a component exists in the registry

  Parameters

  • name: string

    Component name

  • namespace: string = 'Global'

    Component namespace

  • Optionalversion: string

    Component version

  • OptionalcontentHash: string

    Optional content fingerprint (see get)

  Returns boolean

  true if the component exists

register

• register(
      name: string,
      component: ComponentObject,
      namespace?: string,
      version?: string,
      contentHash?: string,
      tags?: string[],
  ): ComponentMetadata

  Parameters

  • name: string
  • component: ComponentObject
  • namespace: string = 'Global'
  • version: string = 'v1'
  • OptionalcontentHash: string
  • Optionaltags: string[]

  Returns ComponentMetadata

  Deprecated

  Use Register.

Register

• Register(
      name: string,
      component: ComponentObject,
      namespace?: string,
      version?: string,
      contentHash?: string,
      tags?: string[],
  ): ComponentMetadata

  Registers a compiled component

  Parameters

  • name: string

    Component name

  • component: ComponentObject

    Compiled component object

  • namespace: string = 'Global'

    Component namespace (default: 'Global')

  • version: string = 'v1'

    Component version (default: 'v1')

  • OptionalcontentHash: string

    Optional content fingerprint. When provided, the entry is keyed by (name, namespace, version, contentHash) so multiple specs that share (name, namespace, version) but carry different code (e.g. a registry-reference stub vs. an inline-code Studio export of the same artifact) coexist in the cache instead of clobbering each other.

  • Optionaltags: string[]

    Optional tags for categorization

  Returns ComponentMetadata

  The registered component's metadata

release

• release(
      name: string,
      namespace?: string,
      version?: string,
      contentHash?: string,
  ): void

  Parameters

  • name: string
  • namespace: string = 'Global'
  • Optionalversion: string
  • OptionalcontentHash: string

  Returns void

  Deprecated

  Use Release.

Release

• Release(
      name: string,
      namespace?: string,
      version?: string,
      contentHash?: string,
  ): void

  Decrements reference count for a component

  Parameters

  • name: string

    Component name

  • namespace: string = 'Global'

    Component namespace

  • Optionalversion: string

    Component version

  • OptionalcontentHash: string

    Optional content fingerprint (see get)

  Returns void

size

• size(): number

  Returns number

  Deprecated

  Use Size.

Size

• Size(): number

  Gets the current size of the registry

  Returns number

  Number of registered components

unregister

• unregister(
      name: string,
      namespace?: string,
      version?: string,
      contentHash?: string,
  ): boolean

  Parameters

  • name: string
  • namespace: string = 'Global'
  • Optionalversion: string
  • OptionalcontentHash: string

  Returns boolean

  Deprecated

  Use Unregister.

Unregister

• Unregister(
      name: string,
      namespace?: string,
      version?: string,
      contentHash?: string,
  ): boolean

  Removes a component from the registry

  Parameters

  • name: string

    Component name

  • namespace: string = 'Global'

    Component namespace

  • Optionalversion: string

    Component version

  • OptionalcontentHash: string

    Optional content fingerprint (see get)

  Returns boolean

  true if the component was removed