Class ComponentRegistry

constructor

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

  Creates a new ComponentRegistry instance

  Parameters

  • Optionalconfig: Partial<RegistryConfig>

    Optional registry configuration

  Returns ComponentRegistry

ReadonlyregistryId

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

  Clears all components from the registry

  Returns void

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

  Destroys the registry and cleans up resources

  Returns void

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

  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>

  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[]

  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[]

  Gets all components in a namespace

  Parameters

  • namespace: string

    Namespace to query

  Returns ComponentMetadata[]

  Array of components in the namespace

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;
  }

  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

  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

  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

  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

  Gets the current size of the registry

  Returns number

  Number of registered components

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