Interface CapabilityManager

Interface for the Capability Manager. Provides methods for contributing, removing, and accessing capabilities.

interface CapabilityManager {
    atom<T>(interfaceDef: Capability.InterfaceDef<T>): Atom<T[]>;
    atomByModule<T>(
        interfaceDef: Capability.InterfaceDef<T>,
    ): Atom<Record<string, T[]>>;
    contribute<T>(
        args: {
            implementation: T;
            interface: Capability.InterfaceDef<T>;
            module: string;
        },
    ): void;
    contributions<T>(
        interfaceDef: Capability.InterfaceDef<T>,
    ): Contributions<T>;
    get<T>(interfaceDef: Capability.InterfaceDef<T>): T;
    getAll<T>(interfaceDef: Capability.InterfaceDef<T>): T[];
    listRegisteredIdentifiers(): string[];
    remove<T>(
        interfaceDef: Capability.InterfaceDef<T>,
        implementation: T,
    ): void;
    waitFor<T>(interfaceDef: Capability.InterfaceDef<T>): Effect<T>;
    waitForPromise<T>(interfaceDef: Capability.InterfaceDef<T>): Promise<T>;
}

Index

Methods

atom atomByModule contribute contributions get getAll listRegisteredIdentifiers remove waitFor waitForPromise

Methods

atom

atom<T>(interfaceDef: Capability.InterfaceDef<T>): Atom<T[]>
Get the Atom reference to the available capabilities for a given interface. Primarily useful for deriving other Atom values based on the capabilities or for subscribing to changes in the capabilities.
Type Parameters
- T
Parameters
- interfaceDef: Capability.InterfaceDef<T>
Returns Atom<T[]>
An atom reference to the available capabilities.
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:87

atomByModule

atomByModule<T>(
interfaceDef: Capability.InterfaceDef<T>,
): Atom<Record<string, T[]>>
Get capabilities grouped by the module that contributed them.
Type Parameters
- T
Parameters
- interfaceDef: Capability.InterfaceDef<T>
Returns Atom<Record<string, T[]>>
An atom containing a record from module ID to capability implementations.
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:120

contribute

contribute<T>(
    args: {
        implementation: T;
        interface: Capability.InterfaceDef<T>;
        module: string;
    },
): void
Type Parameters
- T
Parameters
- args: { implementation: T; interface: Capability.InterfaceDef<T>; module: string }
Returns void
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:77

contributions

contributions<T>(interfaceDef: Capability.InterfaceDef<T>): Contributions<T>
Live view over all contributions for a capability interface. Stable per interface: repeated calls return the same object.
Type Parameters
- T
Parameters
- interfaceDef: Capability.InterfaceDef<T>
Returns Contributions<T>
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:126

get

get<T>(interfaceDef: Capability.InterfaceDef<T>): T
Requests a single capability from the capability manager.
Type Parameters
- T
Parameters
- interfaceDef: Capability.InterfaceDef<T>
Returns T
The capability.

Throws
If no capability is found.
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:100

getAll

getAll<T>(interfaceDef: Capability.InterfaceDef<T>): T[]
Get capabilities from the capability manager.
Type Parameters
- T
Parameters
- interfaceDef: Capability.InterfaceDef<T>
Returns T[]
An array of capabilities.
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:93

listRegisteredIdentifiers

listRegisteredIdentifiers(): string[]
Lists capability interface identifiers that currently have at least one contribution.

Returns string[]
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:131

remove

remove<T>(interfaceDef: Capability.InterfaceDef<T>, implementation: T): void
Type Parameters
- T
Parameters
- interfaceDef: Capability.InterfaceDef<T>
- implementation: T
Returns void
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:79

waitFor

waitFor<T>(interfaceDef: Capability.InterfaceDef<T>): Effect<T>
Waits for a capability to be available.
Type Parameters
- T
Parameters
- interfaceDef: Capability.InterfaceDef<T>
Returns Effect<T>
The capability.
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:106

waitForPromise

waitForPromise<T>(interfaceDef: Capability.InterfaceDef<T>): Promise<T>
Promise form of waitFor, memoized per interface so repeated calls return the SAME reference — React dedupes suspended renders by thrown-promise identity, so a fresh promise per render would re-suspend forever.
Type Parameters
- T
Parameters
- interfaceDef: Capability.InterfaceDef<T>
Returns Promise<T>
A promise settling once at least one capability is contributed.
- Defined in packages/sdk/app-framework/src/core/capability-manager.ts:114

Interface CapabilityManager

Index

Methods

Methods

atom

Type Parameters

Parameters

Returns Atom<T[]>

atomByModule

Type Parameters

Parameters

Returns Atom<Record<string, T[]>>

contribute

Type Parameters

Parameters

Returns void

contributions

Type Parameters

Parameters

Returns Contributions<T>

get

Type Parameters

Parameters

Returns T

Throws

getAll

Type Parameters

Parameters

Returns T[]

listRegisteredIdentifiers

Returns string[]

remove

Type Parameters

Parameters

Returns void

waitFor

Type Parameters

Parameters

Returns Effect<T>

waitForPromise

Type Parameters

Parameters

Returns Promise<T>

Settings

On This Page